74 lines
3.7 KiB
Plaintext
74 lines
3.7 KiB
Plaintext
Package component provides naming
|
|
=================================
|
|
This document describes how the "provides"-strings for packages should
|
|
be formatted for the given PK_PROVIDES types.
|
|
This is needed to ensure cross-distro compatibility on package provides
|
|
naming (the naming of components packages provide), which is used for
|
|
example in pk_client_what_provides_async().
|
|
Valid types of provided components are defined in PkProvidesEnum.
|
|
|
|
In general, the component naming should be "type(component-name)".
|
|
|
|
Component naming
|
|
----------------
|
|
|
|
MODALIAS: A string with the modalias, for example
|
|
"pci:v00008086d00003B64sv000017AAsd0000215Fbc07sc80i00"
|
|
or "usb:v09DAp000Ad0014dc00dsc00dp00ic03isc01ip02".
|
|
Returns packages which provide a driver for this
|
|
device.
|
|
|
|
CODEC: A string in the format of gstreamer<version>(type-format)
|
|
where <version> is the GStreamer API version (e. g.
|
|
0.10), "type" is a GStreamer element type ("encoder",
|
|
"decoder", "urisource", ""urisink", "element"), and
|
|
"format" is the type specific search string.
|
|
Example: "gstreamer0.10(decoder-audio/ac3)" or
|
|
"gstreamer1(decoder-audio/mp3)"
|
|
|
|
MIMETYPE: Mimetypes are (valid) mimetypes strings,
|
|
for example "application/x-catalog" or "text/plain".
|
|
|
|
FONT: A font name, e.g. "Cantarell".
|
|
|
|
HARDWARE_DRIVER: The only valid query at the moment is
|
|
"drivers_for_attached_hardware" which delivers all
|
|
driver packages that apply to the current system's
|
|
hardware.
|
|
|
|
POSTSCRIPT_DRIVER:
|
|
A string in the format of "postscriptdriver(mfg;mdl;)"
|
|
where mfg and mdl are the corresponding
|
|
IEEE 1284 Device ID keys for the printer model,
|
|
converted to lower-case and with spaces converted
|
|
to underscores.
|
|
Example: "postscriptdriver(epson;stylus_d92;)"
|
|
|
|
PLASMA_SERVICE: A string in the format of
|
|
"plasma<version>(servicetype-name)" (where <version> is
|
|
currently expected to be 4 or 5), e.g.
|
|
"plasma4(dataengine-weather)". For backwards
|
|
compatibility, "servicetype-name" will be treated the
|
|
same as "plasma4(servicetype-name)".
|
|
|
|
SHARED_LIB: Name of a shared library
|
|
Example: "libpackagekit-glib2.so.14"
|
|
|
|
PYTHON: A string in the format of "python<version>(module-name)",
|
|
or just the name of the Python module.
|
|
If the Python-Version is omitted, the backend will
|
|
choose the current default Python version.
|
|
Example: "python2(packagekit)"
|
|
|
|
LANGUAGE_SUPPORT: A string in the format of language(ll_CC) or
|
|
language(ll), which should correspond to a
|
|
language/country pair or just a language, as in
|
|
/usr/share/i18n/SUPPORTED. Returns all packages
|
|
which provide language support (dictionaries,
|
|
translated help, ibus modules, etc.) for all packages
|
|
that are currently installed in the system.
|
|
Example: "language(zh_CN)" might suggest ibus-pinyin and
|
|
libreoffice-l10n-zh-cn if you have ibus and LibreOffice
|
|
installed.
|
|
|