libzypp 17.37.17
zypp::RepoInfo Class Reference

What is known about a repository. More...

#include <zypp/RepoInfo.h>

Inheritance diagram for zypp::RepoInfo:

Classes

struct  Impl
 RepoInfo implementation. More...

Public Types

using url_set = std::list<Url>
using urls_size_type = url_set::size_type
using urls_const_iterator = transform_iterator<repo::RepoVariablesUrlReplacer, url_set::const_iterator>

Public Member Functions

 RepoInfo ()
 ~RepoInfo () override
 RepoInfo (const RepoInfo &)=default
 RepoInfo (RepoInfo &&)=default
RepoInfooperator= (const RepoInfo &)=default
RepoInfooperator= (RepoInfo &&)=default
unsigned priority () const
 Repository priority for solver.
void setPriority (unsigned newval_r)
 Set repository priority for solver.
bool baseUrlsEmpty () const
 whether repository urls are available
bool baseUrlSet () const
 Whether there are manualy configured repository urls.
urls_size_type baseUrlsSize () const
 number of repository urls
urls_const_iterator baseUrlsBegin () const
 iterator that points at begin of repository urls
urls_const_iterator baseUrlsEnd () const
 iterator that points at end of repository urls
Url url () const
 Pars pro toto: The first repository url, this is either baseUrls().front() or if no baseUrl is defined the first available mirror.
Url rawUrl () const
 Pars pro toto: The first repository raw url (no variables replaced) this is either rawBaseUrls().front() or if no baseUrl is defined the first available mirror.
Url location () const
 Returns the location URL for the repository, this is either the first configured baseUrl or a configured mirror or metalink URL.
url_set baseUrls () const
 The complete set of repository urls as configured.
url_set rawBaseUrls () const
 The complete set of raw repository urls (no variables replaced)
void addBaseUrl (Url url)
 Add a base url.
void setBaseUrl (Url url)
 Clears current base URL list and adds url.
void setBaseUrls (url_set urls)
 Clears current base URL list and adds an url_set.
MirroredOriginSet repoOrigins () const
 The repodata origins.
bool repoOriginsEmpty () const
 whether repo origins are available
Pathname path () const
 Repository path.
void setPath (const Pathname &path)
 set the product path.
Url mirrorListUrl () const
 Url of a file which contains a list of repository urls.
Url rawMirrorListUrl () const
 The raw mirrorListUrl (no variables replaced).
void setMirrorlistUrl (const Url &url)
 Set the raw mirrorlist url.
void setMetalinkUrl (const Url &url)
 Set the raw metalink url.
Url rawCfgMirrorlistUrl () const
 The configured raw mirrorlist url.
Url rawCfgMetalinkUrl () const
 The configured raw metalink url.
repo::RepoType type () const
 Type of repository,.
void setProbedType (const repo::RepoType &t) const
 This allows to adjust the RepoType lazy, from NONE to some probed value, even for const objects.
void setType (const repo::RepoType &t)
 set the repository type
Pathname metadataPath () const
 Path where this repo metadata was read from.
void setMetadataPath (const Pathname &path)
 Set the path where the local metadata is stored.
bool usesAutoMetadataPaths () const
 Whether metadataPath uses AUTO% setup.
Pathname packagesPath () const
 Path where this repo packages are cached.
void setPackagesPath (const Pathname &path)
 set the path where the local packages are stored
Pathname predownloadPath () const
 Path where this repo packages are predownloaded.
Public Member Functions inherited from zypp::repo::RepoInfoBase
 RepoInfoBase ()
 RepoInfoBase (const std::string &alias)
virtual ~RepoInfoBase ()
 RepoInfoBase (const RepoInfoBase &)=default
 RepoInfoBase (RepoInfoBase &&) noexcept=default
RepoInfoBaseoperator= (const RepoInfoBase &)=default
RepoInfoBaseoperator= (RepoInfoBase &&) noexcept=default
std::string alias () const
 unique identifier for this source.
std::string escaped_alias () const
 Same as alias(), just escaped in a way to be a valid file name.
std::string name () const
 Repository name.
std::string rawName () const
 The raw metadata name (no default, no variables replaced).
std::string label () const
 Label for use in messages for the user interface.
std::string asUserString () const
 User string: label (alias or name)
bool enabled () const
 If enabled is false, then this repository must be ignored as if does not exists, except when checking for duplicate alias.
bool autorefresh () const
 If true, the repostory must be refreshed before creating resolvables from it.
Pathname filepath () const
 File where this repo was read from.
void setAlias (const std::string &alias)
 set the repository alias
void setName (const std::string &name)
 set the repository name
void setEnabled (bool enabled)
 enable or disable the repository
void setAutorefresh (bool autorefresh)
 enable or disable autorefresh
