Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages  

rpmdb/rpmdb.c File Reference

More...

#include "system.h"
#include <sys/file.h>
#include <signal.h>
#include <sys/signal.h>
#include <fnmatch.h>
#include <regex.h>
#include <rpmcli.h>
#include "rpmdb.h"
#include "fprint.h"
#include "misc.h"
#include "debug.h"

Go to the source code of this file.

Data Structures

union  _dbswap
struct  _rpmdbMatchIterator
struct  miRE_s

Defines

#define INLINE
#define _DBI_FLAGS   0
#define _DBI_PERMS   0644
#define _DBI_MAJOR   -1
#define DB1vec   NULL
#define DB2vec   NULL
#define DB3vec   NULL
#define _DBSWAP(_a)
#define _DB_ROOT   "/"
#define _DB_HOME   "%{_dbpath}"
#define _DB_FLAGS   0
#define _DB_MODE   0
#define _DB_PERMS   0644
#define _DB_MAJOR   -1
#define _DB_ERRPFX   "rpmdb"
#define _RECNUM   rpmdbGetIteratorOffset(mi)

Typedefs

typedef struct miRE_s *  miRE

Functions

unsigned char nibble (char c)
 Convert hex to binary nibble. More...

int printable (const void *ptr, size_t len)
 Check key for printable characters. More...

int dbiTagToDbix (int rpmtag)
 Return dbi index used for rpm tag. More...

void dbiTagsInit (void)
 Initialize database (index, tag) tuple from configuration. More...

int dbiSync (dbiIndex dbi, unsigned int flags)
int dbiByteSwapped (dbiIndex dbi)
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 dbiCount (dbiIndex dbi, void *dbcursor, unsigned int *countp, unsigned int flags)
int dbiVerify (dbiIndex dbi, unsigned int flags)
int dbiClose (dbiIndex dbi, unsigned int flags)
dbiIndex dbiOpen (rpmdb db, int rpmtag, unsigned int flags)
dbiIndexItem dbiIndexNewItem (unsigned int hdrNum, unsigned int tagNum)
 Create and initialize item for index database set. More...

int dbiSearch (dbiIndex dbi, void *dbcursor, const char *keyp, size_t keylen, dbiIndexSet *setp)
 Return items that match criteria. More...

int dbiUpdateIndex (dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, dbiIndexSet set)
 Change/delete items that match criteria. More...

int hdrNumCmp (const void *one, const void *two)
int dbiAppendSet (dbiIndexSet set, const void *recs, int nrecs, size_t recsize, int sortset)
 Append element(s) to set of index database items. More...

int dbiPruneSet (dbiIndexSet set, void *recs, int nrecs, size_t recsize, int sorted)
 Remove element(s) from set of index database items. More...

unsigned int dbiIndexSetCount (dbiIndexSet set)
unsigned int dbiIndexRecordOffset (dbiIndexSet set, int recno)
unsigned int dbiIndexRecordFileNumber (dbiIndexSet set, int recno)
dbiIndexSet dbiFreeIndexSet (dbiIndexSet set)
int blockSignals (rpmdb db, sigset_t *oldMask)
 Disable all signals, returning previous signal mask. More...

int unblockSignals (rpmdb db, sigset_t *oldMask)
 Restore signal mask. More...

int rpmdbOpenAll (rpmdb db)
int rpmdbClose (rpmdb db)
int rpmdbSync (rpmdb db)
rpmdb newRpmdb (const char *root, const char *home, int mode, int perms, int flags)
int openDatabase (const char *prefix, const char *dbpath, int _dbapi, rpmdb *dbp, int mode, int perms, int flags)
int rpmdbOpen (const char *prefix, rpmdb *dbp, int mode, int perms)
int rpmdbInit (const char *prefix, int perms)
int rpmdbVerify (const char *prefix)
int rpmdbFindByFile (rpmdb db, const char *filespec, dbiIndexSet *matches)
int rpmdbCountPackages (rpmdb db, const char *name)
int dbiFindMatches (dbiIndex dbi, void *dbcursor, const char *name, const char *version, const char *release, dbiIndexSet *matches)
 Attempt partial matches on name[-version[-release]] strings. More...

