Main Page | Modules | Data Structures | Directories | File List | Data Fields | Globals | Related Pages
lib

rpmgi.c File Reference

#include "system.h"
#include <rpmlib.h>
#include <rpmte.h>
#include <rpmgi.h>
#include <rpmdb.h>
#include <rpmmacro.h>
#include "manifest.h"
#include "debug.h"

Go to the source code of this file.

Defines

#define _RPMGI_INTERNAL
#define _RPMTS_INTERNAL

Functions

static const char * ftsInfoStr (int fts_info)
static FD_t rpmgiOpen (const char *path, const char *fmode)
 Open a file after macro expanding path.
static rpmRC rpmgiLoadManifest (rpmgi gi, const char *path)
 Load manifest into iterator arg list.
static Header rpmgiReadHeader (rpmgi gi, const char *path)
 Return header from package.
static rpmRC rpmgiLoadReadHeader (rpmgi gi)
 Read next header from package, lazily expanding manifests as found.
static rpmRC rpmgiWalkPathFilter (rpmgi gi)
 Filter file tree walk path.
static rpmRC rpmgiWalkReadHeader (rpmgi gi)
 Read header from next package, lazily walking file tree.
static rpmRC rpmgiGlobArgv (rpmgi gi, ARGV_t argv)
 Append globbed arg list to iterator.
static rpmRC rpmgiInitFilter (rpmgi gi)
 Return rpmdb match iterator with filters (if any) set.
rpmgi XrpmgiUnlink (rpmgi gi, const char *msg, const char *fn, unsigned ln)
rpmgi XrpmgiLink (rpmgi gi, const char *msg, const char *fn, unsigned ln)
rpmgi rpmgiFree (rpmgi gi)
 Destroy a generalized iterator.
rpmgi rpmgiNew (rpmts ts, int tag, const void *keyp, size_t keylen)
 Return a generalized iterator.
rpmRC rpmgiNext (rpmgi gi)
 Perform next iteration step.
const char * rpmgiHdrPath (rpmgi gi)
 Return current header path.
Header rpmgiHeader (rpmgi gi)
 Return current iteration header.
rpmts rpmgiTs (rpmgi gi)
 Return current iteration transaction set.
rpmRC rpmgiSetArgs (rpmgi gi, ARGV_t argv, int ftsOpts, rpmgiFlags flags)
 Load iterator args.

Variables

int _rpmgi_debug = 0
rpmgiFlags giFlags = RPMGI_NONE
static int indent = 2
static const char * ftsInfoStrings []

Define Documentation

#define _RPMGI_INTERNAL
 

Definition at line 10 of file rpmgi.c.

#define _RPMTS_INTERNAL
 

Definition at line 11 of file rpmgi.c.

Function Documentation

static const char* ftsInfoStr (  int  fts_info  )  [static]
 

Definition at line 54 of file rpmgi.c.

References ftsInfoStrings.

Referenced by ftsPrint(), rpmfts_print(), and rpmgiWalkPathFilter().

rpmgi rpmgiFree (  rpmgi  gi  ) 
 

Destroy a generalized iterator.

Parameters:
gi generalized iterator
Returns:
NULL always

Definition at line 402 of file rpmgi.c.

References _free(), argvFree(), Fclose(), Fts_close(), headerFree(), rpmdbFreeIterator(), rpmgiUnlink, rpmtsFree(), and rpmtsiFree.

Referenced by main(), and rpmcliArgIter().

static rpmRC rpmgiGlobArgv (  rpmgi  gi,
ARGV_t  argv
)  [static]
 

Append globbed arg list to iterator.

Parameters:
gi generalized iterator
argv arg list to be globbed (or NULL)
Returns:
RPMRC_OK on success

Definition at line 285 of file rpmgi.c.

References argvAppend(), argvFree(), RPMDBI_ARGLIST, RPMDBI_FTSWALK, RPMDBI_HDLIST, RPMGI_NOGLOB, rpmGlob(), and RPMRC_OK.

Referenced by rpmgiSetArgs().

const char* rpmgiHdrPath (  rpmgi  gi  ) 
 

Return current header path.

Parameters:
gi generalized iterator
Returns:
header path

Definition at line 665 of file rpmgi.c.

Referenced by rpmcliArgIter(), and rpmgiPathOrQF().

Header rpmgiHeader (  rpmgi  gi  ) 
 

Return current iteration header.

