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.xml72
1 files changed, 41 insertions, 31 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 4ca4e51d5d..71f4ca680c 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1396,15 +1396,22 @@
1396 <para role="glossdeffirst"> 1396 <para role="glossdeffirst">
1397<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 1397<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
1398 The bare name of the recipe. 1398 The bare name of the recipe.
1399 This variable is a version of the <link linkend='var-PN'><filename>PN</filename></link> variable 1399 This variable is a version of the
1400 but removes common suffixes such as "-native" and "-cross" as well 1400 <link linkend='var-PN'><filename>PN</filename></link>
1401 as removes common prefixes such as multilib's "lib64-" and "lib32-". 1401 variable but removes common suffixes such as
1402 <filename>-native</filename> and
1403 <filename>-cross</filename> as well
1404 as removes common prefixes such as multilib's
1405 <filename>lib64-</filename> and
1406 <filename>lib32-</filename>.
1402 The exact list of suffixes removed is specified by the 1407 The exact list of suffixes removed is specified by the
1403 <link linkend='var-SPECIAL_PKGSUFFIX'><filename>SPECIAL_PKGSUFFIX</filename></link> variable. 1408 <link linkend='var-SPECIAL_PKGSUFFIX'><filename>SPECIAL_PKGSUFFIX</filename></link>
1409 variable.
1404 The exact list of prefixes removed is specified by the 1410 The exact list of prefixes removed is specified by the
1405 <link linkend='var-MLPREFIX'><filename>MLPREFIX</filename></link> variable. 1411 <link linkend='var-MLPREFIX'><filename>MLPREFIX</filename></link>
1412 variable.
1406 Prefixes are removed for <filename>multilib</filename> 1413 Prefixes are removed for <filename>multilib</filename>
1407 and <filename>nativesdk</filename> cases. 1414 and <filename>nativesdk-</filename> cases.
1408 </para> 1415 </para>
1409 </glossdef> 1416 </glossdef>
1410 </glossentry> 1417 </glossentry>
@@ -1467,7 +1474,7 @@
1467 Specifies the flags to pass to the C pre-processor 1474 Specifies the flags to pass to the C pre-processor
1468 (i.e. to both the C and the C++ compilers) when building 1475 (i.e. to both the C and the C++ compilers) when building
1469 for the build host. 1476 for the build host.
1470 When building in the <filename>native</filename> context, 1477 When building in the <filename>-native</filename> context,
1471 <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link> 1478 <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
1472 is set to the value of this variable by default. 1479 is set to the value of this variable by default.
1473 </para> 1480 </para>
@@ -1483,7 +1490,7 @@
1483<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 1490<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
1484 Specifies the flags to pass to the C++ compiler when 1491 Specifies the flags to pass to the C++ compiler when
1485 building for the build host. 1492 building for the build host.
1486 When building in the <filename>native</filename> context, 1493 When building in the <filename>-native</filename> context,
1487 <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link> 1494 <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
1488 is set to the value of this variable by default. 1495 is set to the value of this variable by default.
1489 </para> 1496 </para>
@@ -1558,7 +1565,7 @@
1558 The OpenEmbedded build system uses the 1565 The OpenEmbedded build system uses the
1559 <filename>BUILD_PREFIX</filename> value to set the 1566 <filename>BUILD_PREFIX</filename> value to set the
1560 <link linkend='var-TARGET_PREFIX'><filename>TARGET_PREFIX</filename></link> 1567 <link linkend='var-TARGET_PREFIX'><filename>TARGET_PREFIX</filename></link>
1561 when building for native recipes. 1568 when building for <filename>native</filename> recipes.
1562 </para> 1569 </para>
1563 </glossdef> 1570 </glossdef>
1564 </glossentry> 1571 </glossentry>
@@ -1839,7 +1846,7 @@
1839<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 1846<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
1840 Specifies the flags to pass to the C compiler when building 1847 Specifies the flags to pass to the C compiler when building
1841 for the SDK. 1848 for the SDK.
1842 When building in the <filename>nativesdk</filename> 1849 When building in the <filename>nativesdk-</filename>
1843 context, 1850 context,
1844 <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link> 1851 <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
1845 is set to the value of this variable by default. 1852 is set to the value of this variable by default.
@@ -1857,7 +1864,7 @@
1857 Specifies the flags to pass to the C pre-processor 1864 Specifies the flags to pass to the C pre-processor
1858 (i.e. to both the C and the C++ compilers) when building 1865 (i.e. to both the C and the C++ compilers) when building
1859 for the SDK. 1866 for the SDK.
1860 When building in the <filename>nativesdk</filename> 1867 When building in the <filename>nativesdk-</filename>
1861 context, 1868 context,
1862 <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link> 1869 <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
1863 is set to the value of this variable by default. 1870 is set to the value of this variable by default.
@@ -1874,7 +1881,7 @@
1874<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 1881<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
1875 Specifies the flags to pass to the C++ compiler when 1882 Specifies the flags to pass to the C++ compiler when
1876 building for the SDK. 1883 building for the SDK.
1877 When building in the <filename>nativesdk</filename> 1884 When building in the <filename>nativesdk-</filename>
1878 context, 1885 context,
1879 <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link> 1886 <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
1880 is set to the value of this variable by default. 1887 is set to the value of this variable by default.
@@ -2031,7 +2038,7 @@
2031 and then can be used as an override. 2038 and then can be used as an override.
2032 Here is an example where "python-native" is added to 2039 Here is an example where "python-native" is added to
2033 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> 2040 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
2034 only when building for the native case: 2041 only when building for the <filename>-native</filename> case:
2035 <literallayout class='monospaced'> 2042 <literallayout class='monospaced'>
2036 DEPENDS_append_class-native = " python-native" 2043 DEPENDS_append_class-native = " python-native"
2037 </literallayout> 2044 </literallayout>
@@ -2567,7 +2574,7 @@
2567 <listitem><para> 2574 <listitem><para>
2568 <link linkend='var-BUILDSDK_CXXFLAGS'><filename>BUILDSDK_CXXFLAGS</filename></link> 2575 <link linkend='var-BUILDSDK_CXXFLAGS'><filename>BUILDSDK_CXXFLAGS</filename></link>
2569 when building for an SDK (i.e. 2576 when building for an SDK (i.e.
2570 <filename>nativesdk</filename>) 2577 <filename>nativesdk-</filename>)
2571 </para></listitem> 2578 </para></listitem>
2572 </itemizedlist> 2579 </itemizedlist>
2573 </para> 2580 </para>
@@ -4736,12 +4743,12 @@
4736 <listitem><para> 4743 <listitem><para>
4737 <filename>BUILD_CC_ARCH</filename> 4744 <filename>BUILD_CC_ARCH</filename>
4738 when building for the build host (i.e. 4745 when building for the build host (i.e.
4739 <filename>native</filename>) 4746 <filename>-native</filename>)
4740 </para></listitem> 4747 </para></listitem>
4741 <listitem><para> 4748 <listitem><para>
4742 <filename>BUILDSDK_CC_ARCH</filename> 4749 <filename>BUILDSDK_CC_ARCH</filename>
4743 when building for an SDK (i.e. 4750 when building for an SDK (i.e.
4744 <filename>nativesdk</filename>) 4751 <filename>nativesdk-</filename>)
4745 </para></listitem> 4752 </para></listitem>
4746 </itemizedlist> 4753 </itemizedlist>
4747 </para> 4754 </para>
@@ -11898,14 +11905,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
11898 <listitem><para>For recipes building for the target 11905 <listitem><para>For recipes building for the target
11899 machine, the value is "${STAGING_DIR}/${MACHINE}". 11906 machine, the value is "${STAGING_DIR}/${MACHINE}".
11900 </para></listitem> 11907 </para></listitem>
11901 <listitem><para>For <filename>native</filename> 11908 <listitem><para>For native recipes building
11902 recipes building
11903 for the build host, the value is empty given the 11909 for the build host, the value is empty given the
11904 assumption that when building for the build host, 11910 assumption that when building for the build host,
11905 the build host's own directories should be used. 11911 the build host's own directories should be used.
11906 </para></listitem> 11912 </para></listitem>
11907 <listitem><para>For <filename>nativesdk</filename> 11913 <listitem><para>For native SDK
11908 recipes that build for the SDK, the value is 11914 recipes that build for the SDK
11915 (<filename>nativesdk</filename>), the value is
11909 "${STAGING_DIR}/${MULTIMACH_HOST_SYS}". 11916 "${STAGING_DIR}/${MULTIMACH_HOST_SYS}".
11910 </para></listitem> 11917 </para></listitem>
11911 </itemizedlist> 11918 </itemizedlist>
@@ -12713,12 +12720,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12713 "${<link linkend='var-TARGET_SYS'>TARGET_SYS</link>}-". 12720 "${<link linkend='var-TARGET_SYS'>TARGET_SYS</link>}-".
12714 </para></listitem> 12721 </para></listitem>
12715 <listitem><para> 12722 <listitem><para>
12716 For <filename>native</filename> recipes, the build 12723 For native recipes, the build system sets the
12717 system sets the variable to the value of 12724 variable to the value of
12718 <filename>BUILD_PREFIX</filename>. 12725 <filename>BUILD_PREFIX</filename>.
12719 </para></listitem> 12726 </para></listitem>
12720 <listitem><para> 12727 <listitem><para>
12721 For <filename>nativesdk</filename> recipes, the 12728 For native SDK recipes
12729 (<filename>nativesdk</filename>), the
12722 build system sets the variable to the value of 12730 build system sets the variable to the value of
12723 <filename>SDK_PREFIX</filename>. 12731 <filename>SDK_PREFIX</filename>.
12724 </para></listitem> 12732 </para></listitem>
@@ -12757,9 +12765,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
12757 Consider these two examples: 12765 Consider these two examples:
12758 <itemizedlist> 12766 <itemizedlist>
12759 <listitem><para> 12767 <listitem><para>
12760 Given a <filename>native</filename> recipe on a 12768 Given a native recipe on a 32-bit, x86 machine
12761 32-bit, x86 machine running Linux, the value is 12769 running Linux, the value is "i686-linux".
12762 "i686-linux".
12763 </para></listitem> 12770 </para></listitem>
12764 <listitem><para> 12771 <listitem><para>
12765 Given a recipe being built for a little-endian, 12772 Given a recipe being built for a little-endian,
@@ -13365,11 +13372,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
13365 toolchain set that runs on the 13372 toolchain set that runs on the
13366 <link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>, 13373 <link linkend='var-SDKMACHINE'><filename>SDKMACHINE</filename></link>,
13367 and each package should usually have the prefix 13374 and each package should usually have the prefix
13368 "nativesdk-". 13375 <filename>nativesdk-</filename>.
13369 When building an SDK using 13376 For example, consider the following command when
13370 <filename>bitbake -c populate_sdk &lt;imagename&gt;</filename>, 13377 building an SDK:
13371 a default list of packages is set in this variable, but 13378 <literallayout class='monospaced'>
13372 you can add additional packages to the list. 13379 $ bitbake -c populate_sdk <replaceable>imagename</replaceable>
13380 </literallayout>
13381 In this case, a default list of packages is set in this
13382 variable, but you can add additional packages to the list.
13373 </para> 13383 </para>
13374 13384
13375 <para> 13385 <para>