int dbiFindByLabel (dbiIndex dbi, void *dbcursor, const char *arg, dbiIndexSet *matches)
 Lookup by name, name-version, and finally by name-version-release. More...

int dbiUpdateRecord (dbiIndex dbi, void *dbcursor, int offset, Header h)
 Rewrite a header in the database. More...

rpmdbMatchIterator rpmdbFreeIterator (rpmdbMatchIterator mi)
rpmdb rpmdbGetIteratorRpmDB (rpmdbMatchIterator mi)
unsigned int rpmdbGetIteratorOffset (rpmdbMatchIterator mi)
unsigned int rpmdbGetIteratorFileNum (rpmdbMatchIterator mi)
int rpmdbGetIteratorCount (rpmdbMatchIterator mi)
int miregexec (miRE mire, const char *val)
 Return pattern match. More...

int mireCmp (const void *a, const void *b)
 Compare iterator selctors by rpm tag (qsort/bsearch). More...

char* mireDup (rpmTag tag, rpmMireMode *modep, const char *pattern)
 Copy pattern, escaping for appropriate mode. More...

int rpmdbSetIteratorRE (rpmdbMatchIterator mi, rpmTag tag, rpmMireMode mode, const char *pattern)
int mireSkip (const rpmdbMatchIterator mi)
 Return iterator selector match. More...

int rpmdbSetIteratorRelease (rpmdbMatchIterator mi, const char *release)
int rpmdbSetIteratorVersion (rpmdbMatchIterator mi, const char *version)
int rpmdbSetIteratorRewrite (rpmdbMatchIterator mi, int rewrite)
int rpmdbSetIteratorModified (rpmdbMatchIterator mi, int modified)
Header XrpmdbNextIterator (rpmdbMatchIterator mi, const char *f, unsigned int l)
Header rpmdbNextIterator (rpmdbMatchIterator mi)
void rpmdbSortIterator (rpmdbMatchIterator mi)
int rpmdbGrowIterator (rpmdbMatchIterator mi, const void *keyp, size_t keylen, int fpNum)
int rpmdbPruneIterator (rpmdbMatchIterator mi, int *hdrNums, int nHdrNums, int sorted)
int rpmdbAppendIterator (rpmdbMatchIterator mi, const int *hdrNums, int nHdrNums)
rpmdbMatchIterator rpmdbInitIterator (rpmdb db, int rpmtag, const void *keyp, size_t keylen)
int removeIndexEntry (dbiIndex dbi, void *dbcursor, const void *keyp, size_t keylen, dbiIndexItem rec)
 Remove entry from database index. More...

int rpmdbRemove (rpmdb db, int rid, unsigned int hdrNum)
int addIndexEntry (dbiIndex dbi, void *dbcursor, const char *keyp, size_t keylen, dbiIndexItem rec)
 Add entry to database index. More...

int rpmdbAdd (rpmdb db, int iid, Header h)
int rpmdbFindFpList (rpmdb db, fingerPrint *fpList, dbiIndexSet *matchList, int numItems)
char* db1basename (int rpmtag)
int rpmioFileExists (const char *urlfn)
 Check if file esists using stat(2). More...

int rpmdbRemoveDatabase (const char *prefix, const char *dbpath, int _dbapi)
int rpmdbMoveDatabase (const char *prefix, const char *olddbpath, int _olddbapi, const char *newdbpath, int _newdbapi)
int rpmdbRebuild (const char *prefix)

Variables

int _debug = 0
int _noDirTokens
int _rebuildinprogress = 0
int _db_filter_dups = 0
int* dbiTags = NULL
int dbiTagsMax = 0
struct _dbiVecmydbvecs []
struct rpmdb_s dbTemplate


Detailed Description

Definition in file rpmdb.c.


Define Documentation

#define DB1vec   NULL
 

Definition at line 181 of file rpmdb.c.

#define DB2vec   NULL
 

Definition at line 189 of file rpmdb.c.

#define DB3vec   NULL
 

Definition at line 197 of file rpmdb.c.

#define INLINE
 

Value:

Definition at line 46 of file rpmdb.c.

#define _DBI_FLAGS   0
 

Definition at line 56 of file rpmdb.c.

#define _DBI_MAJOR   -1
 

Definition at line 58 of file rpmdb.c.

#define _DBI_PERMS   0644
 

