creates and provides information about known sources. More...

#include <RepoManager.h>

Inheritance diagram for zypp::RepoManager:

Classes
struct	MatchServiceAlias
	Functor thats filter RepoInfo by service which it belongs to. More...

Public Types
enum	RawMetadataRefreshPolicy { RefreshIfNeeded , RefreshForced , RefreshIfNeededIgnoreDelay }

enum	CacheBuildPolicy { BuildIfNeeded , BuildForced }

enum	RefreshServiceBit { RefreshService_restoreStatus = (1<<0) , RefreshService_forceRefresh = (1<<1) }
	Flags for tuning RefreshService. More...

typedef std::set< ServiceInfo >	ServiceSet
	ServiceInfo typedefs.

typedef ServiceSet::const_iterator	ServiceConstIterator

typedef ServiceSet::size_type	ServiceSizeType

typedef std::set< RepoInfo >	RepoSet
	RepoInfo typedefs.

typedef RepoSet::const_iterator	RepoConstIterator

typedef RepoSet::size_type	RepoSizeType

typedef RefreshServiceFlags	RefreshServiceOptions
	Options tuning RefreshService.

Public Member Functions
	Impl (const RepoManagerOptions &opt)

	~Impl ()

bool	repoEmpty () const

RepoSizeType	repoSize () const

RepoConstIterator	repoBegin () const

RepoConstIterator	repoEnd () const

bool	hasRepo (const std::string &alias) const

RepoInfo	getRepo (const std::string &alias) const

Pathname	metadataPath (const RepoInfo &info) const

Pathname	packagesPath (const RepoInfo &info) const

RepoStatus	metadataStatus (const RepoInfo &info) const

RefreshCheckStatus	checkIfToRefreshMetadata (const RepoInfo &info, const Url &url, RawMetadataRefreshPolicy policy)

void	refreshMetadata (const RepoInfo &info, RawMetadataRefreshPolicy policy, OPT_PROGRESS)

void	cleanMetadata (const RepoInfo &info, OPT_PROGRESS)

void	cleanPackages (const RepoInfo &info, OPT_PROGRESS, bool isAutoClean=false)

void	buildCache (const RepoInfo &info, CacheBuildPolicy policy, OPT_PROGRESS)

repo::RepoType	probe (const Url &url, const Pathname &path=Pathname()) const

repo::RepoType	probeCache (const Pathname &path_r) const

void	cleanCacheDirGarbage (OPT_PROGRESS)

void	cleanCache (const RepoInfo &info, OPT_PROGRESS)

bool	isCached (const RepoInfo &info) const

RepoStatus	cacheStatus (const RepoInfo &info) const

void	loadFromCache (const RepoInfo &info, OPT_PROGRESS)

void	addRepository (const RepoInfo &info, OPT_PROGRESS)

void	addRepositories (const Url &url, OPT_PROGRESS)

void	removeRepository (const RepoInfo &info, OPT_PROGRESS)

void	modifyRepository (const std::string &alias, const RepoInfo &newinfo_r, OPT_PROGRESS)

RepoInfo	getRepositoryInfo (const std::string &alias, OPT_PROGRESS)

RepoInfo	getRepositoryInfo (const Url &url, const url::ViewOption &urlview, OPT_PROGRESS)

bool	serviceEmpty () const

ServiceSizeType	serviceSize () const

ServiceConstIterator	serviceBegin () const

ServiceConstIterator	serviceEnd () const

bool	hasService (const std::string &alias) const

ServiceInfo	getService (const std::string &alias) const

void	addService (const ServiceInfo &service)

void	addService (const std::string &alias, const Url &url)

void	removeService (const std::string &alias)

void	removeService (const ServiceInfo &service)

void	refreshServices (const RefreshServiceOptions &options_r)

void	refreshService (const std::string &alias, const RefreshServiceOptions &options_r)

void	refreshService (const ServiceInfo &service, const RefreshServiceOptions &options_r)

void	modifyService (const std::string &oldAlias, const ServiceInfo &newService)

repo::ServiceType	probeService (const Url &url) const

void	refreshGeoIPData (const RepoInfo::url_set &urls)

	RepoManager (const RepoManagerOptions &options=RepoManagerOptions())

	~RepoManager ()
	Dtor.

	ZYPP_DECLARE_FLAGS (RefreshServiceFlags, RefreshServiceBit)

Private Member Functions
void	saveService (ServiceInfo &service) const

Pathname	generateNonExistingName (const Pathname &dir, const std::string &basefilename) const

std::string	generateFilename (const RepoInfo &info) const

std::string	generateFilename (const ServiceInfo &info) const

void	setCacheStatus (const RepoInfo &info, const RepoStatus &status)

void	touchIndexFile (const RepoInfo &info)

template<typename OutputIterator >
void	getRepositoriesInService (const std::string &alias, OutputIterator out) const

void	init_knownServices ()

void	init_knownRepositories ()

const RepoSet &	repos () const
	Iterate the known repositories.

RepoSet &	reposManip ()

Impl *	clone () const
	clone for RWCOW_pointer

Private Attributes
RepoManagerOptions	_options

RepoSet	_reposX

ServiceSet	_services

DefaultIntegral< bool, false >	_reposDirty

PluginRepoverification	_pluginRepoverification

Friends
Impl *	rwcowClone (const Impl *rhs)

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

Related Functions
(Note that these are not member functions.)
std::ostream &	operator<< (std::ostream &str, const RepoManager &obj)
	Stream output.

Related Functions inherited from Impl
std::ostream &	operator<< (std::ostream &str, const RepoManager::Impl &obj)
	Stream output.

