libzypp 17.31.23
|
A Solvable object within the sat Pool. More...
#include <sat/Solvable.h>
Classes | |
class | SplitIdent |
Helper that splits an identifier into kind and name or vice versa. More... | |
Public Types | |
typedef sat::detail::SolvableIdType | IdType |
Public Member Functions | |
Solvable () | |
Default ctor creates noSolvable. | |
Solvable (IdType id_r) | |
PoolImpl ctor. | |
operator bool () const | |
Evaluate Solvable in a boolean context (!= noSolvable ). | |
IdString | ident () const |
The identifier. | |
ResKind | kind () const |
The Solvables ResKind. | |
bool | isKind (const ResKind &kind_r) const |
Test whether a Solvable is of a certain ResKind. | |
template<class TRes > | |
bool | isKind () const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<class TIterator > | |
bool | isKind (TIterator begin, TIterator end) const |
std::string | name () const |
The name (without any ResKind prefix). | |
Edition | edition () const |
The edition (version-release). | |
Arch | arch () const |
The architecture. | |
IdString | vendor () const |
The vendor. | |
Repository | repository () const |
The Repository this Solvable belongs to. | |
RepoInfo | repoInfo () const |
The repositories RepoInfo. | |
bool | isSystem () const |
Return whether this Solvable belongs to the system repo. | |
bool | onSystemByUser () const |
Whether this is known to be installed on behalf of a user request. | |
bool | onSystemByAuto () const |
Whether this is known to be automatically installed (as dependency of a user request package). | |
bool | identIsAutoInstalled () const |
Whether an installed solvable with the same ident is flagged as AutoInstalled. | |
bool | multiversionInstall () const |
Whether different versions of this package can be installed at the same time. | |
bool | isNeedreboot () const |
Whether this solvable triggers the reboot-needed hint if installed/updated. | |
Blacklisted packages. | |
Blacklisted packages are visible in a repository, but no matter how good they apparently look like, they must not be considered during normal operations. Under normal conditions the resolver will avoid selecting blacklisted packages. To install a blacklisted package it must be selected explicitly. Whether this is a good idea, depends on the reason for having been blacklisted:
| |
bool | isBlacklisted () const |
Whether this solvable is blacklisted (retracted,ptf,...). | |
bool | isRetracted () const |
Whether this solvable is retracted (provides retractedToken). | |
bool | isPtf () const |
Whether this solvable belongs to a PTF (provides ptfMasterToken or ptfPackageToken). | |
bool | isPtfMaster () const |
Subset of isPtf (provides ptfMasterToken). | |
bool | isPtfPackage () const |
Subset of isPtf (provides ptfPackageToken). | |
Date | buildtime () const |
The items build time. | |
Date | installtime () const |
The items install time (false if not installed). | |
std::string | asString () const |
String representation "ident-edition.arch" or "noSolvable" . | |
std::string | asUserString () const |
String representation "ident-edition.arch(repo)" or "noSolvable" . | |
bool | identical (const Solvable &rhs) const |
Test whether two Solvables have the same content. | |
bool | sameNVRA (const Solvable &rhs) const |
Test for same name-version-release.arch. | |
Locale support. | |
bool | supportsLocales () const |
Whether this Solvable claims to support locales. | |
bool | supportsLocale (const Locale &locale_r) const |
Whether this Solvable supports a specific Locale. | |
bool | supportsLocale (const LocaleSet &locales_r) const |
Whether this Solvable supports at least one of the specified locales. | |
bool | supportsRequestedLocales () const |
Whether this Solvable supports at least one requested locale. | |
LocaleSet | getSupportedLocales () const |
Return the supported locales. | |
void | getSupportedLocales (LocaleSet &locales_r) const |
CpeId | cpeId () const |
The solvables CpeId if available. | |
unsigned | mediaNr () const |
Media number the solvable is located on (0 if no media access required). | |
ByteCount | installSize () const |
Installed (unpacked) size. | |
ByteCount | downloadSize () const |
Download size. | |
std::string | distribution () const |
The distribution string. | |
std::string | summary (const Locale &lang_r=Locale()) const |
Short (singleline) text describing the solvable (opt. | |
std::string | description (const Locale &lang_r=Locale()) const |
Long (multiline) text describing the solvable (opt. | |
std::string | insnotify (const Locale &lang_r=Locale()) const |
UI hint text when selecting the solvable for install (opt. | |
std::string | delnotify (const Locale &lang_r=Locale()) const |
UI hint text when selecting the solvable for uninstall (opt. | |
std::string | licenseToConfirm (const Locale &lang_r=Locale()) const |
License or agreement to accept before installing the solvable (opt. | |
bool | needToAcceptLicense () const |
True except for well known exceptions (i.e show license but no need to accept it). | |
Static Public Member Functions | |
static bool | identIsAutoInstalled (const IdString &ident_r) |
Static Public Attributes | |
static const IdString | retractedToken { "retracted-patch-package()" } |
Indicator provides retracted-patch-package() | |
static const IdString | ptfMasterToken { "ptf()" } |
Indicator provides ptf() | |
static const IdString | ptfPackageToken { "ptf-package()" } |
Indicator provides ptf-package() | |
static const Solvable | noSolvable |
Represents no Solvable. | |
Related Functions | |
(Note that these are not member functions.) | |
std::ostream & | operator<< (std::ostream &str, const Solvable &obj) |
Stream output. | |
std::ostream & | dumpOn (std::ostream &str, const Solvable &obj) |
More verbose stream output including dependencies. | |
std::ostream & | dumpAsXmlOn (std::ostream &str, const Solvable &obj) |
XML output. | |
bool | operator== (const Solvable &lhs, const Solvable &rhs) |
bool | operator!= (const Solvable &lhs, const Solvable &rhs) |
bool | operator< (const Solvable &lhs, const Solvable &rhs) |
template<class TRes > | |
bool | isKind (const Solvable &solvable_r) |
Test whether a Solvable is of a certain Kind. | |
bool | identical (const Solvable &lhs, const Solvable &rhs) |
Test for same content. | |
bool | sameNVRA (const Solvable &lhs, const Solvable &rhs) |
Test for same name version release and arch. | |
int | compareByN (const Solvable &lhs, const Solvable &rhs) |
Compare according to kind and name. | |
int | compareByNVR (const Solvable &lhs, const Solvable &rhs) |
Compare according to kind, name and edition. | |
int | compareByNVRA (const Solvable &lhs, const Solvable &rhs) |
Compare according to kind, name, edition and arch. | |
Access to the \ref Solvable dependencies. | |
| |
Capabilities | const |
Capabilities | provides () const |
Capabilities | conflicts () const |
Capabilities | obsoletes () const |
Capabilities | recommends () const |
Capabilities | suggests () const |
Capabilities | enhances () const |
Capabilities | supplements () const |
Capabilities | prerequires () const |
Capabilities | dep (Dep which_r) const |
Return Capabilities selected by Dep constant. | |
Capabilities | operator[] (Dep which_r) const |
CapabilitySet | providesNamespace (const std::string &namespace_r) const |
Return the namespaced provides 'namespace([value])[ op edition]' of this Solvable. | |
CapabilitySet | valuesOfNamespace (const std::string &namespace_r) const |
Return 'value[ op edition]' for namespaced provides 'namespace(value)[ op edition]' . | |
std::pair< bool, CapabilitySet > | matchesSolvable (const SolvAttr &attr, const sat::Solvable &solv) const |
Attribute lookup. | |
| |
IdType | _id |
std::string | lookupStrAttribute (const SolvAttr &attr) const |
returns the string attribute value for attr or an empty string if it does not exists. | |
std::string | lookupStrAttribute (const SolvAttr &attr, const Locale &lang_r) const |
unsigned long long | lookupNumAttribute (const SolvAttr &attr) const |
returns the numeric attribute value for attr or 0 if it does not exists. | |
unsigned long long | lookupNumAttribute (const SolvAttr &attr, unsigned long long notfound_r) const |
bool | lookupBoolAttribute (const SolvAttr &attr) const |
returns the boolean attribute value for attr or false if it does not exists. | |
detail::IdType | lookupIdAttribute (const SolvAttr &attr) const |
returns the id attribute value for attr or detail::noId if it does not exists. | |
CheckSum | lookupCheckSumAttribute (const SolvAttr &attr) const |
returns the CheckSum attribute value for attr or an empty CheckSum if ir does not exist. | |
OnMediaLocation | lookupLocation () const |
returns OnMediaLocation data: This is everything we need to download e.g. | |
Solvable | nextInPool () const |
Return next Solvable in Pool (or noSolvable). | |
Solvable | nextInRepo () const |
Return next Solvable in Repo (or noSolvable). | |
detail::CSolvable * | get () const |
Expert backdoor. | |
IdType | id () const |
Expert backdoor. | |
Additional Inherited Members | |
Static Protected Member Functions inherited from zypp::sat::detail::PoolMember | |
static PoolImpl & | myPool () |
A Solvable object within the sat Pool.
"pattern:kde_multimedia"
, except for packages and source packes. They are not prefixed by any kind string. Instead the architecture is abused to store "src"
and "nosrc"
values.Solvable will hide this inconsistency by treating source packages as an own kind of solvable and map their arch to Arch_noarch.
Definition at line 53 of file Solvable.h.
Definition at line 56 of file Solvable.h.
|
inline |
Default ctor creates noSolvable.
Definition at line 64 of file Solvable.h.
|
inlineexplicit |
PoolImpl ctor.
Definition at line 69 of file Solvable.h.
|
inlineexplicit |
Evaluate Solvable in a boolean context (!=
noSolvable
).
Definition at line 78 of file Solvable.h.
IdString zypp::sat::Solvable::ident | ( | ) | const |
The identifier.
This is the solvables name, except for packages and source packes, prefixed by its kind.
Definition at line 269 of file Solvable.cc.
ResKind zypp::sat::Solvable::kind | ( | ) | const |
The Solvables ResKind.
Definition at line 275 of file Solvable.cc.
Test whether a Solvable is of a certain ResKind.
The test is far cheaper than actually retrieving and comparing the kind.
Definition at line 302 of file Solvable.cc.
|
inline |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 98 of file Solvable.h.
|
inline |
Definition at line 102 of file Solvable.h.
std::string zypp::sat::Solvable::name | ( | ) | const |
The name (without any ResKind prefix).
Definition at line 329 of file Solvable.cc.
Edition zypp::sat::Solvable::edition | ( | ) | const |
The edition (version-release).
Definition at line 337 of file Solvable.cc.
Arch zypp::sat::Solvable::arch | ( | ) | const |
The architecture.
Definition at line 343 of file Solvable.cc.
IdString zypp::sat::Solvable::vendor | ( | ) | const |
The vendor.
Definition at line 357 of file Solvable.cc.
Repository zypp::sat::Solvable::repository | ( | ) | const |
The Repository this Solvable belongs to.
Definition at line 363 of file Solvable.cc.
RepoInfo zypp::sat::Solvable::repoInfo | ( | ) | const |
The repositories RepoInfo.
Definition at line 369 of file Solvable.cc.
bool zypp::sat::Solvable::isSystem | ( | ) | const |
Return whether this Solvable belongs to the system repo.
Definition at line 373 of file Solvable.cc.
bool zypp::sat::Solvable::onSystemByUser | ( | ) | const |
Whether this is known to be installed on behalf of a user request.
false
for non-system (uninstalled) solvables. Definition at line 379 of file Solvable.cc.
bool zypp::sat::Solvable::onSystemByAuto | ( | ) | const |
Whether this is known to be automatically installed (as dependency of a user request package).
false
for non-system (uninstalled) solvables. Definition at line 384 of file Solvable.cc.
|
inline |
Whether an installed solvable with the same ident is flagged as AutoInstalled.
Definition at line 138 of file Solvable.h.
Definition at line 389 of file Solvable.cc.
bool zypp::sat::Solvable::multiversionInstall | ( | ) | const |
Whether different versions of this package can be installed at the same time.
Per default false
.
Definition at line 430 of file Solvable.cc.
bool zypp::sat::Solvable::isNeedreboot | ( | ) | const |
Whether this solvable triggers the reboot-needed hint if installed/updated.
Definition at line 394 of file Solvable.cc.
bool zypp::sat::Solvable::isBlacklisted | ( | ) | const |
Whether this solvable is blacklisted (retracted,ptf,...).
Definition at line 401 of file Solvable.cc.
bool zypp::sat::Solvable::isRetracted | ( | ) | const |
Whether this solvable is retracted (provides retractedToken).
Definition at line 404 of file Solvable.cc.
bool zypp::sat::Solvable::isPtf | ( | ) | const |
Whether this solvable belongs to a PTF (provides ptfMasterToken or ptfPackageToken).
Definition at line 414 of file Solvable.cc.
bool zypp::sat::Solvable::isPtfMaster | ( | ) | const |
Subset of isPtf (provides ptfMasterToken).
Definition at line 417 of file Solvable.cc.
bool zypp::sat::Solvable::isPtfPackage | ( | ) | const |
Subset of isPtf (provides ptfPackageToken).
Definition at line 423 of file Solvable.cc.
Date zypp::sat::Solvable::buildtime | ( | ) | const |
The items build time.
Definition at line 436 of file Solvable.cc.
Date zypp::sat::Solvable::installtime | ( | ) | const |
The items install time (false
if not installed).
Definition at line 442 of file Solvable.cc.
std::string zypp::sat::Solvable::asString | ( | ) | const |
String representation "ident-edition.arch"
or "noSolvable"
.
Definition at line 448 of file Solvable.cc.
std::string zypp::sat::Solvable::asUserString | ( | ) | const |
String representation "ident-edition.arch(repo)"
or "noSolvable"
.
Definition at line 457 of file Solvable.cc.
Test whether two Solvables have the same content.
Basically the same name, edition, arch, vendor and buildtime.
Definition at line 467 of file Solvable.cc.
Test for same name-version-release.arch.
Definition at line 210 of file Solvable.h.
Capabilities zypp::sat::Solvable::provides | ( | ) | const |
Definition at line 484 of file Solvable.cc.
Capabilities zypp::sat::Solvable::conflicts | ( | ) | const |
Definition at line 494 of file Solvable.cc.
Capabilities zypp::sat::Solvable::obsoletes | ( | ) | const |
Definition at line 499 of file Solvable.cc.
Capabilities zypp::sat::Solvable::recommends | ( | ) | const |
Definition at line 504 of file Solvable.cc.
Capabilities zypp::sat::Solvable::suggests | ( | ) | const |
Definition at line 509 of file Solvable.cc.
Capabilities zypp::sat::Solvable::enhances | ( | ) | const |
Definition at line 514 of file Solvable.cc.
Capabilities zypp::sat::Solvable::supplements | ( | ) | const |
Definition at line 519 of file Solvable.cc.
Capabilities zypp::sat::Solvable::prerequires | ( | ) | const |
Definition at line 524 of file Solvable.cc.
|
inline |
Return Capabilities selected by Dep constant.
Definition at line 230 of file Solvable.h.
|
inline |
Definition at line 247 of file Solvable.h.
CapabilitySet zypp::sat::Solvable::providesNamespace | ( | const std::string & | namespace_r | ) | const |
Return the namespaced provides 'namespace([value])[ op edition]'
of this Solvable.
Definition at line 533 of file Solvable.cc.
CapabilitySet zypp::sat::Solvable::valuesOfNamespace | ( | const std::string & | namespace_r | ) | const |
Return 'value[ op edition]'
for namespaced provides 'namespace(value)[ op edition]'
.
Similar to providesNamespace, but the namespace is stripped from the dependencies. This is convenient if the namespace denotes packages that should be looked up. E.g. the weakremover
namespace used in a products release package denotes the packages that were dropped from the distribution.
Definition at line 547 of file Solvable.cc.
std::pair< bool, CapabilitySet > zypp::sat::Solvable::matchesSolvable | ( | const SolvAttr & | attr, |
const sat::Solvable & | solv | ||
) | const |
Definition at line 565 of file Solvable.cc.
bool zypp::sat::Solvable::supportsLocales | ( | ) | const |
Whether this Solvable
claims to support locales.
Definition at line 652 of file Solvable.cc.
Whether this Solvable
supports a specific Locale.
Definition at line 658 of file Solvable.cc.
Whether this Solvable
supports at least one of the specified locales.
Definition at line 664 of file Solvable.cc.
bool zypp::sat::Solvable::supportsRequestedLocales | ( | ) | const |
Whether this Solvable
supports at least one requested locale.
Definition at line 672 of file Solvable.cc.
LocaleSet zypp::sat::Solvable::getSupportedLocales | ( | ) | const |
Return the supported locales.
Definition at line 675 of file Solvable.cc.
|
inline |
Definition at line 282 of file Solvable.h.
CpeId zypp::sat::Solvable::cpeId | ( | ) | const |
The solvables CpeId if available.
Definition at line 682 of file Solvable.cc.
unsigned zypp::sat::Solvable::mediaNr | ( | ) | const |
Media number the solvable is located on (0
if no media access required).
Definition at line 688 of file Solvable.cc.
ByteCount zypp::sat::Solvable::installSize | ( | ) | const |
Installed (unpacked) size.
This is just a total number. Many objects provide even more detailed disk usage data. You can use DiskUsageCounter to find out how objects data are distributed across partitions/directories.
Definition at line 701 of file Solvable.cc.
ByteCount zypp::sat::Solvable::downloadSize | ( | ) | const |
Download size.
Definition at line 707 of file Solvable.cc.
std::string zypp::sat::Solvable::distribution | ( | ) | const |
The distribution string.
Definition at line 713 of file Solvable.cc.
Short (singleline) text describing the solvable (opt.
translated).
Definition at line 719 of file Solvable.cc.
Long (multiline) text describing the solvable (opt.
translated).
Definition at line 725 of file Solvable.cc.
UI hint text when selecting the solvable for install (opt.
translated).
Definition at line 731 of file Solvable.cc.
UI hint text when selecting the solvable for uninstall (opt.
translated).
Definition at line 737 of file Solvable.cc.
License or agreement to accept before installing the solvable (opt.
translated).
Definition at line 743 of file Solvable.cc.
bool zypp::sat::Solvable::needToAcceptLicense | ( | ) | const |
True
except for well known exceptions (i.e show license but no need to accept it).
Definition at line 760 of file Solvable.cc.
returns the string attribute value for attr or an empty string if it does not exists.
Definition at line 130 of file Solvable.cc.
std::string zypp::sat::Solvable::lookupStrAttribute | ( | const SolvAttr & | attr, |
const Locale & | lang_r | ||
) | const |
Definition at line 137 of file Solvable.cc.
returns the numeric attribute value for attr or 0 if it does not exists.
Definition at line 158 of file Solvable.cc.
unsigned long long zypp::sat::Solvable::lookupNumAttribute | ( | const SolvAttr & | attr, |
unsigned long long | notfound_r | ||
) | const |
Definition at line 164 of file Solvable.cc.
returns the boolean attribute value for attr or false
if it does not exists.
Definition at line 170 of file Solvable.cc.
detail::IdType zypp::sat::Solvable::lookupIdAttribute | ( | const SolvAttr & | attr | ) | const |
returns the id attribute value for attr or detail::noId if it does not exists.
Definition at line 176 of file Solvable.cc.
returns the CheckSum attribute value for attr or an empty CheckSum if ir does not exist.
Definition at line 182 of file Solvable.cc.
OnMediaLocation zypp::sat::Solvable::lookupLocation | ( | ) | const |
returns OnMediaLocation data: This is everything we need to download e.g.
an rpm (path, checksum, downloadsize, etc.).
Definition at line 224 of file Solvable.cc.
Solvable zypp::sat::Solvable::nextInPool | ( | ) | const |
Return next Solvable in Pool (or noSolvable).
Definition at line 113 of file Solvable.cc.
Solvable zypp::sat::Solvable::nextInRepo | ( | ) | const |
Return next Solvable in Repo (or noSolvable).
Definition at line 116 of file Solvable.cc.
detail::CSolvable * zypp::sat::Solvable::get | ( | ) | const |
Expert backdoor.
Definition at line 106 of file Solvable.cc.
|
inline |
Expert backdoor.
Definition at line 428 of file Solvable.h.
Stream output.
Definition at line 776 of file Solvable.cc.
More verbose stream output including dependencies.
Definition at line 787 of file Solvable.cc.
XML output.
Definition at line 807 of file Solvable.cc.
Definition at line 445 of file Solvable.h.
Definition at line 449 of file Solvable.h.
Definition at line 453 of file Solvable.h.
Test whether a Solvable is of a certain Kind.
Definition at line 458 of file Solvable.h.
Test for same content.
Definition at line 462 of file Solvable.h.
Test for same name version release and arch.
Definition at line 466 of file Solvable.h.
Compare according to kind and name.
Definition at line 471 of file Solvable.h.
Compare according to kind, name and edition.
Definition at line 483 of file Solvable.h.
Compare according to kind, name, edition and arch.
Definition at line 492 of file Solvable.h.
Indicator provides retracted-patch-package()
Definition at line 58 of file Solvable.h.
Indicator provides ptf()
Definition at line 59 of file Solvable.h.
Indicator provides ptf-package()
Definition at line 60 of file Solvable.h.
Represents no Solvable.
Definition at line 75 of file Solvable.h.
Capabilities zypp::sat::Solvable::const |
Definition at line 220 of file Solvable.h.
|
private |
Definition at line 431 of file Solvable.h.