Definition at line 57 of file rpmdb.c.

#define _DBSWAP( _a )
 

Value:

  { unsigned char _b, *_c = (_a).uc; \
    _b = _c[3]; _c[3] = _c[0]; _c[0] = _b; \
    _b = _c[2]; _c[2] = _c[1]; _c[1] = _b; \
  }

Definition at line 507 of file rpmdb.c.

Referenced by dbiSearch(), and dbiUpdateIndex().

#define _DB_ERRPFX   "rpmdb"
 

Definition at line 831 of file rpmdb.c.

#define _DB_FLAGS   0
 

Definition at line 826 of file rpmdb.c.

#define _DB_HOME   "%{_dbpath}"
 

Definition at line 825 of file rpmdb.c.

#define _DB_MAJOR   -1
 

Definition at line 830 of file rpmdb.c.

#define _DB_MODE   0
 

Definition at line 827 of file rpmdb.c.

#define _DB_PERMS   0644
 

Definition at line 828 of file rpmdb.c.

#define _DB_ROOT   "/"
 

Definition at line 824 of file rpmdb.c.

#define _RECNUM   rpmdbGetIteratorOffset(mi)
 


Typedef Documentation

typedef struct miRE_s * miRE
 


Function Documentation

Header XrpmdbNextIterator ( rpmdbMatchIterator mi,
const char * f,
unsigned int l )
 

Todo:
Remove debugging entry from the ABI.

Definition at line 2059 of file rpmdb.c.

int addIndexEntry ( dbiIndex dbi,
void * dbcursor,
const char * keyp,
size_t keylen,
dbiIndexItem rec ) [static]
 

Add entry to database index.

Parameters:
dbi   index database handle
dbcursor   index database cursor
keyp   search key
keylen   search key length
rec   record to add
Returns:
0 on success

Definition at line 2657 of file rpmdb.c.

Referenced by rpmdbAdd().

int blockSignals ( rpmdb db,
sigset_t * oldMask ) [static]
 

Disable all signals, returning previous signal mask.

Definition at line 804 of file rpmdb.c.

Referenced by dbiUpdateRecord(), rpmdbAdd(), and rpmdbRemove().

int dbiAppendSet ( dbiIndexSet set,
const void * recs,
int nrecs,
size_t recsize,
int sortset ) [static]
 

Append element(s) to set of index database items.

Parameters:
set   set of index database items
recs   array of items to append to set
nrecs   number of items
recsize   size of an array item
sortset   should resulting set be sorted?
Returns:
0 success, 1 failure (bad args)

Definition at line 710 of file rpmdb.c.

Referenced by addIndexEntry(), rpmdbAppendIterator(), rpmdbFindByFile(), and rpmdbFindFpList().

int dbiFindByLabel ( dbiIndex dbi,
void * dbcursor,
const char * arg,
dbiIndexSet * matches ) [static]
 

Lookup by name, name-version, and finally by name-version-release.

Both version and release can be patterns.

Todo:
Name must be an exact match, as name is a db key.
Parameters:
dbi   index database handle (always RPMTAG_NAME)
dbcursor   index database cursor
arg   name[-version[-release]] string
Return values:
matches   set of header instances that match
Returns:
0 on match, 1 on no match, 2 on error

Definition at line 1441 of file rpmdb.c.

Referenced by rpmdbInitIterator().

int dbiFindMatches ( dbiIndex dbi,
void * dbcursor,
const char * name,
const char * version,
const char * release,
dbiIndexSet * matches ) [static]
 

Attempt partial matches on name[-version[-release]] strings.

Parameters:
dbi   index database handle (always RPMTAG_NAME)
dbcursor   index database cursor
name   package name
version   package version (can be a pattern)
release   package release (can be a pattern)
Return values:
matches   set of header instances that match
Returns:
0 on match, 1 on no match, 2 on error

Definition at line 1348 of file rpmdb.c.

Referenced by dbiFindByLabel().

dbiIndexItem dbiIndexNewItem ( unsigned int hdrNum,
unsigned int tagNum ) [static]
 

Create and initialize item for index database set.

Parameters:
hdrNum   header instance in db
tagNum   tag index in header
Returns:
new item

Definition at line 493 of file rpmdb.c.