void setFilepath (const Pathname &filename)
 set the path to the .repo file

Static Public Member Functions

static unsigned defaultPriority ()
 The default priority (99).
static unsigned noPriority ()
 The least priority (unsigned(-1)).

Static Public Attributes

static const RepoInfo noRepo
 Represents no Repository (one with an empty alias).

Friends

std::ostream & operator<< (std::ostream &str, const RepoInfo &obj)

(Note that these are not member symbols.)

using RepoInfo_Ptr = shared_ptr<RepoInfo>
using RepoInfo_constPtr = shared_ptr<const RepoInfo>
using RepoInfoList = std::list<RepoInfo>
std::ostream & operator<< (std::ostream &str, const RepoInfo::Impl &obj)
 Stream output.
std::ostream & operator<< (std::ostream &str, const RepoInfo &obj) ZYPP_API
 Stream output.

Repository gpgchecks

How signature checking should be performed for this repo.

The values are computed based in the settings of gpgcheck, repo_gpgcheck end pkg_gpgcheck in zypp.conf. Explicitly setting these values in the repositories .repo file will overwrite the defaults from zypp.conf for this repo.

If gpgcheck is on (the default) we will check the signature of repo metadata (packages are secured via checksum inside the metadata). Using unsigned repos needs to be confirmed. Packages from signed repos are accepted if their checksum matches the checksum stated in the repo metadata. Packages from unsigned repos need a valid gpg signature, using unsigned packages needs to be confirmed.

The above default behavior can be tuned by explicitly setting repo_gpgcheck and/or pkg_gpgcheck:

repo_gpgcheck = on same as the default.

repo_gpgcheck = off will silently accept unsigned repos. It will NOT turn of signature checking on the whole. Nevertheless, it's not a secure setting.

pkg_gpgcheck = on will enforce the package signature checking and the need to confirm unsigned packages for all repos (signed and unsigned).

pkg_gpgcheck = off will silently accept unsigned packages. It will NOT turn of signature checking on the whole. Nevertheless, it's not a secure setting.

If gpgCheck is off (not recommneded), no checks are performed. You can still enable them individually by setting repo_gpgcheck and/or pkg_gpgcheck to on.

R: check repo signature is mandatory, confirm unsigned repos
r: check repo signature, unsigned repos are ok but enforce p
: do not check repo signatures
P: check package signature always, confirm unsigned packages
p: like P for unsigned repos, accepted by checksum for signed repos
b: like p but accept unsigned packages
: do not check package signatures
pkg_
gpgcheck 1| * 0 1
------------------------------------
repo_ *1| R/p R/b R/P
0| r/p r/b r/P
pkg_
gpgcheck 0| * 0 1
------------------------------------
repo_ *0| P
1| R R R/P
enum class  GpgCheck {
  indeterminate , On , Strict , AllowUnsigned ,
  AllowUnsignedRepo , AllowUnsignedPackage , Default , Off
}
 Some predefined settings. More...
bool gpgCheck () const
 Whether default signature checking should be performed.
void setGpgCheck (TriBool value_r)
 Set the value for gpgCheck (or indeterminate to use the default).
void setGpgCheck (bool value_r)
bool repoGpgCheck () const
 Whether the signature of repo metadata should be checked for this repo.
bool repoGpgCheckIsMandatory () const
 Mandatory check (repoGpgCheck is on) must ask to confirm using unsigned repos.
void setRepoGpgCheck (TriBool value_r)
 Set the value for repoGpgCheck (or indeterminate to use the default).
bool pkgGpgCheck () const
 Whether the signature of rpm packages should be checked for this repo.
bool pkgGpgCheckIsMandatory () const
 Mandatory check (pkgGpgCheck is not off) must ask to confirm using unsigned packages.
void setPkgGpgCheck (TriBool value_r)
 Set the value for pkgGpgCheck (or indeterminate to use the default).
TriBool validRepoSignature () const
 Whether the repo metadata are signed and successfully validated or indeterminate if unsigned.
void setValidRepoSignature (TriBool value_r)
 Set the value for validRepoSignature (or indeterminate if unsigned).
bool setGpgCheck (GpgCheck mode_r)
 Adjust *GpgCheck settings according to mode_r.
bool gpgKeyUrlsEmpty () const
 Whether gpgkey URLs are defined.
urls_size_type gpgKeyUrlsSize () const
 Number of gpgkey URLs defined.
url_set gpgKeyUrls () const
 The list of gpgkey URLs defined for this repo.
url_set rawGpgKeyUrls () const
 The list of raw gpgkey URLs defined for this repo (no variables replaced)
void setGpgKeyUrls (url_set urls)
 Set a list of gpgkey URLs defined for this repo.
Url gpgKeyUrl () const
 (leagcy API) The 1st gpgkey URL defined for this repo
