libzypp: zypp::target::rpm::librpmDb Class Reference

List of all members.


Public Types
typedef intrusive_ptr < librpmDb >	Ptr
typedef intrusive_ptr< const librpmDb >	constPtr
Public Member Functions
virtual	~librpmDb ()
	Destructor.
const Pathname &	root () const
	Returns: This handles root directory for all operations.
const Pathname &	dbPath () const
	Returns: This handles directory that contains the rpmdb.
shared_ptr < RpmException >	error () const
	Return any database error.
bool	valid () const
	Returns: Whether handle is valid.
bool	empty () const
	Returns: True if handle is valid and database is empty.
unsigned	size () const
	Returns: Number of entries in the database (0 if not valid).
void *	dont_call_it () const
	Dont call it ;) It's for development and testing only.
virtual std::ostream &	dumpOn (std::ostream &str) const
	Dump debug info.
Static Public Member Functions
static bool	globalInit ()
	Initialize lib librpm (read configfiles etc.
static std::string	expand (const std::string &macro_r)
	Returns: librpm macro expansion.
static std::string	stringPath (const Pathname &root_r, const Pathname &sub_r)
	Returns: String '(root_r)sub_r' used in debug output.
static const Pathname &	defaultRoot ()
	Returns: Current root directory for all operations.
static const Pathname &	defaultDbPath ()
	Returns: Current directory (below root) that contains the rpmdb.
static void	dbAccess (const Pathname &root_r, const Pathname &dbPath_r)
	Adjust access to the given database location, making it the new default location on success.
static void	dbAccess (librpmDb::constPtr &ptr_r)
	Same as &ref dbAccess(), but returns the database handle if avaialble, otherwise NULL.
static unsigned	dbRelease (bool force_r=false)
	If there are no outstanding references to the database (e.g.
static unsigned	blockAccess ()
	Blocks further access to rpmdb.
static void	unblockAccess ()
	Allow access to rpmdb e.g.
static bool	isBlocked ()
	Returns: Whether database access is blocked.
static std::ostream &	dumpState (std::ostream &str)
	Dump debug info.
Protected Member Functions
	librpmDb (const Pathname &root_r, const Pathname &dbPath_r, bool readonly_r)
	Private constructor! librpmDb objects are to be created via static interface only.
virtual void	unref_to (unsigned refCount_r) const
	Trigger from Rep, after refCount was decreased.
Static Private Member Functions
static void	dbAccess (librpmDb::Ptr &ptr_r)
	INTENTIONALLY UNDEFINED<> because of bug in Ptr classes which allows implicit conversion from librpmDb::Ptr to librpmDb::constPtr.
static librpmDb *	newLibrpmDb (Pathname root_r, Pathname dbPath_r, bool readonly_r)
	For internal use.
static void	dbAccess ()
	Access the database at the current default location.
Private Attributes
D &	_d
Static Private Attributes
static Pathname	_defaultRoot
	Current root directory for all operations.
static Pathname	_defaultDbPath
	Current directory (below root) that contains the rpmdb.
static librpmDb::constPtr	_defaultDb
	Current rpmdb handle.
static bool	_dbBlocked
	Wheter access is blocked (no _defaultDb will be available).
Classes
class	D
class	db_const_iterator
class	DbDirInfo
	Collect info about what kind of rpmdb seems to be present by looking at paths and filenames. More...

Detailed Description

Member Typedef Documentation

typedef intrusive_ptr<librpmDb> zypp::target::rpm::librpmDb::Ptr

Definition at line 41 of file librpmDb.h.

typedef intrusive_ptr<const librpmDb> zypp::target::rpm::librpmDb::constPtr

Definition at line 42 of file librpmDb.h.

Constructor & Destructor Documentation

zypp::target::rpm::librpmDb::librpmDb	(	const Pathname &	root_r,
		const Pathname &	dbPath_r,
		bool	readonly_r
	)			`[protected]`

Private constructor! librpmDb objects are to be created via static interface only.

Definition at line 372 of file librpmDb.cc.

Referenced by newLibrpmDb().

zypp::target::rpm::librpmDb::~librpmDb ( ) [virtual]

Destructor.

Closes rpmdb.

Definition at line 384 of file librpmDb.cc.

References _d.

Member Function Documentation

void zypp::target::rpm::librpmDb::dbAccess ( librpmDb::Ptr & ptr_r ) [static, private]

INTENTIONALLY UNDEFINED<> because of bug in Ptr classes which allows implicit conversion from librpmDb::Ptr to librpmDb::constPtr.

Currently we don't want to provide non const handles, as the database is opened READONLY.

Exceptions:

RpmException

Definition at line 266 of file librpmDb.cc.

References _defaultDb, dbAccess(), ZYPP_CAUGHT, and ZYPP_RETHROW.

librpmDb * zypp::target::rpm::librpmDb::newLibrpmDb	(	Pathname	root_r,
		Pathname	dbPath_r,
		bool	readonly_r
	)			`[static, private]`

For internal use.

Pointer returned should immediately be wrapped into librpmDb::Ptr.

Exceptions:

RpmException

Definition at line 177 of file librpmDb.cc.

References globalInit(), librpmDb(), ZYPP_CAUGHT, ZYPP_RETHROW, and ZYPP_THROW.

Referenced by dbAccess().

void zypp::target::rpm::librpmDb::dbAccess ( ) [static, private]

Access the database at the current default location.

If necessary (eg. after dbRelease), the database is opened. This just creates the internal handle. Once the handle is passed to e.g. some db_const_iterator, the database will be closed if the last outstanding reference goes out of scope. If no external reference is created, you'll have to explicitly call dbRelease to close the database.

Exceptions:

RpmException

Definition at line 246 of file librpmDb.cc.

References _dbBlocked, _defaultDb, _defaultDbPath, _defaultRoot, newLibrpmDb(), and ZYPP_THROW.

Referenced by zypp::target::rpm::librpmDb::db_const_iterator::D::D(), dbAccess(), zypp::target::rpm::RpmDb::doGetPackages(), and zypp::target::rpm::RpmDb::internal_initDatabase().

bool zypp::target::rpm::librpmDb::globalInit ( ) [static]

Initialize lib librpm (read configfiles etc.

). It's called on demand but you may call it anytime.

Returns:: Whether librpm is initialized.

Definition at line 123 of file librpmDb.cc.

References ERR, MIL, and OUTVAL.

Referenced by expand(), and newLibrpmDb().

std::string zypp::target::rpm::librpmDb::expand ( const std::string & macro_r ) [static]

Returns:: librpm macro expansion.

Definition at line 157 of file librpmDb.cc.

References globalInit().

static std::string zypp::target::rpm::librpmDb::stringPath	(	const Pathname &	root_r,
		const Pathname &	sub_r
	)			`[inline, static]`

Returns:: String '(root_r)sub_r' used in debug output.

Definition at line 127 of file librpmDb.h.

Referenced by dbAccess().

static const Pathname& zypp::target::rpm::librpmDb::defaultRoot ( ) [inline, static]

Returns:: Current root directory for all operations.

Definition at line 137 of file librpmDb.h.

References _defaultRoot.

static const Pathname& zypp::target::rpm::librpmDb::defaultDbPath ( ) [inline, static]

Returns:: Current directory (below root) that contains the rpmdb.

Definition at line 145 of file librpmDb.h.

References _defaultDbPath.

void zypp::target::rpm::librpmDb::dbAccess	(	const Pathname &	root_r,
		const Pathname &	dbPath_r
	)			`[static]`

Adjust access to the given database location, making it the new default location on success.

No relative Pathnames are allowed.

It's not possible to access a database while access is blocked (see blockAccess), but valid Pathnames provided will be stored as new default location.

It's not allowed to switch to another location while a database is accessed. Use dbRelease to force releasing the database first.

Exceptions:

RpmException

Definition at line 213 of file librpmDb.cc.

References _defaultDb, _defaultDbPath, _defaultRoot, dbAccess(), MIL, stringPath(), and ZYPP_THROW.

static void zypp::target::rpm::librpmDb::dbAccess ( librpmDb::constPtr & ptr_r ) [static]

Same as &ref dbAccess(), but returns the database handle if avaialble, otherwise NULL.

This creates an external reference, thus it should not be used longer than necessary. Be prepared that the handle might become invalid (see dbRelease) later.

Exceptions:

RpmException

unsigned zypp::target::rpm::librpmDb::dbRelease ( bool force_r = false ) [static]

If there are no outstanding references to the database (e.g.

by db_const_iterator), the database is closed. Subsequent calls to dbAccess may however open the database again.

If forced, the internal reference is dropped and it will look like the database was closed. But physically the database will be closed after all outstanding references are gone.