Parameters:
gi generalized iterator
Returns:
header

Definition at line 670 of file rpmgi.c.

Referenced by rpmgiPathOrQF(), and rpmgiShowMatches().

static rpmRC rpmgiInitFilter (  rpmgi  gi  )  [static]
 

Return rpmdb match iterator with filters (if any) set.

Parameters:
gi generalized iterator
Returns:
RPMRC_OK on success

Definition at line 327 of file rpmgi.c.

References _, _free(), _rpmgi_debug, rpmdbFreeIterator(), rpmdbSetIteratorRE(), RPMERR_QUERYINFO, rpmError, RPMMIRE_DEFAULT, RPMRC_FAIL, RPMRC_OK, RPMTAG_NAME, rpmtsInitIterator(), tagName(), tagValue(), and xstrdup().

Referenced by rpmgiNext().

static rpmRC rpmgiLoadManifest (  rpmgi  gi,
const char *  path
)  [static]
 

Load manifest into iterator arg list.

Parameters:
gi generalized iterator
path file path
Returns:
RPMRC_OK on success

Definition at line 96 of file rpmgi.c.

References Fclose(), rpmgiOpen(), RPMRC_FAIL, and rpmReadPackageManifest().

Referenced by rpmgiLoadReadHeader().

static rpmRC rpmgiLoadReadHeader (  rpmgi  gi  )  [static]
 

Read next header from package, lazily expanding manifests as found.

Todo:
An empty file read as manifest truncates argv returning RPMRC_NOTFOUND.
Todo:
Errors, e.g.
non-existent path in manifest, will terminate iteration.
Todo:
Chained manifests lose an arg someplace.
Parameters:
gi generalized iterator
Returns:
RPMRC_OK on success

Definition at line 156 of file rpmgi.c.

References _free(), headerFree(), headerLink(), RPMGI_NOHEADER, RPMGI_NOMANIFEST, rpmgiLoadManifest(), rpmgiReadHeader(), RPMRC_NOTFOUND, and RPMRC_OK.

Referenced by rpmgiNext().

rpmgi rpmgiNew (  rpmts  ts,
int  tag,
const void *  keyp,
size_t  keylen
) 
 

Return a generalized iterator.

Parameters:
ts transaction set
tag rpm tag
keyp key data (NULL for sequential access)
keylen key data length (0 will use strlen(keyp))
Returns:
new iterator

Definition at line 441 of file rpmgi.c.

References rpmgiLink, rpmtsLink, and xcalloc().

Referenced by main(), and rpmcliArgIter().

rpmRC rpmgiNext (  rpmgi  gi  ) 
 

Perform next iteration step.

Parameters:
gi generalized iterator
Returns:
RPMRC_OK on success, RPMRC_NOTFOUND on EOI

Definition at line 475 of file rpmgi.c.

References _, _free(), _rpmgi_debug, Fclose(), Fts_close(), Fts_open(), HEADER_MAGIC_YES, headerFree(), headerLink(), headerRead(), rpmdbFreeIterator(), rpmdbGetIteratorOffset(), RPMDBI_ADDED, RPMDBI_ARGLIST, RPMDBI_FTSWALK, RPMDBI_HDLIST, RPMDBI_PACKAGES, rpmdbNextIterator(), rpmExpand(), RPMGI_NOHEADER, RPMGI_TSADD, RPMGI_TSORDER, rpmgiInitFilter(), rpmgiLoadReadHeader(), rpmgiOpen(), rpmgiWalkReadHeader(), rpmIsVerbose, RPMMESS_VERBOSE, rpmMessage, rpmpsFree(), rpmpsNumProblems(), rpmpsPrint(), RPMRC_NOTFOUND, RPMRC_OK, rpmteHeader(), rpmtsAddInstallElement(), rpmtsCheck(), rpmtsCloseDB(), rpmtsiFree, rpmtsiInit, rpmtsiNext(), rpmtsOrder(), rpmtsProblems(), TR_ADDED, and xstrdup().

Referenced by main(), rpmcliArgIter(), and rpmgiShowMatches().

static FD_t rpmgiOpen (  const char *  path,
const char *  fmode
)  [static]
 

Open a file after macro expanding path.

Todo:
There are two error messages printed on header, then manifest failures.
Parameters:
path file path
fmode open mode
Returns:
file handle

Definition at line 73 of file rpmgi.c.

