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

Manage access to librpm database. More...

#include <librpmDb.h>

Inheritance diagram for zypp::target::rpm::librpmDb:

Classes

class  D
 librpmDb internal database handle More...
 
class  db_const_iterator
 Subclass to retrieve database content. More...
 

Public Types

typedef intrusive_ptr< librpmDbPtr
 
typedef intrusive_ptr< const librpmDbconstPtr
 

Public Member Functions

virtual ~librpmDb ()
 Destructor. More...
 
const Pathnameroot () const
 
const PathnamedbPath () const
 
shared_ptr< RpmExceptionerror () const
 Return any database error. More...
 
bool valid () const
 
bool empty () const
 
unsigned size () const
 
void * dont_call_it () const
 Dont call it ;) It's for development and testing only. More...
 
virtual std::ostream & dumpOn (std::ostream &str) const
 Dump debug info. More...
 
- Public Member Functions inherited from zypp::base::ReferenceCounted
 ReferenceCounted ()
 Default ctor. More...
 
 ReferenceCounted (const ReferenceCounted &rhs)
 Copy ctor. More...
 
virtual ~ReferenceCounted ()
 Dtor. More...
 
ReferenceCountedoperator= (const ReferenceCounted &)
 Assignment. More...
 
unsigned refCount () const
 Return reference counter value. More...
 
void ref () const
 Add a reference. More...
 
void unref () const
 Release a reference. More...
 

Static Public Member Functions

static bool globalInit ()
 Initialize lib librpm (read configfiles etc.). More...
 
static std::string expand (const std::string &macro_r)
 
static std::string stringPath (const Pathname &root_r, const Pathname &sub_r)
 
static const PathnamedefaultRoot ()
 
static const PathnamedefaultDbPath ()
 
static void dbAccess (const Pathname &root_r)
 Adjust access to the given database location, making it the new default location on success. More...
 
static void dbAccess (librpmDb::constPtr &ptr_r)
 Same as &ref dbAccess(), but returns the database handle if avaialble, otherwise NULL. More...
 
