Defines | Functions | Variables

lib/rpmgi.c File Reference

#include "system.h"
#include <rpmio.h>
#include <rpmcb.h>
#include <rpmmacro.h>
#include <rpmlib.h>
#include <rpmte.h>
#include <pkgio.h>
#include <rpmgi.h>
#include <rpmdb.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.
rpmgiFlags rpmgiGetFlags (rpmgi gi)
 Return current iteration flags.
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 14 of file rpmgi.c.

#define _RPMTS_INTERNAL

Definition at line 15 of file rpmgi.c.


Function Documentation

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

Definition at line 68 of file rpmgi.c.

References ftsInfoStrings.

Referenced by rpmgiWalkPathFilter().

const char* rpmgiEscapeSpaces ( const char *  s )

Escape isspace(3) characters in string.

Parameters:
sstring
Returns:
escaped string

Definition at line 327 of file rpmgi.c.

References xmalloc().

Referenced by IDTXglob(), and rpmgiGlobArgv().

rpmgi rpmgiFree ( rpmgi  gi )

Destroy a generalized iterator.

Parameters:
gigeneralized iterator
Returns:
NULL always

Definition at line 477 of file rpmgi.c.

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

Referenced by rpmcliArgIter(), rpmcliInstall(), rpmcliSign(), and rpmReSign().

rpmgiFlags rpmgiGetFlags ( rpmgi  gi )

Return current iteration flags.

Parameters:
gigeneralized iterator
Returns:
flags

Definition at line 821 of file rpmgi.c.

References RPMGI_NONE.

Referenced by rpmcliArgIter().

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

Append globbed arg list to iterator.

Parameters:
gigeneralized iterator
argvarg list to be globbed (or NULL)
Returns:
RPMRC_OK on success

Definition at line 357 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:
gigeneralized iterator
Returns:
header path

Definition at line 826 of file rpmgi.c.

Referenced by rpmcliArgIter(), rpmcliInstall(), rpmcliSign(), and rpmReSign().

Header rpmgiHeader ( rpmgi  gi )

Return current iteration header.

Parameters:
gigeneralized iterator
Returns:
header

Definition at line 831 of file rpmgi.c.

Referenced by rpmcliInstall(), and rpmgiShowMatches().

static rpmRC rpmgiInitFilter ( rpmgi  gi ) [static]

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

Parameters:
gigeneralized iterator
Returns:
RPMRC_OK on success

Definition at line 401 of file rpmgi.c.

References _, _free(), _rpmgi_debug, rpmdbFreeIterator(), RPMDBI_PACKAGES, rpmdbSetIteratorRE(), rpmlog(), RPMLOG_NOTICE, RPMRC_FAIL, RPMRC_OK, rpmtsInitIterator(), tagName(), tagValue(), and xstrdup().

Referenced by rpmgiNext().

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

Load manifest into iterator arg list.

Parameters:
gigeneralized iterator
pathfile path
Returns:
RPMRC_OK on success

Definition at line 114 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:
gigeneralized iterator
Returns:
RPMRC_OK on success

Definition at line 170 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.

Errors, e.g. non-existent path in manifest, will terminate iteration.

Chained manifests lose an arg someplace.

Parameters:
gigeneralized iterator
Returns:
RPMRC_OK on success

Definition at line 194 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:
tstransaction set
tagrpm tag
keypkey data (NULL for sequential access)
keylenkey data length (0 will use strlen(keyp))
Returns:
new iterator

Definition at line 516 of file rpmgi.c.

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

Referenced by rpmcliArgIter(), rpmcliInstall(), rpmcliSign(), and rpmReSign().

rpmRC rpmgiNext ( rpmgi  gi )
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:
pathfile path
fmodeopen mode
Returns:
file handle

Definition at line 87 of file rpmgi.c.

References _, _free(), errno, Fclose(), Ferror(), Fopen(), Fstrerror(), rpmExpand(), rpmlog(), and RPMLOG_ERR.

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

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

Return header from package.

Parameters:
gigeneralized iterator
pathfile path
Returns:
header (NULL on failure)

Definition at line 135 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:
gigeneralized iterator
argvarg list
ftsOptsfts(3) flags
flagsiterator flags
Returns:
RPMRC_OK on success

Definition at line 845 of file rpmgi.c.

References ftsOpts, rpmgiGlobArgv(), and RPMRC_FAIL.

Referenced by rpmcliArgIter(), rpmcliInstall(), rpmcliSign(), and rpmReSign().

rpmts rpmgiTs ( rpmgi  gi )

Return current iteration transaction set.

Parameters:
gigeneralized iterator
Returns:
transaction set

Definition at line 838 of file rpmgi.c.

static rpmRC rpmgiWalkPathFilter ( rpmgi  gi ) [static]

Filter file tree walk path.

Parameters:
gigeneralized iterator
Returns:
RPMRC_OK on success

Definition at line 242 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, rpmlog(), RPMLOG_DEBUG, RPMRC_NOTFOUND, and RPMRC_OK.

Referenced by rpmgiWalkReadHeader().

static rpmRC rpmgiWalkReadHeader ( rpmgi  gi ) [static]

Read header from next package, lazily walking file tree.

Parameters:
gigeneralized iterator
Returns:
RPMRC_OK on success

Definition at line 291 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 466 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 455 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 553 of file rpmgi.c.

Referenced by rpmgiNext().

int _rpmgi_debug = 0

Definition at line 32 of file rpmgi.c.

Referenced by rpmgiInitFilter(), rpmgiNext(), rpmgiWalkPathFilter(), XrpmgiLink(), and XrpmgiUnlink().

const char* ftsInfoStrings[] [static]
Initial value:
 {
    "UNKNOWN",
    "D",
    "DC",
    "DEFAULT",
    "DNR",
    "DOT",
    "DP",
    "ERR",
    "F",
    "INIT",
    "NS",
    "NSOK",
    "SL",
    "SLNONE",
    "W",
}

Definition at line 47 of file rpmgi.c.

Referenced by ftsInfoStr().

rpmgiFlags giFlags = RPMGI_NONE

Definition at line 37 of file rpmgi.c.

Referenced by rpmcliArgIter().

int indent = 2 [static]

Definition at line 42 of file rpmgi.c.

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