References _, _free(), Fclose(), Ferror(), Fopen(), Fstrerror(), RPMERR_OPEN, rpmError, and rpmExpand().

Referenced by rpmgiLoadManifest(), rpmgiNext(), and rpmgiReadHeader().

static Header rpmgiReadHeader (  rpmgi  gi,
const char *  path
)  [static]
 

Return header from package.

Parameters:
gi generalized iterator
path file path
Returns:
header (NULL on failure)

Definition at line 117 of file rpmgi.c.

References Fclose(), headerFree(), rpmgiOpen(), RPMRC_FAIL, RPMRC_NOKEY, RPMRC_NOTFOUND, RPMRC_NOTTRUSTED, RPMRC_OK, and rpmReadPackageFile().

Referenced by rpmgiLoadReadHeader(), and rpmgiWalkReadHeader().

rpmRC rpmgiSetArgs (  rpmgi  gi,
ARGV_t  argv,
int  ftsOpts,
rpmgiFlags  flags
) 
 

Load iterator args.

Parameters:
gi generalized iterator
argv arg list
ftsOpts fts(3) flags
flags iterator flags
Returns:
RPMRC_OK on success

Definition at line 684 of file rpmgi.c.

References rpmgiGlobArgv().

Referenced by main(), and rpmcliArgIter().

rpmts rpmgiTs (  rpmgi  gi  ) 
 

Return current iteration transaction set.

Parameters:
gi generalized iterator
Returns:
transaction set

Definition at line 677 of file rpmgi.c.

static rpmRC rpmgiWalkPathFilter (  rpmgi  gi  )  [static]
 

Filter file tree walk path.

Parameters:
gi generalized iterator
Returns:
RPMRC_OK on success

Definition at line 202 of file rpmgi.c.

References _rpmgi_debug, FTS_D, FTS_DC, FTS_DEFAULT, FTS_DNR, FTS_DOT, FTS_DP, FTS_ERR, FTS_F, _ftsent::fts_info, FTS_INIT, _ftsent::fts_level, _ftsent::fts_name, _ftsent::fts_namelen, FTS_NS, FTS_NSOK, FTS_SL, FTS_SLNONE, FTS_W, ftsInfoStr(), indent, RPMMESS_DEBUG, rpmMessage, RPMRC_NOTFOUND, and RPMRC_OK.

Referenced by rpmgiWalkReadHeader().

static rpmRC rpmgiWalkReadHeader (  rpmgi  gi  )  [static]
 

Read header from next package, lazily walking file tree.

Parameters:
gi generalized iterator
Returns:
RPMRC_OK on success

Definition at line 251 of file rpmgi.c.

References Fts_read(), headerFree(), headerLink(), RPMGI_NOHEADER, rpmgiReadHeader(), rpmgiWalkPathFilter(), RPMRC_NOTFOUND, and RPMRC_OK.

Referenced by rpmgiNext().

rpmgi XrpmgiLink (  rpmgi  gi,
const char *  msg,
const char *  fn,
unsigned  ln
) 
 

Todo:
Remove debugging entry from the ABI.

Definition at line 391 of file rpmgi.c.

References _rpmgi_debug.

rpmgi XrpmgiUnlink (  rpmgi  gi,
const char *  msg,
const char *  fn,
unsigned  ln
) 
 

Todo:
Remove debugging entry from the ABI.

Definition at line 380 of file rpmgi.c.

References _rpmgi_debug.

Variable Documentation

int _rpmgi_debug = 0
 

Definition at line 26 of file rpmgi.c.

const char* ftsInfoStrings[] [static]
 

Initial value:

 {
    "UNKNOWN",
    "D",
    "DC",
    "DEFAULT",
    "DNR",
    "DOT",
    "DP",
    "ERR",
    "F",
    "INIT",
    "NS",
    "NSOK",
    "SL",
    "SLNONE",
    "W",
}

Definition at line 35 of file rpmgi.c.

Referenced by ftsInfoStr().

rpmgiFlags giFlags = RPMGI_NONE
 

Definition at line 29 of file rpmgi.c.

Referenced by main(), and rpmcliArgIter().

int indent = 2 [static]
 

Definition at line 32 of file rpmgi.c.

Referenced by ftsPrint(), ftsStashLatest(), rpmfts_print(), and rpmgiWalkPathFilter().

Generated on Tue Feb 19 22:16:54 2008 for rpm by  doxygen 1.4.4