---

DBI.

Files
file	rpmdb.c
file	rpmdb.h
	Access RPM indices using Berkeley DB interface(s).
file	rpmlib.h
Data Structures
struct	_dbiIndex
struct	_dbiIndexItem
struct	_dbiIndexSet
struct	_dbiIR
struct	_dbiVec
Functions
dbiIndex	dbiOpen (rpmdb rpmdb, int rpmtag, unsigned int flags)
int	dbiCopen (dbiIndex dbi, void **dbcp, unsigned int flags)
int	dbiCclose (dbiIndex dbi, void *dbcursor, unsigned int flags)
int	dbiDel (dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, unsigned int flags)
int	dbiGet (dbiIndex dbi, void *dbcursor, void **keypp, size_t *keylenp, void **datapp, size_t *datalenp, unsigned int flags)
int	dbiPut (dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, const void *datap, size_t datalen, unsigned int flags)
int	dbiClose (dbiIndex dbi, unsigned int flags)
int	dbiSync (dbiIndex dbi, unsigned int flags)
int	dbiByteSwapped (dbiIndex dbi)
void	dbiFreeIndexSet (dbiIndexSet set)
unsigned int	dbiIndexSetCount (dbiIndexSet set)
unsigned int	dbiIndexRecordOffset (dbiIndexSet set, int recno)
unsigned int	dbiIndexRecordFileNumber (dbiIndexSet set, int recno)
Variables
int (*	open )(rpmdb rpmdb, int rpmtag, dbiIndex *dbip)
int (*	close )(dbiIndex dbi, unsigned int flags)
int (*	sync )(dbiIndex dbi, unsigned int flags)
int (*	copen )(dbiIndex dbi, void **dbcp, unsigned int flags)
int (*	cclose )(dbiIndex dbi, void *dbcursor, unsigned int flags)
int (*	cdel )(dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, unsigned int flags)
int (*	cget )(dbiIndex dbi, void *dbcursor, void **keypp, size_t *keylenp, void **datapp, size_t *datalenp, unsigned int flags)
int (*	cput )(dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, const void *datap, size_t datalen, unsigned int flags)
int (*	byteswapped )(dbiIndex dbi)

---

Function Documentation

int dbiByteSwapped ( dbiIndex dbi )

Is database byte swapped? Parameters: dbi   index database handle Returns: 0 no Definition at line 146 of file rpmdb.c. Referenced by dbiSearch(), and dbiUpdateIndex().

int dbiCclose ( dbiIndex dbi, void * dbcursor, unsigned int flags )

Parameters: dbi   index database handle flags   (unused)

int dbiClose ( dbiIndex dbi, unsigned int flags )

Close index database. Parameters: dbi   index database handle flags   (unused) Returns: 0 on success Definition at line 233 of file rpmdb.c. Referenced by rpmdbClose().

int dbiCopen ( dbiIndex dbi, void ** dbcp, unsigned int flags )

Parameters: dbi   index database handle flags   (unused)

int dbiDel ( dbiIndex dbi, void * dbcursor, const void * keyp, size_t keylen, unsigned int flags )

Delete (key,data) pair(s) from index database. Parameters: dbi   index database handle keyp   key data keylen   key data length flags   (unused) Returns: 0 on success Definition at line 166 of file rpmdb.c. Referenced by dbiUpdateIndex(), and rpmdbRemove().

void dbiFreeIndexSet ( dbiIndexSet set )

Destroy set of index database items. Parameters: set   set of index database items Definition at line 612 of file rpmdb.c. Referenced by addIndexEntry(), dbiFindByLabel(), dbiFindMatches(), removeIndexEntry(), rpmRunTransactions(), rpmdbCountPackages(), rpmdbFindByFile(), rpmdbFreeIterator(), rpmdbGrowIterator(), and rpmdbInitIterator().

int dbiGet ( dbiIndex dbi, void * dbcursor, void ** keypp, size_t * keylenp, void ** datapp, size_t * datalenp, unsigned int flags )

Retrieve (key,data) pair from index database. Parameters: dbi   index database handle keypp   address of key data keylenp   address of key data length datapp   address of data pointer datalenp   address of data length flags   (unused) Returns: 0 on success Definition at line 183 of file rpmdb.c. Referenced by XrpmdbNextIterator(), dbiSearch(), openDatabase(), rpmdbAdd(), and unsatisfiedDepend().

unsigned int dbiIndexRecordFileNumber ( dbiIndexSet set, int recno )

