mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: Updated PREFERRED_PROVIDER variable

Browse Source 
Provided more details in the explanation and fixed a link to the
section on using virtual providers.

(From yocto-docs rev: ace74e24f001b83c9177266b0a6f15ce96dd04b0)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-02-23 16:50:11 -08:00
committed by Richard Purdie
parent e701fdeeba
commit bb4ab5a653
1 changed files with 25 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/ref-variables.xml
+25 -12
View File
@@ -10701,27 +10701,40 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<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" /> -->
If multiple recipes provide an item, this variable If multiple recipes provide the same item, this variable
determines which recipe should be given preference. determines which recipe is preferred and thus provides
You should always suffix the variable with the name of the the item (i.e. the preferred provider).
provided item, and you should set it to the You should always suffix this variable with the name of the
<link linkend='var-PN'><filename>PN</filename></link> provided item.
of the recipe to which you want to give precedence. And, you should define the variable using the preferred
Some examples: recipe's name
(<link linkend='var-PN'><filename>PN</filename></link>).
Here is a common example:
<literallayout class='monospaced'> <literallayout class='monospaced'>
PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto" PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto"
</literallayout>
In the previous example, multiple recipes are providing
"virtual/kernel".
The <filename>PREFERRED_PROVIDER</filename> variable is
set with the name (<filename>PN</filename>) of the recipe
you prefer to provide "virtual/kernel".
</para>
<para>
Following are more examples:
<literallayout class='monospaced'>
PREFERRED_PROVIDER_virtual/xserver = "xserver-xf86" PREFERRED_PROVIDER_virtual/xserver = "xserver-xf86"
PREFERRED_PROVIDER_virtual/libgl ?= "mesa" PREFERRED_PROVIDER_virtual/libgl ?= "mesa"
</literallayout> </literallayout>
For more information, see the For more information, see the
"<ulink url='&YOCTO_DOCS_CM_URL;#metadata-virtual-providers'>Metadata (Virtual Providers)</ulink>" "<ulink url='&YOCTO_DOCS_DEV_URL;#metadata-virtual-providers'>Using Virtual Providers</ulink>"
section in the Yocto Project Concepts Manual. section in the Yocto Project Development Tasks Manual.
<note> <note>
If you set <filename>PREFERRED_PROVIDER</filename> If you use a <filename>virtual/*</filename> item
for a <filename>virtual/*</filename> item, then any with <filename>PREFERRED_PROVIDER</filename>, then any
recipe that recipe that
<link linkend='var-PROVIDES'><filename>PROVIDES</filename></link> <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link>
that item that is not selected by that item but is not selected (defined) by
<filename>PREFERRED_PROVIDER</filename> is prevented <filename>PREFERRED_PROVIDER</filename> is prevented
from building, which is usually desirable since this from building, which is usually desirable since this
mechanism is designed to select between mutually mechanism is designed to select between mutually