Definition of vendor equivalence. More...

#include <VendorAttr.h>

Classes
class	Impl
	VendorAttr implementation. More...

Public Types
typedef std::vector< std::string >	VendorList
	Preferred type to pass equivalent vendor strings.

Public Member Functions
	VendorAttr ()
	Ctor providing the default set.

	VendorAttr (const Pathname &initial_r)
	Ctor reading the initial_r definitions from a dir or file.

	~VendorAttr ()
	Dtor.

bool	addVendorDirectory (const Pathname &dirname_r)
	Adding new equivalent vendors described in a directory.

bool	addVendorFile (const Pathname &filename_r)
	Adding new equivalent vendors described in a file.

void	addVendorList (VendorList &&list_r)
	Adding new equivalent vendor strings container.

void	addVendorList (const VendorList &list_r)

template<class TContainer >
void	addVendorList (const TContainer &container_r)

template<class TStr >
void	addVendorList (const std::initializer_list< TStr > &container_r)

bool	equivalent (const Vendor &lVendor, const Vendor &rVendor) const
	Return whether two vendor strings should be treated as the same vendor.

bool	equivalent (IdString lVendor, IdString rVendor) const

bool	equivalent (sat::Solvable lVendor, sat::Solvable rVendor) const

bool	equivalent (const PoolItem &lVendor, const PoolItem &rVendor) const

bool	relaxedEquivalent (const Vendor &lVendor, const Vendor &rVendor) const
	Like equivalent but always unifies suse and openSUSE vendor.

bool	relaxedEquivalent (IdString lVendor, IdString rVendor) const

bool	relaxedEquivalent (sat::Solvable lVendor, sat::Solvable rVendor) const

bool	relaxedEquivalent (const PoolItem &lVendor, const PoolItem &rVendor) const

unsigned	foreachVendorList (std::function< bool(VendorList)> fnc_r) const
	Call fnc_r for each equivalent vendor list (return `false` to break).

void	_addVendorList (VendorList &&list_r)

Static Public Member Functions
static const VendorAttr &	instance ()
	(Pseudo)Singleton, mapped to the current Target::vendorAttr settings or to noTargetInstance.

static VendorAttr &	noTargetInstance ()
	Singleton, settings used if no Target is active.

Public Attributes
RWCOW_pointer< Impl >	_pimpl
	Implementation class.

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

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

Detailed Description

Definition of vendor equivalence.

Packages with equivalent vendor strings may replace themselves without creating a solver error.

Per default vendor strings starting with "suse" are treated as being equivalent. This may be tuned by providing customized vendor description files in /etc/zypp/vendors.d.

[main]

vendors = MyVendor,AlternateName

By this vendor strings starting with "MyVendor" or "AlternateName" are considered to be equivalent. Packages from equivalent vendors may replace each other without being considered as a 'vendor change'.

Note: bnc#812608: Within the "opensuse*" namespace exact matches (case insensitive) are required. "vendors = suse,opensuse" will allow switching between "suse*" and "opensuse", but not e.g. "opensuse build service".

See also: Solver - Vendor protection

Definition at line 60 of file VendorAttr.h.

Member Typedef Documentation

◆ VendorList

typedef std::vector<std::string> zypp::VendorAttr::VendorList

Preferred type to pass equivalent vendor strings.

Definition at line 103 of file VendorAttr.h.

Constructor & Destructor Documentation

◆ VendorAttr() [1/2]

zypp::VendorAttr::VendorAttr ( )

Ctor providing the default set.

Definition at line 242 of file VendorAttr.cc.

◆ VendorAttr() [2/2]

zypp::VendorAttr::VendorAttr ( const Pathname & initial_r )

Ctor reading the initial_r definitions from a dir or file.

Definition at line 248 of file VendorAttr.cc.

◆ ~VendorAttr()

zypp::VendorAttr::~VendorAttr ( )

Dtor.

Definition at line 255 of file VendorAttr.cc.

Member Function Documentation

◆ instance()

const VendorAttr & zypp::VendorAttr::instance ( )

static

(Pseudo)Singleton, mapped to the current Target::vendorAttr settings or to noTargetInstance.

Definition at line 230 of file VendorAttr.cc.

◆ noTargetInstance()

VendorAttr & zypp::VendorAttr::noTargetInstance ( )

static

Singleton, settings used if no Target is active.

The instance is initialized with the settings found in the system below /. The active Targets settings can be changed via Target::vendorAttr.

Definition at line 236 of file VendorAttr.cc.

◆ addVendorDirectory()

bool zypp::VendorAttr::addVendorDirectory ( const Pathname & dirname_r )

Adding new equivalent vendors described in a directory.

Definition at line 258 of file VendorAttr.cc.

◆ addVendorFile()

bool zypp::VendorAttr::addVendorFile ( const Pathname & filename_r )

Adding new equivalent vendors described in a file.

Definition at line 275 of file VendorAttr.cc.