Url rawGpgKeyUrl () const
 (leagcy API) The 1st raw gpgkey URL defined for this repo (no variables replaced)
void setGpgKeyUrl (const Url &gpgkey)
 (leagcy API) Set the gpgkey URL defined for this repo
bool keepPackages () const
 Whether packages downloaded from this repository will be kept in local cache.
void setKeepPackages (bool keep)
 Set if packaqes downloaded from this repository will be kept in local cache.
bool effectiveKeepPackages () const
 keepPackages unless the package cache itself enforces keeping the packages.
std::string service () const
 Gets name of the service to which this repository belongs or empty string if it has been added manually.
void setService (const std::string &name)
 sets service which added this repository
std::string targetDistribution () const
 Distribution for which is this repository meant.
void setTargetDistribution (const std::string &targetDistribution)
 Sets the distribution for which is this repository meant.
const std::set< std::string > & contentKeywords () const
 Content keywords defined.
void addContent (const std::string &keyword_r)
 Add content keywords.
template<class TIterator>
void addContentFrom (TIterator begin_r, TIterator end_r)
template<class TContainer>
void addContentFrom (const TContainer &container_r)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

bool hasContent () const
 Check for content keywords.
bool hasContent (const std::string &keyword_r) const
template<class TIterator>
bool hasContentAll (TIterator begin_r, TIterator end_r) const
template<class TContainer>
bool hasContentAll (const TContainer &container_r) 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 hasContentAny (TIterator begin_r, TIterator end_r) const
template<class TContainer>
bool hasContentAny (const TContainer &container_r) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Repository/Product license

In case a repository provides multiple license tarballs in repomd.xml

<data type="license">...</data>
<data type="license-sles">...</data>
<data type="license-sled">...</data>
repo::RepoType type() const
Type of repository,.
Definition RepoInfo.cc:750

you can address the individual licenses by passing their name (e.g. "sles" to access the type="license-sles"). No on an empty name will refer to type="license".

class RepoManager
RWCOW_pointer< Impl_pimpl
 Pointer to implementation.
bool hasLicense () const
 Whether there is a license associated with the repo.
bool hasLicense (const std::string &name_r) const
bool needToAcceptLicense () const
 Whether the repo license has to be accepted, e.g.
bool needToAcceptLicense (const std::string &name_r) const
std::string getLicense (const Locale &lang_r=Locale()) const
 Return the best license for the current (or a specified) locale.
std::string getLicense (const Locale &lang_r=Locale())
std::string getLicense (const std::string &name_r, const Locale &lang_r=Locale()) const
LocaleSet getLicenseLocales () const
 Return the locales the license is available for.
LocaleSet getLicenseLocales (const std::string &name_r) const
bool requireStatusWithMediaFile () const
 Returns true if this repository requires the media.1/media file to be included in the metadata status and repo status calculations.
std::ostream & dumpOn (std::ostream &str) const override
 Write a human-readable representation of this RepoInfo object into the str stream.
std::ostream & dumpAsIniOn (std::ostream &str) const override
 Write this RepoInfo object into str in a .repo file format.
std::ostream & dumpAsXmlOn (std::ostream &str, const std::string &content="") const override
 Write an XML representation of this RepoInfo object.
void getRawGpgChecks (TriBool &g_r, TriBool &r_r, TriBool &p_r) const
 Raw values for RepoManager.
std::string repoStatusString () const
 A string value to track changes requiring a refresh.

Detailed Description

What is known about a repository.

The class RepoInfo represents everything that is known about a software repository.

It can be used to store information about known sources.

This class tries to be compatible with the concept of a .repo file used by YUM and also available in the openSUSE build service. See man yum.conf.

Example file

[ruby]
name=Ruby repository (openSUSE_10.2)
type=rpm-md
baseurl=http://software.opensuse.org/download/ruby/openSUSE_10.2/
http://some.opensuse.mirror/ruby/openSUSE_10.2/
gpgcheck=1
gpgkey=http://software.opensuse.org/openSUSE-Build-Service.asc
unsigned priority() const
Repository priority for solver.
Definition RepoInfo.cc:517
std::string name() const
Repository name.
bool enabled() const
If enabled is false, then this repository must be ignored as if does not exists, except when checking...
Note
A RepoInfo is a hint about how to create a Repository.
Name, baseUrls and mirrorUrl are subject to repo variable replacement (
See also
RepoVariablesStringReplacer).

Definition at line 71 of file RepoInfo.h.

Member Typedef Documentation

◆ url_set

using zypp::RepoInfo::url_set = std::list<Url>

Definition at line 108 of file RepoInfo.h.

◆ urls_size_type

using zypp::RepoInfo::urls_size_type = url_set::size_type

Definition at line 109 of file RepoInfo.h.

◆ urls_const_iterator