Return file index from element in index database set. Parameters: set   set of index database items recno   index of item in set Returns: file index Definition at line 607 of file rpmdb.c. Referenced by XrpmdbNextIterator(), rpmRunTransactions(), and rpmdbFindByFile().

unsigned int dbiIndexRecordOffset ( dbiIndexSet set, int recno )

Return record offset of header from element in index database set. Parameters: set   set of index database items recno   index of item in set Returns: record offset of header Definition at line 602 of file rpmdb.c. Referenced by XrpmdbNextIterator(), dbiFindMatches(), rpmRunTransactions(), and rpmdbFindByFile().

unsigned int dbiIndexSetCount ( dbiIndexSet set )

Count items in index database set. Parameters: set   set of index database items Returns: number of items Definition at line 597 of file rpmdb.c. Referenced by dbiFindMatches(), rpmRunTransactions(), and rpmdbCountPackages().

dbiIndex dbiOpen ( rpmdb rpmdb, int rpmtag, unsigned int flags )

Return handle for an index database. Parameters: rpmdb   rpm database rpmtag   rpm tag flags   (unused) Returns: index database handle Definition at line 239 of file rpmdb.c. Referenced by XrpmdbNextIterator(), openDatabase(), rpmdbAdd(), rpmdbCountPackages(), rpmdbFindByFile(), rpmdbFreeIterator(), rpmdbGrowIterator(), rpmdbInitIterator(), rpmdbOpenAll(), rpmdbRemove(), and unsatisfiedDepend().

int dbiPut ( dbiIndex dbi, void * dbcursor, const void * keyp, size_t keylen, const void * datap, size_t datalen, unsigned int flags )

Store (key,data) pair in index database. Parameters: dbi   index database handle keyp   key data keylen   key data length datap   data pointer datalen   data length flags   (unused) Returns: 0 on success Definition at line 212 of file rpmdb.c. Referenced by dbiUpdateIndex(), dbiUpdateRecord(), rpmdbAdd(), and unsatisfiedDepend().

int dbiSync ( dbiIndex dbi, unsigned int flags )

Flush pending operations to disk. Parameters: dbi   index database handle flags   (unused) Returns: 0 on success Definition at line 140 of file rpmdb.c. Referenced by dbiUpdateRecord(), rpmdbAdd(), rpmdbRemove(), and rpmdbSync().

---

Variable Documentation

int(* _dbiVec::byteswapped)(dbiIndex dbi)

Is database byte swapped? Parameters: dbi   index database handle Returns: 0 no

int(* _dbiVec::cclose)(dbiIndex dbi, void *dbcursor, unsigned int flags)

Close database cursor. Parameters: dbi   index database handle dbcursor   database cursor flags   (unused)

int(* _dbiVec::cdel)(dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, unsigned int flags)

Delete (key,data) pair(s) using db->del or dbcursor->c_del. Parameters: dbi   index database handle dbcursor   database cursor keyp   key data keylen   key data length flags   (unused) Returns: 0 on success

int(* _dbiVec::cget)(dbiIndex dbi, void *dbcursor, void **keypp, size_t *keylenp, void **datapp, size_t *datalenp, unsigned int flags)

Retrieve (key,data) pair using db->get or dbcursor->c_get. Parameters: dbi   index database handle dbcursor   database cursor keypp   address of key data keylenp   address of key data length datapp   address of data pointer datalenp   address of data length flags   (unused) Returns: 0 on success

int(* _dbiVec::close)(dbiIndex dbi, unsigned int flags)

Close index database. Parameters: dbi   index database handle flags   (unused) Returns: 0 on success

int(* _dbiVec::copen)(dbiIndex dbi, void **dbcp, unsigned int flags)

Open database cursor. Parameters: dbi   index database handle dbcp   address of database cursor flags   (unused)

int(* _dbiVec::cput)(dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, const void *datap, size_t datalen, unsigned int flags)

Store (key,data) pair using db->put or dbcursor->c_put. Parameters: dbi   index database handle dbcursor   database cursor keyp   key data keylen   key data length datap   data pointer datalen   data length flags   (unused) Returns: 0 on success

int(* _dbiVec::open)(rpmdb rpmdb, int rpmtag, dbiIndex *dbip)

Return handle for an index database. Parameters: rpmdb   rpm database rpmtag   rpm tag Returns: 0 on success

int(* _dbiVec::sync)(dbiIndex dbi, unsigned int flags)

Flush pending operations to disk. Parameters: dbi   index database handle flags   (unused) Returns: 0 on success

---