summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/dev-manual-common-tasks.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml32
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/&lt;arch&gt;-poky-linux/linux-yocto-&lt;release-specific-string&gt;/linux-&lt;arch&gt;-&lt;build-type&gt;</filename>. 1467 <filename>tmp/work/&lt;arch&gt;-poky-linux/linux-yocto-&lt;release-specific-string&gt;/linux-&lt;arch&gt;-&lt;build-type&gt;</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-&lt;PN&gt; = "${AUTOREV}" 2119 SRCREV_pn-&lt;PN&gt; = "${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