Definition at line 110 of file RepoInfo.h.

Member Enumeration Documentation

◆ GpgCheck

enum class zypp::RepoInfo::GpgCheck
strong

Some predefined settings.

Enumerator
indeterminate 
On 
Strict 
AllowUnsigned 
AllowUnsignedRepo 
AllowUnsignedPackage 
Default 
Off 

Definition at line 412 of file RepoInfo.h.

Constructor & Destructor Documentation

◆ RepoInfo() [1/3]

zypp::RepoInfo::RepoInfo ( )

Definition at line 510 of file RepoInfo.cc.

◆ ~RepoInfo()

zypp::RepoInfo::~RepoInfo ( )
override

Definition at line 514 of file RepoInfo.cc.

◆ RepoInfo() [2/3]

zypp::RepoInfo::RepoInfo ( const RepoInfo & )
default

◆ RepoInfo() [3/3]

zypp::RepoInfo::RepoInfo ( RepoInfo && )
default

Member Function Documentation

◆ operator=() [1/2]

RepoInfo & zypp::RepoInfo::operator= ( const RepoInfo & )
default

◆ operator=() [2/2]

RepoInfo & zypp::RepoInfo::operator= ( RepoInfo && )
default

◆ defaultPriority()

unsigned zypp::RepoInfo::defaultPriority ( )
static

The default priority (99).

Definition at line 520 of file RepoInfo.cc.

◆ noPriority()

unsigned zypp::RepoInfo::noPriority ( )
static

The least priority (unsigned(-1)).

Definition at line 523 of file RepoInfo.cc.

◆ priority()

unsigned zypp::RepoInfo::priority ( ) const

Repository priority for solver.

Some number between 1 (highest priority) and 99 (defaultPriority).

Definition at line 517 of file RepoInfo.cc.

◆ setPriority()

void zypp::RepoInfo::setPriority ( unsigned newval_r)

Set repository priority for solver.

A newval_r of 0 sets the default priority.

See also
priority.

Definition at line 526 of file RepoInfo.cc.

◆ baseUrlsEmpty()

bool zypp::RepoInfo::baseUrlsEmpty ( ) const

whether repository urls are available

Definition at line 807 of file RepoInfo.cc.

◆ baseUrlSet()

bool zypp::RepoInfo::baseUrlSet ( ) const

Whether there are manualy configured repository urls.

If false, a mirrorlist might be used.

Definition at line 810 of file RepoInfo.cc.

◆ baseUrlsSize()

RepoInfo::urls_size_type zypp::RepoInfo::baseUrlsSize ( ) const

number of repository urls

Definition at line 804 of file RepoInfo.cc.

◆ baseUrlsBegin()

RepoInfo::urls_const_iterator zypp::RepoInfo::baseUrlsBegin ( ) const

iterator that points at begin of repository urls

Definition at line 798 of file RepoInfo.cc.

◆ baseUrlsEnd()

RepoInfo::urls_const_iterator zypp::RepoInfo::baseUrlsEnd ( ) const

iterator that points at end of repository urls

Definition at line 801 of file RepoInfo.cc.

◆ url()

Url zypp::RepoInfo::url ( ) const

Pars pro toto: The first repository url, this is either baseUrls().front() or if no baseUrl is defined the first available mirror.

Definition at line 813 of file RepoInfo.cc.

◆ rawUrl()

Url zypp::RepoInfo::rawUrl ( ) const

Pars pro toto: The first repository raw url (no variables replaced) this is either rawBaseUrls().front() or if no baseUrl is defined the first available mirror.

Definition at line 792 of file RepoInfo.cc.

◆ location()

Url zypp::RepoInfo::location ( ) const

Returns the location URL for the repository, this is either the first configured baseUrl or a configured mirror or metalink URL.

Use this if you need to display a repo URL to the user.

Definition at line 795 of file RepoInfo.cc.

◆ baseUrls()

RepoInfo::url_set zypp::RepoInfo::baseUrls ( ) const

The complete set of repository urls as configured.

Definition at line 777 of file RepoInfo.cc.

◆ rawBaseUrls()

RepoInfo::url_set zypp::RepoInfo::rawBaseUrls ( ) const

The complete set of raw repository urls (no variables replaced)

Definition at line 780 of file RepoInfo.cc.

◆ addBaseUrl()

void zypp::RepoInfo::addBaseUrl ( Url url)

Add a base url.

See also
baseUrls
Parameters
urlThe base url for the repository.

To recreate the base URLs list, use setBaseUrl(const Url &) followed by addBaseUrl().

Definition at line 674 of file RepoInfo.cc.

◆ setBaseUrl()

void zypp::RepoInfo::setBaseUrl ( Url url)

Clears current base URL list and adds url.

Definition at line 684 of file RepoInfo.cc.

