documentation/dev-manual/dev-manual-common-tasks.xml: moved BBMASK
Per Richard Purdie's suggestion, I moved the discussion on using BBMASK out from the "Customizing Images" section and placed it into a section of its own titled "Excluding Packages from the Build." (From yocto-docs rev: edb01b30779117f92e710b8afefa9a5d8a3e78fa) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
d19c8c8315
commit
fdf7db7606
|
@ -599,71 +599,47 @@
|
||||||
what you require.
|
what you require.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<section id='adding-packages'>
|
<para>
|
||||||
<title>Adding Packages</title>
|
The simplest way to add extra packages to all images is by using the
|
||||||
|
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_INSTALL'>IMAGE_INSTALL</ulink></filename>
|
||||||
<para>
|
variable with the <filename>_append</filename> operator:
|
||||||
The simplest way to add extra packages to all images is by using the
|
<literallayout class='monospaced'>
|
||||||
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_INSTALL'>IMAGE_INSTALL</ulink></filename>
|
|
||||||
variable with the <filename>_append</filename> operator:
|
|
||||||
<literallayout class='monospaced'>
|
|
||||||
IMAGE_INSTALL_append = " strace"
|
IMAGE_INSTALL_append = " strace"
|
||||||
</literallayout>
|
</literallayout>
|
||||||
Use of the syntax is important.
|
Use of the syntax is important.
|
||||||
Specifically, the space between the quote and the package name, which is
|
Specifically, the space between the quote and the package name, which is
|
||||||
<filename>strace</filename> in this example.
|
<filename>strace</filename> in this example.
|
||||||
This space is required since the <filename>_append</filename>
|
This space is required since the <filename>_append</filename>
|
||||||
operator does not add the space.
|
operator does not add the space.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Furthermore, you must use <filename>_append</filename> instead of the <filename>+=</filename>
|
Furthermore, you must use <filename>_append</filename> instead of the <filename>+=</filename>
|
||||||
operator if you want to avoid ordering issues.
|
operator if you want to avoid ordering issues.
|
||||||
The reason for this is because doing so unconditionally appends to the variable and
|
The reason for this is because doing so unconditionally appends to the variable and
|
||||||
avoids ordering problems due to the variable being set in image recipes and
|
avoids ordering problems due to the variable being set in image recipes and
|
||||||
<filename>.bbclass</filename> files with operators like <filename>?=</filename>.
|
<filename>.bbclass</filename> files with operators like <filename>?=</filename>.
|
||||||
Using <filename>_append</filename> ensures the operation takes affect.
|
Using <filename>_append</filename> ensures the operation takes affect.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
As shown in its simplest use, <filename>IMAGE_INSTALL_append</filename> affects
|
As shown in its simplest use, <filename>IMAGE_INSTALL_append</filename> affects
|
||||||
all images.
|
all images.
|
||||||
It is possible to extend the syntax so that the variable applies to a specific image only.
|
It is possible to extend the syntax so that the variable applies to a specific image only.
|
||||||
Here is an example:
|
Here is an example:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
IMAGE_INSTALL_append_pn-core-image-minimal = " strace"
|
IMAGE_INSTALL_append_pn-core-image-minimal = " strace"
|
||||||
</literallayout>
|
</literallayout>
|
||||||
This example adds <filename>strace</filename> to <filename>core-image-minimal</filename>
|
This example adds <filename>strace</filename> to <filename>core-image-minimal</filename>
|
||||||
only.
|
only.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
You can add packages using a similar approach through the
|
You can add packages using a similar approach through the
|
||||||
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-CORE_IMAGE_EXTRA_INSTALL'>CORE_IMAGE_EXTRA_INSTALL</ulink></filename>
|
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-CORE_IMAGE_EXTRA_INSTALL'>CORE_IMAGE_EXTRA_INSTALL</ulink></filename>
|
||||||
variable.
|
variable.
|
||||||
If you use this variable, only <filename>core-image-*</filename> images are affected.
|
If you use this variable, only <filename>core-image-*</filename> images are affected.
|
||||||
</para>
|
</para>
|
||||||
</section>
|
|
||||||
|
|
||||||
<section id='excluding-packages'>
|
|
||||||
<title>Excluding Packages</title>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
It is possible to filter or mask out <filename>.bb</filename> and
|
|
||||||
<filename>.bbappend</filename> files such that BitBake ignores them during
|
|
||||||
the build.
|
|
||||||
You can do this by providing an expression with the
|
|
||||||
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'>BBMASK</ulink></filename>
|
|
||||||
variable.
|
|
||||||
Here is an example:
|
|
||||||
<literallayout class='monospaced'>
|
|
||||||
BBMASK = ".*/meta-mymachine/recipes-maybe/"
|
|
||||||
</literallayout>
|
|
||||||
Here, all <filename>.bb</filename> and <filename>.bbappend</filename> files
|
|
||||||
in the directory that matches the expression are ignored during the build
|
|
||||||
process.
|
|
||||||
</para>
|
|
||||||
</section>
|
|
||||||
</section>
|
</section>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
@ -2013,6 +1989,26 @@ so that there are some definite steps on how to do this. I need more detail her
|
||||||
build directory that is different than the source directory.
|
build directory that is different than the source directory.
|
||||||
</para>
|
</para>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
<section id='excluding-packages-from-the-build'>
|
||||||
|
<title>Excluding Packages From the Build</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
It is possible to filter or mask out <filename>.bb</filename> and
|
||||||
|
<filename>.bbappend</filename> files such that BitBake ignores them during
|
||||||
|
the build.
|
||||||
|
You can do this by providing an expression with the
|
||||||
|
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'>BBMASK</ulink></filename>
|
||||||
|
variable.
|
||||||
|
Here is an example:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
BBMASK = ".*/meta-mymachine/recipes-maybe/"
|
||||||
|
</literallayout>
|
||||||
|
Here, all <filename>.bb</filename> and <filename>.bbappend</filename> files
|
||||||
|
in the directory that match the expression are ignored during the build
|
||||||
|
process - BitBake does not even parse them.
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
|
|
Loading…
Reference in New Issue