Referenced by rpmdbAdd(), rpmdbFindByFile(), and rpmdbRemove().

int dbiPruneSet ( dbiIndexSet set,
void * recs,
int nrecs,
size_t recsize,
int sorted ) [static]
 

Remove element(s) from set of index database items.

Parameters:
set   set of index database items
recs   array of items to remove from set
nrecs   number of items
recsize   size of an array item
sorted   array is already sorted?
Returns:
0 success, 1 failure (no items found)

Definition at line 751 of file rpmdb.c.

Referenced by removeIndexEntry(), and rpmdbPruneIterator().

int dbiSearch ( dbiIndex dbi,
void * dbcursor,
const char * keyp,
size_t keylen,
dbiIndexSet * setp ) [static]
 

Return items that match criteria.

Parameters:
dbi   index database handle
dbcursor   index database cursor
keyp   search key
keylen   search key length (0 will use strlen(key))
Return values:
setp   address of items retrieved from index database
Returns:
-1 error, 0 success, 1 not found

Definition at line 522 of file rpmdb.c.

Referenced by addIndexEntry(), dbiFindMatches(), removeIndexEntry(), rpmdbCountPackages(), rpmdbFindByFile(), rpmdbGrowIterator(), and rpmdbInitIterator().

int dbiTagToDbix ( int rpmtag ) [static]
 

Return dbi index used for rpm tag.

Parameters:
rpmtag   rpm header tag
Returns:
dbi index, -1 on error

Definition at line 102 of file rpmdb.c.

Referenced by dbiOpen(), and dbiTagsInit().

void dbiTagsInit ( void ) [static]
 

Initialize database (index, tag) tuple from configuration.

Definition at line 118 of file rpmdb.c.

Referenced by openDatabase().

int dbiUpdateIndex ( dbiIndex dbi,
void * dbcursor,
const void * keyp,
size_t keylen,
dbiIndexSet set ) [static]
 

Change/delete items that match criteria.

Parameters:
dbi   index database handle
dbcursor   index database cursor
keyp   update key
keylen   update key length
set   items to update in index database
Returns:
0 success, 1 not found

Definition at line 612 of file rpmdb.c.

Referenced by addIndexEntry(), and removeIndexEntry().

int dbiUpdateRecord ( dbiIndex dbi,
void * dbcursor,
int offset,
Header h ) [static]
 

Rewrite a header in the database.

Note: this is called from a markReplacedFiles iteration, and *must* preserve the "join key" (i.e. offset) for the header.

Parameters:
dbi   index database handle (always RPMDBI_PACKAGES)
dbcursor   index database cursor
offset   join key
h   rpm header
Returns:
0 on success

Definition at line 1531 of file rpmdb.c.

Referenced by rpmdbAdd(), rpmdbFreeIterator(), and rpmdbNextIterator().

int hdrNumCmp ( const void * one,
const void * two ) [static]
 

Definition at line 694 of file rpmdb.c.

int mireCmp ( const void * a,
const void * b ) [static]
 

Compare iterator selctors by rpm tag (qsort/bsearch).

Parameters:
a   1st iterator selector
b   2nd iterator selector
Returns:
result of comparison

Definition at line 1719 of file rpmdb.c.

char * mireDup ( rpmTag tag,
rpmMireMode * modep,
const char * pattern ) [static]
 

Copy pattern, escaping for appropriate mode.

Parameters:
tag   rpm tag
Return values:
modep   type of pattern match
Parameters:
pattern   pattern to duplicate
Returns:
duplicated pattern

Definition at line 1733 of file rpmdb.c.

Referenced by rpmdbSetIteratorRE().

int mireSkip ( const rpmdbMatchIterator mi ) [static]
 

Return iterator selector match.

Parameters:
mi   rpm database iterator
Returns:
1 if header should be skipped

Definition at line 1932 of file rpmdb.c.

Referenced by rpmdbNextIterator().

int miregexec ( miRE mire,
const char * val ) [static]
 

Return pattern match.

Parameters:
mire   match iterator regex
val   value to match
Returns:
0 if pattern matches

Definition at line 1675 of file rpmdb.c.

Referenced by mireSkip().

rpmdb newRpmdb ( const char * root,
const char * home,
int mode,
int perms,
int flags ) [static]
 

