diff options
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 112 |
1 files changed, 60 insertions, 52 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 12839ba138..facf2edb68 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
@@ -53,15 +53,16 @@ | |||
53 | By default, BitBake does not produce empty packages. | 53 | By default, BitBake does not produce empty packages. |
54 | This default behavior can cause issues when there is an | 54 | This default behavior can cause issues when there is an |
55 | <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> or | 55 | <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link> or |
56 | some other runtime hard-requirement on the existence of the package. | 56 | some other hard runtime requirement on the existence of the package. |
57 | </para> | 57 | </para> |
58 | 58 | ||
59 | <para> | 59 | <para> |
60 | Like all package-controlling variables, you must always use them in | 60 | Like all package-controlling variables, you must always use them in |
61 | conjunction with a package name override. | 61 | conjunction with a package name override, as in: |
62 | Here is an example: | ||
63 | <literallayout class='monospaced'> | 62 | <literallayout class='monospaced'> |
64 | ALLOW_EMPTY_${PN} = "1" | 63 | ALLOW_EMPTY_${PN} = "1" |
64 | ALLOW_EMPTY_${PN}-dev = "1" | ||
65 | ALLOW_EMPTY_${PN}-staticdev = "1" | ||
65 | </literallayout> | 66 | </literallayout> |
66 | </para> | 67 | </para> |
67 | </glossdef> | 68 | </glossdef> |
@@ -234,9 +235,9 @@ | |||
234 | in which the OpenEmbedded build system places generated | 235 | in which the OpenEmbedded build system places generated |
235 | objects during a recipe's build process. | 236 | objects during a recipe's build process. |
236 | By default, this directory is the same as the <link linkend='var-S'><filename>S</filename></link> | 237 | By default, this directory is the same as the <link linkend='var-S'><filename>S</filename></link> |
237 | directory: | 238 | directory, which is defined as: |
238 | <literallayout class='monospaced'> | 239 | <literallayout class='monospaced'> |
239 | B = "${WORKDIR}/${BPN}/{PV}/" | 240 | S = "${WORKDIR}/${BP}/" |
240 | </literallayout> | 241 | </literallayout> |
241 | You can separate the (<filename>S</filename>) directory | 242 | You can separate the (<filename>S</filename>) directory |
242 | and the directory pointed to by the <filename>B</filename> | 243 | and the directory pointed to by the <filename>B</filename> |
@@ -503,7 +504,7 @@ | |||
503 | the Git repositories is not the default action by the | 504 | the Git repositories is not the default action by the |
504 | OpenEmbedded build system. | 505 | OpenEmbedded build system. |
505 | <literallayout class='monospaced'> | 506 | <literallayout class='monospaced'> |
506 | BB_Generate_MIRROR_TARBALLS = "1" | 507 | BB_GENERATE_MIRROR_TARBALLS = "1" |
507 | </literallayout> | 508 | </literallayout> |
508 | Set this variable in your <filename>local.conf</filename> | 509 | Set this variable in your <filename>local.conf</filename> |
509 | file in the | 510 | file in the |
@@ -515,7 +516,7 @@ | |||
515 | <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm> | 516 | <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm> |
516 | <glossdef> | 517 | <glossdef> |
517 | <para>The maximum number of tasks BitBake should run in parallel at any one time. | 518 | <para>The maximum number of tasks BitBake should run in parallel at any one time. |
518 | If your host development system supports multiple cores a good rule of thumb | 519 | If your host development system supports multiple cores, a good rule of thumb |
519 | is to set this variable to twice the number of cores.</para> | 520 | is to set this variable to twice the number of cores.</para> |
520 | </glossdef> | 521 | </glossdef> |
521 | </glossentry> | 522 | </glossentry> |
@@ -591,7 +592,7 @@ | |||
591 | for a layer with no dependencies, is the lowest defined priority + 1 | 592 | for a layer with no dependencies, is the lowest defined priority + 1 |
592 | (or 1 if no priorities are defined).</para> | 593 | (or 1 if no priorities are defined).</para> |
593 | <tip> | 594 | <tip> |
594 | You can use the command <filename>bitbake-layers show_layers</filename> to list | 595 | You can use the command <filename>bitbake-layers show-layers</filename> to list |
595 | all configured layers along with their priorities. | 596 | all configured layers along with their priorities. |
596 | </tip> | 597 | </tip> |
597 | </glossdef> | 598 | </glossdef> |
@@ -974,8 +975,8 @@ | |||
974 | Then, provide a space-separated list of files. | 975 | Then, provide a space-separated list of files. |
975 | Here is an example: | 976 | Here is an example: |
976 | <literallayout class='monospaced'> | 977 | <literallayout class='monospaced'> |
977 | CONFFILES_${PN} += "${sysconfdir}/file1 \ | 978 | CONFFILES_${PN} += "${sysconfdir}/file1 \ |
978 | ${sysconfdir}/file2 ${sysconfdir}/file3" | 979 | ${sysconfdir}/file2 ${sysconfdir}/file3" |
979 | </literallayout> | 980 | </literallayout> |
980 | </para> | 981 | </para> |
981 | 982 | ||
@@ -1090,7 +1091,7 @@ | |||
1090 | <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename> | 1091 | <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename> |
1091 | and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> when compiling | 1092 | and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> when compiling |
1092 | a system for debugging. | 1093 | a system for debugging. |
1093 | This variable defaults to "-O -fno-omit-frame-pointer -g". | 1094 | This variable defaults to "-O -fno-omit-frame-pointer ${DEBUG_FLAGS} -pipe". |
1094 | </para> | 1095 | </para> |
1095 | </glossdef> | 1096 | </glossdef> |
1096 | </glossentry> | 1097 | </glossentry> |
@@ -1113,7 +1114,7 @@ | |||
1113 | The bias provided by <filename>DEFAULT_PREFERENCE</filename> | 1114 | The bias provided by <filename>DEFAULT_PREFERENCE</filename> |
1114 | is weak and is overridden by | 1115 | is weak and is overridden by |
1115 | <filename><link linkend='var-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename> | 1116 | <filename><link linkend='var-BBFILE_PRIORITY'>BBFILE_PRIORITY</link></filename> |
1116 | if the that variable is different between two layers | 1117 | if that variable is different between two layers |
1117 | that contain different versions of the same recipe. | 1118 | that contain different versions of the same recipe. |
1118 | </note> | 1119 | </note> |
1119 | </glossdef> | 1120 | </glossdef> |
@@ -1161,7 +1162,7 @@ | |||
1161 | files that are ready to be used outside of the build system. | 1162 | files that are ready to be used outside of the build system. |
1162 | By default, this directory resides within the | 1163 | By default, this directory resides within the |
1163 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> | 1164 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> |
1164 | as <filename>tmp/deploy</filename>. | 1165 | as <filename>${TMPDIR}/deploy</filename>. |
1165 | </para> | 1166 | </para> |
1166 | 1167 | ||
1167 | <para> | 1168 | <para> |
@@ -1188,7 +1189,7 @@ | |||
1188 | <filename>${MACHINE}</filename> name. | 1189 | <filename>${MACHINE}</filename> name. |
1189 | By default, this directory resides within the | 1190 | By default, this directory resides within the |
1190 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> | 1191 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> |
1191 | as <filename>tmp/deploy/images/${MACHINE}/</filename>. | 1192 | as <filename>${DEPLOY_DIR}/images/${MACHINE}/</filename>. |
1192 | </para> | 1193 | </para> |
1193 | 1194 | ||
1194 | <para> | 1195 | <para> |
@@ -1325,7 +1326,7 @@ | |||
1325 | 1326 | ||
1326 | <glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION</glossterm> | 1327 | <glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION</glossterm> |
1327 | <glossdef> | 1328 | <glossdef> |
1328 | <para>the version of the distribution.</para> | 1329 | <para>The version of the distribution.</para> |
1329 | </glossdef> | 1330 | </glossdef> |
1330 | </glossentry> | 1331 | </glossentry> |
1331 | 1332 | ||
@@ -1626,7 +1627,7 @@ | |||
1626 | <para>Sometimes a recipe is required to build the final image but is not | 1627 | <para>Sometimes a recipe is required to build the final image but is not |
1627 | needed in the root filesystem. | 1628 | needed in the root filesystem. |
1628 | You can use the <filename>EXTRA_IMAGEDEPENDS</filename> variable to | 1629 | You can use the <filename>EXTRA_IMAGEDEPENDS</filename> variable to |
1629 | list these recipes and thus, specify the dependencies. | 1630 | list these recipes and thus specify the dependencies. |
1630 | A typical example is a required bootloader in a machine configuration. | 1631 | A typical example is a required bootloader in a machine configuration. |
1631 | </para> | 1632 | </para> |
1632 | <note> | 1633 | <note> |
@@ -1673,15 +1674,15 @@ | |||
1673 | files you want included as part of the resulting package. | 1674 | files you want included as part of the resulting package. |
1674 | Here is an example: | 1675 | Here is an example: |
1675 | <literallayout class='monospaced'> | 1676 | <literallayout class='monospaced'> |
1676 | FILES_${PN} += "${bindir}/mydir1/ ${bindir}/mydir2/myfile" | 1677 | FILES_${PN} += "${bindir}/mydir1/ ${bindir}/mydir2/myfile" |
1677 | </literallayout> | 1678 | </literallayout> |
1678 | </para> | 1679 | </para> |
1679 | 1680 | ||
1680 | <note> | 1681 | <note> |
1681 | When specifying paths as part of the <filename>FILES</filename> variable, | 1682 | When specifying paths as part of the <filename>FILES</filename> variable, |
1682 | it is good practice to use appropriate path variables. | 1683 | it is good practice to use appropriate path variables. |
1683 | For example, <filename>${sysconfdir}</filename> rather than | 1684 | For example, use <filename>${sysconfdir}</filename> rather than |
1684 | <filename>/etc</filename> or <filename>${bindir}</filename> rather | 1685 | <filename>/etc</filename>, or <filename>${bindir}</filename> rather |
1685 | than <filename>/usr/bin</filename>. | 1686 | than <filename>/usr/bin</filename>. |
1686 | You can find a list of these variables at the top of the | 1687 | You can find a list of these variables at the top of the |
1687 | <filename>/meta/conf/bitbake.conf</filename> file in the | 1688 | <filename>/meta/conf/bitbake.conf</filename> file in the |
@@ -1854,7 +1855,7 @@ | |||
1854 | is located in the <filename>meta/files</filename> folder in the | 1855 | is located in the <filename>meta/files</filename> folder in the |
1855 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>. | 1856 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>. |
1856 | If you create your own file permissions setting table, you should place it in your | 1857 | If you create your own file permissions setting table, you should place it in your |
1857 | layer or the distros layer. | 1858 | layer or the distro's layer. |
1858 | </para> | 1859 | </para> |
1859 | <para> | 1860 | <para> |
1860 | You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the | 1861 | You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the |
@@ -1880,7 +1881,7 @@ | |||
1880 | and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> | 1881 | and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> |
1881 | when compiling an optimized system. | 1882 | when compiling an optimized system. |
1882 | This variable defaults to | 1883 | This variable defaults to |
1883 | "-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2". | 1884 | "-O2 -pipe ${DEBUG_FLAGS}". |
1884 | </para> | 1885 | </para> |
1885 | </glossdef> | 1886 | </glossdef> |
1886 | </glossentry> | 1887 | </glossentry> |
@@ -1987,7 +1988,7 @@ | |||
1987 | </para> | 1988 | </para> |
1988 | 1989 | ||
1989 | <para> | 1990 | <para> |
1990 | For example that shows how to customize your image by | 1991 | For an example that shows how to customize your image by |
1991 | using this variable, see the | 1992 | using this variable, see the |
1992 | "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-customimage-imagefeatures'>Customizing Images Using Custom <filename>IMAGE_FEATURES</filename> and <filename>EXTRA_IMAGE_FEATURES</filename></ulink>" | 1993 | "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-customimage-imagefeatures'>Customizing Images Using Custom <filename>IMAGE_FEATURES</filename> and <filename>EXTRA_IMAGE_FEATURES</filename></ulink>" |
1993 | section in the Yocto Project Development Manual. | 1994 | section in the Yocto Project Development Manual. |
@@ -2003,7 +2004,7 @@ | |||
2003 | For example, setting <filename>IMAGE_FSTYPES</filename> | 2004 | For example, setting <filename>IMAGE_FSTYPES</filename> |
2004 | as follows causes the build system to create root | 2005 | as follows causes the build system to create root |
2005 | filesystems using two formats: <filename>.ext3</filename> | 2006 | filesystems using two formats: <filename>.ext3</filename> |
2006 | and <filename>tar.bz2</filename>: | 2007 | and <filename>.tar.bz2</filename>: |
2007 | <literallayout class='monospaced'> | 2008 | <literallayout class='monospaced'> |
2008 | IMAGE_FSTYPES = "ext3 tar.bz2" | 2009 | IMAGE_FSTYPES = "ext3 tar.bz2" |
2009 | </literallayout> | 2010 | </literallayout> |
@@ -2041,7 +2042,7 @@ | |||
2041 | <filename>+=</filename> operation against <filename>IMAGE_INSTALL</filename> | 2042 | <filename>+=</filename> operation against <filename>IMAGE_INSTALL</filename> |
2042 | will result in unexpected behavior when used in | 2043 | will result in unexpected behavior when used in |
2043 | <filename>/conf/local.conf</filename>. | 2044 | <filename>/conf/local.conf</filename>. |
2044 | Furthermore, the same operation from with an image recipe may or may not | 2045 | Furthermore, the same operation from within an image recipe may or may not |
2045 | succeed depending on the specific situation. | 2046 | succeed depending on the specific situation. |
2046 | In both these cases, the behavior is contrary to how most users expect | 2047 | In both these cases, the behavior is contrary to how most users expect |
2047 | the <filename>+=</filename> operator to work. | 2048 | the <filename>+=</filename> operator to work. |
@@ -2053,7 +2054,7 @@ | |||
2053 | IMAGE_INSTALL_append = " package-name" | 2054 | IMAGE_INSTALL_append = " package-name" |
2054 | </literallayout> | 2055 | </literallayout> |
2055 | Be sure to include the space between the quotation character and the start of the | 2056 | Be sure to include the space between the quotation character and the start of the |
2056 | package name. | 2057 | package name or names. |
2057 | </para> | 2058 | </para> |
2058 | </glossdef> | 2059 | </glossdef> |
2059 | </glossentry> | 2060 | </glossentry> |
@@ -2139,9 +2140,9 @@ | |||
2139 | 2140 | ||
2140 | <para> | 2141 | <para> |
2141 | Alternatively, you can ensure a specific amount of free disk space is added | 2142 | Alternatively, you can ensure a specific amount of free disk space is added |
2142 | to the image by using | 2143 | to the image by using the |
2143 | <filename><link linkend='var-IMAGE_ROOTFS_EXTRA_SPACE'>IMAGE_ROOTFS_EXTRA_SPACE</link></filename> | 2144 | <filename><link linkend='var-IMAGE_ROOTFS_EXTRA_SPACE'>IMAGE_ROOTFS_EXTRA_SPACE</link></filename> |
2144 | the variable. | 2145 | variable. |
2145 | </para> | 2146 | </para> |
2146 | </glossdef> | 2147 | </glossdef> |
2147 | </glossentry> | 2148 | </glossentry> |
@@ -2194,6 +2195,14 @@ | |||
2194 | IMAGE_ROOTFS_EXTRA_SPACE = "5242880" | 2195 | IMAGE_ROOTFS_EXTRA_SPACE = "5242880" |
2195 | </literallayout> | 2196 | </literallayout> |
2196 | </para> | 2197 | </para> |
2198 | |||
2199 | <para> | ||
2200 | For example, the Yocto Project Build Appliance specifically requests 40 Gbytes | ||
2201 | of extra space with the line: | ||
2202 | <literallayout class='monospaced'> | ||
2203 | IMAGE_ROOTFS_EXTRA_SPACE = "41943040" | ||
2204 | </literallayout> | ||
2205 | </para> | ||
2197 | </glossdef> | 2206 | </glossdef> |
2198 | </glossentry> | 2207 | </glossentry> |
2199 | 2208 | ||
@@ -2415,7 +2424,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
2415 | </para> | 2424 | </para> |
2416 | <para> | 2425 | <para> |
2417 | This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>. | 2426 | This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>. |
2418 | The variable is Mandatory. | 2427 | The variable is mandatory. |
2419 | </para> | 2428 | </para> |
2420 | </glossdef> | 2429 | </glossdef> |
2421 | </glossentry> | 2430 | </glossentry> |
@@ -3094,11 +3103,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
3094 | MACHINE ?= "qemux86" | 3103 | MACHINE ?= "qemux86" |
3095 | MACHINE ?= "qemux86-64" | 3104 | MACHINE ?= "qemux86-64" |
3096 | MACHINE ?= "genericx86" | 3105 | MACHINE ?= "genericx86" |
3106 | MACHINE ?= "genericx86-64" | ||
3097 | MACHINE ?= "beagleboard" | 3107 | MACHINE ?= "beagleboard" |
3098 | MACHINE ?= "mpc8315e-rdb" | 3108 | MACHINE ?= "mpc8315e-rdb" |
3099 | MACHINE ?= "routerstationpro" | 3109 | MACHINE ?= "routerstationpro" |
3100 | </literallayout> | 3110 | </literallayout> |
3101 | The last four are Yocto Project reference hardware boards, which | 3111 | The last five are Yocto Project reference hardware boards, which |
3102 | are provided in the <filename>meta-yocto-bsp</filename> layer. | 3112 | are provided in the <filename>meta-yocto-bsp</filename> layer. |
3103 | <note>Adding additional Board Support Package (BSP) layers | 3113 | <note>Adding additional Board Support Package (BSP) layers |
3104 | to your configuration adds new possible settings for | 3114 | to your configuration adds new possible settings for |
@@ -3477,7 +3487,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
3477 | <note> | 3487 | <note> |
3478 | Some recommended packages might be required for certain | 3488 | Some recommended packages might be required for certain |
3479 | system functionality, such as kernel modules. | 3489 | system functionality, such as kernel modules. |
3480 | It is up to you to add packages with | 3490 | It is up to you to add packages with the |
3481 | <link linkend='var-IMAGE_INSTALL'><filename>IMAGE_INSTALL</filename></link> | 3491 | <link linkend='var-IMAGE_INSTALL'><filename>IMAGE_INSTALL</filename></link> |
3482 | variable. | 3492 | variable. |
3483 | </note> | 3493 | </note> |
@@ -3656,7 +3666,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
3656 | <para>Enables easily adding packages to | 3666 | <para>Enables easily adding packages to |
3657 | <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> | 3667 | <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> |
3658 | before <filename>${<link linkend='var-PN'>PN</link>}</filename> | 3668 | before <filename>${<link linkend='var-PN'>PN</link>}</filename> |
3659 | so that the packages can pick up files that would normally be | 3669 | so that those added packages can pick up files that would normally be |
3660 | included in the default package.</para> | 3670 | included in the default package.</para> |
3661 | </glossdef> | 3671 | </glossdef> |
3662 | </glossentry> | 3672 | </glossentry> |
@@ -3874,7 +3884,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
3874 | <literallayout class='monospaced'> | 3884 | <literallayout class='monospaced'> |
3875 | PACKAGECONFIG="f4 f5" | 3885 | PACKAGECONFIG="f4 f5" |
3876 | </literallayout> | 3886 | </literallayout> |
3877 | Or, you can just amended the variable: | 3887 | Or, you can just append the variable: |
3878 | <literallayout class='monospaced'> | 3888 | <literallayout class='monospaced'> |
3879 | PACKAGECONFIG_append = " f4" | 3889 | PACKAGECONFIG_append = " f4" |
3880 | </literallayout></para></listitem> | 3890 | </literallayout></para></listitem> |
@@ -3984,15 +3994,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
3984 | </glossdef> | 3994 | </glossdef> |
3985 | </glossentry> | 3995 | </glossentry> |
3986 | 3996 | ||
3987 | |||
3988 | |||
3989 | |||
3990 | PARALLEL_MAKEINST with the description ". | ||
3991 | |||
3992 | |||
3993 | |||
3994 | |||
3995 | |||
3996 | <glossentry id='var-PATCHRESOLVE'><glossterm>PATCHRESOLVE</glossterm> | 3997 | <glossentry id='var-PATCHRESOLVE'><glossterm>PATCHRESOLVE</glossterm> |
3997 | <glossdef> | 3998 | <glossdef> |
3998 | <para> | 3999 | <para> |
@@ -4089,6 +4090,11 @@ PARALLEL_MAKEINST with the description ". | |||
4089 | <filename>do_packagedata</filename> task packages | 4090 | <filename>do_packagedata</filename> task packages |
4090 | data for each recipe and installs it into this temporary, | 4091 | data for each recipe and installs it into this temporary, |
4091 | shared area. | 4092 | shared area. |
4093 | This directory defaults to the following: | ||
4094 | <literallayout class='monospaced'> | ||
4095 | ${STAGING_DIR_HOST}/pkgdata | ||
4096 | </literallayout> | ||
4097 | Do not change this default. | ||
4092 | </para> | 4098 | </para> |
4093 | </glossdef> | 4099 | </glossdef> |
4094 | </glossentry> | 4100 | </glossentry> |
@@ -4174,9 +4180,11 @@ PARALLEL_MAKEINST with the description ". | |||
4174 | provided item, and you should set it to the | 4180 | provided item, and you should set it to the |
4175 | <link linkend='var-PN'><filename>PN</filename></link> | 4181 | <link linkend='var-PN'><filename>PN</filename></link> |
4176 | of the recipe to which you want to give precedence. | 4182 | of the recipe to which you want to give precedence. |
4177 | Here is an example: | 4183 | Some examples: |
4178 | <literallayout class='monospaced'> | 4184 | <literallayout class='monospaced'> |
4185 | PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto" | ||
4179 | PREFERRED_PROVIDER_virtual/xserver = "xserver-xf86" | 4186 | PREFERRED_PROVIDER_virtual/xserver = "xserver-xf86" |
4187 | PREFERRED_PROVIDER_virtual/libgl ?= "mesa" | ||
4180 | </literallayout> | 4188 | </literallayout> |
4181 | </para> | 4189 | </para> |
4182 | </glossdef> | 4190 | </glossdef> |
@@ -4189,7 +4197,7 @@ PARALLEL_MAKEINST with the description ". | |||
4189 | variable determines which recipe should be given preference. | 4197 | variable determines which recipe should be given preference. |
4190 | You must always suffix the variable with the | 4198 | You must always suffix the variable with the |
4191 | <link linkend='var-PN'><filename>PN</filename></link> | 4199 | <link linkend='var-PN'><filename>PN</filename></link> |
4192 | you want to select, and you should set to the | 4200 | you want to select, and you should set the |
4193 | <link linkend='var-PV'><filename>PV</filename></link> | 4201 | <link linkend='var-PV'><filename>PV</filename></link> |
4194 | accordingly for precedence. | 4202 | accordingly for precedence. |
4195 | You can use the "<filename>%</filename>" character as a | 4203 | You can use the "<filename>%</filename>" character as a |
@@ -4198,8 +4206,8 @@ PARALLEL_MAKEINST with the description ". | |||
4198 | numbers that could potentially change. | 4206 | numbers that could potentially change. |
4199 | Here are two examples: | 4207 | Here are two examples: |
4200 | <literallayout class='monospaced'> | 4208 | <literallayout class='monospaced'> |
4201 | PREFERRED_VERSION_python = "2.6.6" | 4209 | PREFERRED_VERSION_python = "2.7.3" |
4202 | PREFERRED_VERSION_linux-yocto = "3.0+git%" | 4210 | PREFERRED_VERSION_linux-yocto = "3.10%" |
4203 | </literallayout> | 4211 | </literallayout> |
4204 | </para> | 4212 | </para> |
4205 | </glossdef> | 4213 | </glossdef> |
@@ -4257,7 +4265,7 @@ PARALLEL_MAKEINST with the description ". | |||
4257 | dynamically increment. | 4265 | dynamically increment. |
4258 | This increment minimizes the impact of layer ordering.</para> | 4266 | This increment minimizes the impact of layer ordering.</para> |
4259 | <para>In order to ensure multiple <filename>.bbappend</filename> files can co-exist, | 4267 | <para>In order to ensure multiple <filename>.bbappend</filename> files can co-exist, |
4260 | <filename>PRINC</filename> should be self referencing. | 4268 | <filename>PRINC</filename> should be self-referencing. |
4261 | This variable defaults to 0.</para> | 4269 | This variable defaults to 0.</para> |
4262 | <para>Following is an example that increments <filename>PR</filename> by two: | 4270 | <para>Following is an example that increments <filename>PR</filename> by two: |
4263 | <literallayout class='monospaced'> | 4271 | <literallayout class='monospaced'> |
@@ -4725,7 +4733,7 @@ PARALLEL_MAKEINST with the description ". | |||
4725 | (<filename><link linkend='var-PV'>PV</link></filename>) as | 4733 | (<filename><link linkend='var-PV'>PV</link></filename>) as |
4726 | follows: | 4734 | follows: |
4727 | <literallayout class='monospaced'> | 4735 | <literallayout class='monospaced'> |
4728 | ${WORKDIR}/${PN}-${PV} | 4736 | ${WORKDIR}/${PN}-${PV} |
4729 | </literallayout> | 4737 | </literallayout> |
4730 | As an example, assume a | 4738 | As an example, assume a |
4731 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> | 4739 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> |
@@ -4735,7 +4743,7 @@ PARALLEL_MAKEINST with the description ". | |||
4735 | to keep the unpacked recipe for <filename>db</filename> | 4743 | to keep the unpacked recipe for <filename>db</filename> |
4736 | is the following: | 4744 | is the following: |
4737 | <literallayout class='monospaced'> | 4745 | <literallayout class='monospaced'> |
4738 | ~/poky/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/db-5.1.19 | 4746 | ~/poky/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/db-5.1.19 |
4739 | </literallayout> | 4747 | </literallayout> |
4740 | </para> | 4748 | </para> |
4741 | </glossdef> | 4749 | </glossdef> |
@@ -5232,7 +5240,7 @@ PARALLEL_MAKEINST with the description ". | |||
5232 | Source Directory defines <filename>PV</filename> as | 5240 | Source Directory defines <filename>PV</filename> as |
5233 | follows: | 5241 | follows: |
5234 | <literallayout class='monospaced'> | 5242 | <literallayout class='monospaced'> |
5235 | PV = "1.5.0+git${SRCPV}" | 5243 | PV = "0.12-git${SRCPV}" |
5236 | </literallayout> | 5244 | </literallayout> |
5237 | </para> | 5245 | </para> |
5238 | </glossdef> | 5246 | </glossdef> |
@@ -5843,7 +5851,7 @@ PARALLEL_MAKEINST with the description ". | |||
5843 | For packages that are not dependent on a particular machine, | 5851 | For packages that are not dependent on a particular machine, |
5844 | <filename>WORKDIR</filename> is defined as follows: | 5852 | <filename>WORKDIR</filename> is defined as follows: |
5845 | <literallayout class='monospaced'> | 5853 | <literallayout class='monospaced'> |
5846 | ${TMPDIR}/work/${PACKAGE_ARCH}-poky-${TARGET_OS}/${PN}/${PV}-${PR} | 5854 | ${TMPDIR}/work/${PACKAGE_ARCH}-poky-${TARGET_OS}/${PN}/${PV}-${PR} |
5847 | </literallayout> | 5855 | </literallayout> |
5848 | As an example, assume a | 5856 | As an example, assume a |
5849 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> top-level | 5857 | <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> top-level |
@@ -5859,9 +5867,9 @@ PARALLEL_MAKEINST with the description ". | |||
5859 | 5867 | ||
5860 | <para> | 5868 | <para> |
5861 | For packages that are dependent on a particular machine, <filename>WORKDIR</filename> | 5869 | For packages that are dependent on a particular machine, <filename>WORKDIR</filename> |
5862 | is defined slightly different: | 5870 | is defined slightly differently: |
5863 | <literallayout class='monospaced'> | 5871 | <literallayout class='monospaced'> |
5864 | ${TMPDIR}/work/${MACHINE}-poky-${TARGET_OS}/${PN}/${PV}-${PR} | 5872 | ${TMPDIR}/work/${MACHINE}-poky-${TARGET_OS}/${PN}/${PV}-${PR} |
5865 | </literallayout> | 5873 | </literallayout> |
5866 | As an example, again assume a Source Directory top-level folder | 5874 | As an example, again assume a Source Directory top-level folder |
5867 | named <filename>poky</filename> and a default Build Directory | 5875 | named <filename>poky</filename> and a default Build Directory |