summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r--documentation/ref-manual/ref-variables.xml2355
1 files changed, 1319 insertions, 1036 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 84c5295046..8d444a4687 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -46,12 +46,12 @@
46 46
47 <glossdiv id='var-glossary-a'><title>A</title> 47 <glossdiv id='var-glossary-a'><title>A</title>
48 48
49 <glossentry id='var-ABIEXTENSION'><glossterm>ABIEXTENSION<imagedata fileref="figures/define-generic.png" /></glossterm> 49 <glossentry id='var-ABIEXTENSION'><glossterm>ABIEXTENSION</glossterm>
50 <info> 50 <info>
51 ABIEXTENSION[doc] = "Extension to the Application Binary Interface (ABI) field of the GNU canonical architecture name (e.g. "eabi")." 51 ABIEXTENSION[doc] = "Extension to the Application Binary Interface (ABI) field of the GNU canonical architecture name (e.g. "eabi")."
52 </info> 52 </info>
53 <glossdef> 53 <glossdef>
54 <para> 54 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
55 Extension to the Application Binary Interface (ABI) 55 Extension to the Application Binary Interface (ABI)
56 field of the GNU canonical architecture name 56 field of the GNU canonical architecture name
57 (e.g. "eabi"). 57 (e.g. "eabi").
@@ -69,12 +69,12 @@
69 </glossdef> 69 </glossdef>
70 </glossentry> 70 </glossentry>
71 71
72 <glossentry id='var-ALLOW_EMPTY'><glossterm>ALLOW_EMPTY<imagedata fileref="figures/define-generic.png" /></glossterm> 72 <glossentry id='var-ALLOW_EMPTY'><glossterm>ALLOW_EMPTY</glossterm>
73 <info> 73 <info>
74 ALLOW_EMPTY[doc] = "Specifies if an output package should still be produced if it is empty." 74 ALLOW_EMPTY[doc] = "Specifies if an output package should still be produced if it is empty."
75 </info> 75 </info>
76 <glossdef> 76 <glossdef>
77 <para> 77 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
78 Specifies if an output package should still be produced if it is empty. 78 Specifies if an output package should still be produced if it is empty.
79 By default, BitBake does not produce empty packages. 79 By default, BitBake does not produce empty packages.
80 This default behavior can cause issues when there is an 80 This default behavior can cause issues when there is an
@@ -94,12 +94,12 @@
94 </glossdef> 94 </glossdef>
95 </glossentry> 95 </glossentry>
96 96
97 <glossentry id='var-ALTERNATIVE'><glossterm>ALTERNATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 97 <glossentry id='var-ALTERNATIVE'><glossterm>ALTERNATIVE</glossterm>
98 <info> 98 <info>
99 ALTERNATIVE[doc] = "Lists commands in a package that need an alternative binary naming scheme." 99 ALTERNATIVE[doc] = "Lists commands in a package that need an alternative binary naming scheme."
100 </info> 100 </info>
101 <glossdef> 101 <glossdef>
102 <para> 102 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
103 Lists commands in a package that need an alternative 103 Lists commands in a package that need an alternative
104 binary naming scheme. 104 binary naming scheme.
105 Sometimes the same command is provided in multiple packages. 105 Sometimes the same command is provided in multiple packages.
@@ -124,12 +124,12 @@
124 </glossdef> 124 </glossdef>
125 </glossentry> 125 </glossentry>
126 126
127 <glossentry id='var-ALTERNATIVE_LINK_NAME'><glossterm>ALTERNATIVE_LINK_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 127 <glossentry id='var-ALTERNATIVE_LINK_NAME'><glossterm>ALTERNATIVE_LINK_NAME</glossterm>
128 <info> 128 <info>
129 ALTERNATIVE_LINK_NAME[doc] = "Used by the alternatives system to map duplicated commands to actual locations." 129 ALTERNATIVE_LINK_NAME[doc] = "Used by the alternatives system to map duplicated commands to actual locations."
130 </info> 130 </info>
131 <glossdef> 131 <glossdef>
132 <para> 132 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
133 Used by the alternatives system to map duplicated commands 133 Used by the alternatives system to map duplicated commands
134 to actual locations. 134 to actual locations.
135 For example, if the <filename>bracket</filename> command 135 For example, if the <filename>bracket</filename> command
@@ -140,6 +140,9 @@
140 <literallayout class='monospaced'> 140 <literallayout class='monospaced'>
141 ALTERNATIVE_LINK_NAME[bracket] = "/usr/bin/[" 141 ALTERNATIVE_LINK_NAME[bracket] = "/usr/bin/["
142 </literallayout> 142 </literallayout>
143 </para>
144
145 <para>
143 In this example, the binary for the 146 In this example, the binary for the
144 <filename>bracket</filename> command (i.e. 147 <filename>bracket</filename> command (i.e.
145 <filename>[</filename>) from the 148 <filename>[</filename>) from the
@@ -160,12 +163,12 @@
160 </glossdef> 163 </glossdef>
161 </glossentry> 164 </glossentry>
162 165
163 <glossentry id='var-ALTERNATIVE_PRIORITY'><glossterm>ALTERNATIVE_PRIORITY<imagedata fileref="figures/define-generic.png" /></glossterm> 166 <glossentry id='var-ALTERNATIVE_PRIORITY'><glossterm>ALTERNATIVE_PRIORITY</glossterm>
164 <info> 167 <info>
165 ALTERNATIVE_PRIORITY[doc] = "Used by the alternatives system to create default priorities for duplicated commands." 168 ALTERNATIVE_PRIORITY[doc] = "Used by the alternatives system to create default priorities for duplicated commands."
166 </info> 169 </info>
167 <glossdef> 170 <glossdef>
168 <para> 171 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
169 Used by the alternatives system to create default 172 Used by the alternatives system to create default
170 priorities for duplicated commands. 173 priorities for duplicated commands.
171 You can use the variable to create a single default 174 You can use the variable to create a single default
@@ -188,12 +191,12 @@
188 </glossdef> 191 </glossdef>
189 </glossentry> 192 </glossentry>
190 193
191 <glossentry id='var-ALTERNATIVE_TARGET'><glossterm>ALTERNATIVE_TARGET<imagedata fileref="figures/define-generic.png" /></glossterm> 194 <glossentry id='var-ALTERNATIVE_TARGET'><glossterm>ALTERNATIVE_TARGET</glossterm>
192 <info> 195 <info>
193 ALTERNATIVE_TARGET[doc] = "Used by the alternatives system to create default link locations for duplicated commands." 196 ALTERNATIVE_TARGET[doc] = "Used by the alternatives system to create default link locations for duplicated commands."
194 </info> 197 </info>
195 <glossdef> 198 <glossdef>
196 <para> 199 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
197 Used by the alternatives system to create default link 200 Used by the alternatives system to create default link
198 locations for duplicated commands. 201 locations for duplicated commands.
199 You can use the variable to create a single default 202 You can use the variable to create a single default
@@ -242,12 +245,12 @@
242 </glossdef> 245 </glossdef>
243 </glossentry> 246 </glossentry>
244 247
245 <glossentry id='var-APPEND'><glossterm>APPEND<imagedata fileref="figures/define-generic.png" /></glossterm> 248 <glossentry id='var-APPEND'><glossterm>APPEND</glossterm>
246 <info> 249 <info>
247 APPEND[doc] = "An override list of append strings for each LABEL." 250 APPEND[doc] = "An override list of append strings for each LABEL."
248 </info> 251 </info>
249 <glossdef> 252 <glossdef>
250 <para> 253 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
251 An override list of append strings for each 254 An override list of append strings for each
252 <link linkend='var-LABELS'><filename>LABEL</filename></link>. 255 <link linkend='var-LABELS'><filename>LABEL</filename></link>.
253 </para> 256 </para>
@@ -260,36 +263,36 @@
260 </glossdef> 263 </glossdef>
261 </glossentry> 264 </glossentry>
262 265
263 <glossentry id='var-AR'><glossterm>AR<imagedata fileref="figures/define-generic.png" /></glossterm> 266 <glossentry id='var-AR'><glossterm>AR</glossterm>
264 <info> 267 <info>
265 AR[doc] = "Minimal command and arguments to run 'ar'." 268 AR[doc] = "Minimal command and arguments to run 'ar'."
266 </info> 269 </info>
267 <glossdef> 270 <glossdef>
268 <para> 271 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
269 The minimal command and arguments used to run 272 The minimal command and arguments used to run
270 <filename>ar</filename>. 273 <filename>ar</filename>.
271 </para> 274 </para>
272 </glossdef> 275 </glossdef>
273 </glossentry> 276 </glossentry>
274 277
275 <glossentry id='var-AS'><glossterm>AS<imagedata fileref="figures/define-generic.png" /></glossterm> 278 <glossentry id='var-AS'><glossterm>AS</glossterm>
276 <info> 279 <info>
277 AS[doc] = "Minimal command and arguments to run the assembler." 280 AS[doc] = "Minimal command and arguments to run the assembler."
278 </info> 281 </info>
279 <glossdef> 282 <glossdef>
280 <para> 283 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
281 The minimal command and arguments used to run the 284 The minimal command and arguments used to run the
282 assembler. 285 assembler.
283 </para> 286 </para>
284 </glossdef> 287 </glossdef>
285 </glossentry> 288 </glossentry>
286 289
287 <glossentry id='var-ASSUME_PROVIDED'><glossterm>ASSUME_PROVIDED<imagedata fileref="figures/define-generic.png" /></glossterm> 290 <glossentry id='var-ASSUME_PROVIDED'><glossterm>ASSUME_PROVIDED</glossterm>
288 <info> 291 <info>
289 ASSUME_PROVIDED[doc] = "Lists recipe names (PN values) BitBake does not attempt to build." 292 ASSUME_PROVIDED[doc] = "Lists recipe names (PN values) BitBake does not attempt to build."
290 </info> 293 </info>
291 <glossdef> 294 <glossdef>
292 <para> 295 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
293 Lists recipe names 296 Lists recipe names
294 (<link linkend='var-PN'><filename>PN</filename></link> 297 (<link linkend='var-PN'><filename>PN</filename></link>
295 values) BitBake does not attempt to build. 298 values) BitBake does not attempt to build.
@@ -307,12 +310,12 @@
307 </glossdef> 310 </glossdef>
308 </glossentry> 311 </glossentry>
309 312
310 <glossentry id='var-ASSUME_SHLIBS'><glossterm>ASSUME_SHLIBS<imagedata fileref="figures/define-generic.png" /></glossterm> 313 <glossentry id='var-ASSUME_SHLIBS'><glossterm>ASSUME_SHLIBS</glossterm>
311 <info> 314 <info>
312 ASSUME_SHLIBS[doc] = Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system." 315 ASSUME_SHLIBS[doc] = Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system."
313 </info> 316 </info>
314 <glossdef> 317 <glossdef>
315 <para> 318 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
316 Provides additional <filename>shlibs</filename> provider 319 Provides additional <filename>shlibs</filename> provider
317 mapping information, which adds to or overwrites the 320 mapping information, which adds to or overwrites the
318 information provided automatically by the system. 321 information provided automatically by the system.
@@ -341,24 +344,24 @@
341 </glossdef> 344 </glossdef>
342 </glossentry> 345 </glossentry>
343 346
344 <glossentry id='var-AUTHOR'><glossterm>AUTHOR<imagedata fileref="figures/define-generic.png" /></glossterm> 347 <glossentry id='var-AUTHOR'><glossterm>AUTHOR</glossterm>
345 <info> 348 <info>
346 AUTHOR[doc] = "Email address used to contact the original author or authors in order to send patches and forward bugs." 349 AUTHOR[doc] = "Email address used to contact the original author or authors in order to send patches and forward bugs."
347 </info> 350 </info>
348 <glossdef> 351 <glossdef>
349 <para> 352 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
350 The email address used to contact the original author 353 The email address used to contact the original author
351 or authors in order to send patches and forward bugs. 354 or authors in order to send patches and forward bugs.
352 </para> 355 </para>
353 </glossdef> 356 </glossdef>
354 </glossentry> 357 </glossentry>
355 358
356 <glossentry id='var-AUTO_LIBNAME_PKGS'><glossterm>AUTO_LIBNAME_PKGS<imagedata fileref="figures/define-generic.png" /></glossterm> 359 <glossentry id='var-AUTO_LIBNAME_PKGS'><glossterm>AUTO_LIBNAME_PKGS</glossterm>
357 <info> 360 <info>
358 AUTO_LIBNAME_PKGS[doc] = "Specifies which packages should be checked for libraries and renamed according to Debian library package naming." 361 AUTO_LIBNAME_PKGS[doc] = "Specifies which packages should be checked for libraries and renamed according to Debian library package naming."
359 </info> 362 </info>
360 <glossdef> 363 <glossdef>
361 <para> 364 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
362 When the 365 When the
363 <link linkend='ref-classes-debian'><filename>debian</filename></link> 366 <link linkend='ref-classes-debian'><filename>debian</filename></link>
364 class is inherited, which is the default behavior, 367 class is inherited, which is the default behavior,
@@ -375,12 +378,12 @@
375 </glossdef> 378 </glossdef>
376 </glossentry> 379 </glossentry>
377 380
378 <glossentry id='var-AUTO_SYSLINUXMENU'><glossterm>AUTO_SYSLINUXMENU<imagedata fileref="figures/define-generic.png" /></glossterm> 381 <glossentry id='var-AUTO_SYSLINUXMENU'><glossterm>AUTO_SYSLINUXMENU</glossterm>
379 <info> 382 <info>
380 AUTO_SYSLINUXMENU[doc] = "Enables creating an automatic menu for the syslinux bootloader." 383 AUTO_SYSLINUXMENU[doc] = "Enables creating an automatic menu for the syslinux bootloader."
381 </info> 384 </info>
382 <glossdef> 385 <glossdef>
383 <para> 386 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
384 Enables creating an automatic menu for the syslinux 387 Enables creating an automatic menu for the syslinux
385 bootloader. 388 bootloader.
386 You must set this variable in your recipe. 389 You must set this variable in your recipe.
@@ -391,12 +394,12 @@
391 </glossdef> 394 </glossdef>
392 </glossentry> 395 </glossentry>
393 396
394 <glossentry id='var-AUTOREV'><glossterm>AUTOREV<imagedata fileref="figures/define-generic.png" /></glossterm> 397 <glossentry id='var-AUTOREV'><glossterm>AUTOREV</glossterm>
395 <info> 398 <info>
396 AUTOREV[doc] = "When SRCREV is set to the value of this variable, it specifies to use the latest source revision in the repository." 399 AUTOREV[doc] = "When SRCREV is set to the value of this variable, it specifies to use the latest source revision in the repository."
397 </info> 400 </info>
398 <glossdef> 401 <glossdef>
399 <para> 402 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
400 When 403 When
401 <filename><link linkend='var-SRCREV'>SRCREV</link></filename> 404 <filename><link linkend='var-SRCREV'>SRCREV</link></filename>
402 is set to the value of this variable, it specifies to use 405 is set to the value of this variable, it specifies to use
@@ -426,12 +429,12 @@
426 </glossdef> 429 </glossdef>
427 </glossentry> 430 </glossentry>
428 431
429 <glossentry id='var-AVAILTUNES'><glossterm>AVAILTUNES<imagedata fileref="figures/define-generic.png" /></glossterm> 432 <glossentry id='var-AVAILTUNES'><glossterm>AVAILTUNES</glossterm>
430 <info> 433 <info>
431 AVAILTUNES[doc] = "The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system." 434 AVAILTUNES[doc] = "The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system."
432 </info> 435 </info>
433 <glossdef> 436 <glossdef>
434 <para id='var-define-AVAILTUNES'> 437 <para id='var-define-AVAILTUNES' role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
435 The list of defined CPU and Application Binary Interface 438 The list of defined CPU and Application Binary Interface
436 (ABI) tunings (i.e. "tunes") available for use by the 439 (ABI) tunings (i.e. "tunes") available for use by the
437 OpenEmbedded build system. 440 OpenEmbedded build system.
@@ -453,11 +456,6 @@
453 "<ulink url='&YOCTO_DOCS_BB_URL;#basic-syntax'>Basic Syntax</ulink>" 456 "<ulink url='&YOCTO_DOCS_BB_URL;#basic-syntax'>Basic Syntax</ulink>"
454 section in the BitBake User Manual for more information. 457 section in the BitBake User Manual for more information.
455 </para> 458 </para>
456<!--
457<para id='var-context-AVAILTUNES'>
458meta/conf/machine/include/<architecture>/arch-<architecture>.inc
459</para>
460-->
461 </glossdef> 459 </glossdef>
462 </glossentry> 460 </glossentry>
463 461
@@ -465,12 +463,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
465 463
466 <glossdiv id='var-glossary-b'><title>B</title> 464 <glossdiv id='var-glossary-b'><title>B</title>
467 465
468 <glossentry id='var-B'><glossterm>B<imagedata fileref="figures/define-generic.png" /></glossterm> 466 <glossentry id='var-B'><glossterm>B</glossterm>
469 <info> 467 <info>
470 B[doc] = "The Build Directory. The OpenEmbedded build system places generated objects into the Build Directory during a recipe's build process." 468 B[doc] = "The Build Directory. The OpenEmbedded build system places generated objects into the Build Directory during a recipe's build process."
471 </info> 469 </info>
472 <glossdef> 470 <glossdef>
473 <para> 471 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
474 The directory within the 472 The directory within the
475 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> 473 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>
476 in which the OpenEmbedded build system places generated 474 in which the OpenEmbedded build system places generated
@@ -480,6 +478,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
480 <literallayout class='monospaced'> 478 <literallayout class='monospaced'>
481 S = "${WORKDIR}/${BP}/" 479 S = "${WORKDIR}/${BP}/"
482 </literallayout> 480 </literallayout>
481 </para>
482
483 <para>
483 You can separate the (<filename>S</filename>) directory 484 You can separate the (<filename>S</filename>) directory
484 and the directory pointed to by the <filename>B</filename> 485 and the directory pointed to by the <filename>B</filename>
485 variable. 486 variable.
@@ -491,12 +492,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
491 </glossdef> 492 </glossdef>
492 </glossentry> 493 </glossentry>
493 494
494 <glossentry id='var-BAD_RECOMMENDATIONS'><glossterm>BAD_RECOMMENDATIONS<imagedata fileref="figures/define-generic.png" /></glossterm> 495 <glossentry id='var-BAD_RECOMMENDATIONS'><glossterm>BAD_RECOMMENDATIONS</glossterm>
495 <info> 496 <info>
496 BAD_RECOMMENDATIONS[doc] = "A list of packages not to install despite being recommended by a recipe. Support for this variable exists only when using the IPK packaging backend." 497 BAD_RECOMMENDATIONS[doc] = "A list of packages not to install despite being recommended by a recipe. Support for this variable exists only when using the IPK packaging backend."
497 </info> 498 </info>
498 <glossdef> 499 <glossdef>
499 <para> 500 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
500 Lists "recommended-only" packages to not install. 501 Lists "recommended-only" packages to not install.
501 Recommended-only packages are packages installed only 502 Recommended-only packages are packages installed only
502 through the 503 through the
@@ -508,6 +509,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
508 <literallayout class='monospaced'> 509 <literallayout class='monospaced'>
509 BAD_RECOMMENDATIONS = "<replaceable>package_name</replaceable> <replaceable>package_name</replaceable> <replaceable>package_name</replaceable> ..." 510 BAD_RECOMMENDATIONS = "<replaceable>package_name</replaceable> <replaceable>package_name</replaceable> <replaceable>package_name</replaceable> ..."
510 </literallayout> 511 </literallayout>
512 </para>
513
514 <para>
511 You can set this variable globally in your 515 You can set this variable globally in your
512 <filename>local.conf</filename> file or you can attach it to 516 <filename>local.conf</filename> file or you can attach it to
513 a specific image recipe by using the recipe name override: 517 a specific image recipe by using the recipe name override:
@@ -542,12 +546,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
542 </glossdef> 546 </glossdef>
543 </glossentry> 547 </glossentry>
544 548
545 <glossentry id='var-BASE_LIB'><glossterm>BASE_LIB<imagedata fileref="figures/define-generic.png" /></glossterm> 549 <glossentry id='var-BASE_LIB'><glossterm>BASE_LIB</glossterm>
546 <info> 550 <info>
547 BASE_LIB[doc] = "The library directory name for the CPU or Application Binary Interface (ABI) tune." 551 BASE_LIB[doc] = "The library directory name for the CPU or Application Binary Interface (ABI) tune."
548 </info> 552 </info>
549 <glossdef> 553 <glossdef>
550 <para> 554 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
551 The library directory name for the CPU or Application 555 The library directory name for the CPU or Application
552 Binary Interface (ABI) tune. 556 Binary Interface (ABI) tune.
553 The <filename>BASE_LIB</filename> applies only in the 557 The <filename>BASE_LIB</filename> applies only in the
@@ -567,24 +571,24 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
567 </glossdef> 571 </glossdef>
568 </glossentry> 572 </glossentry>
569 573
570 <glossentry id='var-BASE_WORKDIR'><glossterm>BASE_WORKDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 574 <glossentry id='var-BASE_WORKDIR'><glossterm>BASE_WORKDIR</glossterm>
571 <info> 575 <info>
572 BASE_WORKDIR[doc] = "Points to the base of the work directory for all recipes." 576 BASE_WORKDIR[doc] = "Points to the base of the work directory for all recipes."
573 </info> 577 </info>
574 <glossdef> 578 <glossdef>
575 <para> 579 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
576 Points to the base of the work directory for all recipes. 580 Points to the base of the work directory for all recipes.
577 The default value is "${TMPDIR}/work". 581 The default value is "${TMPDIR}/work".
578 </para> 582 </para>
579 </glossdef> 583 </glossdef>
580 </glossentry> 584 </glossentry>
581 585
582 <glossentry id='var-BB_DANGLINGAPPENDS_WARNONLY'><glossterm>BB_DANGLINGAPPENDS_WARNONLY<imagedata fileref="figures/define-generic.png" /></glossterm> 586 <glossentry id='var-BB_DANGLINGAPPENDS_WARNONLY'><glossterm>BB_DANGLINGAPPENDS_WARNONLY</glossterm>
583 <info> 587 <info>
584 BB_DANGLINGAPPENDS_WARNONLY[doc] = "Defines how BitBake handles situations where an append file (.bbappend) has no corresponding recipe file (.bb)." 588 BB_DANGLINGAPPENDS_WARNONLY[doc] = "Defines how BitBake handles situations where an append file (.bbappend) has no corresponding recipe file (.bb)."
585 </info> 589 </info>
586 <glossdef> 590 <glossdef>
587 <para> 591 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
588 Defines how BitBake handles situations where an append 592 Defines how BitBake handles situations where an append
589 file (<filename>.bbappend</filename>) has no 593 file (<filename>.bbappend</filename>) has no
590 corresponding recipe file (<filename>.bb</filename>). 594 corresponding recipe file (<filename>.bb</filename>).
@@ -616,12 +620,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
616 </glossdef> 620 </glossdef>
617 </glossentry> 621 </glossentry>
618 622
619 <glossentry id='var-BB_DISKMON_DIRS'><glossterm>BB_DISKMON_DIRS<imagedata fileref="figures/define-generic.png" /></glossterm> 623 <glossentry id='var-BB_DISKMON_DIRS'><glossterm>BB_DISKMON_DIRS</glossterm>
620 <info> 624 <info>
621 BB_DISKMON_DIRS[doc] = "Monitors disk space and available inodes during the build and allows you to control the build based on these parameters." 625 BB_DISKMON_DIRS[doc] = "Monitors disk space and available inodes during the build and allows you to control the build based on these parameters."
622 </info> 626 </info>
623 <glossdef> 627 <glossdef>
624 <para> 628 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
625 Monitors disk space and available inodes during the build 629 Monitors disk space and available inodes during the build
626 and allows you to control the build based on these 630 and allows you to control the build based on these
627 parameters. 631 parameters.
@@ -714,12 +718,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
714 </glossdef> 718 </glossdef>
715 </glossentry> 719 </glossentry>
716 720
717 <glossentry id='var-BB_DISKMON_WARNINTERVAL'><glossterm>BB_DISKMON_WARNINTERVAL<imagedata fileref="figures/define-generic.png" /></glossterm> 721 <glossentry id='var-BB_DISKMON_WARNINTERVAL'><glossterm>BB_DISKMON_WARNINTERVAL</glossterm>
718 <info> 722 <info>
719 BB_DISKMON_WARNINTERVAL[doc] = "Defines the disk space and free inode warning intervals. To set these intervals, define the variable in the conf/local.conf file in the Build Directory." 723 BB_DISKMON_WARNINTERVAL[doc] = "Defines the disk space and free inode warning intervals. To set these intervals, define the variable in the conf/local.conf file in the Build Directory."
720 </info> 724 </info>
721 <glossdef> 725 <glossdef>
722 <para> 726 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
723 Defines the disk space and free inode warning intervals. 727 Defines the disk space and free inode warning intervals.
724 To set these intervals, define the variable in your 728 To set these intervals, define the variable in your
725 <filename>conf/local.conf</filename> file in the 729 <filename>conf/local.conf</filename> file in the
@@ -785,12 +789,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
785 </glossdef> 789 </glossdef>
786 </glossentry> 790 </glossentry>
787 791
788 <glossentry id='var-BB_GENERATE_MIRROR_TARBALLS'><glossterm>BB_GENERATE_MIRROR_TARBALLS<imagedata fileref="figures/define-generic.png" /></glossterm> 792 <glossentry id='var-BB_GENERATE_MIRROR_TARBALLS'><glossterm>BB_GENERATE_MIRROR_TARBALLS</glossterm>
789 <info> 793 <info>
790 BB_GENERATE_MIRROR_TARBALLS[doc] = "Causes tarballs of the Git repositories to be placed in the DL_DIR directory." 794 BB_GENERATE_MIRROR_TARBALLS[doc] = "Causes tarballs of the Git repositories to be placed in the DL_DIR directory."
791 </info> 795 </info>
792 <glossdef> 796 <glossdef>
793 <para> 797 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
794 Causes tarballs of the Git repositories, including the 798 Causes tarballs of the Git repositories, including the
795 Git metadata, to be placed in the 799 Git metadata, to be placed in the
796 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> 800 <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link>
@@ -811,12 +815,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
811 </glossdef> 815 </glossdef>
812 </glossentry> 816 </glossentry>
813 817
814 <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS<imagedata fileref="figures/define-generic.png" /></glossterm> 818 <glossentry id='var-BB_NUMBER_THREADS'><glossterm>BB_NUMBER_THREADS</glossterm>
815 <info> 819 <info>
816 BB_NUMBER_THREADS[doc] = "The maximum number of tasks BitBake should run in parallel at any one time. This variable is automatically configured to be equal to the number of build system cores." 820 BB_NUMBER_THREADS[doc] = "The maximum number of tasks BitBake should run in parallel at any one time. This variable is automatically configured to be equal to the number of build system cores."
817 </info> 821 </info>
818 <glossdef> 822 <glossdef>
819 <para> 823 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
820 The maximum number of tasks BitBake should run in parallel 824 The maximum number of tasks BitBake should run in parallel
821 at any one time. 825 at any one time.
822 The OpenEmbedded build system automatically configures 826 The OpenEmbedded build system automatically configures
@@ -828,12 +832,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
828 </glossdef> 832 </glossdef>
829 </glossentry> 833 </glossentry>
830 834
831 <glossentry id='var-BBCLASSEXTEND'><glossterm>BBCLASSEXTEND<imagedata fileref="figures/define-generic.png" /></glossterm> 835 <glossentry id='var-BBCLASSEXTEND'><glossterm>BBCLASSEXTEND</glossterm>
832 <info> 836 <info>
833 BBCLASSEXTEND[doc] = "Allows you to extend a recipe so that it builds variants of the software. Common variants for recipes are 'native', 'cross', 'nativesdk' and multilibs." 837 BBCLASSEXTEND[doc] = "Allows you to extend a recipe so that it builds variants of the software. Common variants for recipes are 'native', 'cross', 'nativesdk' and multilibs."
834 </info> 838 </info>
835 <glossdef> 839 <glossdef>
836 <para> 840 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
837 Allows you to extend a recipe so that it builds variants of the software. 841 Allows you to extend a recipe so that it builds variants of the software.
838 Common variants for recipes exist such as "natives" like <filename>quilt-native</filename>, 842 Common variants for recipes exist such as "natives" like <filename>quilt-native</filename>,
839 which is a copy of Quilt built to run on the build system; 843 which is a copy of Quilt built to run on the build system;
@@ -855,12 +859,13 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
855 </glossdef> 859 </glossdef>
856 </glossentry> 860 </glossentry>
857 861
858 <glossentry id='var-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS<imagedata fileref="figures/define-generic.png" /></glossterm> 862 <glossentry id='var-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS</glossterm>
859 <info> 863 <info>
860 BBFILE_COLLECTIONS[doc] = "Lists the names of configured layers. These names are used to find the other BBFILE_* variables." 864 BBFILE_COLLECTIONS[doc] = "Lists the names of configured layers. These names are used to find the other BBFILE_* variables."
861 </info> 865 </info>
862 <glossdef> 866 <glossdef>
863 <para>Lists the names of configured layers. 867 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
868 Lists the names of configured layers.
864 These names are used to find the other <filename>BBFILE_*</filename> 869 These names are used to find the other <filename>BBFILE_*</filename>
865 variables. 870 variables.
866 Typically, each layer will append its name to this variable in its 871 Typically, each layer will append its name to this variable in its
@@ -869,27 +874,33 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
869 </glossdef> 874 </glossdef>
870 </glossentry> 875 </glossentry>
871 876
872 <glossentry id='var-BBFILE_PATTERN'><glossterm>BBFILE_PATTERN<imagedata fileref="figures/define-generic.png" /></glossterm> 877 <glossentry id='var-BBFILE_PATTERN'><glossterm>BBFILE_PATTERN</glossterm>
873 <info> 878 <info>
874 BBFILE_PATTERN[doc] = "Variable that expands to match files from BBFILES in a particular layer. This variable is used in the layer.conf file and must be suffixed with the name of a layer." 879 BBFILE_PATTERN[doc] = "Variable that expands to match files from BBFILES in a particular layer. This variable is used in the layer.conf file and must be suffixed with the name of a layer."
875 </info> 880 </info>
876 <glossdef> 881 <glossdef>
877 <para>Variable that expands to match files from 882 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
883 Variable that expands to match files from
878 <link linkend='var-BBFILES'><filename>BBFILES</filename></link> 884 <link linkend='var-BBFILES'><filename>BBFILES</filename></link>
879 in a particular layer. 885 in a particular layer.
880 This variable is used in the <filename>conf/layer.conf</filename> file and must 886 This variable is used in the <filename>conf/layer.conf</filename> file and must
881 be suffixed with the name of the specific layer (e.g. 887 be suffixed with the name of the specific layer (e.g.
882 <filename>BBFILE_PATTERN_emenlow</filename>).</para> 888 <filename>BBFILE_PATTERN_emenlow</filename>).
889 </para>
883 </glossdef> 890 </glossdef>
884 </glossentry> 891 </glossentry>
885 892
886 <glossentry id='var-BBFILE_PRIORITY'><glossterm>BBFILE_PRIORITY<imagedata fileref="figures/define-generic.png" /></glossterm> 893 <glossentry id='var-BBFILE_PRIORITY'><glossterm>BBFILE_PRIORITY</glossterm>
887 <info> 894 <info>
888 BBFILE_PRIORITY[doc] = "Assigns the priority for recipe files in each layer. Setting this variable allows you to prioritize a layer against other layers that contain the same recipe." 895 BBFILE_PRIORITY[doc] = "Assigns the priority for recipe files in each layer. Setting this variable allows you to prioritize a layer against other layers that contain the same recipe."
889 </info> 896 </info>
890 <glossdef> 897 <glossdef>
891 <para>Assigns the priority for recipe files in each layer.</para> 898 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
892 <para>This variable is useful in situations where the same recipe appears in 899 Assigns the priority for recipe files in each layer.
900 </para>
901
902 <para>
903 This variable is useful in situations where the same recipe appears in
893 more than one layer. 904 more than one layer.
894 Setting this variable allows you to prioritize a 905 Setting this variable allows you to prioritize a
895 layer against other layers that contain the same recipe - effectively 906 layer against other layers that contain the same recipe - effectively
@@ -899,8 +910,11 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
899 (<link linkend='var-PV'><filename>PV</filename></link> variable). 910 (<link linkend='var-PV'><filename>PV</filename></link> variable).
900 For example, a layer that has a recipe with a higher <filename>PV</filename> value but for 911 For example, a layer that has a recipe with a higher <filename>PV</filename> value but for
901 which the <filename>BBFILE_PRIORITY</filename> is set to have a lower precedence still has a 912 which the <filename>BBFILE_PRIORITY</filename> is set to have a lower precedence still has a
902 lower precedence.</para> 913 lower precedence.
903 <para>A larger value for the <filename>BBFILE_PRIORITY</filename> variable results in a higher 914 </para>
915
916 <para>
917 A larger value for the <filename>BBFILE_PRIORITY</filename> variable results in a higher
904 precedence. 918 precedence.
905 For example, the value 6 has a higher precedence than the value 5. 919 For example, the value 6 has a higher precedence than the value 5.
906 If not specified, the <filename>BBFILE_PRIORITY</filename> variable is set based on layer 920 If not specified, the <filename>BBFILE_PRIORITY</filename> variable is set based on layer
@@ -909,7 +923,8 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
909 more information. 923 more information.
910 The default priority, if unspecified 924 The default priority, if unspecified
911 for a layer with no dependencies, is the lowest defined priority + 1 925 for a layer with no dependencies, is the lowest defined priority + 1
912 (or 1 if no priorities are defined).</para> 926 (or 1 if no priorities are defined).
927 </para>
913 <tip> 928 <tip>
914 You can use the command <filename>bitbake-layers show-layers</filename> to list 929 You can use the command <filename>bitbake-layers show-layers</filename> to list
915 all configured layers along with their priorities. 930 all configured layers along with their priorities.
@@ -917,30 +932,34 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
917 </glossdef> 932 </glossdef>
918 </glossentry> 933 </glossentry>
919 934
920 <glossentry id='var-BBFILES'><glossterm>BBFILES<imagedata fileref="figures/define-generic.png" /></glossterm> 935 <glossentry id='var-BBFILES'><glossterm>BBFILES</glossterm>
921 <info> 936 <info>
922 BBFILES[doc] = "List of recipe files used by BitBake to build software." 937 BBFILES[doc] = "List of recipe files used by BitBake to build software."
923 </info> 938 </info>
924 <glossdef> 939 <glossdef>
925 <para>List of recipe files used by BitBake to build software.</para> 940 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
941 List of recipe files used by BitBake to build software.
942 </para>
926 </glossdef> 943 </glossdef>
927 </glossentry> 944 </glossentry>
928 945
929 <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS<imagedata fileref="figures/define-generic.png" /></glossterm> 946 <glossentry id='var-BBINCLUDELOGS'><glossterm>BBINCLUDELOGS</glossterm>
930 <info> 947 <info>
931 BBINCLUDELOGS[doc] = "Variable that controls how BitBake displays logs on build failure." 948 BBINCLUDELOGS[doc] = "Variable that controls how BitBake displays logs on build failure."
932 </info> 949 </info>
933 <glossdef> 950 <glossdef>
934 <para>Variable that controls how BitBake displays logs on build failure.</para> 951 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
952 Variable that controls how BitBake displays logs on build failure.
953 </para>
935 </glossdef> 954 </glossdef>
936 </glossentry> 955 </glossentry>
937 956
938 <glossentry id='var-BBINCLUDELOGS_LINES'><glossterm>BBINCLUDELOGS_LINES<imagedata fileref="figures/define-generic.png" /></glossterm> 957 <glossentry id='var-BBINCLUDELOGS_LINES'><glossterm>BBINCLUDELOGS_LINES</glossterm>
939 <info> 958 <info>
940 BBINCLUDELOGS_LINES[doc] = "Amount of log lines printed on failure." 959 BBINCLUDELOGS_LINES[doc] = "Amount of log lines printed on failure."
941 </info> 960 </info>
942 <glossdef> 961 <glossdef>
943 <para> 962 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
944 If 963 If
945 <link linkend='var-BBINCLUDELOGS'><filename>BBINCLUDELOGS</filename></link> 964 <link linkend='var-BBINCLUDELOGS'><filename>BBINCLUDELOGS</filename></link>
946 is set, specifies the maximum number of lines from the 965 is set, specifies the maximum number of lines from the
@@ -951,12 +970,13 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
951 </glossdef> 970 </glossdef>
952 </glossentry> 971 </glossentry>
953 972
954 <glossentry id='var-BBLAYERS'><glossterm>BBLAYERS<imagedata fileref="figures/define-generic.png" /></glossterm> 973 <glossentry id='var-BBLAYERS'><glossterm>BBLAYERS</glossterm>
955 <info> 974 <info>
956 BBLAYERS[doc] = "Lists the layers to enable during the build. This variable is defined in the bblayers.conf configuration file." 975 BBLAYERS[doc] = "Lists the layers to enable during the build. This variable is defined in the bblayers.conf configuration file."
957 </info> 976 </info>
958 <glossdef> 977 <glossdef>
959 <para>Lists the layers to enable during the build. 978 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
979 Lists the layers to enable during the build.
960 This variable is defined in the <filename>bblayers.conf</filename> configuration 980 This variable is defined in the <filename>bblayers.conf</filename> configuration
961 file in the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. 981 file in the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
962 Here is an example: 982 Here is an example:
@@ -973,18 +993,22 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
973 /home/scottrif/poky/meta-yocto \ 993 /home/scottrif/poky/meta-yocto \
974 " 994 "
975 </literallayout> 995 </literallayout>
996 </para>
997
998 <para>
976 This example enables four layers, one of which is a custom, user-defined layer 999 This example enables four layers, one of which is a custom, user-defined layer
977 named <filename>meta-mykernel</filename>. 1000 named <filename>meta-mykernel</filename>.
978 </para> 1001 </para>
979 </glossdef> 1002 </glossdef>
980 </glossentry> 1003 </glossentry>
981 1004
982 <glossentry id='var-BBLAYERS_NON_REMOVABLE'><glossterm>BBLAYERS_NON_REMOVABLE<imagedata fileref="figures/define-generic.png" /></glossterm> 1005 <glossentry id='var-BBLAYERS_NON_REMOVABLE'><glossterm>BBLAYERS_NON_REMOVABLE</glossterm>
983 <info> 1006 <info>
984 BBLAYERS_NON_REMOVABLE[doc] = "Lists core layers that cannot be removed from the bblayers.conf file." 1007 BBLAYERS_NON_REMOVABLE[doc] = "Lists core layers that cannot be removed from the bblayers.conf file."
985 </info> 1008 </info>
986 <glossdef> 1009 <glossdef>
987 <para>Lists core layers that cannot be removed from the 1010 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1011 Lists core layers that cannot be removed from the
988 <filename>bblayers.conf</filename> file during a build 1012 <filename>bblayers.conf</filename> file during a build
989 using the 1013 using the
990 <ulink url='https://www.yoctoproject.org/tools-resources/projects/hob'>Hob</ulink>. 1014 <ulink url='https://www.yoctoproject.org/tools-resources/projects/hob'>Hob</ulink>.
@@ -992,6 +1016,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
992 When building an image outside of Hob, this variable 1016 When building an image outside of Hob, this variable
993 is ignored. 1017 is ignored.
994 </note> 1018 </note>
1019 </para>
1020
1021 <para>
995 In order for BitBake to build your image using Hob, your 1022 In order for BitBake to build your image using Hob, your
996 <filename>bblayers.conf</filename> file must include the 1023 <filename>bblayers.conf</filename> file must include the
997 <filename>meta</filename> and <filename>meta-yocto</filename> 1024 <filename>meta</filename> and <filename>meta-yocto</filename>
@@ -1015,12 +1042,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1015 </glossdef> 1042 </glossdef>
1016 </glossentry> 1043 </glossentry>
1017 1044
1018 <glossentry id='var-BBMASK'><glossterm>BBMASK<imagedata fileref="figures/define-generic.png" /></glossterm> 1045 <glossentry id='var-BBMASK'><glossterm>BBMASK</glossterm>
1019 <glossdef> 1046 <glossdef>
1020 <info> 1047 <info>
1021 BBMASK[doc] = "Prevents BitBake from processing specific recipes or recipe append files. Use the BBMASK variable from within conf/local.conf." 1048 BBMASK[doc] = "Prevents BitBake from processing specific recipes or recipe append files. Use the BBMASK variable from within conf/local.conf."
1022 </info> 1049 </info>
1023 <para> 1050 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1024 Prevents BitBake from processing recipes and recipe 1051 Prevents BitBake from processing recipes and recipe
1025 append files. 1052 append files.
1026 Use the <filename>BBMASK</filename> variable from within the 1053 Use the <filename>BBMASK</filename> variable from within the
@@ -1078,12 +1105,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1078 </glossdef> 1105 </glossdef>
1079 </glossentry> 1106 </glossentry>
1080 1107
1081 <glossentry id='var-BBPATH'><glossterm>BBPATH<imagedata fileref="figures/define-generic.png" /></glossterm> 1108 <glossentry id='var-BBPATH'><glossterm>BBPATH</glossterm>
1082 <info> 1109 <info>
1083 BBPATH[doc] = "Used by BitBake to locate .bbclass and configuration files. This variable is analogous to the PATH variable." 1110 BBPATH[doc] = "Used by BitBake to locate .bbclass and configuration files. This variable is analogous to the PATH variable."
1084 </info> 1111 </info>
1085 <glossdef> 1112 <glossdef>
1086 <para> 1113 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1087 Used by BitBake to locate 1114 Used by BitBake to locate
1088 <filename>.bbclass</filename> and configuration files. 1115 <filename>.bbclass</filename> and configuration files.
1089 This variable is analogous to the 1116 This variable is analogous to the
@@ -1106,12 +1133,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1106 </glossdef> 1133 </glossdef>
1107 </glossentry> 1134 </glossentry>
1108 1135
1109 <glossentry id='var-BBSERVER'><glossterm>BBSERVER<imagedata fileref="figures/define-generic.png" /></glossterm> 1136 <glossentry id='var-BBSERVER'><glossterm>BBSERVER</glossterm>
1110 <info> 1137 <info>
1111 BBSERVER[doc] = "Points to the server that runs memory-resident BitBake." 1138 BBSERVER[doc] = "Points to the server that runs memory-resident BitBake."
1112 </info> 1139 </info>
1113 <glossdef> 1140 <glossdef>
1114 <para> 1141 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1115 Points to the server that runs memory-resident BitBake. 1142 Points to the server that runs memory-resident BitBake.
1116 This variable is set by the 1143 This variable is set by the
1117 <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link> 1144 <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>
@@ -1122,6 +1149,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1122 <literallayout class='monospaced'> 1149 <literallayout class='monospaced'>
1123 export BBSERVER=localhost:$port 1150 export BBSERVER=localhost:$port
1124 </literallayout> 1151 </literallayout>
1152 </para>
1153
1154 <para>
1125 For more information on how the 1155 For more information on how the
1126 <filename>BBSERVER</filename> is used, see the 1156 <filename>BBSERVER</filename> is used, see the
1127 <filename>oe-init-build-env-memres</filename> script, which 1157 <filename>oe-init-build-env-memres</filename> script, which
@@ -1131,12 +1161,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1131 </glossdef> 1161 </glossdef>
1132 </glossentry> 1162 </glossentry>
1133 1163
1134 <glossentry id='var-BINCONFIG'><glossterm>BINCONFIG<imagedata fileref="figures/define-generic.png" /></glossterm> 1164 <glossentry id='var-BINCONFIG'><glossterm>BINCONFIG</glossterm>
1135 <info> 1165 <info>
1136 BINCONFIG[doc] = "When inheriting the binconfig-disabled class, this variable specifies binary configuration scripts to disable in favor of using pkg-config to query the information." 1166 BINCONFIG[doc] = "When inheriting the binconfig-disabled class, this variable specifies binary configuration scripts to disable in favor of using pkg-config to query the information."
1137 </info> 1167 </info>
1138 <glossdef> 1168 <glossdef>
1139 <para> 1169 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1140 When inheriting the 1170 When inheriting the
1141 <link linkend='ref-classes-binconfig-disabled'><filename>binconfig-disabled</filename></link> 1171 <link linkend='ref-classes-binconfig-disabled'><filename>binconfig-disabled</filename></link>
1142 class, this variable specifies binary configuration 1172 class, this variable specifies binary configuration
@@ -1158,12 +1188,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1158 </glossdef> 1188 </glossdef>
1159 </glossentry> 1189 </glossentry>
1160 1190
1161 <glossentry id='var-BINCONFIG_GLOB'><glossterm>BINCONFIG_GLOB<imagedata fileref="figures/define-generic.png" /></glossterm> 1191 <glossentry id='var-BINCONFIG_GLOB'><glossterm>BINCONFIG_GLOB</glossterm>
1162 <info> 1192 <info>
1163 BINCONFIG_GLOB[doc] = "When inheriting binconfig.bbclass from a recipe, this variable specifies a wildcard for configuration scripts that need editing." 1193 BINCONFIG_GLOB[doc] = "When inheriting binconfig.bbclass from a recipe, this variable specifies a wildcard for configuration scripts that need editing."
1164 </info> 1194 </info>
1165 <glossdef> 1195 <glossdef>
1166 <para> 1196 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1167 When inheriting the 1197 When inheriting the
1168 <link linkend='ref-classes-binconfig'><filename>binconfig</filename></link> 1198 <link linkend='ref-classes-binconfig'><filename>binconfig</filename></link>
1169 class, this variable specifies a wildcard for 1199 class, this variable specifies a wildcard for
@@ -1185,27 +1215,30 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1185 </glossdef> 1215 </glossdef>
1186 </glossentry> 1216 </glossentry>
1187 1217
1188 <glossentry id='var-BP'><glossterm>BP<imagedata fileref="figures/define-generic.png" /></glossterm> 1218 <glossentry id='var-BP'><glossterm>BP</glossterm>
1189 <info> 1219 <info>
1190 BP[doc] = "The base recipe name and version but without any special recipe name suffix (i.e. -native, lib64-, and so forth). BP is comprised of ${BPN}-${PV}" 1220 BP[doc] = "The base recipe name and version but without any special recipe name suffix (i.e. -native, lib64-, and so forth). BP is comprised of ${BPN}-${PV}"
1191 </info> 1221 </info>
1192 <glossdef> 1222 <glossdef>
1193 <para>The base recipe name and version but without any special 1223 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1224 The base recipe name and version but without any special
1194 recipe name suffix (i.e. <filename>-native</filename>, <filename>lib64-</filename>, 1225 recipe name suffix (i.e. <filename>-native</filename>, <filename>lib64-</filename>,
1195 and so forth). 1226 and so forth).
1196 <filename>BP</filename> is comprised of the following: 1227 <filename>BP</filename> is comprised of the following:
1197 <literallayout class="monospaced"> 1228 <literallayout class="monospaced">
1198 ${BPN}-${PV} 1229 ${BPN}-${PV}
1199 </literallayout></para> 1230 </literallayout>
1231 </para>
1200 </glossdef> 1232 </glossdef>
1201 </glossentry> 1233 </glossentry>
1202 1234
1203 <glossentry id='var-BPN'><glossterm>BPN<imagedata fileref="figures/define-generic.png" /></glossterm> 1235 <glossentry id='var-BPN'><glossterm>BPN</glossterm>
1204 <info> 1236 <info>
1205 BPN[doc] = "The bare name of the recipe. This variable is a version of the PN variable but removes common suffixes and prefixes." 1237 BPN[doc] = "The bare name of the recipe. This variable is a version of the PN variable but removes common suffixes and prefixes."
1206 </info> 1238 </info>
1207 <glossdef> 1239 <glossdef>
1208 <para>The bare name of the recipe. 1240 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1241 The bare name of the recipe.
1209 This variable is a version of the <link linkend='var-PN'><filename>PN</filename></link> variable 1242 This variable is a version of the <link linkend='var-PN'><filename>PN</filename></link> variable
1210 but removes common suffixes such as "-native" and "-cross" as well 1243 but removes common suffixes such as "-native" and "-cross" as well
1211 as removes common prefixes such as multilib's "lib64-" and "lib32-". 1244 as removes common prefixes such as multilib's "lib64-" and "lib32-".
@@ -1214,16 +1247,17 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1214 The exact list of prefixes removed is specified by the 1247 The exact list of prefixes removed is specified by the
1215 <link linkend='var-MLPREFIX'><filename>MLPREFIX</filename></link> variable. 1248 <link linkend='var-MLPREFIX'><filename>MLPREFIX</filename></link> variable.
1216 Prefixes are removed for <filename>multilib</filename> 1249 Prefixes are removed for <filename>multilib</filename>
1217 and <filename>nativesdk</filename> cases.</para> 1250 and <filename>nativesdk</filename> cases.
1251 </para>
1218 </glossdef> 1252 </glossdef>
1219 </glossentry> 1253 </glossentry>
1220 1254
1221 <glossentry id='var-BUGTRACKER'><glossterm>BUGTRACKER<imagedata fileref="figures/define-generic.png" /></glossterm> 1255 <glossentry id='var-BUGTRACKER'><glossterm>BUGTRACKER</glossterm>
1222 <info> 1256 <info>
1223 BUGTRACKER[doc] = "Specifies a URL for an upstream bug tracking website for a recipe." 1257 BUGTRACKER[doc] = "Specifies a URL for an upstream bug tracking website for a recipe."
1224 </info> 1258 </info>
1225 <glossdef> 1259 <glossdef>
1226 <para> 1260 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1227 Specifies a URL for an upstream bug tracking website for 1261 Specifies a URL for an upstream bug tracking website for
1228 a recipe. 1262 a recipe.
1229 The OpenEmbedded build system does not use this variable. 1263 The OpenEmbedded build system does not use this variable.
@@ -1233,12 +1267,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1233 </glossdef> 1267 </glossdef>
1234 </glossentry> 1268 </glossentry>
1235 1269
1236 <glossentry id='var-BUILD_ARCH'><glossterm>BUILD_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 1270 <glossentry id='var-BUILD_ARCH'><glossterm>BUILD_ARCH</glossterm>
1237 <info> 1271 <info>
1238 BUILD_ARCH[doc] = "The name of the building architecture (e.g. i686)." 1272 BUILD_ARCH[doc] = "The name of the building architecture (e.g. i686)."
1239 </info> 1273 </info>
1240 <glossdef> 1274 <glossdef>
1241 <para> 1275 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1242 Specifies the architecture of the build host 1276 Specifies the architecture of the build host
1243 (e.g. <filename>i686</filename>). 1277 (e.g. <filename>i686</filename>).
1244 The OpenEmbedded build system sets the value of 1278 The OpenEmbedded build system sets the value of
@@ -1248,12 +1282,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1248 </glossdef> 1282 </glossdef>
1249 </glossentry> 1283 </glossentry>
1250 1284
1251 <glossentry id='var-BUILD_CFLAGS'><glossterm>BUILD_CFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1285 <glossentry id='var-BUILD_CFLAGS'><glossterm>BUILD_CFLAGS</glossterm>
1252 <info> 1286 <info>
1253 BUILD_CFLAGS[doc] = "Specifies the flags to pass to the C compiler when building for the build host." 1287 BUILD_CFLAGS[doc] = "Specifies the flags to pass to the C compiler when building for the build host."
1254 </info> 1288 </info>
1255 <glossdef> 1289 <glossdef>
1256 <para> 1290 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1257 Specifies the flags to pass to the C compiler when building 1291 Specifies the flags to pass to the C compiler when building
1258 for the build host. 1292 for the build host.
1259 When building in the <filename>-native</filename> context, 1293 When building in the <filename>-native</filename> context,
@@ -1263,12 +1297,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1263 </glossdef> 1297 </glossdef>
1264 </glossentry> 1298 </glossentry>
1265 1299
1266 <glossentry id='var-BUILD_CPPFLAGS'><glossterm>BUILD_CPPFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1300 <glossentry id='var-BUILD_CPPFLAGS'><glossterm>BUILD_CPPFLAGS</glossterm>
1267 <info> 1301 <info>
1268 BUILD_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the build host." 1302 BUILD_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the build host."
1269 </info> 1303 </info>
1270 <glossdef> 1304 <glossdef>
1271 <para> 1305 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1272 Specifies the flags to pass to the C pre-processor 1306 Specifies the flags to pass to the C pre-processor
1273 (i.e. to both the C and the C++ compilers) when building 1307 (i.e. to both the C and the C++ compilers) when building
1274 for the build host. 1308 for the build host.
@@ -1279,12 +1313,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1279 </glossdef> 1313 </glossdef>
1280 </glossentry> 1314 </glossentry>
1281 1315
1282 <glossentry id='var-BUILD_CXXFLAGS'><glossterm>BUILD_CXXFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1316 <glossentry id='var-BUILD_CXXFLAGS'><glossterm>BUILD_CXXFLAGS</glossterm>
1283 <info> 1317 <info>
1284 BUILD_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the build host." 1318 BUILD_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the build host."
1285 </info> 1319 </info>
1286 <glossdef> 1320 <glossdef>
1287 <para> 1321 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1288 Specifies the flags to pass to the C++ compiler when 1322 Specifies the flags to pass to the C++ compiler when
1289 building for the build host. 1323 building for the build host.
1290 When building in the <filename>native</filename> context, 1324 When building in the <filename>native</filename> context,
@@ -1294,12 +1328,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1294 </glossdef> 1328 </glossdef>
1295 </glossentry> 1329 </glossentry>
1296 1330
1297 <glossentry id='var-BUILD_LDFLAGS'><glossterm>BUILD_LDFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1331 <glossentry id='var-BUILD_LDFLAGS'><glossterm>BUILD_LDFLAGS</glossterm>
1298 <info> 1332 <info>
1299 BUILD_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the build host." 1333 BUILD_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the build host."
1300 </info> 1334 </info>
1301 <glossdef> 1335 <glossdef>
1302 <para> 1336 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1303 Specifies the flags to pass to the linker when building 1337 Specifies the flags to pass to the linker when building
1304 for the build host. 1338 for the build host.
1305 When building in the <filename>-native</filename> context, 1339 When building in the <filename>-native</filename> context,
@@ -1309,12 +1343,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1309 </glossdef> 1343 </glossdef>
1310 </glossentry> 1344 </glossentry>
1311 1345
1312 <glossentry id='var-BUILD_OPTIMIZATION'><glossterm>BUILD_OPTIMIZATION<imagedata fileref="figures/define-generic.png" /></glossterm> 1346 <glossentry id='var-BUILD_OPTIMIZATION'><glossterm>BUILD_OPTIMIZATION</glossterm>
1313 <info> 1347 <info>
1314 BUILD_OPTIMIZATION[doc] = "Specifies the optimization flags passed to the C compiler when building for the build host or the SDK." 1348 BUILD_OPTIMIZATION[doc] = "Specifies the optimization flags passed to the C compiler when building for the build host or the SDK."
1315 </info> 1349 </info>
1316 <glossdef> 1350 <glossdef>
1317 <para> 1351 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1318 Specifies the optimization flags passed to the C compiler 1352 Specifies the optimization flags passed to the C compiler
1319 when building for the build host or the SDK. 1353 when building for the build host or the SDK.
1320 The flags are passed through the 1354 The flags are passed through the
@@ -1332,12 +1366,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1332 </glossdef> 1366 </glossdef>
1333 </glossentry> 1367 </glossentry>
1334 1368
1335 <glossentry id='var-BUILD_OS'><glossterm>BUILD_OS<imagedata fileref="figures/define-generic.png" /></glossterm> 1369 <glossentry id='var-BUILD_OS'><glossterm>BUILD_OS</glossterm>
1336 <info> 1370 <info>
1337 BUILD_OS[doc] = "The operating system (in lower case) of the building architecture (e.g. Linux)." 1371 BUILD_OS[doc] = "The operating system (in lower case) of the building architecture (e.g. Linux)."
1338 </info> 1372 </info>
1339 <glossdef> 1373 <glossdef>
1340 <para> 1374 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1341 Specifies the operating system in use on the build 1375 Specifies the operating system in use on the build
1342 host (e.g. "linux"). 1376 host (e.g. "linux").
1343 The OpenEmbedded build system sets the value of 1377 The OpenEmbedded build system sets the value of
@@ -1348,12 +1382,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1348 </glossdef> 1382 </glossdef>
1349 </glossentry> 1383 </glossentry>
1350 1384
1351 <glossentry id='var-BUILD_PREFIX'><glossterm>BUILD_PREFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 1385 <glossentry id='var-BUILD_PREFIX'><glossterm>BUILD_PREFIX</glossterm>
1352 <info> 1386 <info>
1353 BUILD_PREFIX[doc] = "The toolchain binary prefix used for native recipes." 1387 BUILD_PREFIX[doc] = "The toolchain binary prefix used for native recipes."
1354 </info> 1388 </info>
1355 <glossdef> 1389 <glossdef>
1356 <para> 1390 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1357 The toolchain binary prefix used for native recipes. 1391 The toolchain binary prefix used for native recipes.
1358 The OpenEmbedded build system uses the 1392 The OpenEmbedded build system uses the
1359 <filename>BUILD_PREFIX</filename> value to set the 1393 <filename>BUILD_PREFIX</filename> value to set the
@@ -1363,12 +1397,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1363 </glossdef> 1397 </glossdef>
1364 </glossentry> 1398 </glossentry>
1365 1399
1366 <glossentry id='var-BUILD_SYS'><glossterm>BUILD_SYS<imagedata fileref="figures/define-generic.png" /></glossterm> 1400 <glossentry id='var-BUILD_SYS'><glossterm>BUILD_SYS</glossterm>
1367 <info> 1401 <info>
1368 BUILD_SYS[doc] = "The toolchain binary prefix used for native recipes." 1402 BUILD_SYS[doc] = "The toolchain binary prefix used for native recipes."
1369 </info> 1403 </info>
1370 <glossdef> 1404 <glossdef>
1371 <para> 1405 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1372 Specifies the system, including the architecture and 1406 Specifies the system, including the architecture and
1373 the operating system, to use when building for the build 1407 the operating system, to use when building for the build
1374 host (i.e. when building <filename>native</filename> 1408 host (i.e. when building <filename>native</filename>
@@ -1388,12 +1422,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1388 </glossdef> 1422 </glossdef>
1389 </glossentry> 1423 </glossentry>
1390 1424
1391 <glossentry id='var-BUILD_VENDOR'><glossterm>BUILD_VENDOR<imagedata fileref="figures/define-generic.png" /></glossterm> 1425 <glossentry id='var-BUILD_VENDOR'><glossterm>BUILD_VENDOR</glossterm>
1392 <info> 1426 <info>
1393 BUILD_VENDOR[doc] = "The vendor name to use when building for the build host." 1427 BUILD_VENDOR[doc] = "The vendor name to use when building for the build host."
1394 </info> 1428 </info>
1395 <glossdef> 1429 <glossdef>
1396 <para> 1430 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1397 Specifies the vendor name to use when building for the 1431 Specifies the vendor name to use when building for the
1398 build host. 1432 build host.
1399 The default value is an empty string (""). 1433 The default value is an empty string ("").
@@ -1401,12 +1435,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1401 </glossdef> 1435 </glossdef>
1402 </glossentry> 1436 </glossentry>
1403 1437
1404 <glossentry id='var-BUILDDIR'><glossterm>BUILDDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 1438 <glossentry id='var-BUILDDIR'><glossterm>BUILDDIR</glossterm>
1405 <info> 1439 <info>
1406 BUILDDIR[doc] = "Points to the location of the Build Directory." 1440 BUILDDIR[doc] = "Points to the location of the Build Directory."
1407 </info> 1441 </info>
1408 <glossdef> 1442 <glossdef>
1409 <para> 1443 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1410 Points to the location of the 1444 Points to the location of the
1411 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. 1445 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
1412 You can define this directory indirectly through the 1446 You can define this directory indirectly through the
@@ -1422,12 +1456,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1422 </glossdef> 1456 </glossdef>
1423 </glossentry> 1457 </glossentry>
1424 1458
1425 <glossentry id='var-BUILDHISTORY_COMMIT'><glossterm>BUILDHISTORY_COMMIT<imagedata fileref="figures/define-generic.png" /></glossterm> 1459 <glossentry id='var-BUILDHISTORY_COMMIT'><glossterm>BUILDHISTORY_COMMIT</glossterm>
1426 <info> 1460 <info>
1427 BUILDHISTORY_COMMIT[doc] = "When inheriting the buildhistory class, this variable specifies whether or not to commit the build history output in a local Git repository." 1461 BUILDHISTORY_COMMIT[doc] = "When inheriting the buildhistory class, this variable specifies whether or not to commit the build history output in a local Git repository."
1428 </info> 1462 </info>
1429 <glossdef> 1463 <glossdef>
1430 <para> 1464 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1431 When inheriting the 1465 When inheriting the
1432 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> 1466 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link>
1433 class, this variable specifies whether or not to commit the 1467 class, this variable specifies whether or not to commit the
@@ -1453,12 +1487,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1453 </glossdef> 1487 </glossdef>
1454 </glossentry> 1488 </glossentry>
1455 1489
1456 <glossentry id='var-BUILDHISTORY_COMMIT_AUTHOR'><glossterm>BUILDHISTORY_COMMIT_AUTHOR<imagedata fileref="figures/define-generic.png" /></glossterm> 1490 <glossentry id='var-BUILDHISTORY_COMMIT_AUTHOR'><glossterm>BUILDHISTORY_COMMIT_AUTHOR</glossterm>
1457 <info> 1491 <info>
1458 BUILDHISTORY_COMMIT_AUTHOR[doc] = "When inheriting the buildhistory class, this variable specifies the author to use for each Git commit." 1492 BUILDHISTORY_COMMIT_AUTHOR[doc] = "When inheriting the buildhistory class, this variable specifies the author to use for each Git commit."
1459 </info> 1493 </info>
1460 <glossdef> 1494 <glossdef>
1461 <para> 1495 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1462 When inheriting the 1496 When inheriting the
1463 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> 1497 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link>
1464 class, this variable specifies the author to use for each 1498 class, this variable specifies the author to use for each
@@ -1487,12 +1521,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1487 </glossdef> 1521 </glossdef>
1488 </glossentry> 1522 </glossentry>
1489 1523
1490 <glossentry id='var-BUILDHISTORY_DIR'><glossterm>BUILDHISTORY_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 1524 <glossentry id='var-BUILDHISTORY_DIR'><glossterm>BUILDHISTORY_DIR</glossterm>
1491 <info> 1525 <info>
1492 BUILDHISTORY_DIR[doc] = "When inheriting the buildhistory class, this variable specifies the directory in which build history information is kept." 1526 BUILDHISTORY_DIR[doc] = "When inheriting the buildhistory class, this variable specifies the directory in which build history information is kept."
1493 </info> 1527 </info>
1494 <glossdef> 1528 <glossdef>
1495 <para> 1529 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1496 When inheriting the 1530 When inheriting the
1497 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> 1531 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link>
1498 class, this variable specifies the directory in which 1532 class, this variable specifies the directory in which
@@ -1511,12 +1545,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1511 </glossdef> 1545 </glossdef>
1512 </glossentry> 1546 </glossentry>
1513 1547
1514 <glossentry id='var-BUILDHISTORY_FEATURES'><glossterm>BUILDHISTORY_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 1548 <glossentry id='var-BUILDHISTORY_FEATURES'><glossterm>BUILDHISTORY_FEATURES</glossterm>
1515 <info> 1549 <info>
1516 BUILDHISTORY_FEATURES[doc] = "When inheriting the buildhistory class, this variable specifies the build history features to be enabled." 1550 BUILDHISTORY_FEATURES[doc] = "When inheriting the buildhistory class, this variable specifies the build history features to be enabled."
1517 </info> 1551 </info>
1518 <glossdef> 1552 <glossdef>
1519 <para> 1553 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1520 When inheriting the 1554 When inheriting the
1521 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> 1555 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link>
1522 class, this variable specifies the build history features 1556 class, this variable specifies the build history features
@@ -1555,12 +1589,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1555 </glossdef> 1589 </glossdef>
1556 </glossentry> 1590 </glossentry>
1557 1591
1558 <glossentry id='var-BUILDHISTORY_IMAGE_FILES'><glossterm>BUILDHISTORY_IMAGE_FILES<imagedata fileref="figures/define-generic.png" /></glossterm> 1592 <glossentry id='var-BUILDHISTORY_IMAGE_FILES'><glossterm>BUILDHISTORY_IMAGE_FILES</glossterm>
1559 <info> 1593 <info>
1560 BUILDHISTORY_IMAGE_FILES[doc] = "When inheriting the buildhistory class, this variable specifies a list of paths to files copied from the image contents into the build history directory under an "image-files" directory in the directory for the image, so that you can track the contents of each file." 1594 BUILDHISTORY_IMAGE_FILES[doc] = "When inheriting the buildhistory class, this variable specifies a list of paths to files copied from the image contents into the build history directory under an "image-files" directory in the directory for the image, so that you can track the contents of each file."
1561 </info> 1595 </info>
1562 <glossdef> 1596 <glossdef>
1563 <para> 1597 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1564 When inheriting the 1598 When inheriting the
1565 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> 1599 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link>
1566 class, this variable specifies a list of paths to files 1600 class, this variable specifies a list of paths to files
@@ -1587,12 +1621,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1587 </glossdef> 1621 </glossdef>
1588 </glossentry> 1622 </glossentry>
1589 1623
1590 <glossentry id='var-BUILDHISTORY_PUSH_REPO'><glossterm>BUILDHISTORY_PUSH_REPO<imagedata fileref="figures/define-generic.png" /></glossterm> 1624 <glossentry id='var-BUILDHISTORY_PUSH_REPO'><glossterm>BUILDHISTORY_PUSH_REPO</glossterm>
1591 <info> 1625 <info>
1592 BUILDHISTORY_PUSH_REPO[doc] = "When inheriting the buildhistory class, this variable optionally specifies a remote repository to which build history pushes Git changes." 1626 BUILDHISTORY_PUSH_REPO[doc] = "When inheriting the buildhistory class, this variable optionally specifies a remote repository to which build history pushes Git changes."
1593 </info> 1627 </info>
1594 <glossdef> 1628 <glossdef>
1595 <para> 1629 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1596 When inheriting the 1630 When inheriting the
1597 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link> 1631 <link linkend='ref-classes-buildhistory'><filename>buildhistory</filename></link>
1598 class, this variable optionally specifies a remote 1632 class, this variable optionally specifies a remote
@@ -1621,12 +1655,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1621 </glossdef> 1655 </glossdef>
1622 </glossentry> 1656 </glossentry>
1623 1657
1624 <glossentry id='var-BUILDSDK_CFLAGS'><glossterm>BUILDSDK_CFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1658 <glossentry id='var-BUILDSDK_CFLAGS'><glossterm>BUILDSDK_CFLAGS</glossterm>
1625 <info> 1659 <info>
1626 BUILDSDK_CFLAGS[doc] = "Specifies the flags to pass to the C compiler when building for the SDK." 1660 BUILDSDK_CFLAGS[doc] = "Specifies the flags to pass to the C compiler when building for the SDK."
1627 </info> 1661 </info>
1628 <glossdef> 1662 <glossdef>
1629 <para> 1663 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1630 Specifies the flags to pass to the C compiler when building 1664 Specifies the flags to pass to the C compiler when building
1631 for the SDK. 1665 for the SDK.
1632 When building in the <filename>nativesdk</filename> 1666 When building in the <filename>nativesdk</filename>
@@ -1637,12 +1671,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1637 </glossdef> 1671 </glossdef>
1638 </glossentry> 1672 </glossentry>
1639 1673
1640 <glossentry id='var-BUILDSDK_CPPFLAGS'><glossterm>BUILDSDK_CPPFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1674 <glossentry id='var-BUILDSDK_CPPFLAGS'><glossterm>BUILDSDK_CPPFLAGS</glossterm>
1641 <info> 1675 <info>
1642 BUILDSDK_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the SDK." 1676 BUILDSDK_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the SDK."
1643 </info> 1677 </info>
1644 <glossdef> 1678 <glossdef>
1645 <para> 1679 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1646 Specifies the flags to pass to the C pre-processor 1680 Specifies the flags to pass to the C pre-processor
1647 (i.e. to both the C and the C++ compilers) when building 1681 (i.e. to both the C and the C++ compilers) when building
1648 for the SDK. 1682 for the SDK.
@@ -1654,12 +1688,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1654 </glossdef> 1688 </glossdef>
1655 </glossentry> 1689 </glossentry>
1656 1690
1657 <glossentry id='var-BUILDSDK_CXXFLAGS'><glossterm>BUILDSDK_CXXFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1691 <glossentry id='var-BUILDSDK_CXXFLAGS'><glossterm>BUILDSDK_CXXFLAGS</glossterm>
1658 <info> 1692 <info>
1659 BUILDSDK_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the SDK." 1693 BUILDSDK_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the SDK."
1660 </info> 1694 </info>
1661 <glossdef> 1695 <glossdef>
1662 <para> 1696 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1663 Specifies the flags to pass to the C++ compiler when 1697 Specifies the flags to pass to the C++ compiler when
1664 building for the SDK. 1698 building for the SDK.
1665 When building in the <filename>nativesdk</filename> 1699 When building in the <filename>nativesdk</filename>
@@ -1670,12 +1704,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1670 </glossdef> 1704 </glossdef>
1671 </glossentry> 1705 </glossentry>
1672 1706
1673 <glossentry id='var-BUILDSDK_LDFLAGS'><glossterm>BUILDSDK_LDFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1707 <glossentry id='var-BUILDSDK_LDFLAGS'><glossterm>BUILDSDK_LDFLAGS</glossterm>
1674 <info> 1708 <info>
1675 BUILDSDK_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the SDK." 1709 BUILDSDK_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the SDK."
1676 </info> 1710 </info>
1677 <glossdef> 1711 <glossdef>
1678 <para> 1712 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1679 Specifies the flags to pass to the linker when building 1713 Specifies the flags to pass to the linker when building
1680 for the SDK. 1714 for the SDK.
1681 When building in the <filename>nativesdk-</filename> 1715 When building in the <filename>nativesdk-</filename>
@@ -1686,12 +1720,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1686 </glossdef> 1720 </glossdef>
1687 </glossentry> 1721 </glossentry>
1688 1722
1689 <glossentry id='var-BUILDSTATS_BASE'><glossterm>BUILDSTATS_BASE<imagedata fileref="figures/define-generic.png" /></glossterm> 1723 <glossentry id='var-BUILDSTATS_BASE'><glossterm>BUILDSTATS_BASE</glossterm>
1690 <info> 1724 <info>
1691 BUILDSTATS_BASE[doc] = "Points to the location of the directory that holds build statistics when you use and enable the buildstats class." 1725 BUILDSTATS_BASE[doc] = "Points to the location of the directory that holds build statistics when you use and enable the buildstats class."
1692 </info> 1726 </info>
1693 <glossdef> 1727 <glossdef>
1694 <para> 1728 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1695 Points to the location of the directory that holds build 1729 Points to the location of the directory that holds build
1696 statistics when you use and enable the 1730 statistics when you use and enable the
1697 <link linkend='ref-classes-buildstats'><filename>buildstats</filename></link> 1731 <link linkend='ref-classes-buildstats'><filename>buildstats</filename></link>
@@ -1703,12 +1737,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1703 </glossdef> 1737 </glossdef>
1704 </glossentry> 1738 </glossentry>
1705 1739
1706 <glossentry id='var-BUSYBOX_SPLIT_SUID'><glossterm>BUSYBOX_SPLIT_SUID<imagedata fileref="figures/define-generic.png" /></glossterm> 1740 <glossentry id='var-BUSYBOX_SPLIT_SUID'><glossterm>BUSYBOX_SPLIT_SUID</glossterm>
1707 <info> 1741 <info>
1708 BUSYBOX_SPLIT_SUID[doc] = "For the BusyBox recipe, specifies whether to split the output executable file into two parts: one for features that require setuid root, and one for the remaining features." 1742 BUSYBOX_SPLIT_SUID[doc] = "For the BusyBox recipe, specifies whether to split the output executable file into two parts: one for features that require setuid root, and one for the remaining features."
1709 </info> 1743 </info>
1710 <glossdef> 1744 <glossdef>
1711 <para> 1745 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1712 For the BusyBox recipe, specifies whether to split the 1746 For the BusyBox recipe, specifies whether to split the
1713 output executable file into two parts: one for features 1747 output executable file into two parts: one for features
1714 that require <filename>setuid root</filename>, and one for 1748 that require <filename>setuid root</filename>, and one for
@@ -1729,12 +1763,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1729 1763
1730 <glossdiv id='var-glossary-c'><title>C</title> 1764 <glossdiv id='var-glossary-c'><title>C</title>
1731 1765
1732 <glossentry id='var-CACHE'><glossterm>CACHE<imagedata fileref="figures/define-generic.png" /></glossterm> 1766 <glossentry id='var-CACHE'><glossterm>CACHE</glossterm>
1733 <info> 1767 <info>
1734 CACHE[doc] = "The directory BitBake uses to store a cache of the metadata." 1768 CACHE[doc] = "The directory BitBake uses to store a cache of the metadata."
1735 </info> 1769 </info>
1736 <glossdef> 1770 <glossdef>
1737 <para> 1771 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1738 Specifies the directory BitBake uses to store a cache 1772 Specifies the directory BitBake uses to store a cache
1739 of the 1773 of the
1740 <ulink url='&YOCTO_DOCS_DEV_URL;#metadata'>Metadata</ulink> 1774 <ulink url='&YOCTO_DOCS_DEV_URL;#metadata'>Metadata</ulink>
@@ -1744,24 +1778,24 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1744 </glossdef> 1778 </glossdef>
1745 </glossentry> 1779 </glossentry>
1746 1780
1747 <glossentry id='var-CC'><glossterm>CC<imagedata fileref="figures/define-generic.png" /></glossterm> 1781 <glossentry id='var-CC'><glossterm>CC</glossterm>
1748 <info> 1782 <info>
1749 CC[doc] = "Minimum command and arguments to run the C compiler." 1783 CC[doc] = "Minimum command and arguments to run the C compiler."
1750 </info> 1784 </info>
1751 <glossdef> 1785 <glossdef>
1752 <para> 1786 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1753 The minimal command and arguments used to run the C 1787 The minimal command and arguments used to run the C
1754 compiler. 1788 compiler.
1755 </para> 1789 </para>
1756 </glossdef> 1790 </glossdef>
1757 </glossentry> 1791 </glossentry>
1758 1792
1759 <glossentry id='var-CFLAGS'><glossterm>CFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 1793 <glossentry id='var-CFLAGS'><glossterm>CFLAGS</glossterm>
1760 <info> 1794 <info>
1761 CFLAGS[doc] = "Flags passed to the C compiler for the target system. This variable evaluates to the same as TARGET_CFLAGS." 1795 CFLAGS[doc] = "Flags passed to the C compiler for the target system. This variable evaluates to the same as TARGET_CFLAGS."
1762 </info> 1796 </info>
1763 <glossdef> 1797 <glossdef>
1764 <para> 1798 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1765 Specifies the flags to pass to the C compiler. 1799 Specifies the flags to pass to the C compiler.
1766 This variable is exported to an environment 1800 This variable is exported to an environment
1767 variable and thus made visible to the software being 1801 variable and thus made visible to the software being
@@ -1791,12 +1825,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1791 </glossdef> 1825 </glossdef>
1792 </glossentry> 1826 </glossentry>
1793 1827
1794 <glossentry id='var-CLASSOVERRIDE'><glossterm>CLASSOVERRIDE<imagedata fileref="figures/define-generic.png" /></glossterm> 1828 <glossentry id='var-CLASSOVERRIDE'><glossterm>CLASSOVERRIDE</glossterm>
1795 <info> 1829 <info>
1796 CLASSOVERRIDE[doc] = "An internal variable specifying the special class override that should currently apply (e.g. "class-target", "class-native", and so forth)." 1830 CLASSOVERRIDE[doc] = "An internal variable specifying the special class override that should currently apply (e.g. "class-target", "class-native", and so forth)."
1797 </info> 1831 </info>
1798 <glossdef> 1832 <glossdef>
1799 <para> 1833 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1800 An internal variable specifying the special class override 1834 An internal variable specifying the special class override
1801 that should currently apply (e.g. "class-target", 1835 that should currently apply (e.g. "class-target",
1802 "class-native", and so forth). 1836 "class-native", and so forth).
@@ -1820,12 +1854,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1820 </glossdef> 1854 </glossdef>
1821 </glossentry> 1855 </glossentry>
1822 1856
1823 <glossentry id='var-CLEANBROKEN'><glossterm>CLEANBROKEN<imagedata fileref="figures/define-generic.png" /></glossterm> 1857 <glossentry id='var-CLEANBROKEN'><glossterm>CLEANBROKEN</glossterm>
1824 <info> 1858 <info>
1825 CLEANBROKEN[doc] = "Prevents the build system from running 'make clean' during the do_configure task." 1859 CLEANBROKEN[doc] = "Prevents the build system from running 'make clean' during the do_configure task."
1826 </info> 1860 </info>
1827 <glossdef> 1861 <glossdef>
1828 <para> 1862 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1829 If set to "1" within a recipe, 1863 If set to "1" within a recipe,
1830 <filename>CLEANBROKEN</filename> specifies that 1864 <filename>CLEANBROKEN</filename> specifies that
1831 the <filename>make clean</filename> command does 1865 the <filename>make clean</filename> command does
@@ -1838,12 +1872,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1838 </glossdef> 1872 </glossdef>
1839 </glossentry> 1873 </glossentry>
1840 1874
1841 <glossentry id='var-COMBINED_FEATURES'><glossterm>COMBINED_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 1875 <glossentry id='var-COMBINED_FEATURES'><glossterm>COMBINED_FEATURES</glossterm>
1842 <info> 1876 <info>
1843 COMBINED_FEATURES[doc] = "A set of features common between MACHINE_FEATURES and DISTRO_FEATURES." 1877 COMBINED_FEATURES[doc] = "A set of features common between MACHINE_FEATURES and DISTRO_FEATURES."
1844 </info> 1878 </info>
1845 <glossdef> 1879 <glossdef>
1846 <para> 1880 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1847 Provides a list of hardware features that are enabled in 1881 Provides a list of hardware features that are enabled in
1848 both 1882 both
1849 <link linkend='var-MACHINE_FEATURES'><filename>MACHINE_FEATURES</filename></link> 1883 <link linkend='var-MACHINE_FEATURES'><filename>MACHINE_FEATURES</filename></link>
@@ -1867,12 +1901,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1867 </glossdef> 1901 </glossdef>
1868 </glossentry> 1902 </glossentry>
1869 1903
1870 <glossentry id='var-COMMON_LICENSE_DIR'><glossterm>COMMON_LICENSE_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 1904 <glossentry id='var-COMMON_LICENSE_DIR'><glossterm>COMMON_LICENSE_DIR</glossterm>
1871 <info> 1905 <info>
1872 COMMON_LICENSE_DIR[doc] = "Points to meta/files/common-licenses in the Source Directory, which is where generic license files reside." 1906 COMMON_LICENSE_DIR[doc] = "Points to meta/files/common-licenses in the Source Directory, which is where generic license files reside."
1873 </info> 1907 </info>
1874 <glossdef> 1908 <glossdef>
1875 <para> 1909 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1876 Points to <filename>meta/files/common-licenses</filename> 1910 Points to <filename>meta/files/common-licenses</filename>
1877 in the 1911 in the
1878 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>, 1912 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>,
@@ -1881,12 +1915,13 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1881 </glossdef> 1915 </glossdef>
1882 </glossentry> 1916 </glossentry>
1883 1917
1884 <glossentry id='var-COMPATIBLE_HOST'><glossterm>COMPATIBLE_HOST<imagedata fileref="figures/define-generic.png" /></glossterm> 1918 <glossentry id='var-COMPATIBLE_HOST'><glossterm>COMPATIBLE_HOST</glossterm>
1885 <info> 1919 <info>
1886 COMPATIBLE_HOST[doc] = "A regular expression that resolves to one or more hosts (when the recipe is native) or one or more targets (when the recipe is non-native) with which a recipe is compatible." 1920 COMPATIBLE_HOST[doc] = "A regular expression that resolves to one or more hosts (when the recipe is native) or one or more targets (when the recipe is non-native) with which a recipe is compatible."
1887 </info> 1921 </info>
1888 <glossdef> 1922 <glossdef>
1889 <para>A regular expression that resolves to one or more hosts 1923 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1924 A regular expression that resolves to one or more hosts
1890 (when the recipe is native) or one or more targets (when 1925 (when the recipe is native) or one or more targets (when
1891 the recipe is non-native) with which a recipe is compatible. 1926 the recipe is non-native) with which a recipe is compatible.
1892 The regular expression is matched against 1927 The regular expression is matched against
@@ -1897,16 +1932,18 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1897 Stopping these builds is particularly useful with kernels. 1932 Stopping these builds is particularly useful with kernels.
1898 The variable also helps to increase parsing speed 1933 The variable also helps to increase parsing speed
1899 since the build system skips parsing recipes not 1934 since the build system skips parsing recipes not
1900 compatible with the current system.</para> 1935 compatible with the current system.
1936 </para>
1901 </glossdef> 1937 </glossdef>
1902 </glossentry> 1938 </glossentry>
1903 1939
1904 <glossentry id='var-COMPATIBLE_MACHINE'><glossterm>COMPATIBLE_MACHINE<imagedata fileref="figures/define-generic.png" /></glossterm> 1940 <glossentry id='var-COMPATIBLE_MACHINE'><glossterm>COMPATIBLE_MACHINE</glossterm>
1905 <info> 1941 <info>
1906 COMPATIBLE_MACHINE[doc] = "A regular expression that resolves to one or more target machines with which a recipe is compatible." 1942 COMPATIBLE_MACHINE[doc] = "A regular expression that resolves to one or more target machines with which a recipe is compatible."
1907 </info> 1943 </info>
1908 <glossdef> 1944 <glossdef>
1909 <para>A regular expression that resolves to one or more 1945 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1946 A regular expression that resolves to one or more
1910 target machines with which a recipe is compatible. 1947 target machines with which a recipe is compatible.
1911 The regular expression is matched against 1948 The regular expression is matched against
1912 <link linkend="var-MACHINEOVERRIDES"><filename>MACHINEOVERRIDES</filename></link>. 1949 <link linkend="var-MACHINEOVERRIDES"><filename>MACHINEOVERRIDES</filename></link>.
@@ -1915,16 +1952,17 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1915 Stopping these builds is particularly useful with kernels. 1952 Stopping these builds is particularly useful with kernels.
1916 The variable also helps to increase parsing speed 1953 The variable also helps to increase parsing speed
1917 since the build system skips parsing recipes not 1954 since the build system skips parsing recipes not
1918 compatible with the current machine.</para> 1955 compatible with the current machine.
1956 </para>
1919 </glossdef> 1957 </glossdef>
1920 </glossentry> 1958 </glossentry>
1921 1959
1922 <glossentry id='var-COMPLEMENTARY_GLOB'><glossterm>COMPLEMENTARY_GLOB<imagedata fileref="figures/define-generic.png" /></glossterm> 1960 <glossentry id='var-COMPLEMENTARY_GLOB'><glossterm>COMPLEMENTARY_GLOB</glossterm>
1923 <info> 1961 <info>
1924 COMPLEMENTARY_GLOB[doc] = "Defines wildcards to match when installing a list of complementary packages for all the packages installed in an image." 1962 COMPLEMENTARY_GLOB[doc] = "Defines wildcards to match when installing a list of complementary packages for all the packages installed in an image."
1925 </info> 1963 </info>
1926 <glossdef> 1964 <glossdef>
1927 <para> 1965 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1928 Defines wildcards to match when installing a list of 1966 Defines wildcards to match when installing a list of
1929 complementary packages for all the packages explicitly 1967 complementary packages for all the packages explicitly
1930 (or implicitly) installed in an image. 1968 (or implicitly) installed in an image.
@@ -1949,12 +1987,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1949 </glossdef> 1987 </glossdef>
1950 </glossentry> 1988 </glossentry>
1951 1989
1952 <glossentry id='var-CONF_VERSION'><glossterm>CONF_VERSION<imagedata fileref="figures/define-generic.png" /></glossterm> 1990 <glossentry id='var-CONF_VERSION'><glossterm>CONF_VERSION</glossterm>
1953 <info> 1991 <info>
1954 CONF_VERSION[doc] = "Tracks the version of local.conf. Increased each time build/conf/ changes incompatibly." 1992 CONF_VERSION[doc] = "Tracks the version of local.conf. Increased each time build/conf/ changes incompatibly."
1955 </info> 1993 </info>
1956 <glossdef> 1994 <glossdef>
1957 <para> 1995 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1958 Tracks the version of the local configuration file 1996 Tracks the version of the local configuration file
1959 (i.e. <filename>local.conf</filename>). 1997 (i.e. <filename>local.conf</filename>).
1960 The value for <filename>CONF_VERSION</filename> 1998 The value for <filename>CONF_VERSION</filename>
@@ -1963,12 +2001,13 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
1963 </para> 2001 </para>
1964 </glossdef> 2002 </glossdef>
1965 </glossentry> 2003 </glossentry>
1966 <glossentry id='var-CONFFILES'><glossterm>CONFFILES<imagedata fileref="figures/define-generic.png" /></glossterm> 2004
2005 <glossentry id='var-CONFFILES'><glossterm>CONFFILES</glossterm>
1967 <info> 2006 <info>
1968 CONFFILES[doc] = "Identifies editable or configurable files that are part of a package." 2007 CONFFILES[doc] = "Identifies editable or configurable files that are part of a package."
1969 </info> 2008 </info>
1970 <glossdef> 2009 <glossdef>
1971 <para> 2010 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
1972 Identifies editable or configurable files that are part of a package. 2011 Identifies editable or configurable files that are part of a package.
1973 If the Package Management System (PMS) is being used to update 2012 If the Package Management System (PMS) is being used to update
1974 packages on the target system, it is possible that 2013 packages on the target system, it is possible that
@@ -2016,12 +2055,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2016 </glossdef> 2055 </glossdef>
2017 </glossentry> 2056 </glossentry>
2018 2057
2019 <glossentry id='var-CONFIG_INITRAMFS_SOURCE'><glossterm>CONFIG_INITRAMFS_SOURCE<imagedata fileref="figures/define-generic.png" /></glossterm> 2058 <glossentry id='var-CONFIG_INITRAMFS_SOURCE'><glossterm>CONFIG_INITRAMFS_SOURCE</glossterm>
2020 <info> 2059 <info>
2021 CONFIG_INITRAMFS_SOURCE[doc] = "Identifies the initial RAM disk (initramfs) source files. The OpenEmbedded build system receives and uses this kernel Kconfig variable as an environment variable." 2060 CONFIG_INITRAMFS_SOURCE[doc] = "Identifies the initial RAM disk (initramfs) source files. The OpenEmbedded build system receives and uses this kernel Kconfig variable as an environment variable."
2022 </info> 2061 </info>
2023 <glossdef> 2062 <glossdef>
2024 <para> 2063 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2025 Identifies the initial RAM disk (initramfs) source files. 2064 Identifies the initial RAM disk (initramfs) source files.
2026 The OpenEmbedded build system receives and uses 2065 The OpenEmbedded build system receives and uses
2027 this kernel Kconfig variable as an environment variable. 2066 this kernel Kconfig variable as an environment variable.
@@ -2051,12 +2090,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2051 </glossdef> 2090 </glossdef>
2052 </glossentry> 2091 </glossentry>
2053 2092
2054 <glossentry id='var-CONFIG_SITE'><glossterm>CONFIG_SITE<imagedata fileref="figures/define-generic.png" /></glossterm> 2093 <glossentry id='var-CONFIG_SITE'><glossterm>CONFIG_SITE</glossterm>
2055 <info> 2094 <info>
2056 CONFIG_SITE[doc] = "A list of files that contains autoconf test results relevant to the current build. This variable is used by the Autotools utilities when running configure." 2095 CONFIG_SITE[doc] = "A list of files that contains autoconf test results relevant to the current build. This variable is used by the Autotools utilities when running configure."
2057 </info> 2096 </info>
2058 <glossdef> 2097 <glossdef>
2059 <para> 2098 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2060 A list of files that contains <filename>autoconf</filename> test results relevant 2099 A list of files that contains <filename>autoconf</filename> test results relevant
2061 to the current build. 2100 to the current build.
2062 This variable is used by the Autotools utilities when running 2101 This variable is used by the Autotools utilities when running
@@ -2065,23 +2104,23 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2065 </glossdef> 2104 </glossdef>
2066 </glossentry> 2105 </glossentry>
2067 2106
2068 <glossentry id='var-CONFIGURE_FLAGS'><glossterm>CONFIGURE_FLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 2107 <glossentry id='var-CONFIGURE_FLAGS'><glossterm>CONFIGURE_FLAGS</glossterm>
2069 <info> 2108 <info>
2070 CONFIGURE_FLAGS[doc] = "The minimal arguments for GNU configure." 2109 CONFIGURE_FLAGS[doc] = "The minimal arguments for GNU configure."
2071 </info> 2110 </info>
2072 <glossdef> 2111 <glossdef>
2073 <para> 2112 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2074 The minimal arguments for GNU configure. 2113 The minimal arguments for GNU configure.
2075 </para> 2114 </para>
2076 </glossdef> 2115 </glossdef>
2077 </glossentry> 2116 </glossentry>
2078 2117
2079 <glossentry id='var-CONFLICT_DISTRO_FEATURES'><glossterm>CONFLICT_DISTRO_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 2118 <glossentry id='var-CONFLICT_DISTRO_FEATURES'><glossterm>CONFLICT_DISTRO_FEATURES</glossterm>
2080 <info> 2119 <info>
2081 CONFLICT_DISTRO_FEATURES[doc] = "When a recipe inherits the distro_features_check class, this variable identifies distribution features that would be in conflict should the recipe be built." 2120 CONFLICT_DISTRO_FEATURES[doc] = "When a recipe inherits the distro_features_check class, this variable identifies distribution features that would be in conflict should the recipe be built."
2082 </info> 2121 </info>
2083 <glossdef> 2122 <glossdef>
2084 <para> 2123 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2085 When inheriting the 2124 When inheriting the
2086 <link linkend='ref-classes-distro_features_check'><filename>distro_features_check</filename></link> 2125 <link linkend='ref-classes-distro_features_check'><filename>distro_features_check</filename></link>
2087 class, this 2126 class, this
@@ -2098,12 +2137,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2098 </glossdef> 2137 </glossdef>
2099 </glossentry> 2138 </glossentry>
2100 2139
2101 <glossentry id='var-COPY_LIC_DIRS'><glossterm>COPY_LIC_DIRS<imagedata fileref="figures/define-generic.png" /></glossterm> 2140 <glossentry id='var-COPY_LIC_DIRS'><glossterm>COPY_LIC_DIRS</glossterm>
2102 <info> 2141 <info>
2103 COPY_LIC_DIRS[doc] = "If set to "1" along with the COPY_LIC_MANIFEST variable, the OpenEmbedded build system copies into the image the license files, which are located in /usr/share/common-licenses, for each package." 2142 COPY_LIC_DIRS[doc] = "If set to "1" along with the COPY_LIC_MANIFEST variable, the OpenEmbedded build system copies into the image the license files, which are located in /usr/share/common-licenses, for each package."
2104 </info> 2143 </info>
2105 <glossdef> 2144 <glossdef>
2106 <para> 2145 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2107 If set to "1" along with the 2146 If set to "1" along with the
2108 <link linkend='var-COPY_LIC_MANIFEST'><filename>COPY_LIC_MANIFEST</filename></link> 2147 <link linkend='var-COPY_LIC_MANIFEST'><filename>COPY_LIC_MANIFEST</filename></link>
2109 variable, the OpenEmbedded build system copies 2148 variable, the OpenEmbedded build system copies
@@ -2112,16 +2151,16 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2112 for each package. 2151 for each package.
2113 The license files are placed 2152 The license files are placed
2114 in directories within the image itself. 2153 in directories within the image itself.
2115 </para> 2154 </para>
2116 </glossdef> 2155 </glossdef>
2117 </glossentry> 2156 </glossentry>
2118 2157
2119 <glossentry id='var-COPY_LIC_MANIFEST'><glossterm>COPY_LIC_MANIFEST<imagedata fileref="figures/define-generic.png" /></glossterm> 2158 <glossentry id='var-COPY_LIC_MANIFEST'><glossterm>COPY_LIC_MANIFEST</glossterm>
2120 <info> 2159 <info>
2121 COPY_LIC_MANIFEST[doc] = "If set to "1", the OpenEmbedded build system copies the license manifest for the image to /usr/share/common-licenses/license.manifest within the image itself." 2160 COPY_LIC_MANIFEST[doc] = "If set to "1", the OpenEmbedded build system copies the license manifest for the image to /usr/share/common-licenses/license.manifest within the image itself."
2122 </info> 2161 </info>
2123 <glossdef> 2162 <glossdef>
2124 <para> 2163 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2125 If set to "1", the OpenEmbedded build system copies 2164 If set to "1", the OpenEmbedded build system copies
2126 the license manifest for the image to 2165 the license manifest for the image to
2127 <filename>/usr/share/common-licenses/license.manifest</filename> 2166 <filename>/usr/share/common-licenses/license.manifest</filename>
@@ -2130,12 +2169,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2130 </glossdef> 2169 </glossdef>
2131 </glossentry> 2170 </glossentry>
2132 2171
2133 <glossentry id='var-CORE_IMAGE_EXTRA_INSTALL'><glossterm>CORE_IMAGE_EXTRA_INSTALL<imagedata fileref="figures/define-generic.png" /></glossterm> 2172 <glossentry id='var-CORE_IMAGE_EXTRA_INSTALL'><glossterm>CORE_IMAGE_EXTRA_INSTALL</glossterm>
2134 <info> 2173 <info>
2135 CORE_IMAGE_EXTRA_INSTALL[doc] = "Specifies the list of packages to be added to the image. You should only set this variable in the conf/local.conf file in the Build Directory." 2174 CORE_IMAGE_EXTRA_INSTALL[doc] = "Specifies the list of packages to be added to the image. You should only set this variable in the conf/local.conf file in the Build Directory."
2136 </info> 2175 </info>
2137 <glossdef> 2176 <glossdef>
2138 <para> 2177 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2139 Specifies the list of packages to be added to the image. 2178 Specifies the list of packages to be added to the image.
2140 You should only set this variable in the 2179 You should only set this variable in the
2141 <filename>local.conf</filename> configuration file found 2180 <filename>local.conf</filename> configuration file found
@@ -2149,12 +2188,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2149 </glossdef> 2188 </glossdef>
2150 </glossentry> 2189 </glossentry>
2151 2190
2152 <glossentry id='var-COREBASE'><glossterm>COREBASE<imagedata fileref="figures/define-generic.png" /></glossterm> 2191 <glossentry id='var-COREBASE'><glossterm>COREBASE</glossterm>
2153 <info> 2192 <info>
2154 COREBASE[doc] = "Specifies the parent directory of the OpenEmbedded Core Metadata layer (i.e. meta)." 2193 COREBASE[doc] = "Specifies the parent directory of the OpenEmbedded Core Metadata layer (i.e. meta)."
2155 </info> 2194 </info>
2156 <glossdef> 2195 <glossdef>
2157 <para> 2196 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2158 Specifies the parent directory of the OpenEmbedded 2197 Specifies the parent directory of the OpenEmbedded
2159 Core Metadata layer (i.e. <filename>meta</filename>). 2198 Core Metadata layer (i.e. <filename>meta</filename>).
2160 </para> 2199 </para>
@@ -2174,24 +2213,24 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2174 </glossdef> 2213 </glossdef>
2175 </glossentry> 2214 </glossentry>
2176 2215
2177 <glossentry id='var-CPP'><glossterm>CPP<imagedata fileref="figures/define-generic.png" /></glossterm> 2216 <glossentry id='var-CPP'><glossterm>CPP</glossterm>
2178 <info> 2217 <info>
2179 CPP[doc] = "Minimum command and arguments to run the C preprocessor." 2218 CPP[doc] = "Minimum command and arguments to run the C preprocessor."
2180 </info> 2219 </info>
2181 <glossdef> 2220 <glossdef>
2182 <para> 2221 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2183 The minimal command and arguments used to run the C 2222 The minimal command and arguments used to run the C
2184 preprocessor. 2223 preprocessor.
2185 </para> 2224 </para>
2186 </glossdef> 2225 </glossdef>
2187 </glossentry> 2226 </glossentry>
2188 2227
2189 <glossentry id='var-CPPFLAGS'><glossterm>CPPFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 2228 <glossentry id='var-CPPFLAGS'><glossterm>CPPFLAGS</glossterm>
2190 <info> 2229 <info>
2191 CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers)." 2230 CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers)."
2192 </info> 2231 </info>
2193 <glossdef> 2232 <glossdef>
2194 <para> 2233 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2195 Specifies the flags to pass to the C pre-processor 2234 Specifies the flags to pass to the C pre-processor
2196 (i.e. to both the C and the C++ compilers). 2235 (i.e. to both the C and the C++ compilers).
2197 This variable is exported to an environment 2236 This variable is exported to an environment
@@ -2222,12 +2261,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2222 </glossdef> 2261 </glossdef>
2223 </glossentry> 2262 </glossentry>
2224 2263
2225 <glossentry id='var-CROSS_COMPILE'><glossterm>CROSS_COMPILE<imagedata fileref="figures/define-generic.png" /></glossterm> 2264 <glossentry id='var-CROSS_COMPILE'><glossterm>CROSS_COMPILE</glossterm>
2226 <info> 2265 <info>
2227 CROSS_COMPILE[doc] = "The toolchain binary prefix for the target tools." 2266 CROSS_COMPILE[doc] = "The toolchain binary prefix for the target tools."
2228 </info> 2267 </info>
2229 <glossdef> 2268 <glossdef>
2230 <para> 2269 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2231 The toolchain binary prefix for the target tools. 2270 The toolchain binary prefix for the target tools.
2232 The <filename>CROSS_COMPILE</filename> variable is the 2271 The <filename>CROSS_COMPILE</filename> variable is the
2233 same as the 2272 same as the
@@ -2243,36 +2282,36 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2243 </glossdef> 2282 </glossdef>
2244 </glossentry> 2283 </glossentry>
2245 2284
2246 <glossentry id='var-CVSDIR'><glossterm>CVSDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 2285 <glossentry id='var-CVSDIR'><glossterm>CVSDIR</glossterm>
2247 <info> 2286 <info>
2248 CVSDIR[doc] = "The directory where cvs checkouts will be stored in." 2287 CVSDIR[doc] = "The directory where cvs checkouts will be stored in."
2249 </info> 2288 </info>
2250 <glossdef> 2289 <glossdef>
2251 <para> 2290 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2252 The directory in which files checked out under the 2291 The directory in which files checked out under the
2253 CVS system are stored. 2292 CVS system are stored.
2254 </para> 2293 </para>
2255 </glossdef> 2294 </glossdef>
2256 </glossentry> 2295 </glossentry>
2257 2296
2258 <glossentry id='var-CXX'><glossterm>CXX<imagedata fileref="figures/define-generic.png" /></glossterm> 2297 <glossentry id='var-CXX'><glossterm>CXX</glossterm>
2259 <info> 2298 <info>
2260 CXX[doc] = "Minimum command and arguments to run the C++ compiler." 2299 CXX[doc] = "Minimum command and arguments to run the C++ compiler."
2261 </info> 2300 </info>
2262 <glossdef> 2301 <glossdef>
2263 <para> 2302 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2264 The minimal command and arguments used to run the C++ 2303 The minimal command and arguments used to run the C++
2265 compiler. 2304 compiler.
2266 </para> 2305 </para>
2267 </glossdef> 2306 </glossdef>
2268 </glossentry> 2307 </glossentry>
2269 2308
2270 <glossentry id='var-CXXFLAGS'><glossterm>CXXFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 2309 <glossentry id='var-CXXFLAGS'><glossterm>CXXFLAGS</glossterm>
2271 <info> 2310 <info>
2272 CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler." 2311 CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler."
2273 </info> 2312 </info>
2274 <glossdef> 2313 <glossdef>
2275 <para> 2314 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2276 Specifies the flags to pass to the C++ compiler. 2315 Specifies the flags to pass to the C++ compiler.
2277 This variable is exported to an environment 2316 This variable is exported to an environment
2278 variable and thus made visible to the software being 2317 variable and thus made visible to the software being
@@ -2306,12 +2345,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2306 2345
2307 <glossdiv id='var-glossary-d'><title>D</title> 2346 <glossdiv id='var-glossary-d'><title>D</title>
2308 2347
2309 <glossentry id='var-D'><glossterm>D<imagedata fileref="figures/define-generic.png" /></glossterm> 2348 <glossentry id='var-D'><glossterm>D</glossterm>
2310 <info> 2349 <info>
2311 D[doc] = "The destination directory." 2350 D[doc] = "The destination directory."
2312 </info> 2351 </info>
2313 <glossdef> 2352 <glossdef>
2314 <para> 2353 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2315 The destination directory. 2354 The destination directory.
2316 The location in the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> 2355 The location in the <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>
2317 where components are installed by the 2356 where components are installed by the
@@ -2325,12 +2364,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2325 </glossdef> 2364 </glossdef>
2326 </glossentry> 2365 </glossentry>
2327 2366
2328 <glossentry id='var-DATE'><glossterm>DATE<imagedata fileref="figures/define-generic.png" /></glossterm> 2367 <glossentry id='var-DATE'><glossterm>DATE</glossterm>
2329 <info> 2368 <info>
2330 DATE[doc] = "The date the build was started using YMD format." 2369 DATE[doc] = "The date the build was started using YMD format."
2331 </info> 2370 </info>
2332 <glossdef> 2371 <glossdef>
2333 <para> 2372 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2334 The date the build was started. 2373 The date the build was started.
2335 Dates appear using the year, month, and day (YMD) format 2374 Dates appear using the year, month, and day (YMD) format
2336 (e.g. "20150209" for February 9th, 2015). 2375 (e.g. "20150209" for February 9th, 2015).
@@ -2338,24 +2377,24 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2338 </glossdef> 2377 </glossdef>
2339 </glossentry> 2378 </glossentry>
2340 2379
2341 <glossentry id='var-DATETIME'><glossterm>DATETIME<imagedata fileref="figures/define-generic.png" /></glossterm> 2380 <glossentry id='var-DATETIME'><glossterm>DATETIME</glossterm>
2342 <info> 2381 <info>
2343 DATETIME[doc] = "The date and time the build was started." 2382 DATETIME[doc] = "The date and time the build was started."
2344 </info> 2383 </info>
2345 <glossdef> 2384 <glossdef>
2346 <para> 2385 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2347 The date and time on which the current build started. 2386 The date and time on which the current build started.
2348 The format is suitable for timestamps. 2387 The format is suitable for timestamps.
2349 </para> 2388 </para>
2350 </glossdef> 2389 </glossdef>
2351 </glossentry> 2390 </glossentry>
2352 2391
2353 <glossentry id='var-DEBIAN_NOAUTONAME'><glossterm>DEBIAN_NOAUTONAME<imagedata fileref="figures/define-generic.png" /></glossterm> 2392 <glossentry id='var-DEBIAN_NOAUTONAME'><glossterm>DEBIAN_NOAUTONAME</glossterm>
2354 <info> 2393 <info>
2355 DEBIAN_NOAUTONAME[doc] = "Prevents a particular package from being renamed according to Debian package naming." 2394 DEBIAN_NOAUTONAME[doc] = "Prevents a particular package from being renamed according to Debian package naming."
2356 </info> 2395 </info>
2357 <glossdef> 2396 <glossdef>
2358 <para> 2397 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2359 When the 2398 When the
2360 <link linkend='ref-classes-debian'><filename>debian</filename></link> 2399 <link linkend='ref-classes-debian'><filename>debian</filename></link>
2361 class is inherited, which is the default behavior, 2400 class is inherited, which is the default behavior,
@@ -2373,12 +2412,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2373 </glossdef> 2412 </glossdef>
2374 </glossentry> 2413 </glossentry>
2375 2414
2376 <glossentry id='var-DEBIANNAME'><glossterm>DEBIANNAME<imagedata fileref="figures/define-generic.png" /></glossterm> 2415 <glossentry id='var-DEBIANNAME'><glossterm>DEBIANNAME</glossterm>
2377 <info> 2416 <info>
2378 DEBIANNAME[doc] = "Allows you to override the library name for an individual package for Debian library package renaming." 2417 DEBIANNAME[doc] = "Allows you to override the library name for an individual package for Debian library package renaming."
2379 </info> 2418 </info>
2380 <glossdef> 2419 <glossdef>
2381 <para> 2420 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2382 When the 2421 When the
2383 <link linkend='ref-classes-debian'><filename>debian</filename></link> 2422 <link linkend='ref-classes-debian'><filename>debian</filename></link>
2384 class is inherited, which is the default behavior, 2423 class is inherited, which is the default behavior,
@@ -2396,12 +2435,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2396 </glossdef> 2435 </glossdef>
2397 </glossentry> 2436 </glossentry>
2398 2437
2399 <glossentry id='var-DEBUG_BUILD'><glossterm>DEBUG_BUILD<imagedata fileref="figures/define-generic.png" /></glossterm> 2438 <glossentry id='var-DEBUG_BUILD'><glossterm>DEBUG_BUILD</glossterm>
2400 <info> 2439 <info>
2401 DEBUG_BUILD[doc] = "Specifies to build packages with debugging information. This influences the value of the SELECTED_OPTIMIZATION variable." 2440 DEBUG_BUILD[doc] = "Specifies to build packages with debugging information. This influences the value of the SELECTED_OPTIMIZATION variable."
2402 </info> 2441 </info>
2403 <glossdef> 2442 <glossdef>
2404 <para> 2443 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2405 Specifies to build packages with debugging information. 2444 Specifies to build packages with debugging information.
2406 This influences the value of the 2445 This influences the value of the
2407 <filename><link linkend='var-SELECTED_OPTIMIZATION'>SELECTED_OPTIMIZATION</link></filename> 2446 <filename><link linkend='var-SELECTED_OPTIMIZATION'>SELECTED_OPTIMIZATION</link></filename>
@@ -2410,12 +2449,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2410 </glossdef> 2449 </glossdef>
2411 </glossentry> 2450 </glossentry>
2412 2451
2413 <glossentry id='var-DEBUG_OPTIMIZATION'><glossterm>DEBUG_OPTIMIZATION<imagedata fileref="figures/define-generic.png" /></glossterm> 2452 <glossentry id='var-DEBUG_OPTIMIZATION'><glossterm>DEBUG_OPTIMIZATION</glossterm>
2414 <info> 2453 <info>
2415 DEBUG_OPTIMIZATION[doc] = "The options to pass in TARGET_CFLAGS and CFLAGS when compiling a system for debugging. This variable defaults to '-O -fno-omit-frame-pointer -g'." 2454 DEBUG_OPTIMIZATION[doc] = "The options to pass in TARGET_CFLAGS and CFLAGS when compiling a system for debugging. This variable defaults to '-O -fno-omit-frame-pointer -g'."
2416 </info> 2455 </info>
2417 <glossdef> 2456 <glossdef>
2418 <para> 2457 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2419 The options to pass in 2458 The options to pass in
2420 <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename> 2459 <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename>
2421 and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> when compiling 2460 and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> when compiling
@@ -2425,14 +2464,15 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2425 </glossdef> 2464 </glossdef>
2426 </glossentry> 2465 </glossentry>
2427 2466
2428 <glossentry id='var-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE<imagedata fileref="figures/define-generic.png" /></glossterm> 2467 <glossentry id='var-DEFAULT_PREFERENCE'><glossterm>DEFAULT_PREFERENCE</glossterm>
2429 <info> 2468 <info>
2430 DEFAULT_PREFERENCE[doc] = "Specifies a weak bias for recipe selection priority." 2469 DEFAULT_PREFERENCE[doc] = "Specifies a weak bias for recipe selection priority."
2431 </info> 2470 </info>
2432 <glossdef> 2471 <glossdef>
2433 <para> 2472 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2434 Specifies a weak bias for recipe selection priority. 2473 Specifies a weak bias for recipe selection priority.
2435 </para> 2474 </para>
2475
2436 <para> 2476 <para>
2437 The most common usage of this is variable is to set 2477 The most common usage of this is variable is to set
2438 it to "-1" within a recipe for a development version of a 2478 it to "-1" within a recipe for a development version of a
@@ -2442,6 +2482,7 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2442 <filename><link linkend='var-PREFERRED_VERSION'>PREFERRED_VERSION</link></filename> 2482 <filename><link linkend='var-PREFERRED_VERSION'>PREFERRED_VERSION</link></filename>
2443 being used to build the development version. 2483 being used to build the development version.
2444 </para> 2484 </para>
2485
2445 <note> 2486 <note>
2446 The bias provided by <filename>DEFAULT_PREFERENCE</filename> 2487 The bias provided by <filename>DEFAULT_PREFERENCE</filename>
2447 is weak and is overridden by 2488 is weak and is overridden by
@@ -2452,12 +2493,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2452 </glossdef> 2493 </glossdef>
2453 </glossentry> 2494 </glossentry>
2454 2495
2455 <glossentry id='var-DEFAULTTUNE'><glossterm>DEFAULTTUNE<imagedata fileref="figures/define-generic.png" /></glossterm> 2496 <glossentry id='var-DEFAULTTUNE'><glossterm>DEFAULTTUNE</glossterm>
2456 <info> 2497 <info>
2457 DEFAULTTUNE[doc] = "The default CPU and Application Binary Interface (ABI) tunings (i.e. the "tune") used by the OpenEmbedded build system." 2498 DEFAULTTUNE[doc] = "The default CPU and Application Binary Interface (ABI) tunings (i.e. the "tune") used by the OpenEmbedded build system."
2458 </info> 2499 </info>
2459 <glossdef> 2500 <glossdef>
2460 <para> 2501 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2461 The default CPU and Application Binary Interface (ABI) 2502 The default CPU and Application Binary Interface (ABI)
2462 tunings (i.e. the "tune") used by the OpenEmbedded build 2503 tunings (i.e. the "tune") used by the OpenEmbedded build
2463 system. 2504 system.
@@ -2476,12 +2517,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2476 </glossdef> 2517 </glossdef>
2477 </glossentry> 2518 </glossentry>
2478 2519
2479 <glossentry id='var-DEPENDS'><glossterm>DEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 2520 <glossentry id='var-DEPENDS'><glossterm>DEPENDS</glossterm>
2480 <info> 2521 <info>
2481 DEPENDS[doc] = "Lists a recipe's build-time dependencies (i.e. other recipe files)." 2522 DEPENDS[doc] = "Lists a recipe's build-time dependencies (i.e. other recipe files)."
2482 </info> 2523 </info>
2483 <glossdef> 2524 <glossdef>
2484 <para> 2525 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2485 Lists a recipe's build-time dependencies 2526 Lists a recipe's build-time dependencies
2486 (i.e. other recipe files). 2527 (i.e. other recipe files).
2487 The system ensures that all the dependencies listed 2528 The system ensures that all the dependencies listed
@@ -2514,12 +2555,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2514 </glossdef> 2555 </glossdef>
2515 </glossentry> 2556 </glossentry>
2516 2557
2517 <glossentry id='var-DEPLOY_DIR'><glossterm>DEPLOY_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 2558 <glossentry id='var-DEPLOY_DIR'><glossterm>DEPLOY_DIR</glossterm>
2518 <info> 2559 <info>
2519 DEPLOY_DIR[doc] = "Points to the general area that the OpenEmbedded build system uses to place images, packages, SDKs and other output files that are ready to be used outside of the build system." 2560 DEPLOY_DIR[doc] = "Points to the general area that the OpenEmbedded build system uses to place images, packages, SDKs and other output files that are ready to be used outside of the build system."
2520 </info> 2561 </info>
2521 <glossdef> 2562 <glossdef>
2522 <para> 2563 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2523 Points to the general area that the OpenEmbedded build 2564 Points to the general area that the OpenEmbedded build
2524 system uses to place images, packages, SDKs and other output 2565 system uses to place images, packages, SDKs and other output
2525 files that are ready to be used outside of the build system. 2566 files that are ready to be used outside of the build system.
@@ -2542,12 +2583,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2542 </glossdef> 2583 </glossdef>
2543 </glossentry> 2584 </glossentry>
2544 2585
2545 <glossentry id='var-DEPLOY_DIR_IMAGE'><glossterm>DEPLOY_DIR_IMAGE<imagedata fileref="figures/define-generic.png" /></glossterm> 2586 <glossentry id='var-DEPLOY_DIR_IMAGE'><glossterm>DEPLOY_DIR_IMAGE</glossterm>
2546 <info> 2587 <info>
2547 DEPLOY_DIR_IMAGE[doc] = "Points to the area that the OpenEmbedded build system uses to place images and other associated output files that are ready to be deployed onto the target machine." 2588 DEPLOY_DIR_IMAGE[doc] = "Points to the area that the OpenEmbedded build system uses to place images and other associated output files that are ready to be deployed onto the target machine."
2548 </info> 2589 </info>
2549 <glossdef> 2590 <glossdef>
2550 <para> 2591 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2551 Points to the area that the OpenEmbedded build system uses 2592 Points to the area that the OpenEmbedded build system uses
2552 to place images and other associated output files that are 2593 to place images and other associated output files that are
2553 ready to be deployed onto the target machine. 2594 ready to be deployed onto the target machine.
@@ -2572,12 +2613,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2572 </glossdef> 2613 </glossdef>
2573 </glossentry> 2614 </glossentry>
2574 2615
2575 <glossentry id='var-DEPLOYDIR'><glossterm>DEPLOYDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 2616 <glossentry id='var-DEPLOYDIR'><glossterm>DEPLOYDIR</glossterm>
2576 <info> 2617 <info>
2577 DEPLOYDIR[doc] = "For recipes that inherit the deploy class, the DEPLOYDIR points to a temporary work area for deployed files." 2618 DEPLOYDIR[doc] = "For recipes that inherit the deploy class, the DEPLOYDIR points to a temporary work area for deployed files."
2578 </info> 2619 </info>
2579 <glossdef> 2620 <glossdef>
2580 <para> 2621 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2581 When inheriting the 2622 When inheriting the
2582 <link linkend='ref-classes-deploy'><filename>deploy</filename></link> 2623 <link linkend='ref-classes-deploy'><filename>deploy</filename></link>
2583 class, the <filename>DEPLOYDIR</filename> points to a 2624 class, the <filename>DEPLOYDIR</filename> points to a
@@ -2586,6 +2627,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2586 <literallayout class='monospaced'> 2627 <literallayout class='monospaced'>
2587 DEPLOYDIR = "${WORKDIR}/deploy-${<link linkend='var-PN'><filename>PN</filename></link>}" 2628 DEPLOYDIR = "${WORKDIR}/deploy-${<link linkend='var-PN'><filename>PN</filename></link>}"
2588 </literallayout> 2629 </literallayout>
2630 </para>
2631
2632 <para>
2589 Recipes inheriting the <filename>deploy</filename> class 2633 Recipes inheriting the <filename>deploy</filename> class
2590 should copy files to be deployed into 2634 should copy files to be deployed into
2591 <filename>DEPLOYDIR</filename>, and the class will take 2635 <filename>DEPLOYDIR</filename>, and the class will take
@@ -2596,26 +2640,27 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2596 </glossdef> 2640 </glossdef>
2597 </glossentry> 2641 </glossentry>
2598 2642
2599 <glossentry id='var-DESCRIPTION'><glossterm>DESCRIPTION<imagedata fileref="figures/define-generic.png" /></glossterm> 2643 <glossentry id='var-DESCRIPTION'><glossterm>DESCRIPTION</glossterm>
2600 <info> 2644 <info>
2601 DESCRIPTION[doc] = "The package description used by package managers. If not set, DESCRIPTION takes the value of the SUMMARY variable." 2645 DESCRIPTION[doc] = "The package description used by package managers. If not set, DESCRIPTION takes the value of the SUMMARY variable."
2602 </info> 2646 </info>
2603 <glossdef> 2647 <glossdef>
2604 <para>The package description used by package managers. 2648 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2605 If not set, <filename>DESCRIPTION</filename> takes 2649 The package description used by package managers.
2606 the value of the 2650 If not set, <filename>DESCRIPTION</filename> takes
2607 <link linkend='var-SUMMARY'><filename>SUMMARY</filename></link> 2651 the value of the
2608 variable. 2652 <link linkend='var-SUMMARY'><filename>SUMMARY</filename></link>
2653 variable.
2609 </para> 2654 </para>
2610 </glossdef> 2655 </glossdef>
2611 </glossentry> 2656 </glossentry>
2612 2657
2613 <glossentry id='var-DISK_SIGNATURE'><glossterm>DISK_SIGNATURE<imagedata fileref="figures/define-generic.png" /></glossterm> 2658 <glossentry id='var-DISK_SIGNATURE'><glossterm>DISK_SIGNATURE</glossterm>
2614 <info> 2659 <info>
2615 DISK_SIGNATURE[doc] = "A 32-bit MBR disk signature used by directdisk images." 2660 DISK_SIGNATURE[doc] = "A 32-bit MBR disk signature used by directdisk images."
2616 </info> 2661 </info>
2617 <glossdef> 2662 <glossdef>
2618 <para> 2663 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2619 A 32-bit MBR disk signature used by 2664 A 32-bit MBR disk signature used by
2620 <filename>directdisk</filename> images. 2665 <filename>directdisk</filename> images.
2621 </para> 2666 </para>
@@ -2663,12 +2708,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2663 </glossdef> 2708 </glossdef>
2664 </glossentry> 2709 </glossentry>
2665 2710
2666 <glossentry id='var-DISTRO'><glossterm>DISTRO<imagedata fileref="figures/define-generic.png" /></glossterm> 2711 <glossentry id='var-DISTRO'><glossterm>DISTRO</glossterm>
2667 <info> 2712 <info>
2668 DISTRO[doc] = "The short name of the distribution. If the variable is blank, meta/conf/distro/defaultsetup.conf will be used." 2713 DISTRO[doc] = "The short name of the distribution. If the variable is blank, meta/conf/distro/defaultsetup.conf will be used."
2669 </info> 2714 </info>
2670 <glossdef> 2715 <glossdef>
2671 <para> 2716 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2672 The short name of the distribution. 2717 The short name of the distribution.
2673 This variable corresponds to a distribution 2718 This variable corresponds to a distribution
2674 configuration file whose root name is the same as the 2719 configuration file whose root name is the same as the
@@ -2708,23 +2753,23 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2708 </glossdef> 2753 </glossdef>
2709 </glossentry> 2754 </glossentry>
2710 2755
2711 <glossentry id='var-DISTRO_CODENAME'><glossterm>DISTRO_CODENAME<imagedata fileref="figures/define-generic.png" /></glossterm> 2756 <glossentry id='var-DISTRO_CODENAME'><glossterm>DISTRO_CODENAME</glossterm>
2712 <info> 2757 <info>
2713 DISTRO_CODENAME[doc] = "Specifies a codename for the distribution being built." 2758 DISTRO_CODENAME[doc] = "Specifies a codename for the distribution being built."
2714 </info> 2759 </info>
2715 <glossdef> 2760 <glossdef>
2716 <para> 2761 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2717 Specifies a codename for the distribution being built. 2762 Specifies a codename for the distribution being built.
2718 </para> 2763 </para>
2719 </glossdef> 2764 </glossdef>
2720 </glossentry> 2765 </glossentry>
2721 2766
2722 <glossentry id='var-DISTRO_EXTRA_RDEPENDS'><glossterm>DISTRO_EXTRA_RDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 2767 <glossentry id='var-DISTRO_EXTRA_RDEPENDS'><glossterm>DISTRO_EXTRA_RDEPENDS</glossterm>
2723 <info> 2768 <info>
2724 DISTRO_EXTRA_RDEPENDS[doc] = "Specifies a list of distro-specific packages to add to all images. The variable only applies to the images that include packagegroup-base." 2769 DISTRO_EXTRA_RDEPENDS[doc] = "Specifies a list of distro-specific packages to add to all images. The variable only applies to the images that include packagegroup-base."
2725 </info> 2770 </info>
2726 <glossdef> 2771 <glossdef>
2727 <para> 2772 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2728 Specifies a list of distro-specific packages to add to all images. 2773 Specifies a list of distro-specific packages to add to all images.
2729 This variable takes affect through 2774 This variable takes affect through
2730 <filename>packagegroup-base</filename> so the 2775 <filename>packagegroup-base</filename> so the
@@ -2738,12 +2783,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2738 </glossdef> 2783 </glossdef>
2739 </glossentry> 2784 </glossentry>
2740 2785
2741 <glossentry id='var-DISTRO_EXTRA_RRECOMMENDS'><glossterm>DISTRO_EXTRA_RRECOMMENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 2786 <glossentry id='var-DISTRO_EXTRA_RRECOMMENDS'><glossterm>DISTRO_EXTRA_RRECOMMENDS</glossterm>
2742 <info> 2787 <info>
2743 DISTRO_EXTRA_RRECOMMENDS[doc] = "Specifies a list of distro-specific packages to add to all images if the packages exist. The list of packages are automatically installed but you can remove them." 2788 DISTRO_EXTRA_RRECOMMENDS[doc] = "Specifies a list of distro-specific packages to add to all images if the packages exist. The list of packages are automatically installed but you can remove them."
2744 </info> 2789 </info>
2745 <glossdef> 2790 <glossdef>
2746 <para> 2791 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2747 Specifies a list of distro-specific packages to add to all images 2792 Specifies a list of distro-specific packages to add to all images
2748 if the packages exist. 2793 if the packages exist.
2749 The packages might not exist or be empty (e.g. kernel modules). 2794 The packages might not exist or be empty (e.g. kernel modules).
@@ -2753,12 +2798,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2753 </glossdef> 2798 </glossdef>
2754 </glossentry> 2799 </glossentry>
2755 2800
2756 <glossentry id='var-DISTRO_FEATURES'><glossterm>DISTRO_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 2801 <glossentry id='var-DISTRO_FEATURES'><glossterm>DISTRO_FEATURES</glossterm>
2757 <info> 2802 <info>
2758 DISTRO_FEATURES[doc] = "The features enabled for the distribution." 2803 DISTRO_FEATURES[doc] = "The features enabled for the distribution."
2759 </info> 2804 </info>
2760 <glossdef> 2805 <glossdef>
2761 <para> 2806 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2762 The software support you want in your distribution for 2807 The software support you want in your distribution for
2763 various features. 2808 various features.
2764 You define your distribution features in the distribution 2809 You define your distribution features in the distribution
@@ -2789,12 +2834,13 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2789 </glossdef> 2834 </glossdef>
2790 </glossentry> 2835 </glossentry>
2791 2836
2792 <glossentry id='var-DISTRO_FEATURES_BACKFILL'><glossterm>DISTRO_FEATURES_BACKFILL<imagedata fileref="figures/define-generic.png" /></glossterm> 2837 <glossentry id='var-DISTRO_FEATURES_BACKFILL'><glossterm>DISTRO_FEATURES_BACKFILL</glossterm>
2793 <info> 2838 <info>
2794 DISTRO_FEATURES_BACKFILL[doc] = "Features to be added to DISTRO_FEATURES if not also present in DISTRO_FEATURES_BACKFILL_CONSIDERED. This variable is set in the meta/conf/bitbake.conf file and it is not intended to be user-configurable." 2839 DISTRO_FEATURES_BACKFILL[doc] = "Features to be added to DISTRO_FEATURES if not also present in DISTRO_FEATURES_BACKFILL_CONSIDERED. This variable is set in the meta/conf/bitbake.conf file and it is not intended to be user-configurable."
2795 </info> 2840 </info>
2796 <glossdef> 2841 <glossdef>
2797 <para>Features to be added to 2842 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2843 Features to be added to
2798 <filename><link linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></filename> 2844 <filename><link linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></filename>
2799 if not also present in 2845 if not also present in
2800 <filename><link linkend='var-DISTRO_FEATURES_BACKFILL_CONSIDERED'>DISTRO_FEATURES_BACKFILL_CONSIDERED</link></filename>. 2846 <filename><link linkend='var-DISTRO_FEATURES_BACKFILL_CONSIDERED'>DISTRO_FEATURES_BACKFILL_CONSIDERED</link></filename>.
@@ -2811,28 +2857,29 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2811 </glossdef> 2857 </glossdef>
2812 </glossentry> 2858 </glossentry>
2813 2859
2814 <glossentry id='var-DISTRO_FEATURES_BACKFILL_CONSIDERED'><glossterm>DISTRO_FEATURES_BACKFILL_CONSIDERED<imagedata fileref="figures/define-generic.png" /></glossterm> 2860 <glossentry id='var-DISTRO_FEATURES_BACKFILL_CONSIDERED'><glossterm>DISTRO_FEATURES_BACKFILL_CONSIDERED</glossterm>
2815 <info> 2861 <info>
2816 DISTRO_FEATURES_BACKFILL_CONSIDERED[doc] = "Features from DISTRO_FEATURES_BACKFILL that should not be backfilled (i.e. added to DISTRO_FEATURES) during the build." 2862 DISTRO_FEATURES_BACKFILL_CONSIDERED[doc] = "Features from DISTRO_FEATURES_BACKFILL that should not be backfilled (i.e. added to DISTRO_FEATURES) during the build."
2817 </info> 2863 </info>
2818 <glossdef> 2864 <glossdef>
2819 <para>Features from 2865 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2866 Features from
2820 <filename><link linkend='var-DISTRO_FEATURES_BACKFILL'>DISTRO_FEATURES_BACKFILL</link></filename> 2867 <filename><link linkend='var-DISTRO_FEATURES_BACKFILL'>DISTRO_FEATURES_BACKFILL</link></filename>
2821 that should not be backfilled (i.e. added to 2868 that should not be backfilled (i.e. added to
2822 <filename><link linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></filename>) 2869 <filename><link linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></filename>)
2823 during the build. 2870 during the build.
2824 See the "<link linkend='ref-features-backfill'>Feature Backfilling</link>" section for 2871 See the "<link linkend='ref-features-backfill'>Feature Backfilling</link>" section for
2825 more information. 2872 more information.
2826 </para> 2873 </para>
2827 </glossdef> 2874 </glossdef>
2828 </glossentry> 2875 </glossentry>
2829 2876
2830 <glossentry id='var-DISTRO_FEATURES_DEFAULT'><glossterm>DISTRO_FEATURES_DEFAULT<imagedata fileref="figures/define-generic.png" /></glossterm> 2877 <glossentry id='var-DISTRO_FEATURES_DEFAULT'><glossterm>DISTRO_FEATURES_DEFAULT</glossterm>
2831 <info> 2878 <info>
2832 DISTRO_FEATURES_DEFAULT[doc] = "Provides the default list of distro features with the exception of any libc-specific features." 2879 DISTRO_FEATURES_DEFAULT[doc] = "Provides the default list of distro features with the exception of any libc-specific features."
2833 </info> 2880 </info>
2834 <glossdef> 2881 <glossdef>
2835 <para> 2882 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2836 A convenience variable that gives you the default 2883 A convenience variable that gives you the default
2837 list of distro features with the exception of any 2884 list of distro features with the exception of any
2838 features specific to the C library 2885 features specific to the C library
@@ -2854,12 +2901,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2854 </glossdef> 2901 </glossdef>
2855 </glossentry> 2902 </glossentry>
2856 2903
2857 <glossentry id='var-DISTRO_FEATURES_LIBC'><glossterm>DISTRO_FEATURES_LIBC<imagedata fileref="figures/define-generic.png" /></glossterm> 2904 <glossentry id='var-DISTRO_FEATURES_LIBC'><glossterm>DISTRO_FEATURES_LIBC</glossterm>
2858 <info> 2905 <info>
2859 DISTRO_FEATURES_LIBC[doc] = "Specifies the list of distro features that are specific to the C library (libc)." 2906 DISTRO_FEATURES_LIBC[doc] = "Specifies the list of distro features that are specific to the C library (libc)."
2860 </info> 2907 </info>
2861 <glossdef> 2908 <glossdef>
2862 <para> 2909 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2863 A convenience variable that specifies the list of distro 2910 A convenience variable that specifies the list of distro
2864 features that are specific to the C library 2911 features that are specific to the C library
2865 (<filename>libc</filename>). 2912 (<filename>libc</filename>).
@@ -2870,30 +2917,34 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2870 </glossdef> 2917 </glossdef>
2871 </glossentry> 2918 </glossentry>
2872 2919
2873 <glossentry id='var-DISTRO_NAME'><glossterm>DISTRO_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 2920 <glossentry id='var-DISTRO_NAME'><glossterm>DISTRO_NAME</glossterm>
2874 <info> 2921 <info>
2875 DISTRO_NAME[doc] = "The long name of the distribution." 2922 DISTRO_NAME[doc] = "The long name of the distribution."
2876 </info> 2923 </info>
2877 <glossdef> 2924 <glossdef>
2878 <para>The long name of the distribution.</para> 2925 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2926 The long name of the distribution.
2927 </para>
2879 </glossdef> 2928 </glossdef>
2880 </glossentry> 2929 </glossentry>
2881 2930
2882 <glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION<imagedata fileref="figures/define-generic.png" /></glossterm> 2931 <glossentry id='var-DISTRO_VERSION'><glossterm>DISTRO_VERSION</glossterm>
2883 <info> 2932 <info>
2884 DISTRO_VERSION[doc] = "The version of the distribution." 2933 DISTRO_VERSION[doc] = "The version of the distribution."
2885 </info> 2934 </info>
2886 <glossdef> 2935 <glossdef>
2887 <para>The version of the distribution.</para> 2936 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2937 The version of the distribution.
2938 </para>
2888 </glossdef> 2939 </glossdef>
2889 </glossentry> 2940 </glossentry>
2890 2941
2891 <glossentry id='var-DISTROOVERRIDES'><glossterm>DISTROOVERRIDES<imagedata fileref="figures/define-generic.png" /></glossterm> 2942 <glossentry id='var-DISTROOVERRIDES'><glossterm>DISTROOVERRIDES</glossterm>
2892 <info> 2943 <info>
2893 DISTROOVERRIDES[doc] = "Lists overrides specific to the current distribution. By default, the variable list includes the value of the DISTRO variable." 2944 DISTROOVERRIDES[doc] = "Lists overrides specific to the current distribution. By default, the variable list includes the value of the DISTRO variable."
2894 </info> 2945 </info>
2895 <glossdef> 2946 <glossdef>
2896 <para> 2947 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2897 This variable lists overrides specific to the current 2948 This variable lists overrides specific to the current
2898 distribution. 2949 distribution.
2899 By default, the variable list includes the value of the 2950 By default, the variable list includes the value of the
@@ -2907,12 +2958,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2907 </glossdef> 2958 </glossdef>
2908 </glossentry> 2959 </glossentry>
2909 2960
2910 <glossentry id='var-DL_DIR'><glossterm>DL_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 2961 <glossentry id='var-DL_DIR'><glossterm>DL_DIR</glossterm>
2911 <info> 2962 <info>
2912 DL_DIR[doc] = "The central download directory used by the build process to store downloads. By default, the directory is 'downloads' in the Build Directory." 2963 DL_DIR[doc] = "The central download directory used by the build process to store downloads. By default, the directory is 'downloads' in the Build Directory."
2913 </info> 2964 </info>
2914 <glossdef> 2965 <glossdef>
2915 <para> 2966 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2916 The central download directory used by the build process to 2967 The central download directory used by the build process to
2917 store downloads. 2968 store downloads.
2918 By default, <filename>DL_DIR</filename> gets files 2969 By default, <filename>DL_DIR</filename> gets files
@@ -2966,12 +3017,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2966 </glossdef> 3017 </glossdef>
2967 </glossentry> 3018 </glossentry>
2968 3019
2969 <glossentry id='var-DOC_COMPRESS'><glossterm>DOC_COMPRESS<imagedata fileref="figures/define-generic.png" /></glossterm> 3020 <glossentry id='var-DOC_COMPRESS'><glossterm>DOC_COMPRESS</glossterm>
2970 <info> 3021 <info>
2971 DOC_COMPRESS[doc] = "When inheriting the compress_doc class, this variable sets the compression policy used when the OpenEmbedded build system compresses man pages and info pages." 3022 DOC_COMPRESS[doc] = "When inheriting the compress_doc class, this variable sets the compression policy used when the OpenEmbedded build system compresses man pages and info pages."
2972 </info> 3023 </info>
2973 <glossdef> 3024 <glossdef>
2974 <para> 3025 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
2975 When inheriting the 3026 When inheriting the
2976 <link linkend='ref-classes-compress_doc'><filename>compress_doc</filename></link> 3027 <link linkend='ref-classes-compress_doc'><filename>compress_doc</filename></link>
2977 class, this variable sets the compression policy used when 3028 class, this variable sets the compression policy used when
@@ -2993,12 +3044,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
2993 3044
2994 <glossdiv id='var-glossary-e'><title>E</title> 3045 <glossdiv id='var-glossary-e'><title>E</title>
2995 3046
2996 <glossentry id='var-EFI_PROVIDER'><glossterm>EFI_PROVIDER<imagedata fileref="figures/define-generic.png" /></glossterm> 3047 <glossentry id='var-EFI_PROVIDER'><glossterm>EFI_PROVIDER</glossterm>
2997 <info> 3048 <info>
2998 EFI_PROVIDER[doc] = "When building bootable images (i.e. where hddimg or vmdk is in IMAGE_FSTYPES), the EFI_PROVIDER variable specifies the EFI bootloader to use." 3049 EFI_PROVIDER[doc] = "When building bootable images (i.e. where hddimg or vmdk is in IMAGE_FSTYPES), the EFI_PROVIDER variable specifies the EFI bootloader to use."
2999 </info> 3050 </info>
3000 <glossdef> 3051 <glossdef>
3001 <para> 3052 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3002 When building bootable images (i.e. where 3053 When building bootable images (i.e. where
3003 <filename>hddimg</filename> or <filename>vmdk</filename> 3054 <filename>hddimg</filename> or <filename>vmdk</filename>
3004 is in 3055 is in
@@ -3017,24 +3068,26 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3017 </glossdef> 3068 </glossdef>
3018 </glossentry> 3069 </glossentry>
3019 3070
3020 <glossentry id='var-ENABLE_BINARY_LOCALE_GENERATION'><glossterm>ENABLE_BINARY_LOCALE_GENERATION<imagedata fileref="figures/define-generic.png" /></glossterm> 3071 <glossentry id='var-ENABLE_BINARY_LOCALE_GENERATION'><glossterm>ENABLE_BINARY_LOCALE_GENERATION</glossterm>
3021 <info> 3072 <info>
3022 ENABLE_BINARY_LOCALE_GENERATION[doc] = "Controls which locales for glibc are generated during the build. The variable is useful if the target device has 64Mbytes of RAM or less." 3073 ENABLE_BINARY_LOCALE_GENERATION[doc] = "Controls which locales for glibc are generated during the build. The variable is useful if the target device has 64Mbytes of RAM or less."
3023 </info> 3074 </info>
3024 <glossdef> 3075 <glossdef>
3025 <para>Variable that controls which locales for 3076 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3077 Variable that controls which locales for
3026 <filename>glibc</filename> are generated during the 3078 <filename>glibc</filename> are generated during the
3027 build (useful if the target device has 64Mbytes 3079 build (useful if the target device has 64Mbytes
3028 of RAM or less).</para> 3080 of RAM or less).
3081 </para>
3029 </glossdef> 3082 </glossdef>
3030 </glossentry> 3083 </glossentry>
3031 3084
3032 <glossentry id='var-ERR_REPORT_DIR'><glossterm>ERR_REPORT_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 3085 <glossentry id='var-ERR_REPORT_DIR'><glossterm>ERR_REPORT_DIR</glossterm>
3033 <info> 3086 <info>
3034 ERR_REPORT_DIR[doc] = "When used with the report-error class, specifies the path used for storing the debug files created by the error reporting tool, which allows you to submit build errors you encounter to a central database." 3087 ERR_REPORT_DIR[doc] = "When used with the report-error class, specifies the path used for storing the debug files created by the error reporting tool, which allows you to submit build errors you encounter to a central database."
3035 </info> 3088 </info>
3036 <glossdef> 3089 <glossdef>
3037 <para> 3090 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3038 When used with the 3091 When used with the
3039 <link linkend='ref-classes-report-error'><filename>report-error</filename></link> 3092 <link linkend='ref-classes-report-error'><filename>report-error</filename></link>
3040 class, specifies the path used for storing the debug files 3093 class, specifies the path used for storing the debug files
@@ -3057,12 +3110,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3057 </glossdef> 3110 </glossdef>
3058 </glossentry> 3111 </glossentry>
3059 3112
3060 <glossentry id='var-ERROR_QA'><glossterm>ERROR_QA<imagedata fileref="figures/define-generic.png" /></glossterm> 3113 <glossentry id='var-ERROR_QA'><glossterm>ERROR_QA</glossterm>
3061 <info> 3114 <info>
3062 ERROR_QA[doc] = "Specifies the quality assurance checks whose failures are reported as errors by the OpenEmbedded build system." 3115 ERROR_QA[doc] = "Specifies the quality assurance checks whose failures are reported as errors by the OpenEmbedded build system."
3063 </info> 3116 </info>
3064 <glossdef> 3117 <glossdef>
3065 <para> 3118 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3066 Specifies the quality assurance checks whose failures are 3119 Specifies the quality assurance checks whose failures are
3067 reported as errors by the OpenEmbedded build system. 3120 reported as errors by the OpenEmbedded build system.
3068 You set this variable in your distribution configuration 3121 You set this variable in your distribution configuration
@@ -3075,12 +3128,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3075 </glossdef> 3128 </glossdef>
3076 </glossentry> 3129 </glossentry>
3077 3130
3078 <glossentry id='var-EXCLUDE_FROM_WORLD'><glossterm>EXCLUDE_FROM_WORLD<imagedata fileref="figures/define-generic.png" /></glossterm> 3131 <glossentry id='var-EXCLUDE_FROM_WORLD'><glossterm>EXCLUDE_FROM_WORLD</glossterm>
3079 <info> 3132 <info>
3080 EXCLUDE_FROM_WORLD[doc] = "Directs BitBake to exclude a recipe from world builds (i.e. bitbake world)." 3133 EXCLUDE_FROM_WORLD[doc] = "Directs BitBake to exclude a recipe from world builds (i.e. bitbake world)."
3081 </info> 3134 </info>
3082 <glossdef> 3135 <glossdef>
3083 <para> 3136 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3084 Directs BitBake to exclude a recipe from world builds (i.e. 3137 Directs BitBake to exclude a recipe from world builds (i.e.
3085 <filename>bitbake world</filename>). 3138 <filename>bitbake world</filename>).
3086 During world builds, BitBake locates, parses and builds all 3139 During world builds, BitBake locates, parses and builds all
@@ -3104,12 +3157,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3104 </glossdef> 3157 </glossdef>
3105 </glossentry> 3158 </glossentry>
3106 3159
3107 <glossentry id='var-EXTENDPE'><glossterm>EXTENDPE<imagedata fileref="figures/define-generic.png" /></glossterm> 3160 <glossentry id='var-EXTENDPE'><glossterm>EXTENDPE</glossterm>
3108 <info> 3161 <info>
3109 EXTENDPE[doc] = "Used with file and pathnames to create a prefix for a recipe's version based on the recipe's PE value. If PE is set and greater than zero for a recipe, EXTENDPE becomes that value." 3162 EXTENDPE[doc] = "Used with file and pathnames to create a prefix for a recipe's version based on the recipe's PE value. If PE is set and greater than zero for a recipe, EXTENDPE becomes that value."
3110 </info> 3163 </info>
3111 <glossdef> 3164 <glossdef>
3112 <para> 3165 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3113 Used with file and pathnames to create a prefix for a recipe's 3166 Used with file and pathnames to create a prefix for a recipe's
3114 version based on the recipe's 3167 version based on the recipe's
3115 <link linkend='var-PE'><filename>PE</filename></link> value. 3168 <link linkend='var-PE'><filename>PE</filename></link> value.
@@ -3125,12 +3178,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3125 </glossdef> 3178 </glossdef>
3126 </glossentry> 3179 </glossentry>
3127 3180
3128 <glossentry id='var-EXTENDPKGV'><glossterm>EXTENDPKGV<imagedata fileref="figures/define-generic.png" /></glossterm> 3181 <glossentry id='var-EXTENDPKGV'><glossterm>EXTENDPKGV</glossterm>
3129 <info> 3182 <info>
3130 EXTENDPKGV[doc] = "The full package version specification as it appears on the final packages produced by a recipe." 3183 EXTENDPKGV[doc] = "The full package version specification as it appears on the final packages produced by a recipe."
3131 </info> 3184 </info>
3132 <glossdef> 3185 <glossdef>
3133 <para> 3186 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3134 The full package version specification as it appears on the 3187 The full package version specification as it appears on the
3135 final packages produced by a recipe. 3188 final packages produced by a recipe.
3136 The variable's value is normally used to fix a runtime 3189 The variable's value is normally used to fix a runtime
@@ -3149,12 +3202,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3149 </glossdef> 3202 </glossdef>
3150 </glossentry> 3203 </glossentry>
3151 3204
3152 <glossentry id='var-EXTERNALSRC'><glossterm>EXTERNALSRC<imagedata fileref="figures/define-generic.png" /></glossterm> 3205 <glossentry id='var-EXTERNALSRC'><glossterm>EXTERNALSRC</glossterm>
3153 <info> 3206 <info>
3154 EXTERNALSRC[doc] = "If externalsrc.bbclass is inherited, this variable points to the source tree, which is outside of the OpenEmbedded build system." 3207 EXTERNALSRC[doc] = "If externalsrc.bbclass is inherited, this variable points to the source tree, which is outside of the OpenEmbedded build system."
3155 </info> 3208 </info>
3156 <glossdef> 3209 <glossdef>
3157 <para> 3210 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3158 When inheriting the 3211 When inheriting the
3159 <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link> 3212 <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link>
3160 class, this variable points to the source tree, which is 3213 class, this variable points to the source tree, which is
@@ -3178,12 +3231,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3178 </glossdef> 3231 </glossdef>
3179 </glossentry> 3232 </glossentry>
3180 3233
3181 <glossentry id='var-EXTERNALSRC_BUILD'><glossterm>EXTERNALSRC_BUILD<imagedata fileref="figures/define-generic.png" /></glossterm> 3234 <glossentry id='var-EXTERNALSRC_BUILD'><glossterm>EXTERNALSRC_BUILD</glossterm>
3182 <info> 3235 <info>
3183 EXTERNALSRC_BUILD[doc] = "If externalsrc.bbclass is inherited, this variable points to the directory in which the recipe's source code is built, which is outside of the OpenEmbedded build system." 3236 EXTERNALSRC_BUILD[doc] = "If externalsrc.bbclass is inherited, this variable points to the directory in which the recipe's source code is built, which is outside of the OpenEmbedded build system."
3184 </info> 3237 </info>
3185 <glossdef> 3238 <glossdef>
3186 <para> 3239 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3187 When inheriting the 3240 When inheriting the
3188 <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link> 3241 <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link>
3189 class, this variable points to the directory in which the 3242 class, this variable points to the directory in which the
@@ -3208,12 +3261,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3208 </glossdef> 3261 </glossdef>
3209 </glossentry> 3262 </glossentry>
3210 3263
3211 <glossentry id='var-EXTRA_AUTORECONF'><glossterm>EXTRA_AUTORECONF<imagedata fileref="figures/define-generic.png" /></glossterm> 3264 <glossentry id='var-EXTRA_AUTORECONF'><glossterm>EXTRA_AUTORECONF</glossterm>
3212 <info> 3265 <info>
3213 EXTRA_AUTORECONF[doc] = "Extra options passed to the autoreconf command, which is executed during do_configure." 3266 EXTRA_AUTORECONF[doc] = "Extra options passed to the autoreconf command, which is executed during do_configure."
3214 </info> 3267 </info>
3215 <glossdef> 3268 <glossdef>
3216 <para> 3269 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3217 For recipes inheriting the 3270 For recipes inheriting the
3218 <link linkend='ref-classes-autotools'><filename>autotools</filename></link> 3271 <link linkend='ref-classes-autotools'><filename>autotools</filename></link>
3219 class, you can use <filename>EXTRA_AUTORECONF</filename> to 3272 class, you can use <filename>EXTRA_AUTORECONF</filename> to
@@ -3230,12 +3283,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3230 </glossdef> 3283 </glossdef>
3231 </glossentry> 3284 </glossentry>
3232 3285
3233 <glossentry id='var-EXTRA_IMAGE_FEATURES'><glossterm>EXTRA_IMAGE_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 3286 <glossentry id='var-EXTRA_IMAGE_FEATURES'><glossterm>EXTRA_IMAGE_FEATURES</glossterm>
3234 <info> 3287 <info>
3235 EXTRA_IMAGE_FEATURES[doc] = "The list of additional features to include in an image. Configure this variable in the conf/local.conf file in the Build Directory." 3288 EXTRA_IMAGE_FEATURES[doc] = "The list of additional features to include in an image. Configure this variable in the conf/local.conf file in the Build Directory."
3236 </info> 3289 </info>
3237 <glossdef> 3290 <glossdef>
3238 <para> 3291 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3239 The list of additional features to include in an image. 3292 The list of additional features to include in an image.
3240 Typically, you configure this variable in your 3293 Typically, you configure this variable in your
3241 <filename>local.conf</filename> file, which is found in the 3294 <filename>local.conf</filename> file, which is found in the
@@ -3308,12 +3361,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3308 </glossdef> 3361 </glossdef>
3309 </glossentry> 3362 </glossentry>
3310 3363
3311 <glossentry id='var-EXTRA_IMAGECMD'><glossterm>EXTRA_IMAGECMD<imagedata fileref="figures/define-generic.png" /></glossterm> 3364 <glossentry id='var-EXTRA_IMAGECMD'><glossterm>EXTRA_IMAGECMD</glossterm>
3312 <info> 3365 <info>
3313 EXTRA_IMAGECMD[doc] = "Specifies additional options for the image creation command that has been specified in IMAGE_CMD. When setting this variable, you should use an override for the associated type." 3366 EXTRA_IMAGECMD[doc] = "Specifies additional options for the image creation command that has been specified in IMAGE_CMD. When setting this variable, you should use an override for the associated type."
3314 </info> 3367 </info>
3315 <glossdef> 3368 <glossdef>
3316 <para> 3369 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3317 Specifies additional options for the image 3370 Specifies additional options for the image
3318 creation command that has been specified in 3371 creation command that has been specified in
3319 <link linkend='var-IMAGE_CMD'><filename>IMAGE_CMD</filename></link>. 3372 <link linkend='var-IMAGE_CMD'><filename>IMAGE_CMD</filename></link>.
@@ -3327,20 +3380,24 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3327 </glossdef> 3380 </glossdef>
3328 </glossentry> 3381 </glossentry>
3329 3382
3330 <glossentry id='var-EXTRA_IMAGEDEPENDS'><glossterm>EXTRA_IMAGEDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 3383 <glossentry id='var-EXTRA_IMAGEDEPENDS'><glossterm>EXTRA_IMAGEDEPENDS</glossterm>
3331 <info> 3384 <info>
3332 EXTRA_IMAGEDEPENDS[doc] = "A list of recipes to build that do not provide packages for installing into the root filesystem. Use this variable to list recipes that are required to build the final image, but not needed in the root filesystem." 3385 EXTRA_IMAGEDEPENDS[doc] = "A list of recipes to build that do not provide packages for installing into the root filesystem. Use this variable to list recipes that are required to build the final image, but not needed in the root filesystem."
3333 </info> 3386 </info>
3334 <glossdef> 3387 <glossdef>
3335 <para>A list of recipes to build that do not provide packages 3388 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3389 A list of recipes to build that do not provide packages
3336 for installing into the root filesystem. 3390 for installing into the root filesystem.
3337 </para> 3391 </para>
3338 <para>Sometimes a recipe is required to build the final image but is not 3392
3393 <para>
3394 Sometimes a recipe is required to build the final image but is not
3339 needed in the root filesystem. 3395 needed in the root filesystem.
3340 You can use the <filename>EXTRA_IMAGEDEPENDS</filename> variable to 3396 You can use the <filename>EXTRA_IMAGEDEPENDS</filename> variable to
3341 list these recipes and thus specify the dependencies. 3397 list these recipes and thus specify the dependencies.
3342 A typical example is a required bootloader in a machine configuration. 3398 A typical example is a required bootloader in a machine configuration.
3343 </para> 3399 </para>
3400
3344 <note> 3401 <note>
3345 To add packages to the root filesystem, see the various 3402 To add packages to the root filesystem, see the various
3346 <filename>*<link linkend='var-RDEPENDS'>RDEPENDS</link></filename> 3403 <filename>*<link linkend='var-RDEPENDS'>RDEPENDS</link></filename>
@@ -3350,39 +3407,45 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3350 </glossdef> 3407 </glossdef>
3351 </glossentry> 3408 </glossentry>
3352 3409
3353 <glossentry id='var-EXTRA_OECMAKE'><glossterm>EXTRA_OECMAKE<imagedata fileref="figures/define-generic.png" /></glossterm> 3410 <glossentry id='var-EXTRA_OECMAKE'><glossterm>EXTRA_OECMAKE</glossterm>
3354 <info> 3411 <info>
3355 EXTRA_OECMAKE[doc] = "Additional cmake options." 3412 EXTRA_OECMAKE[doc] = "Additional cmake options."
3356 </info> 3413 </info>
3357 <glossdef> 3414 <glossdef>
3358 <para>Additional <filename>cmake</filename> options.</para> 3415 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3416 Additional <filename>cmake</filename> options.
3417 </para>
3359 </glossdef> 3418 </glossdef>
3360 </glossentry> 3419 </glossentry>
3361 3420
3362 <glossentry id='var-EXTRA_OECONF'><glossterm>EXTRA_OECONF<imagedata fileref="figures/define-generic.png" /></glossterm> 3421 <glossentry id='var-EXTRA_OECONF'><glossterm>EXTRA_OECONF</glossterm>
3363 <info> 3422 <info>
3364 EXTRA_OECONF[doc] = "Additional configure script options." 3423 EXTRA_OECONF[doc] = "Additional configure script options."
3365 </info> 3424 </info>
3366 <glossdef> 3425 <glossdef>
3367 <para>Additional <filename>configure</filename> script options.</para> 3426 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3427 Additional <filename>configure</filename> script options.
3428 </para>
3368 </glossdef> 3429 </glossdef>
3369 </glossentry> 3430 </glossentry>
3370 3431
3371 <glossentry id='var-EXTRA_OEMAKE'><glossterm>EXTRA_OEMAKE<imagedata fileref="figures/define-generic.png" /></glossterm> 3432 <glossentry id='var-EXTRA_OEMAKE'><glossterm>EXTRA_OEMAKE</glossterm>
3372 <info> 3433 <info>
3373 EXTRA_OEMAKE[doc] = "Additional GNU make options." 3434 EXTRA_OEMAKE[doc] = "Additional GNU make options."
3374 </info> 3435 </info>
3375 <glossdef> 3436 <glossdef>
3376 <para>Additional GNU <filename>make</filename> options.</para> 3437 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3438 Additional GNU <filename>make</filename> options.
3439 </para>
3377 </glossdef> 3440 </glossdef>
3378 </glossentry> 3441 </glossentry>
3379 3442
3380 <glossentry id='var-EXTRA_OESCONS'><glossterm>EXTRA_OESCONS<imagedata fileref="figures/define-generic.png" /></glossterm> 3443 <glossentry id='var-EXTRA_OESCONS'><glossterm>EXTRA_OESCONS</glossterm>
3381 <info> 3444 <info>
3382 EXTRA_OESCONS[doc] = "When a recipe inherits the scons class, this variable specifies additional configuration options you want to pass to the scons command line." 3445 EXTRA_OESCONS[doc] = "When a recipe inherits the scons class, this variable specifies additional configuration options you want to pass to the scons command line."
3383 </info> 3446 </info>
3384 <glossdef> 3447 <glossdef>
3385 <para> 3448 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3386 When inheriting the 3449 When inheriting the
3387 <link linkend='ref-classes-scons'><filename>scons</filename></link> 3450 <link linkend='ref-classes-scons'><filename>scons</filename></link>
3388 class, this variable specifies additional configuration 3451 class, this variable specifies additional configuration
@@ -3392,12 +3455,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3392 </glossdef> 3455 </glossdef>
3393 </glossentry> 3456 </glossentry>
3394 3457
3395 <glossentry id='var-EXTRA_QMAKEVARS_POST'><glossterm>EXTRA_QMAKEVARS_POST<imagedata fileref="figures/define-generic.png" /></glossterm> 3458 <glossentry id='var-EXTRA_QMAKEVARS_POST'><glossterm>EXTRA_QMAKEVARS_POST</glossterm>
3396 <info> 3459 <info>
3397 EXTRA_QMAKEVARS_POST[doc] = "Configuration variables or options you want to pass to qmake when the arguments need to be after the .pro file list on the command line." 3460 EXTRA_QMAKEVARS_POST[doc] = "Configuration variables or options you want to pass to qmake when the arguments need to be after the .pro file list on the command line."
3398 </info> 3461 </info>
3399 <glossdef> 3462 <glossdef>
3400 <para> 3463 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3401 Configuration variables or options you want to pass to 3464 Configuration variables or options you want to pass to
3402 <filename>qmake</filename>. 3465 <filename>qmake</filename>.
3403 Use this variable when the arguments need to be after the 3466 Use this variable when the arguments need to be after the
@@ -3413,12 +3476,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3413 </glossdef> 3476 </glossdef>
3414 </glossentry> 3477 </glossentry>
3415 3478
3416 <glossentry id='var-EXTRA_QMAKEVARS_PRE'><glossterm>EXTRA_QMAKEVARS_PRE<imagedata fileref="figures/define-generic.png" /></glossterm> 3479 <glossentry id='var-EXTRA_QMAKEVARS_PRE'><glossterm>EXTRA_QMAKEVARS_PRE</glossterm>
3417 <info> 3480 <info>
3418 EXTRA_QMAKEVARS_PRE[doc] = "Configuration variables or options you want to pass to qmake when the arguments need to be before the .pro file list on the command line." 3481 EXTRA_QMAKEVARS_PRE[doc] = "Configuration variables or options you want to pass to qmake when the arguments need to be before the .pro file list on the command line."
3419 </info> 3482 </info>
3420 <glossdef> 3483 <glossdef>
3421 <para> 3484 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3422 Configuration variables or options you want to pass to 3485 Configuration variables or options you want to pass to
3423 <filename>qmake</filename>. 3486 <filename>qmake</filename>.
3424 Use this variable when the arguments need to be before the 3487 Use this variable when the arguments need to be before the
@@ -3434,12 +3497,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3434 </glossdef> 3497 </glossdef>
3435 </glossentry> 3498 </glossentry>
3436 3499
3437 <glossentry id='var-EXTRA_USERS_PARAMS'><glossterm>EXTRA_USERS_PARAMS<imagedata fileref="figures/define-generic.png" /></glossterm> 3500 <glossentry id='var-EXTRA_USERS_PARAMS'><glossterm>EXTRA_USERS_PARAMS</glossterm>
3438 <info> 3501 <info>
3439 EXTRA_USERS_PARAMS[doc] = "When a recipe inherits the extrausers class, this variable provides image level user and group operations." 3502 EXTRA_USERS_PARAMS[doc] = "When a recipe inherits the extrausers class, this variable provides image level user and group operations."
3440 </info> 3503 </info>
3441 <glossdef> 3504 <glossdef>
3442 <para> 3505 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3443 When inheriting the 3506 When inheriting the
3444 <link linkend='ref-classes-extrausers'><filename>extrausers</filename></link> 3507 <link linkend='ref-classes-extrausers'><filename>extrausers</filename></link>
3445 class, this variable provides image level user and group 3508 class, this variable provides image level user and group
@@ -3475,12 +3538,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3475 3538
3476 <glossdiv id='var-glossary-f'><title>F</title> 3539 <glossdiv id='var-glossary-f'><title>F</title>
3477 3540
3478 <glossentry id='var-FEATURE_PACKAGES'><glossterm>FEATURE_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 3541 <glossentry id='var-FEATURE_PACKAGES'><glossterm>FEATURE_PACKAGES</glossterm>
3479 <info> 3542 <info>
3480 FEATURE_PACKAGES[doc] = "Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES. When setting the value, FEATURE_PACKAGES should have the name of the feature item as an override." 3543 FEATURE_PACKAGES[doc] = "Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES. When setting the value, FEATURE_PACKAGES should have the name of the feature item as an override."
3481 </info> 3544 </info>
3482 <glossdef> 3545 <glossdef>
3483 <para> 3546 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3484 Defines one or more packages to include in an image when 3547 Defines one or more packages to include in an image when
3485 a specific item is included in 3548 a specific item is included in
3486 <link linkend='var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></link>. 3549 <link linkend='var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></link>.
@@ -3490,6 +3553,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3490 <literallayout class='monospaced'> 3553 <literallayout class='monospaced'>
3491 FEATURE_PACKAGES_widget = "<replaceable>package1</replaceable> <replaceable>package2</replaceable>" 3554 FEATURE_PACKAGES_widget = "<replaceable>package1</replaceable> <replaceable>package2</replaceable>"
3492 </literallayout> 3555 </literallayout>
3556 </para>
3557
3558 <para>
3493 In this example, if "widget" were added to 3559 In this example, if "widget" were added to
3494 <filename>IMAGE_FEATURES</filename>, <replaceable>package1</replaceable> and 3560 <filename>IMAGE_FEATURES</filename>, <replaceable>package1</replaceable> and
3495 <replaceable>package2</replaceable> would be included in the image. 3561 <replaceable>package2</replaceable> would be included in the image.
@@ -3506,12 +3572,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3506 </glossdef> 3572 </glossdef>
3507 </glossentry> 3573 </glossentry>
3508 3574
3509 <glossentry id='var-FEED_DEPLOYDIR_BASE_URI'><glossterm>FEED_DEPLOYDIR_BASE_URI<imagedata fileref="figures/define-generic.png" /></glossterm> 3575 <glossentry id='var-FEED_DEPLOYDIR_BASE_URI'><glossterm>FEED_DEPLOYDIR_BASE_URI</glossterm>
3510 <info> 3576 <info>
3511 FEED_DEPLOYDIR_BASE_URI[doc] = "Allow to serve ipk deploy directory as an ad hoc feed (bogofeed). Set to base URL of the directory as exported by HTTP. Set of ad hoc feed configs will be generated in the image." 3577 FEED_DEPLOYDIR_BASE_URI[doc] = "Allow to serve ipk deploy directory as an ad hoc feed (bogofeed). Set to base URL of the directory as exported by HTTP. Set of ad hoc feed configs will be generated in the image."
3512 </info> 3578 </info>
3513 <glossdef> 3579 <glossdef>
3514 <para> 3580 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3515 Points to the base URL of the server and location within 3581 Points to the base URL of the server and location within
3516 the document-root that provides the metadata and 3582 the document-root that provides the metadata and
3517 packages required by OPKG to support runtime package 3583 packages required by OPKG to support runtime package
@@ -3536,12 +3602,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3536 </glossdef> 3602 </glossdef>
3537 </glossentry> 3603 </glossentry>
3538 3604
3539 <glossentry id='var-FILES'><glossterm>FILES<imagedata fileref="figures/define-generic.png" /></glossterm> 3605 <glossentry id='var-FILES'><glossterm>FILES</glossterm>
3540 <info> 3606 <info>
3541 FILES[doc] = "The list of directories or files that are placed in packages." 3607 FILES[doc] = "The list of directories or files that are placed in packages."
3542 </info> 3608 </info>
3543 <glossdef> 3609 <glossdef>
3544 <para> 3610 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3545 The list of directories or files that are placed in packages. 3611 The list of directories or files that are placed in packages.
3546 </para> 3612 </para>
3547 3613
@@ -3586,12 +3652,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3586 </glossdef> 3652 </glossdef>
3587 </glossentry> 3653 </glossentry>
3588 3654
3589 <glossentry id='var-FILESEXTRAPATHS'><glossterm>FILESEXTRAPATHS<imagedata fileref="figures/define-generic.png" /></glossterm> 3655 <glossentry id='var-FILESEXTRAPATHS'><glossterm>FILESEXTRAPATHS</glossterm>
3590 <info> 3656 <info>
3591 FILESEXTRAPATHS[doc] = "Extends the search path the OpenEmbedded build system uses when looking for files and patches as it processes recipes and append files." 3657 FILESEXTRAPATHS[doc] = "Extends the search path the OpenEmbedded build system uses when looking for files and patches as it processes recipes and append files."
3592 </info> 3658 </info>
3593 <glossdef> 3659 <glossdef>
3594 <para> 3660 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3595 Extends the search path the OpenEmbedded build system uses 3661 Extends the search path the OpenEmbedded build system uses
3596 when looking for files and patches as it processes recipes 3662 when looking for files and patches as it processes recipes
3597 and append files. 3663 and append files.
@@ -3656,12 +3722,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3656 </glossdef> 3722 </glossdef>
3657 </glossentry> 3723 </glossentry>
3658 3724
3659 <glossentry id='var-FILESOVERRIDES'><glossterm>FILESOVERRIDES<imagedata fileref="figures/define-generic.png" /></glossterm> 3725 <glossentry id='var-FILESOVERRIDES'><glossterm>FILESOVERRIDES</glossterm>
3660 <info> 3726 <info>
3661 FILESOVERRIDES[doc] = "A subset of OVERRIDES used by the OpenEmbedded build system for creating FILESPATH." 3727 FILESOVERRIDES[doc] = "A subset of OVERRIDES used by the OpenEmbedded build system for creating FILESPATH."
3662 </info> 3728 </info>
3663 <glossdef> 3729 <glossdef>
3664 <para> 3730 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3665 A subset of <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link> 3731 A subset of <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link>
3666 used by the OpenEmbedded build system for creating 3732 used by the OpenEmbedded build system for creating
3667 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>. 3733 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>.
@@ -3687,12 +3753,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3687 </glossdef> 3753 </glossdef>
3688 </glossentry> 3754 </glossentry>
3689 3755
3690 <glossentry id='var-FILESPATH'><glossterm>FILESPATH<imagedata fileref="figures/define-generic.png" /></glossterm> 3756 <glossentry id='var-FILESPATH'><glossterm>FILESPATH</glossterm>
3691 <info> 3757 <info>
3692 FILESPATH[doc] = "The default set of directories the OpenEmbedded build system uses when searching for patches and files. It is defined in the base.bbclass class found in meta/classes in the Source Directory. Do not hand-edit the FILESPATH variable." 3758 FILESPATH[doc] = "The default set of directories the OpenEmbedded build system uses when searching for patches and files. It is defined in the base.bbclass class found in meta/classes in the Source Directory. Do not hand-edit the FILESPATH variable."
3693 </info> 3759 </info>
3694 <glossdef> 3760 <glossdef>
3695 <para> 3761 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3696 The default set of directories the OpenEmbedded build system 3762 The default set of directories the OpenEmbedded build system
3697 uses when searching for patches and files. 3763 uses when searching for patches and files.
3698 During the build process, BitBake searches each directory in 3764 During the build process, BitBake searches each directory in
@@ -3733,18 +3799,20 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3733 </glossdef> 3799 </glossdef>
3734 </glossentry> 3800 </glossentry>
3735 3801
3736 <glossentry id='var-FILESYSTEM_PERMS_TABLES'><glossterm>FILESYSTEM_PERMS_TABLES<imagedata fileref="figures/define-generic.png" /></glossterm> 3802 <glossentry id='var-FILESYSTEM_PERMS_TABLES'><glossterm>FILESYSTEM_PERMS_TABLES</glossterm>
3737 <info> 3803 <info>
3738 FILESYSTEM_PERMS_TABLES[doc] = "Allows you to define your own file permissions settings table as part of your configuration for the packaging process." 3804 FILESYSTEM_PERMS_TABLES[doc] = "Allows you to define your own file permissions settings table as part of your configuration for the packaging process."
3739 </info> 3805 </info>
3740 <glossdef> 3806 <glossdef>
3741 <para>Allows you to define your own file permissions settings table as part of 3807 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3808 Allows you to define your own file permissions settings table as part of
3742 your configuration for the packaging process. 3809 your configuration for the packaging process.
3743 For example, suppose you need a consistent set of custom permissions for 3810 For example, suppose you need a consistent set of custom permissions for
3744 a set of groups and users across an entire work project. 3811 a set of groups and users across an entire work project.
3745 It is best to do this in the packages themselves but this is not always 3812 It is best to do this in the packages themselves but this is not always
3746 possible. 3813 possible.
3747 </para> 3814 </para>
3815
3748 <para> 3816 <para>
3749 By default, the OpenEmbedded build system uses the <filename>fs-perms.txt</filename>, which 3817 By default, the OpenEmbedded build system uses the <filename>fs-perms.txt</filename>, which
3750 is located in the <filename>meta/files</filename> folder in the 3818 is located in the <filename>meta/files</filename> folder in the
@@ -3752,6 +3820,7 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3752 If you create your own file permissions setting table, you should place it in your 3820 If you create your own file permissions setting table, you should place it in your
3753 layer or the distro's layer. 3821 layer or the distro's layer.
3754 </para> 3822 </para>
3823
3755 <para> 3824 <para>
3756 You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the 3825 You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the
3757 <filename>conf/local.conf</filename> file, which is found in the 3826 <filename>conf/local.conf</filename> file, which is found in the
@@ -3761,6 +3830,7 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3761 The paths you specify to these files must be defined within the 3830 The paths you specify to these files must be defined within the
3762 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> variable. 3831 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> variable.
3763 </para> 3832 </para>
3833
3764 <para> 3834 <para>
3765 For guidance on how to create your own file permissions settings table file, 3835 For guidance on how to create your own file permissions settings table file,
3766 examine the existing <filename>fs-perms.txt</filename>. 3836 examine the existing <filename>fs-perms.txt</filename>.
@@ -3768,12 +3838,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3768 </glossdef> 3838 </glossdef>
3769 </glossentry> 3839 </glossentry>
3770 3840
3771 <glossentry id='var-FONT_EXTRA_RDEPENDS'><glossterm>FONT_EXTRA_RDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 3841 <glossentry id='var-FONT_EXTRA_RDEPENDS'><glossterm>FONT_EXTRA_RDEPENDS</glossterm>
3772 <info> 3842 <info>
3773 FONT_EXTRA_RDEPENDS[doc] = "When a recipe inherits the fontcache class, this variable specifies runtime dependencies for font packages. This variable defaults to 'fontconfig-utils'." 3843 FONT_EXTRA_RDEPENDS[doc] = "When a recipe inherits the fontcache class, this variable specifies runtime dependencies for font packages. This variable defaults to 'fontconfig-utils'."
3774 </info> 3844 </info>
3775 <glossdef> 3845 <glossdef>
3776 <para> 3846 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3777 When inheriting the 3847 When inheriting the
3778 <link linkend='ref-classes-fontcache'><filename>fontcache</filename></link> 3848 <link linkend='ref-classes-fontcache'><filename>fontcache</filename></link>
3779 class, this variable specifies the runtime dependencies 3849 class, this variable specifies the runtime dependencies
@@ -3784,12 +3854,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3784 </glossdef> 3854 </glossdef>
3785 </glossentry> 3855 </glossentry>
3786 3856
3787 <glossentry id='var-FONT_PACKAGES'><glossterm>FONT_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 3857 <glossentry id='var-FONT_PACKAGES'><glossterm>FONT_PACKAGES</glossterm>
3788 <info> 3858 <info>
3789 FONT_PACKAGES[doc] = "When a recipe inherits the fontcache class, this variable identifies packages containing font files that need to be cached by Fontconfig." 3859 FONT_PACKAGES[doc] = "When a recipe inherits the fontcache class, this variable identifies packages containing font files that need to be cached by Fontconfig."
3790 </info> 3860 </info>
3791 <glossdef> 3861 <glossdef>
3792 <para> 3862 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3793 When inheriting the 3863 When inheriting the
3794 <link linkend='ref-classes-fontcache'><filename>fontcache</filename></link> 3864 <link linkend='ref-classes-fontcache'><filename>fontcache</filename></link>
3795 class, this variable identifies packages containing font 3865 class, this variable identifies packages containing font
@@ -3803,12 +3873,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3803 </glossdef> 3873 </glossdef>
3804 </glossentry> 3874 </glossentry>
3805 3875
3806 <glossentry id='var-FULL_OPTIMIZATION'><glossterm>FULL_OPTIMIZATION<imagedata fileref="figures/define-generic.png" /></glossterm> 3876 <glossentry id='var-FULL_OPTIMIZATION'><glossterm>FULL_OPTIMIZATION</glossterm>
3807 <info> 3877 <info>
3808 FULL_OPTIMIZATION[doc]= "The options to pass in TARGET_CFLAGS and CFLAGS when compiling an optimized system. This variable defaults to '-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2'." 3878 FULL_OPTIMIZATION[doc]= "The options to pass in TARGET_CFLAGS and CFLAGS when compiling an optimized system. This variable defaults to '-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2'."
3809 </info> 3879 </info>
3810 <glossdef> 3880 <glossdef>
3811 <para> 3881 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3812 The options to pass in 3882 The options to pass in
3813 <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename> 3883 <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename>
3814 and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename> 3884 and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename>
@@ -3822,35 +3892,35 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3822 3892
3823 <glossdiv id='var-glossary-g'><title>G</title> 3893 <glossdiv id='var-glossary-g'><title>G</title>
3824 3894
3825 <glossentry id='var-GDB'><glossterm>GDB<imagedata fileref="figures/define-generic.png" /></glossterm> 3895 <glossentry id='var-GDB'><glossterm>GDB</glossterm>
3826 <info> 3896 <info>
3827 GDB[doc] = "The minimal command and arguments to run the GNU Debugger." 3897 GDB[doc] = "The minimal command and arguments to run the GNU Debugger."
3828 </info> 3898 </info>
3829 <glossdef> 3899 <glossdef>
3830 <para> 3900 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3831 The minimal command and arguments to run the GNU Debugger. 3901 The minimal command and arguments to run the GNU Debugger.
3832 </para> 3902 </para>
3833 </glossdef> 3903 </glossdef>
3834 </glossentry> 3904 </glossentry>
3835 3905
3836 <glossentry id='var-GITDIR'><glossterm>GITDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 3906 <glossentry id='var-GITDIR'><glossterm>GITDIR</glossterm>
3837 <info> 3907 <info>
3838 GITDIR[doc] = "The directory where Git clones will be stored." 3908 GITDIR[doc] = "The directory where Git clones will be stored."
3839 </info> 3909 </info>
3840 <glossdef> 3910 <glossdef>
3841 <para> 3911 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3842 The directory in which a local copy of a Git repository 3912 The directory in which a local copy of a Git repository
3843 is stored when it is cloned. 3913 is stored when it is cloned.
3844 </para> 3914 </para>
3845 </glossdef> 3915 </glossdef>
3846 </glossentry> 3916 </glossentry>
3847 3917
3848 <glossentry id='var-GLIBC_GENERATE_LOCALES'><glossterm>GLIBC_GENERATE_LOCALES<imagedata fileref="figures/define-generic.png" /></glossterm> 3918 <glossentry id='var-GLIBC_GENERATE_LOCALES'><glossterm>GLIBC_GENERATE_LOCALES</glossterm>
3849 <info> 3919 <info>
3850 GLIBC_GENERATE_LOCALES[doc]= "Specifies the list of GLIBC locales to generate should you not wish generate all LIBC locals, which can be time consuming." 3920 GLIBC_GENERATE_LOCALES[doc]= "Specifies the list of GLIBC locales to generate should you not wish generate all LIBC locals, which can be time consuming."
3851 </info> 3921 </info>
3852 <glossdef> 3922 <glossdef>
3853 <para> 3923 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3854 Specifies the list of GLIBC locales to generate should you 3924 Specifies the list of GLIBC locales to generate should you
3855 not wish generate all LIBC locals, which can be time 3925 not wish generate all LIBC locals, which can be time
3856 consuming. 3926 consuming.
@@ -3860,6 +3930,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3860 <link linkend='var-IMAGE_LINGUAS'><filename>IMAGE_LINGUAS</filename></link> 3930 <link linkend='var-IMAGE_LINGUAS'><filename>IMAGE_LINGUAS</filename></link>
3861 appropriately. 3931 appropriately.
3862 </note> 3932 </note>
3933 </para>
3934
3935 <para>
3863 You can set <filename>GLIBC_GENERATE_LOCALES</filename> 3936 You can set <filename>GLIBC_GENERATE_LOCALES</filename>
3864 in your <filename>local.conf</filename> file. 3937 in your <filename>local.conf</filename> file.
3865 By default, all locales are generated. 3938 By default, all locales are generated.
@@ -3870,12 +3943,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3870 </glossdef> 3943 </glossdef>
3871 </glossentry> 3944 </glossentry>
3872 3945
3873 <glossentry id='var-GROUPADD_PARAM'><glossterm>GROUPADD_PARAM<imagedata fileref="figures/define-generic.png" /></glossterm> 3946 <glossentry id='var-GROUPADD_PARAM'><glossterm>GROUPADD_PARAM</glossterm>
3874 <info> 3947 <info>
3875 GROUPADD_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the groupadd command if you wish to add a group to the system when the package is installed." 3948 GROUPADD_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the groupadd command if you wish to add a group to the system when the package is installed."
3876 </info> 3949 </info>
3877 <glossdef> 3950 <glossdef>
3878 <para> 3951 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3879 When inheriting the 3952 When inheriting the
3880 <link linkend='ref-classes-useradd'><filename>useradd</filename></link> 3953 <link linkend='ref-classes-useradd'><filename>useradd</filename></link>
3881 class, this variable 3954 class, this variable
@@ -3898,12 +3971,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3898 </glossdef> 3971 </glossdef>
3899 </glossentry> 3972 </glossentry>
3900 3973
3901 <glossentry id='var-GROUPMEMS_PARAM'><glossterm>GROUPMEMS_PARAM<imagedata fileref="figures/define-generic.png" /></glossterm> 3974 <glossentry id='var-GROUPMEMS_PARAM'><glossterm>GROUPMEMS_PARAM</glossterm>
3902 <info> 3975 <info>
3903 GROUPMEMS_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the groupmems command if you wish to modify the members of a group when the package is installed." 3976 GROUPMEMS_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the groupmems command if you wish to modify the members of a group when the package is installed."
3904 </info> 3977 </info>
3905 <glossdef> 3978 <glossdef>
3906 <para> 3979 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3907 When inheriting the 3980 When inheriting the
3908 <link linkend='ref-classes-useradd'><filename>useradd</filename></link> 3981 <link linkend='ref-classes-useradd'><filename>useradd</filename></link>
3909 class, this variable 3982 class, this variable
@@ -3921,12 +3994,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3921 </glossdef> 3994 </glossdef>
3922 </glossentry> 3995 </glossentry>
3923 3996
3924 <glossentry id='var-GRUB_GFXSERIAL'><glossterm>GRUB_GFXSERIAL<imagedata fileref="figures/define-generic.png" /></glossterm> 3997 <glossentry id='var-GRUB_GFXSERIAL'><glossterm>GRUB_GFXSERIAL</glossterm>
3925 <info> 3998 <info>
3926 GRUB_GFXSERIAL[doc] = "Configures the GNU GRand Unified Bootloader (GRUB) to have graphics and serial in the boot menu." 3999 GRUB_GFXSERIAL[doc] = "Configures the GNU GRand Unified Bootloader (GRUB) to have graphics and serial in the boot menu."
3927 </info> 4000 </info>
3928 <glossdef> 4001 <glossdef>
3929 <para> 4002 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3930 Configures the GNU GRand Unified Bootloader (GRUB) to have 4003 Configures the GNU GRand Unified Bootloader (GRUB) to have
3931 graphics and serial in the boot menu. 4004 graphics and serial in the boot menu.
3932 Set this variable to "1" in your 4005 Set this variable to "1" in your
@@ -3943,12 +4016,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3943 </glossdef> 4016 </glossdef>
3944 </glossentry> 4017 </glossentry>
3945 4018
3946 <glossentry id='var-GRUB_OPTS'><glossterm>GRUB_OPTS<imagedata fileref="figures/define-generic.png" /></glossterm> 4019 <glossentry id='var-GRUB_OPTS'><glossterm>GRUB_OPTS</glossterm>
3947 <info> 4020 <info>
3948 GRUB_OPTS[doc] = "Additional options to add to the GNU GRand Unified Bootloader (GRUB) configuration." 4021 GRUB_OPTS[doc] = "Additional options to add to the GNU GRand Unified Bootloader (GRUB) configuration."
3949 </info> 4022 </info>
3950 <glossdef> 4023 <glossdef>
3951 <para> 4024 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3952 Additional options to add to the GNU GRand Unified 4025 Additional options to add to the GNU GRand Unified
3953 Bootloader (GRUB) configuration. 4026 Bootloader (GRUB) configuration.
3954 Use a semi-colon character (<filename>;</filename>) to 4027 Use a semi-colon character (<filename>;</filename>) to
@@ -3964,12 +4037,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3964 </glossdef> 4037 </glossdef>
3965 </glossentry> 4038 </glossentry>
3966 4039
3967 <glossentry id='var-GRUB_TIMEOUT'><glossterm>GRUB_TIMEOUT<imagedata fileref="figures/define-generic.png" /></glossterm> 4040 <glossentry id='var-GRUB_TIMEOUT'><glossterm>GRUB_TIMEOUT</glossterm>
3968 <info> 4041 <info>
3969 GRUB_TIMEOUT[doc] = "Specifies the timeout before executing the default LABEL in the GNU GRand Unified Bootloader (GRUB)." 4042 GRUB_TIMEOUT[doc] = "Specifies the timeout before executing the default LABEL in the GNU GRand Unified Bootloader (GRUB)."
3970 </info> 4043 </info>
3971 <glossdef> 4044 <glossdef>
3972 <para> 4045 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3973 Specifies the timeout before executing the default 4046 Specifies the timeout before executing the default
3974 <filename>LABEL</filename> in the GNU GRand Unified 4047 <filename>LABEL</filename> in the GNU GRand Unified
3975 Bootloader (GRUB). 4048 Bootloader (GRUB).
@@ -3984,12 +4057,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3984 </glossdef> 4057 </glossdef>
3985 </glossentry> 4058 </glossentry>
3986 4059
3987 <glossentry id='var-GTKIMMODULES_PACKAGES'><glossterm>GTKIMMODULES_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 4060 <glossentry id='var-GTKIMMODULES_PACKAGES'><glossterm>GTKIMMODULES_PACKAGES</glossterm>
3988 <info> 4061 <info>
3989 GTKIMMODULES_PACKAGES[doc] = "For recipes that inherit the gtk-immodules-cache class, this variable specifies the packages that contain the GTK+ input method modules being installed when the modules are in packages other than the main package." 4062 GTKIMMODULES_PACKAGES[doc] = "For recipes that inherit the gtk-immodules-cache class, this variable specifies the packages that contain the GTK+ input method modules being installed when the modules are in packages other than the main package."
3990 </info> 4063 </info>
3991 <glossdef> 4064 <glossdef>
3992 <para> 4065 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
3993 When inheriting the 4066 When inheriting the
3994 <link linkend='ref-classes-gtk-immodules-cache'><filename>gtk-immodules-cache</filename></link> 4067 <link linkend='ref-classes-gtk-immodules-cache'><filename>gtk-immodules-cache</filename></link>
3995 class, this variable specifies the packages that contain the 4068 class, this variable specifies the packages that contain the
@@ -3999,12 +4072,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
3999 </glossdef> 4072 </glossdef>
4000 </glossentry> 4073 </glossentry>
4001 4074
4002 <glossentry id='var-GUMMIBOOT_CFG'><glossterm>GUMMIBOOT_CFG<imagedata fileref="figures/define-generic.png" /></glossterm> 4075 <glossentry id='var-GUMMIBOOT_CFG'><glossterm>GUMMIBOOT_CFG</glossterm>
4003 <info> 4076 <info>
4004 GUMMIBOOT_CFG[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_CFG variable specifies the configuration file that should be used." 4077 GUMMIBOOT_CFG[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_CFG variable specifies the configuration file that should be used."
4005 </info> 4078 </info>
4006 <glossdef> 4079 <glossdef>
4007 <para> 4080 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4008 When 4081 When
4009 <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link> 4082 <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link>
4010 is set to "gummiboot", the 4083 is set to "gummiboot", the
@@ -4026,12 +4099,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4026 </glossdef> 4099 </glossdef>
4027 </glossentry> 4100 </glossentry>
4028 4101
4029 <glossentry id='var-GUMMIBOOT_ENTRIES'><glossterm>GUMMIBOOT_ENTRIES<imagedata fileref="figures/define-generic.png" /></glossterm> 4102 <glossentry id='var-GUMMIBOOT_ENTRIES'><glossterm>GUMMIBOOT_ENTRIES</glossterm>
4030 <info> 4103 <info>
4031 GUMMIBOOT_ENTRIES[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_ENTRIES variable specifies a list of entry files (*.conf) to be installed containing one boot entry per file." 4104 GUMMIBOOT_ENTRIES[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_ENTRIES variable specifies a list of entry files (*.conf) to be installed containing one boot entry per file."
4032 </info> 4105 </info>
4033 <glossdef> 4106 <glossdef>
4034 <para> 4107 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4035 When 4108 When
4036 <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link> 4109 <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link>
4037 is set to "gummiboot", the 4110 is set to "gummiboot", the
@@ -4055,12 +4128,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4055 </glossdef> 4128 </glossdef>
4056 </glossentry> 4129 </glossentry>
4057 4130
4058 <glossentry id='var-GUMMIBOOT_TIMEOUT'><glossterm>GUMMIBOOT_TIMEOUT<imagedata fileref="figures/define-generic.png" /></glossterm> 4131 <glossentry id='var-GUMMIBOOT_TIMEOUT'><glossterm>GUMMIBOOT_TIMEOUT</glossterm>
4059 <info> 4132 <info>
4060 GUMMIBOOT_TIMEOUT[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_TIMEOUT variable specifies the boot menu timeout in seconds." 4133 GUMMIBOOT_TIMEOUT[doc] = "When EFI_PROVIDER is set to "gummiboot", the GUMMIBOOT_TIMEOUT variable specifies the boot menu timeout in seconds."
4061 </info> 4134 </info>
4062 <glossdef> 4135 <glossdef>
4063 <para> 4136 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4064 When 4137 When
4065 <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link> 4138 <link linkend='var-EFI_PROVIDER'><filename>EFI_PROVIDER</filename></link>
4066 is set to "gummiboot", the 4139 is set to "gummiboot", the
@@ -4086,23 +4159,25 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4086 4159
4087 <glossdiv id='var-glossary-h'><title>H</title> 4160 <glossdiv id='var-glossary-h'><title>H</title>
4088 4161
4089 <glossentry id='var-HOMEPAGE'><glossterm>HOMEPAGE<imagedata fileref="figures/define-generic.png" /></glossterm> 4162 <glossentry id='var-HOMEPAGE'><glossterm>HOMEPAGE</glossterm>
4090 <info> 4163 <info>
4091 HOMEPAGE[doc] = "Website where more information about the software the recipe is building can be found." 4164 HOMEPAGE[doc] = "Website where more information about the software the recipe is building can be found."
4092 </info> 4165 </info>
4093 <glossdef> 4166 <glossdef>
4094 <para>Website where more information about the software the recipe is building 4167 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4095 can be found.</para> 4168 Website where more information about the software the recipe is building
4169 can be found.
4170 </para>
4096 </glossdef> 4171 </glossdef>
4097 </glossentry> 4172 </glossentry>
4098 4173
4099 <glossentry id='var-HOST_ARCH'><glossterm>HOST_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 4174 <glossentry id='var-HOST_ARCH'><glossterm>HOST_ARCH</glossterm>
4100 <info> 4175 <info>
4101 HOST_ARCH[doc] = "The name of the target architecture. Normally same as the TARGET_ARCH." 4176 HOST_ARCH[doc] = "The name of the target architecture. Normally same as the TARGET_ARCH."
4102 4177
4103 </info> 4178 </info>
4104 <glossdef> 4179 <glossdef>
4105 <para> 4180 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4106 The name of the target architecture, which is normally 4181 The name of the target architecture, which is normally
4107 the same as 4182 the same as
4108 <link linkend='var-TARGET_ARCH'><filename>TARGET_ARCH</filename></link>. 4183 <link linkend='var-TARGET_ARCH'><filename>TARGET_ARCH</filename></link>.
@@ -4124,12 +4199,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4124 </glossdef> 4199 </glossdef>
4125 </glossentry> 4200 </glossentry>
4126 4201
4127 <glossentry id='var-HOST_CC_ARCH'><glossterm>HOST_CC_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 4202 <glossentry id='var-HOST_CC_ARCH'><glossterm>HOST_CC_ARCH</glossterm>
4128 <info> 4203 <info>
4129 HOST_CC_ARCH[doc] = "The name of the host architecture. Normally same as the TARGET_CC_ARCH." 4204 HOST_CC_ARCH[doc] = "The name of the host architecture. Normally same as the TARGET_CC_ARCH."
4130 </info> 4205 </info>
4131 <glossdef> 4206 <glossdef>
4132 <para> 4207 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4133 Specifies architecture-specific compiler flags that are 4208 Specifies architecture-specific compiler flags that are
4134 passed to the C compiler. 4209 passed to the C compiler.
4135 </para> 4210 </para>
@@ -4157,12 +4232,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4157 </glossdef> 4232 </glossdef>
4158 </glossentry> 4233 </glossentry>
4159 4234
4160 <glossentry id='var-HOST_OS'><glossterm>HOST_OS<imagedata fileref="figures/define-generic.png" /></glossterm> 4235 <glossentry id='var-HOST_OS'><glossterm>HOST_OS</glossterm>
4161 <info> 4236 <info>
4162 HOST_OS[doc] = "The name of the target operating system. Normally the same as the TARGET_OS." 4237 HOST_OS[doc] = "The name of the target operating system. Normally the same as the TARGET_OS."
4163 </info> 4238 </info>
4164 <glossdef> 4239 <glossdef>
4165 <para> 4240 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4166 Specifies the name of the target operating system, which 4241 Specifies the name of the target operating system, which
4167 is normally the same as the 4242 is normally the same as the
4168 <link linkend='var-TARGET_OS'><filename>TARGET_OS</filename></link>. 4243 <link linkend='var-TARGET_OS'><filename>TARGET_OS</filename></link>.
@@ -4174,12 +4249,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4174 </glossdef> 4249 </glossdef>
4175 </glossentry> 4250 </glossentry>
4176 4251
4177 <glossentry id='var-HOST_PREFIX'><glossterm>HOST_PREFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 4252 <glossentry id='var-HOST_PREFIX'><glossterm>HOST_PREFIX</glossterm>
4178 <info> 4253 <info>
4179 HOST_PREFIX[doc] = "The prefix for the cross compile toolchain. Normally same as the TARGET_PREFIX." 4254 HOST_PREFIX[doc] = "The prefix for the cross compile toolchain. Normally same as the TARGET_PREFIX."
4180 </info> 4255 </info>
4181 <glossdef> 4256 <glossdef>
4182 <para> 4257 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4183 Specifies the prefix for the cross-compile toolchain. 4258 Specifies the prefix for the cross-compile toolchain.
4184 <filename>HOST_PREFIX</filename> is normally the same as 4259 <filename>HOST_PREFIX</filename> is normally the same as
4185 <link linkend='var-TARGET_PREFIX'><filename>TARGET_PREFIX</filename></link>. 4260 <link linkend='var-TARGET_PREFIX'><filename>TARGET_PREFIX</filename></link>.
@@ -4187,12 +4262,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4187 </glossdef> 4262 </glossdef>
4188 </glossentry> 4263 </glossentry>
4189 4264
4190 <glossentry id='var-HOST_SYS'><glossterm>HOST_SYS<imagedata fileref="figures/define-generic.png" /></glossterm> 4265 <glossentry id='var-HOST_SYS'><glossterm>HOST_SYS</glossterm>
4191 <info> 4266 <info>
4192 HOST_SYS[doc] = "Specifies the system, including the architecture and the operating system, for with the build is occurring in the context of the current recipe." 4267 HOST_SYS[doc] = "Specifies the system, including the architecture and the operating system, for with the build is occurring in the context of the current recipe."
4193 </info> 4268 </info>
4194 <glossdef> 4269 <glossdef>
4195 <para> 4270 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4196 Specifies the system, including the architecture and the 4271 Specifies the system, including the architecture and the
4197 operating system, for which the build is occurring 4272 operating system, for which the build is occurring
4198 in the context of the current recipe. 4273 in the context of the current recipe.
@@ -4227,12 +4302,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4227 </glossdef> 4302 </glossdef>
4228 </glossentry> 4303 </glossentry>
4229 4304
4230 <glossentry id='var-HOST_VENDOR'><glossterm>HOST_VENDOR<imagedata fileref="figures/define-generic.png" /></glossterm> 4305 <glossentry id='var-HOST_VENDOR'><glossterm>HOST_VENDOR</glossterm>
4231 <info> 4306 <info>
4232 HOST_VENDOR[doc] = "The name of the vendor. Normally same as the TARGET_VENDOR." 4307 HOST_VENDOR[doc] = "The name of the vendor. Normally same as the TARGET_VENDOR."
4233 </info> 4308 </info>
4234 <glossdef> 4309 <glossdef>
4235 <para> 4310 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4236 Specifies the name of the vendor. 4311 Specifies the name of the vendor.
4237 <filename>HOST_VENDOR</filename> is normally the same as 4312 <filename>HOST_VENDOR</filename> is normally the same as
4238 <link linkend='var-TARGET_PREFIX'><filename>TARGET_VENDOR</filename></link>. 4313 <link linkend='var-TARGET_PREFIX'><filename>TARGET_VENDOR</filename></link>.
@@ -4244,12 +4319,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4244 4319
4245 <glossdiv id='var-glossary-i'><title>I</title> 4320 <glossdiv id='var-glossary-i'><title>I</title>
4246 4321
4247 <glossentry id='var-ICECC_DISABLED'><glossterm>ICECC_DISABLED<imagedata fileref="figures/define-generic.png" /></glossterm> 4322 <glossentry id='var-ICECC_DISABLED'><glossterm>ICECC_DISABLED</glossterm>
4248 <info> 4323 <info>
4249 ICECC_DISABLED[doc] = "Disables or enables the icecc (Icecream) function." 4324 ICECC_DISABLED[doc] = "Disables or enables the icecc (Icecream) function."
4250 </info> 4325 </info>
4251 <glossdef> 4326 <glossdef>
4252 <para> 4327 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4253 Disables or enables the <filename>icecc</filename> 4328 Disables or enables the <filename>icecc</filename>
4254 (Icecream) function. 4329 (Icecream) function.
4255 For more information on this function and best practices 4330 For more information on this function and best practices
@@ -4272,12 +4347,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4272 </glossdef> 4347 </glossdef>
4273 </glossentry> 4348 </glossentry>
4274 4349
4275 <glossentry id='var-ICECC_ENV_EXEC'><glossterm>ICECC_ENV_EXEC<imagedata fileref="figures/define-generic.png" /></glossterm> 4350 <glossentry id='var-ICECC_ENV_EXEC'><glossterm>ICECC_ENV_EXEC</glossterm>
4276 <info> 4351 <info>
4277 ICECC_ENV_EXEC[doc] = "Points to the icecc-create-env script that you provide." 4352 ICECC_ENV_EXEC[doc] = "Points to the icecc-create-env script that you provide."
4278 </info> 4353 </info>
4279 <glossdef> 4354 <glossdef>
4280 <para> 4355 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4281 Points to the <filename>icecc-create-env</filename> script 4356 Points to the <filename>icecc-create-env</filename> script
4282 that you provide. 4357 that you provide.
4283 This variable is used by the 4358 This variable is used by the
@@ -4297,12 +4372,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4297 </glossdef> 4372 </glossdef>
4298 </glossentry> 4373 </glossentry>
4299 4374
4300 <glossentry id='var-ICECC_PARALLEL_MAKE'><glossterm>ICECC_PARALLEL_MAKE<imagedata fileref="figures/define-generic.png" /></glossterm> 4375 <glossentry id='var-ICECC_PARALLEL_MAKE'><glossterm>ICECC_PARALLEL_MAKE</glossterm>
4301 <info> 4376 <info>
4302 ICECC_PARALLEL_MAKE[doc] = "Extra options passed to the make command during the do_compile task that specify parallel compilation." 4377 ICECC_PARALLEL_MAKE[doc] = "Extra options passed to the make command during the do_compile task that specify parallel compilation."
4303 </info> 4378 </info>
4304 <glossdef> 4379 <glossdef>
4305 <para> 4380 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4306 Extra options passed to the <filename>make</filename> 4381 Extra options passed to the <filename>make</filename>
4307 command during the 4382 command during the
4308 <link linkend='ref-tasks-compile'><filename>do_compile</filename></link> 4383 <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>
@@ -4341,12 +4416,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4341 </glossdef> 4416 </glossdef>
4342 </glossentry> 4417 </glossentry>
4343 4418
4344 <glossentry id='var-ICECC_PATH'><glossterm>ICECC_PATH<imagedata fileref="figures/define-generic.png" /></glossterm> 4419 <glossentry id='var-ICECC_PATH'><glossterm>ICECC_PATH</glossterm>
4345 <info> 4420 <info>
4346 ICECC_PATH[doc] = "The location of the icecc binary." 4421 ICECC_PATH[doc] = "The location of the icecc binary."
4347 </info> 4422 </info>
4348 <glossdef> 4423 <glossdef>
4349 <para> 4424 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4350 The location of the <filename>icecc</filename> binary. 4425 The location of the <filename>icecc</filename> binary.
4351 You can set this variable in your 4426 You can set this variable in your
4352 <filename>local.conf</filename> file. 4427 <filename>local.conf</filename> file.
@@ -4359,12 +4434,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4359 </glossdef> 4434 </glossdef>
4360 </glossentry> 4435 </glossentry>
4361 4436
4362 <glossentry id='var-ICECC_USER_CLASS_BL'><glossterm>ICECC_USER_CLASS_BL<imagedata fileref="figures/define-generic.png" /></glossterm> 4437 <glossentry id='var-ICECC_USER_CLASS_BL'><glossterm>ICECC_USER_CLASS_BL</glossterm>
4363 <info> 4438 <info>
4364 ICECC_USER_CLASS_BL[doc] = "Identifies user classes that you do not want the Icecream distributed compile support to consider." 4439 ICECC_USER_CLASS_BL[doc] = "Identifies user classes that you do not want the Icecream distributed compile support to consider."
4365 </info> 4440 </info>
4366 <glossdef> 4441 <glossdef>
4367 <para> 4442 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4368 Identifies user classes that you do not want the 4443 Identifies user classes that you do not want the
4369 Icecream distributed compile support to consider. 4444 Icecream distributed compile support to consider.
4370 This variable is used by the 4445 This variable is used by the
@@ -4384,12 +4459,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4384 </glossdef> 4459 </glossdef>
4385 </glossentry> 4460 </glossentry>
4386 4461
4387 <glossentry id='var-ICECC_USER_PACKAGE_BL'><glossterm>ICECC_USER_PACKAGE_BL<imagedata fileref="figures/define-generic.png" /></glossterm> 4462 <glossentry id='var-ICECC_USER_PACKAGE_BL'><glossterm>ICECC_USER_PACKAGE_BL</glossterm>
4388 <info> 4463 <info>
4389 ICECC_USER_PACKAGE_BL[doc] = "Identifies user recipes that you do not want the Icecream distributed compile support to consider." 4464 ICECC_USER_PACKAGE_BL[doc] = "Identifies user recipes that you do not want the Icecream distributed compile support to consider."
4390 </info> 4465 </info>
4391 <glossdef> 4466 <glossdef>
4392 <para> 4467 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4393 Identifies user recipes that you do not want the 4468 Identifies user recipes that you do not want the
4394 Icecream distributed compile support to consider. 4469 Icecream distributed compile support to consider.
4395 This variable is used by the 4470 This variable is used by the
@@ -4409,12 +4484,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4409 </glossdef> 4484 </glossdef>
4410 </glossentry> 4485 </glossentry>
4411 4486
4412 <glossentry id='var-ICECC_USER_PACKAGE_WL'><glossterm>ICECC_USER_PACKAGE_WL<imagedata fileref="figures/define-generic.png" /></glossterm> 4487 <glossentry id='var-ICECC_USER_PACKAGE_WL'><glossterm>ICECC_USER_PACKAGE_WL</glossterm>
4413 <info> 4488 <info>
4414 ICECC_USER_PACKAGE_WL[doc] = "Identifies user recipes that use an empty PARALLEL_MAKE variable that you want to force remote distributed compilation on using the Icecream distributed compile support." 4489 ICECC_USER_PACKAGE_WL[doc] = "Identifies user recipes that use an empty PARALLEL_MAKE variable that you want to force remote distributed compilation on using the Icecream distributed compile support."
4415 </info> 4490 </info>
4416 <glossdef> 4491 <glossdef>
4417 <para> 4492 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4418 Identifies user recipes that use an empty 4493 Identifies user recipes that use an empty
4419 <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link> 4494 <link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>
4420 variable that you want to force remote distributed 4495 variable that you want to force remote distributed
@@ -4429,12 +4504,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4429 </glossdef> 4504 </glossdef>
4430 </glossentry> 4505 </glossentry>
4431 4506
4432 <glossentry id='var-IMAGE_BASENAME'><glossterm>IMAGE_BASENAME<imagedata fileref="figures/define-generic.png" /></glossterm> 4507 <glossentry id='var-IMAGE_BASENAME'><glossterm>IMAGE_BASENAME</glossterm>
4433 <info> 4508 <info>
4434 IMAGE_BASENAME[doc] = "The base name of image output files." 4509 IMAGE_BASENAME[doc] = "The base name of image output files."
4435 </info> 4510 </info>
4436 <glossdef> 4511 <glossdef>
4437 <para> 4512 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4438 The base name of image output files. 4513 The base name of image output files.
4439 This variable defaults to the recipe name 4514 This variable defaults to the recipe name
4440 (<filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>). 4515 (<filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>).
@@ -4442,12 +4517,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4442 </glossdef> 4517 </glossdef>
4443 </glossentry> 4518 </glossentry>
4444 4519
4445 <glossentry id='var-IMAGE_BOOT_FILES'><glossterm>IMAGE_BOOT_FILES<imagedata fileref="figures/define-generic.png" /></glossterm> 4520 <glossentry id='var-IMAGE_BOOT_FILES'><glossterm>IMAGE_BOOT_FILES</glossterm>
4446 <info> 4521 <info>
4447 IMAGE_BOOT_FILES[doc] = "Whitespace separated list of files from ${DEPLOY_DIR_IMAGE} to place in boot partition. Entries will be installed under a same name as the source file. To change the destination file name, pass a desired name after a semicolon (eg. u-boot.img;uboot)." 4522 IMAGE_BOOT_FILES[doc] = "Whitespace separated list of files from ${DEPLOY_DIR_IMAGE} to place in boot partition. Entries will be installed under a same name as the source file. To change the destination file name, pass a desired name after a semicolon (eg. u-boot.img;uboot)."
4448 </info> 4523 </info>
4449 <glossdef> 4524 <glossdef>
4450 <para> 4525 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4451 A space-separated list of files installed into the 4526 A space-separated list of files installed into the
4452 boot partition when preparing an image using the 4527 boot partition when preparing an image using the
4453 <filename>wic</filename> tool with the 4528 <filename>wic</filename> tool with the
@@ -4465,6 +4540,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4465 IMAGE_BOOT_FILES = "u-boot.img uImage;kernel" 4540 IMAGE_BOOT_FILES = "u-boot.img uImage;kernel"
4466 IMAGE_BOOT_FILES = "u-boot.${UBOOT_SUFFIX} ${KERNEL_IMAGETYPE}" 4541 IMAGE_BOOT_FILES = "u-boot.${UBOOT_SUFFIX} ${KERNEL_IMAGETYPE}"
4467 </literallayout> 4542 </literallayout>
4543 </para>
4544
4545 <para>
4468 Alternatively, source files can be picked up using 4546 Alternatively, source files can be picked up using
4469 a glob pattern. 4547 a glob pattern.
4470 In this case, the destination file 4548 In this case, the destination file
@@ -4488,12 +4566,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4488 </glossdef> 4566 </glossdef>
4489 </glossentry> 4567 </glossentry>
4490 4568
4491 <glossentry id='var-IMAGE_CLASSES'><glossterm>IMAGE_CLASSES<imagedata fileref="figures/define-generic.png" /></glossterm> 4569 <glossentry id='var-IMAGE_CLASSES'><glossterm>IMAGE_CLASSES</glossterm>
4492 <info> 4570 <info>
4493 IMAGE_CLASSES[doc] = "A list of classes that all images should inherit." 4571 IMAGE_CLASSES[doc] = "A list of classes that all images should inherit."
4494 </info> 4572 </info>
4495 <glossdef> 4573 <glossdef>
4496 <para> 4574 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4497 A list of classes that all images should inherit. 4575 A list of classes that all images should inherit.
4498 You typically use this variable to specify the list of 4576 You typically use this variable to specify the list of
4499 classes that register the different types of images 4577 classes that register the different types of images
@@ -4516,12 +4594,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4516 </glossdef> 4594 </glossdef>
4517 </glossentry> 4595 </glossentry>
4518 4596
4519 <glossentry id='var-IMAGE_CMD'><glossterm>IMAGE_CMD<imagedata fileref="figures/define-generic.png" /></glossterm> 4597 <glossentry id='var-IMAGE_CMD'><glossterm>IMAGE_CMD</glossterm>
4520 <info> 4598 <info>
4521 IMAGE_CMD[doc] = "Specifies the command to create the image file for a specific image type, which corresponds to the value set set in IMAGE_FSTYPES, (e.g. ext3, btrfs, and so forth)." 4599 IMAGE_CMD[doc] = "Specifies the command to create the image file for a specific image type, which corresponds to the value set set in IMAGE_FSTYPES, (e.g. ext3, btrfs, and so forth)."
4522 </info> 4600 </info>
4523 <glossdef> 4601 <glossdef>
4524 <para> 4602 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4525 Specifies the command to create the image file for a 4603 Specifies the command to create the image file for a
4526 specific image type, which corresponds to the value set 4604 specific image type, which corresponds to the value set
4527 set in 4605 set in
@@ -4536,6 +4614,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4536 --faketime --output=${DEPLOY_DIR_IMAGE}/${IMAGE_NAME}.rootfs.jffs2 \ 4614 --faketime --output=${DEPLOY_DIR_IMAGE}/${IMAGE_NAME}.rootfs.jffs2 \
4537 ${EXTRA_IMAGECMD}" 4615 ${EXTRA_IMAGECMD}"
4538 </literallayout> 4616 </literallayout>
4617 </para>
4618
4619 <para>
4539 You typically do not need to set this variable unless 4620 You typically do not need to set this variable unless
4540 you are adding support for a new image type. 4621 you are adding support for a new image type.
4541 For more examples on how to set this variable, see the 4622 For more examples on how to set this variable, see the
@@ -4546,12 +4627,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4546 </glossdef> 4627 </glossdef>
4547 </glossentry> 4628 </glossentry>
4548 4629
4549 <glossentry id='var-IMAGE_DEVICE_TABLES'><glossterm>IMAGE_DEVICE_TABLES<imagedata fileref="figures/define-generic.png" /></glossterm> 4630 <glossentry id='var-IMAGE_DEVICE_TABLES'><glossterm>IMAGE_DEVICE_TABLES</glossterm>
4550 <info> 4631 <info>
4551 IMAGE_DEVICE_TABLES[doc] = "Specifies one or more files that contain custom device tables that are passed to the makedevs command as part of creating an image." 4632 IMAGE_DEVICE_TABLES[doc] = "Specifies one or more files that contain custom device tables that are passed to the makedevs command as part of creating an image."
4552 </info> 4633 </info>
4553 <glossdef> 4634 <glossdef>
4554 <para> 4635 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4555 Specifies one or more files that contain custom device 4636 Specifies one or more files that contain custom device
4556 tables that are passed to the 4637 tables that are passed to the
4557 <filename>makedevs</filename> command as part of creating 4638 <filename>makedevs</filename> command as part of creating
@@ -4569,12 +4650,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4569 </glossdef> 4650 </glossdef>
4570 </glossentry> 4651 </glossentry>
4571 4652
4572 <glossentry id='var-IMAGE_FEATURES'><glossterm>IMAGE_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 4653 <glossentry id='var-IMAGE_FEATURES'><glossterm>IMAGE_FEATURES</glossterm>
4573 <info> 4654 <info>
4574 IMAGE_FEATURES[doc] = "The primary list of features to include in an image. Configure this variable in an image recipe." 4655 IMAGE_FEATURES[doc] = "The primary list of features to include in an image. Configure this variable in an image recipe."
4575 </info> 4656 </info>
4576 <glossdef> 4657 <glossdef>
4577 <para> 4658 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4578 The primary list of features to include in an image. 4659 The primary list of features to include in an image.
4579 Typically, you configure this variable in an image recipe. 4660 Typically, you configure this variable in an image recipe.
4580 Although you can use this variable from your 4661 Although you can use this variable from your
@@ -4586,6 +4667,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4586 use the 4667 use the
4587 <filename><link linkend='var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</link></filename> variable. 4668 <filename><link linkend='var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</link></filename> variable.
4588 </note> 4669 </note>
4670 </para>
4671
4672 <para>
4589 For a list of image features that ships with the Yocto 4673 For a list of image features that ships with the Yocto
4590 Project, see the 4674 Project, see the
4591 "<link linkend="ref-features-image">Image Features</link>" 4675 "<link linkend="ref-features-image">Image Features</link>"
@@ -4601,12 +4685,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4601 </glossdef> 4685 </glossdef>
4602 </glossentry> 4686 </glossentry>
4603 4687
4604 <glossentry id='var-IMAGE_FSTYPES'><glossterm>IMAGE_FSTYPES<imagedata fileref="figures/define-generic.png" /></glossterm> 4688 <glossentry id='var-IMAGE_FSTYPES'><glossterm>IMAGE_FSTYPES</glossterm>
4605 <info> 4689 <info>
4606 IMAGE_FSTYPES[doc] = "Formats of root filesystem images that you want to have created." 4690 IMAGE_FSTYPES[doc] = "Formats of root filesystem images that you want to have created."
4607 </info> 4691 </info>
4608 <glossdef> 4692 <glossdef>
4609 <para> 4693 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4610 Specifies the formats the OpenEmbedded build system uses 4694 Specifies the formats the OpenEmbedded build system uses
4611 during the build when creating the root filesystem. 4695 during the build when creating the root filesystem.
4612 For example, setting <filename>IMAGE_FSTYPES</filename> 4696 For example, setting <filename>IMAGE_FSTYPES</filename>
@@ -4616,6 +4700,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4616 <literallayout class='monospaced'> 4700 <literallayout class='monospaced'>
4617 IMAGE_FSTYPES = "ext3 tar.bz2" 4701 IMAGE_FSTYPES = "ext3 tar.bz2"
4618 </literallayout> 4702 </literallayout>
4703 </para>
4704
4705 <para>
4619 For the complete list of supported image formats from which 4706 For the complete list of supported image formats from which
4620 you can choose, see 4707 you can choose, see
4621 <link linkend='var-IMAGE_TYPES'><filename>IMAGE_TYPES</filename></link>. 4708 <link linkend='var-IMAGE_TYPES'><filename>IMAGE_TYPES</filename></link>.
@@ -4639,12 +4726,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4639 </glossdef> 4726 </glossdef>
4640 </glossentry> 4727 </glossentry>
4641 4728
4642 <glossentry id='var-IMAGE_INSTALL'><glossterm>IMAGE_INSTALL<imagedata fileref="figures/define-generic.png" /></glossterm> 4729 <glossentry id='var-IMAGE_INSTALL'><glossterm>IMAGE_INSTALL</glossterm>
4643 <info> 4730 <info>
4644 IMAGE_INSTALL[doc] = "Specifies the packages to install into an image. Image recipes set IMAGE_INSTALL to specify the packages to install into an image through image.bbclass." 4731 IMAGE_INSTALL[doc] = "Specifies the packages to install into an image. Image recipes set IMAGE_INSTALL to specify the packages to install into an image through image.bbclass."
4645 </info> 4732 </info>
4646 <glossdef> 4733 <glossdef>
4647 <para> 4734 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4648 Specifies the packages to install into an image. 4735 Specifies the packages to install into an image.
4649 The <filename>IMAGE_INSTALL</filename> variable is a 4736 The <filename>IMAGE_INSTALL</filename> variable is a
4650 mechanism for an image recipe and you should use it 4737 mechanism for an image recipe and you should use it
@@ -4705,12 +4792,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4705 </glossdef> 4792 </glossdef>
4706 </glossentry> 4793 </glossentry>
4707 4794
4708 <glossentry id='var-IMAGE_LINGUAS'><glossterm>IMAGE_LINGUAS<imagedata fileref="figures/define-generic.png" /></glossterm> 4795 <glossentry id='var-IMAGE_LINGUAS'><glossterm>IMAGE_LINGUAS</glossterm>
4709 <info> 4796 <info>
4710 IMAGE_LINGUAS[doc] = "Specifies the list of locales to install into the image during the root filesystem construction process." 4797 IMAGE_LINGUAS[doc] = "Specifies the list of locales to install into the image during the root filesystem construction process."
4711 </info> 4798 </info>
4712 <glossdef> 4799 <glossdef>
4713 <para> 4800 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4714 Specifies the list of locales to install into the image 4801 Specifies the list of locales to install into the image
4715 during the root filesystem construction process. 4802 during the root filesystem construction process.
4716 The OpenEmbedded build system automatically splits locale 4803 The OpenEmbedded build system automatically splits locale
@@ -4724,6 +4811,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4724 <literallayout class='monospaced'> 4811 <literallayout class='monospaced'>
4725 IMAGE_LINGUAS = "pt-br de-de" 4812 IMAGE_LINGUAS = "pt-br de-de"
4726 </literallayout> 4813 </literallayout>
4814 </para>
4815
4816 <para>
4727 In this example, the build system ensures any Brazilian 4817 In this example, the build system ensures any Brazilian
4728 Portuguese and German locale files that correspond to 4818 Portuguese and German locale files that correspond to
4729 packages in the image are installed (i.e. 4819 packages in the image are installed (i.e.
@@ -4743,12 +4833,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4743 </glossdef> 4833 </glossdef>
4744 </glossentry> 4834 </glossentry>
4745 4835
4746 <glossentry id='var-IMAGE_MANIFEST'><glossterm>IMAGE_MANIFEST<imagedata fileref="figures/define-generic.png" /></glossterm> 4836 <glossentry id='var-IMAGE_MANIFEST'><glossterm>IMAGE_MANIFEST</glossterm>
4747 <info> 4837 <info>
4748 IMAGE_MANIFEST[doc] = "The manifest file for the image. This file lists all the installed packages that make up the image." 4838 IMAGE_MANIFEST[doc] = "The manifest file for the image. This file lists all the installed packages that make up the image."
4749 </info> 4839 </info>
4750 <glossdef> 4840 <glossdef>
4751 <para> 4841 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4752 The manifest file for the image. 4842 The manifest file for the image.
4753 This file lists all the installed packages that make up 4843 This file lists all the installed packages that make up
4754 the image. 4844 the image.
@@ -4779,12 +4869,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4779 </glossdef> 4869 </glossdef>
4780 </glossentry> 4870 </glossentry>
4781 4871
4782 <glossentry id='var-IMAGE_NAME'><glossterm>IMAGE_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 4872 <glossentry id='var-IMAGE_NAME'><glossterm>IMAGE_NAME</glossterm>
4783 <info> 4873 <info>
4784 IMAGE_NAME[doc] = "The name of the output image files minus the extension." 4874 IMAGE_NAME[doc] = "The name of the output image files minus the extension."
4785 </info> 4875 </info>
4786 <glossdef> 4876 <glossdef>
4787 <para> 4877 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4788 The name of the output image files minus the extension. 4878 The name of the output image files minus the extension.
4789 This variable is derived using the 4879 This variable is derived using the
4790 <link linkend='var-IMAGE_BASENAME'><filename>IMAGE_BASENAME</filename></link>, 4880 <link linkend='var-IMAGE_BASENAME'><filename>IMAGE_BASENAME</filename></link>,
@@ -4799,12 +4889,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4799 </glossdef> 4889 </glossdef>
4800 </glossentry> 4890 </glossentry>
4801 4891
4802 <glossentry id='var-IMAGE_OVERHEAD_FACTOR'><glossterm>IMAGE_OVERHEAD_FACTOR<imagedata fileref="figures/define-generic.png" /></glossterm> 4892 <glossentry id='var-IMAGE_OVERHEAD_FACTOR'><glossterm>IMAGE_OVERHEAD_FACTOR</glossterm>
4803 <info> 4893 <info>
4804 IMAGE_OVERHEAD_FACTOR[doc] = "Defines a multiplier that the build system applies to the initial image size for cases when the multiplier times the returned disk usage value for the image is greater than the sum of IMAGE_ROOTFS_SIZE and IMAGE_ROOTFS_EXTRA_SPACE." 4894 IMAGE_OVERHEAD_FACTOR[doc] = "Defines a multiplier that the build system applies to the initial image size for cases when the multiplier times the returned disk usage value for the image is greater than the sum of IMAGE_ROOTFS_SIZE and IMAGE_ROOTFS_EXTRA_SPACE."
4805 </info> 4895 </info>
4806 <glossdef> 4896 <glossdef>
4807 <para> 4897 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4808 Defines a multiplier that the build system applies to the initial image 4898 Defines a multiplier that the build system applies to the initial image
4809 size for cases when the multiplier times the returned disk usage value 4899 size for cases when the multiplier times the returned disk usage value
4810 for the image is greater than the sum of 4900 for the image is greater than the sum of
@@ -4844,12 +4934,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4844 </glossdef> 4934 </glossdef>
4845 </glossentry> 4935 </glossentry>
4846 4936
4847 <glossentry id='var-IMAGE_PKGTYPE'><glossterm>IMAGE_PKGTYPE<imagedata fileref="figures/define-generic.png" /></glossterm> 4937 <glossentry id='var-IMAGE_PKGTYPE'><glossterm>IMAGE_PKGTYPE</glossterm>
4848 <info> 4938 <info>
4849 IMAGE_PKGTYPE[doc] = "Defines the package type (DEB, RPM, IPK, or TAR) used by the OpenEmbedded build system." 4939 IMAGE_PKGTYPE[doc] = "Defines the package type (DEB, RPM, IPK, or TAR) used by the OpenEmbedded build system."
4850 </info> 4940 </info>
4851 <glossdef> 4941 <glossdef>
4852 <para> 4942 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4853 Defines the package type (DEB, RPM, IPK, or TAR) used 4943 Defines the package type (DEB, RPM, IPK, or TAR) used
4854 by the OpenEmbedded build system. 4944 by the OpenEmbedded build system.
4855 The variable is defined appropriately by the 4945 The variable is defined appropriately by the
@@ -4895,18 +4985,21 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4895 </glossdef> 4985 </glossdef>
4896 </glossentry> 4986 </glossentry>
4897 4987
4898 <glossentry id='var-IMAGE_POSTPROCESS_COMMAND'><glossterm>IMAGE_POSTPROCESS_COMMAND<imagedata fileref="figures/define-generic.png" /></glossterm> 4988 <glossentry id='var-IMAGE_POSTPROCESS_COMMAND'><glossterm>IMAGE_POSTPROCESS_COMMAND</glossterm>
4899 <info> 4989 <info>
4900 IMAGE_POSTPROCESS_COMMAND[doc] = "Added by classes to run post processing commands once the OpenEmbedded build system has created the image." 4990 IMAGE_POSTPROCESS_COMMAND[doc] = "Added by classes to run post processing commands once the OpenEmbedded build system has created the image."
4901 </info> 4991 </info>
4902 <glossdef> 4992 <glossdef>
4903 <para> 4993 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4904 Added by classes to run post processing commands once the 4994 Added by classes to run post processing commands once the
4905 OpenEmbedded build system has created the image. 4995 OpenEmbedded build system has created the image.
4906 You can specify shell commands separated by semicolons: 4996 You can specify shell commands separated by semicolons:
4907 <literallayout class='monospaced'> 4997 <literallayout class='monospaced'>
4908 IMAGE_POSTPROCESS_COMMAND += "<replaceable>shell_command</replaceable>; ... " 4998 IMAGE_POSTPROCESS_COMMAND += "<replaceable>shell_command</replaceable>; ... "
4909 </literallayout> 4999 </literallayout>
5000 </para>
5001
5002 <para>
4910 If you need to pass the path to the root filesystem within 5003 If you need to pass the path to the root filesystem within
4911 the command, you can use 5004 the command, you can use
4912 <filename>${IMAGE_ROOTFS}</filename>, which points to 5005 <filename>${IMAGE_ROOTFS}</filename>, which points to
@@ -4915,12 +5008,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4915 </glossdef> 5008 </glossdef>
4916 </glossentry> 5009 </glossentry>
4917 5010
4918 <glossentry id='var-IMAGE_ROOTFS'><glossterm>IMAGE_ROOTFS<imagedata fileref="figures/define-generic.png" /></glossterm> 5011 <glossentry id='var-IMAGE_ROOTFS'><glossterm>IMAGE_ROOTFS</glossterm>
4919 <info> 5012 <info>
4920 IMAGE_ROOTFS[doc] = "The location of the root filesystem while it is under construction (i.e. during do_rootfs)." 5013 IMAGE_ROOTFS[doc] = "The location of the root filesystem while it is under construction (i.e. during do_rootfs)."
4921 </info> 5014 </info>
4922 <glossdef> 5015 <glossdef>
4923 <para> 5016 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4924 The location of the root filesystem while it is under 5017 The location of the root filesystem while it is under
4925 construction (i.e. during the 5018 construction (i.e. during the
4926 <link linkend='ref-tasks-rootfs'><filename>do_rootfs</filename></link> 5019 <link linkend='ref-tasks-rootfs'><filename>do_rootfs</filename></link>
@@ -4931,12 +5024,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4931 </glossdef> 5024 </glossdef>
4932 </glossentry> 5025 </glossentry>
4933 5026
4934 <glossentry id='var-IMAGE_ROOTFS_ALIGNMENT'><glossterm>IMAGE_ROOTFS_ALIGNMENT<imagedata fileref="figures/define-generic.png" /></glossterm> 5027 <glossentry id='var-IMAGE_ROOTFS_ALIGNMENT'><glossterm>IMAGE_ROOTFS_ALIGNMENT</glossterm>
4935 <info> 5028 <info>
4936 IMAGE_ROOTFS_ALIGNMENT[doc] = "Specifies the alignment for the output image file in Kbytes." 5029 IMAGE_ROOTFS_ALIGNMENT[doc] = "Specifies the alignment for the output image file in Kbytes."
4937 </info> 5030 </info>
4938 <glossdef> 5031 <glossdef>
4939 <para> 5032 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4940 Specifies the alignment for the output image file in 5033 Specifies the alignment for the output image file in
4941 Kbytes. 5034 Kbytes.
4942 If the size of the image is not a multiple of 5035 If the size of the image is not a multiple of
@@ -4950,12 +5043,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4950 </glossdef> 5043 </glossdef>
4951 </glossentry> 5044 </glossentry>
4952 5045
4953 <glossentry id='var-IMAGE_ROOTFS_EXTRA_SPACE'><glossterm>IMAGE_ROOTFS_EXTRA_SPACE<imagedata fileref="figures/define-generic.png" /></glossterm> 5046 <glossentry id='var-IMAGE_ROOTFS_EXTRA_SPACE'><glossterm>IMAGE_ROOTFS_EXTRA_SPACE</glossterm>
4954 <info> 5047 <info>
4955 IMAGE_ROOTFS_EXTRA_SPACE[doc] = "Defines additional free disk space created in the image in Kbytes. By default, this variable is set to '0'." 5048 IMAGE_ROOTFS_EXTRA_SPACE[doc] = "Defines additional free disk space created in the image in Kbytes. By default, this variable is set to '0'."
4956 </info> 5049 </info>
4957 <glossdef> 5050 <glossdef>
4958 <para> 5051 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4959 Defines additional free disk space created in the image in Kbytes. 5052 Defines additional free disk space created in the image in Kbytes.
4960 By default, this variable is set to "0". 5053 By default, this variable is set to "0".
4961 This free disk space is added to the image after the build system determines 5054 This free disk space is added to the image after the build system determines
@@ -4984,12 +5077,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
4984 </glossdef> 5077 </glossdef>
4985 </glossentry> 5078 </glossentry>
4986 5079
4987 <glossentry id='var-IMAGE_ROOTFS_SIZE'><glossterm>IMAGE_ROOTFS_SIZE<imagedata fileref="figures/define-generic.png" /></glossterm> 5080 <glossentry id='var-IMAGE_ROOTFS_SIZE'><glossterm>IMAGE_ROOTFS_SIZE</glossterm>
4988 <info> 5081 <info>
4989 IMAGE_ROOTFS_SIZE[doc] = "Defines the size in Kbytes for the generated image." 5082 IMAGE_ROOTFS_SIZE[doc] = "Defines the size in Kbytes for the generated image."
4990 </info> 5083 </info>
4991 <glossdef> 5084 <glossdef>
4992 <para> 5085 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
4993 Defines the size in Kbytes for the generated image. 5086 Defines the size in Kbytes for the generated image.
4994 The OpenEmbedded build system determines the final size for the generated 5087 The OpenEmbedded build system determines the final size for the generated
4995 image using an algorithm that takes into account the initial disk space used 5088 image using an algorithm that takes into account the initial disk space used
@@ -5017,6 +5110,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5017 5110
5018 xspace = IMAGE_ROOTFS_EXTRA_SPACE 5111 xspace = IMAGE_ROOTFS_EXTRA_SPACE
5019 </literallayout> 5112 </literallayout>
5113 </para>
5114
5115 <para>
5020 See the <link linkend='var-IMAGE_OVERHEAD_FACTOR'><filename>IMAGE_OVERHEAD_FACTOR</filename></link> 5116 See the <link linkend='var-IMAGE_OVERHEAD_FACTOR'><filename>IMAGE_OVERHEAD_FACTOR</filename></link>
5021 and <link linkend='var-IMAGE_ROOTFS_EXTRA_SPACE'><filename>IMAGE_ROOTFS_EXTRA_SPACE</filename></link> 5117 and <link linkend='var-IMAGE_ROOTFS_EXTRA_SPACE'><filename>IMAGE_ROOTFS_EXTRA_SPACE</filename></link>
5022 variables for related information. 5118 variables for related information.
@@ -5030,12 +5126,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5030 </glossdef> 5126 </glossdef>
5031 </glossentry> 5127 </glossentry>
5032 5128
5033 <glossentry id='var-IMAGE_TYPEDEP'><glossterm>IMAGE_TYPEDEP<imagedata fileref="figures/define-generic.png" /></glossterm> 5129 <glossentry id='var-IMAGE_TYPEDEP'><glossterm>IMAGE_TYPEDEP</glossterm>
5034 <info> 5130 <info>
5035 IMAGE_TYPEDEP[doc] = "Specifies a dependency from one image type on another." 5131 IMAGE_TYPEDEP[doc] = "Specifies a dependency from one image type on another."
5036 </info> 5132 </info>
5037 <glossdef> 5133 <glossdef>
5038 <para> 5134 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5039 Specifies a dependency from one image type on another. 5135 Specifies a dependency from one image type on another.
5040 Here is an example from the 5136 Here is an example from the
5041 <link linkend='ref-classes-image-live'><filename>image-live</filename></link> 5137 <link linkend='ref-classes-image-live'><filename>image-live</filename></link>
@@ -5043,6 +5139,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5043 <literallayout class='monospaced'> 5139 <literallayout class='monospaced'>
5044 IMAGE_TYPEDEP_live = "ext3" 5140 IMAGE_TYPEDEP_live = "ext3"
5045 </literallayout> 5141 </literallayout>
5142 </para>
5143
5144 <para>
5046 In the previous example, the variable ensures that when 5145 In the previous example, the variable ensures that when
5047 "live" is listed with the 5146 "live" is listed with the
5048 <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link> 5147 <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link>
@@ -5056,12 +5155,12 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5056 </glossdef> 5155 </glossdef>
5057 </glossentry> 5156 </glossentry>
5058 5157
5059 <glossentry id='var-IMAGE_TYPES'><glossterm>IMAGE_TYPES<imagedata fileref="figures/define-generic.png" /></glossterm> 5158 <glossentry id='var-IMAGE_TYPES'><glossterm>IMAGE_TYPES</glossterm>
5060 <info> 5159 <info>
5061 IMAGE_TYPES[doc] = "Specifies the complete list of supported image types by default." 5160 IMAGE_TYPES[doc] = "Specifies the complete list of supported image types by default."
5062 </info> 5161 </info>
5063 <glossdef> 5162 <glossdef>
5064 <para> 5163 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5065 Specifies the complete list of supported image types 5164 Specifies the complete list of supported image types
5066 by default: 5165 by default:
5067 <literallayout class='monospaced'> 5166 <literallayout class='monospaced'>
@@ -5091,6 +5190,9 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5091 vmdk 5190 vmdk
5092 elf 5191 elf
5093 </literallayout> 5192 </literallayout>
5193 </para>
5194
5195 <para>
5094 For more information about these types of images, see 5196 For more information about these types of images, see
5095 <filename>meta/classes/image_types*.bbclass</filename> 5197 <filename>meta/classes/image_types*.bbclass</filename>
5096 in the 5198 in the
@@ -5099,16 +5201,20 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5099 </glossdef> 5201 </glossdef>
5100 </glossentry> 5202 </glossentry>
5101 5203
5102 <glossentry id='var-INC_PR'><glossterm>INC_PR<imagedata fileref="figures/define-generic.png" /></glossterm> 5204 <glossentry id='var-INC_PR'><glossterm>INC_PR</glossterm>
5103 <info> 5205 <info>
5104 INC_PR[doc] = "Helps define the recipe revision for recipes that share a common include file." 5206 INC_PR[doc] = "Helps define the recipe revision for recipes that share a common include file."
5105 </info> 5207 </info>
5106 <glossdef> 5208 <glossdef>
5107 <para>Helps define the recipe revision for recipes that share 5209 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5210 Helps define the recipe revision for recipes that share
5108 a common <filename>include</filename> file. 5211 a common <filename>include</filename> file.
5109 You can think of this variable as part of the recipe revision 5212 You can think of this variable as part of the recipe revision
5110 as set from within an include file.</para> 5213 as set from within an include file.
5111 <para>Suppose, for example, you have a set of recipes that 5214 </para>
5215
5216 <para>
5217 Suppose, for example, you have a set of recipes that
5112 are used across several projects. 5218 are used across several projects.
5113 And, within each of those recipes the revision 5219 And, within each of those recipes the revision
5114 (its <link linkend='var-PR'><filename>PR</filename></link> 5220 (its <link linkend='var-PR'><filename>PR</filename></link>
@@ -5119,14 +5225,18 @@ meta/conf/machine/include/<architecture>/arch-<architecture>.inc
5119 version of the recipe. 5225 version of the recipe.
5120 In this scenario, it can get complicated when recipes 5226 In this scenario, it can get complicated when recipes
5121 that are used in many places and provide common functionality 5227 that are used in many places and provide common functionality
5122 are upgraded to a new revision.</para> 5228 are upgraded to a new revision.
5123 <para>A more efficient way of dealing with this situation is 5229 </para>
5230
5231 <para>
5232 A more efficient way of dealing with this situation is
5124 to set the <filename>INC_PR</filename> variable inside 5233 to set the <filename>INC_PR</filename> variable inside
5125 the <filename>include</filename> files that the recipes 5234 the <filename>include</filename> files that the recipes
5126 share and then expand the <filename>INC_PR</filename> 5235 share and then expand the <filename>INC_PR</filename>
5127 variable within the recipes to help 5236 variable within the recipes to help
5128 define the recipe revision. 5237 define the recipe revision.
5129 </para> 5238 </para>
5239
5130 <para> 5240 <para>
5131 The following provides an example that shows how to use 5241 The following provides an example that shows how to use
5132 the <filename>INC_PR</filename> variable 5242 the <filename>INC_PR</filename> variable
@@ -5151,16 +5261,17 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5151 <filename>include</filename> file. 5261 <filename>include</filename> file.
5152 The remaining lines in the example are from individual 5262 The remaining lines in the example are from individual
5153 recipes and show how the <filename>PR</filename> value 5263 recipes and show how the <filename>PR</filename> value
5154 is set.</para> 5264 is set.
5265 </para>
5155 </glossdef> 5266 </glossdef>
5156 </glossentry> 5267 </glossentry>
5157 5268
5158 <glossentry id='var-INCOMPATIBLE_LICENSE'><glossterm>INCOMPATIBLE_LICENSE<imagedata fileref="figures/define-generic.png" /></glossterm> 5269 <glossentry id='var-INCOMPATIBLE_LICENSE'><glossterm>INCOMPATIBLE_LICENSE</glossterm>
5159 <info> 5270 <info>
5160 INCOMPATIBLE_LICENSE[doc] = "Specifies a space-separated list of license names (as they would appear in LICENSE) that should be excluded from the build." 5271 INCOMPATIBLE_LICENSE[doc] = "Specifies a space-separated list of license names (as they would appear in LICENSE) that should be excluded from the build."
5161 </info> 5272 </info>
5162 <glossdef> 5273 <glossdef>
5163 <para> 5274 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5164 Specifies a space-separated list of license names 5275 Specifies a space-separated list of license names
5165 (as they would appear in 5276 (as they would appear in
5166 <link linkend='var-LICENSE'><filename>LICENSE</filename></link>) 5277 <link linkend='var-LICENSE'><filename>LICENSE</filename></link>)
@@ -5185,12 +5296,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5185 </glossdef> 5296 </glossdef>
5186 </glossentry> 5297 </glossentry>
5187 5298
5188 <glossentry id='var-INHIBIT_DEFAULT_DEPS'><glossterm>INHIBIT_DEFAULT_DEPS<imagedata fileref="figures/define-generic.png" /></glossterm> 5299 <glossentry id='var-INHIBIT_DEFAULT_DEPS'><glossterm>INHIBIT_DEFAULT_DEPS</glossterm>
5189 <info> 5300 <info>
5190 INHIBIT_DEFAULT_DEPS[doc] = "Prevents the default dependencies, namely the C compiler and standard C library (libc), from being added to DEPENDS." 5301 INHIBIT_DEFAULT_DEPS[doc] = "Prevents the default dependencies, namely the C compiler and standard C library (libc), from being added to DEPENDS."
5191 </info> 5302 </info>
5192 <glossdef> 5303 <glossdef>
5193 <para> 5304 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5194 Prevents the default dependencies, namely the C compiler 5305 Prevents the default dependencies, namely the C compiler
5195 and standard C library (libc), from being added to 5306 and standard C library (libc), from being added to
5196 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>. 5307 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>.
@@ -5205,13 +5316,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5205 </glossdef> 5316 </glossdef>
5206 </glossentry> 5317 </glossentry>
5207 5318
5208 <glossentry id='var-INHIBIT_PACKAGE_DEBUG_SPLIT'><glossterm>INHIBIT_PACKAGE_DEBUG_SPLIT<imagedata fileref="figures/define-generic.png" /></glossterm> 5319 <glossentry id='var-INHIBIT_PACKAGE_DEBUG_SPLIT'><glossterm>INHIBIT_PACKAGE_DEBUG_SPLIT</glossterm>
5209 <info> 5320 <info>
5210 INHIBIT_PACKAGE_STRIP[doc] = "If set to "1", causes the build to not strip binaries in resulting packages." 5321 INHIBIT_PACKAGE_STRIP[doc] = "If set to "1", causes the build to not strip binaries in resulting packages."
5211 </info> 5322 </info>
5212 <glossdef> 5323 <glossdef>
5213 5324 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5214 <para>
5215 Prevents the OpenEmbedded build system from splitting 5325 Prevents the OpenEmbedded build system from splitting
5216 out debug information during packaging. 5326 out debug information during packaging.
5217 By default, the build system splits out debugging 5327 By default, the build system splits out debugging
@@ -5236,23 +5346,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5236 </glossdef> 5346 </glossdef>
5237 </glossentry> 5347 </glossentry>
5238 5348
5239 <glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP<imagedata fileref="figures/define-generic.png" /></glossterm> 5349 <glossentry id='var-INHIBIT_PACKAGE_STRIP'><glossterm>INHIBIT_PACKAGE_STRIP</glossterm>
5240 <info> 5350 <info>
5241 INHIBIT_PACKAGE_STRIP[doc] = "If set to "1", causes the build to not strip binaries in resulting packages." 5351 INHIBIT_PACKAGE_STRIP[doc] = "If set to "1", causes the build to not strip binaries in resulting packages."
5242 </info> 5352 </info>
5243 <glossdef> 5353 <glossdef>
5244 <para> 5354 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5245 If set to "1", causes the build to not strip binaries in resulting packages. 5355 If set to "1", causes the build to not strip binaries in resulting packages.
5246 </para> 5356 </para>
5247 </glossdef> 5357 </glossdef>
5248 </glossentry> 5358 </glossentry>
5249 5359
5250 <glossentry id='var-INHERIT'><glossterm>INHERIT<imagedata fileref="figures/define-generic.png" /></glossterm> 5360 <glossentry id='var-INHERIT'><glossterm>INHERIT</glossterm>
5251 <info> 5361 <info>
5252 INHERIT[doc] = "Causes the named class to be inherited at this point during parsing. The variable is only valid in configuration files." 5362 INHERIT[doc] = "Causes the named class to be inherited at this point during parsing. The variable is only valid in configuration files."
5253 </info> 5363 </info>
5254 <glossdef> 5364 <glossdef>
5255 <para> 5365 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5256 Causes the named class to be inherited at 5366 Causes the named class to be inherited at
5257 this point during parsing. 5367 this point during parsing.
5258 The variable is only valid in configuration files. 5368 The variable is only valid in configuration files.
@@ -5260,12 +5370,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5260 </glossdef> 5370 </glossdef>
5261 </glossentry> 5371 </glossentry>
5262 5372
5263 <glossentry id='var-INHERIT_DISTRO'><glossterm>INHERIT_DISTRO<imagedata fileref="figures/define-generic.png" /></glossterm> 5373 <glossentry id='var-INHERIT_DISTRO'><glossterm>INHERIT_DISTRO</glossterm>
5264 <info> 5374 <info>
5265 INHERIT_DISTRO[doc] = "Lists classes that will be inherited at the distribution level. It is unlikely that you want to edit this variable." 5375 INHERIT_DISTRO[doc] = "Lists classes that will be inherited at the distribution level. It is unlikely that you want to edit this variable."
5266 </info> 5376 </info>
5267 <glossdef> 5377 <glossdef>
5268 <para> 5378 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5269 Lists classes that will be inherited at the 5379 Lists classes that will be inherited at the
5270 distribution level. 5380 distribution level.
5271 It is unlikely that you want to edit this variable. 5381 It is unlikely that you want to edit this variable.
@@ -5282,12 +5392,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5282 </glossdef> 5392 </glossdef>
5283 </glossentry> 5393 </glossentry>
5284 5394
5285 <glossentry id='var-INITRAMFS_FSTYPES'><glossterm>INITRAMFS_FSTYPES<imagedata fileref="figures/define-generic.png" /></glossterm> 5395 <glossentry id='var-INITRAMFS_FSTYPES'><glossterm>INITRAMFS_FSTYPES</glossterm>
5286 <info> 5396 <info>
5287 INITRAMFS_FSTYPES[doc] = "Defines the format for the output image of an initial RAM disk (initramfs), which is used during boot." 5397 INITRAMFS_FSTYPES[doc] = "Defines the format for the output image of an initial RAM disk (initramfs), which is used during boot."
5288 </info> 5398 </info>
5289 <glossdef> 5399 <glossdef>
5290 <para> 5400 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5291 Defines the format for the output image of an initial 5401 Defines the format for the output image of an initial
5292 RAM disk (initramfs), which is used during boot. 5402 RAM disk (initramfs), which is used during boot.
5293 Supported formats are the same as those supported by the 5403 Supported formats are the same as those supported by the
@@ -5297,12 +5407,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5297 </glossdef> 5407 </glossdef>
5298 </glossentry> 5408 </glossentry>
5299 5409
5300 <glossentry id='var-INITRAMFS_IMAGE'><glossterm>INITRAMFS_IMAGE<imagedata fileref="figures/define-generic.png" /></glossterm> 5410 <glossentry id='var-INITRAMFS_IMAGE'><glossterm>INITRAMFS_IMAGE</glossterm>
5301 <info> 5411 <info>
5302 INITRAMFS_IMAGE[doc] = "Causes the OpenEmbedded build system to build an additional recipe as a dependency to your root filesystem recipe (e.g. core-image-sato)." 5412 INITRAMFS_IMAGE[doc] = "Causes the OpenEmbedded build system to build an additional recipe as a dependency to your root filesystem recipe (e.g. core-image-sato)."
5303 </info> 5413 </info>
5304 <glossdef> 5414 <glossdef>
5305 <para> 5415 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5306 Causes the OpenEmbedded build system to build an additional 5416 Causes the OpenEmbedded build system to build an additional
5307 recipe as a dependency to your root filesystem recipe 5417 recipe as a dependency to your root filesystem recipe
5308 (e.g. <filename>core-image-sato</filename>). 5418 (e.g. <filename>core-image-sato</filename>).
@@ -5343,12 +5453,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5343 </glossdef> 5453 </glossdef>
5344 </glossentry> 5454 </glossentry>
5345 5455
5346 <glossentry id='var-INITRAMFS_IMAGE_BUNDLE'><glossterm>INITRAMFS_IMAGE_BUNDLE<imagedata fileref="figures/define-generic.png" /></glossterm> 5456 <glossentry id='var-INITRAMFS_IMAGE_BUNDLE'><glossterm>INITRAMFS_IMAGE_BUNDLE</glossterm>
5347 <info> 5457 <info>
5348 INITRAMFS_IMAGE_BUNDLE[doc] = "Controls whether or not the image recipe specified by INITRAMFS_IMAGE is run through an extra pass during kernel compilation in order to build a single binary that contains both the kernel image and the initial RAM disk (initramfs)." 5458 INITRAMFS_IMAGE_BUNDLE[doc] = "Controls whether or not the image recipe specified by INITRAMFS_IMAGE is run through an extra pass during kernel compilation in order to build a single binary that contains both the kernel image and the initial RAM disk (initramfs)."
5349 </info> 5459 </info>
5350 <glossdef> 5460 <glossdef>
5351 <para> 5461 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5352 Controls whether or not the image recipe specified by 5462 Controls whether or not the image recipe specified by
5353 <link linkend='var-INITRAMFS_IMAGE'><filename>INITRAMFS_IMAGE</filename></link> 5463 <link linkend='var-INITRAMFS_IMAGE'><filename>INITRAMFS_IMAGE</filename></link>
5354 is run through an extra pass during kernel compilation 5464 is run through an extra pass during kernel compilation
@@ -5393,12 +5503,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5393 </glossdef> 5503 </glossdef>
5394 </glossentry> 5504 </glossentry>
5395 5505
5396 <glossentry id='var-INITRD'><glossterm>INITRD<imagedata fileref="figures/define-generic.png" /></glossterm> 5506 <glossentry id='var-INITRD'><glossterm>INITRD</glossterm>
5397 <info> 5507 <info>
5398 INITRD[doc] = "Indicates a list of filesystem images to concatenate and use as an initial RAM disk (initrd)." 5508 INITRD[doc] = "Indicates a list of filesystem images to concatenate and use as an initial RAM disk (initrd)."
5399 </info> 5509 </info>
5400 <glossdef> 5510 <glossdef>
5401 <para> 5511 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5402 Indicates list of filesystem images to concatenate and use 5512 Indicates list of filesystem images to concatenate and use
5403 as an initial RAM disk (<filename>initrd</filename>). 5513 as an initial RAM disk (<filename>initrd</filename>).
5404 </para> 5514 </para>
@@ -5412,12 +5522,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5412 </glossdef> 5522 </glossdef>
5413 </glossentry> 5523 </glossentry>
5414 5524
5415 <glossentry id='var-INITRD_IMAGE'><glossterm>INITRD_IMAGE<imagedata fileref="figures/define-generic.png" /></glossterm> 5525 <glossentry id='var-INITRD_IMAGE'><glossterm>INITRD_IMAGE</glossterm>
5416 <info> 5526 <info>
5417 INITRD_IMAGE[doc] = "When building a "live" bootable image (i.e. when IMAGE_FSTYPES contains "live"), INITRD_IMAGE specifies the image recipe that should be built to provide the initial RAM disk image." 5527 INITRD_IMAGE[doc] = "When building a "live" bootable image (i.e. when IMAGE_FSTYPES contains "live"), INITRD_IMAGE specifies the image recipe that should be built to provide the initial RAM disk image."
5418 </info> 5528 </info>
5419 <glossdef> 5529 <glossdef>
5420 <para> 5530 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5421 When building a "live" bootable image (i.e. when 5531 When building a "live" bootable image (i.e. when
5422 <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link> 5532 <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link>
5423 contains "live"), <filename>INITRD_IMAGE</filename> 5533 contains "live"), <filename>INITRD_IMAGE</filename>
@@ -5434,15 +5544,16 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5434 </glossdef> 5544 </glossdef>
5435 </glossentry> 5545 </glossentry>
5436 5546
5437 <glossentry id='var-INITSCRIPT_NAME'><glossterm>INITSCRIPT_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 5547 <glossentry id='var-INITSCRIPT_NAME'><glossterm>INITSCRIPT_NAME</glossterm>
5438 <info> 5548 <info>
5439 INITSCRIPT_NAME[doc] = "The filename of the initialization script as installed to ${sysconfdir}/init.d." 5549 INITSCRIPT_NAME[doc] = "The filename of the initialization script as installed to ${sysconfdir}/init.d."
5440 </info> 5550 </info>
5441 <glossdef> 5551 <glossdef>
5442 <para> 5552 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5443 The filename of the initialization script as installed to 5553 The filename of the initialization script as installed to
5444 <filename>${sysconfdir}/init.d</filename>. 5554 <filename>${sysconfdir}/init.d</filename>.
5445 </para> 5555 </para>
5556
5446 <para> 5557 <para>
5447 This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>. 5558 This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>.
5448 The variable is mandatory. 5559 The variable is mandatory.
@@ -5450,15 +5561,17 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5450 </glossdef> 5561 </glossdef>
5451 </glossentry> 5562 </glossentry>
5452 5563
5453 <glossentry id='var-INITSCRIPT_PACKAGES'><glossterm>INITSCRIPT_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 5564 <glossentry id='var-INITSCRIPT_PACKAGES'><glossterm>INITSCRIPT_PACKAGES</glossterm>
5454 <info> 5565 <info>
5455 INITSCRIPT_PACKAGES[doc] = "A list of the packages that contain initscripts. This variable is used in recipes when using update-rc.d.bbclass. The variable is optional and defaults to the PN variable." 5566 INITSCRIPT_PACKAGES[doc] = "A list of the packages that contain initscripts. This variable is used in recipes when using update-rc.d.bbclass. The variable is optional and defaults to the PN variable."
5456 </info> 5567 </info>
5457 <glossdef> 5568 <glossdef>
5458 <para> 5569 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5459 A list of the packages that contain initscripts. 5570 A list of the packages that contain initscripts.
5460 If multiple packages are specified, you need to append the package name 5571 If multiple packages are specified, you need to append the package name
5461 to the other <filename>INITSCRIPT_*</filename> as an override.</para> 5572 to the other <filename>INITSCRIPT_*</filename> as an override.
5573 </para>
5574
5462 <para> 5575 <para>
5463 This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>. 5576 This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>.
5464 The variable is optional and defaults to the 5577 The variable is optional and defaults to the
@@ -5467,27 +5580,32 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5467 </glossdef> 5580 </glossdef>
5468 </glossentry> 5581 </glossentry>
5469 5582
5470 <glossentry id='var-INITSCRIPT_PARAMS'><glossterm>INITSCRIPT_PARAMS<imagedata fileref="figures/define-generic.png" /></glossterm> 5583 <glossentry id='var-INITSCRIPT_PARAMS'><glossterm>INITSCRIPT_PARAMS</glossterm>
5471 <info> 5584 <info>
5472 INITSCRIPT_PARAMS[doc] = "Specifies the options to pass to update-rc.d. The variable is mandatory and is used in recipes when using update-rc.d.bbclass." 5585 INITSCRIPT_PARAMS[doc] = "Specifies the options to pass to update-rc.d. The variable is mandatory and is used in recipes when using update-rc.d.bbclass."
5473 </info> 5586 </info>
5474 <glossdef> 5587 <glossdef>
5475 <para> 5588 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5476 Specifies the options to pass to <filename>update-rc.d</filename>. 5589 Specifies the options to pass to <filename>update-rc.d</filename>.
5477 Here is an example: 5590 Here is an example:
5478 <literallayout class='monospaced'> 5591 <literallayout class='monospaced'>
5479 INITSCRIPT_PARAMS = "start 99 5 2 . stop 20 0 1 6 ." 5592 INITSCRIPT_PARAMS = "start 99 5 2 . stop 20 0 1 6 ."
5480 </literallayout> 5593 </literallayout>
5594 </para>
5595
5596 <para>
5481 In this example, the script has a runlevel of 99, 5597 In this example, the script has a runlevel of 99,
5482 starts the script in initlevels 2 and 5, and 5598 starts the script in initlevels 2 and 5, and
5483 stops the script in levels 0, 1 and 6. 5599 stops the script in levels 0, 1 and 6.
5484 </para> 5600 </para>
5601
5485 <para> 5602 <para>
5486 The variable's default value is "defaults", which is 5603 The variable's default value is "defaults", which is
5487 set in the 5604 set in the
5488 <link linkend='ref-classes-update-rc.d'><filename>update-rc.d</filename></link> 5605 <link linkend='ref-classes-update-rc.d'><filename>update-rc.d</filename></link>
5489 class. 5606 class.
5490 </para> 5607 </para>
5608
5491 <para> 5609 <para>
5492 The value in 5610 The value in
5493 <filename>INITSCRIPT_PARAMS</filename> is passed through 5611 <filename>INITSCRIPT_PARAMS</filename> is passed through
@@ -5499,12 +5617,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5499 </glossdef> 5617 </glossdef>
5500 </glossentry> 5618 </glossentry>
5501 5619
5502 <glossentry id='var-INSANE_SKIP'><glossterm>INSANE_SKIP<imagedata fileref="figures/define-generic.png" /></glossterm> 5620 <glossentry id='var-INSANE_SKIP'><glossterm>INSANE_SKIP</glossterm>
5503 <info> 5621 <info>
5504 INSANE_SKIP[doc] = "Specifies the QA checks to skip for a specific package within a recipe." 5622 INSANE_SKIP[doc] = "Specifies the QA checks to skip for a specific package within a recipe."
5505 </info> 5623 </info>
5506 <glossdef> 5624 <glossdef>
5507 <para> 5625 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5508 Specifies the QA checks to skip for a specific package 5626 Specifies the QA checks to skip for a specific package
5509 within a recipe. 5627 within a recipe.
5510 For example, to skip the check for symbolic link 5628 For example, to skip the check for symbolic link
@@ -5516,6 +5634,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5516 INSANE_SKIP_${PN} += "dev-so" 5634 INSANE_SKIP_${PN} += "dev-so"
5517 </literallayout> 5635 </literallayout>
5518 </para> 5636 </para>
5637
5519 <para> 5638 <para>
5520 See the "<link linkend='ref-classes-insane'><filename>insane.bbclass</filename></link>" 5639 See the "<link linkend='ref-classes-insane'><filename>insane.bbclass</filename></link>"
5521 section for a list of the valid QA checks you can 5640 section for a list of the valid QA checks you can
@@ -5524,12 +5643,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5524 </glossdef> 5643 </glossdef>
5525 </glossentry> 5644 </glossentry>
5526 5645
5527 <glossentry id='var-IPK_FEED_URIS'><glossterm>IPK_FEED_URIS<imagedata fileref="figures/define-generic.png" /></glossterm> 5646 <glossentry id='var-IPK_FEED_URIS'><glossterm>IPK_FEED_URIS</glossterm>
5528 <info> 5647 <info>
5529 IPK_FEED_URIS[doc] = "List of ipkg feed records to put into generated image." 5648 IPK_FEED_URIS[doc] = "List of ipkg feed records to put into generated image."
5530 </info> 5649 </info>
5531 <glossdef> 5650 <glossdef>
5532 <para> 5651 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5533 When the IPK backend is in use and package management 5652 When the IPK backend is in use and package management
5534 is enabled on the target, you can use this variable to 5653 is enabled on the target, you can use this variable to
5535 set up <filename>opkg</filename> in the target image 5654 set up <filename>opkg</filename> in the target image
@@ -5542,7 +5661,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5542 </glossentry> 5661 </glossentry>
5543 5662
5544<!-- 5663<!--
5545 <glossentry id='var-INTERCEPT_DIR'><glossterm>INTERCEPT_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 5664 <glossentry id='var-INTERCEPT_DIR'><glossterm>INTERCEPT_DIR</glossterm>
5546 <glossdef> 5665 <glossdef>
5547 <para> 5666 <para>
5548 An environment variable that defines the directory where 5667 An environment variable that defines the directory where
@@ -5583,12 +5702,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5583 5702
5584 <glossdiv id='var-glossary-k'><title>K</title> 5703 <glossdiv id='var-glossary-k'><title>K</title>
5585 5704
5586 <glossentry id='var-KARCH'><glossterm>KARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 5705 <glossentry id='var-KARCH'><glossterm>KARCH</glossterm>
5587 <info> 5706 <info>
5588 KARCH[doc] = "Defines the kernel architecture used when assembling the configuration. You define the KARCH variable in the BSP Descriptions." 5707 KARCH[doc] = "Defines the kernel architecture used when assembling the configuration. You define the KARCH variable in the BSP Descriptions."
5589 </info> 5708 </info>
5590 <glossdef> 5709 <glossdef>
5591 <para> 5710 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5592 Defines the kernel architecture used when assembling 5711 Defines the kernel architecture used when assembling
5593 the configuration. 5712 the configuration.
5594 Architectures supported for this release are: 5713 Architectures supported for this release are:
@@ -5609,12 +5728,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5609 </glossdef> 5728 </glossdef>
5610 </glossentry> 5729 </glossentry>
5611 5730
5612 <glossentry id='var-KBRANCH'><glossterm>KBRANCH<imagedata fileref="figures/define-generic.png" /></glossterm> 5731 <glossentry id='var-KBRANCH'><glossterm>KBRANCH</glossterm>
5613 <info> 5732 <info>
5614 KBRANCH[doc] = "A regular expression used by the build process to explicitly identify the kernel branch that is validated, patched and configured during a build." 5733 KBRANCH[doc] = "A regular expression used by the build process to explicitly identify the kernel branch that is validated, patched and configured during a build."
5615 </info> 5734 </info>
5616 <glossdef> 5735 <glossdef>
5617 <para> 5736 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5618 A regular expression used by the build process to explicitly 5737 A regular expression used by the build process to explicitly
5619 identify the kernel branch that is validated, patched 5738 identify the kernel branch that is validated, patched
5620 and configured during a build. 5739 and configured during a build.
@@ -5673,12 +5792,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5673 </glossdef> 5792 </glossdef>
5674 </glossentry> 5793 </glossentry>
5675 5794
5676 <glossentry id='var-KBRANCH_DEFAULT'><glossterm>KBRANCH_DEFAULT<imagedata fileref="figures/define-generic.png" /></glossterm> 5795 <glossentry id='var-KBRANCH_DEFAULT'><glossterm>KBRANCH_DEFAULT</glossterm>
5677 <info> 5796 <info>
5678 KBRANCH_DEFAULT[doc] = "Defines the Linux kernel source repository's default branch used to build the Linux kernel. Unless you specify otherwise, the variable initializes to 'master'." 5797 KBRANCH_DEFAULT[doc] = "Defines the Linux kernel source repository's default branch used to build the Linux kernel. Unless you specify otherwise, the variable initializes to 'master'."
5679 </info> 5798 </info>
5680 <glossdef> 5799 <glossdef>
5681 <para> 5800 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5682 Defines the Linux kernel source repository's default 5801 Defines the Linux kernel source repository's default
5683 branch used to build the Linux kernel. 5802 branch used to build the Linux kernel.
5684 The <filename>KBRANCH_DEFAULT</filename> value is 5803 The <filename>KBRANCH_DEFAULT</filename> value is
@@ -5691,12 +5810,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5691 </glossdef> 5810 </glossdef>
5692 </glossentry> 5811 </glossentry>
5693 5812
5694 <glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS<imagedata fileref="figures/define-generic.png" /></glossterm> 5813 <glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS</glossterm>
5695 <info> 5814 <info>
5696 KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel." 5815 KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel."
5697 </info> 5816 </info>
5698 <glossdef> 5817 <glossdef>
5699 <para> 5818 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5700 Specifies additional <filename>make</filename> 5819 Specifies additional <filename>make</filename>
5701 command-line arguments the OpenEmbedded build system 5820 command-line arguments the OpenEmbedded build system
5702 passes on when compiling the kernel. 5821 passes on when compiling the kernel.
@@ -5704,27 +5823,34 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5704 </glossdef> 5823 </glossdef>
5705 </glossentry> 5824 </glossentry>
5706 5825
5707 <glossentry id='var-KERNEL_FEATURES'><glossterm>KERNEL_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 5826 <glossentry id='var-KERNEL_FEATURES'><glossterm>KERNEL_FEATURES</glossterm>
5708 <info> 5827 <info>
5709 KERNEL_FEATURES[doc] = "Includes additional metadata from the Yocto Project kernel Git repository. The metadata you add through this variable includes config fragments and features descriptions." 5828 KERNEL_FEATURES[doc] = "Includes additional metadata from the Yocto Project kernel Git repository. The metadata you add through this variable includes config fragments and features descriptions."
5710 </info> 5829 </info>
5711 <glossdef> 5830 <glossdef>
5712 <para>Includes additional metadata from the Yocto Project kernel Git repository. 5831 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5832 Includes additional metadata from the Yocto Project kernel Git repository.
5713 In the OpenEmbedded build system, the default Board Support Packages (BSPs) 5833 In the OpenEmbedded build system, the default Board Support Packages (BSPs)
5714 <ulink url='&YOCTO_DOCS_DEV_URL;#metadata'>Metadata</ulink> 5834 <ulink url='&YOCTO_DOCS_DEV_URL;#metadata'>Metadata</ulink>
5715 is provided through 5835 is provided through
5716 the <link linkend='var-KMACHINE'><filename>KMACHINE</filename></link> 5836 the <link linkend='var-KMACHINE'><filename>KMACHINE</filename></link>
5717 and <link linkend='var-KBRANCH'><filename>KBRANCH</filename></link> variables. 5837 and <link linkend='var-KBRANCH'><filename>KBRANCH</filename></link> variables.
5718 You can use the <filename>KERNEL_FEATURES</filename> variable to further 5838 You can use the <filename>KERNEL_FEATURES</filename> variable to further
5719 add metadata for all BSPs.</para> 5839 add metadata for all BSPs.
5720 <para>The metadata you add through this variable includes config fragments and 5840 </para>
5841
5842 <para>
5843 The metadata you add through this variable includes config fragments and
5721 features descriptions, 5844 features descriptions,
5722 which usually includes patches as well as config fragments. 5845 which usually includes patches as well as config fragments.
5723 You typically override the <filename>KERNEL_FEATURES</filename> variable 5846 You typically override the <filename>KERNEL_FEATURES</filename> variable
5724 for a specific machine. 5847 for a specific machine.
5725 In this way, you can provide validated, but optional, sets of kernel 5848 In this way, you can provide validated, but optional, sets of kernel
5726 configurations and features.</para> 5849 configurations and features.
5727 <para>For example, the following adds <filename>netfilter</filename> to all 5850 </para>
5851
5852 <para>
5853 For example, the following adds <filename>netfilter</filename> to all
5728 the Yocto Project kernels and adds sound support to the <filename>qemux86</filename> 5854 the Yocto Project kernels and adds sound support to the <filename>qemux86</filename>
5729 machine: 5855 machine:
5730 <literallayout class='monospaced'> 5856 <literallayout class='monospaced'>
@@ -5737,12 +5863,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5737 </glossdef> 5863 </glossdef>
5738 </glossentry> 5864 </glossentry>
5739 5865
5740 <glossentry id='var-KERNEL_IMAGE_BASE_NAME'><glossterm>KERNEL_IMAGE_BASE_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 5866 <glossentry id='var-KERNEL_IMAGE_BASE_NAME'><glossterm>KERNEL_IMAGE_BASE_NAME</glossterm>
5741 <info> 5867 <info>
5742 KERNEL_IMAGE_BASE_NAME[doc] = "The base name of the kernel image." 5868 KERNEL_IMAGE_BASE_NAME[doc] = "The base name of the kernel image."
5743 </info> 5869 </info>
5744 <glossdef> 5870 <glossdef>
5745 <para> 5871 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5746 The base name of the kernel image. 5872 The base name of the kernel image.
5747 This variable is set in the 5873 This variable is set in the
5748 <link linkend='ref-classes-kernel'>kernel</link> class 5874 <link linkend='ref-classes-kernel'>kernel</link> class
@@ -5750,6 +5876,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5750 <literallayout class='monospaced'> 5876 <literallayout class='monospaced'>
5751 KERNEL_IMAGE_BASE_NAME ?= "${KERNEL_IMAGETYPE}-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}" 5877 KERNEL_IMAGE_BASE_NAME ?= "${KERNEL_IMAGETYPE}-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"
5752 </literallayout> 5878 </literallayout>
5879 </para>
5880
5881 <para>
5753 See the 5882 See the
5754 <link linkend='var-KERNEL_IMAGETYPE'><filename>KERNEL_IMAGETYPE</filename></link>, 5883 <link linkend='var-KERNEL_IMAGETYPE'><filename>KERNEL_IMAGETYPE</filename></link>,
5755 <link linkend='var-PKGE'><filename>PKGE</filename></link>, 5884 <link linkend='var-PKGE'><filename>PKGE</filename></link>,
@@ -5763,12 +5892,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5763 </glossdef> 5892 </glossdef>
5764 </glossentry> 5893 </glossentry>
5765 5894
5766 <glossentry id='var-KERNEL_IMAGE_MAXSIZE'><glossterm>KERNEL_IMAGE_MAXSIZE<imagedata fileref="figures/define-generic.png" /></glossterm> 5895 <glossentry id='var-KERNEL_IMAGE_MAXSIZE'><glossterm>KERNEL_IMAGE_MAXSIZE</glossterm>
5767 <info> 5896 <info>
5768 KERNEL_IMAGE_MAXSIZE[doc] = "The maximum allowable size in kilobytes of the kernel image file." 5897 KERNEL_IMAGE_MAXSIZE[doc] = "The maximum allowable size in kilobytes of the kernel image file."
5769 </info> 5898 </info>
5770 <glossdef> 5899 <glossdef>
5771 <para> 5900 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5772 Specifies the maximum size of the kernel image file in 5901 Specifies the maximum size of the kernel image file in
5773 kilobytes. 5902 kilobytes.
5774 If <filename>KERNEL_IMAGE_MAXSIZE</filename> is set, 5903 If <filename>KERNEL_IMAGE_MAXSIZE</filename> is set,
@@ -5793,25 +5922,27 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5793 </glossdef> 5922 </glossdef>
5794 </glossentry> 5923 </glossentry>
5795 5924
5796 <glossentry id='var-KERNEL_IMAGETYPE'><glossterm>KERNEL_IMAGETYPE<imagedata fileref="figures/define-generic.png" /></glossterm> 5925 <glossentry id='var-KERNEL_IMAGETYPE'><glossterm>KERNEL_IMAGETYPE</glossterm>
5797 <info> 5926 <info>
5798 KERNEL_IMAGETYPE[doc] = "The type of kernel to build for a device, usually set by the machine configuration files and defaults to 'zImage'." 5927 KERNEL_IMAGETYPE[doc] = "The type of kernel to build for a device, usually set by the machine configuration files and defaults to 'zImage'."
5799 </info> 5928 </info>
5800 <glossdef> 5929 <glossdef>
5801 <para>The type of kernel to build for a device, usually set by the 5930 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5931 The type of kernel to build for a device, usually set by the
5802 machine configuration files and defaults to "zImage". 5932 machine configuration files and defaults to "zImage".
5803 This variable is used 5933 This variable is used
5804 when building the kernel and is passed to <filename>make</filename> as the target to 5934 when building the kernel and is passed to <filename>make</filename> as the target to
5805 build.</para> 5935 build.
5936 </para>
5806 </glossdef> 5937 </glossdef>
5807 </glossentry> 5938 </glossentry>
5808 5939
5809 <glossentry id='var-KERNEL_MODULE_AUTOLOAD'><glossterm>KERNEL_MODULE_AUTOLOAD<imagedata fileref="figures/define-generic.png" /></glossterm> 5940 <glossentry id='var-KERNEL_MODULE_AUTOLOAD'><glossterm>KERNEL_MODULE_AUTOLOAD</glossterm>
5810 <info> 5941 <info>
5811 KERNEL_MODULE_AUTOLOAD[doc] = "Lists kernel modules that need to be auto-loaded during boot" 5942 KERNEL_MODULE_AUTOLOAD[doc] = "Lists kernel modules that need to be auto-loaded during boot"
5812 </info> 5943 </info>
5813 <glossdef> 5944 <glossdef>
5814 <para> 5945 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5815 Lists kernel modules that need to be auto-loaded during 5946 Lists kernel modules that need to be auto-loaded during
5816 boot. 5947 boot.
5817 <note> 5948 <note>
@@ -5859,12 +5990,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5859 </glossdef> 5990 </glossdef>
5860 </glossentry> 5991 </glossentry>
5861 5992
5862 <glossentry id='var-KERNEL_MODULE_PROBECONF'><glossterm>KERNEL_MODULE_PROBECONF<imagedata fileref="figures/define-generic.png" /></glossterm> 5993 <glossentry id='var-KERNEL_MODULE_PROBECONF'><glossterm>KERNEL_MODULE_PROBECONF</glossterm>
5863 <info> 5994 <info>
5864 KERNEL_MODULE_PROBECONF[doc] = "Lists kernel modules for which the build system expects to find module_conf_* values that specify configuration for each of the modules." 5995 KERNEL_MODULE_PROBECONF[doc] = "Lists kernel modules for which the build system expects to find module_conf_* values that specify configuration for each of the modules."
5865 </info> 5996 </info>
5866 <glossdef> 5997 <glossdef>
5867 <para> 5998 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5868 Provides a list of modules for which the OpenEmbedded 5999 Provides a list of modules for which the OpenEmbedded
5869 build system expects to find 6000 build system expects to find
5870 <filename>module_conf_</filename><replaceable>modname</replaceable> 6001 <filename>module_conf_</filename><replaceable>modname</replaceable>
@@ -5877,12 +6008,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5877 </glossdef> 6008 </glossdef>
5878 </glossentry> 6009 </glossentry>
5879 6010
5880 <glossentry id='var-KERNEL_PATH'><glossterm>KERNEL_PATH<imagedata fileref="figures/define-generic.png" /></glossterm> 6011 <glossentry id='var-KERNEL_PATH'><glossterm>KERNEL_PATH</glossterm>
5881 <info> 6012 <info>
5882 KERNEL_PATH[doc] = "The location of the kernel sources. This variable is set to the value of the STAGING_KERNEL_DIR within the module class (module.bbclass)." 6013 KERNEL_PATH[doc] = "The location of the kernel sources. This variable is set to the value of the STAGING_KERNEL_DIR within the module class (module.bbclass)."
5883 </info> 6014 </info>
5884 <glossdef> 6015 <glossdef>
5885 <para> 6016 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5886 The location of the kernel sources. 6017 The location of the kernel sources.
5887 This variable is set to the value of the 6018 This variable is set to the value of the
5888 <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> 6019 <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link>
@@ -5907,12 +6038,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5907 </glossdef> 6038 </glossdef>
5908 </glossentry> 6039 </glossentry>
5909 6040
5910 <glossentry id='var-KERNEL_SRC'><glossterm>KERNEL_SRC<imagedata fileref="figures/define-generic.png" /></glossterm> 6041 <glossentry id='var-KERNEL_SRC'><glossterm>KERNEL_SRC</glossterm>
5911 <info> 6042 <info>
5912 KERNEL_SRC[doc] = "The location of the kernel sources. This variable is set to the value of the STAGING_KERNEL_DIR within the module class (module.bbclass)." 6043 KERNEL_SRC[doc] = "The location of the kernel sources. This variable is set to the value of the STAGING_KERNEL_DIR within the module class (module.bbclass)."
5913 </info> 6044 </info>
5914 <glossdef> 6045 <glossdef>
5915 <para> 6046 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5916 The location of the kernel sources. 6047 The location of the kernel sources.
5917 This variable is set to the value of the 6048 This variable is set to the value of the
5918 <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> 6049 <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link>
@@ -5937,12 +6068,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5937 </glossdef> 6068 </glossdef>
5938 </glossentry> 6069 </glossentry>
5939 6070
5940 <glossentry id='var-KFEATURE_DESCRIPTION'><glossterm>KFEATURE_DESCRIPTION<imagedata fileref="figures/define-generic.png" /></glossterm> 6071 <glossentry id='var-KFEATURE_DESCRIPTION'><glossterm>KFEATURE_DESCRIPTION</glossterm>
5941 <info> 6072 <info>
5942 KFEATURE_DESCRIPTION[doc] = "Provides a short description of a configuration fragment. You use this variable in the .scc file that describes a configuration fragment file." 6073 KFEATURE_DESCRIPTION[doc] = "Provides a short description of a configuration fragment. You use this variable in the .scc file that describes a configuration fragment file."
5943 </info> 6074 </info>
5944 <glossdef> 6075 <glossdef>
5945 <para> 6076 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5946 Provides a short description of a configuration fragment. 6077 Provides a short description of a configuration fragment.
5947 You use this variable in the <filename>.scc</filename> 6078 You use this variable in the <filename>.scc</filename>
5948 file that describes a configuration fragment file. 6079 file that describes a configuration fragment file.
@@ -5956,12 +6087,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5956 </glossdef> 6087 </glossdef>
5957 </glossentry> 6088 </glossentry>
5958 6089
5959 <glossentry id='var-KMACHINE'><glossterm>KMACHINE<imagedata fileref="figures/define-generic.png" /></glossterm> 6090 <glossentry id='var-KMACHINE'><glossterm>KMACHINE</glossterm>
5960 <info> 6091 <info>
5961 KMACHINE[doc] = "The machine as known by the kernel." 6092 KMACHINE[doc] = "The machine as known by the kernel."
5962 </info> 6093 </info>
5963 <glossdef> 6094 <glossdef>
5964 <para> 6095 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
5965 The machine as known by the kernel. 6096 The machine as known by the kernel.
5966 Sometimes the machine name used by the kernel does not match the machine name 6097 Sometimes the machine name used by the kernel does not match the machine name
5967 used by the OpenEmbedded build system. 6098 used by the OpenEmbedded build system.
@@ -6052,12 +6183,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6052 </glossdef> 6183 </glossdef>
6053 </glossentry> 6184 </glossentry>
6054 6185
6055 <glossentry id='var-KTYPE'><glossterm>KTYPE<imagedata fileref="figures/define-generic.png" /></glossterm> 6186 <glossentry id='var-KTYPE'><glossterm>KTYPE</glossterm>
6056 <info> 6187 <info>
6057 KTYPE[doc] = "Defines the kernel type to be used in assembling the configuration." 6188 KTYPE[doc] = "Defines the kernel type to be used in assembling the configuration."
6058 </info> 6189 </info>
6059 <glossdef> 6190 <glossdef>
6060 <para> 6191 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6061 Defines the kernel type to be used in assembling the 6192 Defines the kernel type to be used in assembling the
6062 configuration. 6193 configuration.
6063 The linux-yocto recipes define "standard", "tiny", 6194 The linux-yocto recipes define "standard", "tiny",
@@ -6081,12 +6212,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6081 6212
6082 <glossdiv id='var-glossary-l'><title>L</title> 6213 <glossdiv id='var-glossary-l'><title>L</title>
6083 6214
6084 <glossentry id='var-LABELS'><glossterm>LABELS<imagedata fileref="figures/define-generic.png" /></glossterm> 6215 <glossentry id='var-LABELS'><glossterm>LABELS</glossterm>
6085 <info> 6216 <info>
6086 LABELS[doc] = "Provides a list of targets for automatic configuration." 6217 LABELS[doc] = "Provides a list of targets for automatic configuration."
6087 </info> 6218 </info>
6088 <glossdef> 6219 <glossdef>
6089 <para> 6220 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6090 Provides a list of targets for automatic configuration. 6221 Provides a list of targets for automatic configuration.
6091 </para> 6222 </para>
6092 6223
@@ -6098,12 +6229,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6098 </glossdef> 6229 </glossdef>
6099 </glossentry> 6230 </glossentry>
6100 6231
6101 <glossentry id='var-LAYERDEPENDS'><glossterm>LAYERDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 6232 <glossentry id='var-LAYERDEPENDS'><glossterm>LAYERDEPENDS</glossterm>
6102 <info> 6233 <info>
6103 LAYERDEPENDS[doc] = "Lists the layers, separated by spaces, upon which this recipe depends. This variable is used in the conf/layer.conf file and must be suffixed with the name of the specific layer." 6234 LAYERDEPENDS[doc] = "Lists the layers, separated by spaces, upon which this recipe depends. This variable is used in the conf/layer.conf file and must be suffixed with the name of the specific layer."
6104 </info> 6235 </info>
6105 <glossdef> 6236 <glossdef>
6106 <para>Lists the layers that this recipe depends upon, separated by spaces. 6237 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6238 Lists the layers that this recipe depends upon, separated by spaces.
6107 Optionally, you can specify a specific layer version for a dependency 6239 Optionally, you can specify a specific layer version for a dependency
6108 by adding it to the end of the layer name with a colon, (e.g. "anotherlayer:3" 6240 by adding it to the end of the layer name with a colon, (e.g. "anotherlayer:3"
6109 to be compared against 6241 to be compared against
@@ -6113,56 +6245,61 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6113 the version numbers do not match exactly (if specified). 6245 the version numbers do not match exactly (if specified).
6114 This variable is used in the <filename>conf/layer.conf</filename> file 6246 This variable is used in the <filename>conf/layer.conf</filename> file
6115 and must be suffixed with the name of the specific layer (e.g. 6247 and must be suffixed with the name of the specific layer (e.g.
6116 <filename>LAYERDEPENDS_mylayer</filename>).</para> 6248 <filename>LAYERDEPENDS_mylayer</filename>).
6249 </para>
6117 </glossdef> 6250 </glossdef>
6118 </glossentry> 6251 </glossentry>
6119 6252
6120 <glossentry id='var-LAYERDIR'><glossterm>LAYERDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 6253 <glossentry id='var-LAYERDIR'><glossterm>LAYERDIR</glossterm>
6121 <info> 6254 <info>
6122 LAYERDIR[doc] = "When used inside the layer.conf configuration file, this variable provides the path of the current layer." 6255 LAYERDIR[doc] = "When used inside the layer.conf configuration file, this variable provides the path of the current layer."
6123 </info> 6256 </info>
6124 <glossdef> 6257 <glossdef>
6125 <para>When used inside the <filename>layer.conf</filename> configuration 6258 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6259 When used inside the <filename>layer.conf</filename> configuration
6126 file, this variable provides the path of the current layer. 6260 file, this variable provides the path of the current layer.
6127 This variable is not available outside of <filename>layer.conf</filename> 6261 This variable is not available outside of <filename>layer.conf</filename>
6128 and references are expanded immediately when parsing of the file completes.</para> 6262 and references are expanded immediately when parsing of the file completes.
6263 </para>
6129 </glossdef> 6264 </glossdef>
6130 </glossentry> 6265 </glossentry>
6131 6266
6132 <glossentry id='var-LAYERVERSION'><glossterm>LAYERVERSION<imagedata fileref="figures/define-generic.png" /></glossterm> 6267 <glossentry id='var-LAYERVERSION'><glossterm>LAYERVERSION</glossterm>
6133 <info> 6268 <info>
6134 LAYERVERSION[doc] = "Optionally specifies the version of a layer as a single number. This variable is used in the conf/layer.conf file and must be suffixed with the name of the specific layer." 6269 LAYERVERSION[doc] = "Optionally specifies the version of a layer as a single number. This variable is used in the conf/layer.conf file and must be suffixed with the name of the specific layer."
6135 </info> 6270 </info>
6136 <glossdef> 6271 <glossdef>
6137 <para>Optionally specifies the version of a layer as a single number. 6272 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6273 Optionally specifies the version of a layer as a single number.
6138 You can use this within 6274 You can use this within
6139 <link linkend='var-LAYERDEPENDS'><filename>LAYERDEPENDS</filename></link> 6275 <link linkend='var-LAYERDEPENDS'><filename>LAYERDEPENDS</filename></link>
6140 for another layer in order to depend on a specific version 6276 for another layer in order to depend on a specific version
6141 of the layer. 6277 of the layer.
6142 This variable is used in the <filename>conf/layer.conf</filename> file 6278 This variable is used in the <filename>conf/layer.conf</filename> file
6143 and must be suffixed with the name of the specific layer (e.g. 6279 and must be suffixed with the name of the specific layer (e.g.
6144 <filename>LAYERVERSION_mylayer</filename>).</para> 6280 <filename>LAYERVERSION_mylayer</filename>).
6281 </para>
6145 </glossdef> 6282 </glossdef>
6146 </glossentry> 6283 </glossentry>
6147 6284
6148 <glossentry id='var-LD'><glossterm>LD<imagedata fileref="figures/define-generic.png" /></glossterm> 6285 <glossentry id='var-LD'><glossterm>LD</glossterm>
6149 <info> 6286 <info>
6150 LD[doc] = "Minimal command and arguments to run the linker." 6287 LD[doc] = "Minimal command and arguments to run the linker."
6151 </info> 6288 </info>
6152 <glossdef> 6289 <glossdef>
6153 <para> 6290 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6154 The minimal command and arguments used to run the 6291 The minimal command and arguments used to run the
6155 linker. 6292 linker.
6156 </para> 6293 </para>
6157 </glossdef> 6294 </glossdef>
6158 </glossentry> 6295 </glossentry>
6159 6296
6160 <glossentry id='var-LDFLAGS'><glossterm>LDFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 6297 <glossentry id='var-LDFLAGS'><glossterm>LDFLAGS</glossterm>
6161 <info> 6298 <info>
6162 LDFLAGS[doc] = "Specifies the flags to pass to the linker." 6299 LDFLAGS[doc] = "Specifies the flags to pass to the linker."
6163 </info> 6300 </info>
6164 <glossdef> 6301 <glossdef>
6165 <para> 6302 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6166 Specifies the flags to pass to the linker. 6303 Specifies the flags to pass to the linker.
6167 This variable is exported to an environment 6304 This variable is exported to an environment
6168 variable and thus made visible to the software being 6305 variable and thus made visible to the software being
@@ -6192,12 +6329,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6192 </glossdef> 6329 </glossdef>
6193 </glossentry> 6330 </glossentry>
6194 6331
6195 <glossentry id='var-LEAD_SONAME'><glossterm>LEAD_SONAME<imagedata fileref="figures/define-generic.png" /></glossterm> 6332 <glossentry id='var-LEAD_SONAME'><glossterm>LEAD_SONAME</glossterm>
6196 <info> 6333 <info>
6197 LEAD_SONAME[doc] = "Specifies the lead (or primary) compiled library file (.so) that the debian class applies its naming policy to given a recipe that packages multiple libraries." 6334 LEAD_SONAME[doc] = "Specifies the lead (or primary) compiled library file (.so) that the debian class applies its naming policy to given a recipe that packages multiple libraries."
6198 </info> 6335 </info>
6199 <glossdef> 6336 <glossdef>
6200 <para> 6337 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6201 Specifies the lead (or primary) compiled library file 6338 Specifies the lead (or primary) compiled library file
6202 (<filename>.so</filename>) that the 6339 (<filename>.so</filename>) that the
6203 <link linkend='ref-classes-debian'><filename>debian</filename></link> 6340 <link linkend='ref-classes-debian'><filename>debian</filename></link>
@@ -6212,33 +6349,37 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6212 </glossdef> 6349 </glossdef>
6213 </glossentry> 6350 </glossentry>
6214 6351
6215 <glossentry id='var-LIC_FILES_CHKSUM'><glossterm>LIC_FILES_CHKSUM<imagedata fileref="figures/define-generic.png" /></glossterm> 6352 <glossentry id='var-LIC_FILES_CHKSUM'><glossterm>LIC_FILES_CHKSUM</glossterm>
6216 <info> 6353 <info>
6217 LIC_FILES_CHKSUM[doc] = "Checksums of the license text in the recipe source code." 6354 LIC_FILES_CHKSUM[doc] = "Checksums of the license text in the recipe source code."
6218 </info> 6355 </info>
6219 <glossdef> 6356 <glossdef>
6220 <para>Checksums of the license text in the recipe source code.</para> 6357 <para>Checksums of the license text in the recipe source code.</para>
6221 <para>This variable tracks changes in license text of the source 6358 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6359 This variable tracks changes in license text of the source
6222 code files. 6360 code files.
6223 If the license text is changed, it will trigger a build 6361 If the license text is changed, it will trigger a build
6224 failure, which gives the developer an opportunity to review any 6362 failure, which gives the developer an opportunity to review any
6225 license change.</para> 6363 license change.
6364 </para>
6365
6226 <para> 6366 <para>
6227 This variable must be defined for all recipes (unless 6367 This variable must be defined for all recipes (unless
6228 <link linkend='var-LICENSE'><filename>LICENSE</filename></link> 6368 <link linkend='var-LICENSE'><filename>LICENSE</filename></link>
6229 is set to "CLOSED").</para> 6369 is set to "CLOSED").</para>
6230 <para>For more information, see the 6370 <para>For more information, see the
6231 "<link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'> 6371 "<link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'>
6232 Tracking License Changes</link>" section.</para> 6372 Tracking License Changes</link>" section.
6373 </para>
6233 </glossdef> 6374 </glossdef>
6234 </glossentry> 6375 </glossentry>
6235 6376
6236 <glossentry id='var-LICENSE'><glossterm>LICENSE<imagedata fileref="figures/define-generic.png" /></glossterm> 6377 <glossentry id='var-LICENSE'><glossterm>LICENSE</glossterm>
6237 <info> 6378 <info>
6238 LICENSE[doc] = "The list of source licenses for the recipe. The logical operators &amp;, '|', and parentheses can be used." 6379 LICENSE[doc] = "The list of source licenses for the recipe. The logical operators &amp;, '|', and parentheses can be used."
6239 </info> 6380 </info>
6240 <glossdef> 6381 <glossdef>
6241 <para> 6382 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6242 The list of source licenses for the recipe. 6383 The list of source licenses for the recipe.
6243 Follow these rules: 6384 Follow these rules:
6244 <itemizedlist> 6385 <itemizedlist>
@@ -6297,12 +6438,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6297 </glossdef> 6438 </glossdef>
6298 </glossentry> 6439 </glossentry>
6299 6440
6300 <glossentry id='var-LICENSE_FLAGS'><glossterm>LICENSE_FLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 6441 <glossentry id='var-LICENSE_FLAGS'><glossterm>LICENSE_FLAGS</glossterm>
6301 <info> 6442 <info>
6302 LICENSE_FLAGS[doc] = "Specifies additional flags for a recipe you must whitelist through LICENSE_FLAGS_WHITELIST in order to allow the recipe to be built." 6443 LICENSE_FLAGS[doc] = "Specifies additional flags for a recipe you must whitelist through LICENSE_FLAGS_WHITELIST in order to allow the recipe to be built."
6303 </info> 6444 </info>
6304 <glossdef> 6445 <glossdef>
6305 <para> 6446 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6306 Specifies additional flags for a recipe you must 6447 Specifies additional flags for a recipe you must
6307 whitelist through 6448 whitelist through
6308 <link linkend='var-LICENSE_FLAGS_WHITELIST'><filename>LICENSE_FLAGS_WHITELIST</filename></link> 6449 <link linkend='var-LICENSE_FLAGS_WHITELIST'><filename>LICENSE_FLAGS_WHITELIST</filename></link>
@@ -6324,12 +6465,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6324 </glossdef> 6465 </glossdef>
6325 </glossentry> 6466 </glossentry>
6326 6467
6327 <glossentry id='var-LICENSE_FLAGS_WHITELIST'><glossterm>LICENSE_FLAGS_WHITELIST<imagedata fileref="figures/define-generic.png" /></glossterm> 6468 <glossentry id='var-LICENSE_FLAGS_WHITELIST'><glossterm>LICENSE_FLAGS_WHITELIST</glossterm>
6328 <info> 6469 <info>
6329 LICENSE_FLAGS_WHITELIST[doc] = "Lists license flags that when specified in LICENSE_FLAGS within a recipe should not prevent that recipe from being built." 6470 LICENSE_FLAGS_WHITELIST[doc] = "Lists license flags that when specified in LICENSE_FLAGS within a recipe should not prevent that recipe from being built."
6330 </info> 6471 </info>
6331 <glossdef> 6472 <glossdef>
6332 <para> 6473 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6333 Lists license flags that when specified in 6474 Lists license flags that when specified in
6334 <link linkend='var-LICENSE_FLAGS'><filename>LICENSE_FLAGS</filename></link> 6475 <link linkend='var-LICENSE_FLAGS'><filename>LICENSE_FLAGS</filename></link>
6335 within a recipe should not prevent that recipe from being 6476 within a recipe should not prevent that recipe from being
@@ -6343,28 +6484,30 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6343 </glossdef> 6484 </glossdef>
6344 </glossentry> 6485 </glossentry>
6345 6486
6346 <glossentry id='var-LICENSE_PATH'><glossterm>LICENSE_PATH<imagedata fileref="figures/define-generic.png" /></glossterm> 6487 <glossentry id='var-LICENSE_PATH'><glossterm>LICENSE_PATH</glossterm>
6347 <info> 6488 <info>
6348 LICENSE_PATH[doc] = "Path to additional licenses used during the build." 6489 LICENSE_PATH[doc] = "Path to additional licenses used during the build."
6349 </info> 6490 </info>
6350 <glossdef> 6491 <glossdef>
6351 <para>Path to additional licenses used during the build. 6492 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6493 Path to additional licenses used during the build.
6352 By default, the OpenEmbedded build system uses <filename>COMMON_LICENSE_DIR</filename> 6494 By default, the OpenEmbedded build system uses <filename>COMMON_LICENSE_DIR</filename>
6353 to define the directory that holds common license text used during the build. 6495 to define the directory that holds common license text used during the build.
6354 The <filename>LICENSE_PATH</filename> variable allows you to extend that 6496 The <filename>LICENSE_PATH</filename> variable allows you to extend that
6355 location to other areas that have additional licenses: 6497 location to other areas that have additional licenses:
6356 <literallayout class='monospaced'> 6498 <literallayout class='monospaced'>
6357 LICENSE_PATH += "<replaceable>path-to-additional-common-licenses</replaceable>" 6499 LICENSE_PATH += "<replaceable>path-to-additional-common-licenses</replaceable>"
6358 </literallayout></para> 6500 </literallayout>
6501 </para>
6359 </glossdef> 6502 </glossdef>
6360 </glossentry> 6503 </glossentry>
6361 6504
6362 <glossentry id='var-LINUX_KERNEL_TYPE'><glossterm>LINUX_KERNEL_TYPE<imagedata fileref="figures/define-generic.png" /></glossterm> 6505 <glossentry id='var-LINUX_KERNEL_TYPE'><glossterm>LINUX_KERNEL_TYPE</glossterm>
6363 <info> 6506 <info>
6364 LINUX_KERNEL_TYPE[doc] = "Defines the kernel type to be used in assembling the configuration." 6507 LINUX_KERNEL_TYPE[doc] = "Defines the kernel type to be used in assembling the configuration."
6365 </info> 6508 </info>
6366 <glossdef> 6509 <glossdef>
6367 <para> 6510 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6368 Defines the kernel type to be used in assembling the 6511 Defines the kernel type to be used in assembling the
6369 configuration. 6512 configuration.
6370 The linux-yocto recipes define "standard", "tiny", and 6513 The linux-yocto recipes define "standard", "tiny", and
@@ -6391,12 +6534,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6391 </glossdef> 6534 </glossdef>
6392 </glossentry> 6535 </glossentry>
6393 6536
6394 <glossentry id='var-LINUX_VERSION'><glossterm>LINUX_VERSION<imagedata fileref="figures/define-generic.png" /></glossterm> 6537 <glossentry id='var-LINUX_VERSION'><glossterm>LINUX_VERSION</glossterm>
6395 <info> 6538 <info>
6396 LINUX_VERSION[doc] = "The Linux version from kernel.org on which the Linux kernel image being built using the OpenEmbedded build system is based. You define this variable in the kernel recipe." 6539 LINUX_VERSION[doc] = "The Linux version from kernel.org on which the Linux kernel image being built using the OpenEmbedded build system is based. You define this variable in the kernel recipe."
6397 </info> 6540 </info>
6398 <glossdef> 6541 <glossdef>
6399 <para>The Linux version from <filename>kernel.org</filename> 6542 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6543 The Linux version from <filename>kernel.org</filename>
6400 on which the Linux kernel image being built using the 6544 on which the Linux kernel image being built using the
6401 OpenEmbedded build system is based. 6545 OpenEmbedded build system is based.
6402 You define this variable in the kernel recipe. 6546 You define this variable in the kernel recipe.
@@ -6407,21 +6551,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6407 <literallayout class='monospaced'> 6551 <literallayout class='monospaced'>
6408 LINUX_VERSION ?= "3.4.24" 6552 LINUX_VERSION ?= "3.4.24"
6409 </literallayout> 6553 </literallayout>
6554 </para>
6555
6556 <para>
6410 The <filename>LINUX_VERSION</filename> variable is used to 6557 The <filename>LINUX_VERSION</filename> variable is used to
6411 define <link linkend='var-PV'><filename>PV</filename></link> 6558 define <link linkend='var-PV'><filename>PV</filename></link>
6412 for the recipe: 6559 for the recipe:
6413 <literallayout class='monospaced'> 6560 <literallayout class='monospaced'>
6414 PV = "${LINUX_VERSION}+git${SRCPV}" 6561 PV = "${LINUX_VERSION}+git${SRCPV}"
6415 </literallayout></para> 6562 </literallayout>
6563 </para>
6416 </glossdef> 6564 </glossdef>
6417 </glossentry> 6565 </glossentry>
6418 6566
6419 <glossentry id='var-LINUX_VERSION_EXTENSION'><glossterm>LINUX_VERSION_EXTENSION<imagedata fileref="figures/define-generic.png" /></glossterm> 6567 <glossentry id='var-LINUX_VERSION_EXTENSION'><glossterm>LINUX_VERSION_EXTENSION</glossterm>
6420 <info> 6568 <info>
6421 LINUX_VERSION_EXTENSION[doc] = "A string extension compiled into the version string of the Linux kernel built with the OpenEmbedded build system. You define this variable in the kernel recipe." 6569 LINUX_VERSION_EXTENSION[doc] = "A string extension compiled into the version string of the Linux kernel built with the OpenEmbedded build system. You define this variable in the kernel recipe."
6422 </info> 6570 </info>
6423 <glossdef> 6571 <glossdef>
6424 <para>A string extension compiled into the version 6572 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6573 A string extension compiled into the version
6425 string of the Linux kernel built with the OpenEmbedded 6574 string of the Linux kernel built with the OpenEmbedded
6426 build system. 6575 build system.
6427 You define this variable in the kernel recipe. 6576 You define this variable in the kernel recipe.
@@ -6430,6 +6579,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6430 <literallayout class='monospaced'> 6579 <literallayout class='monospaced'>
6431 LINUX_VERSION_EXTENSION ?= "-yocto-${<link linkend='var-LINUX_KERNEL_TYPE'>LINUX_KERNEL_TYPE</link>}" 6580 LINUX_VERSION_EXTENSION ?= "-yocto-${<link linkend='var-LINUX_KERNEL_TYPE'>LINUX_KERNEL_TYPE</link>}"
6432 </literallayout> 6581 </literallayout>
6582 </para>
6583
6584 <para>
6433 Defining this variable essentially sets the 6585 Defining this variable essentially sets the
6434 Linux kernel configuration item 6586 Linux kernel configuration item
6435 <filename>CONFIG_LOCALVERSION</filename>, which is visible 6587 <filename>CONFIG_LOCALVERSION</filename>, which is visible
@@ -6444,16 +6596,17 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6444 </glossdef> 6596 </glossdef>
6445 </glossentry> 6597 </glossentry>
6446 6598
6447 <glossentry id='var-LOG_DIR'><glossterm>LOG_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 6599 <glossentry id='var-LOG_DIR'><glossterm>LOG_DIR</glossterm>
6448 <info> 6600 <info>
6449 LOG_DIR[doc] = "Specifies the directory to which the OpenEmbedded build system writes overall log files. The default directory is ${TMPDIR}/log" 6601 LOG_DIR[doc] = "Specifies the directory to which the OpenEmbedded build system writes overall log files. The default directory is ${TMPDIR}/log"
6450 </info> 6602 </info>
6451 <glossdef> 6603 <glossdef>
6452 <para> 6604 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6453 Specifies the directory to which the OpenEmbedded build 6605 Specifies the directory to which the OpenEmbedded build
6454 system writes overall log files. 6606 system writes overall log files.
6455 The default directory is <filename>${TMPDIR}/log</filename>. 6607 The default directory is <filename>${TMPDIR}/log</filename>.
6456 </para> 6608 </para>
6609
6457 <para> 6610 <para>
6458 For the directory containing logs specific to each task, 6611 For the directory containing logs specific to each task,
6459 see the <link linkend='var-T'><filename>T</filename></link> 6612 see the <link linkend='var-T'><filename>T</filename></link>
@@ -6466,12 +6619,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6466 6619
6467 <glossdiv id='var-glossary-m'><title>M</title> 6620 <glossdiv id='var-glossary-m'><title>M</title>
6468 6621
6469 <glossentry id='var-MACHINE'><glossterm>MACHINE<imagedata fileref="figures/define-generic.png" /></glossterm> 6622 <glossentry id='var-MACHINE'><glossterm>MACHINE</glossterm>
6470 <info> 6623 <info>
6471 MACHINE[doc] = "Specifies the target device for which the image is built. You define MACHINE in the conf/local.conf file in the Build Directory." 6624 MACHINE[doc] = "Specifies the target device for which the image is built. You define MACHINE in the conf/local.conf file in the Build Directory."
6472 </info> 6625 </info>
6473 <glossdef> 6626 <glossdef>
6474 <para> 6627 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6475 Specifies the target device for which the image is built. 6628 Specifies the target device for which the image is built.
6476 You define <filename>MACHINE</filename> in the 6629 You define <filename>MACHINE</filename> in the
6477 <filename>local.conf</filename> file found in the 6630 <filename>local.conf</filename> file found in the
@@ -6482,6 +6635,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6482 <literallayout class='monospaced'> 6635 <literallayout class='monospaced'>
6483 MACHINE ?= "qemux86" 6636 MACHINE ?= "qemux86"
6484 </literallayout> 6637 </literallayout>
6638 </para>
6639
6640 <para>
6485 The variable corresponds to a machine configuration file of the 6641 The variable corresponds to a machine configuration file of the
6486 same name, through which machine-specific configurations are set. 6642 same name, through which machine-specific configurations are set.
6487 Thus, when <filename>MACHINE</filename> is set to "qemux86" there 6643 Thus, when <filename>MACHINE</filename> is set to "qemux86" there
@@ -6516,12 +6672,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6516 </glossdef> 6672 </glossdef>
6517 </glossentry> 6673 </glossentry>
6518 6674
6519 <glossentry id='var-MACHINE_ARCH'><glossterm>MACHINE_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 6675 <glossentry id='var-MACHINE_ARCH'><glossterm>MACHINE_ARCH</glossterm>
6520 <info> 6676 <info>
6521 MACHINE_ARCH[doc] = "Specifies the name of the machine-specific architecture. This variable is set automatically from MACHINE or TUNE_PKGARCH." 6677 MACHINE_ARCH[doc] = "Specifies the name of the machine-specific architecture. This variable is set automatically from MACHINE or TUNE_PKGARCH."
6522 </info> 6678 </info>
6523 <glossdef> 6679 <glossdef>
6524 <para> 6680 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6525 Specifies the name of the machine-specific architecture. 6681 Specifies the name of the machine-specific architecture.
6526 This variable is set automatically from 6682 This variable is set automatically from
6527 <link linkend='var-MACHINE'><filename>MACHINE</filename></link> 6683 <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
@@ -6533,12 +6689,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6533 </glossdef> 6689 </glossdef>
6534 </glossentry> 6690 </glossentry>
6535 6691
6536 <glossentry id='var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'><glossterm>MACHINE_ESSENTIAL_EXTRA_RDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 6692 <glossentry id='var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'><glossterm>MACHINE_ESSENTIAL_EXTRA_RDEPENDS</glossterm>
6537 <info> 6693 <info>
6538 MACHINE_ESSENTIAL_EXTRA_RDEPENDS[doc] = "A list of required machine-specific packages to install as part of the image being built. Because this is a 'machine essential' variable, the list of packages are essential for the machine to boot." 6694 MACHINE_ESSENTIAL_EXTRA_RDEPENDS[doc] = "A list of required machine-specific packages to install as part of the image being built. Because this is a 'machine essential' variable, the list of packages are essential for the machine to boot."
6539 </info> 6695 </info>
6540 <glossdef> 6696 <glossdef>
6541 <para> 6697 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6542 A list of required machine-specific packages to install as part of 6698 A list of required machine-specific packages to install as part of
6543 the image being built. 6699 the image being built.
6544 The build process depends on these packages being present. 6700 The build process depends on these packages being present.
@@ -6548,6 +6704,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6548 <filename>packagegroup-core-boot</filename>, 6704 <filename>packagegroup-core-boot</filename>,
6549 including the <filename>core-image-minimal</filename> image. 6705 including the <filename>core-image-minimal</filename> image.
6550 </para> 6706 </para>
6707
6551 <para> 6708 <para>
6552 This variable is similar to the 6709 This variable is similar to the
6553 <filename><link linkend='var-MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS'>MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS</link></filename> 6710 <filename><link linkend='var-MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS'>MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS</link></filename>
@@ -6555,6 +6712,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6555 dependency on the variable's list of packages. 6712 dependency on the variable's list of packages.
6556 In other words, the image will not build if a file in this list is not found. 6713 In other words, the image will not build if a file in this list is not found.
6557 </para> 6714 </para>
6715
6558 <para> 6716 <para>
6559 As an example, suppose the machine for which you are building requires 6717 As an example, suppose the machine for which you are building requires
6560 <filename>example-init</filename> to be run during boot to initialize the hardware. 6718 <filename>example-init</filename> to be run during boot to initialize the hardware.
@@ -6567,12 +6725,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6567 </glossdef> 6725 </glossdef>
6568 </glossentry> 6726 </glossentry>
6569 6727
6570 <glossentry id='var-MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS'><glossterm>MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 6728 <glossentry id='var-MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS'><glossterm>MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS</glossterm>
6571 <info> 6729 <info>
6572 MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS[doc] = "A list of recommended machine-specific packages to install as part of the image being built. Because this is a 'machine essential' variable, the list of packages are essential for the machine to boot." 6730 MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS[doc] = "A list of recommended machine-specific packages to install as part of the image being built. Because this is a 'machine essential' variable, the list of packages are essential for the machine to boot."
6573 </info> 6731 </info>
6574 <glossdef> 6732 <glossdef>
6575 <para> 6733 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6576 A list of recommended machine-specific packages to install as part of 6734 A list of recommended machine-specific packages to install as part of
6577 the image being built. 6735 the image being built.
6578 The build process does not depend on these packages being present. 6736 The build process does not depend on these packages being present.
@@ -6582,6 +6740,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6582 <filename>packagegroup-core-boot</filename>, 6740 <filename>packagegroup-core-boot</filename>,
6583 including the <filename>core-image-minimal</filename> image. 6741 including the <filename>core-image-minimal</filename> image.
6584 </para> 6742 </para>
6743
6585 <para> 6744 <para>
6586 This variable is similar to the 6745 This variable is similar to the
6587 <filename><link linkend='var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'>MACHINE_ESSENTIAL_EXTRA_RDEPENDS</link></filename> 6746 <filename><link linkend='var-MACHINE_ESSENTIAL_EXTRA_RDEPENDS'>MACHINE_ESSENTIAL_EXTRA_RDEPENDS</link></filename>
@@ -6592,6 +6751,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6592 functionality may be selected to be built into the kernel rather than as a module, 6751 functionality may be selected to be built into the kernel rather than as a module,
6593 in which case a package will not be produced. 6752 in which case a package will not be produced.
6594 </para> 6753 </para>
6754
6595 <para> 6755 <para>
6596 Consider an example where you have a custom kernel where a specific touchscreen 6756 Consider an example where you have a custom kernel where a specific touchscreen
6597 driver is required for the machine to be usable. 6757 driver is required for the machine to be usable.
@@ -6610,6 +6770,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6610 MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS += "kernel-module-ab123" 6770 MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS += "kernel-module-ab123"
6611 </literallayout> 6771 </literallayout>
6612 </para> 6772 </para>
6773
6613 <para> 6774 <para>
6614 Some examples of these machine essentials are flash, screen, keyboard, mouse, 6775 Some examples of these machine essentials are flash, screen, keyboard, mouse,
6615 or touchscreen drivers (depending on the machine). 6776 or touchscreen drivers (depending on the machine).
@@ -6617,23 +6778,25 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6617 </glossdef> 6778 </glossdef>
6618 </glossentry> 6779 </glossentry>
6619 6780
6620 <glossentry id='var-MACHINE_EXTRA_RDEPENDS'><glossterm>MACHINE_EXTRA_RDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 6781 <glossentry id='var-MACHINE_EXTRA_RDEPENDS'><glossterm>MACHINE_EXTRA_RDEPENDS</glossterm>
6621 <info> 6782 <info>
6622 MACHINE_EXTRA_RDEPENDS[doc] = "A list of machine-specific packages to install as part of the image being built that are not essential for the machine to boot. However, the build process for more fully-featured images depends on the packages being present." 6783 MACHINE_EXTRA_RDEPENDS[doc] = "A list of machine-specific packages to install as part of the image being built that are not essential for the machine to boot. However, the build process for more fully-featured images depends on the packages being present."
6623 </info> 6784 </info>
6624 <glossdef> 6785 <glossdef>
6625 <para> 6786 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6626 A list of machine-specific packages to install as part of the 6787 A list of machine-specific packages to install as part of the
6627 image being built that are not essential for the machine to boot. 6788 image being built that are not essential for the machine to boot.
6628 However, the build process for more fully-featured images 6789 However, the build process for more fully-featured images
6629 depends on the packages being present. 6790 depends on the packages being present.
6630 </para> 6791 </para>
6792
6631 <para> 6793 <para>
6632 This variable affects all images based on 6794 This variable affects all images based on
6633 <filename>packagegroup-base</filename>, which does not include the 6795 <filename>packagegroup-base</filename>, which does not include the
6634 <filename>core-image-minimal</filename> or <filename>core-image-full-cmdline</filename> 6796 <filename>core-image-minimal</filename> or <filename>core-image-full-cmdline</filename>
6635 images. 6797 images.
6636 </para> 6798 </para>
6799
6637 <para> 6800 <para>
6638 The variable is similar to the 6801 The variable is similar to the
6639 <filename><link linkend='var-MACHINE_EXTRA_RRECOMMENDS'>MACHINE_EXTRA_RRECOMMENDS</link></filename> 6802 <filename><link linkend='var-MACHINE_EXTRA_RRECOMMENDS'>MACHINE_EXTRA_RRECOMMENDS</link></filename>
@@ -6641,6 +6804,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6641 dependency on the variable's list of packages. 6804 dependency on the variable's list of packages.
6642 In other words, the image will not build if a file in this list is not found. 6805 In other words, the image will not build if a file in this list is not found.
6643 </para> 6806 </para>
6807
6644 <para> 6808 <para>
6645 An example is a machine that has WiFi capability but is not 6809 An example is a machine that has WiFi capability but is not
6646 essential for the machine to boot the image. 6810 essential for the machine to boot the image.
@@ -6659,22 +6823,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6659 </glossdef> 6823 </glossdef>
6660 </glossentry> 6824 </glossentry>
6661 6825
6662 <glossentry id='var-MACHINE_EXTRA_RRECOMMENDS'><glossterm>MACHINE_EXTRA_RRECOMMENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 6826 <glossentry id='var-MACHINE_EXTRA_RRECOMMENDS'><glossterm>MACHINE_EXTRA_RRECOMMENDS</glossterm>
6663 <info> 6827 <info>
6664 MACHINE_EXTRA_RRECOMMENDS[doc] = "A list of machine-specific packages to install as part of the image being built that are not essential for booting the machine. The image being built has no build dependencies on the packages in this list." 6828 MACHINE_EXTRA_RRECOMMENDS[doc] = "A list of machine-specific packages to install as part of the image being built that are not essential for booting the machine. The image being built has no build dependencies on the packages in this list."
6665 </info> 6829 </info>
6666 <glossdef> 6830 <glossdef>
6667 <para> 6831 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6668 A list of machine-specific packages to install as part of the 6832 A list of machine-specific packages to install as part of the
6669 image being built that are not essential for booting the machine. 6833 image being built that are not essential for booting the machine.
6670 The image being built has no build dependency on this list of packages. 6834 The image being built has no build dependency on this list of packages.
6671 </para> 6835 </para>
6836
6672 <para> 6837 <para>
6673 This variable affects only images based on 6838 This variable affects only images based on
6674 <filename>packagegroup-base</filename>, which does not include the 6839 <filename>packagegroup-base</filename>, which does not include the
6675 <filename>core-image-minimal</filename> or <filename>core-image-full-cmdline</filename> 6840 <filename>core-image-minimal</filename> or <filename>core-image-full-cmdline</filename>
6676 images. 6841 images.
6677 </para> 6842 </para>
6843
6678 <para> 6844 <para>
6679 This variable is similar to the 6845 This variable is similar to the
6680 <filename><link linkend='var-MACHINE_EXTRA_RDEPENDS'>MACHINE_EXTRA_RDEPENDS</link></filename> 6846 <filename><link linkend='var-MACHINE_EXTRA_RDEPENDS'>MACHINE_EXTRA_RDEPENDS</link></filename>
@@ -6682,6 +6848,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6682 dependency on the variable's list of packages. 6848 dependency on the variable's list of packages.
6683 In other words, the image will build if a file in this list is not found. 6849 In other words, the image will build if a file in this list is not found.
6684 </para> 6850 </para>
6851
6685 <para> 6852 <para>
6686 An example is a machine that has WiFi capability but is not essential 6853 An example is a machine that has WiFi capability but is not essential
6687 For the machine to boot the image. 6854 For the machine to boot the image.
@@ -6700,12 +6867,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6700 </glossdef> 6867 </glossdef>
6701 </glossentry> 6868 </glossentry>
6702 6869
6703 <glossentry id='var-MACHINE_FEATURES'><glossterm>MACHINE_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 6870 <glossentry id='var-MACHINE_FEATURES'><glossterm>MACHINE_FEATURES</glossterm>
6704 <info> 6871 <info>
6705 MACHINE_FEATURES[doc] = "Specifies the list of hardware features the MACHINE supports." 6872 MACHINE_FEATURES[doc] = "Specifies the list of hardware features the MACHINE supports."
6706 </info> 6873 </info>
6707 <glossdef> 6874 <glossdef>
6708 <para> 6875 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6709 Specifies the list of hardware features the 6876 Specifies the list of hardware features the
6710 <link linkend='var-MACHINE'><filename>MACHINE</filename></link> is capable 6877 <link linkend='var-MACHINE'><filename>MACHINE</filename></link> is capable
6711 of supporting. 6878 of supporting.
@@ -6726,12 +6893,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6726 </glossdef> 6893 </glossdef>
6727 </glossentry> 6894 </glossentry>
6728 6895
6729 <glossentry id='var-MACHINE_FEATURES_BACKFILL'><glossterm>MACHINE_FEATURES_BACKFILL<imagedata fileref="figures/define-generic.png" /></glossterm> 6896 <glossentry id='var-MACHINE_FEATURES_BACKFILL'><glossterm>MACHINE_FEATURES_BACKFILL</glossterm>
6730 <info> 6897 <info>
6731 MACHINE_FEATURES_BACKFILL[doc] = "Features to be added to MACHINE_FEATURES if not also present in MACHINE_FEATURES_BACKFILL_CONSIDERED. This variable is set in the meta/conf/bitbake.conf file and is not intended to be user-configurable." 6898 MACHINE_FEATURES_BACKFILL[doc] = "Features to be added to MACHINE_FEATURES if not also present in MACHINE_FEATURES_BACKFILL_CONSIDERED. This variable is set in the meta/conf/bitbake.conf file and is not intended to be user-configurable."
6732 </info> 6899 </info>
6733 <glossdef> 6900 <glossdef>
6734 <para>Features to be added to 6901 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6902 Features to be added to
6735 <filename><link linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></filename> 6903 <filename><link linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></filename>
6736 if not also present in 6904 if not also present in
6737 <filename><link linkend='var-MACHINE_FEATURES_BACKFILL_CONSIDERED'>MACHINE_FEATURES_BACKFILL_CONSIDERED</link></filename>. 6905 <filename><link linkend='var-MACHINE_FEATURES_BACKFILL_CONSIDERED'>MACHINE_FEATURES_BACKFILL_CONSIDERED</link></filename>.
@@ -6748,28 +6916,29 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6748 </glossdef> 6916 </glossdef>
6749 </glossentry> 6917 </glossentry>
6750 6918
6751 <glossentry id='var-MACHINE_FEATURES_BACKFILL_CONSIDERED'><glossterm>MACHINE_FEATURES_BACKFILL_CONSIDERED<imagedata fileref="figures/define-generic.png" /></glossterm> 6919 <glossentry id='var-MACHINE_FEATURES_BACKFILL_CONSIDERED'><glossterm>MACHINE_FEATURES_BACKFILL_CONSIDERED</glossterm>
6752 <info> 6920 <info>
6753 MACHINE_FEATURES_BACKFILL_CONSIDERED[doc] = "Features from MACHINE_FEATURES_BACKFILL that should not be backfilled (i.e. added to MACHINE_FEATURES) during the build." 6921 MACHINE_FEATURES_BACKFILL_CONSIDERED[doc] = "Features from MACHINE_FEATURES_BACKFILL that should not be backfilled (i.e. added to MACHINE_FEATURES) during the build."
6754 </info> 6922 </info>
6755 <glossdef> 6923 <glossdef>
6756 <para>Features from 6924 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6925 Features from
6757 <filename><link linkend='var-MACHINE_FEATURES_BACKFILL'>MACHINE_FEATURES_BACKFILL</link></filename> 6926 <filename><link linkend='var-MACHINE_FEATURES_BACKFILL'>MACHINE_FEATURES_BACKFILL</link></filename>
6758 that should not be backfilled (i.e. added to 6927 that should not be backfilled (i.e. added to
6759 <filename><link linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></filename>) 6928 <filename><link linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></filename>)
6760 during the build. 6929 during the build.
6761 See the "<link linkend='ref-features-backfill'>Feature backfilling</link>" section for 6930 See the "<link linkend='ref-features-backfill'>Feature backfilling</link>" section for
6762 more information. 6931 more information.
6763 </para> 6932 </para>
6764 </glossdef> 6933 </glossdef>
6765 </glossentry> 6934 </glossentry>
6766 6935
6767 <glossentry id='var-MACHINEOVERRIDES'><glossterm>MACHINEOVERRIDES<imagedata fileref="figures/define-generic.png" /></glossterm> 6936 <glossentry id='var-MACHINEOVERRIDES'><glossterm>MACHINEOVERRIDES</glossterm>
6768 <info> 6937 <info>
6769 MACHINEOVERRIDES[doc] = "Lists overrides specific to the current machine. By default, this list includes the value of MACHINE." 6938 MACHINEOVERRIDES[doc] = "Lists overrides specific to the current machine. By default, this list includes the value of MACHINE."
6770 </info> 6939 </info>
6771 <glossdef> 6940 <glossdef>
6772 <para> 6941 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6773 Lists overrides specific to the current machine. 6942 Lists overrides specific to the current machine.
6774 By default, this list includes the value 6943 By default, this list includes the value
6775 of <filename><link linkend='var-MACHINE'>MACHINE</link></filename>. 6944 of <filename><link linkend='var-MACHINE'>MACHINE</link></filename>.
@@ -6783,6 +6952,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6783 <literallayout class='monospaced'> 6952 <literallayout class='monospaced'>
6784 MACHINEOVERRIDES =. "qemuall:" 6953 MACHINEOVERRIDES =. "qemuall:"
6785 </literallayout> 6954 </literallayout>
6955 </para>
6956
6957 <para>
6786 Applying an override like <filename>qemuall</filename> 6958 Applying an override like <filename>qemuall</filename>
6787 affects all QEMU emulated machines elsewhere. 6959 affects all QEMU emulated machines elsewhere.
6788 Here is an example from the 6960 Here is an example from the
@@ -6796,21 +6968,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6796 </glossdef> 6968 </glossdef>
6797 </glossentry> 6969 </glossentry>
6798 6970
6799 <glossentry id='var-MAINTAINER'><glossterm>MAINTAINER<imagedata fileref="figures/define-generic.png" /></glossterm> 6971 <glossentry id='var-MAINTAINER'><glossterm>MAINTAINER</glossterm>
6800 <info> 6972 <info>
6801 MAINTAINER[doc] = "The email address of the distribution maintainer." 6973 MAINTAINER[doc] = "The email address of the distribution maintainer."
6802 </info> 6974 </info>
6803 <glossdef> 6975 <glossdef>
6804 <para>The email address of the distribution maintainer.</para> 6976 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6977 The email address of the distribution maintainer.
6978 </para>
6805 </glossdef> 6979 </glossdef>
6806 </glossentry> 6980 </glossentry>
6807 6981
6808 <glossentry id='var-MIRRORS'><glossterm>MIRRORS<imagedata fileref="figures/define-generic.png" /></glossterm> 6982 <glossentry id='var-MIRRORS'><glossterm>MIRRORS</glossterm>
6809 <info> 6983 <info>
6810 MIRRORS[doc] = "Specifies additional paths from which the OpenEmbedded build system gets source code." 6984 MIRRORS[doc] = "Specifies additional paths from which the OpenEmbedded build system gets source code."
6811 </info> 6985 </info>
6812 <glossdef> 6986 <glossdef>
6813 <para> 6987 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6814 Specifies additional paths from which the OpenEmbedded 6988 Specifies additional paths from which the OpenEmbedded
6815 build system gets source code. 6989 build system gets source code.
6816 When the build system searches for source code, it first 6990 When the build system searches for source code, it first
@@ -6833,12 +7007,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6833 </glossdef> 7007 </glossdef>
6834 </glossentry> 7008 </glossentry>
6835 7009
6836 <glossentry id='var-MLPREFIX'><glossterm>MLPREFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 7010 <glossentry id='var-MLPREFIX'><glossterm>MLPREFIX</glossterm>
6837 <info> 7011 <info>
6838 MLPREFIX[doc] = "Specifies a prefix has been added to PN to create a special version of a recipe or package, such as a Multilib version." 7012 MLPREFIX[doc] = "Specifies a prefix has been added to PN to create a special version of a recipe or package, such as a Multilib version."
6839 </info> 7013 </info>
6840 <glossdef> 7014 <glossdef>
6841 <para> 7015 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6842 Specifies a prefix has been added to 7016 Specifies a prefix has been added to
6843 <link linkend='var-PN'><filename>PN</filename></link> to create a special version 7017 <link linkend='var-PN'><filename>PN</filename></link> to create a special version
6844 of a recipe or package, such as a Multilib version. 7018 of a recipe or package, such as a Multilib version.
@@ -6851,12 +7025,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6851 </glossdef> 7025 </glossdef>
6852 </glossentry> 7026 </glossentry>
6853 7027
6854 <glossentry id='var-module_autoload'><glossterm>module_autoload<imagedata fileref="figures/define-generic.png" /></glossterm> 7028 <glossentry id='var-module_autoload'><glossterm>module_autoload</glossterm>
6855 <info> 7029 <info>
6856 module_autoload[doc] = "This variable has been replaced by the KERNEL_MODULE_AUTOLOAD variable. You should replace all occurrences of module_autoload with additions to KERNEL_MODULE_AUTOLOAD." 7030 module_autoload[doc] = "This variable has been replaced by the KERNEL_MODULE_AUTOLOAD variable. You should replace all occurrences of module_autoload with additions to KERNEL_MODULE_AUTOLOAD."
6857 </info> 7031 </info>
6858 <glossdef> 7032 <glossdef>
6859 <para> 7033 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6860 This variable has been replaced by the 7034 This variable has been replaced by the
6861 <filename>KERNEL_MODULE_AUTOLOAD</filename> variable. 7035 <filename>KERNEL_MODULE_AUTOLOAD</filename> variable.
6862 You should replace all occurrences of 7036 You should replace all occurrences of
@@ -6865,6 +7039,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6865 <literallayout class='monospaced'> 7039 <literallayout class='monospaced'>
6866 module_autoload_rfcomm = "rfcomm" 7040 module_autoload_rfcomm = "rfcomm"
6867 </literallayout> 7041 </literallayout>
7042 </para>
7043
7044 <para>
6868 should now be replaced with: 7045 should now be replaced with:
6869 <literallayout class='monospaced'> 7046 <literallayout class='monospaced'>
6870 KERNEL_MODULE_AUTOLOAD += "rfcomm" 7047 KERNEL_MODULE_AUTOLOAD += "rfcomm"
@@ -6876,12 +7053,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6876 </glossdef> 7053 </glossdef>
6877 </glossentry> 7054 </glossentry>
6878 7055
6879 <glossentry id='var-module_conf'><glossterm>module_conf<imagedata fileref="figures/define-generic.png" /></glossterm> 7056 <glossentry id='var-module_conf'><glossterm>module_conf</glossterm>
6880 <info> 7057 <info>
6881 module_conf[doc] = "Specifies modprobe.d syntax lines for inclusion in the /etc/modprobe.d/modname.conf file." 7058 module_conf[doc] = "Specifies modprobe.d syntax lines for inclusion in the /etc/modprobe.d/modname.conf file."
6882 </info> 7059 </info>
6883 <glossdef> 7060 <glossdef>
6884 <para> 7061 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6885 Specifies 7062 Specifies
6886 <ulink url='http://linux.die.net/man/5/modprobe.d'><filename>modprobe.d</filename></ulink> 7063 <ulink url='http://linux.die.net/man/5/modprobe.d'><filename>modprobe.d</filename></ulink>
6887 syntax lines for inclusion in the 7064 syntax lines for inclusion in the
@@ -6936,12 +7113,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6936 </glossdef> 7113 </glossdef>
6937 </glossentry> 7114 </glossentry>
6938 7115
6939 <glossentry id='var-MODULE_IMAGE_BASE_NAME'><glossterm>MODULE_IMAGE_BASE_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 7116 <glossentry id='var-MODULE_IMAGE_BASE_NAME'><glossterm>MODULE_IMAGE_BASE_NAME</glossterm>
6940 <info> 7117 <info>
6941 MODULE_IMAGE_BASE_NAME[doc] = "The base name of the kernel modules tarball." 7118 MODULE_IMAGE_BASE_NAME[doc] = "The base name of the kernel modules tarball."
6942 </info> 7119 </info>
6943 <glossdef> 7120 <glossdef>
6944 <para> 7121 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6945 The base name of the kernel modules tarball. 7122 The base name of the kernel modules tarball.
6946 This variable is set in the 7123 This variable is set in the
6947 <link linkend='ref-classes-kernel'>kernel</link> class 7124 <link linkend='ref-classes-kernel'>kernel</link> class
@@ -6949,6 +7126,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6949 <literallayout class='monospaced'> 7126 <literallayout class='monospaced'>
6950 MODULE_IMAGE_BASE_NAME ?= "modules-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}" 7127 MODULE_IMAGE_BASE_NAME ?= "modules-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"
6951 </literallayout> 7128 </literallayout>
7129 </para>
7130
7131 <para>
6952 See the 7132 See the
6953 <link linkend='var-PKGE'><filename>PKGE</filename></link>, 7133 <link linkend='var-PKGE'><filename>PKGE</filename></link>,
6954 <link linkend='var-PKGV'><filename>PKGV</filename></link>, 7134 <link linkend='var-PKGV'><filename>PKGV</filename></link>,
@@ -6961,12 +7141,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6961 </glossdef> 7141 </glossdef>
6962 </glossentry> 7142 </glossentry>
6963 7143
6964 <glossentry id='var-MODULE_TARBALL_DEPLOY'><glossterm>MODULE_TARBALL_DEPLOY<imagedata fileref="figures/define-generic.png" /></glossterm> 7144 <glossentry id='var-MODULE_TARBALL_DEPLOY'><glossterm>MODULE_TARBALL_DEPLOY</glossterm>
6965 <info> 7145 <info>
6966 MODULE_TARBALL_DEPLOY[doc] = "Controls creation of the modules-*.tgz file. Set this variable to "0" to disable creation of this file, which contains all of the kernel modules resulting from a kernel build." 7146 MODULE_TARBALL_DEPLOY[doc] = "Controls creation of the modules-*.tgz file. Set this variable to "0" to disable creation of this file, which contains all of the kernel modules resulting from a kernel build."
6967 </info> 7147 </info>
6968 <glossdef> 7148 <glossdef>
6969 <para> 7149 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6970 Controls creation of the <filename>modules-*.tgz</filename> 7150 Controls creation of the <filename>modules-*.tgz</filename>
6971 file. 7151 file.
6972 Set this variable to "0" to disable creation of this 7152 Set this variable to "0" to disable creation of this
@@ -6976,12 +7156,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6976 </glossdef> 7156 </glossdef>
6977 </glossentry> 7157 </glossentry>
6978 7158
6979 <glossentry id='var-MULTIMACH_TARGET_SYS'><glossterm>MULTIMACH_TARGET_SYS<imagedata fileref="figures/define-generic.png" /></glossterm> 7159 <glossentry id='var-MULTIMACH_TARGET_SYS'><glossterm>MULTIMACH_TARGET_SYS</glossterm>
6980 <info> 7160 <info>
6981 MULTIMACH_TARGET_SYS[doc] = "Separates files for different machines such that you can build for multiple target machines using the same output directories." 7161 MULTIMACH_TARGET_SYS[doc] = "Separates files for different machines such that you can build for multiple target machines using the same output directories."
6982 </info> 7162 </info>
6983 <glossdef> 7163 <glossdef>
6984 <para> 7164 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
6985 Separates files for different machines such that you can build 7165 Separates files for different machines such that you can build
6986 for multiple target machines using the same output directories. 7166 for multiple target machines using the same output directories.
6987 See the <link linkend='var-STAMP'><filename>STAMP</filename></link> variable 7167 See the <link linkend='var-STAMP'><filename>STAMP</filename></link> variable
@@ -6994,12 +7174,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6994 7174
6995 <glossdiv id='var-glossary-n'><title>N</title> 7175 <glossdiv id='var-glossary-n'><title>N</title>
6996 7176
6997 <glossentry id='var-NATIVELSBSTRING'><glossterm>NATIVELSBSTRING<imagedata fileref="figures/define-generic.png" /></glossterm> 7177 <glossentry id='var-NATIVELSBSTRING'><glossterm>NATIVELSBSTRING</glossterm>
6998 <info> 7178 <info>
6999 NATIVELSBSTRING[doc] = "A string identifying the host distribution." 7179 NATIVELSBSTRING[doc] = "A string identifying the host distribution."
7000 </info> 7180 </info>
7001 <glossdef> 7181 <glossdef>
7002 <para> 7182 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7003 A string identifying the host distribution. 7183 A string identifying the host distribution.
7004 Strings consist of the host distributor ID 7184 Strings consist of the host distributor ID
7005 followed by the release, as reported by the 7185 followed by the release, as reported by the
@@ -7010,6 +7190,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7010 If this information is unable to be determined, the value 7190 If this information is unable to be determined, the value
7011 resolves to "Unknown". 7191 resolves to "Unknown".
7012 </para> 7192 </para>
7193
7013 <para> 7194 <para>
7014 This variable is used by default to isolate native shared 7195 This variable is used by default to isolate native shared
7015 state packages for different distributions (e.g. to avoid 7196 state packages for different distributions (e.g. to avoid
@@ -7022,24 +7203,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7022 </glossdef> 7203 </glossdef>
7023 </glossentry> 7204 </glossentry>
7024 7205
7025 <glossentry id='var-NM'><glossterm>NM<imagedata fileref="figures/define-generic.png" /></glossterm> 7206 <glossentry id='var-NM'><glossterm>NM</glossterm>
7026 <info> 7207 <info>
7027 NM[doc] = "Minimal command and arguments to run 'nm'." 7208 NM[doc] = "Minimal command and arguments to run 'nm'."
7028 </info> 7209 </info>
7029 <glossdef> 7210 <glossdef>
7030 <para> 7211 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7031 The minimal command and arguments to run 7212 The minimal command and arguments to run
7032 <filename>nm</filename>. 7213 <filename>nm</filename>.
7033 </para> 7214 </para>
7034 </glossdef> 7215 </glossdef>
7035 </glossentry> 7216 </glossentry>
7036 7217
7037 <glossentry id='var-NO_RECOMMENDATIONS'><glossterm>NO_RECOMMENDATIONS<imagedata fileref="figures/define-generic.png" /></glossterm> 7218 <glossentry id='var-NO_RECOMMENDATIONS'><glossterm>NO_RECOMMENDATIONS</glossterm>
7038 <info> 7219 <info>
7039 NO_RECOMMENDATIONS[doc] = "When set to '1', no recommended packages will be installed. Realize that some recommended packages might be required for certain system functionality, such as kernel-modules. It is up to the user to add packages to IMAGE_INSTALL as needed." 7220 NO_RECOMMENDATIONS[doc] = "When set to '1', no recommended packages will be installed. Realize that some recommended packages might be required for certain system functionality, such as kernel-modules. It is up to the user to add packages to IMAGE_INSTALL as needed."
7040 </info> 7221 </info>
7041 <glossdef> 7222 <glossdef>
7042 <para> 7223 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7043 Prevents installation of all "recommended-only" packages. 7224 Prevents installation of all "recommended-only" packages.
7044 Recommended-only packages are packages installed only 7225 Recommended-only packages are packages installed only
7045 through the 7226 through the
@@ -7050,6 +7231,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7050 <literallayout class='monospaced'> 7231 <literallayout class='monospaced'>
7051 NO_RECOMMENDATIONS = "1" 7232 NO_RECOMMENDATIONS = "1"
7052 </literallayout> 7233 </literallayout>
7234 </para>
7235
7236 <para>
7053 You can set this variable globally in your 7237 You can set this variable globally in your
7054 <filename>local.conf</filename> file or you can attach it to 7238 <filename>local.conf</filename> file or you can attach it to
7055 a specific image recipe by using the recipe name override: 7239 a specific image recipe by using the recipe name override:
@@ -7091,12 +7275,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7091 </glossdef> 7275 </glossdef>
7092 </glossentry> 7276 </glossentry>
7093 7277
7094 <glossentry id='var-NOHDD'><glossterm>NOHDD<imagedata fileref="figures/define-generic.png" /></glossterm> 7278 <glossentry id='var-NOHDD'><glossterm>NOHDD</glossterm>
7095 <info> 7279 <info>
7096 NOHDD[doc] = "Causes the OpenEmbedded build system to skip building the .hddimg image." 7280 NOHDD[doc] = "Causes the OpenEmbedded build system to skip building the .hddimg image."
7097 </info> 7281 </info>
7098 <glossdef> 7282 <glossdef>
7099 <para> 7283 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7100 Causes the OpenEmbedded build system to skip building the 7284 Causes the OpenEmbedded build system to skip building the
7101 <filename>.hddimg</filename> image. 7285 <filename>.hddimg</filename> image.
7102 The <filename>NOHDD</filename> variable is used with the 7286 The <filename>NOHDD</filename> variable is used with the
@@ -7108,12 +7292,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7108 </glossdef> 7292 </glossdef>
7109 </glossentry> 7293 </glossentry>
7110 7294
7111 <glossentry id='var-NOISO'><glossterm>NOISO<imagedata fileref="figures/define-generic.png" /></glossterm> 7295 <glossentry id='var-NOISO'><glossterm>NOISO</glossterm>
7112 <info> 7296 <info>
7113 NOISO[doc] = "Causes the OpenEmbedded build system to skip building the ISO image." 7297 NOISO[doc] = "Causes the OpenEmbedded build system to skip building the ISO image."
7114 </info> 7298 </info>
7115 <glossdef> 7299 <glossdef>
7116 <para> 7300 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7117 Causes the OpenEmbedded build system to skip building the 7301 Causes the OpenEmbedded build system to skip building the
7118 ISO image. 7302 ISO image.
7119 The <filename>NOISO</filename> variable is used with the 7303 The <filename>NOISO</filename> variable is used with the
@@ -7130,36 +7314,36 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7130 7314
7131 <glossdiv id='var-glossary-o'><title>O</title> 7315 <glossdiv id='var-glossary-o'><title>O</title>
7132 7316
7133 <glossentry id='var-OBJCOPY'><glossterm>OBJCOPY<imagedata fileref="figures/define-generic.png" /></glossterm> 7317 <glossentry id='var-OBJCOPY'><glossterm>OBJCOPY</glossterm>
7134 <info> 7318 <info>
7135 OBJCOPY[doc] = "Minimal command and arguments to run 'objcopy'." 7319 OBJCOPY[doc] = "Minimal command and arguments to run 'objcopy'."
7136 </info> 7320 </info>
7137 <glossdef> 7321 <glossdef>
7138 <para> 7322 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7139 The minimal command and arguments to run 7323 The minimal command and arguments to run
7140 <filename>objcopy</filename>. 7324 <filename>objcopy</filename>.
7141 </para> 7325 </para>
7142 </glossdef> 7326 </glossdef>
7143 </glossentry> 7327 </glossentry>
7144 7328
7145 <glossentry id='var-OBJDUMP'><glossterm>OBJDUMP<imagedata fileref="figures/define-generic.png" /></glossterm> 7329 <glossentry id='var-OBJDUMP'><glossterm>OBJDUMP</glossterm>
7146 <info> 7330 <info>
7147 OBJDUMP[doc] = "Minimal command and arguments to run 'objdump'." 7331 OBJDUMP[doc] = "Minimal command and arguments to run 'objdump'."
7148 </info> 7332 </info>
7149 <glossdef> 7333 <glossdef>
7150 <para> 7334 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7151 The minimal command and arguments to run 7335 The minimal command and arguments to run
7152 <filename>objdump</filename>. 7336 <filename>objdump</filename>.
7153 </para> 7337 </para>
7154 </glossdef> 7338 </glossdef>
7155 </glossentry> 7339 </glossentry>
7156 7340
7157 <glossentry id='var-OE_BINCONFIG_EXTRA_MANGLE'><glossterm>OE_BINCONFIG_EXTRA_MANGLE<imagedata fileref="figures/define-generic.png" /></glossterm> 7341 <glossentry id='var-OE_BINCONFIG_EXTRA_MANGLE'><glossterm>OE_BINCONFIG_EXTRA_MANGLE</glossterm>
7158 <info> 7342 <info>
7159 OE_BINCONFIG_EXTRA_MANGLE[doc] = "When a recipe inherits the binconfig.bbclass class, this variable specifies additional arguments passed to the "sed" command." 7343 OE_BINCONFIG_EXTRA_MANGLE[doc] = "When a recipe inherits the binconfig.bbclass class, this variable specifies additional arguments passed to the "sed" command."
7160 </info> 7344 </info>
7161 <glossdef> 7345 <glossdef>
7162 <para> 7346 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7163 When inheriting the 7347 When inheriting the
7164 <link linkend='ref-classes-binconfig'><filename>binconfig</filename></link> 7348 <link linkend='ref-classes-binconfig'><filename>binconfig</filename></link>
7165 class, this variable 7349 class, this variable
@@ -7187,12 +7371,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7187 </glossdef> 7371 </glossdef>
7188 </glossentry> 7372 </glossentry>
7189 7373
7190 <glossentry id='var-OE_IMPORTS'><glossterm>OE_IMPORTS<imagedata fileref="figures/define-generic.png" /></glossterm> 7374 <glossentry id='var-OE_IMPORTS'><glossterm>OE_IMPORTS</glossterm>
7191 <info> 7375 <info>
7192 OE_IMPORTS[doc] = "An internal variable used to tell the OpenEmbedded build system what Python modules to import for every Python function run by the system." 7376 OE_IMPORTS[doc] = "An internal variable used to tell the OpenEmbedded build system what Python modules to import for every Python function run by the system."
7193 </info> 7377 </info>
7194 <glossdef> 7378 <glossdef>
7195 <para> 7379 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7196 An internal variable used to tell the OpenEmbedded build 7380 An internal variable used to tell the OpenEmbedded build
7197 system what Python modules to import for every Python 7381 system what Python modules to import for every Python
7198 function run by the system. 7382 function run by the system.
@@ -7205,12 +7389,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7205 </glossdef> 7389 </glossdef>
7206 </glossentry> 7390 </glossentry>
7207 7391
7208 <glossentry id='var-OE_TERMINAL'><glossterm>OE_TERMINAL<imagedata fileref="figures/define-generic.png" /></glossterm> 7392 <glossentry id='var-OE_TERMINAL'><glossterm>OE_TERMINAL</glossterm>
7209 <info> 7393 <info>
7210 OE_TERMINAL[doc] = "Controls how the OpenEmbedded build system spawns interactive terminals on the host development system." 7394 OE_TERMINAL[doc] = "Controls how the OpenEmbedded build system spawns interactive terminals on the host development system."
7211 </info> 7395 </info>
7212 <glossdef> 7396 <glossdef>
7213 <para> 7397 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7214 Controls how the OpenEmbedded build system spawns 7398 Controls how the OpenEmbedded build system spawns
7215 interactive terminals on the host development system 7399 interactive terminals on the host development system
7216 (e.g. using the BitBake command with the 7400 (e.g. using the BitBake command with the
@@ -7239,12 +7423,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7239 </glossdef> 7423 </glossdef>
7240 </glossentry> 7424 </glossentry>
7241 7425
7242 <glossentry id='var-OEROOT'><glossterm>OEROOT<imagedata fileref="figures/define-generic.png" /></glossterm> 7426 <glossentry id='var-OEROOT'><glossterm>OEROOT</glossterm>
7243 <info> 7427 <info>
7244 OEROOT[doc] = "The directory from which the top-level build environment setup script is sourced." 7428 OEROOT[doc] = "The directory from which the top-level build environment setup script is sourced."
7245 </info> 7429 </info>
7246 <glossdef> 7430 <glossdef>
7247 <para> 7431 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7248 The directory from which the top-level build environment 7432 The directory from which the top-level build environment
7249 setup script is sourced. 7433 setup script is sourced.
7250 The Yocto Project makes two top-level build environment 7434 The Yocto Project makes two top-level build environment
@@ -7264,12 +7448,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7264 </glossdef> 7448 </glossdef>
7265 </glossentry> 7449 </glossentry>
7266 7450
7267 <glossentry id='var-OLDEST_KERNEL'><glossterm>OLDEST_KERNEL<imagedata fileref="figures/define-generic.png" /></glossterm> 7451 <glossentry id='var-OLDEST_KERNEL'><glossterm>OLDEST_KERNEL</glossterm>
7268 <info> 7452 <info>
7269 OLDEST_KERNEL[doc] = "Declares the oldest version of the Linux kernel that the produced binaries must support." 7453 OLDEST_KERNEL[doc] = "Declares the oldest version of the Linux kernel that the produced binaries must support."
7270 </info> 7454 </info>
7271 <glossdef> 7455 <glossdef>
7272 <para> 7456 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7273 Declares the oldest version of the Linux kernel that the 7457 Declares the oldest version of the Linux kernel that the
7274 produced binaries must support. 7458 produced binaries must support.
7275 This variable is passed into the build of the Embedded 7459 This variable is passed into the build of the Embedded
@@ -7286,12 +7470,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7286 </glossdef> 7470 </glossdef>
7287 </glossentry> 7471 </glossentry>
7288 7472
7289 <glossentry id='var-OVERRIDES'><glossterm>OVERRIDES<imagedata fileref="figures/define-generic.png" /></glossterm> 7473 <glossentry id='var-OVERRIDES'><glossterm>OVERRIDES</glossterm>
7290 <info> 7474 <info>
7291 OVERRIDES[doc] = "BitBake uses OVERRIDES to control what variables are overridden after BitBake parses recipes and configuration files." 7475 OVERRIDES[doc] = "BitBake uses OVERRIDES to control what variables are overridden after BitBake parses recipes and configuration files."
7292 </info> 7476 </info>
7293 <glossdef> 7477 <glossdef>
7294 <para> 7478 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7295 BitBake uses <filename>OVERRIDES</filename> to control 7479 BitBake uses <filename>OVERRIDES</filename> to control
7296 what variables are overridden after BitBake parses 7480 what variables are overridden after BitBake parses
7297 recipes and configuration files. 7481 recipes and configuration files.
@@ -7306,25 +7490,27 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7306 7490
7307 <glossdiv id='var-glossary-p'><title>P</title> 7491 <glossdiv id='var-glossary-p'><title>P</title>
7308 7492
7309 <glossentry id='var-P'><glossterm>P<imagedata fileref="figures/define-generic.png" /></glossterm> 7493 <glossentry id='var-P'><glossterm>P</glossterm>
7310 <info> 7494 <info>
7311 P[doc] = "The recipe name and version. P is comprised of ${PN}-${PV}." 7495 P[doc] = "The recipe name and version. P is comprised of ${PN}-${PV}."
7312 </info> 7496 </info>
7313 <glossdef> 7497 <glossdef>
7314 <para>The recipe name and version. 7498 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7499 The recipe name and version.
7315 <filename>P</filename> is comprised of the following: 7500 <filename>P</filename> is comprised of the following:
7316 <literallayout class='monospaced'> 7501 <literallayout class='monospaced'>
7317 ${PN}-${PV} 7502 ${PN}-${PV}
7318 </literallayout></para> 7503 </literallayout>
7504 </para>
7319 </glossdef> 7505 </glossdef>
7320 </glossentry> 7506 </glossentry>
7321 7507
7322 <glossentry id='var-PACKAGE_ARCH'><glossterm>PACKAGE_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 7508 <glossentry id='var-PACKAGE_ARCH'><glossterm>PACKAGE_ARCH</glossterm>
7323 <info> 7509 <info>
7324 PACKAGE_ARCH[doc] = "The architecture of the resulting package or packages." 7510 PACKAGE_ARCH[doc] = "The architecture of the resulting package or packages."
7325 </info> 7511 </info>
7326 <glossdef> 7512 <glossdef>
7327 <para> 7513 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7328 The architecture of the resulting package or packages. 7514 The architecture of the resulting package or packages.
7329 </para> 7515 </para>
7330 7516
@@ -7348,12 +7534,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7348 </glossdef> 7534 </glossdef>
7349 </glossentry> 7535 </glossentry>
7350 7536
7351 <glossentry id='var-PACKAGE_ARCHS'><glossterm>PACKAGE_ARCHS<imagedata fileref="figures/define-generic.png" /></glossterm> 7537 <glossentry id='var-PACKAGE_ARCHS'><glossterm>PACKAGE_ARCHS</glossterm>
7352 <info> 7538 <info>
7353 PACKAGE_ARCHS[doc] = "A list of architectures compatible with the given target in order of priority." 7539 PACKAGE_ARCHS[doc] = "A list of architectures compatible with the given target in order of priority."
7354 </info> 7540 </info>
7355 <glossdef> 7541 <glossdef>
7356 <para> 7542 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7357 Specifies a list of architectures compatible with 7543 Specifies a list of architectures compatible with
7358 the target machine. 7544 the target machine.
7359 This variable is set automatically and should not 7545 This variable is set automatically and should not
@@ -7367,25 +7553,27 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7367 </glossdef> 7553 </glossdef>
7368 </glossentry> 7554 </glossentry>
7369 7555
7370 <glossentry id='var-PACKAGE_BEFORE_PN'><glossterm>PACKAGE_BEFORE_PN<imagedata fileref="figures/define-generic.png" /></glossterm> 7556 <glossentry id='var-PACKAGE_BEFORE_PN'><glossterm>PACKAGE_BEFORE_PN</glossterm>
7371 <info> 7557 <info>
7372 PACKAGE_BEFORE_PN[doc] = "Enables easily adding packages to PACKAGES before ${PN} so that the packages can pick up files that would normally be included in the default package." 7558 PACKAGE_BEFORE_PN[doc] = "Enables easily adding packages to PACKAGES before ${PN} so that the packages can pick up files that would normally be included in the default package."
7373 </info> 7559 </info>
7374 <glossdef> 7560 <glossdef>
7375 <para>Enables easily adding packages to 7561 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7376 <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> 7562 Enables easily adding packages to
7377 before <filename>${<link linkend='var-PN'>PN</link>}</filename> 7563 <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename>
7378 so that those added packages can pick up files that would normally be 7564 before <filename>${<link linkend='var-PN'>PN</link>}</filename>
7379 included in the default package.</para> 7565 so that those added packages can pick up files that would normally be
7566 included in the default package.
7567 </para>
7380 </glossdef> 7568 </glossdef>
7381 </glossentry> 7569 </glossentry>
7382 7570
7383 <glossentry id='var-PACKAGE_CLASSES'><glossterm>PACKAGE_CLASSES<imagedata fileref="figures/define-generic.png" /></glossterm> 7571 <glossentry id='var-PACKAGE_CLASSES'><glossterm>PACKAGE_CLASSES</glossterm>
7384 <info> 7572 <info>
7385 PACKAGE_CLASSES[doc] = "This variable specifies the package manager to use when packaging data. It is set in the conf/local.conf file in the Build Directory." 7573 PACKAGE_CLASSES[doc] = "This variable specifies the package manager to use when packaging data. It is set in the conf/local.conf file in the Build Directory."
7386 </info> 7574 </info>
7387 <glossdef> 7575 <glossdef>
7388 <para> 7576 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7389 This variable, which is set in the 7577 This variable, which is set in the
7390 <filename>local.conf</filename> configuration file found in 7578 <filename>local.conf</filename> configuration file found in
7391 the <filename>conf</filename> folder of the 7579 the <filename>conf</filename> folder of the
@@ -7428,12 +7616,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7428 </glossdef> 7616 </glossdef>
7429 </glossentry> 7617 </glossentry>
7430 7618
7431 <glossentry id='var-PACKAGE_DEBUG_SPLIT_STYLE'><glossterm>PACKAGE_DEBUG_SPLIT_STYLE<imagedata fileref="figures/define-generic.png" /></glossterm> 7619 <glossentry id='var-PACKAGE_DEBUG_SPLIT_STYLE'><glossterm>PACKAGE_DEBUG_SPLIT_STYLE</glossterm>
7432 <info> 7620 <info>
7433 PACKAGE_DEBUG_SPLIT_STYLE[doc] = "Determines how to split up the binary and debug information when creating *-dbg packages to be used with the GNU Project Debugger (GDB)." 7621 PACKAGE_DEBUG_SPLIT_STYLE[doc] = "Determines how to split up the binary and debug information when creating *-dbg packages to be used with the GNU Project Debugger (GDB)."
7434 </info> 7622 </info>
7435 <glossdef> 7623 <glossdef>
7436 <para> 7624 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7437 Determines how to split up the binary and debug information 7625 Determines how to split up the binary and debug information
7438 when creating <filename>*-dbg</filename> packages to be 7626 when creating <filename>*-dbg</filename> packages to be
7439 used with the GNU Project Debugger (GDB). 7627 used with the GNU Project Debugger (GDB).
@@ -7486,17 +7674,20 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7486 </glossdef> 7674 </glossdef>
7487 </glossentry> 7675 </glossentry>
7488 7676
7489 <glossentry id='var-PACKAGE_EXCLUDE'><glossterm>PACKAGE_EXCLUDE<imagedata fileref="figures/define-generic.png" /></glossterm> 7677 <glossentry id='var-PACKAGE_EXCLUDE'><glossterm>PACKAGE_EXCLUDE</glossterm>
7490 <info> 7678 <info>
7491 PACKAGE_EXCLUDE[doc] = "Packages to exclude from the installation. If a listed package is required, an error is generated." 7679 PACKAGE_EXCLUDE[doc] = "Packages to exclude from the installation. If a listed package is required, an error is generated."
7492 </info> 7680 </info>
7493 <glossdef> 7681 <glossdef>
7494 <para> 7682 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7495 Lists packages that should not be installed into an image. 7683 Lists packages that should not be installed into an image.
7496 For example: 7684 For example:
7497 <literallayout class='monospaced'> 7685 <literallayout class='monospaced'>
7498 PACKAGE_EXCLUDE = "<replaceable>package_name</replaceable> <replaceable>package_name</replaceable> <replaceable>package_name</replaceable> ..." 7686 PACKAGE_EXCLUDE = "<replaceable>package_name</replaceable> <replaceable>package_name</replaceable> <replaceable>package_name</replaceable> ..."
7499 </literallayout> 7687 </literallayout>
7688 </para>
7689
7690 <para>
7500 You can set this variable globally in your 7691 You can set this variable globally in your
7501 <filename>local.conf</filename> file or you can attach it to 7692 <filename>local.conf</filename> file or you can attach it to
7502 a specific image recipe by using the recipe name override: 7693 a specific image recipe by using the recipe name override:
@@ -7534,23 +7725,25 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7534 </glossdef> 7725 </glossdef>
7535 </glossentry> 7726 </glossentry>
7536 7727
7537 <glossentry id='var-PACKAGE_EXTRA_ARCHS'><glossterm>PACKAGE_EXTRA_ARCHS<imagedata fileref="figures/define-generic.png" /></glossterm> 7728 <glossentry id='var-PACKAGE_EXTRA_ARCHS'><glossterm>PACKAGE_EXTRA_ARCHS</glossterm>
7538 <info> 7729 <info>
7539 PACKAGE_EXTRA_ARCHS[doc] = "Specifies the list of architectures compatible with the device CPU. This variable is useful when you build for several different devices that use miscellaneous processors." 7730 PACKAGE_EXTRA_ARCHS[doc] = "Specifies the list of architectures compatible with the device CPU. This variable is useful when you build for several different devices that use miscellaneous processors."
7540 </info> 7731 </info>
7541 <glossdef> 7732 <glossdef>
7542 <para>Specifies the list of architectures compatible with the device CPU. 7733 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7734 Specifies the list of architectures compatible with the device CPU.
7543 This variable is useful when you build for several different devices that use 7735 This variable is useful when you build for several different devices that use
7544 miscellaneous processors such as XScale and ARM926-EJS.</para> 7736 miscellaneous processors such as XScale and ARM926-EJS.
7737 </para>
7545 </glossdef> 7738 </glossdef>
7546 </glossentry> 7739 </glossentry>
7547 7740
7548 <glossentry id='var-PACKAGE_GROUP'><glossterm>PACKAGE_GROUP<imagedata fileref="figures/define-generic.png" /></glossterm> 7741 <glossentry id='var-PACKAGE_GROUP'><glossterm>PACKAGE_GROUP</glossterm>
7549 <info> 7742 <info>
7550 PACKAGE_GROUP[doc] = "Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES." 7743 PACKAGE_GROUP[doc] = "Defines one or more packages to include in an image when a specific item is included in IMAGE_FEATURES."
7551 </info> 7744 </info>
7552 <glossdef> 7745 <glossdef>
7553 <para> 7746 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7554 The <filename>PACKAGE_GROUP</filename> variable has been 7747 The <filename>PACKAGE_GROUP</filename> variable has been
7555 renamed to 7748 renamed to
7556 <link linkend='var-FEATURE_PACKAGES'><filename>FEATURE_PACKAGES</filename></link>. 7749 <link linkend='var-FEATURE_PACKAGES'><filename>FEATURE_PACKAGES</filename></link>.
@@ -7566,12 +7759,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7566 </glossdef> 7759 </glossdef>
7567 </glossentry> 7760 </glossentry>
7568 7761
7569 <glossentry id='var-PACKAGE_INSTALL'><glossterm>PACKAGE_INSTALL<imagedata fileref="figures/define-generic.png" /></glossterm> 7762 <glossentry id='var-PACKAGE_INSTALL'><glossterm>PACKAGE_INSTALL</glossterm>
7570 <info> 7763 <info>
7571 PACKAGE_INSTALL[doc] = "List of the packages to be installed into the image. The variable is generally not user-defined and uses IMAGE_INSTALL as part of the list." 7764 PACKAGE_INSTALL[doc] = "List of the packages to be installed into the image. The variable is generally not user-defined and uses IMAGE_INSTALL as part of the list."
7572 </info> 7765 </info>
7573 <glossdef> 7766 <glossdef>
7574 <para> 7767 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7575 The final list of packages passed to the package manager 7768 The final list of packages passed to the package manager
7576 for installation into the image. 7769 for installation into the image.
7577 </para> 7770 </para>
@@ -7597,12 +7790,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7597 </glossdef> 7790 </glossdef>
7598 </glossentry> 7791 </glossentry>
7599 7792
7600 <glossentry id='var-PACKAGE_INSTALL_ATTEMPTONLY'><glossterm>PACKAGE_INSTALL_ATTEMPTONLY<imagedata fileref="figures/define-generic.png" /></glossterm> 7793 <glossentry id='var-PACKAGE_INSTALL_ATTEMPTONLY'><glossterm>PACKAGE_INSTALL_ATTEMPTONLY</glossterm>
7601 <info> 7794 <info>
7602 PACKAGE_INSTALL_ATTEMPTONLY[doc] = "List of packages attempted to be installed when creating an image. If a listed package fails to install, the build system does not generate an error. This variable is generally not user-defined." 7795 PACKAGE_INSTALL_ATTEMPTONLY[doc] = "List of packages attempted to be installed when creating an image. If a listed package fails to install, the build system does not generate an error. This variable is generally not user-defined."
7603 </info> 7796 </info>
7604 <glossdef> 7797 <glossdef>
7605 <para> 7798 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7606 Specifies a list of packages the OpenEmbedded build 7799 Specifies a list of packages the OpenEmbedded build
7607 system attempts to install when creating an image. 7800 system attempts to install when creating an image.
7608 If a listed package fails to install, the build system 7801 If a listed package fails to install, the build system
@@ -7612,12 +7805,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7612 </glossdef> 7805 </glossdef>
7613 </glossentry> 7806 </glossentry>
7614 7807
7615 <glossentry id='var-PACKAGE_PREPROCESS_FUNCS'><glossterm>PACKAGE_PREPROCESS_FUNCS<imagedata fileref="figures/define-generic.png" /></glossterm> 7808 <glossentry id='var-PACKAGE_PREPROCESS_FUNCS'><glossterm>PACKAGE_PREPROCESS_FUNCS</glossterm>
7616 <info> 7809 <info>
7617 PACKAGE_PREPROCESS_FUNCS[doc] = "Specifies a list of functions run to pre-process the PKGD directory prior to splitting the files out to individual packages." 7810 PACKAGE_PREPROCESS_FUNCS[doc] = "Specifies a list of functions run to pre-process the PKGD directory prior to splitting the files out to individual packages."
7618 </info> 7811 </info>
7619 <glossdef> 7812 <glossdef>
7620 <para> 7813 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7621 Specifies a list of functions run to pre-process the 7814 Specifies a list of functions run to pre-process the
7622 <link linkend='var-PKGD'><filename>PKGD</filename></link> 7815 <link linkend='var-PKGD'><filename>PKGD</filename></link>
7623 directory prior to splitting the files out to individual 7816 directory prior to splitting the files out to individual
@@ -7626,12 +7819,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7626 </glossdef> 7819 </glossdef>
7627 </glossentry> 7820 </glossentry>
7628 7821
7629 <glossentry id='var-PACKAGECONFIG'><glossterm>PACKAGECONFIG<imagedata fileref="figures/define-generic.png" /></glossterm> 7822 <glossentry id='var-PACKAGECONFIG'><glossterm>PACKAGECONFIG</glossterm>
7630 <info> 7823 <info>
7631 PACKAGECONFIG[doc] = "This variable provides a means of enabling or disabling features of a recipe on a per-recipe basis." 7824 PACKAGECONFIG[doc] = "This variable provides a means of enabling or disabling features of a recipe on a per-recipe basis."
7632 </info> 7825 </info>
7633 <glossdef> 7826 <glossdef>
7634 <para> 7827 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7635 This variable provides a means of enabling or disabling 7828 This variable provides a means of enabling or disabling
7636 features of a recipe on a per-recipe basis. 7829 features of a recipe on a per-recipe basis.
7637 <filename>PACKAGECONFIG</filename> blocks are defined 7830 <filename>PACKAGECONFIG</filename> blocks are defined
@@ -7644,6 +7837,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7644 PACKAGECONFIG[f2] = "--with-f2,--without-f2,build-deps-f2,rt-deps-f2" 7837 PACKAGECONFIG[f2] = "--with-f2,--without-f2,build-deps-f2,rt-deps-f2"
7645 PACKAGECONFIG[f3] = "--with-f3,--without-f3,build-deps-f3,rt-deps-f3" 7838 PACKAGECONFIG[f3] = "--with-f3,--without-f3,build-deps-f3,rt-deps-f3"
7646 </literallayout> 7839 </literallayout>
7840 </para>
7841
7842 <para>
7647 The <filename>PACKAGECONFIG</filename> 7843 The <filename>PACKAGECONFIG</filename>
7648 variable itself specifies a space-separated list of the 7844 variable itself specifies a space-separated list of the
7649 features to enable. 7845 features to enable.
@@ -7744,12 +7940,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7744 </glossdef> 7940 </glossdef>
7745 </glossentry> 7941 </glossentry>
7746 7942
7747 <glossentry id='var-PACKAGEGROUP_DISABLE_COMPLEMENTARY'><glossterm>PACKAGEGROUP_DISABLE_COMPLEMENTARY<imagedata fileref="figures/define-generic.png" /></glossterm> 7943 <glossentry id='var-PACKAGEGROUP_DISABLE_COMPLEMENTARY'><glossterm>PACKAGEGROUP_DISABLE_COMPLEMENTARY</glossterm>
7748 <info> 7944 <info>
7749 PACKAGEGROUP_DISABLE_COMPLEMENTARY[doc] = "Prevents automatic creation of the normal complementary packages such as -dev and -dbg in a packagegroup recipe." 7945 PACKAGEGROUP_DISABLE_COMPLEMENTARY[doc] = "Prevents automatic creation of the normal complementary packages such as -dev and -dbg in a packagegroup recipe."
7750 </info> 7946 </info>
7751 <glossdef> 7947 <glossdef>
7752 <para> 7948 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7753 For recipes inheriting the 7949 For recipes inheriting the
7754 <link linkend='ref-classes-packagegroup'><filename>packagegroup</filename></link> 7950 <link linkend='ref-classes-packagegroup'><filename>packagegroup</filename></link>
7755 class, setting 7951 class, setting
@@ -7764,25 +7960,27 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7764 </glossdef> 7960 </glossdef>
7765 </glossentry> 7961 </glossentry>
7766 7962
7767 <glossentry id='var-PACKAGES'><glossterm>PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 7963 <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm>
7768 <info> 7964 <info>
7769 PACKAGES[doc] = "The list of packages to be created from the recipe." 7965 PACKAGES[doc] = "The list of packages to be created from the recipe."
7770 </info> 7966 </info>
7771 <glossdef> 7967 <glossdef>
7772 <para>The list of packages to be created from the recipe. 7968 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7969 The list of packages to be created from the recipe.
7773 The default value is the following: 7970 The default value is the following:
7774 <literallayout class='monospaced'> 7971 <literallayout class='monospaced'>
7775 ${PN}-dbg ${PN}-staticdev ${PN}-dev ${PN}-doc ${PN}-locale ${PACKAGE_BEFORE_PN} ${PN} 7972 ${PN}-dbg ${PN}-staticdev ${PN}-dev ${PN}-doc ${PN}-locale ${PACKAGE_BEFORE_PN} ${PN}
7776 </literallayout></para> 7973 </literallayout>
7974 </para>
7777 </glossdef> 7975 </glossdef>
7778 </glossentry> 7976 </glossentry>
7779 7977
7780 <glossentry id='var-PACKAGES_DYNAMIC'><glossterm>PACKAGES_DYNAMIC<imagedata fileref="figures/define-generic.png" /></glossterm> 7978 <glossentry id='var-PACKAGES_DYNAMIC'><glossterm>PACKAGES_DYNAMIC</glossterm>
7781 <info> 7979 <info>
7782 PACKAGES_DYNAMIC[doc] = "A promise that your recipe satisfies runtime dependencies for optional modules that are found in other recipes." 7980 PACKAGES_DYNAMIC[doc] = "A promise that your recipe satisfies runtime dependencies for optional modules that are found in other recipes."
7783 </info> 7981 </info>
7784 <glossdef> 7982 <glossdef>
7785 <para> 7983 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7786 A promise that your recipe satisfies runtime dependencies 7984 A promise that your recipe satisfies runtime dependencies
7787 for optional modules that are found in other recipes. 7985 for optional modules that are found in other recipes.
7788 <filename>PACKAGES_DYNAMIC</filename> 7986 <filename>PACKAGES_DYNAMIC</filename>
@@ -7800,6 +7998,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7800 <link linkend='ref-tasks-rootfs'><filename>do_rootfs</filename></link> 7998 <link linkend='ref-tasks-rootfs'><filename>do_rootfs</filename></link>
7801 task. 7999 task.
7802 </para> 8000 </para>
8001
7803 <para> 8002 <para>
7804 Typically, if there is a chance that such a situation can 8003 Typically, if there is a chance that such a situation can
7805 occur and the package that is not created is valid 8004 occur and the package that is not created is valid
@@ -7818,12 +8017,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7818 </glossdef> 8017 </glossdef>
7819 </glossentry> 8018 </glossentry>
7820 8019
7821 <glossentry id='var-PACKAGESPLITFUNCS'><glossterm>PACKAGESPLITFUNCS<imagedata fileref="figures/define-generic.png" /></glossterm> 8020 <glossentry id='var-PACKAGESPLITFUNCS'><glossterm>PACKAGESPLITFUNCS</glossterm>
7822 <info> 8021 <info>
7823 PACKAGESPLITFUNCS[doc] = "Specifies a list of functions run to perform additional splitting of files into individual packages." 8022 PACKAGESPLITFUNCS[doc] = "Specifies a list of functions run to perform additional splitting of files into individual packages."
7824 </info> 8023 </info>
7825 <glossdef> 8024 <glossdef>
7826 <para> 8025 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7827 Specifies a list of functions run to perform additional 8026 Specifies a list of functions run to perform additional
7828 splitting of files into individual packages. 8027 splitting of files into individual packages.
7829 Recipes can either prepend to this variable or prepend 8028 Recipes can either prepend to this variable or prepend
@@ -7839,12 +8038,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7839 </glossdef> 8038 </glossdef>
7840 </glossentry> 8039 </glossentry>
7841 8040
7842 <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE<imagedata fileref="figures/define-generic.png" /></glossterm> 8041 <glossentry id='var-PARALLEL_MAKE'><glossterm>PARALLEL_MAKE</glossterm>
7843 <info> 8042 <info>
7844 PARALLEL_MAKE[doc] = "Specifies extra options that are passed to the make command during the compile tasks. This variable is usually in the form -j 4, where the number represents the maximum number of parallel threads make can run." 8043 PARALLEL_MAKE[doc] = "Specifies extra options that are passed to the make command during the compile tasks. This variable is usually in the form -j 4, where the number represents the maximum number of parallel threads make can run."
7845 </info> 8044 </info>
7846 <glossdef> 8045 <glossdef>
7847 <para> 8046 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7848 Extra options passed to the <filename>make</filename> 8047 Extra options passed to the <filename>make</filename>
7849 command during the 8048 command during the
7850 <link linkend='ref-tasks-compile'><filename>do_compile</filename></link> 8049 <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>
@@ -7868,12 +8067,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7868 </glossdef> 8067 </glossdef>
7869 </glossentry> 8068 </glossentry>
7870 8069
7871 <glossentry id='var-PARALLEL_MAKEINST'><glossterm>PARALLEL_MAKEINST<imagedata fileref="figures/define-generic.png" /></glossterm> 8070 <glossentry id='var-PARALLEL_MAKEINST'><glossterm>PARALLEL_MAKEINST</glossterm>
7872 <info> 8071 <info>
7873 PARALLEL_MAKEINST[doc] = "Extra options passed to the make install command during the do_install task in order to specify parallel installation." 8072 PARALLEL_MAKEINST[doc] = "Extra options passed to the make install command during the do_install task in order to specify parallel installation."
7874 </info> 8073 </info>
7875 <glossdef> 8074 <glossdef>
7876 <para> 8075 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7877 Extra options passed to the 8076 Extra options passed to the
7878 <filename>make install</filename> command during the 8077 <filename>make install</filename> command during the
7879 <link linkend='ref-tasks-install'><filename>do_install</filename></link> 8078 <link linkend='ref-tasks-install'><filename>do_install</filename></link>
@@ -7889,12 +8088,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7889 </glossdef> 8088 </glossdef>
7890 </glossentry> 8089 </glossentry>
7891 8090
7892 <glossentry id='var-PATCHRESOLVE'><glossterm>PATCHRESOLVE<imagedata fileref="figures/define-generic.png" /></glossterm> 8091 <glossentry id='var-PATCHRESOLVE'><glossterm>PATCHRESOLVE</glossterm>
7893 <info> 8092 <info>
7894 PATCHRESOLVE[doc] = "Enable or disable interactive patch resolution." 8093 PATCHRESOLVE[doc] = "Enable or disable interactive patch resolution."
7895 </info> 8094 </info>
7896 <glossdef> 8095 <glossdef>
7897 <para> 8096 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7898 Determines the action to take when a patch fails. 8097 Determines the action to take when a patch fails.
7899 You can set this variable to one of two values: "noop" and 8098 You can set this variable to one of two values: "noop" and
7900 "user". 8099 "user".
@@ -7916,12 +8115,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7916 </glossdef> 8115 </glossdef>
7917 </glossentry> 8116 </glossentry>
7918 8117
7919 <glossentry id='var-PATCHTOOL'><glossterm>PATCHTOOL<imagedata fileref="figures/define-generic.png" /></glossterm> 8118 <glossentry id='var-PATCHTOOL'><glossterm>PATCHTOOL</glossterm>
7920 <info> 8119 <info>
7921 PATCHTOOL[doc] = "Specifies the utility used to apply patches for a recipe during do_patch." 8120 PATCHTOOL[doc] = "Specifies the utility used to apply patches for a recipe during do_patch."
7922 </info> 8121 </info>
7923 <glossdef> 8122 <glossdef>
7924 <para> 8123 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7925 Specifies the utility used to apply patches for a recipe 8124 Specifies the utility used to apply patches for a recipe
7926 during the 8125 during the
7927 <link linkend='ref-tasks-patch'><filename>do_patch</filename></link> 8126 <link linkend='ref-tasks-patch'><filename>do_patch</filename></link>
@@ -7946,12 +8145,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7946 </glossdef> 8145 </glossdef>
7947 </glossentry> 8146 </glossentry>
7948 8147
7949 <glossentry id='var-PE'><glossterm>PE<imagedata fileref="figures/define-generic.png" /></glossterm> 8148 <glossentry id='var-PE'><glossterm>PE</glossterm>
7950 <info> 8149 <info>
7951 PE[doc] = "The epoch of the recipe. The default value is '0'. The field is used to make upgrades possible when the versioning scheme changes in some backwards incompatible way." 8150 PE[doc] = "The epoch of the recipe. The default value is '0'. The field is used to make upgrades possible when the versioning scheme changes in some backwards incompatible way."
7952 </info> 8151 </info>
7953 <glossdef> 8152 <glossdef>
7954 <para> 8153 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7955 The epoch of the recipe. 8154 The epoch of the recipe.
7956 By default, this variable is unset. 8155 By default, this variable is unset.
7957 The variable is used to make upgrades possible when the 8156 The variable is used to make upgrades possible when the
@@ -7961,27 +8160,29 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7961 </glossdef> 8160 </glossdef>
7962 </glossentry> 8161 </glossentry>
7963 8162
7964 <glossentry id='var-PF'><glossterm>PF<imagedata fileref="figures/define-generic.png" /></glossterm> 8163 <glossentry id='var-PF'><glossterm>PF</glossterm>
7965 <info> 8164 <info>
7966 PF[doc] = "Specifies the recipe or package name and includes all version and revision numbers. This variable is comprised of ${PN}-${EXTENDPE}${PV}-${PR}." 8165 PF[doc] = "Specifies the recipe or package name and includes all version and revision numbers. This variable is comprised of ${PN}-${EXTENDPE}${PV}-${PR}."
7967 </info> 8166 </info>
7968 <glossdef> 8167 <glossdef>
7969 <para>Specifies the recipe or package name and includes all version and revision 8168 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8169 Specifies the recipe or package name and includes all version and revision
7970 numbers (i.e. <filename>glibc-2.13-r20+svnr15508/</filename> and 8170 numbers (i.e. <filename>glibc-2.13-r20+svnr15508/</filename> and
7971 <filename>bash-4.2-r1/</filename>). 8171 <filename>bash-4.2-r1/</filename>).
7972 This variable is comprised of the following: 8172 This variable is comprised of the following:
7973 <literallayout class='monospaced'> 8173 <literallayout class='monospaced'>
7974 ${<link linkend='var-PN'>PN</link>}-${<link linkend='var-EXTENDPE'>EXTENDPE</link>}${<link linkend='var-PV'>PV</link>}-${<link linkend='var-PR'>PR</link>} 8174 ${<link linkend='var-PN'>PN</link>}-${<link linkend='var-EXTENDPE'>EXTENDPE</link>}${<link linkend='var-PV'>PV</link>}-${<link linkend='var-PR'>PR</link>}
7975 </literallayout></para> 8175 </literallayout>
8176 </para>
7976 </glossdef> 8177 </glossdef>
7977 </glossentry> 8178 </glossentry>
7978 8179
7979 <glossentry id='var-PIXBUF_PACKAGES'><glossterm>PIXBUF_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 8180 <glossentry id='var-PIXBUF_PACKAGES'><glossterm>PIXBUF_PACKAGES</glossterm>
7980 <info> 8181 <info>
7981 PIXBUF_PACKAGES[doc] = "When a recipe inherits the pixbufcache class, this variable identifies packages that contain the pixbuf loaders used with gdk-pixbuf." 8182 PIXBUF_PACKAGES[doc] = "When a recipe inherits the pixbufcache class, this variable identifies packages that contain the pixbuf loaders used with gdk-pixbuf."
7982 </info> 8183 </info>
7983 <glossdef> 8184 <glossdef>
7984 <para> 8185 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
7985 When inheriting the 8186 When inheriting the
7986 <link linkend='ref-classes-pixbufcache'><filename>pixbufcache</filename></link> 8187 <link linkend='ref-classes-pixbufcache'><filename>pixbufcache</filename></link>
7987 class, this variable identifies packages that contain 8188 class, this variable identifies packages that contain
@@ -7996,18 +8197,21 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7996 </glossdef> 8197 </glossdef>
7997 </glossentry> 8198 </glossentry>
7998 8199
7999 <glossentry id='var-PKG'><glossterm>PKG<imagedata fileref="figures/define-generic.png" /></glossterm> 8200 <glossentry id='var-PKG'><glossterm>PKG</glossterm>
8000 <info> 8201 <info>
8001 PKG[doc] = "The name of the resulting package created by the OpenEmbedded build system. When you use this variable, you must use a package name override." 8202 PKG[doc] = "The name of the resulting package created by the OpenEmbedded build system. When you use this variable, you must use a package name override."
8002 </info> 8203 </info>
8003 <glossdef> 8204 <glossdef>
8004 <para> 8205 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8005 The name of the resulting package created by the 8206 The name of the resulting package created by the
8006 OpenEmbedded build system. 8207 OpenEmbedded build system.
8007 <note> 8208 <note>
8008 When using the <filename>PKG</filename> variable, you 8209 When using the <filename>PKG</filename> variable, you
8009 must use a package name override. 8210 must use a package name override.
8010 </note> 8211 </note>
8212 </para>
8213
8214 <para>
8011 For example, when the 8215 For example, when the
8012 <link linkend='ref-classes-debian'><filename>debian</filename></link> 8216 <link linkend='ref-classes-debian'><filename>debian</filename></link>
8013 class renames the output package, it does so by setting 8217 class renames the output package, it does so by setting
@@ -8016,12 +8220,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8016 </glossdef> 8220 </glossdef>
8017 </glossentry> 8221 </glossentry>
8018 8222
8019 <glossentry id='var-PKG_CONFIG_PATH'><glossterm>PKG_CONFIG_PATH<imagedata fileref="figures/define-generic.png" /></glossterm> 8223 <glossentry id='var-PKG_CONFIG_PATH'><glossterm>PKG_CONFIG_PATH</glossterm>
8020 <info> 8224 <info>
8021 PKG_CONFIG_PATH[doc] = "Path to pkg-config files for the current build context." 8225 PKG_CONFIG_PATH[doc] = "Path to pkg-config files for the current build context."
8022 </info> 8226 </info>
8023 <glossdef> 8227 <glossdef>
8024 <para> 8228 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8025 The path to <filename>pkg-config</filename> files for the 8229 The path to <filename>pkg-config</filename> files for the
8026 current build context. 8230 current build context.
8027 <filename>pkg-config</filename> reads this variable 8231 <filename>pkg-config</filename> reads this variable
@@ -8030,29 +8234,32 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8030 </glossdef> 8234 </glossdef>
8031 </glossentry> 8235 </glossentry>
8032 8236
8033 <glossentry id='var-PKGD'><glossterm>PKGD<imagedata fileref="figures/define-generic.png" /></glossterm> 8237 <glossentry id='var-PKGD'><glossterm>PKGD</glossterm>
8034 <info> 8238 <info>
8035 PKGD[doc] = "Points to the destination directory for files to be packaged before they are split into individual packages." 8239 PKGD[doc] = "Points to the destination directory for files to be packaged before they are split into individual packages."
8036 </info> 8240 </info>
8037 <glossdef> 8241 <glossdef>
8038 <para> 8242 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8039 Points to the destination directory for files to be 8243 Points to the destination directory for files to be
8040 packaged before they are split into individual packages. 8244 packaged before they are split into individual packages.
8041 This directory defaults to the following: 8245 This directory defaults to the following:
8042 <literallayout class='monospaced'> 8246 <literallayout class='monospaced'>
8043 ${WORKDIR}/package 8247 ${WORKDIR}/package
8044 </literallayout> 8248 </literallayout>
8249 </para>
8250
8251 <para>
8045 Do not change this default. 8252 Do not change this default.
8046 </para> 8253 </para>
8047 </glossdef> 8254 </glossdef>
8048 </glossentry> 8255 </glossentry>
8049 8256
8050 <glossentry id='var-PKGDATA_DIR'><glossterm>PKGDATA_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 8257 <glossentry id='var-PKGDATA_DIR'><glossterm>PKGDATA_DIR</glossterm>
8051 <info> 8258 <info>
8052 PKGDATA_DIR[doc] = "Points to a shared, global-state directory that holds data generated during the packaging process." 8259 PKGDATA_DIR[doc] = "Points to a shared, global-state directory that holds data generated during the packaging process."
8053 </info> 8260 </info>
8054 <glossdef> 8261 <glossdef>
8055 <para> 8262 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8056 Points to a shared, global-state directory that holds data 8263 Points to a shared, global-state directory that holds data
8057 generated during the packaging process. 8264 generated during the packaging process.
8058 During the packaging process, the 8265 During the packaging process, the
@@ -8063,23 +8270,29 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8063 <literallayout class='monospaced'> 8270 <literallayout class='monospaced'>
8064 ${STAGING_DIR_HOST}/pkgdata 8271 ${STAGING_DIR_HOST}/pkgdata
8065 </literallayout> 8272 </literallayout>
8273 </para>
8274
8275 <para>
8066 Do not change this default. 8276 Do not change this default.
8067 </para> 8277 </para>
8068 </glossdef> 8278 </glossdef>
8069 </glossentry> 8279 </glossentry>
8070 8280
8071 <glossentry id='var-PKGDEST'><glossterm>PKGDEST<imagedata fileref="figures/define-generic.png" /></glossterm> 8281 <glossentry id='var-PKGDEST'><glossterm>PKGDEST</glossterm>
8072 <info> 8282 <info>
8073 PKGDEST[doc] = "Points to the parent directory for files to be packaged after they have been split into individual packages." 8283 PKGDEST[doc] = "Points to the parent directory for files to be packaged after they have been split into individual packages."
8074 </info> 8284 </info>
8075 <glossdef> 8285 <glossdef>
8076 <para> 8286 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8077 Points to the parent directory for files to be packaged 8287 Points to the parent directory for files to be packaged
8078 after they have been split into individual packages. 8288 after they have been split into individual packages.
8079 This directory defaults to the following: 8289 This directory defaults to the following:
8080 <literallayout class='monospaced'> 8290 <literallayout class='monospaced'>
8081 ${WORKDIR}/packages-split 8291 ${WORKDIR}/packages-split
8082 </literallayout> 8292 </literallayout>
8293 </para>
8294
8295 <para>
8083 Under this directory, the build system creates 8296 Under this directory, the build system creates
8084 directories for each package specified in 8297 directories for each package specified in
8085 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>. 8298 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>.
@@ -8088,12 +8301,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8088 </glossdef> 8301 </glossdef>
8089 </glossentry> 8302 </glossentry>
8090 8303
8091 <glossentry id='var-PKGDESTWORK'><glossterm>PKGDESTWORK<imagedata fileref="figures/define-generic.png" /></glossterm> 8304 <glossentry id='var-PKGDESTWORK'><glossterm>PKGDESTWORK</glossterm>
8092 <info> 8305 <info>
8093 PKGDESTWORK[doc] = "Points to a temporary work area used by the do_package task to write output from the do_packagedata task." 8306 PKGDESTWORK[doc] = "Points to a temporary work area used by the do_package task to write output from the do_packagedata task."
8094 </info> 8307 </info>
8095 <glossdef> 8308 <glossdef>
8096 <para> 8309 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8097 Points to a temporary work area used by the 8310 Points to a temporary work area used by the
8098 <link linkend='ref-tasks-package'><filename>do_package</filename></link> 8311 <link linkend='ref-tasks-package'><filename>do_package</filename></link>
8099 task to write output from the 8312 task to write output from the
@@ -8104,6 +8317,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8104 <literallayout class='monospaced'> 8317 <literallayout class='monospaced'>
8105 ${WORKDIR}/pkgdata 8318 ${WORKDIR}/pkgdata
8106 </literallayout> 8319 </literallayout>
8320 </para>
8321
8322 <para>
8107 The <filename>do_packagedata</filename> task then packages 8323 The <filename>do_packagedata</filename> task then packages
8108 the data in the temporary work area and installs it into a 8324 the data in the temporary work area and installs it into a
8109 shared directory pointed to by 8325 shared directory pointed to by
@@ -8116,12 +8332,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8116 </glossdef> 8332 </glossdef>
8117 </glossentry> 8333 </glossentry>
8118 8334
8119 <glossentry id='var-PKGE'><glossterm>PKGE<imagedata fileref="figures/define-generic.png" /></glossterm> 8335 <glossentry id='var-PKGE'><glossterm>PKGE</glossterm>
8120 <info> 8336 <info>
8121 PKGE[doc] = "The epoch of the output package built by the OpenEmbedded build system." 8337 PKGE[doc] = "The epoch of the output package built by the OpenEmbedded build system."
8122 </info> 8338 </info>
8123 <glossdef> 8339 <glossdef>
8124 <para> 8340 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8125 The epoch of the output package built by the 8341 The epoch of the output package built by the
8126 OpenEmbedded build system. 8342 OpenEmbedded build system.
8127 By default, <filename>PKGE</filename> is set to 8343 By default, <filename>PKGE</filename> is set to
@@ -8130,26 +8346,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8130 </glossdef> 8346 </glossdef>
8131 </glossentry> 8347 </glossentry>
8132 8348
8133 <glossentry id='var-PKGR'><glossterm>PKGR<imagedata fileref="figures/define-generic.png" /></glossterm> 8349 <glossentry id='var-PKGR'><glossterm>PKGR</glossterm>
8134 <info> 8350 <info>
8135 PKGR[doc] = "The revision of the output package built by the OpenEmbedded build system." 8351 PKGR[doc] = "The revision of the output package built by the OpenEmbedded build system."
8136 </info> 8352 </info>
8137 <glossdef> 8353 <glossdef>
8138 <para> 8354 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8139 The revision of the output package built by the 8355 The revision of the output package built by the
8140 OpenEmbedded build system. 8356 OpenEmbedded build system.
8141 By default, <filename>PKGR</filename> is set to 8357 By default, <filename>PKGR</filename> is set to
8142 <link linkend='var-PR'><filename>PR</filename></link>. 8358 <link linkend='var-PR'><filename>PR</filename></link>.
8143 </para> 8359 </para>
8144 </glossdef> 8360 </glossdef>
8145 </glossentry> 8361 </glossentry>
8146 8362
8147 <glossentry id='var-PKGV'><glossterm>PKGV<imagedata fileref="figures/define-generic.png" /></glossterm> 8363 <glossentry id='var-PKGV'><glossterm>PKGV</glossterm>
8148 <info> 8364 <info>
8149 PKGV[doc] = "The version of the output package built by the OpenEmbedded build system." 8365 PKGV[doc] = "The version of the output package built by the OpenEmbedded build system."
8150 </info> 8366 </info>
8151 <glossdef> 8367 <glossdef>
8152 <para> 8368 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8153 The version of the output package built by the 8369 The version of the output package built by the
8154 OpenEmbedded build system. 8370 OpenEmbedded build system.
8155 By default, <filename>PKGV</filename> is set to 8371 By default, <filename>PKGV</filename> is set to
@@ -8158,23 +8374,32 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8158 </glossdef> 8374 </glossdef>
8159 </glossentry> 8375 </glossentry>
8160 8376
8161 <glossentry id='var-PN'><glossterm>PN<imagedata fileref="figures/define-generic.png" /></glossterm> 8377 <glossentry id='var-PN'><glossterm>PN</glossterm>
8162 <info> 8378 <info>
8163 PN[doc] = "PN refers to a recipe name in the context of a file used by the OpenEmbedded build system as input to create a package. It refers to a package name in the context of a file created or produced by the OpenEmbedded build system." 8379 PN[doc] = "PN refers to a recipe name in the context of a file used by the OpenEmbedded build system as input to create a package. It refers to a package name in the context of a file created or produced by the OpenEmbedded build system."
8164 </info> 8380 </info>
8165 <glossdef> 8381 <glossdef>
8166 <para>This variable can have two separate functions depending on the context: a recipe 8382 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8167 name or a resulting package name.</para> 8383 This variable can have two separate functions depending on the context: a recipe
8168 <para><filename>PN</filename> refers to a recipe name in the context of a file used 8384 name or a resulting package name.
8385 </para>
8386
8387 <para>
8388 <filename>PN</filename> refers to a recipe name in the context of a file used
8169 by the OpenEmbedded build system as input to create a package. 8389 by the OpenEmbedded build system as input to create a package.
8170 The name is normally extracted from the recipe file name. 8390 The name is normally extracted from the recipe file name.
8171 For example, if the recipe is named 8391 For example, if the recipe is named
8172 <filename>expat_2.0.1.bb</filename>, then the default value of <filename>PN</filename> 8392 <filename>expat_2.0.1.bb</filename>, then the default value of <filename>PN</filename>
8173 will be "expat".</para> 8393 will be "expat".
8394 </para>
8395
8174 <para> 8396 <para>
8175 The variable refers to a package name in the context of a file created or produced by the 8397 The variable refers to a package name in the context of a file created or produced by the
8176 OpenEmbedded build system.</para> 8398 OpenEmbedded build system.
8177 <para>If applicable, the <filename>PN</filename> variable also contains any special 8399 </para>
8400
8401 <para>
8402 If applicable, the <filename>PN</filename> variable also contains any special
8178 suffix or prefix. 8403 suffix or prefix.
8179 For example, using <filename>bash</filename> to build packages for the native 8404 For example, using <filename>bash</filename> to build packages for the native
8180 machine, <filename>PN</filename> is <filename>bash-native</filename>. 8405 machine, <filename>PN</filename> is <filename>bash-native</filename>.
@@ -8185,12 +8410,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8185 </glossdef> 8410 </glossdef>
8186 </glossentry> 8411 </glossentry>
8187 8412
8188 <glossentry id='var-PNBLACKLIST'><glossterm>PNBLACKLIST<imagedata fileref="figures/define-generic.png" /></glossterm> 8413 <glossentry id='var-PNBLACKLIST'><glossterm>PNBLACKLIST</glossterm>
8189 <info> 8414 <info>
8190 PNBLACKLIST[doc] = "Lists recipes you do not want the OpenEmbedded build system to build." 8415 PNBLACKLIST[doc] = "Lists recipes you do not want the OpenEmbedded build system to build."
8191 </info> 8416 </info>
8192 <glossdef> 8417 <glossdef>
8193 <para> 8418 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8194 Lists recipes you do not want the OpenEmbedded build system 8419 Lists recipes you do not want the OpenEmbedded build system
8195 to build. 8420 to build.
8196 This variable works in conjunction with the 8421 This variable works in conjunction with the
@@ -8212,24 +8437,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8212 </glossdef> 8437 </glossdef>
8213 </glossentry> 8438 </glossentry>
8214 8439
8215 <glossentry id='var-PR'><glossterm>PR<imagedata fileref="figures/define-generic.png" /></glossterm> 8440 <glossentry id='var-PR'><glossterm>PR</glossterm>
8216 <info> 8441 <info>
8217 PR[doc] = "The revision of the recipe. The default value for this variable is 'r0'." 8442 PR[doc] = "The revision of the recipe. The default value for this variable is 'r0'."
8218 </info> 8443 </info>
8219 <glossdef> 8444 <glossdef>
8220 <para> 8445 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8221 The revision of the recipe. 8446 The revision of the recipe.
8222 The default value for this variable is "r0". 8447 The default value for this variable is "r0".
8223 </para> 8448 </para>
8224 </glossdef> 8449 </glossdef>
8225 </glossentry> 8450 </glossentry>
8226 8451
8227 <glossentry id='var-PREFERRED_PROVIDER'><glossterm>PREFERRED_PROVIDER<imagedata fileref="figures/define-generic.png" /></glossterm> 8452 <glossentry id='var-PREFERRED_PROVIDER'><glossterm>PREFERRED_PROVIDER</glossterm>
8228 <info> 8453 <info>
8229 PREFERRED_PROVIDER[doc] = "If multiple recipes provide an item, this variable determines which recipe should be given preference." 8454 PREFERRED_PROVIDER[doc] = "If multiple recipes provide an item, this variable determines which recipe should be given preference."
8230 </info> 8455 </info>
8231 <glossdef> 8456 <glossdef>
8232 <para> 8457 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8233 If multiple recipes provide an item, this variable 8458 If multiple recipes provide an item, this variable
8234 determines which recipe should be given preference. 8459 determines which recipe should be given preference.
8235 You should always suffix the variable with the name of the 8460 You should always suffix the variable with the name of the
@@ -8246,12 +8471,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8246 </glossdef> 8471 </glossdef>
8247 </glossentry> 8472 </glossentry>
8248 8473
8249 <glossentry id='var-PREFERRED_VERSION'><glossterm>PREFERRED_VERSION<imagedata fileref="figures/define-generic.png" /></glossterm> 8474 <glossentry id='var-PREFERRED_VERSION'><glossterm>PREFERRED_VERSION</glossterm>
8250 <info> 8475 <info>
8251 PREFERRED_VERSION[doc] = "If there are multiple versions of recipes available, this variable determines which recipe should be given preference." 8476 PREFERRED_VERSION[doc] = "If there are multiple versions of recipes available, this variable determines which recipe should be given preference."
8252 </info> 8477 </info>
8253 <glossdef> 8478 <glossdef>
8254 <para> 8479 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8255 If there are multiple versions of recipes available, this 8480 If there are multiple versions of recipes available, this
8256 variable determines which recipe should be given preference. 8481 variable determines which recipe should be given preference.
8257 You must always suffix the variable with the 8482 You must always suffix the variable with the
@@ -8272,12 +8497,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8272 </glossdef> 8497 </glossdef>
8273 </glossentry> 8498 </glossentry>
8274 8499
8275 <glossentry id='var-PREMIRRORS'><glossterm>PREMIRRORS<imagedata fileref="figures/define-generic.png" /></glossterm> 8500 <glossentry id='var-PREMIRRORS'><glossterm>PREMIRRORS</glossterm>
8276 <info> 8501 <info>
8277 PREMIRRORS[doc] = "Specifies additional paths from which the OpenEmbedded build system gets source code." 8502 PREMIRRORS[doc] = "Specifies additional paths from which the OpenEmbedded build system gets source code."
8278 </info> 8503 </info>
8279 <glossdef> 8504 <glossdef>
8280 <para> 8505 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8281 Specifies additional paths from which the OpenEmbedded 8506 Specifies additional paths from which the OpenEmbedded
8282 build system gets source code. 8507 build system gets source code.
8283 When the build system searches for source code, it first 8508 When the build system searches for source code, it first
@@ -8320,13 +8545,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8320 </glossdef> 8545 </glossdef>
8321 </glossentry> 8546 </glossentry>
8322 8547
8323 <glossentry id='var-PRINC'><glossterm>PRINC<imagedata fileref="figures/define-generic.png" /></glossterm> 8548 <glossentry id='var-PRINC'><glossterm>PRINC</glossterm>
8324 <info> 8549 <info>
8325 PRINC[doc] = "Causes the PR variable of .bbappend files to dynamically increment. This increment minimizes the impact of layer ordering. This variable defaults to '0'." 8550 PRINC[doc] = "Causes the PR variable of .bbappend files to dynamically increment. This increment minimizes the impact of layer ordering. This variable defaults to '0'."
8326 </info> 8551 </info>
8327 <glossdef> 8552 <glossdef>
8328 8553 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8329 <para>
8330 The <filename>PRINC</filename> variable has been deprecated 8554 The <filename>PRINC</filename> variable has been deprecated
8331 and triggers a warning if detected during a build. 8555 and triggers a warning if detected during a build.
8332 For 8556 For
@@ -8369,13 +8593,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8369 </glossdef> 8593 </glossdef>
8370 </glossentry> 8594 </glossentry>
8371 8595
8372 <glossentry id='var-PRIORITY'><glossterm>PRIORITY<imagedata fileref="figures/define-generic.png" /></glossterm> 8596 <glossentry id='var-PRIORITY'><glossterm>PRIORITY</glossterm>
8373 <info> 8597 <info>
8374 PRIORITY[doc] = "Indicates the importance of a package. The default value is 'optional'. Other standard values are 'required', 'standard' and 'extra'." 8598 PRIORITY[doc] = "Indicates the importance of a package. The default value is 'optional'. Other standard values are 'required', 'standard' and 'extra'."
8375 </info> 8599 </info>
8376 <glossdef> 8600 <glossdef>
8377 8601 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8378 <para>
8379 Indicates the importance of a package. 8602 Indicates the importance of a package.
8380 </para> 8603 </para>
8381 8604
@@ -8395,12 +8618,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8395 </glossdef> 8618 </glossdef>
8396 </glossentry> 8619 </glossentry>
8397 8620
8398 <glossentry id='var-PRIVATE_LIBS'><glossterm>PRIVATE_LIBS<imagedata fileref="figures/define-generic.png" /></glossterm> 8621 <glossentry id='var-PRIVATE_LIBS'><glossterm>PRIVATE_LIBS</glossterm>
8399 <info> 8622 <info>
8400 PRIVATE_LIBS[doc] = "Specifies libraries installed within a recipe that should be ignored by the OpenEmbedded build system's shared library resolver." 8623 PRIVATE_LIBS[doc] = "Specifies libraries installed within a recipe that should be ignored by the OpenEmbedded build system's shared library resolver."
8401 </info> 8624 </info>
8402 <glossdef> 8625 <glossdef>
8403 <para> 8626 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8404 Specifies libraries installed within a recipe that 8627 Specifies libraries installed within a recipe that
8405 should be ignored by the OpenEmbedded build system's 8628 should be ignored by the OpenEmbedded build system's
8406 shared library resolver. 8629 shared library resolver.
@@ -8430,12 +8653,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8430 </glossdef> 8653 </glossdef>
8431 </glossentry> 8654 </glossentry>
8432 8655
8433 <glossentry id='var-PROVIDES'><glossterm>PROVIDES<imagedata fileref="figures/define-generic.png" /></glossterm> 8656 <glossentry id='var-PROVIDES'><glossterm>PROVIDES</glossterm>
8434 <info> 8657 <info>
8435 PROVIDES[doc] = "A list of aliases that a recipe also provides. These aliases are useful for satisfying dependencies of other recipes during the build as specified by DEPENDS." 8658 PROVIDES[doc] = "A list of aliases that a recipe also provides. These aliases are useful for satisfying dependencies of other recipes during the build as specified by DEPENDS."
8436 </info> 8659 </info>
8437 <glossdef> 8660 <glossdef>
8438 <para> 8661 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8439 A list of aliases by which a particular recipe can be 8662 A list of aliases by which a particular recipe can be
8440 known. 8663 known.
8441 By default, a recipe's own 8664 By default, a recipe's own
@@ -8462,12 +8685,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8462 </glossdef> 8685 </glossdef>
8463 </glossentry> 8686 </glossentry>
8464 8687
8465 <glossentry id='var-PRSERV_HOST'><glossterm>PRSERV_HOST<imagedata fileref="figures/define-generic.png" /></glossterm> 8688 <glossentry id='var-PRSERV_HOST'><glossterm>PRSERV_HOST</glossterm>
8466 <info> 8689 <info>
8467 PRSERV_HOST[doc] = "The network based PR service host and port." 8690 PRSERV_HOST[doc] = "The network based PR service host and port."
8468 </info> 8691 </info>
8469 <glossdef> 8692 <glossdef>
8470 <para> 8693 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8471 The network based 8694 The network based
8472 <link linkend='var-PR'><filename>PR</filename></link> 8695 <link linkend='var-PR'><filename>PR</filename></link>
8473 service host and port. 8696 service host and port.
@@ -8491,12 +8714,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8491 </glossdef> 8714 </glossdef>
8492 </glossentry> 8715 </glossentry>
8493 8716
8494 <glossentry id='var-PTEST_ENABLED'><glossterm>PTEST_ENABLED<imagedata fileref="figures/define-generic.png" /></glossterm> 8717 <glossentry id='var-PTEST_ENABLED'><glossterm>PTEST_ENABLED</glossterm>
8495 <info> 8718 <info>
8496 PRSERV_HOST[doc] = "Specifies whether or not Package Test (ptest) functionality is enabled when building a recipe." 8719 PRSERV_HOST[doc] = "Specifies whether or not Package Test (ptest) functionality is enabled when building a recipe."
8497 </info> 8720 </info>
8498 <glossdef> 8721 <glossdef>
8499 <para> 8722 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8500 Specifies whether or not 8723 Specifies whether or not
8501 <ulink url='&YOCTO_DOCS_DEV_URL;#testing-packages-with-ptest'>Package Test</ulink> 8724 <ulink url='&YOCTO_DOCS_DEV_URL;#testing-packages-with-ptest'>Package Test</ulink>
8502 (ptest) functionality is enabled when building a recipe. 8725 (ptest) functionality is enabled when building a recipe.
@@ -8509,12 +8732,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8509 </glossdef> 8732 </glossdef>
8510 </glossentry> 8733 </glossentry>
8511 8734
8512 <glossentry id='var-PV'><glossterm>PV<imagedata fileref="figures/define-generic.png" /></glossterm> 8735 <glossentry id='var-PV'><glossterm>PV</glossterm>
8513 <info> 8736 <info>
8514 PV[doc] = "The version of the recipe. The version is normally extracted from the recipe filename." 8737 PV[doc] = "The version of the recipe. The version is normally extracted from the recipe filename."
8515 </info> 8738 </info>
8516 <glossdef> 8739 <glossdef>
8517 <para> 8740 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8518 The version of the recipe. 8741 The version of the recipe.
8519 The version is normally extracted from the recipe filename. 8742 The version is normally extracted from the recipe filename.
8520 For example, if the recipe is named 8743 For example, if the recipe is named
@@ -8527,12 +8750,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8527 </glossdef> 8750 </glossdef>
8528 </glossentry> 8751 </glossentry>
8529 8752
8530 <glossentry id='var-PYTHON_ABI'><glossterm>PYTHON_ABI<imagedata fileref="figures/define-generic.png" /></glossterm> 8753 <glossentry id='var-PYTHON_ABI'><glossterm>PYTHON_ABI</glossterm>
8531 <info> 8754 <info>
8532 PYTHON_ABI[doc] = "When used by recipes that inherit the distutils3, setuptools3, distutils, or setuptools classes, denotes the Application Binary Interface (ABI) currently in use for Python." 8755 PYTHON_ABI[doc] = "When used by recipes that inherit the distutils3, setuptools3, distutils, or setuptools classes, denotes the Application Binary Interface (ABI) currently in use for Python."
8533 </info> 8756 </info>
8534 <glossdef> 8757 <glossdef>
8535 <para> 8758 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8536 When used by recipes that inherit the 8759 When used by recipes that inherit the
8537 <link linkend='ref-classes-distutils3'><filename>distutils3</filename></link>, 8760 <link linkend='ref-classes-distutils3'><filename>distutils3</filename></link>,
8538 <link linkend='ref-classes-setuptools3'><filename>setuptools3</filename></link>, 8761 <link linkend='ref-classes-setuptools3'><filename>setuptools3</filename></link>,
@@ -8563,12 +8786,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8563 </glossdef> 8786 </glossdef>
8564 </glossentry> 8787 </glossentry>
8565 8788
8566 <glossentry id='var-PYTHON_PN'><glossterm>PYTHON_PN<imagedata fileref="figures/define-generic.png" /></glossterm> 8789 <glossentry id='var-PYTHON_PN'><glossterm>PYTHON_PN</glossterm>
8567 <info> 8790 <info>
8568 PYTHON_PN[doc] = "When used by recipes that inherit the distutils3, setuptools3, distutils, or setuptools classes, specifies the major Python version being built." 8791 PYTHON_PN[doc] = "When used by recipes that inherit the distutils3, setuptools3, distutils, or setuptools classes, specifies the major Python version being built."
8569 </info> 8792 </info>
8570 <glossdef> 8793 <glossdef>
8571 <para> 8794 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8572 When used by recipes that inherit the 8795 When used by recipes that inherit the
8573 <link linkend='ref-classes-distutils3'><filename>distutils3</filename></link>, 8796 <link linkend='ref-classes-distutils3'><filename>distutils3</filename></link>,
8574 <link linkend='ref-classes-setuptools3'><filename>setuptools3</filename></link>, 8797 <link linkend='ref-classes-setuptools3'><filename>setuptools3</filename></link>,
@@ -8599,12 +8822,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8599 8822
8600 <glossdiv id='var-glossary-q'><title>Q</title> 8823 <glossdiv id='var-glossary-q'><title>Q</title>
8601 8824
8602 <glossentry id='var-QMAKE_PROFILES'><glossterm>QMAKE_PROFILES<imagedata fileref="figures/define-generic.png" /></glossterm> 8825 <glossentry id='var-QMAKE_PROFILES'><glossterm>QMAKE_PROFILES</glossterm>
8603 <info> 8826 <info>
8604 QMAKE_PROFILES[doc] = "Specifies your own subset of .pro files to be built for use with qmake." 8827 QMAKE_PROFILES[doc] = "Specifies your own subset of .pro files to be built for use with qmake."
8605 </info> 8828 </info>
8606 <glossdef> 8829 <glossdef>
8607 <para> 8830 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8608 Specifies your own subset of <filename>.pro</filename> 8831 Specifies your own subset of <filename>.pro</filename>
8609 files to be built for use with 8832 files to be built for use with
8610 <filename>qmake</filename>. 8833 <filename>qmake</filename>.
@@ -8627,24 +8850,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8627 8850
8628 <glossdiv id='var-glossary-r'><title>R</title> 8851 <glossdiv id='var-glossary-r'><title>R</title>
8629 8852
8630 <glossentry id='var-RANLIB'><glossterm>RANLIB<imagedata fileref="figures/define-generic.png" /></glossterm> 8853 <glossentry id='var-RANLIB'><glossterm>RANLIB</glossterm>
8631 <info> 8854 <info>
8632 RANLIB[doc] = "Minimal command and arguments to run 'ranlib'." 8855 RANLIB[doc] = "Minimal command and arguments to run 'ranlib'."
8633 </info> 8856 </info>
8634 <glossdef> 8857 <glossdef>
8635 <para> 8858 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8636 The minimal command and arguments to run 8859 The minimal command and arguments to run
8637 <filename>ranlib</filename>. 8860 <filename>ranlib</filename>.
8638 </para> 8861 </para>
8639 </glossdef> 8862 </glossdef>
8640 </glossentry> 8863 </glossentry>
8641 8864
8642 <glossentry id='var-RCONFLICTS'><glossterm>RCONFLICTS<imagedata fileref="figures/define-generic.png" /></glossterm> 8865 <glossentry id='var-RCONFLICTS'><glossterm>RCONFLICTS</glossterm>
8643 <info> 8866 <info>
8644 RCONFLICTS[doc] = "The list of packages that conflict with another package. Note that the package will not be installed if the conflicting packages are not first removed." 8867 RCONFLICTS[doc] = "The list of packages that conflict with another package. Note that the package will not be installed if the conflicting packages are not first removed."
8645 </info> 8868 </info>
8646 <glossdef> 8869 <glossdef>
8647 <para> 8870 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8648 The list of packages that conflict with packages. 8871 The list of packages that conflict with packages.
8649 Note that packages will not be installed if conflicting 8872 Note that packages will not be installed if conflicting
8650 packages are not first removed. 8873 packages are not first removed.
@@ -8687,12 +8910,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8687 </glossdef> 8910 </glossdef>
8688 </glossentry> 8911 </glossentry>
8689 8912
8690 <glossentry id='var-RDEPENDS'><glossterm>RDEPENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 8913 <glossentry id='var-RDEPENDS'><glossterm>RDEPENDS</glossterm>
8691 <info> 8914 <info>
8692 RDEPENDS[doc] = "Lists a package's runtime dependencies (i.e. other packages) that must be installed for the package to be built. They must be the names of other packages as listed in the PACKAGES variable, not recipe names (PN)." 8915 RDEPENDS[doc] = "Lists a package's runtime dependencies (i.e. other packages) that must be installed for the package to be built. They must be the names of other packages as listed in the PACKAGES variable, not recipe names (PN)."
8693 </info> 8916 </info>
8694 <glossdef> 8917 <glossdef>
8695 <para> 8918 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8696 Lists a package's runtime dependencies (i.e. other packages) 8919 Lists a package's runtime dependencies (i.e. other packages)
8697 that must be installed in order for the built package to run 8920 that must be installed in order for the built package to run
8698 correctly. 8921 correctly.
@@ -8822,12 +9045,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8822 </glossdef> 9045 </glossdef>
8823 </glossentry> 9046 </glossentry>
8824 9047
8825 <glossentry id='var-REQUIRED_DISTRO_FEATURES'><glossterm>REQUIRED_DISTRO_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 9048 <glossentry id='var-REQUIRED_DISTRO_FEATURES'><glossterm>REQUIRED_DISTRO_FEATURES</glossterm>
8826 <info> 9049 <info>
8827 REQUIRED_DISTRO_FEATURES[doc] = "When a recipe inherits the distro_features_check class, this variable identifies distribution features that must exist in the current configuration in order for the OpenEmbedded build system to build the recipe." 9050 REQUIRED_DISTRO_FEATURES[doc] = "When a recipe inherits the distro_features_check class, this variable identifies distribution features that must exist in the current configuration in order for the OpenEmbedded build system to build the recipe."
8828 </info> 9051 </info>
8829 <glossdef> 9052 <glossdef>
8830 <para> 9053 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8831 When inheriting the 9054 When inheriting the
8832 <link linkend='ref-classes-distro_features_check'><filename>distro_features_check</filename></link> 9055 <link linkend='ref-classes-distro_features_check'><filename>distro_features_check</filename></link>
8833 class, this 9056 class, this
@@ -8844,12 +9067,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8844 </glossdef> 9067 </glossdef>
8845 </glossentry> 9068 </glossentry>
8846 9069
8847 <glossentry id='var-RM_OLD_IMAGE'><glossterm>RM_OLD_IMAGE<imagedata fileref="figures/define-generic.png" /></glossterm> 9070 <glossentry id='var-RM_OLD_IMAGE'><glossterm>RM_OLD_IMAGE</glossterm>
8848 <info> 9071 <info>
8849 RM_OLD_IMAGE[doc] = "Reclaims disk space by removing previously built versions of the same image from the images directory pointed to by the DEPLOY_DIR variable." 9072 RM_OLD_IMAGE[doc] = "Reclaims disk space by removing previously built versions of the same image from the images directory pointed to by the DEPLOY_DIR variable."
8850 </info> 9073 </info>
8851 <glossdef> 9074 <glossdef>
8852 <para> 9075 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8853 Reclaims disk space by removing previously built 9076 Reclaims disk space by removing previously built
8854 versions of the same image from the 9077 versions of the same image from the
8855 <filename>images</filename> directory pointed to by the 9078 <filename>images</filename> directory pointed to by the
@@ -8865,12 +9088,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8865 </glossdef> 9088 </glossdef>
8866 </glossentry> 9089 </glossentry>
8867 9090
8868 <glossentry id='var-RM_WORK_EXCLUDE'><glossterm>RM_WORK_EXCLUDE<imagedata fileref="figures/define-generic.png" /></glossterm> 9091 <glossentry id='var-RM_WORK_EXCLUDE'><glossterm>RM_WORK_EXCLUDE</glossterm>
8869 <info> 9092 <info>
8870 RM_WORK_EXCLUDE[doc] = "With rm_work enabled, this variable specifies a list of packages whose work directories should not be removed." 9093 RM_WORK_EXCLUDE[doc] = "With rm_work enabled, this variable specifies a list of packages whose work directories should not be removed."
8871 </info> 9094 </info>
8872 <glossdef> 9095 <glossdef>
8873 <para> 9096 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8874 With <filename>rm_work</filename> enabled, this 9097 With <filename>rm_work</filename> enabled, this
8875 variable specifies a list of recipes whose work directories 9098 variable specifies a list of recipes whose work directories
8876 should not be removed. 9099 should not be removed.
@@ -8880,12 +9103,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8880 </glossdef> 9103 </glossdef>
8881 </glossentry> 9104 </glossentry>
8882 9105
8883 <glossentry id='var-ROOT_HOME'><glossterm>ROOT_HOME<imagedata fileref="figures/define-generic.png" /></glossterm> 9106 <glossentry id='var-ROOT_HOME'><glossterm>ROOT_HOME</glossterm>
8884 <info> 9107 <info>
8885 ROOT_HOME[doc] = "Defines the root home directory." 9108 ROOT_HOME[doc] = "Defines the root home directory."
8886 </info> 9109 </info>
8887 <glossdef> 9110 <glossdef>
8888 <para> 9111 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8889 Defines the root home directory. 9112 Defines the root home directory.
8890 By default, this directory is set as follows in the 9113 By default, this directory is set as follows in the
8891 BitBake configuration file: 9114 BitBake configuration file:
@@ -8916,12 +9139,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8916 </glossdef> 9139 </glossdef>
8917 </glossentry> 9140 </glossentry>
8918 9141
8919 <glossentry id='var-ROOTFS'><glossterm>ROOTFS<imagedata fileref="figures/define-generic.png" /></glossterm> 9142 <glossentry id='var-ROOTFS'><glossterm>ROOTFS</glossterm>
8920 <info> 9143 <info>
8921 ROOTFS[doc] = "Indicates a filesystem image to include as the root filesystem." 9144 ROOTFS[doc] = "Indicates a filesystem image to include as the root filesystem."
8922 </info> 9145 </info>
8923 <glossdef> 9146 <glossdef>
8924 <para> 9147 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8925 Indicates a filesystem image to include as the root 9148 Indicates a filesystem image to include as the root
8926 filesystem. 9149 filesystem.
8927 </para> 9150 </para>
@@ -8935,18 +9158,21 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8935 </glossdef> 9158 </glossdef>
8936 </glossentry> 9159 </glossentry>
8937 9160
8938 <glossentry id='var-ROOTFS_POSTPROCESS_COMMAND'><glossterm>ROOTFS_POSTPROCESS_COMMAND<imagedata fileref="figures/define-generic.png" /></glossterm> 9161 <glossentry id='var-ROOTFS_POSTPROCESS_COMMAND'><glossterm>ROOTFS_POSTPROCESS_COMMAND</glossterm>
8939 <info> 9162 <info>
8940 ROOTFS_POSTPROCESS_COMMAND[doc] = "Added by classes to run post processing commands once the OpenEmbedded build system has created the root filesystem." 9163 ROOTFS_POSTPROCESS_COMMAND[doc] = "Added by classes to run post processing commands once the OpenEmbedded build system has created the root filesystem."
8941 </info> 9164 </info>
8942 <glossdef> 9165 <glossdef>
8943 <para> 9166 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8944 Added by classes to run post processing commands once the 9167 Added by classes to run post processing commands once the
8945 OpenEmbedded build system has created the root filesystem. 9168 OpenEmbedded build system has created the root filesystem.
8946 You can specify shell commands separated by semicolons: 9169 You can specify shell commands separated by semicolons:
8947 <literallayout class='monospaced'> 9170 <literallayout class='monospaced'>
8948 ROOTFS_POSTPROCESS_COMMAND += "<replaceable>shell_command</replaceable>; ... " 9171 ROOTFS_POSTPROCESS_COMMAND += "<replaceable>shell_command</replaceable>; ... "
8949 </literallayout> 9172 </literallayout>
9173 </para>
9174
9175 <para>
8950 If you need to pass the path to the root filesystem within 9176 If you need to pass the path to the root filesystem within
8951 the command, you can use 9177 the command, you can use
8952 <filename>${IMAGE_ROOTFS}</filename>, which points to 9178 <filename>${IMAGE_ROOTFS}</filename>, which points to
@@ -8958,12 +9184,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8958 </glossdef> 9184 </glossdef>
8959 </glossentry> 9185 </glossentry>
8960 9186
8961 <glossentry id='var-RPROVIDES'><glossterm>RPROVIDES<imagedata fileref="figures/define-generic.png" /></glossterm> 9187 <glossentry id='var-RPROVIDES'><glossterm>RPROVIDES</glossterm>
8962 <info> 9188 <info>
8963 RPROVIDES[doc] = "A list of package name aliases that a package also provides. These aliases are useful for satisfying runtime dependencies of other packages both during the build and on the target." 9189 RPROVIDES[doc] = "A list of package name aliases that a package also provides. These aliases are useful for satisfying runtime dependencies of other packages both during the build and on the target."
8964 </info> 9190 </info>
8965 <glossdef> 9191 <glossdef>
8966 <para> 9192 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8967 A list of package name aliases that a package also provides. 9193 A list of package name aliases that a package also provides.
8968 These aliases are useful for satisfying runtime dependencies 9194 These aliases are useful for satisfying runtime dependencies
8969 of other packages both during the build and on the target 9195 of other packages both during the build and on the target
@@ -8974,6 +9200,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8974 <filename>RPROVIDES</filename> list. 9200 <filename>RPROVIDES</filename> list.
8975 </note> 9201 </note>
8976 </para> 9202 </para>
9203
8977 <para> 9204 <para>
8978 As with all package-controlling variables, you must always 9205 As with all package-controlling variables, you must always
8979 use the variable in conjunction with a package name override. 9206 use the variable in conjunction with a package name override.
@@ -8985,12 +9212,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
8985 </glossdef> 9212 </glossdef>
8986 </glossentry> 9213 </glossentry>
8987 9214
8988 <glossentry id='var-RRECOMMENDS'><glossterm>RRECOMMENDS<imagedata fileref="figures/define-generic.png" /></glossterm> 9215 <glossentry id='var-RRECOMMENDS'><glossterm>RRECOMMENDS</glossterm>
8989 <info> 9216 <info>
8990 RRECOMMENDS[doc] = "A list of packages that extends the usability of a package being built. The package being built does not depend on this list of packages in order to successfully build, but needs them for the extended usability." 9217 RRECOMMENDS[doc] = "A list of packages that extends the usability of a package being built. The package being built does not depend on this list of packages in order to successfully build, but needs them for the extended usability."
8991 </info> 9218 </info>
8992 <glossdef> 9219 <glossdef>
8993 <para> 9220 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
8994 A list of packages that extends the usability of a package 9221 A list of packages that extends the usability of a package
8995 being built. 9222 being built.
8996 The package being built does not depend on this list of 9223 The package being built does not depend on this list of
@@ -9077,12 +9304,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9077 </glossdef> 9304 </glossdef>
9078 </glossentry> 9305 </glossentry>
9079 9306
9080 <glossentry id='var-RREPLACES'><glossterm>RREPLACES<imagedata fileref="figures/define-generic.png" /></glossterm> 9307 <glossentry id='var-RREPLACES'><glossterm>RREPLACES</glossterm>
9081 <info> 9308 <info>
9082 RREPLACES[doc] = "A list of packages replaced by a package. The package manager uses this variable to determine which package should be installed to replace other package(s) during an upgrade." 9309 RREPLACES[doc] = "A list of packages replaced by a package. The package manager uses this variable to determine which package should be installed to replace other package(s) during an upgrade."
9083 </info> 9310 </info>
9084 <glossdef> 9311 <glossdef>
9085 <para> 9312 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9086 A list of packages replaced by a package. 9313 A list of packages replaced by a package.
9087 The package manager uses this variable to determine which 9314 The package manager uses this variable to determine which
9088 package should be installed to replace other package(s) 9315 package should be installed to replace other package(s)
@@ -9092,6 +9319,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9092 package to the 9319 package to the
9093 <filename><link linkend='var-RCONFLICTS'>RCONFLICTS</link></filename> variable. 9320 <filename><link linkend='var-RCONFLICTS'>RCONFLICTS</link></filename> variable.
9094 </para> 9321 </para>
9322
9095 <para> 9323 <para>
9096 As with all package-controlling variables, you must use 9324 As with all package-controlling variables, you must use
9097 this variable in conjunction with a package name 9325 this variable in conjunction with a package name
@@ -9131,17 +9359,18 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9131 </glossdef> 9359 </glossdef>
9132 </glossentry> 9360 </glossentry>
9133 9361
9134 <glossentry id='var-RSUGGESTS'><glossterm>RSUGGESTS<imagedata fileref="figures/define-generic.png" /></glossterm> 9362 <glossentry id='var-RSUGGESTS'><glossterm>RSUGGESTS</glossterm>
9135 <info> 9363 <info>
9136 RSUGGESTS[doc] = "A list of additional packages that you can suggest for installation by the package manager at the time a package is installed. Not all package managers support this functionality." 9364 RSUGGESTS[doc] = "A list of additional packages that you can suggest for installation by the package manager at the time a package is installed. Not all package managers support this functionality."
9137 </info> 9365 </info>
9138 <glossdef> 9366 <glossdef>
9139 <para> 9367 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9140 A list of additional packages that you can suggest for 9368 A list of additional packages that you can suggest for
9141 installation by the package manager at the time a package 9369 installation by the package manager at the time a package
9142 is installed. 9370 is installed.
9143 Not all package managers support this functionality. 9371 Not all package managers support this functionality.
9144 </para> 9372 </para>
9373
9145 <para> 9374 <para>
9146 As with all package-controlling variables, you must always 9375 As with all package-controlling variables, you must always
9147 use this variable in conjunction with a package name 9376 use this variable in conjunction with a package name
@@ -9158,12 +9387,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9158 9387
9159 <glossdiv id='var-glossary-s'><title>S</title> 9388 <glossdiv id='var-glossary-s'><title>S</title>
9160 9389
9161 <glossentry id='var-S'><glossterm>S<imagedata fileref="figures/define-generic.png" /></glossterm> 9390 <glossentry id='var-S'><glossterm>S</glossterm>
9162 <info> 9391 <info>
9163 S[doc] = "The location in the Build Directory where unpacked package source code resides." 9392 S[doc] = "The location in the Build Directory where unpacked package source code resides."
9164 </info> 9393 </info>
9165 <glossdef> 9394 <glossdef>
9166 <para> 9395 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9167 The location in the 9396 The location in the
9168 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> 9397 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>
9169 where unpacked recipe source code resides. 9398 where unpacked recipe source code resides.
@@ -9178,6 +9407,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9178 <literallayout class='monospaced'> 9407 <literallayout class='monospaced'>
9179 ${WORKDIR}/${PN}-${PV} 9408 ${WORKDIR}/${PN}-${PV}
9180 </literallayout> 9409 </literallayout>
9410 </para>
9411
9412 <para>
9181 As an example, assume a 9413 As an example, assume a
9182 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> 9414 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
9183 top-level folder named <filename>poky</filename> and a 9415 top-level folder named <filename>poky</filename> and a
@@ -9192,12 +9424,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9192 </glossdef> 9424 </glossdef>
9193 </glossentry> 9425 </glossentry>
9194 9426
9195 <glossentry id='var-SANITY_REQUIRED_UTILITIES'><glossterm>SANITY_REQUIRED_UTILITIES<imagedata fileref="figures/define-generic.png" /></glossterm> 9427 <glossentry id='var-SANITY_REQUIRED_UTILITIES'><glossterm>SANITY_REQUIRED_UTILITIES</glossterm>
9196 <info> 9428 <info>
9197 SANITY_REQUIRED_UTILITIES[doc] = "Specifies a list of command-line utilities that should be checked for during the initial sanity checking process when running BitBake." 9429 SANITY_REQUIRED_UTILITIES[doc] = "Specifies a list of command-line utilities that should be checked for during the initial sanity checking process when running BitBake."
9198 </info> 9430 </info>
9199 <glossdef> 9431 <glossdef>
9200 <para> 9432 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9201 Specifies a list of command-line utilities that should be 9433 Specifies a list of command-line utilities that should be
9202 checked for during the initial sanity checking process when 9434 checked for during the initial sanity checking process when
9203 running BitBake. 9435 running BitBake.
@@ -9207,12 +9439,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9207 </glossdef> 9439 </glossdef>
9208 </glossentry> 9440 </glossentry>
9209 9441
9210 <glossentry id='var-SANITY_TESTED_DISTROS'><glossterm>SANITY_TESTED_DISTROS<imagedata fileref="figures/define-generic.png" /></glossterm> 9442 <glossentry id='var-SANITY_TESTED_DISTROS'><glossterm>SANITY_TESTED_DISTROS</glossterm>
9211 <info> 9443 <info>
9212 SANITY_TESTED_DISTROS[doc] = "A list of the host distribution identifiers that the build system has been tested against." 9444 SANITY_TESTED_DISTROS[doc] = "A list of the host distribution identifiers that the build system has been tested against."
9213 </info> 9445 </info>
9214 <glossdef> 9446 <glossdef>
9215 <para> 9447 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9216 A list of the host distribution identifiers that the 9448 A list of the host distribution identifiers that the
9217 build system has been tested against. 9449 build system has been tested against.
9218 Identifiers consist of the host distributor ID 9450 Identifiers consist of the host distributor ID
@@ -9231,12 +9463,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9231 </glossdef> 9463 </glossdef>
9232 </glossentry> 9464 </glossentry>
9233 9465
9234 <glossentry id='var-SDK_ARCH'><glossterm>SDK_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 9466 <glossentry id='var-SDK_ARCH'><glossterm>SDK_ARCH</glossterm>
9235 <info> 9467 <info>
9236 SDK_ARCH[doc] = "The target architecture for the SDK." 9468 SDK_ARCH[doc] = "The target architecture for the SDK."
9237 </info> 9469 </info>
9238 <glossdef> 9470 <glossdef>
9239 <para> 9471 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9240 The target architecture for the SDK. 9472 The target architecture for the SDK.
9241 Typically, you do not directly set this variable. 9473 Typically, you do not directly set this variable.
9242 Instead, use 9474 Instead, use
@@ -9245,12 +9477,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9245 </glossdef> 9477 </glossdef>
9246 </glossentry> 9478 </glossentry>
9247 9479
9248 <glossentry id='var-SDK_DEPLOY'><glossterm>SDK_DEPLOY<imagedata fileref="figures/define-generic.png" /></glossterm> 9480 <glossentry id='var-SDK_DEPLOY'><glossterm>SDK_DEPLOY</glossterm>
9249 <info> 9481 <info>
9250 SDK_DEPLOY[doc] = "The directory set up and used by the populate_sdk_base to which the SDK is deployed." 9482 SDK_DEPLOY[doc] = "The directory set up and used by the populate_sdk_base to which the SDK is deployed."
9251 </info> 9483 </info>
9252 <glossdef> 9484 <glossdef>
9253 <para> 9485 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9254 The directory set up and used by the 9486 The directory set up and used by the
9255 <link linkend='ref-classes-populate-sdk'><filename>populate_sdk_base</filename></link> 9487 <link linkend='ref-classes-populate-sdk'><filename>populate_sdk_base</filename></link>
9256 to which the SDK is deployed. 9488 to which the SDK is deployed.
@@ -9263,12 +9495,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9263 </glossdef> 9495 </glossdef>
9264 </glossentry> 9496 </glossentry>
9265 9497
9266 <glossentry id='var-SDK_DIR'><glossterm>SDK_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 9498 <glossentry id='var-SDK_DIR'><glossterm>SDK_DIR</glossterm>
9267 <info> 9499 <info>
9268 SDK_DIR[doc] = "The parent directory used by the OpenEmbedded build system when creating SDK output." 9500 SDK_DIR[doc] = "The parent directory used by the OpenEmbedded build system when creating SDK output."
9269 </info> 9501 </info>
9270 <glossdef> 9502 <glossdef>
9271 <para> 9503 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9272 The parent directory used by the OpenEmbedded build system 9504 The parent directory used by the OpenEmbedded build system
9273 when creating SDK output. 9505 when creating SDK output.
9274 The 9506 The
@@ -9288,12 +9520,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9288 </glossdef> 9520 </glossdef>
9289 </glossentry> 9521 </glossentry>
9290 9522
9291 <glossentry id='var-SDK_NAME'><glossterm>SDK_NAME<imagedata fileref="figures/define-generic.png" /></glossterm> 9523 <glossentry id='var-SDK_NAME'><glossterm>SDK_NAME</glossterm>
9292 <info> 9524 <info>
9293 SDK_NAME[doc] = "The base name for SDK output files." 9525 SDK_NAME[doc] = "The base name for SDK output files."
9294 </info> 9526 </info>
9295 <glossdef> 9527 <glossdef>
9296 <para> 9528 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9297 The base name for SDK output files. 9529 The base name for SDK output files.
9298 The name is derived from the 9530 The name is derived from the
9299 <link linkend='var-DISTRO'><filename>DISTRO</filename></link>, 9531 <link linkend='var-DISTRO'><filename>DISTRO</filename></link>,
@@ -9310,12 +9542,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9310 </glossdef> 9542 </glossdef>
9311 </glossentry> 9543 </glossentry>
9312 9544
9313 <glossentry id='var-SDK_OS'><glossterm>SDK_OS<imagedata fileref="figures/define-generic.png" /></glossterm> 9545 <glossentry id='var-SDK_OS'><glossterm>SDK_OS</glossterm>
9314 <info> 9546 <info>
9315 SDK_OS[doc] = "The operating system for which the SDK will be built." 9547 SDK_OS[doc] = "The operating system for which the SDK will be built."
9316 </info> 9548 </info>
9317 <glossdef> 9549 <glossdef>
9318 <para> 9550 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9319 Specifies the operating system for which the SDK 9551 Specifies the operating system for which the SDK
9320 will be built. 9552 will be built.
9321 The default value is the value of 9553 The default value is the value of
@@ -9324,12 +9556,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9324 </glossdef> 9556 </glossdef>
9325 </glossentry> 9557 </glossentry>
9326 9558
9327 <glossentry id='var-SDK_OUTPUT'><glossterm>SDK_OUTPUT<imagedata fileref="figures/define-generic.png" /></glossterm> 9559 <glossentry id='var-SDK_OUTPUT'><glossterm>SDK_OUTPUT</glossterm>
9328 <info> 9560 <info>
9329 SDK_OUTPUT[doc] = "The location used by the OpenEmbedded build system when creating SDK output." 9561 SDK_OUTPUT[doc] = "The location used by the OpenEmbedded build system when creating SDK output."
9330 </info> 9562 </info>
9331 <glossdef> 9563 <glossdef>
9332 <para> 9564 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9333 The location used by the OpenEmbedded build system when 9565 The location used by the OpenEmbedded build system when
9334 creating SDK output. 9566 creating SDK output.
9335 The 9567 The
@@ -9346,17 +9578,16 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9346 The final output directory is 9578 The final output directory is
9347 <link linkend='var-SDK_DEPLOY'><filename>SDK_DEPLOY</filename></link>. 9579 <link linkend='var-SDK_DEPLOY'><filename>SDK_DEPLOY</filename></link>.
9348 </note> 9580 </note>
9349
9350 </para> 9581 </para>
9351 </glossdef> 9582 </glossdef>
9352 </glossentry> 9583 </glossentry>
9353 9584
9354 <glossentry id='var-SDK_PACKAGE_ARCHS'><glossterm>SDK_PACKAGE_ARCHS<imagedata fileref="figures/define-generic.png" /></glossterm> 9585 <glossentry id='var-SDK_PACKAGE_ARCHS'><glossterm>SDK_PACKAGE_ARCHS</glossterm>
9355 <info> 9586 <info>
9356 SDK_PACKAGE_ARCHS[doc] = "Specifies a list of architectures compatible with the SDK machine. This variable is set automatically and should not normally be hand-edited." 9587 SDK_PACKAGE_ARCHS[doc] = "Specifies a list of architectures compatible with the SDK machine. This variable is set automatically and should not normally be hand-edited."
9357 </info> 9588 </info>
9358 <glossdef> 9589 <glossdef>
9359 <para> 9590 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9360 Specifies a list of architectures compatible with 9591 Specifies a list of architectures compatible with
9361 the SDK machine. 9592 the SDK machine.
9362 This variable is set automatically and should not 9593 This variable is set automatically and should not
@@ -9370,12 +9601,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9370 </glossdef> 9601 </glossdef>
9371 </glossentry> 9602 </glossentry>
9372 9603
9373 <glossentry id='var-SDK_PREFIX'><glossterm>SDK_PREFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 9604 <glossentry id='var-SDK_PREFIX'><glossterm>SDK_PREFIX</glossterm>
9374 <info> 9605 <info>
9375 SDK_PREFIX[doc] = "The toolchain binary prefix used for nativesdk recipes." 9606 SDK_PREFIX[doc] = "The toolchain binary prefix used for nativesdk recipes."
9376 </info> 9607 </info>
9377 <glossdef> 9608 <glossdef>
9378 <para> 9609 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9379 The toolchain binary prefix used for nativesdk recipes. 9610 The toolchain binary prefix used for nativesdk recipes.
9380 The OpenEmbedded build system uses the 9611 The OpenEmbedded build system uses the
9381 <filename>SDK_PREFIX</filename> value to set the 9612 <filename>SDK_PREFIX</filename> value to set the
@@ -9386,12 +9617,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9386 </glossdef> 9617 </glossdef>
9387 </glossentry> 9618 </glossentry>
9388 9619
9389 <glossentry id='var-SDK_SYS'><glossterm>SDK_SYS<imagedata fileref="figures/define-generic.png" /></glossterm> 9620 <glossentry id='var-SDK_SYS'><glossterm>SDK_SYS</glossterm>
9390 <info> 9621 <info>
9391 SDK_SYS[doc] = "Specifies the system, including the architecture and the operating system, for which the SDK will be built." 9622 SDK_SYS[doc] = "Specifies the system, including the architecture and the operating system, for which the SDK will be built."
9392 </info> 9623 </info>
9393 <glossdef> 9624 <glossdef>
9394 <para> 9625 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9395 Specifies the system, including the architecture and the 9626 Specifies the system, including the architecture and the
9396 operating system, for which the SDK will be built. 9627 operating system, for which the SDK will be built.
9397 </para> 9628 </para>
@@ -9409,23 +9640,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9409 </glossdef> 9640 </glossdef>
9410 </glossentry> 9641 </glossentry>
9411 9642
9412 <glossentry id='var-SDK_VENDOR'><glossterm>SDK_VENDOR<imagedata fileref="figures/define-generic.png" /></glossterm> 9643 <glossentry id='var-SDK_VENDOR'><glossterm>SDK_VENDOR</glossterm>
9413 <info> 9644 <info>
9414 SDK_VENDOR[doc] = "Specifies the name of the SDK vendor." 9645 SDK_VENDOR[doc] = "Specifies the name of the SDK vendor."
9415 </info> 9646 </info>
9416 <glossdef> 9647 <glossdef>
9417 <para> 9648 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9418 Specifies the name of the SDK vendor. 9649 Specifies the name of the SDK vendor.
9419 </para> 9650 </para>
9420 </glossdef> 9651 </glossdef>
9421 </glossentry> 9652 </glossentry>
9422 9653
9423 <glossentry id='var-SDKIMAGE_FEATURES'><glossterm>SDKIMAGE_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 9654 <glossentry id='var-SDKIMAGE_FEATURES'><glossterm>SDKIMAGE_FEATURES</glossterm>
9424 <info> 9655 <info>
9425 SDKIMAGE_FEATURES[doc] = "Equivalent to IMAGE_FEATURES. However, this variable applies to the SDK generated from an image using the command 'bitbake -c populate_sdk imagename'." 9656 SDKIMAGE_FEATURES[doc] = "Equivalent to IMAGE_FEATURES. However, this variable applies to the SDK generated from an image using the command 'bitbake -c populate_sdk imagename'."
9426 </info> 9657 </info>
9427 <glossdef> 9658 <glossdef>
9428 <para>Equivalent to 9659 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9660 Equivalent to
9429 <filename><link linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></filename>. 9661 <filename><link linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></filename>.
9430 However, this variable applies to the SDK generated from an 9662 However, this variable applies to the SDK generated from an
9431 image using the following command: 9663 image using the following command:
@@ -9436,12 +9668,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9436 </glossdef> 9668 </glossdef>
9437 </glossentry> 9669 </glossentry>
9438 9670
9439 <glossentry id='var-SDKMACHINE'><glossterm>SDKMACHINE<imagedata fileref="figures/define-generic.png" /></glossterm> 9671 <glossentry id='var-SDKMACHINE'><glossterm>SDKMACHINE</glossterm>
9440 <info> 9672 <info>
9441 SDKMACHINE[doc] = "Specifies the architecture (i.e. i686 or x86_64) for which to build SDK and ADT items." 9673 SDKMACHINE[doc] = "Specifies the architecture (i.e. i686 or x86_64) for which to build SDK and ADT items."
9442 </info> 9674 </info>
9443 <glossdef> 9675 <glossdef>
9444 <para> 9676 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9445 The machine for which the Application Development Toolkit 9677 The machine for which the Application Development Toolkit
9446 (ADT) or SDK is built. 9678 (ADT) or SDK is built.
9447 In other words, the SDK or ADT is built such that it 9679 In other words, the SDK or ADT is built such that it
@@ -9468,12 +9700,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9468 </glossdef> 9700 </glossdef>
9469 </glossentry> 9701 </glossentry>
9470 9702
9471 <glossentry id='var-SDKPATH'><glossterm>SDKPATH<imagedata fileref="figures/define-generic.png" /></glossterm> 9703 <glossentry id='var-SDKPATH'><glossterm>SDKPATH</glossterm>
9472 <info> 9704 <info>
9473 SDKPATH[doc] = "Defines the path offered to the user for installation of the SDK that is generated by the OpenEmbedded build system." 9705 SDKPATH[doc] = "Defines the path offered to the user for installation of the SDK that is generated by the OpenEmbedded build system."
9474 </info> 9706 </info>
9475 <glossdef> 9707 <glossdef>
9476 <para> 9708 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9477 Defines the path offered to the user for installation 9709 Defines the path offered to the user for installation
9478 of the SDK that is generated by the OpenEmbedded build 9710 of the SDK that is generated by the OpenEmbedded build
9479 system. 9711 system.
@@ -9485,12 +9717,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9485 </glossdef> 9717 </glossdef>
9486 </glossentry> 9718 </glossentry>
9487 9719
9488 <glossentry id='var-SDKTARGETSYSROOT'><glossterm>SDKTARGETSYSROOT<imagedata fileref="figures/define-generic.png" /></glossterm> 9720 <glossentry id='var-SDKTARGETSYSROOT'><glossterm>SDKTARGETSYSROOT</glossterm>
9489 <info> 9721 <info>
9490 SDKTARGETSYSROOT[doc] = "Full path to the sysroot used for cross-compilation within an SDK as it will be when installed into the default SDKPATH." 9722 SDKTARGETSYSROOT[doc] = "Full path to the sysroot used for cross-compilation within an SDK as it will be when installed into the default SDKPATH."
9491 </info> 9723 </info>
9492 <glossdef> 9724 <glossdef>
9493 <para> 9725 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9494 The full path to the sysroot used for cross-compilation 9726 The full path to the sysroot used for cross-compilation
9495 within an SDK as it will be when installed into the 9727 within an SDK as it will be when installed into the
9496 default 9728 default
@@ -9499,22 +9731,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9499 </glossdef> 9731 </glossdef>
9500 </glossentry> 9732 </glossentry>
9501 9733
9502 <glossentry id='var-SECTION'><glossterm>SECTION<imagedata fileref="figures/define-generic.png" /></glossterm> 9734 <glossentry id='var-SECTION'><glossterm>SECTION</glossterm>
9503 <info> 9735 <info>
9504 SECTION[doc] = "The section in which packages should be categorized. Package management utilities can make use of this variable." 9736 SECTION[doc] = "The section in which packages should be categorized. Package management utilities can make use of this variable."
9505 </info> 9737 </info>
9506 <glossdef> 9738 <glossdef>
9507 <para>The section in which packages should be categorized. 9739 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9508 Package management utilities can make use of this variable.</para> 9740 The section in which packages should be categorized.
9741 Package management utilities can make use of this variable.
9742 </para>
9509 </glossdef> 9743 </glossdef>
9510 </glossentry> 9744 </glossentry>
9511 9745
9512 <glossentry id='var-SELECTED_OPTIMIZATION'><glossterm>SELECTED_OPTIMIZATION<imagedata fileref="figures/define-generic.png" /></glossterm> 9746 <glossentry id='var-SELECTED_OPTIMIZATION'><glossterm>SELECTED_OPTIMIZATION</glossterm>
9513 <info> 9747 <info>
9514 SELECTED_OPTIMIZATION[doc] = "The variable takes the value of FULL_OPTIMIZATION unless DEBUG_BUILD = '1'. In this case, the value of DEBUG_OPTIMIZATION is used." 9748 SELECTED_OPTIMIZATION[doc] = "The variable takes the value of FULL_OPTIMIZATION unless DEBUG_BUILD = '1'. In this case, the value of DEBUG_OPTIMIZATION is used."
9515 </info> 9749 </info>
9516 <glossdef> 9750 <glossdef>
9517 <para> 9751 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9518 Specifies the optimization flags passed to the C compiler 9752 Specifies the optimization flags passed to the C compiler
9519 when building for the target. 9753 when building for the target.
9520 The flags are passed through the default value of the 9754 The flags are passed through the default value of the
@@ -9533,12 +9767,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9533 </glossdef> 9767 </glossdef>
9534 </glossentry> 9768 </glossentry>
9535 9769
9536 <glossentry id='var-SERIAL_CONSOLE'><glossterm>SERIAL_CONSOLE<imagedata fileref="figures/define-generic.png" /></glossterm> 9770 <glossentry id='var-SERIAL_CONSOLE'><glossterm>SERIAL_CONSOLE</glossterm>
9537 <info> 9771 <info>
9538 SERIAL_CONSOLE[doc] = "The speed and device for the serial port used to attach the serial console. This variable is given to the kernel as the 'console' parameter. After booting occurs, getty is started on that port so remote login is possible." 9772 SERIAL_CONSOLE[doc] = "The speed and device for the serial port used to attach the serial console. This variable is given to the kernel as the 'console' parameter. After booting occurs, getty is started on that port so remote login is possible."
9539 </info> 9773 </info>
9540 <glossdef> 9774 <glossdef>
9541 <para> 9775 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9542 Defines a serial console (TTY) to enable using getty. 9776 Defines a serial console (TTY) to enable using getty.
9543 Provide a value that specifies the baud rate followed by 9777 Provide a value that specifies the baud rate followed by
9544 the TTY device name separated by a space. 9778 the TTY device name separated by a space.
@@ -9557,12 +9791,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9557 </glossdef> 9791 </glossdef>
9558 </glossentry> 9792 </glossentry>
9559 9793
9560 <glossentry id='var-SERIAL_CONSOLES'><glossterm>SERIAL_CONSOLES<imagedata fileref="figures/define-generic.png" /></glossterm> 9794 <glossentry id='var-SERIAL_CONSOLES'><glossterm>SERIAL_CONSOLES</glossterm>
9561 <info> 9795 <info>
9562 SERIAL_CONSOLES[doc] = "Defines the serial consoles (TTYs) to enable using getty." 9796 SERIAL_CONSOLES[doc] = "Defines the serial consoles (TTYs) to enable using getty."
9563 </info> 9797 </info>
9564 <glossdef> 9798 <glossdef>
9565 <para> 9799 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9566 Defines the serial consoles (TTYs) to enable using getty. 9800 Defines the serial consoles (TTYs) to enable using getty.
9567 Provide a value that specifies the baud rate followed by 9801 Provide a value that specifies the baud rate followed by
9568 the TTY device name separated by a semicolon. 9802 the TTY device name separated by a semicolon.
@@ -9574,12 +9808,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9574 </glossdef> 9808 </glossdef>
9575 </glossentry> 9809 </glossentry>
9576 9810
9577 <glossentry id='var-SERIAL_CONSOLES_CHECK'><glossterm>SERIAL_CONSOLES_CHECK<imagedata fileref="figures/define-generic.png" /></glossterm> 9811 <glossentry id='var-SERIAL_CONSOLES_CHECK'><glossterm>SERIAL_CONSOLES_CHECK</glossterm>
9578 <info> 9812 <info>
9579 SERIAL_CONSOLES_CHECK[doc] = "Similar to SERIAL_CONSOLES except the device is checked for existence before attempting to enable it. Supported only by SysVinit." 9813 SERIAL_CONSOLES_CHECK[doc] = "Similar to SERIAL_CONSOLES except the device is checked for existence before attempting to enable it. Supported only by SysVinit."
9580 </info> 9814 </info>
9581 <glossdef> 9815 <glossdef>
9582 <para> 9816 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9583 Similar to 9817 Similar to
9584 <link linkend='var-SERIAL_CONSOLES'><filename>SERIAL_CONSOLES</filename></link> 9818 <link linkend='var-SERIAL_CONSOLES'><filename>SERIAL_CONSOLES</filename></link>
9585 except the device is checked for existence before attempting 9819 except the device is checked for existence before attempting
@@ -9590,12 +9824,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9590 </glossdef> 9824 </glossdef>
9591 </glossentry> 9825 </glossentry>
9592 9826
9593 <glossentry id='var-SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS'><glossterm>SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS<imagedata fileref="figures/define-generic.png" /></glossterm> 9827 <glossentry id='var-SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS'><glossterm>SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS</glossterm>
9594 <info> 9828 <info>
9595 SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS[doc] = "A list of recipe dependencies that should not be used to determine signatures of tasks from one recipe when they depend on tasks from another recipe." 9829 SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS[doc] = "A list of recipe dependencies that should not be used to determine signatures of tasks from one recipe when they depend on tasks from another recipe."
9596 </info> 9830 </info>
9597 <glossdef> 9831 <glossdef>
9598 <para> 9832 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9599 A list of recipe dependencies that should not be used to 9833 A list of recipe dependencies that should not be used to
9600 determine signatures of tasks from one recipe when they 9834 determine signatures of tasks from one recipe when they
9601 depend on tasks from another recipe. 9835 depend on tasks from another recipe.
@@ -9603,6 +9837,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9603 <literallayout class='monospaced'> 9837 <literallayout class='monospaced'>
9604 SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS += "intone->mplayer2" 9838 SIGGEN_EXCLUDE_SAFE_RECIPE_DEPS += "intone->mplayer2"
9605 </literallayout> 9839 </literallayout>
9840 </para>
9841
9842 <para>
9606 In this example, <filename>intone</filename> depends on 9843 In this example, <filename>intone</filename> depends on
9607 <filename>mplayer2</filename>. 9844 <filename>mplayer2</filename>.
9608 </para> 9845 </para>
@@ -9621,12 +9858,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9621 </glossdef> 9858 </glossdef>
9622 </glossentry> 9859 </glossentry>
9623 9860
9624 <glossentry id='var-SIGGEN_EXCLUDERECIPES_ABISAFE'><glossterm>SIGGEN_EXCLUDERECIPES_ABISAFE<imagedata fileref="figures/define-generic.png" /></glossterm> 9861 <glossentry id='var-SIGGEN_EXCLUDERECIPES_ABISAFE'><glossterm>SIGGEN_EXCLUDERECIPES_ABISAFE</glossterm>
9625 <info> 9862 <info>
9626 SIGGEN_EXCLUDERECIPES_ABISAFE[doc] = "A list of recipes that are completely stable and will never change." 9863 SIGGEN_EXCLUDERECIPES_ABISAFE[doc] = "A list of recipes that are completely stable and will never change."
9627 </info> 9864 </info>
9628 <glossdef> 9865 <glossdef>
9629 <para> 9866 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9630 A list of recipes that are completely stable and will 9867 A list of recipes that are completely stable and will
9631 never change. 9868 never change.
9632 The ABI for the recipes in the list are presented by 9869 The ABI for the recipes in the list are presented by
@@ -9644,36 +9881,36 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9644 </glossdef> 9881 </glossdef>
9645 </glossentry> 9882 </glossentry>
9646 9883
9647 <glossentry id='var-SITEINFO_BITS'><glossterm>SITEINFO_BITS<imagedata fileref="figures/define-generic.png" /></glossterm> 9884 <glossentry id='var-SITEINFO_BITS'><glossterm>SITEINFO_BITS</glossterm>
9648 <info> 9885 <info>
9649 SITEINFO_BITS[doc] = "Specifies the number of bits for the target system CPU." 9886 SITEINFO_BITS[doc] = "Specifies the number of bits for the target system CPU."
9650 </info> 9887 </info>
9651 <glossdef> 9888 <glossdef>
9652 <para> 9889 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9653 Specifies the number of bits for the target system CPU. 9890 Specifies the number of bits for the target system CPU.
9654 The value should be either "32" or "64". 9891 The value should be either "32" or "64".
9655 </para> 9892 </para>
9656 </glossdef> 9893 </glossdef>
9657 </glossentry> 9894 </glossentry>
9658 9895
9659 <glossentry id='var-SITEINFO_ENDIANNESS'><glossterm>SITEINFO_ENDIANNESS<imagedata fileref="figures/define-generic.png" /></glossterm> 9896 <glossentry id='var-SITEINFO_ENDIANNESS'><glossterm>SITEINFO_ENDIANNESS</glossterm>
9660 <info> 9897 <info>
9661 SITEINFO_ENDIANNESS[doc] = "Specifies the endian byte order of the target system. The value should be either 'le' for 'little-endian' or 'be' for 'big-endian'." 9898 SITEINFO_ENDIANNESS[doc] = "Specifies the endian byte order of the target system. The value should be either 'le' for 'little-endian' or 'be' for 'big-endian'."
9662 </info> 9899 </info>
9663 <glossdef> 9900 <glossdef>
9664 <para> 9901 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9665 Specifies the endian byte order of the target system. 9902 Specifies the endian byte order of the target system.
9666 The value should be either "le" for little-endian or "be" for big-endian. 9903 The value should be either "le" for little-endian or "be" for big-endian.
9667 </para> 9904 </para>
9668 </glossdef> 9905 </glossdef>
9669 </glossentry> 9906 </glossentry>
9670 9907
9671 <glossentry id='var-SOC_FAMILY'><glossterm>SOC_FAMILY<imagedata fileref="figures/define-generic.png" /></glossterm> 9908 <glossentry id='var-SOC_FAMILY'><glossterm>SOC_FAMILY</glossterm>
9672 <info> 9909 <info>
9673 SOC_FAMILY[doc] = "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." 9910 SOC_FAMILY[doc] = "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."
9674 </info> 9911 </info>
9675 <glossdef> 9912 <glossdef>
9676 <para> 9913 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9677 Groups together machines based upon the same family 9914 Groups together machines based upon the same family
9678 of SOC (System On Chip). 9915 of SOC (System On Chip).
9679 You typically set this variable in a common 9916 You typically set this variable in a common
@@ -9683,18 +9920,18 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9683 You must include 9920 You must include
9684 <filename>conf/machine/include/soc-family.inc</filename> 9921 <filename>conf/machine/include/soc-family.inc</filename>
9685 for this variable to appear in 9922 for this variable to appear in
9686 <link linkend='var-MACHINEOVERRIDES'><filename>MACHINEOVERRIDES</filename></link>. 9923 <link linkend='var-MACHINEOVERRIDES'><filename>MACHINEOVERRIDES</filename></link>.
9687 </note> 9924 </note>
9688 </para> 9925 </para>
9689 </glossdef> 9926 </glossdef>
9690 </glossentry> 9927 </glossentry>
9691 9928
9692 <glossentry id='var-SOLIBS'><glossterm>SOLIBS<imagedata fileref="figures/define-generic.png" /></glossterm> 9929 <glossentry id='var-SOLIBS'><glossterm>SOLIBS</glossterm>
9693 <info> 9930 <info>
9694 SOLIBS[doc] = "Defines the suffix for shared libraries used on the target platform." 9931 SOLIBS[doc] = "Defines the suffix for shared libraries used on the target platform."
9695 </info> 9932 </info>
9696 <glossdef> 9933 <glossdef>
9697 <para> 9934 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9698 Defines the suffix for shared libraries used on the 9935 Defines the suffix for shared libraries used on the
9699 target platform. 9936 target platform.
9700 By default, this suffix is ".so.*" for all Linux-based 9937 By default, this suffix is ".so.*" for all Linux-based
@@ -9710,12 +9947,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9710 </glossdef> 9947 </glossdef>
9711 </glossentry> 9948 </glossentry>
9712 9949
9713 <glossentry id='var-SOLIBSDEV'><glossterm>SOLIBSDEV<imagedata fileref="figures/define-generic.png" /></glossterm> 9950 <glossentry id='var-SOLIBSDEV'><glossterm>SOLIBSDEV</glossterm>
9714 <info> 9951 <info>
9715 SOLIBSDEV[doc] = "Defines the suffix for the development symbolic link (symlink) for shared libraries on the target platform." 9952 SOLIBSDEV[doc] = "Defines the suffix for the development symbolic link (symlink) for shared libraries on the target platform."
9716 </info> 9953 </info>
9717 <glossdef> 9954 <glossdef>
9718 <para> 9955 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9719 Defines the suffix for the development symbolic link 9956 Defines the suffix for the development symbolic link
9720 (symlink) for shared libraries on the target platform. 9957 (symlink) for shared libraries on the target platform.
9721 By default, this suffix is ".so" for Linux-based 9958 By default, this suffix is ".so" for Linux-based
@@ -9731,12 +9968,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9731 </glossdef> 9968 </glossdef>
9732 </glossentry> 9969 </glossentry>
9733 9970
9734 <glossentry id='var-SOURCE_MIRROR_FETCH'><glossterm>SOURCE_MIRROR_FETCH<imagedata fileref="figures/define-generic.png" /></glossterm> 9971 <glossentry id='var-SOURCE_MIRROR_FETCH'><glossterm>SOURCE_MIRROR_FETCH</glossterm>
9735 <info> 9972 <info>
9736 SOURCE_MIRROR_FETCH[doc] = "Set as part of a source mirror generation script to skip COMPATIBLE_MACHINE and COMPATIBLE_HOST checks." 9973 SOURCE_MIRROR_FETCH[doc] = "Set as part of a source mirror generation script to skip COMPATIBLE_MACHINE and COMPATIBLE_HOST checks."
9737 </info> 9974 </info>
9738 <glossdef> 9975 <glossdef>
9739 <para> 9976 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9740 When you are fetching files to create a mirror of sources 9977 When you are fetching files to create a mirror of sources
9741 (i.e. creating a source mirror), setting 9978 (i.e. creating a source mirror), setting
9742 <filename>SOURCE_MIRROR_FETCH</filename> to "1" in your 9979 <filename>SOURCE_MIRROR_FETCH</filename> to "1" in your
@@ -9762,12 +9999,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9762 </glossdef> 9999 </glossdef>
9763 </glossentry> 10000 </glossentry>
9764 10001
9765 <glossentry id='var-SOURCE_MIRROR_URL'><glossterm>SOURCE_MIRROR_URL<imagedata fileref="figures/define-generic.png" /></glossterm> 10002 <glossentry id='var-SOURCE_MIRROR_URL'><glossterm>SOURCE_MIRROR_URL</glossterm>
9766 <info> 10003 <info>
9767 SOURCE_MIRROR_URL[doc] = "URL to source mirror that will be used before fetching from original SRC_URI." 10004 SOURCE_MIRROR_URL[doc] = "URL to source mirror that will be used before fetching from original SRC_URI."
9768 </info> 10005 </info>
9769 <glossdef> 10006 <glossdef>
9770 <para> 10007 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9771 Defines your own 10008 Defines your own
9772 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> 10009 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link>
9773 from which to first fetch source before attempting to fetch 10010 from which to first fetch source before attempting to fetch
@@ -9792,12 +10029,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9792 </glossdef> 10029 </glossdef>
9793 </glossentry> 10030 </glossentry>
9794 10031
9795 <glossentry id='var-SPDXLICENSEMAP'><glossterm>SPDXLICENSEMAP<imagedata fileref="figures/define-generic.png" /></glossterm> 10032 <glossentry id='var-SPDXLICENSEMAP'><glossterm>SPDXLICENSEMAP</glossterm>
9796 <info> 10033 <info>
9797 SPDXLICENSEMAP[doc] = "Maps commonly used license names to their SPDX counterparts found in meta/files/common-licenses/." 10034 SPDXLICENSEMAP[doc] = "Maps commonly used license names to their SPDX counterparts found in meta/files/common-licenses/."
9798 </info> 10035 </info>
9799 <glossdef> 10036 <glossdef>
9800 <para> 10037 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9801 Maps commonly used license names to their SPDX counterparts 10038 Maps commonly used license names to their SPDX counterparts
9802 found in <filename>meta/files/common-licenses/</filename>. 10039 found in <filename>meta/files/common-licenses/</filename>.
9803 For the default <filename>SPDXLICENSEMAP</filename> 10040 For the default <filename>SPDXLICENSEMAP</filename>
@@ -9813,12 +10050,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9813 </glossdef> 10050 </glossdef>
9814 </glossentry> 10051 </glossentry>
9815 10052
9816 <glossentry id='var-SPECIAL_PKGSUFFIX'><glossterm>SPECIAL_PKGSUFFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 10053 <glossentry id='var-SPECIAL_PKGSUFFIX'><glossterm>SPECIAL_PKGSUFFIX</glossterm>
9817 <info> 10054 <info>
9818 SPECIAL_PKGSUFFIX[doc] = "A list of prefixes for PN used by the OpenEmbedded build system to create variants of recipes or packages. The list specifies the prefixes to strip off during certain circumstances such as the generation of the BPN variable." 10055 SPECIAL_PKGSUFFIX[doc] = "A list of prefixes for PN used by the OpenEmbedded build system to create variants of recipes or packages. The list specifies the prefixes to strip off during certain circumstances such as the generation of the BPN variable."
9819 </info> 10056 </info>
9820 <glossdef> 10057 <glossdef>
9821 <para> 10058 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9822 A list of prefixes for <link linkend='var-PN'><filename>PN</filename></link> used by the 10059 A list of prefixes for <link linkend='var-PN'><filename>PN</filename></link> used by the
9823 OpenEmbedded build system to create variants of recipes or packages. 10060 OpenEmbedded build system to create variants of recipes or packages.
9824 The list specifies the prefixes to strip off during certain circumstances 10061 The list specifies the prefixes to strip off during certain circumstances
@@ -9827,12 +10064,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9827 </glossdef> 10064 </glossdef>
9828 </glossentry> 10065 </glossentry>
9829 10066
9830 <glossentry id='var-SRC_URI'><glossterm>SRC_URI<imagedata fileref="figures/define-generic.png" /></glossterm> 10067 <glossentry id='var-SRC_URI'><glossterm>SRC_URI</glossterm>
9831 <info> 10068 <info>
9832 SRC_URI[doc] = "The list of source files - local or remote. This variable tells the OpenEmbedded build system what bits to pull in for the build and how to pull them in." 10069 SRC_URI[doc] = "The list of source files - local or remote. This variable tells the OpenEmbedded build system what bits to pull in for the build and how to pull them in."
9833 </info> 10070 </info>
9834 <glossdef> 10071 <glossdef>
9835 <para>The list of source files - local or remote. 10072 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10073 The list of source files - local or remote.
9836 This variable tells the OpenEmbedded build system which bits 10074 This variable tells the OpenEmbedded build system which bits
9837 to pull in for the build and how to pull them in. 10075 to pull in for the build and how to pull them in.
9838 For example, if the recipe or append file only needs to 10076 For example, if the recipe or append file only needs to
@@ -9842,8 +10080,11 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9842 On the other hand, if the recipe or append file needs to 10080 On the other hand, if the recipe or append file needs to
9843 fetch a tarball, apply two patches, and include a custom 10081 fetch a tarball, apply two patches, and include a custom
9844 file, the recipe or append file would include four 10082 file, the recipe or append file would include four
9845 instances of the variable.</para> 10083 instances of the variable.
9846 <para>The following list explains the available URI protocols: 10084 </para>
10085
10086 <para>
10087 The following list explains the available URI protocols:
9847 <itemizedlist> 10088 <itemizedlist>
9848 <listitem><para><emphasis><filename>file://</filename> -</emphasis> 10089 <listitem><para><emphasis><filename>file://</filename> -</emphasis>
9849 Fetches files, which are usually files shipped with 10090 Fetches files, which are usually files shipped with
@@ -9916,7 +10157,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9916 a Subversion (<filename>svn</filename>) revision control repository.</para></listitem> 10157 a Subversion (<filename>svn</filename>) revision control repository.</para></listitem>
9917 </itemizedlist> 10158 </itemizedlist>
9918 </para> 10159 </para>
9919 <para>Standard and recipe-specific options for <filename>SRC_URI</filename> exist. 10160
10161 <para>
10162 Standard and recipe-specific options for <filename>SRC_URI</filename> exist.
9920 Here are standard options: 10163 Here are standard options:
9921 <itemizedlist> 10164 <itemizedlist>
9922 <listitem><para><emphasis><filename>apply</filename> -</emphasis> Whether to apply 10165 <listitem><para><emphasis><filename>apply</filename> -</emphasis> Whether to apply
@@ -9931,7 +10174,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9931 </para></listitem> 10174 </para></listitem>
9932 </itemizedlist> 10175 </itemizedlist>
9933 </para> 10176 </para>
9934 <para>Here are options specific to recipes building code from a revision control system: 10177
10178 <para>
10179 Here are options specific to recipes building code from a revision control system:
9935 <itemizedlist> 10180 <itemizedlist>
9936 <listitem><para><emphasis><filename>mindate</filename> -</emphasis> 10181 <listitem><para><emphasis><filename>mindate</filename> -</emphasis>
9937 Apply the patch only if 10182 Apply the patch only if
@@ -9960,7 +10205,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9960 </para></listitem> 10205 </para></listitem>
9961 </itemizedlist> 10206 </itemizedlist>
9962 </para> 10207 </para>
9963 <para>Here are some additional options worth mentioning: 10208
10209 <para>
10210 Here are some additional options worth mentioning:
9964 <itemizedlist> 10211 <itemizedlist>
9965 <listitem><para><emphasis><filename>unpack</filename> -</emphasis> Controls 10212 <listitem><para><emphasis><filename>unpack</filename> -</emphasis> Controls
9966 whether or not to unpack the file if it is an archive. 10213 whether or not to unpack the file if it is an archive.
@@ -9982,12 +10229,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9982 </glossdef> 10229 </glossdef>
9983 </glossentry> 10230 </glossentry>
9984 10231
9985 <glossentry id='var-SRC_URI_OVERRIDES_PACKAGE_ARCH'><glossterm>SRC_URI_OVERRIDES_PACKAGE_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 10232 <glossentry id='var-SRC_URI_OVERRIDES_PACKAGE_ARCH'><glossterm>SRC_URI_OVERRIDES_PACKAGE_ARCH</glossterm>
9986 <info> 10233 <info>
9987 SRC_URI_OVERRIDES_PACKAGE_ARCH[doc] = "By default, the OpenEmbedded build system automatically detects whether SRC_URI contains files that are machine-specific. If so, the build system automatically changes PACKAGE_ARCH. Setting this variable to '0' disables this behavior." 10234 SRC_URI_OVERRIDES_PACKAGE_ARCH[doc] = "By default, the OpenEmbedded build system automatically detects whether SRC_URI contains files that are machine-specific. If so, the build system automatically changes PACKAGE_ARCH. Setting this variable to '0' disables this behavior."
9988 </info> 10235 </info>
9989 <glossdef> 10236 <glossdef>
9990 <para> 10237 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
9991 By default, the OpenEmbedded build system automatically detects whether 10238 By default, the OpenEmbedded build system automatically detects whether
9992 <filename><link linkend='var-SRC_URI'>SRC_URI</link></filename> 10239 <filename><link linkend='var-SRC_URI'>SRC_URI</link></filename>
9993 contains files that are machine-specific. 10240 contains files that are machine-specific.
@@ -9998,24 +10245,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9998 </glossdef> 10245 </glossdef>
9999 </glossentry> 10246 </glossentry>
10000 10247
10001 <glossentry id='var-SRCDATE'><glossterm>SRCDATE<imagedata fileref="figures/define-generic.png" /></glossterm> 10248 <glossentry id='var-SRCDATE'><glossterm>SRCDATE</glossterm>
10002 <info> 10249 <info>
10003 SRCDATE[doc] = "The date of the source code used to build the package. This variable applies only if the source was fetched from a Source Code Manager (SCM)." 10250 SRCDATE[doc] = "The date of the source code used to build the package. This variable applies only if the source was fetched from a Source Code Manager (SCM)."
10004 </info> 10251 </info>
10005 <glossdef> 10252 <glossdef>
10006 <para> 10253 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10007 The date of the source code used to build the package. 10254 The date of the source code used to build the package.
10008 This variable applies only if the source was fetched from a Source Code Manager (SCM). 10255 This variable applies only if the source was fetched from a Source Code Manager (SCM).
10009 </para> 10256 </para>
10010 </glossdef> 10257 </glossdef>
10011 </glossentry> 10258 </glossentry>
10012 10259
10013 <glossentry id='var-SRCPV'><glossterm>SRCPV<imagedata fileref="figures/define-generic.png" /></glossterm> 10260 <glossentry id='var-SRCPV'><glossterm>SRCPV</glossterm>
10014 <info> 10261 <info>
10015 SRCPV[doc] = "Returns the version string of the current package. This string is used to help define the value of PV." 10262 SRCPV[doc] = "Returns the version string of the current package. This string is used to help define the value of PV."
10016 </info> 10263 </info>
10017 <glossdef> 10264 <glossdef>
10018 <para> 10265 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10019 Returns the version string of the current package. 10266 Returns the version string of the current package.
10020 This string is used to help define the value of 10267 This string is used to help define the value of
10021 <link linkend='var-PV'><filename>PV</filename></link>. 10268 <link linkend='var-PV'><filename>PV</filename></link>.
@@ -10047,12 +10294,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10047 </glossdef> 10294 </glossdef>
10048 </glossentry> 10295 </glossentry>
10049 10296
10050 <glossentry id='var-SRCREV'><glossterm>SRCREV<imagedata fileref="figures/define-generic.png" /></glossterm> 10297 <glossentry id='var-SRCREV'><glossterm>SRCREV</glossterm>
10051 <info> 10298 <info>
10052 SRCREV[doc] = "The revision of the source code used to build the package. This variable applies to Subversion, Git, Mercurial and Bazaar only." 10299 SRCREV[doc] = "The revision of the source code used to build the package. This variable applies to Subversion, Git, Mercurial and Bazaar only."
10053 </info> 10300 </info>
10054 <glossdef> 10301 <glossdef>
10055 <para> 10302 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10056 The revision of the source code used to build the package. 10303 The revision of the source code used to build the package.
10057 This variable applies to Subversion, Git, Mercurial and 10304 This variable applies to Subversion, Git, Mercurial and
10058 Bazaar only. 10305 Bazaar only.
@@ -10073,21 +10320,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10073 </glossdef> 10320 </glossdef>
10074 </glossentry> 10321 </glossentry>
10075 10322
10076 <glossentry id='var-SSTATE_DIR'><glossterm>SSTATE_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10323 <glossentry id='var-SSTATE_DIR'><glossterm>SSTATE_DIR</glossterm>
10077 <info> 10324 <info>
10078 SSTATE_DIR[doc] = "The directory for the shared state cache." 10325 SSTATE_DIR[doc] = "The directory for the shared state cache."
10079 </info> 10326 </info>
10080 <glossdef> 10327 <glossdef>
10081 <para>The directory for the shared state cache.</para> 10328 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10329 The directory for the shared state cache.
10330 </para>
10082 </glossdef> 10331 </glossdef>
10083 </glossentry> 10332 </glossentry>
10084 10333
10085 <glossentry id='var-SSTATE_MIRROR_ALLOW_NETWORK'><glossterm>SSTATE_MIRROR_ALLOW_NETWORK<imagedata fileref="figures/define-generic.png" /></glossterm> 10334 <glossentry id='var-SSTATE_MIRROR_ALLOW_NETWORK'><glossterm>SSTATE_MIRROR_ALLOW_NETWORK</glossterm>
10086 <info> 10335 <info>
10087 SSTATE_MIRROR_ALLOW_NETWORK[doc] = "If set to "1", allows fetches from mirrors that are specified in SSTATE_MIRRORS to work even when fetching from the network has been disabled by setting BB_NO_NETWORK to "1"." 10336 SSTATE_MIRROR_ALLOW_NETWORK[doc] = "If set to "1", allows fetches from mirrors that are specified in SSTATE_MIRRORS to work even when fetching from the network has been disabled by setting BB_NO_NETWORK to "1"."
10088 </info> 10337 </info>
10089 <glossdef> 10338 <glossdef>
10090 <para> 10339 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10091 If set to "1", allows fetches from 10340 If set to "1", allows fetches from
10092 mirrors that are specified in 10341 mirrors that are specified in
10093 <link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link> 10342 <link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link>
@@ -10104,12 +10353,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10104 </glossdef> 10353 </glossdef>
10105 </glossentry> 10354 </glossentry>
10106 10355
10107 <glossentry id='var-SSTATE_MIRRORS'><glossterm>SSTATE_MIRRORS<imagedata fileref="figures/define-generic.png" /></glossterm> 10356 <glossentry id='var-SSTATE_MIRRORS'><glossterm>SSTATE_MIRRORS</glossterm>
10108 <info> 10357 <info>
10109 SSTATE_MIRRORS[doc] = "Configures the OpenEmbedded build system to search other mirror locations for prebuilt cache data objects before building out the data. You can specify a filesystem directory or a remote URL such as HTTP or FTP." 10358 SSTATE_MIRRORS[doc] = "Configures the OpenEmbedded build system to search other mirror locations for prebuilt cache data objects before building out the data. You can specify a filesystem directory or a remote URL such as HTTP or FTP."
10110 </info> 10359 </info>
10111 <glossdef> 10360 <glossdef>
10112 <para> 10361 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10113 Configures the OpenEmbedded build system to search other 10362 Configures the OpenEmbedded build system to search other
10114 mirror locations for prebuilt cache data objects before 10363 mirror locations for prebuilt cache data objects before
10115 building out the data. 10364 building out the data.
@@ -10145,12 +10394,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10145 </glossdef> 10394 </glossdef>
10146 </glossentry> 10395 </glossentry>
10147 10396
10148 <glossentry id='var-STAGING_BASE_LIBDIR_NATIVE'><glossterm>STAGING_BASE_LIBDIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10397 <glossentry id='var-STAGING_BASE_LIBDIR_NATIVE'><glossterm>STAGING_BASE_LIBDIR_NATIVE</glossterm>
10149 <info> 10398 <info>
10150 STAGING_BASE_LIBDIR_NATIVE[doc] = "Specifies the path to the /lib subdirectory of the sysroot directory for the build host." 10399 STAGING_BASE_LIBDIR_NATIVE[doc] = "Specifies the path to the /lib subdirectory of the sysroot directory for the build host."
10151 </info> 10400 </info>
10152 <glossdef> 10401 <glossdef>
10153 <para> 10402 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10154 Specifies the path to the <filename>/lib</filename> 10403 Specifies the path to the <filename>/lib</filename>
10155 subdirectory of the sysroot directory for the 10404 subdirectory of the sysroot directory for the
10156 build host. 10405 build host.
@@ -10158,12 +10407,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10158 </glossdef> 10407 </glossdef>
10159 </glossentry> 10408 </glossentry>
10160 10409
10161 <glossentry id='var-STAGING_BASELIBDIR'><glossterm>STAGING_BASELIBDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10410 <glossentry id='var-STAGING_BASELIBDIR'><glossterm>STAGING_BASELIBDIR</glossterm>
10162 <info> 10411 <info>
10163 STAGING_BASELIBDIR[doc] = "Specifies the path to the /lib subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)." 10412 STAGING_BASELIBDIR[doc] = "Specifies the path to the /lib subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)."
10164 </info> 10413 </info>
10165 <glossdef> 10414 <glossdef>
10166 <para> 10415 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10167 Specifies the path to the <filename>/lib</filename> 10416 Specifies the path to the <filename>/lib</filename>
10168 subdirectory of the sysroot directory for the target 10417 subdirectory of the sysroot directory for the target
10169 for which the current recipe is being built 10418 for which the current recipe is being built
@@ -10172,12 +10421,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10172 </glossdef> 10421 </glossdef>
10173 </glossentry> 10422 </glossentry>
10174 10423
10175 <glossentry id='var-STAGING_BINDIR'><glossterm>STAGING_BINDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10424 <glossentry id='var-STAGING_BINDIR'><glossterm>STAGING_BINDIR</glossterm>
10176 <info> 10425 <info>
10177 STAGING_BINDIR[doc] = "Specifies the path to the /usr/bin subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)." 10426 STAGING_BINDIR[doc] = "Specifies the path to the /usr/bin subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)."
10178 </info> 10427 </info>
10179 <glossdef> 10428 <glossdef>
10180 <para> 10429 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10181 Specifies the path to the 10430 Specifies the path to the
10182 <filename>/usr/bin</filename> subdirectory of the 10431 <filename>/usr/bin</filename> subdirectory of the
10183 sysroot directory for the target for which the current 10432 sysroot directory for the target for which the current
@@ -10187,12 +10436,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10187 </glossdef> 10436 </glossdef>
10188 </glossentry> 10437 </glossentry>
10189 10438
10190 <glossentry id='var-STAGING_BINDIR_CROSS'><glossterm>STAGING_BINDIR_CROSS<imagedata fileref="figures/define-generic.png" /></glossterm> 10439 <glossentry id='var-STAGING_BINDIR_CROSS'><glossterm>STAGING_BINDIR_CROSS</glossterm>
10191 <info> 10440 <info>
10192 STAGING_BINDIR_CROSS[doc] = "Specifies the path to the directory containing binary configuration scripts. These scripts provide configuration information for other software that wants to make use of libraries or include files provided by the software associated with the script." 10441 STAGING_BINDIR_CROSS[doc] = "Specifies the path to the directory containing binary configuration scripts. These scripts provide configuration information for other software that wants to make use of libraries or include files provided by the software associated with the script."
10193 </info> 10442 </info>
10194 <glossdef> 10443 <glossdef>
10195 <para> 10444 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10196 Specifies the path to the directory containing binary 10445 Specifies the path to the directory containing binary
10197 configuration scripts. 10446 configuration scripts.
10198 These scripts provide configuration information for 10447 These scripts provide configuration information for
@@ -10212,12 +10461,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10212 </glossdef> 10461 </glossdef>
10213 </glossentry> 10462 </glossentry>
10214 10463
10215 <glossentry id='var-STAGING_BINDIR_NATIVE'><glossterm>STAGING_BINDIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10464 <glossentry id='var-STAGING_BINDIR_NATIVE'><glossterm>STAGING_BINDIR_NATIVE</glossterm>
10216 <info> 10465 <info>
10217 STAGING_BINDIR_NATIVE[doc] = "Specifies the path to the /usr/bin subdirectory of the sysroot directory for the build host." 10466 STAGING_BINDIR_NATIVE[doc] = "Specifies the path to the /usr/bin subdirectory of the sysroot directory for the build host."
10218 </info> 10467 </info>
10219 <glossdef> 10468 <glossdef>
10220 <para> 10469 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10221 Specifies the path to the 10470 Specifies the path to the
10222 <filename>/usr/bin</filename> subdirectory of the 10471 <filename>/usr/bin</filename> subdirectory of the
10223 sysroot directory for the build host. 10472 sysroot directory for the build host.
@@ -10225,12 +10474,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10225 </glossdef> 10474 </glossdef>
10226 </glossentry> 10475 </glossentry>
10227 10476
10228 <glossentry id='var-STAGING_DATADIR'><glossterm>STAGING_DATADIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10477 <glossentry id='var-STAGING_DATADIR'><glossterm>STAGING_DATADIR</glossterm>
10229 <info> 10478 <info>
10230 STAGING_DATADIR[doc] = "Specifies the path to the /usr/share subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)." 10479 STAGING_DATADIR[doc] = "Specifies the path to the /usr/share subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)."
10231 </info> 10480 </info>
10232 <glossdef> 10481 <glossdef>
10233 <para> 10482 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10234 Specifies the path to the <filename>/usr/share</filename> 10483 Specifies the path to the <filename>/usr/share</filename>
10235 subdirectory of the sysroot directory for the target 10484 subdirectory of the sysroot directory for the target
10236 for which the current recipe is being built 10485 for which the current recipe is being built
@@ -10239,24 +10488,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10239 </glossdef> 10488 </glossdef>
10240 </glossentry> 10489 </glossentry>
10241 10490
10242 <glossentry id='var-STAGING_DATADIR_NATIVE'><glossterm>STAGING_DATADIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10491 <glossentry id='var-STAGING_DATADIR_NATIVE'><glossterm>STAGING_DATADIR_NATIVE</glossterm>
10243 <info> 10492 <info>
10244 STAGING_DATADIR_NATIVE[doc] = "Specifies the path to the /usr/share subdirectory of the sysroot directory for the build host." 10493 STAGING_DATADIR_NATIVE[doc] = "Specifies the path to the /usr/share subdirectory of the sysroot directory for the build host."
10245 </info> 10494 </info>
10246 <glossdef> 10495 <glossdef>
10247 <para> 10496 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10248 Specifies the path to the <filename>/usr/share</filename> 10497 Specifies the path to the <filename>/usr/share</filename>
10249 subdirectory of the sysroot directory for the build host. 10498 subdirectory of the sysroot directory for the build host.
10250 </para> 10499 </para>
10251 </glossdef> 10500 </glossdef>
10252 </glossentry> 10501 </glossentry>
10253 10502
10254 <glossentry id='var-STAGING_DIR'><glossterm>STAGING_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10503 <glossentry id='var-STAGING_DIR'><glossterm>STAGING_DIR</glossterm>
10255 <info> 10504 <info>
10256 STAGING_DIR[doc] = "Specifies the path to the top-level sysroots directory (i.e. ${TMPDIR}/sysroots)." 10505 STAGING_DIR[doc] = "Specifies the path to the top-level sysroots directory (i.e. ${TMPDIR}/sysroots)."
10257 </info> 10506 </info>
10258 <glossdef> 10507 <glossdef>
10259 <para> 10508 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10260 Specifies the path to the top-level sysroots directory 10509 Specifies the path to the top-level sysroots directory
10261 (i.e. 10510 (i.e.
10262 <filename>${</filename><link linkend='var-TMPDIR'><filename>TMPDIR</filename></link><filename>}/sysroots</filename>). 10511 <filename>${</filename><link linkend='var-TMPDIR'><filename>TMPDIR</filename></link><filename>}/sysroots</filename>).
@@ -10275,12 +10524,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10275 </glossdef> 10524 </glossdef>
10276 </glossentry> 10525 </glossentry>
10277 10526
10278 <glossentry id='var-STAGING_DIR_HOST'><glossterm>STAGING_DIR_HOST<imagedata fileref="figures/define-generic.png" /></glossterm> 10527 <glossentry id='var-STAGING_DIR_HOST'><glossterm>STAGING_DIR_HOST</glossterm>
10279 <info> 10528 <info>
10280 STAGING_DIR_HOST[doc] = "Specifies the path to the primary sysroot directory for which the target is being built." 10529 STAGING_DIR_HOST[doc] = "Specifies the path to the primary sysroot directory for which the target is being built."
10281 </info> 10530 </info>
10282 <glossdef> 10531 <glossdef>
10283 <para> 10532 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10284 Specifies the path to the primary sysroot directory for 10533 Specifies the path to the primary sysroot directory for
10285 which the target is being built. 10534 which the target is being built.
10286 Depending on the type of recipe and the build target, the 10535 Depending on the type of recipe and the build target, the
@@ -10304,24 +10553,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10304 </glossdef> 10553 </glossdef>
10305 </glossentry> 10554 </glossentry>
10306 10555
10307 <glossentry id='var-STAGING_DIR_NATIVE'><glossterm>STAGING_DIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10556 <glossentry id='var-STAGING_DIR_NATIVE'><glossterm>STAGING_DIR_NATIVE</glossterm>
10308 <info> 10557 <info>
10309 STAGING_DIR_NATIVE[doc] = "Specifies the path to the sysroot directory for the build host." 10558 STAGING_DIR_NATIVE[doc] = "Specifies the path to the sysroot directory for the build host."
10310 </info> 10559 </info>
10311 <glossdef> 10560 <glossdef>
10312 <para> 10561 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10313 Specifies the path to the sysroot directory for the 10562 Specifies the path to the sysroot directory for the
10314 build host. 10563 build host.
10315 </para> 10564 </para>
10316 </glossdef> 10565 </glossdef>
10317 </glossentry> 10566 </glossentry>
10318 10567
10319 <glossentry id='var-STAGING_DIR_TARGET'><glossterm>STAGING_DIR_TARGET<imagedata fileref="figures/define-generic.png" /></glossterm> 10568 <glossentry id='var-STAGING_DIR_TARGET'><glossterm>STAGING_DIR_TARGET</glossterm>
10320 <info> 10569 <info>
10321 STAGING_DIR_TARGET[doc] = "Specifies the path to the sysroot directory for the target for which the current recipe is being built." 10570 STAGING_DIR_TARGET[doc] = "Specifies the path to the sysroot directory for the target for which the current recipe is being built."
10322 </info> 10571 </info>
10323 <glossdef> 10572 <glossdef>
10324 <para> 10573 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10325 Specifies the path to the sysroot directory for the 10574 Specifies the path to the sysroot directory for the
10326 target for which the current recipe is being built. 10575 target for which the current recipe is being built.
10327 In most cases, this path is the 10576 In most cases, this path is the
@@ -10343,12 +10592,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10343 </glossdef> 10592 </glossdef>
10344 </glossentry> 10593 </glossentry>
10345 10594
10346 <glossentry id='var-STAGING_ETCDIR_NATIVE'><glossterm>STAGING_ETCDIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10595 <glossentry id='var-STAGING_ETCDIR_NATIVE'><glossterm>STAGING_ETCDIR_NATIVE</glossterm>
10347 <info> 10596 <info>
10348 STAGING_ETCDIR_NATIVE[doc] = "Specifies the path to the /etc subdirectory of the sysroot directory for the build host." 10597 STAGING_ETCDIR_NATIVE[doc] = "Specifies the path to the /etc subdirectory of the sysroot directory for the build host."
10349 </info> 10598 </info>
10350 <glossdef> 10599 <glossdef>
10351 <para> 10600 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10352 Specifies the path to the <filename>/etc</filename> 10601 Specifies the path to the <filename>/etc</filename>
10353 subdirectory of the sysroot directory for the 10602 subdirectory of the sysroot directory for the
10354 build host. 10603 build host.
@@ -10356,12 +10605,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10356 </glossdef> 10605 </glossdef>
10357 </glossentry> 10606 </glossentry>
10358 10607
10359 <glossentry id='var-STAGING_EXECPREFIXDIR'><glossterm>STAGING_EXECPREFIXDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10608 <glossentry id='var-STAGING_EXECPREFIXDIR'><glossterm>STAGING_EXECPREFIXDIR</glossterm>
10360 <info> 10609 <info>
10361 STAGING_EXECPREFIXDIR[doc] = "Specifies the path to the /usr subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)." 10610 STAGING_EXECPREFIXDIR[doc] = "Specifies the path to the /usr subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)."
10362 </info> 10611 </info>
10363 <glossdef> 10612 <glossdef>
10364 <para> 10613 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10365 Specifies the path to the <filename>/usr</filename> 10614 Specifies the path to the <filename>/usr</filename>
10366 subdirectory of the sysroot directory for the target 10615 subdirectory of the sysroot directory for the target
10367 for which the current recipe is being built 10616 for which the current recipe is being built
@@ -10370,12 +10619,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10370 </glossdef> 10619 </glossdef>
10371 </glossentry> 10620 </glossentry>
10372 10621
10373 <glossentry id='var-STAGING_INCDIR'><glossterm>STAGING_INCDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10622 <glossentry id='var-STAGING_INCDIR'><glossterm>STAGING_INCDIR</glossterm>
10374 <info> 10623 <info>
10375 STAGING_INCDIR[doc] = "Specifies the path to the /usr/include subdirectory of the sysroot directory for the target for which the current recipe being built (STAGING_DIR_HOST)." 10624 STAGING_INCDIR[doc] = "Specifies the path to the /usr/include subdirectory of the sysroot directory for the target for which the current recipe being built (STAGING_DIR_HOST)."
10376 </info> 10625 </info>
10377 <glossdef> 10626 <glossdef>
10378 <para> 10627 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10379 Specifies the path to the 10628 Specifies the path to the
10380 <filename>/usr/include</filename> subdirectory of the 10629 <filename>/usr/include</filename> subdirectory of the
10381 sysroot directory for the target for which the current 10630 sysroot directory for the target for which the current
@@ -10385,36 +10634,36 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10385 </glossdef> 10634 </glossdef>
10386 </glossentry> 10635 </glossentry>
10387 10636
10388 <glossentry id='var-STAGING_INCDIR_NATIVE'><glossterm>STAGING_INCDIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10637 <glossentry id='var-STAGING_INCDIR_NATIVE'><glossterm>STAGING_INCDIR_NATIVE</glossterm>
10389 <info> 10638 <info>
10390 STAGING_INCDIR_NATIVE[doc] = "Specifies the path to the /usr/include subdirectory of the sysroot directory for the build host." 10639 STAGING_INCDIR_NATIVE[doc] = "Specifies the path to the /usr/include subdirectory of the sysroot directory for the build host."
10391 </info> 10640 </info>
10392 <glossdef> 10641 <glossdef>
10393 <para> 10642 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10394 Specifies the path to the <filename>/usr/include</filename> 10643 Specifies the path to the <filename>/usr/include</filename>
10395 subdirectory of the sysroot directory for the build host. 10644 subdirectory of the sysroot directory for the build host.
10396 </para> 10645 </para>
10397 </glossdef> 10646 </glossdef>
10398 </glossentry> 10647 </glossentry>
10399 10648
10400 <glossentry id='var-STAGING_KERNEL_DIR'><glossterm>STAGING_KERNEL_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10649 <glossentry id='var-STAGING_KERNEL_DIR'><glossterm>STAGING_KERNEL_DIR</glossterm>
10401 <info> 10650 <info>
10402 STAGING_KERNEL_DIR[doc] = "The directory with kernel headers that are required to build out-of-tree modules." 10651 STAGING_KERNEL_DIR[doc] = "The directory with kernel headers that are required to build out-of-tree modules."
10403 </info> 10652 </info>
10404 <glossdef> 10653 <glossdef>
10405 <para> 10654 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10406 The directory with kernel headers that are required to build out-of-tree 10655 The directory with kernel headers that are required to build out-of-tree
10407 modules. 10656 modules.
10408 </para> 10657 </para>
10409 </glossdef> 10658 </glossdef>
10410 </glossentry> 10659 </glossentry>
10411 10660
10412 <glossentry id='var-STAGING_LIBDIR'><glossterm>STAGING_LIBDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10661 <glossentry id='var-STAGING_LIBDIR'><glossterm>STAGING_LIBDIR</glossterm>
10413 <info> 10662 <info>
10414 STAGING_LIBDIR[doc] = "Specifies the path to the /usr/lib subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)." 10663 STAGING_LIBDIR[doc] = "Specifies the path to the /usr/lib subdirectory of the sysroot directory for the target for which the current recipe is being built (STAGING_DIR_HOST)."
10415 </info> 10664 </info>
10416 <glossdef> 10665 <glossdef>
10417 <para> 10666 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10418 Specifies the path to the <filename>/usr/lib</filename> 10667 Specifies the path to the <filename>/usr/lib</filename>
10419 subdirectory of the sysroot directory for the target for 10668 subdirectory of the sysroot directory for the target for
10420 which the current recipe is being built 10669 which the current recipe is being built
@@ -10423,24 +10672,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10423 </glossdef> 10672 </glossdef>
10424 </glossentry> 10673 </glossentry>
10425 10674
10426 <glossentry id='var-STAGING_LIBDIR_NATIVE'><glossterm>STAGING_LIBDIR_NATIVE<imagedata fileref="figures/define-generic.png" /></glossterm> 10675 <glossentry id='var-STAGING_LIBDIR_NATIVE'><glossterm>STAGING_LIBDIR_NATIVE</glossterm>
10427 <info> 10676 <info>
10428 STAGING_LIBDIR_NATIVE[doc] = "Specifies the path to the /usr/lib subdirectory of the sysroot directory for the build host." 10677 STAGING_LIBDIR_NATIVE[doc] = "Specifies the path to the /usr/lib subdirectory of the sysroot directory for the build host."
10429 </info> 10678 </info>
10430 <glossdef> 10679 <glossdef>
10431 <para> 10680 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10432 Specifies the path to the <filename>/usr/lib</filename> 10681 Specifies the path to the <filename>/usr/lib</filename>
10433 subdirectory of the sysroot directory for the build host. 10682 subdirectory of the sysroot directory for the build host.
10434 </para> 10683 </para>
10435 </glossdef> 10684 </glossdef>
10436 </glossentry> 10685 </glossentry>
10437 10686
10438 <glossentry id='var-STAMP'><glossterm>STAMP<imagedata fileref="figures/define-generic.png" /></glossterm> 10687 <glossentry id='var-STAMP'><glossterm>STAMP</glossterm>
10439 <info> 10688 <info>
10440 STAMP[doc] = "Specifies the base path used to create recipe stamp files. The path to an actual stamp file is constructed by evaluating this string and then appending additional information." 10689 STAMP[doc] = "Specifies the base path used to create recipe stamp files. The path to an actual stamp file is constructed by evaluating this string and then appending additional information."
10441 </info> 10690 </info>
10442 <glossdef> 10691 <glossdef>
10443 <para> 10692 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10444 Specifies the base path used to create recipe stamp files. 10693 Specifies the base path used to create recipe stamp files.
10445 The path to an actual stamp file is constructed by evaluating this 10694 The path to an actual stamp file is constructed by evaluating this
10446 string and then appending additional information. 10695 string and then appending additional information.
@@ -10450,6 +10699,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10450 <literallayout class='monospaced'> 10699 <literallayout class='monospaced'>
10451 STAMP = "${STAMPS_DIR}/${MULTIMACH_TARGET_SYS}/${PN}/${EXTENDPE}${PV}-${PR}" 10700 STAMP = "${STAMPS_DIR}/${MULTIMACH_TARGET_SYS}/${PN}/${EXTENDPE}${PV}-${PR}"
10452 </literallayout> 10701 </literallayout>
10702 </para>
10703
10704 <para>
10453 See <link linkend='var-STAMPS_DIR'><filename>STAMPS_DIR</filename></link>, 10705 See <link linkend='var-STAMPS_DIR'><filename>STAMPS_DIR</filename></link>,
10454 <link linkend='var-MULTIMACH_TARGET_SYS'><filename>MULTIMACH_TARGET_SYS</filename></link>, 10706 <link linkend='var-MULTIMACH_TARGET_SYS'><filename>MULTIMACH_TARGET_SYS</filename></link>,
10455 <link linkend='var-PN'><filename>PN</filename></link>, 10707 <link linkend='var-PN'><filename>PN</filename></link>,
@@ -10461,12 +10713,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10461 </glossdef> 10713 </glossdef>
10462 </glossentry> 10714 </glossentry>
10463 10715
10464 <glossentry id='var-STAMPS_DIR'><glossterm>STAMPS_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10716 <glossentry id='var-STAMPS_DIR'><glossterm>STAMPS_DIR</glossterm>
10465 <info> 10717 <info>
10466 STAMPS_DIR[doc] = "Specifies the base directory in which the OpenEmbedded build system places stamps." 10718 STAMPS_DIR[doc] = "Specifies the base directory in which the OpenEmbedded build system places stamps."
10467 </info> 10719 </info>
10468 <glossdef> 10720 <glossdef>
10469 <para> 10721 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10470 Specifies the base directory in which the OpenEmbedded 10722 Specifies the base directory in which the OpenEmbedded
10471 build system places stamps. 10723 build system places stamps.
10472 The default directory is 10724 The default directory is
@@ -10475,12 +10727,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10475 </glossdef> 10727 </glossdef>
10476 </glossentry> 10728 </glossentry>
10477 10729
10478 <glossentry id='var-STRIP'><glossterm>STRIP<imagedata fileref="figures/define-generic.png" /></glossterm> 10730 <glossentry id='var-STRIP'><glossterm>STRIP</glossterm>
10479 <info> 10731 <info>
10480 STRIP[doc] = "Minimal command and arguments to run 'strip' (strip symbols)." 10732 STRIP[doc] = "Minimal command and arguments to run 'strip' (strip symbols)."
10481 </info> 10733 </info>
10482 <glossdef> 10734 <glossdef>
10483 <para> 10735 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10484 The minimal command and arguments to run 10736 The minimal command and arguments to run
10485 <filename>strip</filename>, which is used to strip 10737 <filename>strip</filename>, which is used to strip
10486 symbols. 10738 symbols.
@@ -10488,12 +10740,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10488 </glossdef> 10740 </glossdef>
10489 </glossentry> 10741 </glossentry>
10490 10742
10491 <glossentry id='var-SUMMARY'><glossterm>SUMMARY<imagedata fileref="figures/define-generic.png" /></glossterm> 10743 <glossentry id='var-SUMMARY'><glossterm>SUMMARY</glossterm>
10492 <info> 10744 <info>
10493 SUMMARY[doc] = "The short (80 characters or less) summary of the binary package for packaging systems such as opkg, rpm or dpkg. By default, SUMMARY is used to define the DESCRIPTION variable if DESCRIPTION is not set in the recipe." 10745 SUMMARY[doc] = "The short (80 characters or less) summary of the binary package for packaging systems such as opkg, rpm or dpkg. By default, SUMMARY is used to define the DESCRIPTION variable if DESCRIPTION is not set in the recipe."
10494 </info> 10746 </info>
10495 <glossdef> 10747 <glossdef>
10496 <para>The short (72 characters or less) summary of the binary package for packaging 10748 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10749 The short (72 characters or less) summary of the binary package for packaging
10497 systems such as <filename>opkg</filename>, <filename>rpm</filename> or 10750 systems such as <filename>opkg</filename>, <filename>rpm</filename> or
10498 <filename>dpkg</filename>. 10751 <filename>dpkg</filename>.
10499 By default, <filename>SUMMARY</filename> is used to define 10752 By default, <filename>SUMMARY</filename> is used to define
@@ -10504,25 +10757,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10504 </glossdef> 10757 </glossdef>
10505 </glossentry> 10758 </glossentry>
10506 10759
10507 <glossentry id='var-SVNDIR'><glossterm>SVNDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 10760 <glossentry id='var-SVNDIR'><glossterm>SVNDIR</glossterm>
10508 <info> 10761 <info>
10509 SVNDIR[doc] = "The directory where Subversion checkouts will be stored." 10762 SVNDIR[doc] = "The directory where Subversion checkouts will be stored."
10510
10511 </info> 10763 </info>
10512 <glossdef> 10764 <glossdef>
10513 <para> 10765 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10514 The directory in which files checked out of a Subversion 10766 The directory in which files checked out of a Subversion
10515 system are stored. 10767 system are stored.
10516 </para> 10768 </para>
10517 </glossdef> 10769 </glossdef>
10518 </glossentry> 10770 </glossentry>
10519 10771
10520 <glossentry id='var-SYSLINUX_DEFAULT_CONSOLE'><glossterm>SYSLINUX_DEFAULT_CONSOLE<imagedata fileref="figures/define-generic.png" /></glossterm> 10772 <glossentry id='var-SYSLINUX_DEFAULT_CONSOLE'><glossterm>SYSLINUX_DEFAULT_CONSOLE</glossterm>
10521 <info> 10773 <info>
10522 SYSLINUX_DEFAULT_CONSOLE[doc] = "Specifies the kernel boot default console." 10774 SYSLINUX_DEFAULT_CONSOLE[doc] = "Specifies the kernel boot default console."
10523 </info> 10775 </info>
10524 <glossdef> 10776 <glossdef>
10525 <para> 10777 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10526 Specifies the kernel boot default console. 10778 Specifies the kernel boot default console.
10527 If you want to use a console other than the default, 10779 If you want to use a console other than the default,
10528 set this variable in your recipe as follows where "X" is 10780 set this variable in your recipe as follows where "X" is
@@ -10541,12 +10793,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10541 </glossdef> 10793 </glossdef>
10542 </glossentry> 10794 </glossentry>
10543 10795
10544 <glossentry id='var-SYSLINUX_OPTS'><glossterm>SYSLINUX_OPTS<imagedata fileref="figures/define-generic.png" /></glossterm> 10796 <glossentry id='var-SYSLINUX_OPTS'><glossterm>SYSLINUX_OPTS</glossterm>
10545 <info> 10797 <info>
10546 SYSLINUX_OPTS[doc] = "Lists additional options to add to the syslinux file." 10798 SYSLINUX_OPTS[doc] = "Lists additional options to add to the syslinux file."
10547 </info> 10799 </info>
10548 <glossdef> 10800 <glossdef>
10549 <para> 10801 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10550 Lists additional options to add to the syslinux file. 10802 Lists additional options to add to the syslinux file.
10551 You need to set this variable in your recipe. 10803 You need to set this variable in your recipe.
10552 If you want to list multiple options, separate the options 10804 If you want to list multiple options, separate the options
@@ -10561,12 +10813,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10561 </glossdef> 10813 </glossdef>
10562 </glossentry> 10814 </glossentry>
10563 10815
10564 <glossentry id='var-SYSLINUX_SERIAL'><glossterm>SYSLINUX_SERIAL<imagedata fileref="figures/define-generic.png" /></glossterm> 10816 <glossentry id='var-SYSLINUX_SERIAL'><glossterm>SYSLINUX_SERIAL</glossterm>
10565 <info> 10817 <info>
10566 SYSLINUX_SERIAL[doc] = "Specifies the alternate serial port or turns it off." 10818 SYSLINUX_SERIAL[doc] = "Specifies the alternate serial port or turns it off."
10567 </info> 10819 </info>
10568 <glossdef> 10820 <glossdef>
10569 <para> 10821 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10570 Specifies the alternate serial port or turns it off. 10822 Specifies the alternate serial port or turns it off.
10571 To turn off serial, set this variable to an empty string 10823 To turn off serial, set this variable to an empty string
10572 in your recipe. 10824 in your recipe.
@@ -10576,16 +10828,20 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10576 <literallayout class='monospaced'> 10828 <literallayout class='monospaced'>
10577 SYSLINUX_SERIAL ?= "0 115200" 10829 SYSLINUX_SERIAL ?= "0 115200"
10578 </literallayout> 10830 </literallayout>
10579 The class checks for and uses the variable as needed. </para> 10831 </para>
10832
10833 <para>
10834 The class checks for and uses the variable as needed.
10835 </para>
10580 </glossdef> 10836 </glossdef>
10581 </glossentry> 10837 </glossentry>
10582 10838
10583 <glossentry id='var-SYSLINUX_SPLASH'><glossterm>SYSLINUX_SPLASH<imagedata fileref="figures/define-generic.png" /></glossterm> 10839 <glossentry id='var-SYSLINUX_SPLASH'><glossterm>SYSLINUX_SPLASH</glossterm>
10584 <info> 10840 <info>
10585 SYSLINUX_SPLASH[doc] = "An .LSS file used as the background for the VGA boot menu when you are using the boot menu." 10841 SYSLINUX_SPLASH[doc] = "An .LSS file used as the background for the VGA boot menu when you are using the boot menu."
10586 </info> 10842 </info>
10587 <glossdef> 10843 <glossdef>
10588 <para> 10844 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10589 An <filename>.LSS</filename> file used as the background 10845 An <filename>.LSS</filename> file used as the background
10590 for the VGA boot menu when you are using the boot menu. 10846 for the VGA boot menu when you are using the boot menu.
10591 You need to set this variable in your recipe. 10847 You need to set this variable in your recipe.
@@ -10600,12 +10856,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10600 </glossdef> 10856 </glossdef>
10601 </glossentry> 10857 </glossentry>
10602 10858
10603 <glossentry id='var-SYSLINUX_SERIAL_TTY'><glossterm>SYSLINUX_SERIAL_TTY<imagedata fileref="figures/define-generic.png" /></glossterm> 10859 <glossentry id='var-SYSLINUX_SERIAL_TTY'><glossterm>SYSLINUX_SERIAL_TTY</glossterm>
10604 <info> 10860 <info>
10605 SYSLINUX_SERIAL_TTY[doc] = "Specifies the alternate console=tty... kernel boot argument." 10861 SYSLINUX_SERIAL_TTY[doc] = "Specifies the alternate console=tty... kernel boot argument."
10606 </info> 10862 </info>
10607 <glossdef> 10863 <glossdef>
10608 <para> 10864 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10609 Specifies the alternate console=tty... kernel boot argument. 10865 Specifies the alternate console=tty... kernel boot argument.
10610 The variable's default value is set in the 10866 The variable's default value is set in the
10611 <link linkend='ref-classes-syslinux'><filename>syslinux</filename></link> 10867 <link linkend='ref-classes-syslinux'><filename>syslinux</filename></link>
@@ -10613,17 +10869,20 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10613 <literallayout class='monospaced'> 10869 <literallayout class='monospaced'>
10614 SYSLINUX_SERIAL_TTY ?= "console=ttyS0,115200" 10870 SYSLINUX_SERIAL_TTY ?= "console=ttyS0,115200"
10615 </literallayout> 10871 </literallayout>
10872 </para>
10873
10874 <para>
10616 The class checks for and uses the variable as needed. 10875 The class checks for and uses the variable as needed.
10617 </para> 10876 </para>
10618 </glossdef> 10877 </glossdef>
10619 </glossentry> 10878 </glossentry>
10620 10879
10621 <glossentry id='var-SYSROOT_PREPROCESS_FUNCS'><glossterm>SYSROOT_PREPROCESS_FUNCS<imagedata fileref="figures/define-generic.png" /></glossterm> 10880 <glossentry id='var-SYSROOT_PREPROCESS_FUNCS'><glossterm>SYSROOT_PREPROCESS_FUNCS</glossterm>
10622 <info> 10881 <info>
10623 SYSROOT_PREPROCESS_FUNCS[doc] = "A list of functions to execute after files are staged into the sysroot. These functions are usually used to apply additional processing on the staged files, or to stage additional files." 10882 SYSROOT_PREPROCESS_FUNCS[doc] = "A list of functions to execute after files are staged into the sysroot. These functions are usually used to apply additional processing on the staged files, or to stage additional files."
10624 </info> 10883 </info>
10625 <glossdef> 10884 <glossdef>
10626 <para> 10885 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10627 A list of functions to execute after files are staged into 10886 A list of functions to execute after files are staged into
10628 the sysroot. 10887 the sysroot.
10629 These functions are usually used to apply additional 10888 These functions are usually used to apply additional
@@ -10633,12 +10892,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10633 </glossdef> 10892 </glossdef>
10634 </glossentry> 10893 </glossentry>
10635 10894
10636 <glossentry id='var-SYSTEMD_AUTO_ENABLE'><glossterm>SYSTEMD_AUTO_ENABLE<imagedata fileref="figures/define-generic.png" /></glossterm> 10895 <glossentry id='var-SYSTEMD_AUTO_ENABLE'><glossterm>SYSTEMD_AUTO_ENABLE</glossterm>
10637 <info> 10896 <info>
10638 SYSTEMD_AUTO_ENABLE[doc] = "For recipes that inherit the systemd class, this variable specifies whether the service you have specified in SYSTEMD_SERVICE should be started automatically or not." 10897 SYSTEMD_AUTO_ENABLE[doc] = "For recipes that inherit the systemd class, this variable specifies whether the service you have specified in SYSTEMD_SERVICE should be started automatically or not."
10639 </info> 10898 </info>
10640 <glossdef> 10899 <glossdef>
10641 <para> 10900 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10642 When inheriting the 10901 When inheriting the
10643 <link linkend='ref-classes-systemd'><filename>systemd</filename></link> 10902 <link linkend='ref-classes-systemd'><filename>systemd</filename></link>
10644 class, this variable specifies whether the service you have 10903 class, this variable specifies whether the service you have
@@ -10653,18 +10912,21 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10653 <literallayout class='monospaced'> 10912 <literallayout class='monospaced'>
10654 SYSTEMD_AUTO_ENABLE ??= "enable" 10913 SYSTEMD_AUTO_ENABLE ??= "enable"
10655 </literallayout> 10914 </literallayout>
10915 </para>
10916
10917 <para>
10656 You can disable the service by setting the variable to 10918 You can disable the service by setting the variable to
10657 "disable". 10919 "disable".
10658 </para> 10920 </para>
10659 </glossdef> 10921 </glossdef>
10660 </glossentry> 10922 </glossentry>
10661 10923
10662 <glossentry id='var-SYSTEMD_PACKAGES'><glossterm>SYSTEMD_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 10924 <glossentry id='var-SYSTEMD_PACKAGES'><glossterm>SYSTEMD_PACKAGES</glossterm>
10663 <info> 10925 <info>
10664 SYSTEMD_PACKAGES[doc] = "For recipes that inherit the systemd class, this variable locates the systemd unit files when they are not found in the main recipe's package." 10926 SYSTEMD_PACKAGES[doc] = "For recipes that inherit the systemd class, this variable locates the systemd unit files when they are not found in the main recipe's package."
10665 </info> 10927 </info>
10666 <glossdef> 10928 <glossdef>
10667 <para> 10929 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10668 When inheriting the 10930 When inheriting the
10669 <link linkend='ref-classes-systemd'><filename>systemd</filename></link> 10931 <link linkend='ref-classes-systemd'><filename>systemd</filename></link>
10670 class, this variable locates the systemd unit files when 10932 class, this variable locates the systemd unit files when
@@ -10676,6 +10938,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10676 <literallayout class='monospaced'> 10938 <literallayout class='monospaced'>
10677 SYSTEMD_PACKAGES ?= "${PN}" 10939 SYSTEMD_PACKAGES ?= "${PN}"
10678 </literallayout> 10940 </literallayout>
10941 </para>
10942
10943 <para>
10679 If these unit files are not in this recipe's main 10944 If these unit files are not in this recipe's main
10680 package, you need to use 10945 package, you need to use
10681 <filename>SYSTEMD_PACKAGES</filename> to list the package 10946 <filename>SYSTEMD_PACKAGES</filename> to list the package
@@ -10685,12 +10950,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10685 </glossdef> 10950 </glossdef>
10686 </glossentry> 10951 </glossentry>
10687 10952
10688 <glossentry id='var-SYSTEMD_SERVICE'><glossterm>SYSTEMD_SERVICE<imagedata fileref="figures/define-generic.png" /></glossterm> 10953 <glossentry id='var-SYSTEMD_SERVICE'><glossterm>SYSTEMD_SERVICE</glossterm>
10689 <info> 10954 <info>
10690 SYSTEMD_SERVICE[doc] = "For recipes that inherit the systemd class, this variable specifies the systemd service name for a package." 10955 SYSTEMD_SERVICE[doc] = "For recipes that inherit the systemd class, this variable specifies the systemd service name for a package."
10691 </info> 10956 </info>
10692 <glossdef> 10957 <glossdef>
10693 <para> 10958 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10694 When inheriting the 10959 When inheriting the
10695 <link linkend='ref-classes-systemd'><filename>systemd</filename></link> 10960 <link linkend='ref-classes-systemd'><filename>systemd</filename></link>
10696 class, this variable specifies the systemd service name for 10961 class, this variable specifies the systemd service name for
@@ -10709,12 +10974,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10709 </glossdef> 10974 </glossdef>
10710 </glossentry> 10975 </glossentry>
10711 10976
10712 <glossentry id='var-SYSVINIT_ENABLED_GETTYS'><glossterm>SYSVINIT_ENABLED_GETTYS<imagedata fileref="figures/define-generic.png" /></glossterm> 10977 <glossentry id='var-SYSVINIT_ENABLED_GETTYS'><glossterm>SYSVINIT_ENABLED_GETTYS</glossterm>
10713 <info> 10978 <info>
10714 SYSVINIT_ENABLED_GETTYS[doc] = "Specifies which virtual terminals should be running a getty, the default is '1'." 10979 SYSVINIT_ENABLED_GETTYS[doc] = "Specifies which virtual terminals should be running a getty, the default is '1'."
10715 </info> 10980 </info>
10716 <glossdef> 10981 <glossdef>
10717 <para> 10982 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10718 When using 10983 When using
10719 <ulink url='&YOCTO_DOCS_DEV_URL;#new-recipe-enabling-system-services'>SysVinit</ulink>, 10984 <ulink url='&YOCTO_DOCS_DEV_URL;#new-recipe-enabling-system-services'>SysVinit</ulink>,
10720 specifies a space-separated list of the virtual terminals 10985 specifies a space-separated list of the virtual terminals
@@ -10737,18 +11002,22 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10737 11002
10738 <glossdiv id='var-glossary-t'><title>T</title> 11003 <glossdiv id='var-glossary-t'><title>T</title>
10739 11004
10740 <glossentry id='var-T'><glossterm>T<imagedata fileref="figures/define-generic.png" /></glossterm> 11005 <glossentry id='var-T'><glossterm>T</glossterm>
10741 <info> 11006 <info>
10742 T[doc] = "This variable points to a directory were BitBake places temporary files, which consist mostly of task logs and scripts, when building a particular recipe." 11007 T[doc] = "This variable points to a directory were BitBake places temporary files, which consist mostly of task logs and scripts, when building a particular recipe."
10743 </info> 11008 </info>
10744 <glossdef> 11009 <glossdef>
10745 <para>This variable points to a directory were BitBake places 11010 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11011 This variable points to a directory were BitBake places
10746 temporary files, which consist mostly of task logs and 11012 temporary files, which consist mostly of task logs and
10747 scripts, when building a particular recipe. 11013 scripts, when building a particular recipe.
10748 The variable is typically set as follows: 11014 The variable is typically set as follows:
10749 <literallayout class='monospaced'> 11015 <literallayout class='monospaced'>
10750 T = "${WORKDIR}/temp" 11016 T = "${WORKDIR}/temp"
10751 </literallayout> 11017 </literallayout>
11018 </para>
11019
11020 <para>
10752 The <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link> 11021 The <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>
10753 is the directory into which BitBake unpacks and builds the 11022 is the directory into which BitBake unpacks and builds the
10754 recipe. 11023 recipe.
@@ -10761,12 +11030,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10761 </glossdef> 11030 </glossdef>
10762 </glossentry> 11031 </glossentry>
10763 11032
10764 <glossentry id='var-TARGET_ARCH'><glossterm>TARGET_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 11033 <glossentry id='var-TARGET_ARCH'><glossterm>TARGET_ARCH</glossterm>
10765 <info> 11034 <info>
10766 TARGET_ARCH[doc] = "The architecture of the device being built. The OpenEmbedded build system supports the following architectures: arm, mips, ppc, x86, x86-64." 11035 TARGET_ARCH[doc] = "The architecture of the device being built. The OpenEmbedded build system supports the following architectures: arm, mips, ppc, x86, x86-64."
10767 </info> 11036 </info>
10768 <glossdef> 11037 <glossdef>
10769 <para> 11038 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10770 The target machine's architecture. 11039 The target machine's architecture.
10771 The OpenEmbedded build system supports many 11040 The OpenEmbedded build system supports many
10772 architectures. 11041 architectures.
@@ -10782,6 +11051,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10782 mips 11051 mips
10783 mipsel 11052 mipsel
10784 </literallayout> 11053 </literallayout>
11054 </para>
11055
11056 <para>
10785 For additional information on machine architectures, see 11057 For additional information on machine architectures, see
10786 the 11058 the
10787 <link linkend='var-TUNE_ARCH'><filename>TUNE_ARCH</filename></link> 11059 <link linkend='var-TUNE_ARCH'><filename>TUNE_ARCH</filename></link>
@@ -10790,12 +11062,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10790 </glossdef> 11062 </glossdef>
10791 </glossentry> 11063 </glossentry>
10792 11064
10793 <glossentry id='var-TARGET_AS_ARCH'><glossterm>TARGET_AS_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 11065 <glossentry id='var-TARGET_AS_ARCH'><glossterm>TARGET_AS_ARCH</glossterm>
10794 <info> 11066 <info>
10795 TARGET_AS_ARCH[doc] = "Specifies architecture-specific assembler flags for the target system." 11067 TARGET_AS_ARCH[doc] = "Specifies architecture-specific assembler flags for the target system."
10796 </info> 11068 </info>
10797 <glossdef> 11069 <glossdef>
10798 <para> 11070 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10799 Specifies architecture-specific assembler flags for the 11071 Specifies architecture-specific assembler flags for the
10800 target system. 11072 target system.
10801 <filename>TARGET_AS_ARCH</filename> is initialized from 11073 <filename>TARGET_AS_ARCH</filename> is initialized from
@@ -10809,12 +11081,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10809 </glossdef> 11081 </glossdef>
10810 </glossentry> 11082 </glossentry>
10811 11083
10812 <glossentry id='var-TARGET_CC_ARCH'><glossterm>TARGET_CC_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 11084 <glossentry id='var-TARGET_CC_ARCH'><glossterm>TARGET_CC_ARCH</glossterm>
10813 <info> 11085 <info>
10814 TARGET_CC_ARCH[doc] = "Specifies architecture-specific C compiler flags for the target system." 11086 TARGET_CC_ARCH[doc] = "Specifies architecture-specific C compiler flags for the target system."
10815 </info> 11087 </info>
10816 <glossdef> 11088 <glossdef>
10817 <para> 11089 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10818 Specifies architecture-specific C compiler flags for the 11090 Specifies architecture-specific C compiler flags for the
10819 target system. 11091 target system.
10820 <filename>TARGET_CC_ARCH</filename> is initialized from 11092 <filename>TARGET_CC_ARCH</filename> is initialized from
@@ -10832,12 +11104,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10832 </glossdef> 11104 </glossdef>
10833 </glossentry> 11105 </glossentry>
10834 11106
10835 <glossentry id='var-TARGET_CC_KERNEL_ARCH'><glossterm>TARGET_CC_KERNEL_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 11107 <glossentry id='var-TARGET_CC_KERNEL_ARCH'><glossterm>TARGET_CC_KERNEL_ARCH</glossterm>
10836 <info> 11108 <info>
10837 TARGET_CC_KERNEL_ARCH[doc] = "This is a specific kernel compiler flag for a CPU or Application Binary Interface (ABI) tune." 11109 TARGET_CC_KERNEL_ARCH[doc] = "This is a specific kernel compiler flag for a CPU or Application Binary Interface (ABI) tune."
10838 </info> 11110 </info>
10839 <glossdef> 11111 <glossdef>
10840 <para> 11112 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10841 This is a specific kernel compiler flag for a CPU or 11113 This is a specific kernel compiler flag for a CPU or
10842 Application Binary Interface (ABI) tune. 11114 Application Binary Interface (ABI) tune.
10843 The flag is used rarely and only for cases where a 11115 The flag is used rarely and only for cases where a
@@ -10856,12 +11128,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10856 </glossdef> 11128 </glossdef>
10857 </glossentry> 11129 </glossentry>
10858 11130
10859 <glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 11131 <glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS</glossterm>
10860 <info> 11132 <info>
10861 TARGET_CFLAGS[doc] = "Flags passed to the C compiler for the target system. This variable evaluates to the same as CFLAGS." 11133 TARGET_CFLAGS[doc] = "Flags passed to the C compiler for the target system. This variable evaluates to the same as CFLAGS."
10862 </info> 11134 </info>
10863 <glossdef> 11135 <glossdef>
10864 <para> 11136 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10865 Specifies the flags to pass to the C compiler when building 11137 Specifies the flags to pass to the C compiler when building
10866 for the target. 11138 for the target.
10867 When building in the target context, 11139 When building in the target context,
@@ -10881,12 +11153,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10881 </glossdef> 11153 </glossdef>
10882 </glossentry> 11154 </glossentry>
10883 11155
10884 <glossentry id='var-TARGET_CPPFLAGS'><glossterm>TARGET_CPPFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 11156 <glossentry id='var-TARGET_CPPFLAGS'><glossterm>TARGET_CPPFLAGS</glossterm>
10885 <info> 11157 <info>
10886 TARGET_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the target." 11158 TARGET_CPPFLAGS[doc] = "Specifies the flags to pass to the C pre-processor (i.e. to both the C and the C++ compilers) when building for the target."
10887 </info> 11159 </info>
10888 <glossdef> 11160 <glossdef>
10889 <para> 11161 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10890 Specifies the flags to pass to the C pre-processor 11162 Specifies the flags to pass to the C pre-processor
10891 (i.e. to both the C and the C++ compilers) when building 11163 (i.e. to both the C and the C++ compilers) when building
10892 for the target. 11164 for the target.
@@ -10907,12 +11179,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10907 </glossdef> 11179 </glossdef>
10908 </glossentry> 11180 </glossentry>
10909 11181
10910 <glossentry id='var-TARGET_CXXFLAGS'><glossterm>TARGET_CXXFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 11182 <glossentry id='var-TARGET_CXXFLAGS'><glossterm>TARGET_CXXFLAGS</glossterm>
10911 <info> 11183 <info>
10912 TARGET_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the target." 11184 TARGET_CXXFLAGS[doc] = "Specifies the flags to pass to the C++ compiler when building for the target."
10913 </info> 11185 </info>
10914 <glossdef> 11186 <glossdef>
10915 <para> 11187 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10916 Specifies the flags to pass to the C++ compiler when 11188 Specifies the flags to pass to the C++ compiler when
10917 building for the target. 11189 building for the target.
10918 When building in the target context, 11190 When building in the target context,
@@ -10932,24 +11204,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10932 </glossdef> 11204 </glossdef>
10933 </glossentry> 11205 </glossentry>
10934 11206
10935 <glossentry id='var-TARGET_FPU'><glossterm>TARGET_FPU<imagedata fileref="figures/define-generic.png" /></glossterm> 11207 <glossentry id='var-TARGET_FPU'><glossterm>TARGET_FPU</glossterm>
10936 <info> 11208 <info>
10937 TARGET_FPU[doc] = "Specifies the method for handling FPU code. For FPU-less targets, which include most ARM CPUs, the variable must be set to 'soft'. If not, the kernel emulation gets used, which results in a performance penalty." 11209 TARGET_FPU[doc] = "Specifies the method for handling FPU code. For FPU-less targets, which include most ARM CPUs, the variable must be set to 'soft'. If not, the kernel emulation gets used, which results in a performance penalty."
10938 </info> 11210 </info>
10939 <glossdef> 11211 <glossdef>
10940 <para>Specifies the method for handling FPU code. 11212 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11213 Specifies the method for handling FPU code.
10941 For FPU-less targets, which include most ARM CPUs, the variable must be 11214 For FPU-less targets, which include most ARM CPUs, the variable must be
10942 set to "soft". 11215 set to "soft".
10943 If not, the kernel emulation gets used, which results in a performance penalty.</para> 11216 If not, the kernel emulation gets used, which results in a performance penalty.
11217 </para>
10944 </glossdef> 11218 </glossdef>
10945 </glossentry> 11219 </glossentry>
10946 11220
10947 <glossentry id='var-TARGET_LD_ARCH'><glossterm>TARGET_LD_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 11221 <glossentry id='var-TARGET_LD_ARCH'><glossterm>TARGET_LD_ARCH</glossterm>
10948 <info> 11222 <info>
10949 TARGET_LD_ARCH[doc] = "Specifies architecture-specific linker flags for the target system." 11223 TARGET_LD_ARCH[doc] = "Specifies architecture-specific linker flags for the target system."
10950 </info> 11224 </info>
10951 <glossdef> 11225 <glossdef>
10952 <para> 11226 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10953 Specifies architecture-specific linker flags for the 11227 Specifies architecture-specific linker flags for the
10954 target system. 11228 target system.
10955 <filename>TARGET_LD_ARCH</filename> is initialized from 11229 <filename>TARGET_LD_ARCH</filename> is initialized from
@@ -10963,12 +11237,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10963 </glossdef> 11237 </glossdef>
10964 </glossentry> 11238 </glossentry>
10965 11239
10966 <glossentry id='var-TARGET_LDFLAGS'><glossterm>TARGET_LDFLAGS<imagedata fileref="figures/define-generic.png" /></glossterm> 11240 <glossentry id='var-TARGET_LDFLAGS'><glossterm>TARGET_LDFLAGS</glossterm>
10967 <info> 11241 <info>
10968 TARGET_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the target." 11242 TARGET_LDFLAGS[doc] = "Specifies the flags to pass to the linker when building for the target."
10969 </info> 11243 </info>
10970 <glossdef> 11244 <glossdef>
10971 <para> 11245 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
10972 Specifies the flags to pass to the linker when building 11246 Specifies the flags to pass to the linker when building
10973 for the target. 11247 for the target.
10974 When building in the target context, 11248 When building in the target context,
@@ -10988,25 +11262,27 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
10988 </glossdef> 11262 </glossdef>
10989 </glossentry> 11263 </glossentry>
10990 11264
10991 <glossentry id='var-TARGET_OS'><glossterm>TARGET_OS<imagedata fileref="figures/define-generic.png" /></glossterm> 11265 <glossentry id='var-TARGET_OS'><glossterm>TARGET_OS</glossterm>
10992 <info> 11266 <info>
10993 TARGET_OS[doc] = "Specifies the target's operating system." 11267 TARGET_OS[doc] = "Specifies the target's operating system."
10994 </info> 11268 </info>
10995 <glossdef> 11269 <glossdef>
10996 <para>Specifies the target's operating system. 11270 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11271 Specifies the target's operating system.
10997 The variable can be set to "linux" for <filename>glibc</filename>-based systems and 11272 The variable can be set to "linux" for <filename>glibc</filename>-based systems and
10998 to "linux-uclibc" for <filename>uclibc</filename>. 11273 to "linux-uclibc" for <filename>uclibc</filename>.
10999 For ARM/EABI targets, there are also "linux-gnueabi" and 11274 For ARM/EABI targets, there are also "linux-gnueabi" and
11000 "linux-uclibc-gnueabi" values possible.</para> 11275 "linux-uclibc-gnueabi" values possible.
11276 </para>
11001 </glossdef> 11277 </glossdef>
11002 </glossentry> 11278 </glossentry>
11003 11279
11004 <glossentry id='var-TARGET_PREFIX'><glossterm>TARGET_PREFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 11280 <glossentry id='var-TARGET_PREFIX'><glossterm>TARGET_PREFIX</glossterm>
11005 <info> 11281 <info>
11006 TARGET_PREFIX[doc] = "The prefix used for the toolchain binary target tools." 11282 TARGET_PREFIX[doc] = "The prefix used for the toolchain binary target tools."
11007 </info> 11283 </info>
11008 <glossdef> 11284 <glossdef>
11009 <para> 11285 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11010 Specifies the prefix used for the toolchain binary target 11286 Specifies the prefix used for the toolchain binary target
11011 tools. 11287 tools.
11012 </para> 11288 </para>
@@ -11035,12 +11311,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11035 </glossdef> 11311 </glossdef>
11036 </glossentry> 11312 </glossentry>
11037 11313
11038 <glossentry id='var-TARGET_SYS'><glossterm>TARGET_SYS<imagedata fileref="figures/define-generic.png" /></glossterm> 11314 <glossentry id='var-TARGET_SYS'><glossterm>TARGET_SYS</glossterm>
11039 <info> 11315 <info>
11040 TARGET_SYS[doc] = "The target system is comprised of TARGET_ARCH,TARGET_VENDOR and TARGET_OS." 11316 TARGET_SYS[doc] = "The target system is comprised of TARGET_ARCH,TARGET_VENDOR and TARGET_OS."
11041 </info> 11317 </info>
11042 <glossdef> 11318 <glossdef>
11043 <para> 11319 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11044 Specifies the system, including the architecture and the 11320 Specifies the system, including the architecture and the
11045 operating system, for which the build is occurring in 11321 operating system, for which the build is occurring in
11046 the context of the current recipe. 11322 the context of the current recipe.
@@ -11078,23 +11354,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11078 </glossdef> 11354 </glossdef>
11079 </glossentry> 11355 </glossentry>
11080 11356
11081 <glossentry id='var-TARGET_VENDOR'><glossterm>TARGET_VENDOR<imagedata fileref="figures/define-generic.png" /></glossterm> 11357 <glossentry id='var-TARGET_VENDOR'><glossterm>TARGET_VENDOR</glossterm>
11082 <info> 11358 <info>
11083 TARGET_VENDOR[doc] = "The name of the target vendor." 11359 TARGET_VENDOR[doc] = "The name of the target vendor."
11084 </info> 11360 </info>
11085 <glossdef> 11361 <glossdef>
11086 <para> 11362 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11087 Specifies the name of the target vendor. 11363 Specifies the name of the target vendor.
11088 </para> 11364 </para>
11089 </glossdef> 11365 </glossdef>
11090 </glossentry> 11366 </glossentry>
11091 11367
11092 <glossentry id='var-TCLIBCAPPEND'><glossterm>TCLIBCAPPEND<imagedata fileref="figures/define-generic.png" /></glossterm> 11368 <glossentry id='var-TCLIBCAPPEND'><glossterm>TCLIBCAPPEND</glossterm>
11093 <info> 11369 <info>
11094 TCLIBCAPPEND[doc] = "Specifies a suffix appended to TMPDIR that identifies the libc variant for the build." 11370 TCLIBCAPPEND[doc] = "Specifies a suffix appended to TMPDIR that identifies the libc variant for the build."
11095 </info> 11371 </info>
11096 <glossdef> 11372 <glossdef>
11097 <para> 11373 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11098 Specifies a suffix to be appended onto the 11374 Specifies a suffix to be appended onto the
11099 <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link> 11375 <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link>
11100 value. 11376 value.
@@ -11119,17 +11395,18 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11119 </glossdef> 11395 </glossdef>
11120 </glossentry> 11396 </glossentry>
11121 11397
11122 <glossentry id='var-TCLIBC'><glossterm>TCLIBC<imagedata fileref="figures/define-generic.png" /></glossterm> 11398 <glossentry id='var-TCLIBC'><glossterm>TCLIBC</glossterm>
11123 <info> 11399 <info>
11124 TCLIBC[doc] = "Specifies GNU standard C library (libc) variant to use during the build process. You can select 'glibc' or 'uclibc'." 11400 TCLIBC[doc] = "Specifies GNU standard C library (libc) variant to use during the build process. You can select 'glibc' or 'uclibc'."
11125 </info> 11401 </info>
11126 <glossdef> 11402 <glossdef>
11127 <para> 11403 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11128 Specifies the GNU standard C library (<filename>libc</filename>) 11404 Specifies the GNU standard C library (<filename>libc</filename>)
11129 variant to use during the build process. 11405 variant to use during the build process.
11130 This variable replaces <filename>POKYLIBC</filename>, which is no longer 11406 This variable replaces <filename>POKYLIBC</filename>, which is no longer
11131 supported. 11407 supported.
11132 </para> 11408 </para>
11409
11133 <para> 11410 <para>
11134 You can select "glibc" or "uclibc". 11411 You can select "glibc" or "uclibc".
11135 <note> 11412 <note>
@@ -11140,12 +11417,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11140 </glossdef> 11417 </glossdef>
11141 </glossentry> 11418 </glossentry>
11142 11419
11143 <glossentry id='var-TCMODE'><glossterm>TCMODE<imagedata fileref="figures/define-generic.png" /></glossterm> 11420 <glossentry id='var-TCMODE'><glossterm>TCMODE</glossterm>
11144 <info> 11421 <info>
11145 TCMODE[doc] = "Enables an external toolchain (where provided by an additional layer) if set to a value other than 'default'." 11422 TCMODE[doc] = "Enables an external toolchain (where provided by an additional layer) if set to a value other than 'default'."
11146 </info> 11423 </info>
11147 <glossdef> 11424 <glossdef>
11148 <para> 11425 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11149 Specifies the toolchain selector. 11426 Specifies the toolchain selector.
11150 <filename>TCMODE</filename> controls the characteristics 11427 <filename>TCMODE</filename> controls the characteristics
11151 of the generated packages and images by telling the 11428 of the generated packages and images by telling the
@@ -11207,12 +11484,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11207 </glossdef> 11484 </glossdef>
11208 </glossentry> 11485 </glossentry>
11209 11486
11210 <glossentry id='var-TEST_EXPORT_DIR'><glossterm>TEST_EXPORT_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 11487 <glossentry id='var-TEST_EXPORT_DIR'><glossterm>TEST_EXPORT_DIR</glossterm>
11211 <info> 11488 <info>
11212 TEST_EXPORT_DIR[doc] = "The location the OpenEmbedded build system uses to export tests when the TEST_EXPORT_ONLY variable is set to "1"." 11489 TEST_EXPORT_DIR[doc] = "The location the OpenEmbedded build system uses to export tests when the TEST_EXPORT_ONLY variable is set to "1"."
11213 </info> 11490 </info>
11214 <glossdef> 11491 <glossdef>
11215 <para> 11492 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11216 The location the OpenEmbedded build system uses to export 11493 The location the OpenEmbedded build system uses to export
11217 tests when the 11494 tests when the
11218 <link linkend='var-TEST_EXPORT_ONLY'><filename>TEST_EXPORT_ONLY</filename></link> 11495 <link linkend='var-TEST_EXPORT_ONLY'><filename>TEST_EXPORT_ONLY</filename></link>
@@ -11226,12 +11503,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11226 </glossdef> 11503 </glossdef>
11227 </glossentry> 11504 </glossentry>
11228 11505
11229 <glossentry id='var-TEST_EXPORT_ONLY'><glossterm>TEST_EXPORT_ONLY<imagedata fileref="figures/define-generic.png" /></glossterm> 11506 <glossentry id='var-TEST_EXPORT_ONLY'><glossterm>TEST_EXPORT_ONLY</glossterm>
11230 <info> 11507 <info>
11231 TEST_EXPORT_ONLY[doc] = "Specifies to export the tests only. Set this variable to "1" if you do not want to run the tests but you want them to be exported in a manner that you to run them outside of the build system." 11508 TEST_EXPORT_ONLY[doc] = "Specifies to export the tests only. Set this variable to "1" if you do not want to run the tests but you want them to be exported in a manner that you to run them outside of the build system."
11232 </info> 11509 </info>
11233 <glossdef> 11510 <glossdef>
11234 <para> 11511 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11235 Specifies to export the tests only. 11512 Specifies to export the tests only.
11236 Set this variable to "1" if you do not want to run the 11513 Set this variable to "1" if you do not want to run the
11237 tests but you want them to be exported in a manner that 11514 tests but you want them to be exported in a manner that
@@ -11240,12 +11517,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11240 </glossdef> 11517 </glossdef>
11241 </glossentry> 11518 </glossentry>
11242 11519
11243 <glossentry id='var-TEST_IMAGE'><glossterm>TEST_IMAGE<imagedata fileref="figures/define-generic.png" /></glossterm> 11520 <glossentry id='var-TEST_IMAGE'><glossterm>TEST_IMAGE</glossterm>
11244 <info> 11521 <info>
11245 TEST_IMAGE[doc] = "Enables test booting of virtual machine images under the QEMU emulator after any root filesystems are created and runs tests against those images." 11522 TEST_IMAGE[doc] = "Enables test booting of virtual machine images under the QEMU emulator after any root filesystems are created and runs tests against those images."
11246 </info> 11523 </info>
11247 <glossdef> 11524 <glossdef>
11248 <para> 11525 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11249 Automatically runs the series of automated tests for 11526 Automatically runs the series of automated tests for
11250 images when an image is successfully built. 11527 images when an image is successfully built.
11251 </para> 11528 </para>
@@ -11273,12 +11550,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11273 </glossdef> 11550 </glossdef>
11274 </glossentry> 11551 </glossentry>
11275 11552
11276 <glossentry id='var-TEST_LOG_DIR'><glossterm>TEST_LOG_DIR<imagedata fileref="figures/define-generic.png" /></glossterm> 11553 <glossentry id='var-TEST_LOG_DIR'><glossterm>TEST_LOG_DIR</glossterm>
11277 <info> 11554 <info>
11278 TEST_LOG_DIR[doc] = "Holds the SSH log and the boot log for QEMU machines. The <filename>TEST_LOG_DIR</filename> variable defaults to "${WORKDIR}/testimage"." 11555 TEST_LOG_DIR[doc] = "Holds the SSH log and the boot log for QEMU machines. The <filename>TEST_LOG_DIR</filename> variable defaults to "${WORKDIR}/testimage"."
11279 </info> 11556 </info>
11280 <glossdef> 11557 <glossdef>
11281 <para> 11558 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11282 Holds the SSH log and the boot log for QEMU machines. 11559 Holds the SSH log and the boot log for QEMU machines.
11283 The <filename>TEST_LOG_DIR</filename> variable defaults 11560 The <filename>TEST_LOG_DIR</filename> variable defaults
11284 to <filename>"${WORKDIR}/testimage"</filename>. 11561 to <filename>"${WORKDIR}/testimage"</filename>.
@@ -11291,12 +11568,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11291 </glossdef> 11568 </glossdef>
11292 </glossentry> 11569 </glossentry>
11293 11570
11294 <glossentry id='var-TEST_POWERCONTROL_CMD'><glossterm>TEST_POWERCONTROL_CMD<imagedata fileref="figures/define-generic.png" /></glossterm> 11571 <glossentry id='var-TEST_POWERCONTROL_CMD'><glossterm>TEST_POWERCONTROL_CMD</glossterm>
11295 <info> 11572 <info>
11296 TEST_POWERCONTROL_CMD[doc] = "For automated hardware testing, specifies the command to use to control the power of the target machine under test" 11573 TEST_POWERCONTROL_CMD[doc] = "For automated hardware testing, specifies the command to use to control the power of the target machine under test"
11297 </info> 11574 </info>
11298 <glossdef> 11575 <glossdef>
11299 <para> 11576 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11300 For automated hardware testing, specifies the command to 11577 For automated hardware testing, specifies the command to
11301 use to control the power of the target machine under test. 11578 use to control the power of the target machine under test.
11302 Typically, this command would point to a script that 11579 Typically, this command would point to a script that
@@ -11310,12 +11587,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11310 </glossdef> 11587 </glossdef>
11311 </glossentry> 11588 </glossentry>
11312 11589
11313 <glossentry id='var-TEST_POWERCONTROL_EXTRA_ARGS'><glossterm>TEST_POWERCONTROL_EXTRA_ARGS<imagedata fileref="figures/define-generic.png" /></glossterm> 11590 <glossentry id='var-TEST_POWERCONTROL_EXTRA_ARGS'><glossterm>TEST_POWERCONTROL_EXTRA_ARGS</glossterm>
11314 <info> 11591 <info>
11315 TEST_POWERCONTROL_EXTRA_ARGS[doc] = "For automated hardware testing, specifies additional arguments to pass through to the command specified in TEST_POWERCONTROL_CMD" 11592 TEST_POWERCONTROL_EXTRA_ARGS[doc] = "For automated hardware testing, specifies additional arguments to pass through to the command specified in TEST_POWERCONTROL_CMD"
11316 </info> 11593 </info>
11317 <glossdef> 11594 <glossdef>
11318 <para> 11595 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11319 For automated hardware testing, specifies additional 11596 For automated hardware testing, specifies additional
11320 arguments to pass through to the command specified in 11597 arguments to pass through to the command specified in
11321 <link linkend='var-TEST_POWERCONTROL_CMD'><filename>TEST_POWERCONTROL_CMD</filename></link>. 11598 <link linkend='var-TEST_POWERCONTROL_CMD'><filename>TEST_POWERCONTROL_CMD</filename></link>.
@@ -11328,12 +11605,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11328 </glossdef> 11605 </glossdef>
11329 </glossentry> 11606 </glossentry>
11330 11607
11331 <glossentry id='var-TEST_QEMUBOOT_TIMEOUT'><glossterm>TEST_QEMUBOOT_TIMEOUT<imagedata fileref="figures/define-generic.png" /></glossterm> 11608 <glossentry id='var-TEST_QEMUBOOT_TIMEOUT'><glossterm>TEST_QEMUBOOT_TIMEOUT</glossterm>
11332 <info> 11609 <info>
11333 TEST_QEMUBOOT_TIMEOUT[doc] = "The time in seconds allowed for an image to boot before automated runtime tests begin to run against an image." 11610 TEST_QEMUBOOT_TIMEOUT[doc] = "The time in seconds allowed for an image to boot before automated runtime tests begin to run against an image."
11334 </info> 11611 </info>
11335 <glossdef> 11612 <glossdef>
11336 <para> 11613 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11337 The time in seconds allowed for an image to boot before 11614 The time in seconds allowed for an image to boot before
11338 automated runtime tests begin to run against an 11615 automated runtime tests begin to run against an
11339 image. 11616 image.
@@ -11351,12 +11628,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11351 </glossdef> 11628 </glossdef>
11352 </glossentry> 11629 </glossentry>
11353 11630
11354 <glossentry id='var-TEST_SERIALCONTROL_CMD'><glossterm>TEST_SERIALCONTROL_CMD<imagedata fileref="figures/define-generic.png" /></glossterm> 11631 <glossentry id='var-TEST_SERIALCONTROL_CMD'><glossterm>TEST_SERIALCONTROL_CMD</glossterm>
11355 <info> 11632 <info>
11356 TEST_SERIALCONTROL_CMD[doc] = "For automated hardware testing, specifies the command to use to connect to the serial console of the target machine under test." 11633 TEST_SERIALCONTROL_CMD[doc] = "For automated hardware testing, specifies the command to use to connect to the serial console of the target machine under test."
11357 </info> 11634 </info>
11358 <glossdef> 11635 <glossdef>
11359 <para> 11636 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11360 For automated hardware testing, specifies the command 11637 For automated hardware testing, specifies the command
11361 to use to connect to the serial console of the target 11638 to use to connect to the serial console of the target
11362 machine under test. 11639 machine under test.
@@ -11376,12 +11653,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11376 </glossdef> 11653 </glossdef>
11377 </glossentry> 11654 </glossentry>
11378 11655
11379 <glossentry id='var-TEST_SERIALCONTROL_EXTRA_ARGS'><glossterm>TEST_SERIALCONTROL_EXTRA_ARGS<imagedata fileref="figures/define-generic.png" /></glossterm> 11656 <glossentry id='var-TEST_SERIALCONTROL_EXTRA_ARGS'><glossterm>TEST_SERIALCONTROL_EXTRA_ARGS</glossterm>
11380 <info> 11657 <info>
11381 TEST_SERIALCONTROL_EXTRA_ARGS[doc] = "For automated hardware testing, specifies additional arguments to pass through to the command specified in TEST_SERIALCONTROL_CMD." 11658 TEST_SERIALCONTROL_EXTRA_ARGS[doc] = "For automated hardware testing, specifies additional arguments to pass through to the command specified in TEST_SERIALCONTROL_CMD."
11382 </info> 11659 </info>
11383 <glossdef> 11660 <glossdef>
11384 <para> 11661 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11385 For automated hardware testing, specifies additional 11662 For automated hardware testing, specifies additional
11386 arguments to pass through to the command specified in 11663 arguments to pass through to the command specified in
11387 <link linkend='var-TEST_SERIALCONTROL_CMD'><filename>TEST_SERIALCONTROL_CMD</filename></link>. 11664 <link linkend='var-TEST_SERIALCONTROL_CMD'><filename>TEST_SERIALCONTROL_CMD</filename></link>.
@@ -11394,12 +11671,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11394 </glossdef> 11671 </glossdef>
11395 </glossentry> 11672 </glossentry>
11396 11673
11397 <glossentry id='var-TEST_SERVER_IP'><glossterm>TEST_SERVER_IP<imagedata fileref="figures/define-generic.png" /></glossterm> 11674 <glossentry id='var-TEST_SERVER_IP'><glossterm>TEST_SERVER_IP</glossterm>
11398 <info> 11675 <info>
11399 TEST_SERVER_IP[doc] = "The IP address of the build machine (host machine). This IP address is usually automatically detected." 11676 TEST_SERVER_IP[doc] = "The IP address of the build machine (host machine). This IP address is usually automatically detected."
11400 </info> 11677 </info>
11401 <glossdef> 11678 <glossdef>
11402 <para> 11679 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11403 The IP address of the build machine (host machine). 11680 The IP address of the build machine (host machine).
11404 This IP address is usually automatically detected. 11681 This IP address is usually automatically detected.
11405 However, if detection fails, this variable needs to be set 11682 However, if detection fails, this variable needs to be set
@@ -11415,18 +11692,21 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11415 </glossdef> 11692 </glossdef>
11416 </glossentry> 11693 </glossentry>
11417 11694
11418 <glossentry id='var-TEST_TARGET'><glossterm>TEST_TARGET<imagedata fileref="figures/define-generic.png" /></glossterm> 11695 <glossentry id='var-TEST_TARGET'><glossterm>TEST_TARGET</glossterm>
11419 <info> 11696 <info>
11420 TEST_TARGET[doc] = "For automated runtime testing, specifies the method of deploying the image and running tests on the target machine." 11697 TEST_TARGET[doc] = "For automated runtime testing, specifies the method of deploying the image and running tests on the target machine."
11421 </info> 11698 </info>
11422 <glossdef> 11699 <glossdef>
11423 <para> 11700 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11424 Specifies the target controller to use when running tests 11701 Specifies the target controller to use when running tests
11425 against a test image. 11702 against a test image.
11426 The default controller to use is "qemu": 11703 The default controller to use is "qemu":
11427 <literallayout class='monospaced'> 11704 <literallayout class='monospaced'>
11428 TEST_TARGET = "qemu" 11705 TEST_TARGET = "qemu"
11429 </literallayout> 11706 </literallayout>
11707 </para>
11708
11709 <para>
11430 A target controller is a class that defines how an 11710 A target controller is a class that defines how an
11431 image gets deployed on a target and how a target is started. 11711 image gets deployed on a target and how a target is started.
11432 A layer can extend the controllers by adding a module 11712 A layer can extend the controllers by adding a module
@@ -11483,12 +11763,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11483 </glossdef> 11763 </glossdef>
11484 </glossentry> 11764 </glossentry>
11485 11765
11486 <glossentry id='var-TEST_TARGET_IP'><glossterm>TEST_TARGET_IP<imagedata fileref="figures/define-generic.png" /></glossterm> 11766 <glossentry id='var-TEST_TARGET_IP'><glossterm>TEST_TARGET_IP</glossterm>
11487 <info> 11767 <info>
11488 TEST_TARGET_IP[doc] = "The IP address of your hardware under test." 11768 TEST_TARGET_IP[doc] = "The IP address of your hardware under test."
11489 </info> 11769 </info>
11490 <glossdef> 11770 <glossdef>
11491 <para> 11771 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11492 The IP address of your hardware under test. 11772 The IP address of your hardware under test.
11493 The <filename>TEST_TARGET_IP</filename> variable has no 11773 The <filename>TEST_TARGET_IP</filename> variable has no
11494 effect when 11774 effect when
@@ -11512,12 +11792,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11512 </glossdef> 11792 </glossdef>
11513 </glossentry> 11793 </glossentry>
11514 11794
11515 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES<imagedata fileref="figures/define-generic.png" /></glossterm> 11795 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES</glossterm>
11516 <info> 11796 <info>
11517 TEST_SUITES[doc] = "An ordered list of tests (modules) to run against an image when performing automated runtime testing." 11797 TEST_SUITES[doc] = "An ordered list of tests (modules) to run against an image when performing automated runtime testing."
11518 </info> 11798 </info>
11519 <glossdef> 11799 <glossdef>
11520 <para> 11800 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11521 An ordered list of tests (modules) to run against 11801 An ordered list of tests (modules) to run against
11522 an image when performing automated runtime testing. 11802 an image when performing automated runtime testing.
11523 </para> 11803 </para>
@@ -11570,12 +11850,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11570 </glossdef> 11850 </glossdef>
11571 </glossentry> 11851 </glossentry>
11572 11852
11573 <glossentry id='var-THISDIR'><glossterm>THISDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 11853 <glossentry id='var-THISDIR'><glossterm>THISDIR</glossterm>
11574 <info> 11854 <info>
11575 THISDIR[doc] = "The directory in which the file BitBake is currently parsing is located." 11855 THISDIR[doc] = "The directory in which the file BitBake is currently parsing is located."
11576 </info> 11856 </info>
11577 <glossdef> 11857 <glossdef>
11578 <para> 11858 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11579 The directory in which the file BitBake is currently 11859 The directory in which the file BitBake is currently
11580 parsing is located. 11860 parsing is located.
11581 Do not manually set this variable. 11861 Do not manually set this variable.
@@ -11583,12 +11863,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11583 </glossdef> 11863 </glossdef>
11584 </glossentry> 11864 </glossentry>
11585 11865
11586 <glossentry id='var-TIME'><glossterm>TIME<imagedata fileref="figures/define-generic.png" /></glossterm> 11866 <glossentry id='var-TIME'><glossterm>TIME</glossterm>
11587 <info> 11867 <info>
11588 TIME[doc] = "The time the build was started using HMS format." 11868 TIME[doc] = "The time the build was started using HMS format."
11589 </info> 11869 </info>
11590 <glossdef> 11870 <glossdef>
11591 <para> 11871 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11592 The time the build was started. 11872 The time the build was started.
11593 Times appear using the hour, minute, and second (HMS) 11873 Times appear using the hour, minute, and second (HMS)
11594 format (e.g. "140159" for one minute and fifty-nine 11874 format (e.g. "140159" for one minute and fifty-nine
@@ -11597,12 +11877,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11597 </glossdef> 11877 </glossdef>
11598 </glossentry> 11878 </glossentry>
11599 11879
11600 <glossentry id='var-TMPDIR'><glossterm>TMPDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 11880 <glossentry id='var-TMPDIR'><glossterm>TMPDIR</glossterm>
11601 <info> 11881 <info>
11602 TMPDIR[doc] = "The temporary directory the OpenEmbedded build system uses when it does its work building images. By default, the TMPDIR variable is named tmp within the Build Directory." 11882 TMPDIR[doc] = "The temporary directory the OpenEmbedded build system uses when it does its work building images. By default, the TMPDIR variable is named tmp within the Build Directory."
11603 </info> 11883 </info>
11604 <glossdef> 11884 <glossdef>
11605 <para> 11885 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11606 This variable is the base directory the OpenEmbedded 11886 This variable is the base directory the OpenEmbedded
11607 build system uses for all build output and intermediate 11887 build system uses for all build output and intermediate
11608 files (other than the shared state cache). 11888 files (other than the shared state cache).
@@ -11638,12 +11918,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11638 </glossdef> 11918 </glossdef>
11639 </glossentry> 11919 </glossentry>
11640 11920
11641 <glossentry id='var-TOOLCHAIN_HOST_TASK'><glossterm>TOOLCHAIN_HOST_TASK<imagedata fileref="figures/define-generic.png" /></glossterm> 11921 <glossentry id='var-TOOLCHAIN_HOST_TASK'><glossterm>TOOLCHAIN_HOST_TASK</glossterm>
11642 <info> 11922 <info>
11643 TOOLCHAIN_HOST_TASK[doc] = "This variable lists packages the OpenEmbedded build system uses when building an SDK, which contains a cross-development environment." 11923 TOOLCHAIN_HOST_TASK[doc] = "This variable lists packages the OpenEmbedded build system uses when building an SDK, which contains a cross-development environment."
11644 </info> 11924 </info>
11645 <glossdef> 11925 <glossdef>
11646 <para> 11926 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11647 This variable lists packages the OpenEmbedded build system 11927 This variable lists packages the OpenEmbedded build system
11648 uses when building an SDK, which contains a 11928 uses when building an SDK, which contains a
11649 cross-development environment. 11929 cross-development environment.
@@ -11671,12 +11951,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11671 </glossdef> 11951 </glossdef>
11672 </glossentry> 11952 </glossentry>
11673 11953
11674 <glossentry id='var-TOOLCHAIN_TARGET_TASK'><glossterm>TOOLCHAIN_TARGET_TASK<imagedata fileref="figures/define-generic.png" /></glossterm> 11954 <glossentry id='var-TOOLCHAIN_TARGET_TASK'><glossterm>TOOLCHAIN_TARGET_TASK</glossterm>
11675 <info> 11955 <info>
11676 TOOLCHAIN_TARGET_TASK[doc] = "This variable lists packages the OpenEmbedded build system uses when it creates the target part of an SDK, which includes libraries and headers." 11956 TOOLCHAIN_TARGET_TASK[doc] = "This variable lists packages the OpenEmbedded build system uses when it creates the target part of an SDK, which includes libraries and headers."
11677 </info> 11957 </info>
11678 <glossdef> 11958 <glossdef>
11679 <para> 11959 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11680 This variable lists packages the OpenEmbedded build system 11960 This variable lists packages the OpenEmbedded build system
11681 uses when it creates the target part of an SDK 11961 uses when it creates the target part of an SDK
11682 (i.e. the part built for the target hardware), which 11962 (i.e. the part built for the target hardware), which
@@ -11696,12 +11976,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11696 </glossdef> 11976 </glossdef>
11697 </glossentry> 11977 </glossentry>
11698 11978
11699 <glossentry id='var-TOPDIR'><glossterm>TOPDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 11979 <glossentry id='var-TOPDIR'><glossterm>TOPDIR</glossterm>
11700 <info> 11980 <info>
11701 TOPDIR[doc] = "The Build Directory. BitBake automatically sets this variable. The OpenEmbedded build system uses the Build Directory when building images." 11981 TOPDIR[doc] = "The Build Directory. BitBake automatically sets this variable. The OpenEmbedded build system uses the Build Directory when building images."
11702 </info> 11982 </info>
11703 <glossdef> 11983 <glossdef>
11704 <para> 11984 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11705 The top-level 11985 The top-level
11706 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. 11986 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
11707 BitBake automatically sets this variable when you 11987 BitBake automatically sets this variable when you
@@ -11713,12 +11993,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11713 </glossdef> 11993 </glossdef>
11714 </glossentry> 11994 </glossentry>
11715 11995
11716 <glossentry id='var-TRANSLATED_TARGET_ARCH'><glossterm>TRANSLATED_TARGET_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 11996 <glossentry id='var-TRANSLATED_TARGET_ARCH'><glossterm>TRANSLATED_TARGET_ARCH</glossterm>
11717 <info> 11997 <info>
11718 TRANSLATED_TARGET_ARCH[doc] = "A sanitized version of TARGET_ARCH. This variable is used where the architecture is needed in a value where underscores are not allowed." 11998 TRANSLATED_TARGET_ARCH[doc] = "A sanitized version of TARGET_ARCH. This variable is used where the architecture is needed in a value where underscores are not allowed."
11719 </info> 11999 </info>
11720 <glossdef> 12000 <glossdef>
11721 <para> 12001 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11722 A sanitized version of 12002 A sanitized version of
11723 <link linkend='var-TARGET_ARCH'><filename>TARGET_ARCH</filename></link>. 12003 <link linkend='var-TARGET_ARCH'><filename>TARGET_ARCH</filename></link>.
11724 This variable is used where the architecture is needed in 12004 This variable is used where the architecture is needed in
@@ -11734,12 +12014,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11734 </glossdef> 12014 </glossdef>
11735 </glossentry> 12015 </glossentry>
11736 12016
11737 <glossentry id='var-TUNE_ARCH'><glossterm>TUNE_ARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 12017 <glossentry id='var-TUNE_ARCH'><glossterm>TUNE_ARCH</glossterm>
11738 <info> 12018 <info>
11739 TUNE_ARCH[doc] = "The GNU canonical architecture for a specific architecture (i.e. arm, armeb, mips, mips64, and so forth)." 12019 TUNE_ARCH[doc] = "The GNU canonical architecture for a specific architecture (i.e. arm, armeb, mips, mips64, and so forth)."
11740 </info> 12020 </info>
11741 <glossdef> 12021 <glossdef>
11742 <para> 12022 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11743 The GNU canonical architecture for a specific architecture 12023 The GNU canonical architecture for a specific architecture
11744 (i.e. <filename>arm</filename>, 12024 (i.e. <filename>arm</filename>,
11745 <filename>armeb</filename>, 12025 <filename>armeb</filename>,
@@ -11792,12 +12072,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11792 </glossdef> 12072 </glossdef>
11793 </glossentry> 12073 </glossentry>
11794 12074
11795 <glossentry id='var-TUNE_ASARGS'><glossterm>TUNE_ASARGS<imagedata fileref="figures/define-generic.png" /></glossterm> 12075 <glossentry id='var-TUNE_ASARGS'><glossterm>TUNE_ASARGS</glossterm>
11796 <info> 12076 <info>
11797 TUNE_ASARGS[doc] = "Specifies architecture-specific assembler flags for the target system." 12077 TUNE_ASARGS[doc] = "Specifies architecture-specific assembler flags for the target system."
11798 </info> 12078 </info>
11799 <glossdef> 12079 <glossdef>
11800 <para> 12080 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11801 Specifies architecture-specific assembler flags for 12081 Specifies architecture-specific assembler flags for
11802 the target system. 12082 the target system.
11803 The set of flags is based on the selected tune features. 12083 The set of flags is based on the selected tune features.
@@ -11822,12 +12102,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11822 </glossdef> 12102 </glossdef>
11823 </glossentry> 12103 </glossentry>
11824 12104
11825 <glossentry id='var-TUNE_CCARGS'><glossterm>TUNE_CCARGS<imagedata fileref="figures/define-generic.png" /></glossterm> 12105 <glossentry id='var-TUNE_CCARGS'><glossterm>TUNE_CCARGS</glossterm>
11826 <info> 12106 <info>
11827 TUNE_CCARGS[doc] = "Specifies architecture-specific C compiler flags for the target system." 12107 TUNE_CCARGS[doc] = "Specifies architecture-specific C compiler flags for the target system."
11828 </info> 12108 </info>
11829 <glossdef> 12109 <glossdef>
11830 <para> 12110 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11831 Specifies architecture-specific C compiler flags for 12111 Specifies architecture-specific C compiler flags for
11832 the target system. 12112 the target system.
11833 The set of flags is based on the selected tune features. 12113 The set of flags is based on the selected tune features.
@@ -11846,12 +12126,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11846 </glossdef> 12126 </glossdef>
11847 </glossentry> 12127 </glossentry>
11848 12128
11849 <glossentry id='var-TUNE_LDARGS'><glossterm>TUNE_LDARGS<imagedata fileref="figures/define-generic.png" /></glossterm> 12129 <glossentry id='var-TUNE_LDARGS'><glossterm>TUNE_LDARGS</glossterm>
11850 <info> 12130 <info>
11851 TUNE_LDARGS[doc] = "Specifies architecture-specific linker flags for the target system." 12131 TUNE_LDARGS[doc] = "Specifies architecture-specific linker flags for the target system."
11852 </info> 12132 </info>
11853 <glossdef> 12133 <glossdef>
11854 <para> 12134 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11855 Specifies architecture-specific linker flags for 12135 Specifies architecture-specific linker flags for
11856 the target system. 12136 the target system.
11857 The set of flags is based on the selected tune features. 12137 The set of flags is based on the selected tune features.
@@ -11876,12 +12156,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11876 </glossdef> 12156 </glossdef>
11877 </glossentry> 12157 </glossentry>
11878 12158
11879 <glossentry id='var-TUNE_FEATURES'><glossterm>TUNE_FEATURES<imagedata fileref="figures/define-generic.png" /></glossterm> 12159 <glossentry id='var-TUNE_FEATURES'><glossterm>TUNE_FEATURES</glossterm>
11880 <info> 12160 <info>
11881 TUNE_FEATURES[doc] = "Features used to "tune" a compiler for optimal use given a specific processor." 12161 TUNE_FEATURES[doc] = "Features used to "tune" a compiler for optimal use given a specific processor."
11882 </info> 12162 </info>
11883 <glossdef> 12163 <glossdef>
11884 <para> 12164 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11885 Features used to "tune" a compiler for optimal use 12165 Features used to "tune" a compiler for optimal use
11886 given a specific processor. 12166 given a specific processor.
11887 The features are defined within the tune files and allow 12167 The features are defined within the tune files and allow
@@ -11909,12 +12189,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11909 </glossdef> 12189 </glossdef>
11910 </glossentry> 12190 </glossentry>
11911 12191
11912 <glossentry id='var-TUNE_PKGARCH'><glossterm>TUNE_PKGARCH<imagedata fileref="figures/define-generic.png" /></glossterm> 12192 <glossentry id='var-TUNE_PKGARCH'><glossterm>TUNE_PKGARCH</glossterm>
11913 <info> 12193 <info>
11914 TUNE_PKGARCH[doc] = "The package architecture understood by the packaging system to define the architecture, ABI, and tuning of output packages." 12194 TUNE_PKGARCH[doc] = "The package architecture understood by the packaging system to define the architecture, ABI, and tuning of output packages."
11915 </info> 12195 </info>
11916 <glossdef> 12196 <glossdef>
11917 <para> 12197 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11918 The package architecture understood by the packaging 12198 The package architecture understood by the packaging
11919 system to define the architecture, ABI, and tuning of 12199 system to define the architecture, ABI, and tuning of
11920 output packages. 12200 output packages.
@@ -11939,12 +12219,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11939 </glossdef> 12219 </glossdef>
11940 </glossentry> 12220 </glossentry>
11941 12221
11942 <glossentry id='var-TUNEABI'><glossterm>TUNEABI<imagedata fileref="figures/define-generic.png" /></glossterm> 12222 <glossentry id='var-TUNEABI'><glossterm>TUNEABI</glossterm>
11943 <info> 12223 <info>
11944 TUNEABI[doc] = "An underlying ABI used by a particular tuning in a given toolchain layer. This feature allows providers using prebuilt libraries to check compatibility of a tuning against their selection of libraries." 12224 TUNEABI[doc] = "An underlying ABI used by a particular tuning in a given toolchain layer. This feature allows providers using prebuilt libraries to check compatibility of a tuning against their selection of libraries."
11945 </info> 12225 </info>
11946 <glossdef> 12226 <glossdef>
11947 <para> 12227 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11948 An underlying Application Binary Interface (ABI) used by 12228 An underlying Application Binary Interface (ABI) used by
11949 a particular tuning in a given toolchain layer. 12229 a particular tuning in a given toolchain layer.
11950 Providers that use prebuilt libraries can use the 12230 Providers that use prebuilt libraries can use the
@@ -11966,12 +12246,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11966 </glossdef> 12246 </glossdef>
11967 </glossentry> 12247 </glossentry>
11968 12248
11969 <glossentry id='var-TUNEABI_OVERRIDE'><glossterm>TUNEABI_OVERRIDE<imagedata fileref="figures/define-generic.png" /></glossterm> 12249 <glossentry id='var-TUNEABI_OVERRIDE'><glossterm>TUNEABI_OVERRIDE</glossterm>
11970 <info> 12250 <info>
11971 TUNEABI_OVERRIDE[doc] = "If set, ignores TUNEABI_WHITELIST." 12251 TUNEABI_OVERRIDE[doc] = "If set, ignores TUNEABI_WHITELIST."
11972 </info> 12252 </info>
11973 <glossdef> 12253 <glossdef>
11974 <para> 12254 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
11975 If set, the OpenEmbedded system ignores the 12255 If set, the OpenEmbedded system ignores the
11976 <link linkend='var-TUNEABI_WHITELIST'><filename>TUNEABI_WHITELIST</filename></link> 12256 <link linkend='var-TUNEABI_WHITELIST'><filename>TUNEABI_WHITELIST</filename></link>
11977 variable. 12257 variable.
@@ -11992,12 +12272,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11992 </glossdef> 12272 </glossdef>
11993 </glossentry> 12273 </glossentry>
11994 12274
11995 <glossentry id='var-TUNEABI_WHITELIST'><glossterm>TUNEABI_WHITELIST<imagedata fileref="figures/define-generic.png" /></glossterm> 12275 <glossentry id='var-TUNEABI_WHITELIST'><glossterm>TUNEABI_WHITELIST</glossterm>
11996 <info> 12276 <info>
11997 TUNEABI_WHITELIST[doc] = "A whitelist of permissible TUNEABI values. If the variable is not set, all values are allowed." 12277 TUNEABI_WHITELIST[doc] = "A whitelist of permissible TUNEABI values. If the variable is not set, all values are allowed."
11998 </info> 12278 </info>
11999 <glossdef> 12279 <glossdef>
12000 <para> 12280 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12001 A whitelist of permissible 12281 A whitelist of permissible
12002 <link linkend='var-TUNEABI'><filename>TUNEABI</filename></link> 12282 <link linkend='var-TUNEABI'><filename>TUNEABI</filename></link>
12003 values. 12283 values.
@@ -12019,12 +12299,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12019 </glossdef> 12299 </glossdef>
12020 </glossentry> 12300 </glossentry>
12021 12301
12022 <glossentry id='var-TUNECONFLICTS'><glossterm>TUNECONFLICTS[<replaceable>feature</replaceable>]<imagedata fileref="figures/define-generic.png" /></glossterm> 12302 <glossentry id='var-TUNECONFLICTS'><glossterm>TUNECONFLICTS[<replaceable>feature</replaceable>]</glossterm>
12023 <info> 12303 <info>
12024 TUNECONFLICTS[doc] = "Specifies CPU or Application Binary Interface (ABI) tuning features that conflict with specified feature." 12304 TUNECONFLICTS[doc] = "Specifies CPU or Application Binary Interface (ABI) tuning features that conflict with specified feature."
12025 </info> 12305 </info>
12026 <glossdef> 12306 <glossdef>
12027 <para> 12307 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12028 Specifies CPU or Application Binary Interface (ABI) 12308 Specifies CPU or Application Binary Interface (ABI)
12029 tuning features that conflict with <replaceable>feature</replaceable>. 12309 tuning features that conflict with <replaceable>feature</replaceable>.
12030 </para> 12310 </para>
@@ -12044,12 +12324,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12044 </glossdef> 12324 </glossdef>
12045 </glossentry> 12325 </glossentry>
12046 12326
12047 <glossentry id='var-TUNEVALID'><glossterm>TUNEVALID[<replaceable>feature</replaceable>]<imagedata fileref="figures/define-generic.png" /></glossterm> 12327 <glossentry id='var-TUNEVALID'><glossterm>TUNEVALID[<replaceable>feature</replaceable>]</glossterm>
12048 <info> 12328 <info>
12049 TUNEVALID[doc] = "Descriptions, stored as flags, of valid tuning features." 12329 TUNEVALID[doc] = "Descriptions, stored as flags, of valid tuning features."
12050 </info> 12330 </info>
12051 <glossdef> 12331 <glossdef>
12052 <para> 12332 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12053 Specifies a valid CPU or Application Binary Interface (ABI) 12333 Specifies a valid CPU or Application Binary Interface (ABI)
12054 tuning feature. 12334 tuning feature.
12055 The specified feature is stored as a flag. 12335 The specified feature is stored as a flag.
@@ -12059,6 +12339,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12059 <literallayout class='monospaced'> 12339 <literallayout class='monospaced'>
12060 TUNEVALID[bigendian] = "Enable big-endian mode." 12340 TUNEVALID[bigendian] = "Enable big-endian mode."
12061 </literallayout> 12341 </literallayout>
12342 </para>
12343
12344 <para>
12062 See the machine include files in the 12345 See the machine include files in the
12063 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> 12346 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
12064 for these features. 12347 for these features.
@@ -12070,12 +12353,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12070 12353
12071 <glossdiv id='var-glossary-u'><title>U</title> 12354 <glossdiv id='var-glossary-u'><title>U</title>
12072 12355
12073 <glossentry id='var-UBOOT_CONFIG'><glossterm>UBOOT_CONFIG<imagedata fileref="figures/define-generic.png" /></glossterm> 12356 <glossentry id='var-UBOOT_CONFIG'><glossterm>UBOOT_CONFIG</glossterm>
12074 <info> 12357 <info>
12075 UBOOT_CONFIG[doc] = "Configures the UBOOT_MACHINE and can also define IMAGE_FSTYPES for individual cases." 12358 UBOOT_CONFIG[doc] = "Configures the UBOOT_MACHINE and can also define IMAGE_FSTYPES for individual cases."
12076 </info> 12359 </info>
12077 <glossdef> 12360 <glossdef>
12078 <para> 12361 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12079 Configures the 12362 Configures the
12080 <link linkend='var-UBOOT_MACHINE'><filename>UBOOT_MACHINE</filename></link> 12363 <link linkend='var-UBOOT_MACHINE'><filename>UBOOT_MACHINE</filename></link>
12081 and can also define 12364 and can also define
@@ -12112,12 +12395,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12112 </glossdef> 12395 </glossdef>
12113 </glossentry> 12396 </glossentry>
12114 12397
12115 <glossentry id='var-UBOOT_ENTRYPOINT'><glossterm>UBOOT_ENTRYPOINT<imagedata fileref="figures/define-generic.png" /></glossterm> 12398 <glossentry id='var-UBOOT_ENTRYPOINT'><glossterm>UBOOT_ENTRYPOINT</glossterm>
12116 <info> 12399 <info>
12117 UBOOT_ENTRYPOINT[doc] = "Specifies the entry point for the U-Boot image." 12400 UBOOT_ENTRYPOINT[doc] = "Specifies the entry point for the U-Boot image."
12118 </info> 12401 </info>
12119 <glossdef> 12402 <glossdef>
12120 <para> 12403 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12121 Specifies the entry point for the U-Boot image. 12404 Specifies the entry point for the U-Boot image.
12122 During U-Boot image creation, the 12405 During U-Boot image creation, the
12123 <filename>UBOOT_ENTRYPOINT</filename> variable is passed 12406 <filename>UBOOT_ENTRYPOINT</filename> variable is passed
@@ -12127,12 +12410,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12127 </glossdef> 12410 </glossdef>
12128 </glossentry> 12411 </glossentry>
12129 12412
12130 <glossentry id='var-UBOOT_LOADADDRESS'><glossterm>UBOOT_LOADADDRESS<imagedata fileref="figures/define-generic.png" /></glossterm> 12413 <glossentry id='var-UBOOT_LOADADDRESS'><glossterm>UBOOT_LOADADDRESS</glossterm>
12131 <info> 12414 <info>
12132 UBOOT_LOADADDRESS[doc] = "Specifies the load address for the U-Boot image." 12415 UBOOT_LOADADDRESS[doc] = "Specifies the load address for the U-Boot image."
12133 </info> 12416 </info>
12134 <glossdef> 12417 <glossdef>
12135 <para> 12418 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12136 Specifies the load address for the U-Boot image. 12419 Specifies the load address for the U-Boot image.
12137 During U-Boot image creation, the 12420 During U-Boot image creation, the
12138 <filename>UBOOT_LOADADDRESS</filename> variable is passed 12421 <filename>UBOOT_LOADADDRESS</filename> variable is passed
@@ -12142,12 +12425,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12142 </glossdef> 12425 </glossdef>
12143 </glossentry> 12426 </glossentry>
12144 12427
12145 <glossentry id='var-UBOOT_LOCALVERSION'><glossterm>UBOOT_LOCALVERSION<imagedata fileref="figures/define-generic.png" /></glossterm> 12428 <glossentry id='var-UBOOT_LOCALVERSION'><glossterm>UBOOT_LOCALVERSION</glossterm>
12146 <info> 12429 <info>
12147 UBOOT_LOCALVERSION[doc] = "Appends a string to the name of the local version of the U-Boot image." 12430 UBOOT_LOCALVERSION[doc] = "Appends a string to the name of the local version of the U-Boot image."
12148 </info> 12431 </info>
12149 <glossdef> 12432 <glossdef>
12150 <para> 12433 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12151 Appends a string to the name of the local version of the 12434 Appends a string to the name of the local version of the
12152 U-Boot image. 12435 U-Boot image.
12153 For example, assuming the version of the U-Boot image 12436 For example, assuming the version of the U-Boot image
@@ -12161,12 +12444,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12161 </glossdef> 12444 </glossdef>
12162 </glossentry> 12445 </glossentry>
12163 12446
12164 <glossentry id='var-UBOOT_MACHINE'><glossterm>UBOOT_MACHINE<imagedata fileref="figures/define-generic.png" /></glossterm> 12447 <glossentry id='var-UBOOT_MACHINE'><glossterm>UBOOT_MACHINE</glossterm>
12165 <info> 12448 <info>
12166 UBOOT_MACHINE[doc] = "Specifies the value passed on the make command line when building a U-Boot image." 12449 UBOOT_MACHINE[doc] = "Specifies the value passed on the make command line when building a U-Boot image."
12167 </info> 12450 </info>
12168 <glossdef> 12451 <glossdef>
12169 <para> 12452 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12170 Specifies the value passed on the 12453 Specifies the value passed on the
12171 <filename>make</filename> command line when building 12454 <filename>make</filename> command line when building
12172 a U-Boot image. 12455 a U-Boot image.
@@ -12184,12 +12467,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12184 </glossdef> 12467 </glossdef>
12185 </glossentry> 12468 </glossentry>
12186 12469
12187 <glossentry id='var-UBOOT_MAKE_TARGET'><glossterm>UBOOT_MAKE_TARGET<imagedata fileref="figures/define-generic.png" /></glossterm> 12470 <glossentry id='var-UBOOT_MAKE_TARGET'><glossterm>UBOOT_MAKE_TARGET</glossterm>
12188 <info> 12471 <info>
12189 UBOOT_MAKE_TARGET[doc] = "Specifies the target called in the Makefile." 12472 UBOOT_MAKE_TARGET[doc] = "Specifies the target called in the Makefile."
12190 </info> 12473 </info>
12191 <glossdef> 12474 <glossdef>
12192 <para> 12475 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12193 Specifies the target called in the 12476 Specifies the target called in the
12194 <filename>Makefile</filename>. 12477 <filename>Makefile</filename>.
12195 The default target is "all". 12478 The default target is "all".
@@ -12197,12 +12480,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12197 </glossdef> 12480 </glossdef>
12198 </glossentry> 12481 </glossentry>
12199 12482
12200 <glossentry id='var-UBOOT_SUFFIX'><glossterm>UBOOT_SUFFIX<imagedata fileref="figures/define-generic.png" /></glossterm> 12483 <glossentry id='var-UBOOT_SUFFIX'><glossterm>UBOOT_SUFFIX</glossterm>
12201 <info> 12484 <info>
12202 UBOOT_SUFFIX[doc] = "Points to the generated U-Boot extension." 12485 UBOOT_SUFFIX[doc] = "Points to the generated U-Boot extension."
12203 </info> 12486 </info>
12204 <glossdef> 12487 <glossdef>
12205 <para> 12488 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12206 Points to the generated U-Boot extension. 12489 Points to the generated U-Boot extension.
12207 For example, <filename>u-boot.sb</filename> has a 12490 For example, <filename>u-boot.sb</filename> has a
12208 <filename>.sb</filename> extension. 12491 <filename>.sb</filename> extension.
@@ -12215,12 +12498,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12215 </glossdef> 12498 </glossdef>
12216 </glossentry> 12499 </glossentry>
12217 12500
12218 <glossentry id='var-UBOOT_TARGET'><glossterm>UBOOT_TARGET<imagedata fileref="figures/define-generic.png" /></glossterm> 12501 <glossentry id='var-UBOOT_TARGET'><glossterm>UBOOT_TARGET</glossterm>
12219 <info> 12502 <info>
12220 UBOOT_TARGET[doc] = "Specifies the target used for building U-Boot." 12503 UBOOT_TARGET[doc] = "Specifies the target used for building U-Boot."
12221 </info> 12504 </info>
12222 <glossdef> 12505 <glossdef>
12223 <para> 12506 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12224 Specifies the target used for building U-Boot. 12507 Specifies the target used for building U-Boot.
12225 The target is passed directly as part of the "make" command 12508 The target is passed directly as part of the "make" command
12226 (e.g. SPL and AIS). 12509 (e.g. SPL and AIS).
@@ -12231,12 +12514,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12231 </glossdef> 12514 </glossdef>
12232 </glossentry> 12515 </glossentry>
12233 12516
12234 <glossentry id='var-UPDATERCPN'><glossterm>UPDATERCPN<imagedata fileref="figures/define-generic.png" /></glossterm> 12517 <glossentry id='var-UPDATERCPN'><glossterm>UPDATERCPN</glossterm>
12235 <info> 12518 <info>
12236 UPDATERCPN[doc] = "Specifies the package that contains the initscript that is to be enabled." 12519 UPDATERCPN[doc] = "Specifies the package that contains the initscript that is to be enabled."
12237 </info> 12520 </info>
12238 <glossdef> 12521 <glossdef>
12239 <para> 12522 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12240 For recipes inheriting the 12523 For recipes inheriting the
12241 <link linkend='ref-classes-update-rc.d'><filename>update-rc.d</filename></link> 12524 <link linkend='ref-classes-update-rc.d'><filename>update-rc.d</filename></link>
12242 class, <filename>UPDATERCPN</filename> specifies 12525 class, <filename>UPDATERCPN</filename> specifies
@@ -12253,12 +12536,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12253 </glossdef> 12536 </glossdef>
12254 </glossentry> 12537 </glossentry>
12255 12538
12256 <glossentry id='var-USE_DEVFS'><glossterm>USE_DEVFS<imagedata fileref="figures/define-generic.png" /></glossterm> 12539 <glossentry id='var-USE_DEVFS'><glossterm>USE_DEVFS</glossterm>
12257 <info> 12540 <info>
12258 USE_DEVFS[doc] = "Determines if devtmpfs is used for /dev population." 12541 USE_DEVFS[doc] = "Determines if devtmpfs is used for /dev population."
12259 </info> 12542 </info>
12260 <glossdef> 12543 <glossdef>
12261 <para> 12544 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12262 Determines if <filename>devtmpfs</filename> is used for 12545 Determines if <filename>devtmpfs</filename> is used for
12263 <filename>/dev</filename> population. 12546 <filename>/dev</filename> population.
12264 The default value used for <filename>USE_DEVFS</filename> 12547 The default value used for <filename>USE_DEVFS</filename>
@@ -12277,12 +12560,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12277 </glossdef> 12560 </glossdef>
12278 </glossentry> 12561 </glossentry>
12279 12562
12280 <glossentry id='var-USE_VT'><glossterm>USE_VT<imagedata fileref="figures/define-generic.png" /></glossterm> 12563 <glossentry id='var-USE_VT'><glossterm>USE_VT</glossterm>
12281 <info> 12564 <info>
12282 USE_VT[doc] = "When using SysVinit, determines whether or not to run a getty on any virtual terminals in order to enable logging in through those terminals." 12565 USE_VT[doc] = "When using SysVinit, determines whether or not to run a getty on any virtual terminals in order to enable logging in through those terminals."
12283 </info> 12566 </info>
12284 <glossdef> 12567 <glossdef>
12285 <para> 12568 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12286 When using 12569 When using
12287 <ulink url='&YOCTO_DOCS_DEV_URL;#new-recipe-enabling-system-services'>SysVinit</ulink>, 12570 <ulink url='&YOCTO_DOCS_DEV_URL;#new-recipe-enabling-system-services'>SysVinit</ulink>,
12288 determines whether or not to run a 12571 determines whether or not to run a
@@ -12302,12 +12585,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12302 </glossdef> 12585 </glossdef>
12303 </glossentry> 12586 </glossentry>
12304 12587
12305 <glossentry id='var-USER_CLASSES'><glossterm>USER_CLASSES<imagedata fileref="figures/define-generic.png" /></glossterm> 12588 <glossentry id='var-USER_CLASSES'><glossterm>USER_CLASSES</glossterm>
12306 <info> 12589 <info>
12307 USER_CLASSES[doc] = "List of additional classes to use when building images that enable extra features." 12590 USER_CLASSES[doc] = "List of additional classes to use when building images that enable extra features."
12308 </info> 12591 </info>
12309 <glossdef> 12592 <glossdef>
12310 <para> 12593 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12311 A list of classes to globally inherit. 12594 A list of classes to globally inherit.
12312 These classes are used by the OpenEmbedded build system 12595 These classes are used by the OpenEmbedded build system
12313 to enable extra features (e.g. 12596 to enable extra features (e.g.
@@ -12329,12 +12612,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12329 </glossdef> 12612 </glossdef>
12330 </glossentry> 12613 </glossentry>
12331 12614
12332 <glossentry id='var-USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC<imagedata fileref="figures/define-generic.png" /></glossterm> 12615 <glossentry id='var-USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC</glossterm>
12333 <info> 12616 <info>
12334 USERADD_ERROR_DYNAMIC[doc] = "Forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in files/passwd and files/group files." 12617 USERADD_ERROR_DYNAMIC[doc] = "Forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in files/passwd and files/group files."
12335 </info> 12618 </info>
12336 <glossdef> 12619 <glossdef>
12337 <para> 12620 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12338 Forces the OpenEmbedded build system to produce an error 12621 Forces the OpenEmbedded build system to produce an error
12339 if the user identification (<filename>uid</filename>) and 12622 if the user identification (<filename>uid</filename>) and
12340 group identification (<filename>gid</filename>) values 12623 group identification (<filename>gid</filename>) values
@@ -12369,12 +12652,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12369 </glossdef> 12652 </glossdef>
12370 </glossentry> 12653 </glossentry>
12371 12654
12372 <glossentry id='var-USERADD_GID_TABLES'><glossterm>USERADD_GID_TABLES<imagedata fileref="figures/define-generic.png" /></glossterm> 12655 <glossentry id='var-USERADD_GID_TABLES'><glossterm>USERADD_GID_TABLES</glossterm>
12373 <info> 12656 <info>
12374 USERADD_GID_TABLES[doc] = "Specifies a password file to use for obtaining static group identification (gid) values when the OpenEmbedded build system adds a group to the system during package installation." 12657 USERADD_GID_TABLES[doc] = "Specifies a password file to use for obtaining static group identification (gid) values when the OpenEmbedded build system adds a group to the system during package installation."
12375 </info> 12658 </info>
12376 <glossdef> 12659 <glossdef>
12377 <para> 12660 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12378 Specifies a password file to use for obtaining static 12661 Specifies a password file to use for obtaining static
12379 group identification (<filename>gid</filename>) values 12662 group identification (<filename>gid</filename>) values
12380 when the OpenEmbedded build system adds a group to the 12663 when the OpenEmbedded build system adds a group to the
@@ -12404,12 +12687,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12404 </glossdef> 12687 </glossdef>
12405 </glossentry> 12688 </glossentry>
12406 12689
12407 <glossentry id='var-USERADD_PACKAGES'><glossterm>USERADD_PACKAGES<imagedata fileref="figures/define-generic.png" /></glossterm> 12690 <glossentry id='var-USERADD_PACKAGES'><glossterm>USERADD_PACKAGES</glossterm>
12408 <info> 12691 <info>
12409 USERADD_PACKAGES[doc] = "When a recipe inherits the useradd class, this variable specifies the individual packages within the recipe that require users and/or groups to be added." 12692 USERADD_PACKAGES[doc] = "When a recipe inherits the useradd class, this variable specifies the individual packages within the recipe that require users and/or groups to be added."
12410 </info> 12693 </info>
12411 <glossdef> 12694 <glossdef>
12412 <para> 12695 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12413 When inheriting the 12696 When inheriting the
12414 <link linkend='ref-classes-useradd'><filename>useradd</filename></link> 12697 <link linkend='ref-classes-useradd'><filename>useradd</filename></link>
12415 class, this variable 12698 class, this variable
@@ -12440,12 +12723,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12440 </glossdef> 12723 </glossdef>
12441 </glossentry> 12724 </glossentry>
12442 12725
12443 <glossentry id='var-USERADD_PARAM'><glossterm>USERADD_PARAM<imagedata fileref="figures/define-generic.png" /></glossterm> 12726 <glossentry id='var-USERADD_PARAM'><glossterm>USERADD_PARAM</glossterm>
12444 <info> 12727 <info>
12445 USERADD_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the useradd command if you wish to add a user to the system when the package is installed." 12728 USERADD_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the useradd command if you wish to add a user to the system when the package is installed."
12446 </info> 12729 </info>
12447 <glossdef> 12730 <glossdef>
12448 <para> 12731 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12449 When inheriting the 12732 When inheriting the
12450 <link linkend='ref-classes-useradd'><filename>useradd</filename></link> 12733 <link linkend='ref-classes-useradd'><filename>useradd</filename></link>
12451 class, this variable 12734 class, this variable
@@ -12470,12 +12753,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12470 </glossdef> 12753 </glossdef>
12471 </glossentry> 12754 </glossentry>
12472 12755
12473 <glossentry id='var-USERADD_UID_TABLES'><glossterm>USERADD_UID_TABLES<imagedata fileref="figures/define-generic.png" /></glossterm> 12756 <glossentry id='var-USERADD_UID_TABLES'><glossterm>USERADD_UID_TABLES</glossterm>
12474 <info> 12757 <info>
12475 USERADD_UID_TABLES[doc] = "Specifies a password file to use for obtaining static user identification (uid) values when the OpenEmbedded build system adds a user to the system during package installation." 12758 USERADD_UID_TABLES[doc] = "Specifies a password file to use for obtaining static user identification (uid) values when the OpenEmbedded build system adds a user to the system during package installation."
12476 </info> 12759 </info>
12477 <glossdef> 12760 <glossdef>
12478 <para> 12761 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12479 Specifies a password file to use for obtaining static 12762 Specifies a password file to use for obtaining static
12480 user identification (<filename>uid</filename>) values 12763 user identification (<filename>uid</filename>) values
12481 when the OpenEmbedded build system adds a user to the 12764 when the OpenEmbedded build system adds a user to the
@@ -12505,12 +12788,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12505 </glossdef> 12788 </glossdef>
12506 </glossentry> 12789 </glossentry>
12507 12790
12508 <glossentry id='var-USERADDEXTENSION'><glossterm>USERADDEXTENSION<imagedata fileref="figures/define-generic.png" /></glossterm> 12791 <glossentry id='var-USERADDEXTENSION'><glossterm>USERADDEXTENSION</glossterm>
12509 <info> 12792 <info>
12510 USERADDEXTENSION[doc] = "When set to "useradd-staticids", causes the OpenEmbedded build system to base all user and group additions on a static passwd and group files found in BBPATH." 12793 USERADDEXTENSION[doc] = "When set to "useradd-staticids", causes the OpenEmbedded build system to base all user and group additions on a static passwd and group files found in BBPATH."
12511 </info> 12794 </info>
12512 <glossdef> 12795 <glossdef>
12513 <para> 12796 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12514 When set to "useradd-staticids", causes the 12797 When set to "useradd-staticids", causes the
12515 OpenEmbedded build system to base all user and group 12798 OpenEmbedded build system to base all user and group
12516 additions on a static 12799 additions on a static
@@ -12560,12 +12843,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12560 12843
12561 <glossdiv id='var-glossary-w'><title>W</title> 12844 <glossdiv id='var-glossary-w'><title>W</title>
12562 12845
12563 <glossentry id='var-WARN_QA'><glossterm>WARN_QA<imagedata fileref="figures/define-generic.png" /></glossterm> 12846 <glossentry id='var-WARN_QA'><glossterm>WARN_QA</glossterm>
12564 <info> 12847 <info>
12565 WARN_QA[doc] = "Specifies the quality assurance checks whose failures are reported as warnings by the OpenEmbedded build system." 12848 WARN_QA[doc] = "Specifies the quality assurance checks whose failures are reported as warnings by the OpenEmbedded build system."
12566 </info> 12849 </info>
12567 <glossdef> 12850 <glossdef>
12568 <para> 12851 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12569 Specifies the quality assurance checks whose failures are 12852 Specifies the quality assurance checks whose failures are
12570 reported as warnings by the OpenEmbedded build system. 12853 reported as warnings by the OpenEmbedded build system.
12571 You set this variable in your distribution configuration 12854 You set this variable in your distribution configuration
@@ -12578,12 +12861,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12578 </glossdef> 12861 </glossdef>
12579 </glossentry> 12862 </glossentry>
12580 12863
12581 <glossentry id='var-WORKDIR'><glossterm>WORKDIR<imagedata fileref="figures/define-generic.png" /></glossterm> 12864 <glossentry id='var-WORKDIR'><glossterm>WORKDIR</glossterm>
12582 <info> 12865 <info>
12583 WORKDIR[doc] = "The pathname of the working directory in which the OpenEmbedded build system builds a recipe. This directory is located within the TMPDIR directory structure and changes as different packages are built." 12866 WORKDIR[doc] = "The pathname of the working directory in which the OpenEmbedded build system builds a recipe. This directory is located within the TMPDIR directory structure and changes as different packages are built."
12584 </info> 12867 </info>
12585 <glossdef> 12868 <glossdef>
12586 <para> 12869 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12587 The pathname of the work directory in which the OpenEmbedded 12870 The pathname of the work directory in which the OpenEmbedded
12588 build system builds a recipe. 12871 build system builds a recipe.
12589 This directory is located within the 12872 This directory is located within the
@@ -12639,13 +12922,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12639 12922
12640 <glossdiv id='var-glossary-x'><title>X</title> 12923 <glossdiv id='var-glossary-x'><title>X</title>
12641 12924
12642 <glossentry id='var-XSERVER'><glossterm>XSERVER<imagedata fileref="figures/define-generic.png" /></glossterm> 12925 <glossentry id='var-XSERVER'><glossterm>XSERVER</glossterm>
12643 <info> 12926 <info>
12644 XSERVER[doc] = "Specifies the packages that should be installed 12927 XSERVER[doc] = "Specifies the packages that should be installed
12645 to provide an X server and drivers for the current machine." 12928 to provide an X server and drivers for the current machine."
12646 </info> 12929 </info>
12647 <glossdef> 12930 <glossdef>
12648 <para> 12931 <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
12649 Specifies the packages that should be installed to 12932 Specifies the packages that should be installed to
12650 provide an X server and drivers for the current machine, 12933 provide an X server and drivers for the current machine,
12651 assuming your image directly includes 12934 assuming your image directly includes
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2024-11-15 04:31:43 +0000