◆ setBaseUrls()

void zypp::RepoInfo::setBaseUrls ( url_set urls)

Clears current base URL list and adds an url_set.

Definition at line 691 of file RepoInfo.cc.

◆ repoOrigins()

MirroredOriginSet zypp::RepoInfo::repoOrigins ( ) const

The repodata origins.

These are either the configured baseurls including the downloaded mirror list (

See also
mirrorListUrl) or meta link urls.

Also if there is just one baseUrl pointing to a well known opensuse server it might contain additional mirrors requested from the server on demand

Definition at line 697 of file RepoInfo.cc.

◆ repoOriginsEmpty()

bool zypp::RepoInfo::repoOriginsEmpty ( ) const

whether repo origins are available

Definition at line 702 of file RepoInfo.cc.

◆ path()

Pathname zypp::RepoInfo::path ( ) const

Repository path.

Pathname relative to the base Url where the product/repository is located

For media containing more than one product, or repositories not located at the root of the media it is important to know the path to the product directory relative to the media root. So a media verifier can be set for that media. You may also read it as baseUrl = url to mount and path = path on the mounted media.

It is not mandatory, and the default is /.

Note
As a repository can have multiple Urls, the path is unique and the same for all Urls, so it is assumed all the Urls have the same media layout.

Definition at line 783 of file RepoInfo.cc.

◆ setPath()

void zypp::RepoInfo::setPath ( const Pathname & path)

set the product path.

See also
path()
Parameters
paththe path to the product

Definition at line 707 of file RepoInfo.cc.

◆ mirrorListUrl()

Url zypp::RepoInfo::mirrorListUrl ( ) const

Url of a file which contains a list of repository urls.

This is either the configured mirrorlist or metalink Url.

Definition at line 753 of file RepoInfo.cc.

◆ rawMirrorListUrl()

Url zypp::RepoInfo::rawMirrorListUrl ( ) const

The raw mirrorListUrl (no variables replaced).

This is either the configured mirrorlist or metalink Url.

Definition at line 756 of file RepoInfo.cc.

◆ setMirrorlistUrl()

void zypp::RepoInfo::setMirrorlistUrl ( const Url & url)

Set the raw mirrorlist url.

Definition at line 641 of file RepoInfo.cc.

◆ setMetalinkUrl()

void zypp::RepoInfo::setMetalinkUrl ( const Url & url)

Set the raw metalink url.

Definition at line 644 of file RepoInfo.cc.

◆ rawCfgMirrorlistUrl()

Url zypp::RepoInfo::rawCfgMirrorlistUrl ( ) const

The configured raw mirrorlist url.

Definition at line 647 of file RepoInfo.cc.

◆ rawCfgMetalinkUrl()

Url zypp::RepoInfo::rawCfgMetalinkUrl ( ) const

The configured raw metalink url.

Definition at line 650 of file RepoInfo.cc.

◆ type()

repo::RepoType zypp::RepoInfo::type ( ) const

Type of repository,.

Definition at line 750 of file RepoInfo.cc.

◆ setProbedType()

void zypp::RepoInfo::setProbedType ( const repo::RepoType & t) const

This allows to adjust the RepoType lazy, from NONE to some probed value, even for const objects.

This is a NOOP if the current type is not NONE.

Definition at line 713 of file RepoInfo.cc.

◆ setType()

void zypp::RepoInfo::setType ( const repo::RepoType & t)

set the repository type

See also
type
Parameters
t

Definition at line 710 of file RepoInfo.cc.

◆ metadataPath()

Pathname zypp::RepoInfo::metadataPath ( ) const

Path where this repo metadata was read from.

Note
could be an empty pathname for repo infos created in memory.

Definition at line 741 of file RepoInfo.cc.

◆ setMetadataPath()

void zypp::RepoInfo::setMetadataPath ( const Pathname & path)

Set the path where the local metadata is stored.

The path to the repositories metadata is usually provided by the RepoManager. If you want to use a temporary repository (not under RepoManagers control), and you set a metadataPath with basename AUTO%, all data directories (raw metadata, solv file and package cache) will be created by replacing AUTO% with RAW%, SLV% or PKG% . This will change the value of packagesPath accordingly, unless you assigned a custom value using setPackagesPath.

repo.setAlias( "Temp" );
repo.setBaseUrl( Url("http://someserver/somepath/") );
repo.setMetadataPath( "/tmp/temprepodata/%AUTO%" );
// will use
// /tmp/temprepodata/%RAW% - raw metadata
// /%SLV% - solv file
// /%PKG% - packages
Url manipulation class.
Definition Url.h:93
Parameters
pathdirectory path

Definition at line 717 of file RepoInfo.cc.

◆ usesAutoMetadataPaths()

bool zypp::RepoInfo::usesAutoMetadataPaths ( ) const

