ref-manual: Updated the MACHINEOVERRIDES variable description
Fixes [YOCTO #10175] Provided a more detailed description of this variable. (From yocto-docs rev: 95a80313dfb276425020a61d199b75d259b47ff1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
44b0b07a6f
commit
2233924ee6
|
@ -7808,36 +7808,41 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
|
||||||
|
|
||||||
<glossentry id='var-MACHINEOVERRIDES'><glossterm>MACHINEOVERRIDES</glossterm>
|
<glossentry id='var-MACHINEOVERRIDES'><glossterm>MACHINEOVERRIDES</glossterm>
|
||||||
<info>
|
<info>
|
||||||
MACHINEOVERRIDES[doc] = "Lists overrides specific to the current machine. By default, this list includes the value of MACHINE."
|
MACHINEOVERRIDES[doc] = "A colon-separated list of overrides that apply to the current machine."
|
||||||
</info>
|
</info>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para role="glossdeffirst">
|
<para role="glossdeffirst">
|
||||||
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
|
||||||
Lists overrides specific to the current machine.
|
A colon-separated list of overrides that apply to the
|
||||||
By default, this list includes the value
|
current machine.
|
||||||
of <filename><link linkend='var-MACHINE'>MACHINE</link></filename>.
|
By default, this list includes the value of
|
||||||
You can extend the list to apply variable overrides for
|
<link linkend='var-MACHINE'><filename>MACHINE</filename></link>.
|
||||||
classes of machines.
|
|
||||||
For example, all QEMU emulated machines (e.g. qemuarm,
|
|
||||||
qemux86, and so forth) include a common file named
|
|
||||||
<filename>meta/conf/machine/include/qemu.inc</filename>
|
|
||||||
that prepends <filename>MACHINEOVERRIDES</filename> with
|
|
||||||
the following variable override:
|
|
||||||
<literallayout class='monospaced'>
|
|
||||||
MACHINEOVERRIDES =. "qemuall:"
|
|
||||||
</literallayout>
|
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Applying an override like <filename>qemuall</filename>
|
You can extend <filename>MACHINEOVERRIDES</filename>
|
||||||
affects all QEMU emulated machines elsewhere.
|
to add extra overrides that should apply to a machine.
|
||||||
Here is an example from the
|
For example, all machines emulated in QEMU (e.g.
|
||||||
<filename>connman-conf</filename> recipe:
|
<filename>qemuarm</filename>, <filename>qemux86</filename>,
|
||||||
|
and so forth) include a file named
|
||||||
|
<filename>meta/conf/machine/include/qemu.inc</filename>
|
||||||
|
that prepends the following override to
|
||||||
|
<filename>MACHINEOVERRIDES</filename>:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
MACHINEOVERRIDES =. "qemuall:"
|
||||||
|
</literallayout>
|
||||||
|
This override allows variables to be overriden for all
|
||||||
|
machines emulated in QEMU, like in the following example
|
||||||
|
from the <filename>connman-conf</filename> recipe:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
SRC_URI_append_qemuall = "file://wired.config \
|
SRC_URI_append_qemuall = "file://wired.config \
|
||||||
file://wired-setup \
|
file://wired-setup \
|
||||||
"
|
"
|
||||||
</literallayout>
|
</literallayout>
|
||||||
|
The underlying mechanism behind
|
||||||
|
<filename>MACHINEOVERRIDES</filename> is simply that it is
|
||||||
|
included in the default value of
|
||||||
|
<link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link>.
|
||||||
</para>
|
</para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
Loading…
Reference in New Issue