static unsigned dbRelease (bool force_r=false)
 If there are no outstanding references to the database (e.g. More...
 
static unsigned blockAccess ()
 Blocks further access to rpmdb. More...
 
static void unblockAccess ()
 Allow access to rpmdb e.g. More...
 
static bool isBlocked ()
 
static std::ostream & dumpState (std::ostream &str)
 Dump debug info. More...
 
- Static Public Member Functions inherited from zypp::base::ReferenceCounted
static void add_ref (const ReferenceCounted *ptr_r)
 Called by zypp::intrusive_ptr to add a reference. More...
 
static void release (const ReferenceCounted *ptr_r)
 Called by zypp::intrusive_ptr to add a reference. More...
 

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. More...
 
virtual void unref_to (unsigned refCount_r) const
 Trigger from Rep, after refCount was decreased. More...
 
- Protected Member Functions inherited from zypp::base::ReferenceCounted
virtual void ref_to (unsigned) const
 Trigger derived classes after refCount was increased. More...
 

Static Private Member Functions

static void dbAccess (librpmDb::Ptr &ptr_r)
 INTENTIONALLY UNDEFINED<\B> because of bug in Ptr classes which allows implicit conversion from librpmDb::Ptr to librpmDb::constPtr. More...
 
static librpmDbnewLibrpmDb ()
 For internal use. More...
 
static void dbAccess ()
 Access the database at the current default location. More...
 

Private Attributes

D_d
 

Static Private Attributes

static Pathname _defaultRoot
 Current root directory for all operations. More...
 
static const Pathname _defaultDbPath
 Current directory (below root) that contains the rpmdb. More...
 
static librpmDb::constPtr _defaultDb
 Current rpmdb handle. More...
 
static bool _dbBlocked
 Whether access is blocked (no _defaultDb will be available). More...
 

Additional Inherited Members

Detailed Description

Manage access to librpm database.

Definition at line 38 of file librpmDb.h.

Member Typedef Documentation

◆ Ptr

◆ constPtr

Definition at line 42 of file librpmDb.h.

Constructor & Destructor Documentation

◆ librpmDb()

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 349 of file librpmDb.cc.

◆ ~librpmDb()

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

Destructor.

Closes rpmdb.

Definition at line 361 of file librpmDb.cc.

Member Function Documentation

◆ dbAccess() [1/4]

static void zypp::target::rpm::librpmDb::dbAccess ( librpmDb::Ptr ptr_r)
staticprivate

INTENTIONALLY UNDEFINED<\B> 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

◆ newLibrpmDb()

librpmDb * zypp::target::rpm::librpmDb::newLibrpmDb ( )
staticprivate

For internal use.

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

Exceptions
RpmException

Definition at line 166 of file librpmDb.cc.

◆ dbAccess() [2/4]

void zypp::target::rpm::librpmDb::dbAccess ( )
staticprivate

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 231 of file librpmDb.cc.

◆ globalInit()

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 115 of file librpmDb.cc.

◆ expand()

std::string zypp::target::rpm::librpmDb::expand ( const std::string &  macro_r)
static
Returns
librpm macro expansion.

Definition at line 146 of file librpmDb.cc.

◆ stringPath()

static std::string zypp::target::rpm::librpmDb::stringPath ( const Pathname root_r,
const Pathname sub_r 
)
inlinestatic
Returns
String '(root_r)sub_r' used in debug output.

Definition at line 127 of file librpmDb.h.

◆ defaultRoot()

static const Pathname& zypp::target::rpm::librpmDb::defaultRoot ( )
inlinestatic
Returns
Current root directory for all operations.

Definition at line 137 of file librpmDb.h.

◆ defaultDbPath()

static const Pathname& zypp::target::rpm::librpmDb::defaultDbPath ( )
inlinestatic
Returns
Current directory (below root) that contains the rpmdb.

Definition at line 145 of file librpmDb.h.

◆ dbAccess() [3/4]

void zypp::target::rpm::librpmDb::dbAccess ( const Pathname root_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 196 of file librpmDb.cc.

◆ dbAccess() [4/4]

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

Definition at line 251 of file librpmDb.cc.

◆ dbRelease()

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.

Returns
The number of outstandig references to the database, 0 if if database was physically closed.

Definition at line 264 of file librpmDb.cc.

◆ blockAccess()

unsigned zypp::target::rpm::librpmDb::blockAccess ( )
static

Blocks further access to rpmdb.

Basically the same as dbRelease( true ), but subsequent calls to dbAccess will fail returning E_RpmDB_access_blocked.

Returns
The number of outstandig references to the database, 0 if if database was physically closed.

Definition at line 301 of file librpmDb.cc.

◆ unblockAccess()

void zypp::target::rpm::librpmDb::unblockAccess ( )
static

Allow access to rpmdb e.g.

after blockAccess. Subsequent calls to dbAccess will perform.

NOTE: Initially we're in blocked mode. So you must call unblockAccess unblockAccess at least once. Othwise nothing will happen.

Returns
The number of outstandig references to the database, 0 if if database was physically closed.

Definition at line 314 of file librpmDb.cc.

◆ isBlocked()

static bool zypp::target::rpm::librpmDb::isBlocked ( )
inlinestatic
Returns
Whether database access is blocked.

Definition at line 215 of file librpmDb.h.

◆ dumpState()

std::ostream & zypp::target::rpm::librpmDb::dumpState ( std::ostream &  str)
static

Dump debug info.

Definition at line 326 of file librpmDb.cc.

◆ unref_to()

void zypp::target::rpm::librpmDb::unref_to ( unsigned  refCount_r) const
protectedvirtual

Trigger from Rep, after refCount was decreased.

Reimplemented from zypp::base::ReferenceCounted.

Definition at line 372 of file librpmDb.cc.

◆ root()

const Pathname & zypp::target::rpm::librpmDb::root ( ) const
Returns
This handles root directory for all operations.

Definition at line 386 of file librpmDb.cc.

◆ dbPath()

const Pathname & zypp::target::rpm::librpmDb::dbPath ( ) const
Returns
This handles directory that contains the rpmdb.

Definition at line 397 of file librpmDb.cc.

◆ error()

shared_ptr< RpmException > zypp::target::rpm::librpmDb::error ( ) const

Return any database error.

Usg. if the database was blocked by calling dbRelease(true) or blockAccess.

Definition at line 408 of file librpmDb.cc.

◆ valid()

bool zypp::target::rpm::librpmDb::valid ( ) const
inline
Returns
Whether handle is valid.

Definition at line 284 of file librpmDb.h.

◆ empty()

bool zypp::target::rpm::librpmDb::empty ( ) const
Returns
True if handle is valid and database is empty.

Definition at line 419 of file librpmDb.cc.

◆ size()

unsigned zypp::target::rpm::librpmDb::size ( ) const
Returns
Number of entries in the database (0 if not valid).

Definition at line 430 of file librpmDb.cc.

◆ dont_call_it()

void * zypp::target::rpm::librpmDb::dont_call_it ( ) const

Dont call it ;) It's for development and testing only.

Definition at line 448 of file librpmDb.cc.

◆ dumpOn()

std::ostream & zypp::target::rpm::librpmDb::dumpOn ( std::ostream &  str) const
virtual

Dump debug info.

Reimplemented from zypp::base::ReferenceCounted.

Definition at line 461 of file librpmDb.cc.

Member Data Documentation

◆ _defaultRoot

Pathname zypp::target::rpm::librpmDb::_defaultRoot
staticprivate

Current root directory for all operations.

(initialy /)

Definition at line 68 of file librpmDb.h.

◆ _defaultDbPath

const Pathname zypp::target::rpm::librpmDb::_defaultDbPath
staticprivate

Current directory (below root) that contains the rpmdb.

(initialy /var/lib/rpm)

Definition at line 74 of file librpmDb.h.

◆ _defaultDb

librpmDb::constPtr zypp::target::rpm::librpmDb::_defaultDb
staticprivate

Current rpmdb handle.

Definition at line 79 of file librpmDb.h.

◆ _dbBlocked

bool zypp::target::rpm::librpmDb::_dbBlocked
staticprivate

Whether access is blocked (no _defaultDb will be available).

Definition at line 84 of file librpmDb.h.

◆ _d

D& zypp::target::rpm::librpmDb::_d
private

Definition at line 242 of file librpmDb.h.


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