Whether metadataPath uses AUTO% setup.

Definition at line 747 of file RepoInfo.cc.

◆ packagesPath()

Pathname zypp::RepoInfo::packagesPath ( ) const

Path where this repo packages are cached.

Definition at line 744 of file RepoInfo.cc.

◆ setPackagesPath()

void zypp::RepoInfo::setPackagesPath ( const Pathname & path)

set the path where the local packages are stored

Parameters
pathdirectory path

Definition at line 720 of file RepoInfo.cc.

◆ predownloadPath()

Pathname zypp::RepoInfo::predownloadPath ( ) const

Path where this repo packages are predownloaded.

Definition at line 723 of file RepoInfo.cc.

◆ gpgCheck()

bool zypp::RepoInfo::gpgCheck ( ) const

Whether default signature checking should be performed.

Definition at line 530 of file RepoInfo.cc.

◆ setGpgCheck() [1/3]

void zypp::RepoInfo::setGpgCheck ( TriBool value_r)

Set the value for gpgCheck (or indeterminate to use the default).

Definition at line 533 of file RepoInfo.cc.

◆ setGpgCheck() [2/3]

void zypp::RepoInfo::setGpgCheck ( bool value_r)

Definition at line 536 of file RepoInfo.cc.

◆ repoGpgCheck()

bool zypp::RepoInfo::repoGpgCheck ( ) const

Whether the signature of repo metadata should be checked for this repo.

Definition at line 540 of file RepoInfo.cc.

◆ repoGpgCheckIsMandatory()

bool zypp::RepoInfo::repoGpgCheckIsMandatory ( ) const

Mandatory check (repoGpgCheck is on) must ask to confirm using unsigned repos.

Definition at line 543 of file RepoInfo.cc.

◆ setRepoGpgCheck()

void zypp::RepoInfo::setRepoGpgCheck ( TriBool value_r)

Set the value for repoGpgCheck (or indeterminate to use the default).

Definition at line 551 of file RepoInfo.cc.

◆ pkgGpgCheck()

bool zypp::RepoInfo::pkgGpgCheck ( ) const

Whether the signature of rpm packages should be checked for this repo.

Definition at line 555 of file RepoInfo.cc.

◆ pkgGpgCheckIsMandatory()

bool zypp::RepoInfo::pkgGpgCheckIsMandatory ( ) const

Mandatory check (pkgGpgCheck is not off) must ask to confirm using unsigned packages.

Definition at line 558 of file RepoInfo.cc.

◆ setPkgGpgCheck()

void zypp::RepoInfo::setPkgGpgCheck ( TriBool value_r)

Set the value for pkgGpgCheck (or indeterminate to use the default).

Definition at line 561 of file RepoInfo.cc.

◆ validRepoSignature()

TriBool zypp::RepoInfo::validRepoSignature ( ) const

Whether the repo metadata are signed and successfully validated or indeterminate if unsigned.

The value is usually set by repo::Downloader when retrieving the metadata.

Definition at line 573 of file RepoInfo.cc.

◆ setValidRepoSignature()

void zypp::RepoInfo::setValidRepoSignature ( TriBool value_r)

Set the value for validRepoSignature (or indeterminate if unsigned).

Definition at line 580 of file RepoInfo.cc.

◆ setGpgCheck() [3/3]

bool zypp::RepoInfo::setGpgCheck ( GpgCheck mode_r)

Adjust *GpgCheck settings according to mode_r.

GpgCheck::indeterminate will leave the settings as they are.

Returns
whether setting were changed

Definition at line 599 of file RepoInfo.cc.

◆ gpgKeyUrlsEmpty()

bool zypp::RepoInfo::gpgKeyUrlsEmpty ( ) const

Whether gpgkey URLs are defined.

Definition at line 759 of file RepoInfo.cc.

◆ gpgKeyUrlsSize()

RepoInfo::urls_size_type zypp::RepoInfo::gpgKeyUrlsSize ( ) const

Number of gpgkey URLs defined.

Definition at line 762 of file RepoInfo.cc.

◆ gpgKeyUrls()

RepoInfo::url_set zypp::RepoInfo::gpgKeyUrls ( ) const

The list of gpgkey URLs defined for this repo.

Definition at line 765 of file RepoInfo.cc.

◆ rawGpgKeyUrls()

RepoInfo::url_set zypp::RepoInfo::rawGpgKeyUrls ( ) const

The list of raw gpgkey URLs defined for this repo (no variables replaced)

Definition at line 768 of file RepoInfo.cc.

◆ setGpgKeyUrls()

void zypp::RepoInfo::setGpgKeyUrls ( url_set urls)

Set a list of gpgkey URLs defined for this repo.

Definition at line 662 of file RepoInfo.cc.

