From 86243228c7cb70973de509aa74ec6dc5cdc45842 Mon Sep 17 00:00:00 2001 From: Paul Eggleton Date: Tue, 9 Apr 2013 13:38:49 +0100 Subject: ref-manual/ref-variables: add COMPATIBLE_HOST and touch up COMPATIBLE_MACHINE This also necessitated adding HOST_SYS so we can point to it being matched against by COMPATIBLE_HOST; similarly MACHINEOVERRIDES and SOC_FAMILY needed to be added for COMPATIBLE_MACHINE (and while we're at it, let's add DISTROOVERRIDES; however I've drawn the line at OVERRIDES since that ought to be covered by the BitBake manual). Quite a bit of rewriting here to clear up some ambiguity created through article use not specifically associated with subject matter. Also, some recasting to active voice and present tense. (From yocto-docs rev: 4090073899e3dfd0e0e6a17aea8210546f08a942) Signed-off-by: Paul Eggleton Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-variables.xml | 124 +++++++++++++++++++++++++++-- 1 file changed, 116 insertions(+), 8 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 5f2a2a716c..5fd459fc34 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -598,16 +598,34 @@ Core layer for images cannot be removed + COMPATIBLE_HOST + + A regular expression matched against + HOST_SYS + that the OpenEmbedded build system evaulates against + systems with which the recipe works. + You can use the variable to stop recipes from being built + for classes of systems with which the recipes are not + compatible. + Stopping these builds is particularly useful with kernels. + The variable also helps to increase parsing speed + since the build system skips parsing recipes not + compatible with the current system. + + + COMPATIBLE_MACHINE - A regular expression that evaluates to match the machines - with which the recipe works. - You can use the variable to stop recipes from being run - on machines for which they are not compatible. - This is particularly useful with kernels. - The variable also helps to increase parsing speed as - further parsing of the recipe is skipped if it is found - the current machine is not compatible. + A regular expression matched against + MACHINEOVERRIDES + that the OpenEmbedded build system evaluates against + machines with which the recipe works. + You can use the variable to stop recipes from being built + for machines with which the recipes are not compatible. + Stopping these builds is particularly useful with kernels. + The variable also helps to increase parsing speed + since the build system skips parsing recipes not + compatible with the current machine. @@ -869,6 +887,22 @@ Core layer for images cannot be removed + DISTROOVERRIDES + + + This variable lists overrides specific to the current + distribution. + By default, the variable list includes the value of the + DISTRO + variable. + You can extend the variable to apply any variable overrides + you want as part of the distribution and are not + already in OVERRIDES through + some other means. + + + + DL_DIR @@ -1221,6 +1255,33 @@ Core layer for images cannot be removed + HOST_SYS + + + Specifies the system, including the architecture and the + operating system, being built in the context of the current + recipe. + The OpenEmbedded build system automatically sets this + variable. + You do not need to set the variable yourself. + + + + Here are two examples: + + Given a native recipe on a 32-bit + x86 machine running Linux, the value is + "i686-linux". + + Given a recipe being built for a + little-endian MIPS target running Linux, + the value might be "mipsel-linux". + + + + + + I @@ -2336,6 +2397,35 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" + MACHINEOVERRIDES + + + Lists overrides specific to the current machine. + By default, this list includes the value + of MACHINE. + You can extend the list to apply variable overrides for + classes of machines. + For example, all QEMU emulated machines (e.g. qemuarm, + qemux86, and so forth) include a common file named + meta/conf/machine/include/qemu.inc + that prepends MACHINEOVERRIDES with + the following variable override: + + MACHINEOVERRIDES =. "qemuall:" + + Applying an override like qemuall + affects all QEMU emulated machines elsewhere. + Here is an example from the + connman-conf recipe: + + SRC_URI_append_qemuall = "file://wired.config \ + file://wired-setup \ + " + + + + + MAINTAINER The email address of the distribution maintainer. @@ -3016,6 +3106,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" + SOC_FAMILY + + + Groups together machines based upon the same family + of SOC (System On Chip). + You typically set this variable in a common + .inc file that you include in the + configuration files of all the machines. + + You must include + conf/machine/include/soc-family.inc + for this variable to appear in + MACHINEOVERRIDES. + + + + + SPECIAL_PKGSUFFIX -- cgit v1.2.3-54-g00ecf