mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-29 18:32:20 +02:00
Code Issues Packages Projects Releases Wiki Activity

ref-manual: Updates to several variables.

Browse Source 
I implemented some review feedback from Paul Eggleton on these
variables:

  TARGET_CFLAGS
  BUILD_OPTIMIZATION
  SDKMACHINE
  IMAGE_ROOTFS_ALIGNMENT
  IMAGE_DEVICE_TABLES
  EXTRA_IMAGECMD
  SSTATE_MIRROR_ALLOW_NETWORK
  PACKAGE_ARCHS
  SDK_PACKAGE_ARCHS

(From yocto-docs rev: 6fd804376367449494d5a5cfeb7e9bb2f4c04de1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2014-06-02 09:46:06 +03:00
committed by Richard Purdie
parent f3394914fd
commit 2aba525b98
1 changed files with 33 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
documentation/ref-manual/ref-variables.xml
View File

@@ -932,7 +932,7 @@
<glossdef> <glossdef>
<para> <para>
Specifies the optimization flags passed to the C compiler Specifies the optimization flags passed to the C compiler
when building for the host or the SDK. when building for the build host or the SDK.
The flags are passed through the The flags are passed through the
<link linkend='var-BUILD_CFLAGS'><filename>BUILD_CFLAGS</filename></link> <link linkend='var-BUILD_CFLAGS'><filename>BUILD_CFLAGS</filename></link>
and and
@@ -2350,6 +2350,12 @@
Specifies additional options for the image Specifies additional options for the image
creation command that has been specified in creation command that has been specified in
<link linkend='var-IMAGE_CMD'><filename>IMAGE_CMD</filename></link>. <link linkend='var-IMAGE_CMD'><filename>IMAGE_CMD</filename></link>.
When setting this variable, you should
use an override for the associated type.
Here is an example:
<literallayout class='monospaced'>
EXTRA_IMAGECMD_ext3 ?= "-i 4096"
</literallayout>
</para> </para>
</glossdef> </glossdef>
</glossentry> </glossentry>
@@ -3196,9 +3202,10 @@
created under <filename>/dev</filename> within the image. created under <filename>/dev</filename> within the image.
If <filename>IMAGE_DEVICE_TABLES</filename> is not set, If <filename>IMAGE_DEVICE_TABLES</filename> is not set,
<filename>files/device_table-minimal.txt</filename> is <filename>files/device_table-minimal.txt</filename> is
used. used, which is located by
<link linkend='var-BBPATH'><filename>BBPATH</filename></link>.
For details on how you should write device table files, For details on how you should write device table files,
see the <filename>files/device_table-minimal.txt</filename> see <filename>files/device_table-minimal.txt</filename>
as an example. as an example.
</para> </para>
</glossdef> </glossdef>
@@ -3533,7 +3540,7 @@
If the size of the image is not a multiple of If the size of the image is not a multiple of
this value, then the size is rounded up to the nearest this value, then the size is rounded up to the nearest
multiple of the value. multiple of the value.
The default value is 1 Kbyte. The default value is "1".
See See
<link linkend='var-IMAGE_ROOTFS_SIZE'><filename>IMAGE_ROOTFS_SIZE</filename></link> <link linkend='var-IMAGE_ROOTFS_SIZE'><filename>IMAGE_ROOTFS_SIZE</filename></link>
for additional information. for additional information.
@@ -5478,10 +5485,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<para> <para>
Specifies a list of architectures compatible with Specifies a list of architectures compatible with
the target machine. the target machine.
Separate the entries using spaces and list them in order
of priority.
This variable is set automatically and should not This variable is set automatically and should not
normally be hand-edited. normally be hand-edited.
Entries are separated using spaces and listed in order
of priority.
The default value for The default value for
<filename>PACKAGE_ARCHS</filename> is "all any noarch <filename>PACKAGE_ARCHS</filename> is "all any noarch
${PACKAGE_EXTRA_ARCHS} ${MACHINE_ARCH}". ${PACKAGE_EXTRA_ARCHS} ${MACHINE_ARCH}".
@@ -7096,10 +7103,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<para> <para>
Specifies a list of architectures compatible with Specifies a list of architectures compatible with
the SDK machine. the SDK machine.
Separate the entries using spaces and list them in order
of priority.
This variable is set automatically and should not This variable is set automatically and should not
normally be hand-edited. normally be hand-edited.
Entries are separated using spaces and listed in order
of priority.
The default value for The default value for
<filename>SDK_PACKAGE_ARCHS</filename> is "all any noarch <filename>SDK_PACKAGE_ARCHS</filename> is "all any noarch
${SDK_ARCH}-${SDKPKGSUFFIX}". ${SDK_ARCH}-${SDKPKGSUFFIX}".
@@ -7132,6 +7139,20 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<filename>.conf</filename> file under <filename>.conf</filename> file under
<filename>conf/machine-sdk/</filename>. <filename>conf/machine-sdk/</filename>.
</para> </para>
<para>
You can use "i686" and "x86_64" as possible values
for this variable. The variable defaults to "i686"
and is set in the local.conf file in the Build Directory.
<literallayout class='monospaced'>
SDKMACHINE ?= "i686"
</literallayout>
<note>
You cannot set the <filename>SDKMACHINE</filename>
variable in your distribution configuration file.
If you do, the configuration will not take affect.
</note>
</para>
</glossdef> </glossdef>
</glossentry> </glossentry>
@@ -7161,7 +7182,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<para> <para>
Specifies the optimization flags passed to the C compiler Specifies the optimization flags passed to the C compiler
when building for the target. when building for the target.
The flags are passed through the default The flags are passed through the default value of the
<link linkend='var-TARGET_CFLAGS'><filename>TARGET_CFLAGS</filename></link> <link linkend='var-TARGET_CFLAGS'><filename>TARGET_CFLAGS</filename></link>
variable. variable.
</para> </para>
@@ -7635,8 +7656,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
If set to "1", allows fetches from If set to "1", allows fetches from
mirrors that are specified in mirrors that are specified in
<link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link> <link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link>
to work even when <filename>BB_NO_NETWORK</filename> to work even when fetching from the network has been
is set to "1", which disables fetching from the network. disabled by setting <filename>BB_NO_NETWORK</filename>
to "1".
Using the Using the
<filename>SSTATE_MIRROR_ALLOW_NETWORK</filename> <filename>SSTATE_MIRROR_ALLOW_NETWORK</filename>
variable is useful if you have set variable is useful if you have set