◆ gpgKeyUrl()

Url zypp::RepoInfo::gpgKeyUrl ( ) const

(leagcy API) The 1st gpgkey URL defined for this repo

Definition at line 771 of file RepoInfo.cc.

◆ rawGpgKeyUrl()

Url zypp::RepoInfo::rawGpgKeyUrl ( ) const

(leagcy API) The 1st raw gpgkey URL defined for this repo (no variables replaced)

Definition at line 774 of file RepoInfo.cc.

◆ setGpgKeyUrl()

void zypp::RepoInfo::setGpgKeyUrl ( const Url & gpgkey)

(leagcy API) Set the gpgkey URL defined for this repo

Definition at line 665 of file RepoInfo.cc.

◆ keepPackages()

bool zypp::RepoInfo::keepPackages ( ) const

Whether packages downloaded from this repository will be kept in local cache.

Definition at line 735 of file RepoInfo.cc.

◆ setKeepPackages()

void zypp::RepoInfo::setKeepPackages ( bool keep)

Set if packaqes downloaded from this repository will be kept in local cache.

If the setting is true, all downloaded packages from this repository will be copied to the local raw cache.

Parameters
keeptrue (keep the downloaded packages) or false (delete them after installation)

Definition at line 726 of file RepoInfo.cc.

◆ effectiveKeepPackages()

bool zypp::RepoInfo::effectiveKeepPackages ( ) const

keepPackages unless the package cache itself enforces keeping the packages.

This can be done by creating a file named .keep_packages in the package cache's toplevel directory (e.g. /var/cache/zypp/packages/.keep_packages)

Definition at line 738 of file RepoInfo.cc.

◆ service()

std::string zypp::RepoInfo::service ( ) const

Gets name of the service to which this repository belongs or empty string if it has been added manually.

Definition at line 786 of file RepoInfo.cc.

◆ setService()

void zypp::RepoInfo::setService ( const std::string & name)

sets service which added this repository

Definition at line 729 of file RepoInfo.cc.

◆ targetDistribution()

std::string zypp::RepoInfo::targetDistribution ( ) const

Distribution for which is this repository meant.

Definition at line 789 of file RepoInfo.cc.

◆ setTargetDistribution()

void zypp::RepoInfo::setTargetDistribution ( const std::string & targetDistribution)

Sets the distribution for which is this repository meant.

This is an in-memory value only, does not get written to the .repo file upon saving.

Definition at line 732 of file RepoInfo.cc.

◆ contentKeywords()

const std::set< std::string > & zypp::RepoInfo::contentKeywords ( ) const

Content keywords defined.

Definition at line 818 of file RepoInfo.cc.

◆ addContent()

void zypp::RepoInfo::addContent ( const std::string & keyword_r)

Add content keywords.

Definition at line 821 of file RepoInfo.cc.

◆ addContentFrom() [1/2]

template<class TIterator>
void zypp::RepoInfo::addContentFrom ( TIterator begin_r,
TIterator end_r )
inline

Definition at line 500 of file RepoInfo.h.

◆ addContentFrom() [2/2]

template<class TContainer>
void zypp::RepoInfo::addContentFrom ( const TContainer & container_r)
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 504 of file RepoInfo.h.

◆ hasContent() [1/2]

bool zypp::RepoInfo::hasContent ( ) const

Check for content keywords.

They may be missing due to missing metadata in disabled repos.

Definition at line 824 of file RepoInfo.cc.

◆ hasContent() [2/2]

bool zypp::RepoInfo::hasContent ( const std::string & keyword_r) const

Definition at line 827 of file RepoInfo.cc.

◆ hasContentAll() [1/2]

template<class TIterator>
bool zypp::RepoInfo::hasContentAll ( TIterator begin_r,
TIterator end_r ) const
inline

Definition at line 515 of file RepoInfo.h.

◆ hasContentAll() [2/2]

template<class TContainer>
bool zypp::RepoInfo::hasContentAll ( const TContainer & container_r) const
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 519 of file RepoInfo.h.

◆ hasContentAny() [1/2]

template<class TIterator>
bool zypp::RepoInfo::hasContentAny ( TIterator begin_r,
TIterator end_r ) const
inline

Definition at line 523 of file RepoInfo.h.

◆ hasContentAny() [2/2]

template<class TContainer>
bool zypp::RepoInfo::hasContentAny ( const TContainer & container_r) const
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 527 of file RepoInfo.h.

◆ hasLicense() [1/2]

bool zypp::RepoInfo::hasLicense ( ) const

Whether there is a license associated with the repo.

Definition at line 832 of file RepoInfo.cc.

◆ hasLicense() [2/2]

bool zypp::RepoInfo::hasLicense ( const std::string & name_r) const

Definition at line 835 of file RepoInfo.cc.