Definition at line 903 of file rpmdb.c.

Referenced by openDatabase().

unsigned char nibble ( char c ) [inline, static]
 

Convert hex to binary nibble.

Parameters:
c   hex character
Returns:
binary nibble

Definition at line 70 of file rpmdb.c.

Referenced by rpmQueryVerify(), rpmdbAdd(), and rpmdbRemove().

int openDatabase ( const char * prefix,
const char * dbpath,
int _dbapi,
rpmdb * dbp,
int mode,
int perms,
int flags ) [static]
 

Definition at line 951 of file rpmdb.c.

Referenced by rpmdbInit(), rpmdbOpen(), rpmdbRebuild(), and rpmdbVerify().

int printable ( const void * ptr,
size_t len ) [static]
 

Check key for printable characters.

Parameters:
ptr   key value pointer
len   key value length
Returns:
1 if only ASCII, 0 otherwise.

Definition at line 88 of file rpmdb.c.

Referenced by dbiGet(), and dbiPut().

int removeIndexEntry ( dbiIndex dbi,
void * dbcursor,
const void * keyp,
size_t keylen,
dbiIndexItem rec ) [static]
 

Remove entry from database index.

Parameters:
dbi   index database handle
dbcursor   index database cursor
keyp   search key
keylen   search key length
rec   record to remove
Returns:
0 on success

Definition at line 2394 of file rpmdb.c.

Referenced by rpmdbRemove().

int rpmdbFindByFile ( rpmdb db,
const char * filespec,
dbiIndexSet * matches ) [static]
 

Definition at line 1169 of file rpmdb.c.

Referenced by rpmdbInitIterator().

int rpmdbGrowIterator ( rpmdbMatchIterator mi,
const void * keyp,
size_t keylen,
int fpNum ) [static]
 

Definition at line 2214 of file rpmdb.c.

Referenced by rpmdbFindFpList().

int rpmdbMoveDatabase ( const char * prefix,
const char * olddbpath,
int _olddbapi,
const char * newdbpath,
int _newdbapi ) [static]
 

Definition at line 3237 of file rpmdb.c.

Referenced by rpmdbRebuild().

int rpmdbRemoveDatabase ( const char * prefix,
const char * dbpath,
int _dbapi ) [static]
 

Definition at line 3173 of file rpmdb.c.

Referenced by rpmdbMoveDatabase(), and rpmdbRebuild().

void rpmdbSortIterator ( rpmdbMatchIterator mi ) [static]
 

Definition at line 2195 of file rpmdb.c.

Referenced by rpmdbFindFpList().

int rpmioFileExists ( const char * urlfn ) [static]
 

Check if file esists using stat(2).

Parameters:
urlfn   file name (may be URL)
Returns:
1 if file exists, 0 if not

Definition at line 3140 of file rpmdb.c.

Referenced by rpmdbMoveDatabase(), and rpmdbRemoveDatabase().

int unblockSignals ( rpmdb db,
sigset_t * oldMask ) [static]
 

Restore signal mask.

Definition at line 817 of file rpmdb.c.

Referenced by dbiUpdateRecord(), rpmdbAdd(), and rpmdbRemove().


Variable Documentation

int _db_filter_dups = 0 [static]
 

Definition at line 54 of file rpmdb.c.

int _debug = 0 [static]
 

Definition at line 45 of file rpmdb.c.

int _rebuildinprogress = 0 [static]
 

Definition at line 52 of file rpmdb.c.

struct rpmdb_s dbTemplate [static]
 

Initial value:

 {
     "/" ,       "%{_dbpath}" ,  0 ,  0 ,  0644 ,
     -1 ,        "rpmdb" 
}

Definition at line 835 of file rpmdb.c.

int* dbiTags = NULL
 

Tags for which rpmdb indices will be built.

Definition at line 61 of file rpmdb.c.

int dbiTagsMax = 0
 

Definition at line 63 of file rpmdb.c.

struct _dbiVec * mydbvecs [static]
 

Initial value:

 {
     NULL ,  NULL ,  NULL ,  NULL , NULL
}

Definition at line 203 of file rpmdb.c.


Generated at Tue Dec 23 04:54:13 2003 for rpm by doxygen1.2.8.1 written by Dimitri van Heesch, © 1997-2001