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

ref-manual/variables: document the PREFERRED_RPROVIDER variable

Browse Source 
This variable is similar to the PREFERRED_PROVIDER variable but it
denotes a runtime provider specifically.

(From yocto-docs rev: 0b0b58070fceff6851a6e137f7f774e706205b32)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Antonin Godard
2024-12-20 13:16:40 +01:00
committed by Richard Purdie
parent c8f553a177
commit 4e49c8bfa5
1 changed files with 22 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
documentation/ref-manual/variables.rst
View File

@@ -6726,6 +6726,28 @@ system and gives an overview of their function and contents.
:term:`PREFERRED_PROVIDERS`
See :term:`bitbake:PREFERRED_PROVIDERS` in the BitBake manual.
:term:`PREFERRED_RPROVIDER`
The :term:`PREFERRED_RPROVIDER` variable works like the
:term:`PREFERRED_PROVIDER` variable, but it denotes packages that provide a
*runtime* component. Runtime providers are declared in recipes that set
the :term:`RPROVIDES` variable for a specific package.
For example::
PREFERRED_RPROVIDER_virtual-x-terminal-emulator = "rxvt-unicode"
This statement sets the runtime provider for the X terminal emulator to
``rxvt-unicode``. The ``rxvt-unicode`` package is a runtime provider of
this component because the ``rxvt-unicode`` recipe set the following
:term:`RPROVIDES` definition for the ``rxvt-unicode`` (``${PN}``)
package::
RPROVIDES:${PN} = "virtual-x-terminal-emulator"
For more information on virtual providers, see the
":ref:`dev-manual/new-recipe:using virtual providers`" section in the
Yocto Project Development Tasks Manual.
:term:`PREFERRED_VERSION`
If there are multiple versions of a recipe available, this variable
determines which version should be given preference. You must always