◆ needToAcceptLicense() [1/2]

bool zypp::RepoInfo::needToAcceptLicense ( ) const

Whether the repo license has to be accepted, e.g.

there is no no acceptance needed for openSUSE.

Definition at line 839 of file RepoInfo.cc.

◆ needToAcceptLicense() [2/2]

bool zypp::RepoInfo::needToAcceptLicense ( const std::string & name_r) const

Definition at line 842 of file RepoInfo.cc.

◆ getLicense() [1/3]

std::string zypp::RepoInfo::getLicense ( const Locale & lang_r = Locale()) const

Return the best license for the current (or a specified) locale.

Definition at line 874 of file RepoInfo.cc.

◆ getLicense() [2/3]

std::string zypp::RepoInfo::getLicense ( const Locale & lang_r = Locale())

Definition at line 871 of file RepoInfo.cc.

◆ getLicense() [3/3]

std::string zypp::RepoInfo::getLicense ( const std::string & name_r,
const Locale & lang_r = Locale() ) const

Definition at line 877 of file RepoInfo.cc.

◆ getLicenseLocales() [1/2]

LocaleSet zypp::RepoInfo::getLicenseLocales ( ) const

Return the locales the license is available for.

Locale::noCode is included in case of license.txt which does not specify a specific locale.

Definition at line 918 of file RepoInfo.cc.

◆ getLicenseLocales() [2/2]

LocaleSet zypp::RepoInfo::getLicenseLocales ( const std::string & name_r) const

Definition at line 921 of file RepoInfo.cc.

◆ requireStatusWithMediaFile()

bool zypp::RepoInfo::requireStatusWithMediaFile ( ) const

Returns true if this repository requires the media.1/media file to be included in the metadata status and repo status calculations.

Definition at line 1131 of file RepoInfo.cc.

◆ dumpOn()

std::ostream & zypp::RepoInfo::dumpOn ( std::ostream & str) const
overridevirtual

Write a human-readable representation of this RepoInfo object into the str stream.

Useful for logging.

Reimplemented from zypp::repo::RepoInfoBase.

Definition at line 954 of file RepoInfo.cc.

◆ dumpAsIniOn()

std::ostream & zypp::RepoInfo::dumpAsIniOn ( std::ostream & str) const
overridevirtual

Write this RepoInfo object into str in a .repo file format.

Raw values, no variable replacement.

Reimplemented from zypp::repo::RepoInfoBase.

Definition at line 1003 of file RepoInfo.cc.

◆ dumpAsXmlOn()

std::ostream & zypp::RepoInfo::dumpAsXmlOn ( std::ostream & str,
const std::string & content = "" ) const
overridevirtual

Write an XML representation of this RepoInfo object.

Repo variables replaced.

Parameters
str
contentthis argument is ignored (used in other classed derived from RepoInfoBase.

Reimplemented from zypp::repo::RepoInfoBase.

Definition at line 1067 of file RepoInfo.cc.

◆ getRawGpgChecks()

void zypp::RepoInfo::getRawGpgChecks ( TriBool & g_r,
TriBool & r_r,
TriBool & p_r ) const

Raw values for RepoManager.

Definition at line 565 of file RepoInfo.cc.

◆ repoStatusString()

std::string zypp::RepoInfo::repoStatusString ( ) const

A string value to track changes requiring a refresh.

The strings value is arbitrary but it should change if the repositories URL changes.

Definition at line 671 of file RepoInfo.cc.

◆ RepoInfo_Ptr

using RepoInfo_Ptr = shared_ptr<RepoInfo>
related

Definition at line 622 of file RepoInfo.h.

◆ RepoInfo_constPtr

using RepoInfo_constPtr = shared_ptr<const RepoInfo>
related

Definition at line 624 of file RepoInfo.h.

◆ RepoInfoList

using RepoInfoList = std::list<RepoInfo>
related

Definition at line 626 of file RepoInfo.h.

◆ RepoManager

friend class RepoManager
friend

Definition at line 614 of file RepoInfo.h.

◆ operator<< [1/3]

std::ostream & operator<< ( std::ostream & str,
const RepoInfo & obj )
friend

Definition at line 1108 of file RepoInfo.cc.

◆ operator<<() [2/3]

std::ostream & operator<< ( std::ostream & str,
const RepoInfo & obj )
related

Stream output.

Definition at line 1108 of file RepoInfo.cc.

Member Data Documentation

◆ noRepo

const RepoInfo zypp::RepoInfo::noRepo
static

Represents no Repository (one with an empty alias).

Definition at line 85 of file RepoInfo.h.

◆ _pimpl

RWCOW_pointer<Impl> zypp::RepoInfo::_pimpl
private

Pointer to implementation.

Definition at line 617 of file RepoInfo.h.


The documentation for this class was generated from the following files: