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

RPMCLI.


Files

file  manifest.c
file  poptBT.c
 Popt tables for build modes.

file  poptQV.c
 Popt tables for query/verify modes.

file  query.c
 Display tag values from package metadata.

file  rpmchecksig.c
 Verify the signature of a package.

file  rpminstall.c
file  rpmlib.h
file  verify.c
 Verify installed payload files from package metadata.


Data Structures

struct  rpmBuildArguments
struct  rpmQVArguments

RPMBT

typedef struct rpmBuildArguments BTA_t
struct poptOption rpmBuildPoptTable []
struct rpmBuildArguments rpmBTArgs

RPMQV

typedef int (* QVF_t )(QVA_t *qva, rpmdb db, Header h)
enum  rpmVerifyAttrs_e {
  RPMVERIFY_NONE = 0, RPMVERIFY_MD5 = (1 << 0), RPMVERIFY_FILESIZE = (1 << 1), RPMVERIFY_LINKTO = (1 << 2),
  RPMVERIFY_USER = (1 << 3), RPMVERIFY_GROUP = (1 << 4), RPMVERIFY_MTIME = (1 << 5), RPMVERIFY_MODE = (1 << 6),
  RPMVERIFY_RDEV = (1 << 7), RPMVERIFY_READLINKFAIL = (1 << 28), RPMVERIFY_READFAIL = (1 << 29), RPMVERIFY_LSTATFAIL = (1 << 30)
}
enum  rpmQVSources_e {
  RPMQV_PACKAGE = 0, RPMQV_PATH, RPMQV_ALL, RPMQV_RPM,
  RPMQV_GROUP, RPMQV_WHATPROVIDES, RPMQV_WHATREQUIRES, RPMQV_TRIGGEREDBY,
  RPMQV_DBOFFSET, RPMQV_SPECFILE
}
enum  rpmQueryFlags_e {
  QUERY_FOR_LIST = (1 << 1), QUERY_FOR_STATE = (1 << 2), QUERY_FOR_DOCS = (1 << 3), QUERY_FOR_CONFIG = (1 << 4),
  QUERY_FOR_DUMPFILES = (1 << 8)
}
enum  rpmVerifyFlags_e { VERIFY_FILES = (1 << 9), VERIFY_DEPS = (1 << 10), VERIFY_SCRIPT = (1 << 11), VERIFY_MD5 = (1 << 12) }
int rpmVerifyFile (const char *root, Header h, int filenum, int *result, int omitMask)
int showMatches (QVA_t *qva, rpmdbMatchIterator mi, QVF_t showPackage)
void rpmDisplayQueryTags (FILE *f)
int rpmQueryVerify (QVA_t *qva, rpmQVSources source, const char *arg, rpmdb db, QVF_t showPackage)
int showQueryPackage (QVA_t *qva, rpmdb db, Header h)
int rpmQuery (QVA_t *qva, rpmQVSources source, const char *arg)
int showVerifyPackage (QVA_t *qva, rpmdb db, Header h)
int rpmVerify (QVA_t *qva, rpmQVSources source, const char *arg)
struct poptOption rpmVerifyPoptTable []
struct poptOption rpmQVSourcePoptTable []
struct poptOption rpmQueryPoptTable []

RPMEIU

enum  rpmInstallInterfaceFlags_e {
  INSTALL_NONE = 0, INSTALL_PERCENT = (1 << 0), INSTALL_HASH = (1 << 1), INSTALL_NODEPS = (1 << 2),
  INSTALL_NOORDER = (1 << 3), INSTALL_LABEL = (1 << 4), INSTALL_UPGRADE = (1 << 5), INSTALL_FRESHEN = (1 << 6)
}
enum  rpmEraseInterfaceFlags_e { UNINSTALL_NONE = 0, UNINSTALL_NODEPS = (1 << 0), UNINSTALL_ALLMATCHES = (1 << 1) }
int rpmInstall (const char *rootdir, const char **argv, rpmtransFlags transFlags, rpmInstallInterfaceFlags interfaceFlags, rpmprobFilterFlags probFilter, rpmRelocation *relocations)
int rpmInstallSource (const char *prefix, const char *arg, const char **specFile, char **cookie)
int rpmErase (const char *rootdir, const char **argv, rpmtransFlags transFlags, rpmEraseInterfaceFlags interfaceFlags)

RPMK

enum  rpmCheckSigFlags_e { CHECKSIG_NONE = 0, CHECKSIG_PGP = (1 << 0), CHECKSIG_MD5 = (1 << 1), CHECKSIG_GPG = (1 << 2) }
enum  rpmResignFlags_e { RESIGN_NEW_SIGNATURE = 0, RESIGN_ADD_SIGNATURE }
int rpmCheckSig (rpmCheckSigFlags flags, const char **argv)
int rpmReSign (rpmResignFlags add, char *passPhrase, const char **argv)

RPMTS

void rpmShowRpmlibProvides (FILE *fp)

Functions

int checkSpec (Header h)

Typedef Documentation

typedef struct rpmBuildArguments BTA_t
 

Definition at line 1286 of file rpmlib.h.

typedef int(* QVF_t)(QVA_t *qva, rpmdb db, Header h)
 

Parameters:
qva   parsed query/verify options
db   rpm database
h   header to use for query/verify

Definition at line 1408 of file rpmlib.h.

Enumeration Type Documentation

enum rpmCheckSigFlags_e
 

Bit(s) to control rpmCheckSig() operation.

Enumeration values:
CHECKSIG_NONE   Don't check any signatures.
CHECKSIG_PGP   if not --nopgp
CHECKSIG_MD5   if not --nomd5
CHECKSIG_GPG   if not --nogpg

Definition at line 1628 of file rpmlib.h.

enum rpmEraseInterfaceFlags_e
 

Bit(s) to control rpmErase() operation.

Enumeration values:
UNINSTALL_NONE  
UNINSTALL_NODEPS   from --nodeps
UNINSTALL_ALLMATCHES   from --allmatches

Definition at line 1537 of file rpmlib.h.

enum rpmInstallInterfaceFlags_e
 

Bit(s) to control rpmInstall() operation.

Enumeration values:
INSTALL_NONE  
INSTALL_PERCENT   from --percent
INSTALL_HASH   from --hash
INSTALL_NODEPS   from --nodeps
INSTALL_NOORDER   from --noorder
INSTALL_LABEL   from --verbose (notify)
INSTALL_UPGRADE   from --upgrade
INSTALL_FRESHEN   from --freshen

Definition at line 1496 of file rpmlib.h.

enum rpmQVSources_e
 

The command line argument will be used to retrieve header(s) ...

Enumeration values:
RPMQV_PACKAGE   ... from package name db search.
RPMQV_PATH   ... from file path db search.
RPMQV_ALL   ... from each installed package.
RPMQV_RPM   ... from reading binary rpm package.
RPMQV_GROUP   ... from group db search.
RPMQV_WHATPROVIDES   ... from provides db search.
RPMQV_WHATREQUIRES   ... from requires db search.
RPMQV_TRIGGEREDBY   ... from trigger db search.
RPMQV_DBOFFSET   ... from database header instance.
RPMQV_SPECFILE   ... from spec file parse (query only).

Definition at line 1347 of file rpmlib.h.

enum rpmQueryFlags_e
 

Bit(s) to control rpmQuery() operation, stored in qva_flags.

Enumeration values:
QUERY_FOR_LIST   from --list
QUERY_FOR_STATE   from --state
QUERY_FOR_DOCS   from --docfiles
QUERY_FOR_CONFIG   from --configfiles
QUERY_FOR_DUMPFILES   from --dump

Definition at line 1363 of file rpmlib.h.

enum rpmResignFlags_e
 

Bit(s) to control rpmReSign() operation.

Enumeration values:
RESIGN_NEW_SIGNATURE   from --resign
RESIGN_ADD_SIGNATURE   from --addsign

Definition at line 1646 of file rpmlib.h.

enum rpmVerifyAttrs_e
 

Bit(s) for rpmVerifyFile() attributes and result.

Enumeration values:
RPMVERIFY_NONE  
RPMVERIFY_MD5  
RPMVERIFY_FILESIZE  
RPMVERIFY_LINKTO  
RPMVERIFY_USER  
RPMVERIFY_GROUP  
RPMVERIFY_MTIME  
RPMVERIFY_MODE  
RPMVERIFY_RDEV  
RPMVERIFY_READLINKFAIL  
RPMVERIFY_READFAIL  
RPMVERIFY_LSTATFAIL  

Definition at line 1304 of file rpmlib.h.

enum rpmVerifyFlags_e
 

Bit(s) to control rpmVerify() operation, stored in qva_flags.

Enumeration values:
VERIFY_FILES   from --nofiles
VERIFY_DEPS   from --nodeps
VERIFY_SCRIPT   from --noscripts
VERIFY_MD5   from --nomd5

Definition at line 1374 of file rpmlib.h.

Function Documentation

int checkSpec ( Header h ) [static]
 

Definition at line 15 of file build.c.

Referenced by buildForTarget().

int rpmCheckSig ( rpmCheckSigFlags flags,
const char ** argv )
 

Check elements in signature header.

Parameters:
flags   bit(s) to enable signature checks
argv   array of package file names (NULL terminated)
Returns:
0 on success

Definition at line 226 of file rpmchecksig.c.

Referenced by checkSig(), and main().

void rpmDisplayQueryTags ( FILE * f )
 

Display list of tags that can be used in --queryformat.

Parameters:
f   file handle to use for display

Definition at line 431 of file query.c.

Referenced by main().

int rpmErase ( const char * rootdir,
const char ** argv,
rpmtransFlags transFlags,
rpmEraseInterfaceFlags interfaceFlags )
 

Erase binary rpm package.

Parameters:
rootdir   path to top of install tree
argv   array of package file names (NULL terminated)
transFlags   bits to control rpmRunTransactions()
interfaceFlags   bits to control rpmInstall()
Returns:
0 on success

Definition at line 555 of file rpminstall.c.

Referenced by main().

int rpmInstall ( const char * rootdir,
const char ** argv,
rpmtransFlags transFlags,
rpmInstallInterfaceFlags interfaceFlags,
rpmprobFilterFlags probFilter,
rpmRelocation * relocations )
 

Todo:
Generalize --freshen policies.

Definition at line 188 of file rpminstall.c.

Referenced by main().

int rpmInstallSource ( const char * prefix,
const char * arg,
const char ** specFile,
char ** cookie )
 

Install source rpm package.

Parameters:
prefix   path to top of install tree
arg   source rpm file name
Return values:
specFile   address of (installed) spec file name
cookie  
Returns:
0 on success

Definition at line 639 of file rpminstall.c.

Referenced by main().

int rpmQuery ( QVA_t * qva,
rpmQVSources source,
const char * arg )
 

Display package information.

Parameters:
qva   parsed query/verify options
source   type of source to query
arg   name of source to query
Returns:
rpmQueryVerify() result, or 1 on rpmdbOpen() failure

Definition at line 755 of file query.c.

Referenced by main().

int rpmQueryVerify ( QVA_t * qva,
rpmQVSources source,
const char * arg,
rpmdb db,
QVF_t showPackage )
 

Common query/verify source interface, called once for each CLI arg.

Parameters:
qva   parsed query/verify options
source   type of source to query/verify
arg   name of source to query/verify
db   rpm database
showPackage   query/verify specific display routine
Returns:
showPackage() result, 1 if rpmdbInitIterator() is NULL

Definition at line 482 of file query.c.

Referenced by rpmQuery(), and rpmVerify().

int rpmReSign ( rpmResignFlags add,
char * passPhrase,
const char ** argv )
 

Create/modify elements in signature header.

Parameters:
add   type of signature operation
passPhrase  
argv   array of package file names (NULL terminated)
Returns:
0 on success

Definition at line 99 of file rpmchecksig.c.

Referenced by main().

void rpmShowRpmlibProvides ( FILE * fp )
 

Display current rpmlib feature provides.

Parameters:
fp   output file handle

Definition at line 37 of file rpmlibprov.c.

int rpmVerify ( QVA_t * qva,
rpmQVSources source,
const char * arg )
 

Verify package install.

Parameters:
qva   parsed query/verify options
source   type of source to verify
arg   name of source to verify
Returns:
rpmQueryVerify() result, or 1 on rpmdbOpen() failure

Definition at line 478 of file verify.c.

int rpmVerifyFile ( const char * prefix,
Header h,
int filenum,
int * result,
int omitMask )
 

Verify file attributes and MD5 sum.

Todo:
gnorpm and python bindings prevent this from being static.