Known repositories.
The known repositories are read from RepoManagerOptions::knownReposPath passed on the Ctor. Which defaults to ZYpp global settings.
enum	RefreshCheckStatus { REFRESH_NEEDED , REPO_UP_TO_DATE , REPO_CHECK_DELAYED }
	Possibly return state of checkIfRefreshMEtadata function. More...

bool	repoEmpty () const

RepoSizeType	repoSize () const

RepoConstIterator	repoBegin () const

RepoConstIterator	repoEnd () const

Iterable< RepoConstIterator >	repos () const

std::list< RepoInfo >	knownRepositories () const
	List of known repositories.

RepoInfo	getRepo (const std::string &alias) const
	Find RepoInfo by alias or return RepoInfo::noRepo.

RepoInfo	getRepo (const RepoInfo &info_r) const

bool	hasRepo (const std::string &alias) const
	Return whether there is a known repository for `alias`.

bool	hasRepo (const RepoInfo &info_r) const

RepoStatus	metadataStatus (const RepoInfo &info) const
	Status of local metadata.

RefreshCheckStatus	checkIfToRefreshMetadata (const RepoInfo &info, const Url &url, RawMetadataRefreshPolicy policy=RefreshIfNeeded)
	Checks whether to refresh metadata for specified repository and url.

Pathname	metadataPath (const RepoInfo &info) const
	Path where the metadata is downloaded and kept.

Pathname	packagesPath (const RepoInfo &info) const
	Path where the rpm packages are downloaded and kept.

