sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

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:
Scott Rifenbark 2012-03-29 15:54:55 -06:00 committed by Richard Purdie
parent d19c8c8315
commit fdf7db7606
1 changed files with 56 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

116
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -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>
<!-- <!--