From ddcd91c6d6301b120d96b9ed700f010369ec3577 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 24 Jan 2014 15:44:24 -0600 Subject: bitbake: user-manual-ref-variables.xml: Added 11 new variables to glossary. SRCREV_FORMAT BUILDNAME BB_ENV_WHITELIST BB_PRESERVE_ENV BB_ENV_EXTRAWHITE BB_ORIGENV BB_TASKHASH BITBAKE_UI BBDUBUG BB_DEFAULT_TASK BBINCLUDED (Bitbake rev: 0e3106bfdebfa255b2db08a8a4585516d8bebe20) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../doc/user-manual/user-manual-ref-variables.xml | 164 +++++++++++++++++++++ 1 file changed, 164 insertions(+) (limited to 'bitbake/doc') diff --git a/bitbake/doc/user-manual/user-manual-ref-variables.xml b/bitbake/doc/user-manual/user-manual-ref-variables.xml index 41c10bdc92..7d821ed267 100644 --- a/bitbake/doc/user-manual/user-manual-ref-variables.xml +++ b/bitbake/doc/user-manual/user-manual-ref-variables.xml @@ -112,6 +112,17 @@ + BB_DEFAULT_TASK + + + The default task to use when none is specified (e.g. + with the -c command line option). + The task name specified should not include the + do_ prefix. + + + + BB_DISKMON_DIRS @@ -267,6 +278,44 @@ + BB_ENV_WHITELIST + + + Specifies the internal whitelist of variables to allow + through from the external environment into BitBake's + datastore. + If the value of this variable is not specified + (which is the default), the following list is used: + BBPATH, + BB_PRESERVE_ENV, + BB_ENV_WHITELIST, + and + BB_ENV_EXTRAWHITE. + + You must set this variable in the external environment + in order for it to work. + + + + + + BB_ENV_EXTRAWHITE + + + Specifies an additional set of variables to allow through + (whitelist) from the external environment into BitBake's + datastore. + This list of variables are on top of the internal list + set in + BB_ENV_WHITELIST. + + You must set this variable in the external + environment in order for it to work. + + + + + BB_FETCH_PREMIRRORONLY @@ -451,6 +500,36 @@ + BB_ORIGENV + + + Contains a copy of the original external environment in + which BitBake was run. + The copy is taken before any whitelisted variable values + are filtered into BitBake's datastore. + + The contents of this variable is a datastore object + that can be queried using the normal datastore + operations. + + + + + + BB_PRESERVE_ENV + + + Disables whitelisting and instead allows all variables + through from the external environment into BitBake's + datastore. + + You must set this variable in the external + environment in order for it to work. + + + + + BB_NUMBER_THREADS The maximum number of tasks BitBake should run in parallel at any one time. @@ -703,6 +782,16 @@ + BB_TASKHASH + + + Within an executing task, this variable holds the hash + of the task as returned by the currently enabled + signature generator. + + + + BB_VERBOSE_LOGS @@ -750,6 +839,20 @@ + BBDEBUG + + + Sets the BitBake debug output level to a specific value + as incremented by the -d command line + option. + + You must set this variable in the external environment + in order for it to work. + + + + + BBFILE_COLLECTIONS Lists the names of configured layers. @@ -809,6 +912,16 @@ + BBINCLUDED + + + Contains a space-separated list of all of all files that + BitBake's parser included during parsing of the current + file. + + + + BBINCLUDELOGS Variable that controls how BitBake displays logs on build failure. @@ -928,6 +1041,30 @@ + BITBAKE_UI + + + Used to specify the UI module to use when running BitBake. + Using this variable is equivalent to using the + -u command-line option. + + You must set this variable in the external environment + in order for it to work. + + + + + + BUILDNAME + + + A name assigned to the build. + The name defaults to a datetime stamp of when the build was + started but can be defined by the metadata. + + + + C @@ -1894,6 +2031,33 @@ + SRCREV_FORMAT + + + Helps construct valid + SRCREV + values when multiple source controlled URLs are used in + SRC_URI. + + + + The system needs help constructing these values under these + circumstances. + Each component in the SRC_URI + is assigned a name and these are referenced + in the SRCREV_FORMAT variable. + Consider an example with URLs named "machine" and "meta". + In this case, SRCREV_FORMAT could look + like "machine_meta" and those names would have the SCM + versions substituted into each position. + Only one AUTOINC placeholder is added + and if needed. + And, this placeholder is placed at the start of the + returned string. + + + + STAMP -- cgit v1.2.3-54-g00ecf