void	refreshMetadata (const RepoInfo &info, RawMetadataRefreshPolicy policy=RefreshIfNeeded, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Refresh local raw cache.

void	cleanMetadata (const RepoInfo &info, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Clean local metadata.

void	cleanPackages (const RepoInfo &info, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Clean local package cache.

RepoStatus	cacheStatus (const RepoInfo &info) const
	Status of metadata cache.

void	buildCache (const RepoInfo &info, CacheBuildPolicy policy=BuildIfNeeded, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Refresh local cache.

void	cleanCache (const RepoInfo &info, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	clean local cache

bool	isCached (const RepoInfo &info) const
	Whether a repository exists in cache.

void	loadFromCache (const RepoInfo &info, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Load resolvables into the pool.

void	cleanCacheDirGarbage (const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Remove any subdirectories of cache directories which no longer belong to any of known repositories.

repo::RepoType	probe (const Url &url, const Pathname &path) const
	Probe repo metadata type.

repo::RepoType	probe (const Url &url) const

void	addRepository (const RepoInfo &info, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Adds a repository to the list of known repositories.

void	addRepositories (const Url &url, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Adds repositores from a repo file to the list of known repositories.

void	removeRepository (const RepoInfo &info, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Remove the best matching repository from known repos list.

void	modifyRepository (const std::string &alias, const RepoInfo &newinfo, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Modify repository attributes.

void	modifyRepository (const RepoInfo &newinfo, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())

RepoInfo	getRepositoryInfo (const std::string &alias, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Find a matching repository info.

RepoInfo	getRepositoryInfo (const Url &url, const url::ViewOption &urlview=url::ViewOption::DEFAULTS, const ProgressData::ReceiverFnc &progressrcv=ProgressData::ReceiverFnc())
	Find repository info by URL.

static std::string	makeStupidAlias (const Url &url_r=Url())
	Some stupid string but suitable as alias for your url if nothing better is available.

Known services.
The known services are read from RepoManagerOptions::knownServicesPath passed on the Ctor. Which defaults to ZYpp global settings.
RWCOW_pointer< Impl >	_pimpl
	Pointer to implementation.

bool	serviceEmpty () const
	Gets true if no service is in RepoManager (so no one in specified location)

ServiceSizeType	serviceSize () const
	Gets count of service in RepoManager (in specified location)

ServiceConstIterator	serviceBegin () const
	Iterator to first service in internal storage.

ServiceConstIterator	serviceEnd () const
	Iterator to place behind last service in internal storage.

Iterable< ServiceConstIterator >	services () const
	Iterate the known services.

std::list< ServiceInfo >	knownServices () const
	List of known services.

ServiceInfo	getService (const std::string &alias) const
	Finds ServiceInfo by alias or return ServiceInfo::noService.

bool	hasService (const std::string &alias) const
	Return whether there is a known service for `alias`.

repo::ServiceType	probeService (const Url &url) const
	Probe the type or the service.

void	addService (const std::string &alias, const Url &url)
	Adds a new service by its alias and URL.

void	addService (const ServiceInfo &service)
	Adds new service.

void	removeService (const std::string &alias)
	Removes service specified by its name.

void	removeService (const ServiceInfo &service)

void	refreshServices (const RefreshServiceOptions &options_r=RefreshServiceOptions())
	Refreshes all enabled services.

void	refreshService (const std::string &alias, const RefreshServiceOptions &options_r=RefreshServiceOptions())
	Refresh specific service.

void	refreshService (const ServiceInfo &service, const RefreshServiceOptions &options_r=RefreshServiceOptions())

void	modifyService (const std::string &oldAlias, const ServiceInfo &service)
	Modifies service file (rewrites it with new values) and underlying repositories if needed.

void	modifyService (const ServiceInfo &service)

void	refreshGeoIp (const RepoInfo::url_set &urls)

template<typename OutputIterator >
void	getRepositoriesInService (const std::string &alias, OutputIterator out) const
	fill to output iterator repositories in service name.

Detailed Description

creates and provides information about known sources.

Definition at line 532 of file RepoManager.cc.

Member Typedef Documentation

◆ ServiceSet

typedef std::set<ServiceInfo> zypp::RepoManager::ServiceSet

ServiceInfo typedefs.

Definition at line 114 of file RepoManager.h.

◆ ServiceConstIterator

typedef ServiceSet::const_iterator zypp::RepoManager::ServiceConstIterator

Definition at line 115 of file RepoManager.h.

◆ ServiceSizeType

typedef ServiceSet::size_type zypp::RepoManager::ServiceSizeType

Definition at line 116 of file RepoManager.h.

◆ RepoSet

typedef std::set<RepoInfo> zypp::RepoManager::RepoSet

RepoInfo typedefs.

Definition at line 119 of file RepoManager.h.

◆ RepoConstIterator

typedef RepoSet::const_iterator zypp::RepoManager::RepoConstIterator

Definition at line 120 of file RepoManager.h.

◆ RepoSizeType

typedef RepoSet::size_type zypp::RepoManager::RepoSizeType

Definition at line 121 of file RepoManager.h.

◆ RefreshServiceOptions

typedef RefreshServiceFlags zypp::RepoManager::RefreshServiceOptions

Options tuning RefreshService.

Definition at line 150 of file RepoManager.h.

Member Enumeration Documentation

◆ RawMetadataRefreshPolicy

enum zypp::RepoManager::RawMetadataRefreshPolicy

Enumerator
RefreshIfNeeded
RefreshForced
RefreshIfNeededIgnoreDelay

Definition at line 128 of file RepoManager.h.

◆ CacheBuildPolicy

enum zypp::RepoManager::CacheBuildPolicy

Enumerator
BuildIfNeeded
BuildForced

Definition at line 135 of file RepoManager.h.

◆ RefreshServiceBit

enum zypp::RepoManager::RefreshServiceBit

Flags for tuning RefreshService.

Enumerator
RefreshService_restoreStatus	Force restoring repo enabled/disabled status.
RefreshService_forceRefresh	Force refresh even if TTL is not reached.

Definition at line 142 of file RepoManager.h.

◆ RefreshCheckStatus

enum zypp::RepoManager::RefreshCheckStatus

Possibly return state of checkIfRefreshMEtadata function.

Enumerator
REFRESH_NEEDED	refresh is needed
REPO_UP_TO_DATE	repository not changed
REPO_CHECK_DELAYED	refresh is delayed due to settings

Definition at line 196 of file RepoManager.h.

Constructor & Destructor Documentation

◆ ~Impl()

zypp::RepoManager::~Impl ( )

inline

Definition at line 543 of file RepoManager.cc.

◆ RepoManager()

zypp::RepoManager::RepoManager ( const RepoManagerOptions & options = RepoManagerOptions() )

Definition at line 2709 of file RepoManager.cc.

◆ ~RepoManager()

zypp::RepoManager::~RepoManager ( )

Dtor.

Definition at line 2713 of file RepoManager.cc.

Member Function Documentation

◆ Impl()

zypp::RepoManager::Impl ( const RepoManagerOptions & opt )

inline

Definition at line 535 of file RepoManager.cc.

◆ repoEmpty() [1/2]

bool zypp::RepoManager::repoEmpty ( ) const

inline

Definition at line 588 of file RepoManager.cc.

◆ repoSize() [1/2]

RepoManager::RepoSizeType zypp::RepoManager::repoSize ( ) const

inline

Definition at line 589 of file RepoManager.cc.

◆ repoBegin() [1/2]

RepoManager::RepoConstIterator zypp::RepoManager::repoBegin ( ) const

inline

Definition at line 590 of file RepoManager.cc.

◆ repoEnd() [1/2]

RepoManager::RepoConstIterator zypp::RepoManager::repoEnd ( ) const

inline

Definition at line 591 of file RepoManager.cc.

◆ hasRepo() [1/3]

bool zypp::RepoManager::hasRepo ( const std::string & alias ) const

inline

Definition at line 593 of file RepoManager.cc.

◆ getRepo() [1/3]

RepoInfo zypp::RepoManager::getRepo ( const std::string & alias ) const

inline

Definition at line 596 of file RepoManager.cc.

◆ metadataPath() [1/2]

Pathname zypp::RepoManager::metadataPath ( const RepoInfo & info ) const

inline

Definition at line 603 of file RepoManager.cc.

◆ packagesPath() [1/2]

Pathname zypp::RepoManager::packagesPath ( const RepoInfo & info ) const

inline

Definition at line 606 of file RepoManager.cc.

◆ metadataStatus() [1/2]

RepoStatus zypp::RepoManager::metadataStatus ( const RepoInfo & info ) const

Definition at line 2754 of file RepoManager.cc.

◆ checkIfToRefreshMetadata() [1/2]

RepoManager::RefreshCheckStatus zypp::RepoManager::checkIfToRefreshMetadata	(	const RepoInfo &	info,
		const Url &	url,
		RawMetadataRefreshPolicy	policy
	)

Definition at line 2757 of file RepoManager.cc.

◆ refreshMetadata() [1/2]

void zypp::RepoManager::refreshMetadata	(	const RepoInfo &	info,
		RawMetadataRefreshPolicy	policy,
		OPT_PROGRESS
	)

◆ cleanMetadata() [1/2]

void zypp::RepoManager::cleanMetadata	(	const RepoInfo &	info,
		OPT_PROGRESS
	)

◆ cleanPackages() [1/2]

void zypp::RepoManager::cleanPackages	(	const RepoInfo &	info,
		OPT_PROGRESS	,
		bool	isAutoClean = `false`
	)

◆ buildCache() [1/2]

void zypp::RepoManager::buildCache	(	const RepoInfo &	info,
		CacheBuildPolicy	policy,
		OPT_PROGRESS
	)

◆ probe() [1/3]

repo::RepoType zypp::RepoManager::probe	(	const Url &	url,
		const Pathname &	path = `Pathname()`
	)		const

Definition at line 2793 of file RepoManager.cc.

◆ probeCache()

repo::RepoType zypp::RepoManager::probeCache ( const Pathname & path_r ) const

◆ cleanCacheDirGarbage() [1/2]

void zypp::RepoManager::cleanCacheDirGarbage ( OPT_PROGRESS )

◆ cleanCache() [1/2]

void zypp::RepoManager::cleanCache	(	const RepoInfo &	info,
		OPT_PROGRESS
	)

◆ isCached() [1/2]

bool zypp::RepoManager::isCached ( const RepoInfo & info ) const

inline

Definition at line 628 of file RepoManager.cc.

◆ cacheStatus() [1/2]

RepoStatus zypp::RepoManager::cacheStatus ( const RepoInfo & info ) const

inline

Definition at line 631 of file RepoManager.cc.

◆ loadFromCache() [1/2]

void zypp::RepoManager::loadFromCache	(	const RepoInfo &	info,
		OPT_PROGRESS
	)

◆ addRepository() [1/2]

void zypp::RepoManager::addRepository	(	const RepoInfo &	info,
		OPT_PROGRESS
	)

◆ addRepositories() [1/2]

void zypp::RepoManager::addRepositories	(	const Url &	url,
		OPT_PROGRESS
	)

◆ removeRepository() [1/2]

void zypp::RepoManager::removeRepository	(	const RepoInfo &	info,
		OPT_PROGRESS
	)

◆ modifyRepository() [1/3]

void zypp::RepoManager::modifyRepository	(	const std::string &	alias,
		const RepoInfo &	newinfo_r,
		OPT_PROGRESS
	)

◆ getRepositoryInfo() [1/4]

RepoInfo zypp::RepoManager::getRepositoryInfo	(	const std::string &	alias,
		OPT_PROGRESS
	)

◆ getRepositoryInfo() [2/4]

RepoInfo zypp::RepoManager::getRepositoryInfo	(	const Url &	url,
		const url::ViewOption &	urlview,
		OPT_PROGRESS
	)

◆ serviceEmpty() [1/2]

bool zypp::RepoManager::serviceEmpty ( ) const

inline

Definition at line 648 of file RepoManager.cc.

◆ serviceSize() [1/2]

RepoManager::ServiceSizeType zypp::RepoManager::serviceSize ( ) const

inline

Definition at line 649 of file RepoManager.cc.

◆ serviceBegin() [1/2]

RepoManager::ServiceConstIterator zypp::RepoManager::serviceBegin ( ) const

inline

Definition at line 650 of file RepoManager.cc.

◆ serviceEnd() [1/2]

RepoManager::ServiceConstIterator zypp::RepoManager::serviceEnd ( ) const

inline

Definition at line 651 of file RepoManager.cc.

◆ hasService() [1/2]

bool zypp::RepoManager::hasService ( const std::string & alias ) const

inline

Definition at line 653 of file RepoManager.cc.

◆ getService() [1/2]

ServiceInfo zypp::RepoManager::getService ( const std::string & alias ) const

inline

Definition at line 656 of file RepoManager.cc.

◆ addService() [1/4]

void zypp::RepoManager::addService ( const ServiceInfo & service )

Definition at line 2841 of file RepoManager.cc.

◆ addService() [2/4]

void zypp::RepoManager::addService	(	const std::string &	alias,
		const Url &	url
	)

inline

Definition at line 664 of file RepoManager.cc.

◆ removeService() [1/4]

void zypp::RepoManager::removeService ( const std::string & alias )

Definition at line 2844 of file RepoManager.cc.

◆ removeService() [2/4]

void zypp::RepoManager::removeService ( const ServiceInfo & service )

inline

Definition at line 668 of file RepoManager.cc.

◆ refreshServices() [1/2]

void zypp::RepoManager::refreshServices ( const RefreshServiceOptions & options_r )

Definition at line 2850 of file RepoManager.cc.

◆ refreshService() [1/4]

void zypp::RepoManager::refreshService	(	const std::string &	alias,
		const RefreshServiceOptions &	options_r
	)

Definition at line 2853 of file RepoManager.cc.

◆ refreshService() [2/4]

void zypp::RepoManager::refreshService	(	const ServiceInfo &	service,
		const RefreshServiceOptions &	options_r
	)

inline

Definition at line 674 of file RepoManager.cc.

◆ modifyService() [1/3]

void zypp::RepoManager::modifyService	(	const std::string &	oldAlias,
		const ServiceInfo &	newService
	)

Definition at line 2859 of file RepoManager.cc.

◆ probeService() [1/2]

repo::ServiceType zypp::RepoManager::probeService ( const Url & url ) const

Definition at line 2835 of file RepoManager.cc.

◆ refreshGeoIPData()

void zypp::RepoManager::refreshGeoIPData ( const RepoInfo::url_set & urls )

◆ saveService()

void zypp::RepoManager::saveService ( ServiceInfo & service ) const

private

◆ generateNonExistingName()

Pathname zypp::RepoManager::generateNonExistingName	(	const Pathname &	dir,
		const std::string &	basefilename
	)		const

private

◆ generateFilename() [1/2]

std::string zypp::RepoManager::generateFilename ( const RepoInfo & info ) const

inlineprivate

Definition at line 688 of file RepoManager.cc.

◆ generateFilename() [2/2]

std::string zypp::RepoManager::generateFilename ( const ServiceInfo & info ) const

inlineprivate

Definition at line 691 of file RepoManager.cc.

◆ setCacheStatus()

void zypp::RepoManager::setCacheStatus	(	const RepoInfo &	info,
		const RepoStatus &	status
	)

inlineprivate

Definition at line 694 of file RepoManager.cc.

◆ touchIndexFile()

void zypp::RepoManager::touchIndexFile ( const RepoInfo & info )

private

◆ getRepositoriesInService() [1/2]

template<typename OutputIterator >

void zypp::RepoManager::getRepositoriesInService	(	const std::string &	alias,
		OutputIterator	out
	)		const

inlineprivate

Definition at line 704 of file RepoManager.cc.

◆ init_knownServices()

void zypp::RepoManager::init_knownServices ( )

private

◆ init_knownRepositories()

void zypp::RepoManager::init_knownRepositories ( )

private

◆ repos() [1/2]

Iterable< RepoManager::RepoConstIterator > zypp::RepoManager::repos ( ) const

inlineprivate

Iterate the known repositories.

Definition at line 716 of file RepoManager.cc.

◆ reposManip()

RepoSet & zypp::RepoManager::reposManip ( )

inlineprivate

Definition at line 717 of file RepoManager.cc.

◆ clone()

Impl * zypp::RepoManager::clone ( ) const

inlineprivate

clone for RWCOW_pointer

Definition at line 731 of file RepoManager.cc.

◆ ZYPP_DECLARE_FLAGS()

zypp::RepoManager::ZYPP_DECLARE_FLAGS	(	RefreshServiceFlags	,
		RefreshServiceBit
	)

◆ repoEmpty() [2/2]

bool zypp::RepoManager::repoEmpty ( ) const

◆ repoSize() [2/2]

RepoSizeType zypp::RepoManager::repoSize ( ) const

◆ repoBegin() [2/2]

RepoConstIterator zypp::RepoManager::repoBegin ( ) const

◆ repoEnd() [2/2]

RepoConstIterator zypp::RepoManager::repoEnd ( ) const

◆ repos() [2/2]

Iterable< RepoConstIterator > zypp::RepoManager::repos ( ) const

◆ knownRepositories()

std::list< RepoInfo > zypp::RepoManager::knownRepositories ( ) const

inline

List of known repositories.

Definition at line 167 of file RepoManager.h.

◆ getRepo() [2/3]

RepoInfo zypp::RepoManager::getRepo ( const std::string & alias ) const

Find RepoInfo by alias or return RepoInfo::noRepo.

◆ getRepo() [3/3]

RepoInfo zypp::RepoManager::getRepo ( const RepoInfo & info_r ) const

inline

Definition at line 173 of file RepoManager.h.

◆ hasRepo() [2/3]

bool zypp::RepoManager::hasRepo ( const std::string & alias ) const

Return whether there is a known repository for alias.

◆ hasRepo() [3/3]

bool zypp::RepoManager::hasRepo ( const RepoInfo & info_r ) const

inline

Definition at line 179 of file RepoManager.h.

◆ makeStupidAlias()

std::string zypp::RepoManager::makeStupidAlias ( const Url & url_r = Url() )

static

Some stupid string but suitable as alias for your url if nothing better is available.

Something like "http-download.opensuse.org-83df67e5"

Definition at line 2734 of file RepoManager.cc.

◆ metadataStatus() [2/2]

RepoStatus zypp::RepoManager::metadataStatus ( const RepoInfo & info ) const

Status of local metadata.

◆ checkIfToRefreshMetadata() [2/2]

RefreshCheckStatus zypp::RepoManager::checkIfToRefreshMetadata	(	const RepoInfo &	info,
		const Url &	url,
		RawMetadataRefreshPolicy	policy = `RefreshIfNeeded`
	)

Checks whether to refresh metadata for specified repository and url.

The need for refresh is evaluated according to the following conditions, in that order:

the refresh policy (refresh may be forced)
the repo.refresh.delay ZConfig value compared to the difference between cached index file timestamp and actual time
the timestamp of cached repo index file compared to the remote index file timestamp.

This method checks the status against the specified url only. If more baseurls are defined for in the RepoInfo, each one must be check individually. Example:

RepoInfo info; // try urls one by one for ( RepoInfo::urls_const_iterator it = info.baseUrlsBegin(); it != info.baseUrlsEnd(); ++it ) { try { // check whether to refresh metadata // if the check fails for this url, it throws, so another url will be checked if (checkIfToRefreshMetadata(info, *it, policy)!=RepoInfo::REFRESH_NEEDED) return;

// do the actual refresh } catch (const Exception & e) { ZYPP_CAUGHT(e); ERR << *it << " doesn't look good. Trying another url." << endl; } } // for all urls

handle("No more URLs.");

Parameters

info
url
policy

Returns: state of repository

See also: RefreshCheckStatus

Exceptions

RepoUnknownTypeException
repo::RepoNoAliasException	if can't figure an alias
Exception	on unknown error

◆ metadataPath() [2/2]

Pathname zypp::RepoManager::metadataPath ( const RepoInfo & info ) const

Path where the metadata is downloaded and kept.

Given a repoinfo, tells where RepoManager will download and keep the raw metadata.

Parameters

info	Repository information

Exceptions

repo::RepoNoAliasException if can't figure an alias

◆ packagesPath() [2/2]

Pathname zypp::RepoManager::packagesPath ( const RepoInfo & info ) const

Path where the rpm packages are downloaded and kept.

Given a repoinfo, tells where RepoProvidePackage will download and keep the .rpm files.

Parameters

info	Repository information

Exceptions

repo::RepoNoAliasException if can't figure an alias

◆ refreshMetadata() [2/2]

void zypp::RepoManager::refreshMetadata	(	const RepoInfo &	info,
		RawMetadataRefreshPolicy	policy = `RefreshIfNeeded`,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Refresh local raw cache.

Will try to download the metadata

In case of falure the metadata remains as it was before.

Exceptions

repo::RepoNoUrlException	if no urls are available.
repo::RepoNoAliasException	if can't figure an alias
repo::RepoUnknownTypeException	if the metadata is unknown
repo::RepoException	if the repository is invalid (no valid metadata found at any of baseurls)

Definition at line 2766 of file RepoManager.cc.

◆ cleanMetadata() [2/2]

void zypp::RepoManager::cleanMetadata	(	const RepoInfo &	info,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Clean local metadata.

Empty local metadata.

Exceptions

repo::RepoNoAliasException	if can't figure an alias
Exception	on unknown error.

Definition at line 2769 of file RepoManager.cc.

◆ cleanPackages() [2/2]

void zypp::RepoManager::cleanPackages	(	const RepoInfo &	info,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Clean local package cache.

Empty local directory with downloaded packages

Exceptions

repo::RepoNoAliasException	if can't figure an alias
Exception	on unknown error.

Definition at line 2772 of file RepoManager.cc.

◆ cacheStatus() [2/2]

RepoStatus zypp::RepoManager::cacheStatus ( const RepoInfo & info ) const

Status of metadata cache.

◆ buildCache() [2/2]

void zypp::RepoManager::buildCache	(	const RepoInfo &	info,
		CacheBuildPolicy	policy = `BuildIfNeeded`,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Refresh local cache.

Will try to build the cache from local metadata.

If the cache exists it will be overwriten.

Note: the local metadata must be valid.

Exceptions

repo::RepoNoAliasException	if can't figure an alias to look in cache
repo::RepoMetadataException	if the metadata is not enough to build a cache (empty, incorrect, or refresh needed)
repo::RepoUnknownTypeException
parser::ParseException	if parser encounters an error.
Exception	on unknown error.

Definition at line 2778 of file RepoManager.cc.

◆ cleanCache() [2/2]

void zypp::RepoManager::cleanCache	(	const RepoInfo &	info,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

clean local cache

Clean the cached version of the metadata

Note: the local metadata must be valid.

Exceptions

repo::RepoNoAliasException	if can't figure an alias to look in cache
cache::CacheRecordNotFoundException	if the cache could not be cleaned because of repository record not found.
Exception	on unknown error.

Definition at line 2781 of file RepoManager.cc.

◆ isCached() [2/2]

bool zypp::RepoManager::isCached ( const RepoInfo & info ) const

Whether a repository exists in cache.

Parameters

RepoInfo to be checked.

◆ loadFromCache() [2/2]

void zypp::RepoManager::loadFromCache	(	const RepoInfo &	info,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Load resolvables into the pool.

Creating from cache requires that the repository is refreshed (metadata downloaded) and cached

Exceptions

repo::RepoNoAliasException	if can't figure an alias to look in cache
RepoNotCachedException	When the source is not cached.

Definition at line 2787 of file RepoManager.cc.

◆ cleanCacheDirGarbage() [2/2]

void zypp::RepoManager::cleanCacheDirGarbage ( const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() )

Remove any subdirectories of cache directories which no longer belong to any of known repositories.

These can be temporary directories left by interrupted refresh, or dirs left after changing .repo files outside of libzypp.

Definition at line 2790 of file RepoManager.cc.

◆ probe() [2/3]

repo::RepoType zypp::RepoManager::probe	(	const Url &	url,
		const Pathname &	path
	)		const

Probe repo metadata type.

The location to probe consists of the base url (you may think of it as a mountpoint) and the path to the repository on the mounted media (ususally / ).

◆ probe() [3/3]

repo::RepoType zypp::RepoManager::probe ( const Url & url ) const

Definition at line 2796 of file RepoManager.cc.

◆ addRepository() [2/2]

void zypp::RepoManager::addRepository	(	const RepoInfo &	info,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Adds a repository to the list of known repositories.

Exceptions

repo::RepoAlreadyExistsException	If the repo clash some unique attribute like alias
RepoUnknownType	If RepoManagerOptions::probe is true and repository type can't be determined.
RepoException	If RepoManagerOptions::probe is true and access to the url fails.
Exception	On other errors.

Definition at line 2799 of file RepoManager.cc.

◆ addRepositories() [2/2]

void zypp::RepoManager::addRepositories	(	const Url &	url,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Adds repositores from a repo file to the list of known repositories.

Parameters

url	Url of the repo file

Exceptions

repo::RepoAlreadyExistsException	If the repo clash some unique attribute like alias
MediaException	If the access to the url fails
ParseException	If the file parsing fails
RepoUnknownType	If repository type can't be determined
RepoException	ON other repository related errors
Exception	On other errors.

Definition at line 2802 of file RepoManager.cc.

◆ removeRepository() [2/2]

void zypp::RepoManager::removeRepository	(	const RepoInfo &	info,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Remove the best matching repository from known repos list.

Exceptions

RepoNotFoundException If no repo match

Definition at line 2805 of file RepoManager.cc.

◆ modifyRepository() [2/3]

void zypp::RepoManager::modifyRepository	(	const std::string &	alias,
		const RepoInfo &	newinfo,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Modify repository attributes.

Exceptions

RepoAlreadyExistsException	if the alias specified in newinfo is already used by another repository
RepoNotFoundException	If no repo match
ParseException	If the file parsing fails
Exception	On other errors.

Definition at line 2808 of file RepoManager.cc.

◆ modifyRepository() [3/3]

void zypp::RepoManager::modifyRepository	(	const RepoInfo &	newinfo,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

inline

Definition at line 463 of file RepoManager.h.

◆ getRepositoryInfo() [3/4]

RepoInfo zypp::RepoManager::getRepositoryInfo	(	const std::string &	alias,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Find a matching repository info.

Note: if multiple repositories incorrectly share the same alias, the first one found will be returned.

Parameters

alias	Repository alias
progressrcv	Progress reporting function

Returns: RepoInfo of the found repository

Exceptions

RepoNotFoundException	If no repo match the alias
ParseException	If the file parsing fails
Exception	On other errors.

Definition at line 2811 of file RepoManager.cc.

◆ getRepositoryInfo() [4/4]

RepoInfo zypp::RepoManager::getRepositoryInfo	(	const Url &	url,
		const url::ViewOption &	urlview = `url::ViewOption::DEFAULTS`,
		const ProgressData::ReceiverFnc &	progressrcv = `ProgressData::ReceiverFnc()`
	)

Find repository info by URL.

Parameters

url	URL to find.
urlview	url::ViewOption to influence URL matching.
progressrcv	Progress receiver function.

Returns: RepoInfo of the found repository.

Note: if multpile repositories incorrectly share the same URL, the first one found will be returned.; the string representation of the URLs are compared. The urlview can be used to influence which parts of the URL are to be compared.

Exceptions

RepoNotFoundException	If no repo match
ParseException	If the file parsing fails
Exception	On other errors.

Definition at line 2814 of file RepoManager.cc.

◆ serviceEmpty() [2/2]

bool zypp::RepoManager::serviceEmpty ( ) const

Gets true if no service is in RepoManager (so no one in specified location)

Returns: true if any ServiceInfo is in RepoManager

◆ serviceSize() [2/2]

ServiceSizeType zypp::RepoManager::serviceSize ( ) const

Gets count of service in RepoManager (in specified location)

Returns: count of service

◆ serviceBegin() [2/2]

ServiceConstIterator zypp::RepoManager::serviceBegin ( ) const

Iterator to first service in internal storage.

Note: Iterator is immutable, so you cannot change pointed ServiceInfo

Returns: Iterator to first service

◆ serviceEnd() [2/2]

ServiceConstIterator zypp::RepoManager::serviceEnd ( ) const

Iterator to place behind last service in internal storage.

Returns: iterator to end

◆ services()

Iterable< RepoManager::ServiceConstIterator > zypp::RepoManager::services ( ) const

inline

Iterate the known services.

Definition at line 717 of file RepoManager.h.

◆ knownServices()

std::list< ServiceInfo > zypp::RepoManager::knownServices ( ) const

inline

List of known services.

Definition at line 545 of file RepoManager.h.

◆ getService() [2/2]

ServiceInfo zypp::RepoManager::getService ( const std::string & alias ) const

Finds ServiceInfo by alias or return ServiceInfo::noService.

Parameters

alias unique identifier of service

Returns: information about service

◆ hasService() [2/2]

bool zypp::RepoManager::hasService ( const std::string & alias ) const

Return whether there is a known service for alias.

◆ probeService() [2/2]

repo::ServiceType zypp::RepoManager::probeService ( const Url & url ) const

Probe the type or the service.

◆ addService() [3/4]

void zypp::RepoManager::addService	(	const std::string &	alias,
		const Url &	url
	)

Adds a new service by its alias and URL.

Parameters

alias	unique identifier of the service
url	url to service

Exceptions

FIXME RepoAlreadyExistException and as reponame is service name

◆ addService() [4/4]

void zypp::RepoManager::addService ( const ServiceInfo & service )

Adds new service.

Parameters

service service info

Exceptions

FIXME RepoAlreadyExistException and as reponame is service name

◆ removeService() [3/4]

void zypp::RepoManager::removeService ( const std::string & alias )

Removes service specified by its name.

Parameters

alias unique indientifier of the service to remove

Exceptions

RepoException	if service is not found or file with ServiceInfo cannot be deleted
Exception	if file contain more services and rewrite file failed

◆ removeService() [4/4]

void zypp::RepoManager::removeService ( const ServiceInfo & service )

◆ refreshServices() [2/2]

void zypp::RepoManager::refreshServices ( const RefreshServiceOptions & options_r = RefreshServiceOptions() )

Refreshes all enabled services.

See also: refreshService(ServiceInfo)

◆ refreshService() [3/4]

void zypp::RepoManager::refreshService	(	const std::string &	alias,
		const RefreshServiceOptions &	options_r = `RefreshServiceOptions()`
	)

Refresh specific service.

Parameters

alias unique indientifier of the service to refresh

Exceptions

RepoException	if service is not found.
MediaException	If there's a problem downloading the repo index file.

◆ refreshService() [4/4]

void zypp::RepoManager::refreshService	(	const ServiceInfo &	service,
		const RefreshServiceOptions &	options_r = `RefreshServiceOptions()`
	)

◆ modifyService() [2/3]

void zypp::RepoManager::modifyService	(	const std::string &	oldAlias,
		const ServiceInfo &	service
	)

Modifies service file (rewrites it with new values) and underlying repositories if needed.

Modifications of a service can lead to rewrite of all .repo files of contained repositories. Particularily, disabling a service (changing ServiceInfo::enabled() from true to false) will disable all contained repositories. Renaming of a service will modify the "service" key of all contained repositories.

Parameters

oldAlias	Old alias of the service
service	ServiceInfo object containing new data

Exceptions

RepoException	if sservice with oldAlias is not known
Exception	if have problems with files

◆ modifyService() [3/3]

void zypp::RepoManager::modifyService ( const ServiceInfo & service )

inline

Definition at line 634 of file RepoManager.h.

◆ refreshGeoIp()

void zypp::RepoManager::refreshGeoIp ( const RepoInfo::url_set & urls )

Checks for any of the given urls if there is no geoip data available, caches the results in the metadata cache for 24hrs. The given urls need to be configured as valid geoIP targets ( usually download.opensuse.org )

Definition at line 2862 of file RepoManager.cc.

◆ getRepositoriesInService() [2/2]

template<typename OutputIterator >

void zypp::RepoManager::getRepositoriesInService	(	const std::string &	alias,
		OutputIterator	out
	)		const

inline

fill to output iterator repositories in service name.

This output iterator can perform any action on with Repo or service Container, because it is sets and it isn't dynamic recreate.

Note: Don't use this function with RepoManager::removeRepository(), it will lead to segfaults due to invalidated internal iterators. FIXME can this be solved (using STL) so that this warning would not be needed?

Parameters

alias	service alias
out	output iterator which get all the repositories belonging to specified service

example how set priority for each RepoInfo in this service:

//functor
class ChangePriority
{
private:
  int priority;
public:
  ChangePriority(int prio) : priority(prio) {}
  // missing rewrite priority back via RepoManager::modifyRepo
  void doIt( RepoInfo info ) { info.setPriority(priority); }
}
 
//somewhere in code
ChangePriority changer(10);
getRepositoriesInService(name,
  boost::make_function_output_iterator(
    bind(&ChangePriority::doIt, &changer, _1)));

Definition at line 692 of file RepoManager.h.

Friends And Related Function Documentation

◆ rwcowClone

Impl * rwcowClone ( const Impl * rhs )

friend

◆ operator<< [1/2]

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

friend

Definition at line 2867 of file RepoManager.cc.

◆ operator<<() [2/2]

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

Definition at line 2867 of file RepoManager.cc.

Member Data Documentation

◆ _options

RepoManagerOptions zypp::RepoManager::_options

private

Definition at line 720 of file RepoManager.cc.

◆ _reposX

RepoSet zypp::RepoManager::_reposX

private

Definition at line 721 of file RepoManager.cc.

◆ _services

ServiceSet zypp::RepoManager::_services

private

Definition at line 722 of file RepoManager.cc.

◆ _reposDirty

DefaultIntegral<bool,false> zypp::RepoManager::_reposDirty

private

Definition at line 724 of file RepoManager.cc.

◆ _pluginRepoverification

PluginRepoverification zypp::RepoManager::_pluginRepoverification

private

Definition at line 726 of file RepoManager.cc.

◆ _pimpl

RWCOW_pointer<Impl> zypp::RepoManager::_pimpl

private

Pointer to implementation.

Definition at line 704 of file RepoManager.h.

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

zypp/RepoManager.cc
zypp/RepoManager.h

Classes

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Friends

Related Functions

Known repositories.

Known services.

Detailed Description

Member Typedef Documentation

◆ ServiceSet

◆ ServiceConstIterator

◆ ServiceSizeType

◆ RepoSet

◆ RepoConstIterator

◆ RepoSizeType

◆ RefreshServiceOptions

Member Enumeration Documentation

◆ RawMetadataRefreshPolicy

◆ CacheBuildPolicy

◆ RefreshServiceBit

◆ RefreshCheckStatus

Constructor & Destructor Documentation

◆ ~Impl()

◆ RepoManager()

◆ ~RepoManager()

Member Function Documentation

◆ Impl()

◆ repoEmpty() [1/2]

◆ repoSize() [1/2]

◆ repoBegin() [1/2]

◆ repoEnd() [1/2]

◆ hasRepo() [1/3]

◆ getRepo() [1/3]

◆ metadataPath() [1/2]

◆ packagesPath() [1/2]

◆ metadataStatus() [1/2]

◆ checkIfToRefreshMetadata() [1/2]

◆ refreshMetadata() [1/2]

◆ cleanMetadata() [1/2]

◆ cleanPackages() [1/2]

◆ buildCache() [1/2]

◆ probe() [1/3]

◆ probeCache()

◆ cleanCacheDirGarbage() [1/2]

◆ cleanCache() [1/2]

◆ isCached() [1/2]

◆ cacheStatus() [1/2]

◆ loadFromCache() [1/2]

◆ addRepository() [1/2]

◆ addRepositories() [1/2]

◆ removeRepository() [1/2]

◆ modifyRepository() [1/3]

◆ getRepositoryInfo() [1/4]

◆ getRepositoryInfo() [2/4]

◆ serviceEmpty() [1/2]

◆ serviceSize() [1/2]

◆ serviceBegin() [1/2]

◆ serviceEnd() [1/2]

◆ hasService() [1/2]

◆ getService() [1/2]

◆ addService() [1/4]

◆ addService() [2/4]

◆ removeService() [1/4]

◆ removeService() [2/4]

◆ refreshServices() [1/2]

◆ refreshService() [1/4]

◆ refreshService() [2/4]

◆ modifyService() [1/3]

◆ probeService() [1/2]

◆ refreshGeoIPData()

◆ saveService()

◆ generateNonExistingName()

◆ generateFilename() [1/2]

◆ generateFilename() [2/2]

◆ setCacheStatus()

◆ touchIndexFile()

◆ getRepositoriesInService() [1/2]

◆ init_knownServices()