add rpmVerifyAttrs to prototype.

Parameters:
root   path to top of install tree
h   header
filenum   index of file in header file info arrays
Return values:
result   address of failure flags
Parameters:
omitMask   bit(s) to disable verify checks
Returns:
0 on success (or not installed), 1 on error

Definition at line 83 of file verify.c.

int showMatches ( QVA_t * qva,
rpmdbMatchIterator mi,
QVF_t showPackage )
 

Display query/verify information for each header in iterator.

Parameters:
qva   parsed query/verify options
mi   rpm database iterator
showPackage   query/verify display routine
Returns:
result of last non-zero showPackage() return

Definition at line 457 of file query.c.

Referenced by rpmQueryVerify().

int showQueryPackage ( QVA_t * qva,
rpmdb db,
Header h )
 

Display results of package query.

Todo:
Devise a meaningful return code.
Parameters:
qva   parsed query/verify options
db   rpm database (unused for queries)
h   header to use for query
Returns:
0 always

Definition at line 145 of file query.c.

int showVerifyPackage ( QVA_t * qva,
rpmdb rpmdb,
Header h )
 

Display results of package verify.

Parameters:
qva   parsed query/verify options
db   rpm database
h   header to use for verify
Returns:
result of last non-zero verify return

Definition at line 458 of file verify.c.

Variable Documentation

struct rpmBuildArguments rpmBTArgs
 

Definition at line 1290 of file rpmlib.h.

struct poptOption rpmBuildPoptTable
 

Definition at line 119 of file poptBT.c.

struct poptOption rpmQVSourcePoptTable
 

Definition at line 64 of file poptQV.c.

struct poptOption rpmQueryPoptTable
 

Initial value:

 {
 { NULL, '\0', POPT_ARG_CALLBACK | POPT_CBFLAG_INC_DATA, 
        queryArgCallback, 0, NULL, NULL },
 { NULL, '\0', POPT_ARG_INCLUDE_TABLE, rpmQVSourcePoptTable, 0,
        NULL, NULL },
 { "configfiles", 'c', 0, 0, 'c',
         "list all configuration files" , NULL },
 { "docfiles", 'd', 0, 0, 'd',
         "list all documentation files" , NULL },
 { "dump", '\0', 0, 0,  1005 ,
         "dump basic file information" , NULL },
 { "list", 'l', 0, 0, 'l',
         "list files in package" , NULL },
 { "qf", '\0', POPT_ARG_STRING | POPT_ARGFLAG_DOC_HIDDEN, 0, 
         1000 , NULL, NULL },
 { "queryformat", '\0', POPT_ARG_STRING, 0,  1000 ,
         "use the following query format" , "QUERYFORMAT" },
 { "specedit", '\0', POPT_ARG_VAL|POPT_ARGFLAG_DOC_HIDDEN, &specedit, -1,
         "substitute i18n sections into spec file" , NULL },
 { "state", 's', 0, 0, 's',
         "display the states of the listed files" , NULL },
 { "verbose", 'v', 0, 0, 'v',
         "display a verbose file listing" , NULL },
   POPT_TABLEEND
}

Definition at line 128 of file poptQV.c.

struct poptOption rpmVerifyPoptTable
 

Initial value:

 {
 { NULL, '\0', POPT_ARG_CALLBACK | POPT_CBFLAG_INC_DATA, 
        verifyArgCallback, 0, NULL, NULL },
 { NULL, '\0', POPT_ARG_INCLUDE_TABLE, rpmQVSourcePoptTable, 0,
        NULL, NULL },
 { "nodeps", '\0', 0, &noDeps,  1000 ,
         "do not verify package dependencies" ,
        NULL },
 { "nofiles", '\0', 0, &noFiles,  1001 ,
         "don't verify files in package" ,
        NULL},
 { "nomd5", '\0', 0, &noMd5,  1002 ,
         "do not verify file md5 checksums" ,
        NULL },
 { "noscripts", '\0', 0, &noScripts,  1003 ,
         "do not execute %verifyscript (if any)" ,
        NULL },
    POPT_TABLEEND
}

Definition at line 52 of file verify.c.

Generated at Thu Apr 19 15:29:50 2001 for rpm by doxygen1.2.6-20010408 written by Dimitri van Heesch, © 1997-2001