◆ addVendorList() [1/4]

void zypp::VendorAttr::addVendorList ( VendorList && list_r )

inline

Adding new equivalent vendor strings container.

Definition at line 108 of file VendorAttr.h.

◆ addVendorList() [2/4]

void zypp::VendorAttr::addVendorList ( const VendorList & list_r )

inline

Definition at line 111 of file VendorAttr.h.

◆ addVendorList() [3/4]

template<class TContainer >

void zypp::VendorAttr::addVendorList ( const TContainer & container_r )

inline

Definition at line 115 of file VendorAttr.h.

◆ addVendorList() [4/4]

template<class TStr >

void zypp::VendorAttr::addVendorList ( const std::initializer_list< TStr > & container_r )

inline

Definition at line 124 of file VendorAttr.h.

◆ equivalent() [1/4]

bool zypp::VendorAttr::equivalent	(	const Vendor &	lVendor,
		const Vendor &	rVendor
	)		const

Return whether two vendor strings should be treated as the same vendor.

Usually the solver is allowed to automatically select a package of an equivalent vendor when updating. Replacing a package with one of a different vendor usually must be confirmed by the user.

Definition at line 331 of file VendorAttr.cc.

◆ equivalent() [2/4]

bool zypp::VendorAttr::equivalent	(	IdString	lVendor,
		IdString	rVendor
	)		const

Definition at line 328 of file VendorAttr.cc.

◆ equivalent() [3/4]

bool zypp::VendorAttr::equivalent	(	sat::Solvable	lVendor,
		sat::Solvable	rVendor
	)		const

Definition at line 334 of file VendorAttr.cc.

◆ equivalent() [4/4]

bool zypp::VendorAttr::equivalent	(	const PoolItem &	lVendor,
		const PoolItem &	rVendor
	)		const

Definition at line 337 of file VendorAttr.cc.

◆ relaxedEquivalent() [1/4]

bool zypp::VendorAttr::relaxedEquivalent	(	const Vendor &	lVendor,
		const Vendor &	rVendor
	)		const

Like equivalent but always unifies suse and openSUSE vendor.

Definition at line 344 of file VendorAttr.cc.

◆ relaxedEquivalent() [2/4]

bool zypp::VendorAttr::relaxedEquivalent	(	IdString	lVendor,
		IdString	rVendor
	)		const

Definition at line 341 of file VendorAttr.cc.

◆ relaxedEquivalent() [3/4]

bool zypp::VendorAttr::relaxedEquivalent	(	sat::Solvable	lVendor,
		sat::Solvable	rVendor
	)		const

Definition at line 347 of file VendorAttr.cc.

◆ relaxedEquivalent() [4/4]

bool zypp::VendorAttr::relaxedEquivalent	(	const PoolItem &	lVendor,
		const PoolItem &	rVendor
	)		const

Definition at line 350 of file VendorAttr.cc.

◆ foreachVendorList()

unsigned zypp::VendorAttr::foreachVendorList ( std::function< bool(VendorList)> fnc_r ) const

Call fnc_r for each equivalent vendor list (return false to break).

Returns: The number of calls to fnc_r.

Definition at line 303 of file VendorAttr.cc.

◆ _addVendorList()

void zypp::VendorAttr::_addVendorList ( VendorList && list_r )

Definition at line 300 of file VendorAttr.cc.

Friends And Related Function Documentation

◆ operator<< [1/2]

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

friend

Definition at line 355 of file VendorAttr.cc.

◆ operator<<() [2/2]

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

Definition at line 355 of file VendorAttr.cc.

Member Data Documentation

◆ _pimpl

RWCOW_pointer<Impl> zypp::VendorAttr::_pimpl

Implementation class.

Pointer to implementation.

Definition at line 162 of file VendorAttr.h.

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

zypp/VendorAttr.h
zypp/VendorAttr.cc

Classes

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Friends

Related Functions

Detailed Description

Member Typedef Documentation

◆ VendorList

Constructor & Destructor Documentation

◆ VendorAttr() [1/2]

◆ VendorAttr() [2/2]

◆ ~VendorAttr()

Member Function Documentation

◆ instance()

◆ noTargetInstance()

◆ addVendorDirectory()

◆ addVendorFile()

◆ addVendorList() [1/4]

◆ addVendorList() [2/4]

◆ addVendorList() [3/4]

◆ addVendorList() [4/4]

◆ equivalent() [1/4]

◆ equivalent() [2/4]

◆ equivalent() [3/4]

◆ equivalent() [4/4]

◆ relaxedEquivalent() [1/4]

◆ relaxedEquivalent() [2/4]

◆ relaxedEquivalent() [3/4]

◆ relaxedEquivalent() [4/4]

◆ foreachVendorList()

◆ _addVendorList()

Friends And Related Function Documentation

◆ operator<< [1/2]

◆ operator<<() [2/2]

Member Data Documentation

◆ _pimpl