Main Page | Modules | Data Structures | 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"

Include dependency graph for rpmgi.c:

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 rpmgiLoadNextKey (rpmgi gi)
 Load next key from argv list.
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.
const char * rpmgiEscapeSpaces (const char *s)
 Escape isspace(3) characters in string.
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 []
static const char * _query_hdlist_path = "/usr/share/comps/%{_arch}/hdlist"

Detailed Description

Definition in file rpmgi.c.

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 64 of file rpmgi.c.

References ftsInfoStrings.

Referenced by rpmfts_print(), and rpmgiWalkPathFilter().

const char* rpmgiEscapeSpaces (  const char *  s  ) 
 

Escape isspace(3) characters in string.

Parameters:
s string
Returns:
escaped string

Definition at line 323 of file rpmgi.c.

References xmalloc().

Referenced by IDTXglob(), rpmgiGlobArgv(), and rpmInstall().

rpmgi rpmgiFree (  rpmgi  gi  ) 
 

Destroy a generalized iterator.

Parameters:
gi generalized iterator
Returns:
NULL always

Definition at line 475 of file rpmgi.c.

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

Referenced by 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 353 of file rpmgi.c.

References _free(), argvAppend(), argvFree(), RPMDBI_ARGLIST, RPMDBI_FTSWALK, RPMDBI_HDLIST, RPMGI_NOGLOB, rpmgiEscapeSpaces(), 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 813 of file rpmgi.c.

Referenced by rpmcliArgIter().

Header rpmgiHeader (  rpmgi  gi  ) 
 

Return current iteration header.

Parameters:
gi generalized iterator
Returns:
header

Definition at line 818 of file rpmgi.c.

Referenced by 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 397 of file rpmgi.c.

References _, _free(), _rpmgi_debug, rpmdbFreeIterator(), RPMDBI_PACKAGES, rpmdbSetIteratorRE(), RPMERR_QUERYINFO, rpmError, 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 110 of file rpmgi.c.

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

Referenced by rpmgiLoadReadHeader().

static rpmRC rpmgiLoadNextKey (  rpmgi  gi  )  [static]
 

Load next key from argv list.

Parameters:
gi generalized iterator
Returns:
RPMRC_OK on success

Definition at line 166 of file rpmgi.c.

References RPMRC_NOTFOUND, and RPMRC_OK.

Referenced by rpmgiNext().

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 190 of file rpmgi.c.

References _free(), errno, 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 514 of file rpmgi.c.

References rpmgiLink, rpmtsLink, rpmtsOrder(), and xcalloc().

Referenced by 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 553 of file rpmgi.c.

References _, _free(), _query_hdlist_path, _rpmgi_debug, Fclose(), Fts_close(), Fts_open(), HEADER_MAGIC_YES, headerFree(), headerGetInstance(), headerLink(), headerRead(), rpmdbBlockDBI(), rpmdbFreeIterator(), rpmdbGetIteratorOffset(), RPMDBI_ADDED, RPMDBI_ARGLIST, RPMDBI_DEPENDS, RPMDBI_FTSWALK, RPMDBI_HDLIST, RPMDBI_PACKAGES, RPMDBI_REMOVED, rpmdbNextIterator(), RPMDEPS_FLAG_DEPLOOPS, rpmExpand(), RPMGI_ERASING, RPMGI_NOHEADER, RPMGI_TSADD, RPMGI_TSORDER, rpmgiInitFilter(), rpmgiLoadNextKey(), rpmgiLoadReadHeader(), rpmgiOpen(), rpmgiWalkReadHeader(), rpmIsVerbose, RPMMESS_VERBOSE, rpmMessage, rpmpsFree(), rpmpsNumProblems(), rpmpsPrint(), RPMRC_NOTFOUND, RPMRC_OK, RPMTAG_BASENAMES, RPMTAG_PROVIDENAME, rpmteHeader(), rpmteType(), rpmtsAddEraseElement(), rpmtsAddInstallElement(), rpmtsCheck(), rpmtsDFlags(), rpmtsiFree, rpmtsiInit, rpmtsiNext(), rpmtsProblems(), rpmtsSetDFlags(), tagName(), TR_ADDED, TR_REMOVED, and xstrdup().

Referenced by 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 83 of file rpmgi.c.

References _, _free(), errno, 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 131 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 832 of file rpmgi.c.

References rpmgiGlobArgv(), and RPMRC_FAIL.

Referenced by rpmcliArgIter().

rpmts rpmgiTs (  rpmgi  gi  ) 
 

Return current iteration transaction set.

Parameters:
gi generalized iterator
Returns:
transaction set

Definition at line 825 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 238 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 287 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 464 of file rpmgi.c.

References _rpmgi_debug, and tagName().

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

Todo:
Remove debugging entry from the ABI.

Definition at line 453 of file rpmgi.c.

References _rpmgi_debug, and tagName().

Variable Documentation

const char* _query_hdlist_path = "/usr/share/comps/%{_arch}/hdlist" [static]
 

Definition at line 551 of file rpmgi.c.

Referenced by rpmgiNext().

int _rpmgi_debug = 0
 

Definition at line 28 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 43 of file rpmgi.c.

Referenced by ftsInfoStr().

rpmgiFlags giFlags = RPMGI_NONE
 

Definition at line 33 of file rpmgi.c.

Referenced by rpmcliArgIter().

int indent = 2 [static]
 

Definition at line 38 of file rpmgi.c.

Referenced by rpmfts_print(), rpmgiWalkPathFilter(), yamlstrcpy(), and yamlstrlen().

Generated on Sun Aug 18 18:37:29 2013 for rpm by  doxygen 1.4.4