mirror of
https://git.yoctoproject.org/poky
synced 2026-06-04 14:09:47 +00:00
docs: fix new override syntax migration
Fix bits missed by the migration script. (From yocto-docs rev: 452e0c5067476fd2ce81f09e6c73da84ced4bbd0) Signed-off-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
committed by
Richard Purdie
parent
ed6482821c
commit
3d93ddf9e8
@@ -207,13 +207,13 @@ following list:
|
|||||||
To make sure your changes apply only when building machine "one",
|
To make sure your changes apply only when building machine "one",
|
||||||
use a machine override with the :term:`DEPENDS` statement::
|
use a machine override with the :term:`DEPENDS` statement::
|
||||||
|
|
||||||
DEPENDS_one = "foo"
|
DEPENDS:one = "foo"
|
||||||
|
|
||||||
You should follow the same strategy when using ``_append``
|
You should follow the same strategy when using ``:append``
|
||||||
and ``_prepend`` operations::
|
and ``:prepend`` operations::
|
||||||
|
|
||||||
DEPENDS:append_one = " foo"
|
DEPENDS:append:one = " foo"
|
||||||
DEPENDS:prepend_one = "foo "
|
DEPENDS:prepend:one = "foo "
|
||||||
|
|
||||||
As an actual example, here's a
|
As an actual example, here's a
|
||||||
snippet from the generic kernel include file ``linux-yocto.inc``,
|
snippet from the generic kernel include file ``linux-yocto.inc``,
|
||||||
@@ -236,8 +236,8 @@ following list:
|
|||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
Avoiding "+=" and "=+" and using machine-specific ``_append``
|
Avoiding "+=" and "=+" and using machine-specific ``:append``
|
||||||
and ``_prepend`` operations is recommended as well.
|
and ``:prepend`` operations is recommended as well.
|
||||||
|
|
||||||
- *Place Machine-Specific Files in Machine-Specific Locations:* When
|
- *Place Machine-Specific Files in Machine-Specific Locations:* When
|
||||||
you have a base recipe, such as ``base-files.bb``, that contains a
|
you have a base recipe, such as ``base-files.bb``, that contains a
|
||||||
@@ -537,7 +537,7 @@ important as it ensures that items in the list remain colon-separated.
|
|||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
BitBake automatically defines the :term:`THISDIR` variable. You should
|
BitBake automatically defines the :term:`THISDIR` variable. You should
|
||||||
never set this variable yourself. Using "_prepend" as part of the
|
never set this variable yourself. Using ":prepend" as part of the
|
||||||
:term:`FILESEXTRAPATHS` ensures your path will be searched prior to other
|
:term:`FILESEXTRAPATHS` ensures your path will be searched prior to other
|
||||||
paths in the final list.
|
paths in the final list.
|
||||||
|
|
||||||
@@ -830,23 +830,23 @@ variable changes are in effect for every build and consequently affect
|
|||||||
all images, which might not be what you require.
|
all images, which might not be what you require.
|
||||||
|
|
||||||
To add a package to your image using the local configuration file, use
|
To add a package to your image using the local configuration file, use
|
||||||
the :term:`IMAGE_INSTALL` variable with the ``_append`` operator::
|
the :term:`IMAGE_INSTALL` variable with the ``:append`` operator::
|
||||||
|
|
||||||
IMAGE_INSTALL:append = " strace"
|
IMAGE_INSTALL:append = " strace"
|
||||||
|
|
||||||
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
|
||||||
``strace`` in this example. This space is required since the ``_append``
|
``strace`` in this example. This space is required since the ``:append``
|
||||||
operator does not add the space.
|
operator does not add the space.
|
||||||
|
|
||||||
Furthermore, you must use ``_append`` instead of the ``+=`` operator if
|
Furthermore, you must use ``:append`` instead of the ``+=`` operator if
|
||||||
you want to avoid ordering issues. The reason for this is because doing
|
you want to avoid ordering issues. The reason for this is because doing
|
||||||
so unconditionally appends to the variable and avoids ordering problems
|
so unconditionally appends to the variable and avoids ordering problems
|
||||||
due to the variable being set in image recipes and ``.bbclass`` files
|
due to the variable being set in image recipes and ``.bbclass`` files
|
||||||
with operators like ``?=``. Using ``_append`` ensures the operation
|
with operators like ``?=``. Using ``:append`` ensures the operation
|
||||||
takes effect.
|
takes effect.
|
||||||
|
|
||||||
As shown in its simplest use, ``IMAGE_INSTALL_append`` affects all
|
As shown in its simplest use, ``IMAGE_INSTALL:append`` affects all
|
||||||
images. It is possible to extend the syntax so that the variable applies
|
images. It is possible to extend the syntax so that the variable applies
|
||||||
to a specific image only. Here is an example::
|
to a specific image only. Here is an example::
|
||||||
|
|
||||||
@@ -1544,8 +1544,8 @@ package for a recipe has the same name as the recipe, and the recipe's
|
|||||||
name can be found through the
|
name can be found through the
|
||||||
``${``\ :term:`PN`\ ``}`` variable, then
|
``${``\ :term:`PN`\ ``}`` variable, then
|
||||||
you specify the dependencies for the main package by setting
|
you specify the dependencies for the main package by setting
|
||||||
``RDEPENDS_${PN}``. If the package were named ``${PN}-tools``, then you
|
``RDEPENDS:${PN}``. If the package were named ``${PN}-tools``, then you
|
||||||
would set ``RDEPENDS_${PN}-tools``, and so forth.
|
would set ``RDEPENDS:${PN}-tools``, and so forth.
|
||||||
|
|
||||||
Some runtime dependencies will be set automatically at packaging time.
|
Some runtime dependencies will be set automatically at packaging time.
|
||||||
These dependencies include any shared library dependencies (i.e. if a
|
These dependencies include any shared library dependencies (i.e. if a
|
||||||
@@ -1796,7 +1796,7 @@ the software being built:
|
|||||||
sure the install portion of the build completes with no issues.
|
sure the install portion of the build completes with no issues.
|
||||||
However, if you wish to install additional files not already being
|
However, if you wish to install additional files not already being
|
||||||
installed by ``make install``, you should do this using a
|
installed by ``make install``, you should do this using a
|
||||||
``do_install_append`` function using the install command as described
|
``do_install:append`` function using the install command as described
|
||||||
in the "Manual" bulleted item later in this list.
|
in the "Manual" bulleted item later in this list.
|
||||||
|
|
||||||
- *Other (using* ``make install``\ *)*: You need to define a ``do_install``
|
- *Other (using* ``make install``\ *)*: You need to define a ``do_install``
|
||||||
@@ -1865,9 +1865,9 @@ additional definitions in your recipe.
|
|||||||
|
|
||||||
If you are adding services and the service initialization script or the
|
If you are adding services and the service initialization script or the
|
||||||
service file itself is not installed, you must provide for that
|
service file itself is not installed, you must provide for that
|
||||||
installation in your recipe using a ``do_install_append`` function. If
|
installation in your recipe using a ``do_install:append`` function. If
|
||||||
your recipe already has a ``do_install`` function, update the function
|
your recipe already has a ``do_install`` function, update the function
|
||||||
near its end rather than adding an additional ``do_install_append``
|
near its end rather than adding an additional ``do_install:append``
|
||||||
function.
|
function.
|
||||||
|
|
||||||
When you create the installation for your services, you need to
|
When you create the installation for your services, you need to
|
||||||
@@ -1938,7 +1938,7 @@ take. The following list describes the process:
|
|||||||
discover problems, you can set
|
discover problems, you can set
|
||||||
:term:`PACKAGES`,
|
:term:`PACKAGES`,
|
||||||
:term:`FILES`,
|
:term:`FILES`,
|
||||||
``do_install(_append)``, and so forth as needed.
|
``do_install(:append)``, and so forth as needed.
|
||||||
|
|
||||||
- *Splitting an Application into Multiple Packages*: If you need to
|
- *Splitting an Application into Multiple Packages*: If you need to
|
||||||
split an application into several packages, see the
|
split an application into several packages, see the
|
||||||
@@ -2137,7 +2137,7 @@ Post-Installation Scripts
|
|||||||
Post-installation scripts run immediately after installing a package on
|
Post-installation scripts run immediately after installing a package on
|
||||||
the target or during image creation when a package is included in an
|
the target or during image creation when a package is included in an
|
||||||
image. To add a post-installation script to a package, add a
|
image. To add a post-installation script to a package, add a
|
||||||
``pkg_postinst_``\ `PACKAGENAME`\ ``()`` function to the recipe file
|
``pkg_postinst:``\ `PACKAGENAME`\ ``()`` function to the recipe file
|
||||||
(``.bb``) and replace `PACKAGENAME` with the name of the package you want
|
(``.bb``) and replace `PACKAGENAME` with the name of the package you want
|
||||||
to attach to the ``postinst`` script. To apply the post-installation
|
to attach to the ``postinst`` script. To apply the post-installation
|
||||||
script to the main package for the recipe, which is usually what is
|
script to the main package for the recipe, which is usually what is
|
||||||
@@ -2147,7 +2147,7 @@ PACKAGENAME.
|
|||||||
|
|
||||||
A post-installation function has the following structure::
|
A post-installation function has the following structure::
|
||||||
|
|
||||||
pkg_postinst_PACKAGENAME() {
|
pkg_postinst:PACKAGENAME() {
|
||||||
# Commands to carry out
|
# Commands to carry out
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -2367,7 +2367,7 @@ In the previous example, we want to ship the ``sxpm`` and ``cxpm``
|
|||||||
binaries in separate packages. Since ``bindir`` would be packaged into
|
binaries in separate packages. Since ``bindir`` would be packaged into
|
||||||
the main :term:`PN` package by default, we prepend the :term:`PACKAGES` variable
|
the main :term:`PN` package by default, we prepend the :term:`PACKAGES` variable
|
||||||
so additional package names are added to the start of list. This results
|
so additional package names are added to the start of list. This results
|
||||||
in the extra ``FILES_*`` variables then containing information that
|
in the extra ``FILES:*`` variables then containing information that
|
||||||
define which files and directories go into which packages. Files
|
define which files and directories go into which packages. Files
|
||||||
included by earlier packages are skipped by latter packages. Thus, the
|
included by earlier packages are skipped by latter packages. Thus, the
|
||||||
main :term:`PN` package does not include the above listed files.
|
main :term:`PN` package does not include the above listed files.
|
||||||
@@ -2398,7 +2398,7 @@ configure and compile steps as well as sets things up to grab packages
|
|||||||
from the appropriate area. In particular, this class sets ``noexec`` on
|
from the appropriate area. In particular, this class sets ``noexec`` on
|
||||||
both the :ref:`ref-tasks-configure`
|
both the :ref:`ref-tasks-configure`
|
||||||
and :ref:`ref-tasks-compile` tasks,
|
and :ref:`ref-tasks-compile` tasks,
|
||||||
sets ``FILES_${PN}`` to "/" so that it picks up all files, and sets up a
|
sets ``FILES:${PN}`` to "/" so that it picks up all files, and sets up a
|
||||||
:ref:`ref-tasks-install` task, which
|
:ref:`ref-tasks-install` task, which
|
||||||
effectively copies all files from ``${S}`` to ``${D}``. The
|
effectively copies all files from ``${S}`` to ``${D}``. The
|
||||||
``bin_package`` class works well when the files extracted into ``${S}``
|
``bin_package`` class works well when the files extracted into ``${S}``
|
||||||
@@ -2459,7 +2459,7 @@ doing the following:
|
|||||||
|
|
||||||
- Ensure that you set up :term:`FILES`
|
- Ensure that you set up :term:`FILES`
|
||||||
(usually
|
(usually
|
||||||
``FILES_${``\ :term:`PN`\ ``}``) to
|
``FILES:${``\ :term:`PN`\ ``}``) to
|
||||||
point to the files you have installed, which of course depends on
|
point to the files you have installed, which of course depends on
|
||||||
where you have installed them and whether those files are in
|
where you have installed them and whether those files are in
|
||||||
different locations than the defaults.
|
different locations than the defaults.
|
||||||
@@ -2631,7 +2631,7 @@ in the BitBake User Manual.
|
|||||||
|
|
||||||
VAR =+ "Starts"
|
VAR =+ "Starts"
|
||||||
|
|
||||||
- *Appending (_append):* Use the ``_append`` operator to append values
|
- *Appending (:append):* Use the ``:append`` operator to append values
|
||||||
to existing variables. This operator does not add any additional
|
to existing variables. This operator does not add any additional
|
||||||
space. Also, the operator is applied after all the ``+=``, and ``=+``
|
space. Also, the operator is applied after all the ``+=``, and ``=+``
|
||||||
operators have been applied and after all ``=`` assignments have
|
operators have been applied and after all ``=`` assignments have
|
||||||
@@ -2644,12 +2644,12 @@ in the BitBake User Manual.
|
|||||||
SRC_URI:append = " file://fix-makefile.patch"
|
SRC_URI:append = " file://fix-makefile.patch"
|
||||||
|
|
||||||
You can also use
|
You can also use
|
||||||
the ``_append`` operator with overrides, which results in the actions
|
the ``:append`` operator with overrides, which results in the actions
|
||||||
only being performed for the specified target or machine::
|
only being performed for the specified target or machine::
|
||||||
|
|
||||||
SRC_URI:append:sh4 = " file://fix-makefile.patch"
|
SRC_URI:append:sh4 = " file://fix-makefile.patch"
|
||||||
|
|
||||||
- *Prepending (_prepend):* Use the ``_prepend`` operator to prepend
|
- *Prepending (:prepend):* Use the ``:prepend`` operator to prepend
|
||||||
values to existing variables. This operator does not add any
|
values to existing variables. This operator does not add any
|
||||||
additional space. Also, the operator is applied after all the ``+=``,
|
additional space. Also, the operator is applied after all the ``+=``,
|
||||||
and ``=+`` operators have been applied and after all ``=``
|
and ``=+`` operators have been applied and after all ``=``
|
||||||
@@ -2662,7 +2662,7 @@ in the BitBake User Manual.
|
|||||||
CFLAGS:prepend = "-I${S}/myincludes "
|
CFLAGS:prepend = "-I${S}/myincludes "
|
||||||
|
|
||||||
You can also use the
|
You can also use the
|
||||||
``_prepend`` operator with overrides, which results in the actions
|
``:prepend`` operator with overrides, which results in the actions
|
||||||
only being performed for the specified target or machine::
|
only being performed for the specified target or machine::
|
||||||
|
|
||||||
CFLAGS:prepend:sh4 = "-I${S}/myincludes "
|
CFLAGS:prepend:sh4 = "-I${S}/myincludes "
|
||||||
@@ -4538,7 +4538,7 @@ that can help you speed up the build:
|
|||||||
exceptions::
|
exceptions::
|
||||||
|
|
||||||
STATICLIBCONF = "--disable-static"
|
STATICLIBCONF = "--disable-static"
|
||||||
STATICLIBCONF_sqlite3-native = ""
|
STATICLIBCONF:sqlite3-native = ""
|
||||||
EXTRA_OECONF += "${STATICLIBCONF}"
|
EXTRA_OECONF += "${STATICLIBCONF}"
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
@@ -4578,7 +4578,7 @@ can control which static library files (``*.a`` files) get included in
|
|||||||
the built library.
|
the built library.
|
||||||
|
|
||||||
The :term:`PACKAGES` and
|
The :term:`PACKAGES` and
|
||||||
:term:`FILES_* <FILES>` variables in the
|
:term:`FILES:* <FILES>` variables in the
|
||||||
``meta/conf/bitbake.conf`` configuration file define how files installed
|
``meta/conf/bitbake.conf`` configuration file define how files installed
|
||||||
by the ``do_install`` task are packaged. By default, the :term:`PACKAGES`
|
by the ``do_install`` task are packaged. By default, the :term:`PACKAGES`
|
||||||
variable includes ``${PN}-staticdev``, which represents all static
|
variable includes ``${PN}-staticdev``, which represents all static
|
||||||
@@ -6510,8 +6510,8 @@ function in your recipe. The ``do_split_packages`` function searches for
|
|||||||
a pattern of files or directories under a specified path and creates a
|
a pattern of files or directories under a specified path and creates a
|
||||||
package for each one it finds by appending to the
|
package for each one it finds by appending to the
|
||||||
:term:`PACKAGES` variable and
|
:term:`PACKAGES` variable and
|
||||||
setting the appropriate values for ``FILES_packagename``,
|
setting the appropriate values for ``FILES:packagename``,
|
||||||
``RDEPENDS_packagename``, ``DESCRIPTION_packagename``, and so forth.
|
``RDEPENDS:packagename``, ``DESCRIPTION:packagename``, and so forth.
|
||||||
Here is an example from the ``lighttpd`` recipe::
|
Here is an example from the ``lighttpd`` recipe::
|
||||||
|
|
||||||
python populate_packages:prepend () {
|
python populate_packages:prepend () {
|
||||||
@@ -7389,11 +7389,11 @@ The variable can be used in multiple ways, including using suffixes to
|
|||||||
set it for a specific package type and/or package. Note that the order
|
set it for a specific package type and/or package. Note that the order
|
||||||
of precedence is the same as this list:
|
of precedence is the same as this list:
|
||||||
|
|
||||||
- ``PACKAGE_ADD_METADATA_<PKGTYPE>_<PN>``
|
- ``PACKAGE_ADD_METADATA_<PKGTYPE>:<PN>``
|
||||||
|
|
||||||
- ``PACKAGE_ADD_METADATA_<PKGTYPE>``
|
- ``PACKAGE_ADD_METADATA_<PKGTYPE>``
|
||||||
|
|
||||||
- ``PACKAGE_ADD_METADATA_<PN>``
|
- ``PACKAGE_ADD_METADATA:<PN>``
|
||||||
|
|
||||||
- :term:`PACKAGE_ADD_METADATA`
|
- :term:`PACKAGE_ADD_METADATA`
|
||||||
|
|
||||||
@@ -7664,11 +7664,11 @@ configuration file contains the line::
|
|||||||
This line pulls in the
|
This line pulls in the
|
||||||
listed include file that contains numerous lines of exactly that form::
|
listed include file that contains numerous lines of exactly that form::
|
||||||
|
|
||||||
#SRCREV_pn-opkg-native ?= "${AUTOREV}"
|
#SRCREV:pn-opkg-native ?= "${AUTOREV}"
|
||||||
#SRCREV_pn-opkg-sdk ?= "${AUTOREV}"
|
#SRCREV:pn-opkg-sdk ?= "${AUTOREV}"
|
||||||
#SRCREV_pn-opkg ?= "${AUTOREV}"
|
#SRCREV:pn-opkg ?= "${AUTOREV}"
|
||||||
#SRCREV_pn-opkg-utils-native ?= "${AUTOREV}"
|
#SRCREV:pn-opkg-utils-native ?= "${AUTOREV}"
|
||||||
#SRCREV_pn-opkg-utils ?= "${AUTOREV}"
|
#SRCREV:pn-opkg-utils ?= "${AUTOREV}"
|
||||||
SRCREV:pn-gconf-dbus ?= "${AUTOREV}"
|
SRCREV:pn-gconf-dbus ?= "${AUTOREV}"
|
||||||
SRCREV:pn-matchbox-common ?= "${AUTOREV}"
|
SRCREV:pn-matchbox-common ?= "${AUTOREV}"
|
||||||
SRCREV:pn-matchbox-config-gtk ?= "${AUTOREV}"
|
SRCREV:pn-matchbox-config-gtk ?= "${AUTOREV}"
|
||||||
@@ -8941,7 +8941,7 @@ In addition to variable values, the output of the ``bitbake -e`` and
|
|||||||
- After the variable values, all functions appear in the output. For
|
- After the variable values, all functions appear in the output. For
|
||||||
shell functions, variables referenced within the function body are
|
shell functions, variables referenced within the function body are
|
||||||
expanded. If a function has been modified using overrides or using
|
expanded. If a function has been modified using overrides or using
|
||||||
override-style operators like ``_append`` and ``_prepend``, then the
|
override-style operators like ``:append`` and ``:prepend``, then the
|
||||||
final assembled function body appears in the output.
|
final assembled function body appears in the output.
|
||||||
|
|
||||||
Viewing Package Information with ``oe-pkgdata-util``
|
Viewing Package Information with ``oe-pkgdata-util``
|
||||||
|
|||||||
@@ -724,7 +724,7 @@ If the BSP description is in recipe space, you cannot simply list the
|
|||||||
``*.scc`` in the :term:`SRC_URI` statement. You need to use the following
|
``*.scc`` in the :term:`SRC_URI` statement. You need to use the following
|
||||||
form from your kernel append file::
|
form from your kernel append file::
|
||||||
|
|
||||||
SRC_URI:append_myplatform = " \
|
SRC_URI:append:myplatform = " \
|
||||||
file://myplatform;type=kmeta;destsuffix=myplatform \
|
file://myplatform;type=kmeta;destsuffix=myplatform \
|
||||||
"
|
"
|
||||||
|
|
||||||
|
|||||||
@@ -502,23 +502,23 @@ strings in the file from the ``meta-yocto-bsp`` layer upstream.
|
|||||||
KMACHINE:genericx86 ?= "common-pc"
|
KMACHINE:genericx86 ?= "common-pc"
|
||||||
KMACHINE:genericx86-64 ?= "common-pc-64"
|
KMACHINE:genericx86-64 ?= "common-pc-64"
|
||||||
KBRANCH:edgerouter = "standard/edgerouter"
|
KBRANCH:edgerouter = "standard/edgerouter"
|
||||||
KBRANCH_beaglebone = "standard/beaglebone"
|
KBRANCH:beaglebone = "standard/beaglebone"
|
||||||
|
|
||||||
SRCREV_machine:genericx86 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19"
|
SRCREV_machine:genericx86 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19"
|
||||||
SRCREV_machine:genericx86-64 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19"
|
SRCREV_machine:genericx86-64 ?= "d09f2ce584d60ecb7890550c22a80c48b83c2e19"
|
||||||
SRCREV_machine:edgerouter ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d"
|
SRCREV_machine:edgerouter ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d"
|
||||||
SRCREV_machine_beaglebone ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d"
|
SRCREV_machine:beaglebone ?= "b5c8cfda2dfe296410d51e131289fb09c69e1e7d"
|
||||||
|
|
||||||
|
|
||||||
COMPATIBLE_MACHINE:genericx86 = "genericx86"
|
COMPATIBLE_MACHINE:genericx86 = "genericx86"
|
||||||
COMPATIBLE_MACHINE:genericx86-64 = "genericx86-64"
|
COMPATIBLE_MACHINE:genericx86-64 = "genericx86-64"
|
||||||
COMPATIBLE_MACHINE:edgerouter = "edgerouter"
|
COMPATIBLE_MACHINE:edgerouter = "edgerouter"
|
||||||
COMPATIBLE_MACHINE_beaglebone = "beaglebone"
|
COMPATIBLE_MACHINE:beaglebone = "beaglebone"
|
||||||
|
|
||||||
LINUX_VERSION:genericx86 = "4.12.7"
|
LINUX_VERSION:genericx86 = "4.12.7"
|
||||||
LINUX_VERSION:genericx86-64 = "4.12.7"
|
LINUX_VERSION:genericx86-64 = "4.12.7"
|
||||||
LINUX_VERSION:edgerouter = "4.12.10"
|
LINUX_VERSION:edgerouter = "4.12.10"
|
||||||
LINUX_VERSION_beaglebone = "4.12.10"
|
LINUX_VERSION:beaglebone = "4.12.10"
|
||||||
|
|
||||||
This append file
|
This append file
|
||||||
contains statements used to support several BSPs that ship with the
|
contains statements used to support several BSPs that ship with the
|
||||||
@@ -726,7 +726,7 @@ that assigns the :term:`KBUILD_DEFCONFIG` variable based on "raspberrypi2"
|
|||||||
and provides the path to the "in-tree" ``defconfig`` file to be used for
|
and provides the path to the "in-tree" ``defconfig`` file to be used for
|
||||||
a Raspberry Pi 2, which is based on the Broadcom 2708/2709 chipset::
|
a Raspberry Pi 2, which is based on the Broadcom 2708/2709 chipset::
|
||||||
|
|
||||||
KBUILD_DEFCONFIG_raspberrypi2 ?= "bcm2709_defconfig"
|
KBUILD_DEFCONFIG:raspberrypi2 ?= "bcm2709_defconfig"
|
||||||
|
|
||||||
Aside from modifying your kernel recipe and providing your own
|
Aside from modifying your kernel recipe and providing your own
|
||||||
``defconfig`` file, you need to be sure no files or statements set
|
``defconfig`` file, you need to be sure no files or statements set
|
||||||
|
|||||||
@@ -36,7 +36,7 @@ How do I install/not-install the kernel image on the rootfs?
|
|||||||
The kernel image (e.g. ``vmlinuz``) is provided by the
|
The kernel image (e.g. ``vmlinuz``) is provided by the
|
||||||
``kernel-image`` package. Image recipes depend on ``kernel-base``. To
|
``kernel-image`` package. Image recipes depend on ``kernel-base``. To
|
||||||
specify whether or not the kernel image is installed in the generated
|
specify whether or not the kernel image is installed in the generated
|
||||||
root filesystem, override ``RDEPENDS_${KERNEL_PACKAGE_NAME}-base`` to include or not
|
root filesystem, override ``RDEPENDS:${KERNEL_PACKAGE_NAME}-base`` to include or not
|
||||||
include "kernel-image". See the
|
include "kernel-image". See the
|
||||||
":ref:`dev-manual/common-tasks:using .bbappend files in your layer`"
|
":ref:`dev-manual/common-tasks:using .bbappend files in your layer`"
|
||||||
section in the
|
section in the
|
||||||
|
|||||||
@@ -1768,7 +1768,7 @@ It is also worth noting that the end result of these signature
|
|||||||
generators is to make some dependency and hash information available to
|
generators is to make some dependency and hash information available to
|
||||||
the build. This information includes:
|
the build. This information includes:
|
||||||
|
|
||||||
- ``BB_BASEHASH_task-``\ taskname: The base hashes for each task in the
|
- ``BB_BASEHASH:task-``\ taskname: The base hashes for each task in the
|
||||||
recipe.
|
recipe.
|
||||||
|
|
||||||
- ``BB_BASEHASH_``\ filename\ ``:``\ taskname: The base hashes for each
|
- ``BB_BASEHASH_``\ filename\ ``:``\ taskname: The base hashes for each
|
||||||
@@ -2027,7 +2027,7 @@ dependencies, you must manually declare the dependencies.
|
|||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
By default, ``foo-dev`` also has an :term:`RDEPENDS`-style dependency on
|
By default, ``foo-dev`` also has an :term:`RDEPENDS`-style dependency on
|
||||||
``foo``, because the default value of ``RDEPENDS_${PN}-dev`` (set in
|
``foo``, because the default value of ``RDEPENDS:${PN}-dev`` (set in
|
||||||
bitbake.conf) includes "${PN}".
|
bitbake.conf) includes "${PN}".
|
||||||
|
|
||||||
To ensure that the dependency chain is never broken, ``-dev`` and
|
To ensure that the dependency chain is never broken, ``-dev`` and
|
||||||
|
|||||||
@@ -738,7 +738,7 @@ other build process, in which case the basic functionality can be
|
|||||||
defined by the classes it inherits from the OE-Core layer's class
|
defined by the classes it inherits from the OE-Core layer's class
|
||||||
definitions in ``./meta/classes``. Within a recipe you can also define
|
definitions in ``./meta/classes``. Within a recipe you can also define
|
||||||
additional tasks as well as task prerequisites. Recipe syntax through
|
additional tasks as well as task prerequisites. Recipe syntax through
|
||||||
BitBake also supports both ``_prepend`` and ``_append`` operators as a
|
BitBake also supports both ``:prepend`` and ``:append`` operators as a
|
||||||
method of extending task functionality. These operators inject code into
|
method of extending task functionality. These operators inject code into
|
||||||
the beginning or end of a task. For information on these BitBake
|
the beginning or end of a task. For information on these BitBake
|
||||||
operators, see the
|
operators, see the
|
||||||
|
|||||||
@@ -1198,7 +1198,7 @@ Here are the tests you can list with the :term:`WARN_QA` and
|
|||||||
its :term:`PN` value matches something already in :term:`OVERRIDES` (e.g.
|
its :term:`PN` value matches something already in :term:`OVERRIDES` (e.g.
|
||||||
:term:`PN` happens to be the same as :term:`MACHINE` or
|
:term:`PN` happens to be the same as :term:`MACHINE` or
|
||||||
:term:`DISTRO`), it can have unexpected consequences.
|
:term:`DISTRO`), it can have unexpected consequences.
|
||||||
For example, assignments such as ``FILES_${PN} = "xyz"`` effectively
|
For example, assignments such as ``FILES:${PN} = "xyz"`` effectively
|
||||||
turn into ``FILES = "xyz"``.
|
turn into ``FILES = "xyz"``.
|
||||||
|
|
||||||
- ``rpaths:`` Checks for rpaths in the binaries that contain build
|
- ``rpaths:`` Checks for rpaths in the binaries that contain build
|
||||||
@@ -1224,7 +1224,7 @@ Here are the tests you can list with the :term:`WARN_QA` and
|
|||||||
|
|
||||||
- ``unlisted-pkg-lics:`` Checks that all declared licenses applying
|
- ``unlisted-pkg-lics:`` Checks that all declared licenses applying
|
||||||
for a package are also declared on the recipe level (i.e. any license
|
for a package are also declared on the recipe level (i.e. any license
|
||||||
in ``LICENSE_*`` should appear in :term:`LICENSE`).
|
in ``LICENSE:*`` should appear in :term:`LICENSE`).
|
||||||
|
|
||||||
- ``useless-rpaths:`` Checks for dynamic library load paths (rpaths)
|
- ``useless-rpaths:`` Checks for dynamic library load paths (rpaths)
|
||||||
in the binaries that by default on a standard system are searched by
|
in the binaries that by default on a standard system are searched by
|
||||||
@@ -1621,7 +1621,7 @@ a couple different ways:
|
|||||||
BBCLASSEXTEND = "native"
|
BBCLASSEXTEND = "native"
|
||||||
|
|
||||||
Inside the
|
Inside the
|
||||||
recipe, use ``_class-native`` and ``_class-target`` overrides to
|
recipe, use ``:class-native`` and ``:class-target`` overrides to
|
||||||
specify any functionality specific to the respective native or target
|
specify any functionality specific to the respective native or target
|
||||||
case.
|
case.
|
||||||
|
|
||||||
@@ -1652,7 +1652,7 @@ couple different ways:
|
|||||||
BBCLASSEXTEND = "nativesdk"
|
BBCLASSEXTEND = "nativesdk"
|
||||||
|
|
||||||
Inside the
|
Inside the
|
||||||
recipe, use ``_class-nativesdk`` and ``_class-target`` overrides to
|
recipe, use ``:class-nativesdk`` and ``:class-target`` overrides to
|
||||||
specify any functionality specific to the respective SDK machine or
|
specify any functionality specific to the respective SDK machine or
|
||||||
target case.
|
target case.
|
||||||
|
|
||||||
|
|||||||
@@ -263,7 +263,7 @@ Errors and Warnings
|
|||||||
|
|
||||||
The ``/usr/share/info/dir`` should not be packaged. Add the following
|
The ``/usr/share/info/dir`` should not be packaged. Add the following
|
||||||
line to your :ref:`ref-tasks-install` task or to your
|
line to your :ref:`ref-tasks-install` task or to your
|
||||||
``do_install_append`` within the recipe as follows::
|
``do_install:append`` within the recipe as follows::
|
||||||
|
|
||||||
rm ${D}${infodir}/dir
|
rm ${D}${infodir}/dir
|
||||||
|
|
||||||
@@ -347,7 +347,7 @@ Errors and Warnings
|
|||||||
|
|
||||||
.. _qa-check-dep-cmp:
|
.. _qa-check-dep-cmp:
|
||||||
|
|
||||||
- ``<var>_<packagename> is invalid: <comparison> (<value>) only comparisons <, =, >, <=, and >= are allowed [dep-cmp]``
|
- ``<var>:<packagename> is invalid: <comparison> (<value>) only comparisons <, =, >, <=, and >= are allowed [dep-cmp]``
|
||||||
|
|
||||||
If you are adding a versioned dependency relationship to one of the
|
If you are adding a versioned dependency relationship to one of the
|
||||||
dependency variables (:term:`RDEPENDS`,
|
dependency variables (:term:`RDEPENDS`,
|
||||||
@@ -454,14 +454,14 @@ Errors and Warnings
|
|||||||
``pkg_preinst``, ``pkg_postinst``, ``pkg_prerm``, ``pkg_postrm``, and
|
``pkg_preinst``, ``pkg_postinst``, ``pkg_prerm``, ``pkg_postrm``, and
|
||||||
:term:`ALLOW_EMPTY`) should always be set specific
|
:term:`ALLOW_EMPTY`) should always be set specific
|
||||||
to a package (i.e. they should be set with a package name override
|
to a package (i.e. they should be set with a package name override
|
||||||
such as ``RDEPENDS_${PN} = "value"`` rather than
|
such as ``RDEPENDS:${PN} = "value"`` rather than
|
||||||
``RDEPENDS = "value"``). If you receive this error, correct any
|
``RDEPENDS = "value"``). If you receive this error, correct any
|
||||||
assignments to these variables within your recipe.
|
assignments to these variables within your recipe.
|
||||||
|
|
||||||
|
|
||||||
- ``recipe uses DEPENDS_${PN}, should use DEPENDS [pkgvarcheck]``
|
- ``recipe uses DEPENDS:${PN}, should use DEPENDS [pkgvarcheck]``
|
||||||
|
|
||||||
This check looks for instances of setting ``DEPENDS_${PN}``
|
This check looks for instances of setting ``DEPENDS:${PN}``
|
||||||
which is erroneous (:term:`DEPENDS` is a recipe-wide variable and thus
|
which is erroneous (:term:`DEPENDS` is a recipe-wide variable and thus
|
||||||
it is not correct to specify it for a particular package, nor will such
|
it is not correct to specify it for a particular package, nor will such
|
||||||
an assignment actually work.) Set :term:`DEPENDS` instead.
|
an assignment actually work.) Set :term:`DEPENDS` instead.
|
||||||
@@ -524,7 +524,7 @@ Errors and Warnings
|
|||||||
following:
|
following:
|
||||||
|
|
||||||
- Add the files to :term:`FILES` for the package you want them to appear
|
- Add the files to :term:`FILES` for the package you want them to appear
|
||||||
in (e.g. ``FILES_${``\ :term:`PN`\ ``}`` for the main
|
in (e.g. ``FILES:${``\ :term:`PN`\ ``}`` for the main
|
||||||
package).
|
package).
|
||||||
|
|
||||||
- Delete the files at the end of the ``do_install`` task if the
|
- Delete the files at the end of the ``do_install`` task if the
|
||||||
@@ -546,11 +546,11 @@ Errors and Warnings
|
|||||||
|
|
||||||
.. _qa-check-unlisted-pkg-lics:
|
.. _qa-check-unlisted-pkg-lics:
|
||||||
|
|
||||||
- ``LICENSE_<packagename> includes licenses (<licenses>) that are not listed in LICENSE [unlisted-pkg-lics]``
|
- ``LICENSE:<packagename> includes licenses (<licenses>) that are not listed in LICENSE [unlisted-pkg-lics]``
|
||||||
|
|
||||||
The :term:`LICENSE` of the recipe should be a superset
|
The :term:`LICENSE` of the recipe should be a superset
|
||||||
of all the licenses of all packages produced by this recipe. In other
|
of all the licenses of all packages produced by this recipe. In other
|
||||||
words, any license in ``LICENSE_*`` should also appear in
|
words, any license in ``LICENSE:*`` should also appear in
|
||||||
:term:`LICENSE`.
|
:term:`LICENSE`.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -575,7 +575,7 @@ system and gives an overview of their function and contents.
|
|||||||
|
|
||||||
Internally, the :term:`BBCLASSEXTEND` mechanism generates recipe
|
Internally, the :term:`BBCLASSEXTEND` mechanism generates recipe
|
||||||
variants by rewriting variable values and applying overrides such
|
variants by rewriting variable values and applying overrides such
|
||||||
as ``_class-native``. For example, to generate a native version of
|
as ``:class-native``. For example, to generate a native version of
|
||||||
a recipe, a :term:`DEPENDS` on "foo" is rewritten
|
a recipe, a :term:`DEPENDS` on "foo" is rewritten
|
||||||
to a :term:`DEPENDS` on "foo-native".
|
to a :term:`DEPENDS` on "foo-native".
|
||||||
|
|
||||||
@@ -2358,7 +2358,7 @@ system and gives an overview of their function and contents.
|
|||||||
rather than ``/usr/bin``. You can find a list of these
|
rather than ``/usr/bin``. You can find a list of these
|
||||||
variables at the top of the ``meta/conf/bitbake.conf`` file in
|
variables at the top of the ``meta/conf/bitbake.conf`` file in
|
||||||
the :term:`Source Directory`. You will also
|
the :term:`Source Directory`. You will also
|
||||||
find the default values of the various ``FILES_*`` variables in
|
find the default values of the various ``FILES:*`` variables in
|
||||||
this file.
|
this file.
|
||||||
|
|
||||||
If some of the files you provide with the :term:`FILES` variable are
|
If some of the files you provide with the :term:`FILES` variable are
|
||||||
@@ -2427,7 +2427,7 @@ system and gives an overview of their function and contents.
|
|||||||
a :term:`MACHINE`-specific override, which is useful
|
a :term:`MACHINE`-specific override, which is useful
|
||||||
in a BSP layer::
|
in a BSP layer::
|
||||||
|
|
||||||
FILESEXTRAPATHS:prepend_intel-x86-common := "${THISDIR}/${PN}:"
|
FILESEXTRAPATHS:prepend:intel-x86-common := "${THISDIR}/${PN}:"
|
||||||
|
|
||||||
The previous statement appears in the
|
The previous statement appears in the
|
||||||
``linux-yocto-dev.bbappend`` file, which is found in the
|
``linux-yocto-dev.bbappend`` file, which is found in the
|
||||||
@@ -3044,8 +3044,8 @@ system and gives an overview of their function and contents.
|
|||||||
:term:`IMAGE_FSTYPES` prior to using the "inherit image" line.
|
:term:`IMAGE_FSTYPES` prior to using the "inherit image" line.
|
||||||
|
|
||||||
- Due to the way the OpenEmbedded build system processes this
|
- Due to the way the OpenEmbedded build system processes this
|
||||||
variable, you cannot update its contents by using ``_append``
|
variable, you cannot update its contents by using ``:append``
|
||||||
or ``_prepend``. You must use the ``+=`` operator to add one or
|
or ``:prepend``. You must use the ``+=`` operator to add one or
|
||||||
more options to the :term:`IMAGE_FSTYPES` variable.
|
more options to the :term:`IMAGE_FSTYPES` variable.
|
||||||
|
|
||||||
:term:`IMAGE_INSTALL`
|
:term:`IMAGE_INSTALL`
|
||||||
@@ -3303,7 +3303,7 @@ system and gives an overview of their function and contents.
|
|||||||
Specifies a dependency from one image type on another. Here is an
|
Specifies a dependency from one image type on another. Here is an
|
||||||
example from the :ref:`image-live <ref-classes-image-live>` class::
|
example from the :ref:`image-live <ref-classes-image-live>` class::
|
||||||
|
|
||||||
IMAGE_TYPEDEP_live = "ext3"
|
IMAGE_TYPEDEP:live = "ext3"
|
||||||
|
|
||||||
In the previous example, the variable ensures that when "live" is
|
In the previous example, the variable ensures that when "live" is
|
||||||
listed with the :term:`IMAGE_FSTYPES` variable,
|
listed with the :term:`IMAGE_FSTYPES` variable,
|
||||||
@@ -3763,7 +3763,7 @@ system and gives an overview of their function and contents.
|
|||||||
KBRANCH:genericx86 = "standard/base"
|
KBRANCH:genericx86 = "standard/base"
|
||||||
KBRANCH:genericx86-64 = "standard/base"
|
KBRANCH:genericx86-64 = "standard/base"
|
||||||
KBRANCH:edgerouter = "standard/edgerouter"
|
KBRANCH:edgerouter = "standard/edgerouter"
|
||||||
KBRANCH_beaglebone = "standard/beaglebone"
|
KBRANCH:beaglebone = "standard/beaglebone"
|
||||||
|
|
||||||
The :term:`KBRANCH` statements
|
The :term:`KBRANCH` statements
|
||||||
identify the kernel branch to use when building for each supported
|
identify the kernel branch to use when building for each supported
|
||||||
@@ -3791,11 +3791,11 @@ system and gives an overview of their function and contents.
|
|||||||
Here is an example from a "raspberrypi2" :term:`KMACHINE` build that uses
|
Here is an example from a "raspberrypi2" :term:`KMACHINE` build that uses
|
||||||
a ``defconfig`` file named "bcm2709_defconfig"::
|
a ``defconfig`` file named "bcm2709_defconfig"::
|
||||||
|
|
||||||
KBUILD_DEFCONFIG_raspberrypi2 = "bcm2709_defconfig"
|
KBUILD_DEFCONFIG:raspberrypi2 = "bcm2709_defconfig"
|
||||||
|
|
||||||
As an alternative, you can use the following within your append file::
|
As an alternative, you can use the following within your append file::
|
||||||
|
|
||||||
KBUILD_DEFCONFIG:pn-linux-yocto ?= defconfig_file
|
KBUILD_DEFCONFIG:pn-linux-yocto ?= "defconfig_file"
|
||||||
|
|
||||||
For more
|
For more
|
||||||
information on how to use the :term:`KBUILD_DEFCONFIG` variable, see the
|
information on how to use the :term:`KBUILD_DEFCONFIG` variable, see the
|
||||||
@@ -4128,13 +4128,13 @@ system and gives an overview of their function and contents.
|
|||||||
Kernel's ``meta`` branch. As an example take a look in the
|
Kernel's ``meta`` branch. As an example take a look in the
|
||||||
``common/recipes-kernel/linux/linux-yocto_3.19.bbappend`` file::
|
``common/recipes-kernel/linux/linux-yocto_3.19.bbappend`` file::
|
||||||
|
|
||||||
LINUX_VERSION_core2-32-intel-common = "3.19.0"
|
LINUX_VERSION:core2-32-intel-common = "3.19.0"
|
||||||
COMPATIBLE_MACHINE_core2-32-intel-common = "${MACHINE}"
|
COMPATIBLE_MACHINE:core2-32-intel-common = "${MACHINE}"
|
||||||
SRCREV_meta_core2-32-intel-common = "8897ef68b30e7426bc1d39895e71fb155d694974"
|
SRCREV_meta:core2-32-intel-common = "8897ef68b30e7426bc1d39895e71fb155d694974"
|
||||||
SRCREV_machine_core2-32-intel-common = "43b9eced9ba8a57add36af07736344dcc383f711"
|
SRCREV_machine:core2-32-intel-common = "43b9eced9ba8a57add36af07736344dcc383f711"
|
||||||
KMACHINE_core2-32-intel-common = "intel-core2-32"
|
KMACHINE:core2-32-intel-common = "intel-core2-32"
|
||||||
KBRANCH_core2-32-intel-common = "standard/base"
|
KBRANCH:core2-32-intel-common = "standard/base"
|
||||||
KERNEL_FEATURES:append_core2-32-intel-common = "${KERNEL_FEATURES_INTEL_COMMON}"
|
KERNEL_FEATURES:append:core2-32-intel-common = "${KERNEL_FEATURES_INTEL_COMMON}"
|
||||||
|
|
||||||
The :term:`KMACHINE` statement says
|
The :term:`KMACHINE` statement says
|
||||||
that the kernel understands the machine name as "intel-core2-32".
|
that the kernel understands the machine name as "intel-core2-32".
|
||||||
@@ -4322,7 +4322,7 @@ system and gives an overview of their function and contents.
|
|||||||
build system to create an extra package (i.e.
|
build system to create an extra package (i.e.
|
||||||
``${``\ :term:`PN`\ ``}-lic``) for each recipe and to add
|
``${``\ :term:`PN`\ ``}-lic``) for each recipe and to add
|
||||||
those packages to the
|
those packages to the
|
||||||
:term:`RRECOMMENDS`\ ``_${PN}``.
|
:term:`RRECOMMENDS`\ ``:${PN}``.
|
||||||
|
|
||||||
The ``${PN}-lic`` package installs a directory in
|
The ``${PN}-lic`` package installs a directory in
|
||||||
``/usr/share/licenses`` named ``${PN}``, which is the recipe's base
|
``/usr/share/licenses`` named ``${PN}``, which is the recipe's base
|
||||||
@@ -4852,7 +4852,7 @@ system and gives an overview of their function and contents.
|
|||||||
|
|
||||||
:term:`NOAUTOPACKAGEDEBUG`
|
:term:`NOAUTOPACKAGEDEBUG`
|
||||||
Disables auto package from splitting ``.debug`` files. If a recipe
|
Disables auto package from splitting ``.debug`` files. If a recipe
|
||||||
requires ``FILES_${PN}-dbg`` to be set manually, the
|
requires ``FILES:${PN}-dbg`` to be set manually, the
|
||||||
:term:`NOAUTOPACKAGEDEBUG` can be defined allowing you to define the
|
:term:`NOAUTOPACKAGEDEBUG` can be defined allowing you to define the
|
||||||
content of the debug package. For example::
|
content of the debug package. For example::
|
||||||
|
|
||||||
@@ -4955,7 +4955,7 @@ system and gives an overview of their function and contents.
|
|||||||
assignment will override ``FOO`` with the value "overridden" at the
|
assignment will override ``FOO`` with the value "overridden" at the
|
||||||
end of parsing::
|
end of parsing::
|
||||||
|
|
||||||
FOO_an-override = "overridden"
|
FOO:an-override = "overridden"
|
||||||
|
|
||||||
See the
|
See the
|
||||||
":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:conditional syntax (overrides)`"
|
":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:conditional syntax (overrides)`"
|
||||||
@@ -5401,7 +5401,7 @@ system and gives an overview of their function and contents.
|
|||||||
(leftmost) package.
|
(leftmost) package.
|
||||||
|
|
||||||
Packages in the variable's list that are empty (i.e. where none of
|
Packages in the variable's list that are empty (i.e. where none of
|
||||||
the patterns in ``FILES_``\ pkg match any files installed by the
|
the patterns in ``FILES:``\ pkg match any files installed by the
|
||||||
:ref:`ref-tasks-install` task) are not generated,
|
:ref:`ref-tasks-install` task) are not generated,
|
||||||
unless generation is forced through the
|
unless generation is forced through the
|
||||||
:term:`ALLOW_EMPTY` variable.
|
:term:`ALLOW_EMPTY` variable.
|
||||||
@@ -5552,7 +5552,7 @@ system and gives an overview of their function and contents.
|
|||||||
|
|
||||||
For example, when the :ref:`debian <ref-classes-debian>` class
|
For example, when the :ref:`debian <ref-classes-debian>` class
|
||||||
renames the output package, it does so by setting
|
renames the output package, it does so by setting
|
||||||
``PKG_packagename``.
|
``PKG:packagename``.
|
||||||
|
|
||||||
:term:`PKG_CONFIG_PATH`
|
:term:`PKG_CONFIG_PATH`
|
||||||
The path to ``pkg-config`` files for the current build context.
|
The path to ``pkg-config`` files for the current build context.
|
||||||
@@ -5796,7 +5796,7 @@ system and gives an overview of their function and contents.
|
|||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
The ``\_forcevariable`` override is not handled specially. This override
|
The ``:forcevariable`` override is not handled specially. This override
|
||||||
only works because the default value of :term:`OVERRIDES` includes "forcevariable".
|
only works because the default value of :term:`OVERRIDES` includes "forcevariable".
|
||||||
|
|
||||||
If a recipe with the specified version is not available, a warning
|
If a recipe with the specified version is not available, a warning
|
||||||
@@ -6083,10 +6083,10 @@ system and gives an overview of their function and contents.
|
|||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
``RDEPENDS_${PN}-dev`` includes ``${``\ :term:`PN`\ ``}``
|
``RDEPENDS:${PN}-dev`` includes ``${``\ :term:`PN`\ ``}``
|
||||||
by default. This default is set in the BitBake configuration file
|
by default. This default is set in the BitBake configuration file
|
||||||
(``meta/conf/bitbake.conf``). Be careful not to accidentally remove
|
(``meta/conf/bitbake.conf``). Be careful not to accidentally remove
|
||||||
``${PN}`` when modifying ``RDEPENDS_${PN}-dev``. Use the "+=" operator
|
``${PN}`` when modifying ``RDEPENDS:${PN}-dev``. Use the "+=" operator
|
||||||
rather than the "=" operator.
|
rather than the "=" operator.
|
||||||
|
|
||||||
The package names you use with :term:`RDEPENDS` must appear as they would
|
The package names you use with :term:`RDEPENDS` must appear as they would
|
||||||
@@ -6873,7 +6873,7 @@ system and gives an overview of their function and contents.
|
|||||||
defined in the ``meta/conf/bitbake.conf`` configuration file.
|
defined in the ``meta/conf/bitbake.conf`` configuration file.
|
||||||
|
|
||||||
You will see this variable referenced in the default values of
|
You will see this variable referenced in the default values of
|
||||||
``FILES_${PN}``.
|
``FILES:${PN}``.
|
||||||
|
|
||||||
:term:`SOLIBSDEV`
|
:term:`SOLIBSDEV`
|
||||||
Defines the suffix for the development symbolic link (symlink) for
|
Defines the suffix for the development symbolic link (symlink) for
|
||||||
@@ -6882,7 +6882,7 @@ system and gives an overview of their function and contents.
|
|||||||
``meta/conf/bitbake.conf`` configuration file.
|
``meta/conf/bitbake.conf`` configuration file.
|
||||||
|
|
||||||
You will see this variable referenced in the default values of
|
You will see this variable referenced in the default values of
|
||||||
``FILES_${PN}-dev``.
|
``FILES:${PN}-dev``.
|
||||||
|
|
||||||
:term:`SOURCE_MIRROR_FETCH`
|
:term:`SOURCE_MIRROR_FETCH`
|
||||||
When you are fetching files to create a mirror of sources (i.e.
|
When you are fetching files to create a mirror of sources (i.e.
|
||||||
|
|||||||
@@ -73,7 +73,7 @@ adjustments:
|
|||||||
SDK_INHERIT_BLACKLIST
|
SDK_INHERIT_BLACKLIST
|
||||||
is set using the "?=" operator. Consequently, you will need to
|
is set using the "?=" operator. Consequently, you will need to
|
||||||
either define the entire list by using the "=" operator, or you
|
either define the entire list by using the "=" operator, or you
|
||||||
will need to append a value using either "_append" or the "+="
|
will need to append a value using either ":append" or the "+="
|
||||||
operator. You can learn more about these operators in the
|
operator. You can learn more about these operators in the
|
||||||
":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:basic syntax`"
|
":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:basic syntax`"
|
||||||
section of the BitBake User Manual.
|
section of the BitBake User Manual.
|
||||||
@@ -250,7 +250,7 @@ source, you need to do a number of things:
|
|||||||
recipes that depend on lists of other recipes.
|
recipes that depend on lists of other recipes.
|
||||||
|
|
||||||
- Build the "world" target and set
|
- Build the "world" target and set
|
||||||
``EXCLUDE_FROM_WORLD_pn-``\ recipename for the recipes you do not
|
``EXCLUDE_FROM_WORLD:pn-``\ recipename for the recipes you do not
|
||||||
want built. See the
|
want built. See the
|
||||||
:term:`EXCLUDE_FROM_WORLD`
|
:term:`EXCLUDE_FROM_WORLD`
|
||||||
variable for additional information.
|
variable for additional information.
|
||||||
@@ -334,7 +334,7 @@ within it are available. Having these recipes available increases build
|
|||||||
time significantly and increases the size of the SDK installer by 30-80
|
time significantly and increases the size of the SDK installer by 30-80
|
||||||
Mbytes depending on how many recipes are included in your configuration.
|
Mbytes depending on how many recipes are included in your configuration.
|
||||||
|
|
||||||
You can use ``EXCLUDE_FROM_WORLD_pn-``\ recipename for recipes you want
|
You can use ``EXCLUDE_FROM_WORLD:pn-``\ recipename for recipes you want
|
||||||
to exclude. However, it is assumed that you would need to be building
|
to exclude. However, it is assumed that you would need to be building
|
||||||
the "world" target if you want to provide additional items to the SDK.
|
the "world" target if you want to provide additional items to the SDK.
|
||||||
Consequently, building for "world" should not represent undue overhead
|
Consequently, building for "world" should not represent undue overhead
|
||||||
|
|||||||
@@ -1154,7 +1154,7 @@ subdirectory for each package. Apart from some advanced cases, the
|
|||||||
splitting. The :term:`PACKAGES` variable lists all of the packages to be
|
splitting. The :term:`PACKAGES` variable lists all of the packages to be
|
||||||
produced, while the :term:`FILES` variable specifies which files to include
|
produced, while the :term:`FILES` variable specifies which files to include
|
||||||
in each package by using an override to specify the package. For
|
in each package by using an override to specify the package. For
|
||||||
example, ``FILES_${PN}`` specifies the files to go into the main package
|
example, ``FILES:${PN}`` specifies the files to go into the main package
|
||||||
(i.e. the main package has the same name as the recipe and
|
(i.e. the main package has the same name as the recipe and
|
||||||
``${``\ :term:`PN`\ ``}`` evaluates to the
|
``${``\ :term:`PN`\ ``}`` evaluates to the
|
||||||
recipe name). The order of the :term:`PACKAGES` value is significant. For
|
recipe name). The order of the :term:`PACKAGES` value is significant. For
|
||||||
|
|||||||
@@ -70,7 +70,7 @@ things we do within the build system to ensure reproducibility include:
|
|||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
Because of an open bug in GCC, using ``DISTRO_FEATURES_append = " lto"`` or
|
Because of an open bug in GCC, using ``DISTRO_FEATURES:append = " lto"`` or
|
||||||
adding ``-flto`` (Link Time Optimization) to ``CFLAGS`` makes the resulting
|
adding ``-flto`` (Link Time Optimization) to ``CFLAGS`` makes the resulting
|
||||||
binary non-reproducible, in that it depends on the full absolute build path
|
binary non-reproducible, in that it depends on the full absolute build path
|
||||||
to ``recipe-sysroot-native``, so installing the Yocto Project in a different
|
to ``recipe-sysroot-native``, so installing the Yocto Project in a different
|
||||||
|
|||||||
Reference in New Issue
Block a user