diff options
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 20742ad539..b909305f68 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -208,7 +208,7 @@ | |||
208 | To enable your layer, simply add your layer's path to the | 208 | To enable your layer, simply add your layer's path to the |
209 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'>BBLAYERS</ulink></filename> | 209 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'>BBLAYERS</ulink></filename> |
210 | variable in your <filename>conf/bblayers.conf</filename> file, which is found in the | 210 | variable in your <filename>conf/bblayers.conf</filename> file, which is found in the |
211 | <link linkend='build-directory'>build directory</link>. | 211 | <link linkend='build-directory'>Build Directory</link>. |
212 | The following example shows how to enable a layer named <filename>meta-mylayer</filename>: | 212 | The following example shows how to enable a layer named <filename>meta-mylayer</filename>: |
213 | <literallayout class='monospaced'> | 213 | <literallayout class='monospaced'> |
214 | LCONF_VERSION = "6" | 214 | LCONF_VERSION = "6" |
@@ -315,7 +315,7 @@ | |||
315 | <literallayout class='monospaced'> | 315 | <literallayout class='monospaced'> |
316 | FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" | 316 | FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" |
317 | 317 | ||
318 | PRINC := "${@int(PRINC) + 1}" | 318 | PRINC := "${@int(PRINC) + 2}" |
319 | </literallayout> | 319 | </literallayout> |
320 | This example adds or overrides files in | 320 | This example adds or overrides files in |
321 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink> | 321 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SRC_URI'><filename>SRC_URI</filename></ulink> |
@@ -581,7 +581,7 @@ | |||
581 | You can also add more features by configuring the | 581 | You can also add more features by configuring the |
582 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</ulink></filename> | 582 | <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</ulink></filename> |
583 | variable in the <filename>local.conf</filename> file found in the Source Directory | 583 | variable in the <filename>local.conf</filename> file found in the Source Directory |
584 | located in the build directory. | 584 | located in the Build Directory. |
585 | </para> | 585 | </para> |
586 | 586 | ||
587 | <para> | 587 | <para> |
@@ -1240,7 +1240,7 @@ | |||
1240 | combination of multiple libraries you want to build. | 1240 | combination of multiple libraries you want to build. |
1241 | You accomplish this through your <filename>local.conf</filename> | 1241 | You accomplish this through your <filename>local.conf</filename> |
1242 | configuration file in the | 1242 | configuration file in the |
1243 | <link linkend='build-directory'>build directory</link>. | 1243 | <link linkend='build-directory'>Build Directory</link>. |
1244 | An example configuration would be as follows: | 1244 | An example configuration would be as follows: |
1245 | <literallayout class='monospaced'> | 1245 | <literallayout class='monospaced'> |
1246 | MACHINE = "qemux86-64" | 1246 | MACHINE = "qemux86-64" |
@@ -1285,7 +1285,7 @@ | |||
1285 | <listitem><para>A unique architecture is defined for the Multilib packages, | 1285 | <listitem><para>A unique architecture is defined for the Multilib packages, |
1286 | along with creating a unique deploy folder under | 1286 | along with creating a unique deploy folder under |
1287 | <filename>tmp/deploy/rpm</filename> in the | 1287 | <filename>tmp/deploy/rpm</filename> in the |
1288 | <link linkend='build-directory'>build directory</link>. | 1288 | <link linkend='build-directory'>Build Directory</link>. |
1289 | For example, consider <filename>lib32</filename> in a | 1289 | For example, consider <filename>lib32</filename> in a |
1290 | <filename>qemux86-64</filename> image. | 1290 | <filename>qemux86-64</filename> image. |
1291 | The possible architectures in the system are "all", "qemux86_64", | 1291 | The possible architectures in the system are "all", "qemux86_64", |
@@ -1407,7 +1407,7 @@ | |||
1407 | Saving the selections updates the <filename>.config</filename> configuration file. | 1407 | Saving the selections updates the <filename>.config</filename> configuration file. |
1408 | This is the file that the OpenEmbedded build system uses to configure the | 1408 | This is the file that the OpenEmbedded build system uses to configure the |
1409 | kernel during the build. | 1409 | kernel during the build. |
1410 | You can find and examine this file in the build directory in | 1410 | You can find and examine this file in the Build Directory in |
1411 | <filename>tmp/work/</filename>. | 1411 | <filename>tmp/work/</filename>. |
1412 | The actual <filename>.config</filename> is located in the area where the | 1412 | The actual <filename>.config</filename> is located in the area where the |
1413 | specific kernel is built. | 1413 | specific kernel is built. |
@@ -1463,7 +1463,7 @@ | |||
1463 | placed where the OpenEmbedded build system can find and apply them. | 1463 | placed where the OpenEmbedded build system can find and apply them. |
1464 | Syntactically, the configuration statement is identical to what would appear | 1464 | Syntactically, the configuration statement is identical to what would appear |
1465 | in the <filename>.config</filename> file, which is in the | 1465 | in the <filename>.config</filename> file, which is in the |
1466 | <link linkend='build-directory'>build directory</link> in | 1466 | <link linkend='build-directory'>Build Directory</link> in |
1467 | <filename>tmp/work/<arch>-poky-linux/linux-yocto-<release-specific-string>/linux-<arch>-<build-type></filename>. | 1467 | <filename>tmp/work/<arch>-poky-linux/linux-yocto-<release-specific-string>/linux-<arch>-<build-type></filename>. |
1468 | </para> | 1468 | </para> |
1469 | 1469 | ||
@@ -1801,7 +1801,7 @@ | |||
1801 | <itemizedlist> | 1801 | <itemizedlist> |
1802 | <listitem><para><emphasis>Build for the Correct Target Architecture:</emphasis> Your | 1802 | <listitem><para><emphasis>Build for the Correct Target Architecture:</emphasis> Your |
1803 | selected <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink> | 1803 | selected <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink> |
1804 | definition within the <filename>local.conf</filename> file in the build directory | 1804 | definition within the <filename>local.conf</filename> file in the Build Directory |
1805 | specifies the target architecture used when building the Linux kernel. | 1805 | specifies the target architecture used when building the Linux kernel. |
1806 | By default, <filename>MACHINE</filename> is set to | 1806 | By default, <filename>MACHINE</filename> is set to |
1807 | <filename>qemux86</filename>, which specifies a 32-bit | 1807 | <filename>qemux86</filename>, which specifies a 32-bit |
@@ -1847,12 +1847,12 @@ | |||
1847 | </para></listitem> | 1847 | </para></listitem> |
1848 | <listitem><para><emphasis>Clean up</emphasis>: | 1848 | <listitem><para><emphasis>Clean up</emphasis>: |
1849 | Be sure to clean the shared state out by running the | 1849 | Be sure to clean the shared state out by running the |
1850 | <filename>cleansstate</filename> BitBake task as follows from your build directory: | 1850 | <filename>cleansstate</filename> BitBake task as follows from your Build Directory: |
1851 | <literallayout class='monospaced'> | 1851 | <literallayout class='monospaced'> |
1852 | $ bitbake -c cleansstate linux-yocto | 1852 | $ bitbake -c cleansstate linux-yocto |
1853 | </literallayout></para> | 1853 | </literallayout></para> |
1854 | <para><note>Never remove any files by hand from the <filename>tmp/deploy</filename> | 1854 | <para><note>Never remove any files by hand from the <filename>tmp/deploy</filename> |
1855 | directory inside the build directory. | 1855 | directory inside the Build Directory. |
1856 | Always use the various BitBake clean tasks to clear out previous | 1856 | Always use the various BitBake clean tasks to clear out previous |
1857 | build artifacts. | 1857 | build artifacts. |
1858 | </note></para></listitem> | 1858 | </note></para></listitem> |
@@ -2022,7 +2022,7 @@ | |||
2022 | 2022 | ||
2023 | <para> | 2023 | <para> |
2024 | By default, the OpenEmbedded build system does its work from within the | 2024 | By default, the OpenEmbedded build system does its work from within the |
2025 | <link linkend='build-directory'>build directory</link>. | 2025 | <link linkend='build-directory'>Build Directory</link>. |
2026 | The build process involves fetching the source files, unpacking them, and then patching them | 2026 | The build process involves fetching the source files, unpacking them, and then patching them |
2027 | if necessary before the build takes place. | 2027 | if necessary before the build takes place. |
2028 | </para> | 2028 | </para> |
@@ -2058,17 +2058,17 @@ | |||
2058 | 2058 | ||
2059 | <para> | 2059 | <para> |
2060 | It is important to know that the <filename>externalsrc.bbclass</filename> assumes that the | 2060 | It is important to know that the <filename>externalsrc.bbclass</filename> assumes that the |
2061 | source directory <filename>S</filename> and the build directory | 2061 | source directory <filename>S</filename> and the Build Directory |
2062 | <ulink url='&YOCTO_DOCS_REF_URL;#var-B'><filename>B</filename></ulink> | 2062 | <ulink url='&YOCTO_DOCS_REF_URL;#var-B'><filename>B</filename></ulink> |
2063 | are different even though by default these directories are the same. | 2063 | are different even though by default these directories are the same. |
2064 | This assumption is important because it supports building different variants of the recipe | 2064 | This assumption is important because it supports building different variants of the recipe |
2065 | by using the | 2065 | by using the |
2066 | <ulink url='&YOCTO_DOCS_REF_URL;#var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></ulink> | 2066 | <ulink url='&YOCTO_DOCS_REF_URL;#var-BBCLASSEXTEND'><filename>BBCLASSEXTEND</filename></ulink> |
2067 | variable. | 2067 | variable. |
2068 | You could allow the build directory to be the same as the source directory but you would | 2068 | You could allow the Build Directory to be the same as the source directory but you would |
2069 | not be able to build more than one variant of the recipe. | 2069 | not be able to build more than one variant of the recipe. |
2070 | Consequently, if you are building multiple variants of the recipe, you need to establish a | 2070 | Consequently, if you are building multiple variants of the recipe, you need to establish a |
2071 | build directory that is different than the source directory. | 2071 | Build Directory that is different than the source directory. |
2072 | </para> | 2072 | </para> |
2073 | </section> | 2073 | </section> |
2074 | 2074 | ||
@@ -2114,7 +2114,7 @@ | |||
2114 | <para> | 2114 | <para> |
2115 | To enable this behavior, simply add the following to the <filename>local.conf</filename> | 2115 | To enable this behavior, simply add the following to the <filename>local.conf</filename> |
2116 | configuration file found in the | 2116 | configuration file found in the |
2117 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>build directory</ulink>: | 2117 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>: |
2118 | <literallayout class='monospaced'> | 2118 | <literallayout class='monospaced'> |
2119 | SRCREV_pn-<PN> = "${AUTOREV}" | 2119 | SRCREV_pn-<PN> = "${AUTOREV}" |
2120 | </literallayout> | 2120 | </literallayout> |
@@ -2545,7 +2545,7 @@ | |||
2545 | </para> | 2545 | </para> |
2546 | 2546 | ||
2547 | <para> | 2547 | <para> |
2548 | Downloaded archives reside in the build directory in | 2548 | Downloaded archives reside in the Build Directory in |
2549 | <filename>/tmp</filename> and are cleared up when they are no longer in use. | 2549 | <filename>/tmp</filename> and are cleared up when they are no longer in use. |
2550 | </para> | 2550 | </para> |
2551 | 2551 | ||