RPMCLI.


Files
file	manifest.c
file	poptI.c
	Popt tables for install modes.
file	poptK.c
	Popt tables for signature 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	rpmcli.h
file	rpminstall.c
file	rpmlib.h
file	verify.c
	Verify installed payload files from package metadata.
file	poptDB.c
	Popt tables for database modes.
Data Structures
struct	rpmBuildArguments_s
	Describe build command line request. More...
struct	rpmQVArguments_s
	Describe query/verify command line request. More...
struct	rpmInstallArguments_s
	Describe database command line requests. More...
struct	rpmDatabaseArguments_s
	Describe database command line requests. More...
struct	rpmSignArguments_s
	Describe signature command line request. More...
RPMQV
enum	rpmQueryFlags_e { QUERY_FOR_DEFAULT = 0, QUERY_MD5 = (1 << 0), QUERY_SIZE = (1 << 1), QUERY_LINKTO = (1 << 2), QUERY_USER = (1 << 3), QUERY_GROUP = (1 << 4), QUERY_MTIME = (1 << 5), QUERY_MODE = (1 << 6), QUERY_RDEV = (1 << 7), QUERY_FILES = (1 << 16), QUERY_DEPS = (1 << 17), QUERY_SCRIPT = (1 << 18), QUERY_DIGEST = (1 << 19), QUERY_FOR_LIST = (1 << 23), QUERY_FOR_STATE = (1 << 24), QUERY_FOR_DOCS = (1 << 25), QUERY_FOR_CONFIG = (1 << 26), QUERY_FOR_DUMPFILES = (1 << 27) }
	Bit(s) to control rpmQuery() operation, stored in qva_flags. More...
enum	rpmVerifyFlags_e { VERIFY_DEFAULT = 0, VERIFY_MD5 = (1 << 0), VERIFY_SIZE = (1 << 1), VERIFY_LINKTO = (1 << 2), VERIFY_USER = (1 << 3), VERIFY_GROUP = (1 << 4), VERIFY_MTIME = (1 << 5), VERIFY_MODE = (1 << 6), VERIFY_RDEV = (1 << 7), VERIFY_FILES = (1 << 16), VERIFY_DEPS = (1 << 17), VERIFY_SCRIPT = (1 << 18), VERIFY_DIGEST = (1 << 19), VERIFY_FOR_LIST = (1 << 23), VERIFY_FOR_STATE = (1 << 24), VERIFY_FOR_DOCS = (1 << 25), VERIFY_FOR_CONFIG = (1 << 26), VERIFY_FOR_DUMPFILES = (1 << 27) }
	Bit(s) to control rpmVerify() operation, stored in qva_flags. More...
struct rpmQVArguments_s	rpmQVArgs
struct poptOption	rpmQVSourcePoptTable []
	Common query/verify mode options.
int	specedit
struct poptOption	rpmQueryPoptTable []
	Query mode options.
struct poptOption	rpmVerifyPoptTable []
	Verify mode options.
typedef enum rpmQueryFlags_e	rpmQueryFlags
	Bit(s) to control rpmQuery() operation, stored in qva_flags.
typedef enum rpmVerifyFlags_e	rpmVerifyFlags
	Bit(s) to control rpmVerify() operation, stored in qva_flags.
typedef int(*	QVF_t )(QVA_t qva, rpmdb db, Header h)
int	showMatches (QVA_t qva, rpmdbMatchIterator mi, QVF_t showPackage)
	Display query/verify information for each header in iterator.
void	rpmDisplayQueryTags (FILE *fp)
	Display list of tags that can be used in --queryformat.
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.
int	showQueryPackage (QVA_t qva, rpmdb db, Header h)
	Display results of package query.
int	rpmQuery (QVA_t qva, rpmQVSources source, const char *arg)
	Display package information.
int	showVerifyPackage (QVA_t qva, rpmdb db, Header h)
	Display results of package verify.
int	rpmVerify (QVA_t qva, rpmQVSources source, const char *arg)
	Verify package install.
RPMK
enum	rpmCheckSigFlags_e { CHECKSIG_NONE = 0, CHECKSIG_PGP = (1 << 0), CHECKSIG_MD5 = (1 << 1), CHECKSIG_GPG = (1 << 2) }
	Bit(s) to control rpmCheckSig() operation. More...
enum	rpmResignFlags_e { RESIGN_NONE = 0, RESIGN_CHK_SIGNATURE = 1, RESIGN_NEW_SIGNATURE, RESIGN_ADD_SIGNATURE }
	Bit(s) to control rpmReSign() operation. More...
struct rpmSignArguments_s	rpmKArgs
struct poptOption	rpmSignPoptTable []
typedef enum rpmCheckSigFlags_e	rpmCheckSigFlags
	Bit(s) to control rpmCheckSig() operation.
typedef enum rpmResignFlags_e	rpmResignFlags
	Bit(s) to control rpmReSign() operation.
int	rpmCheckSig (rpmCheckSigFlags flags, const char **argv)
	Check elements in signature header.
int	rpmReSign (rpmResignFlags add, char passPhrase, const char *argv)
	Create/modify elements in signature header.
RPMQV
enum	rpmQVSources_e { RPMQV_PACKAGE = 0, RPMQV_PATH, RPMQV_ALL, RPMQV_RPM, RPMQV_GROUP, RPMQV_WHATPROVIDES, RPMQV_WHATREQUIRES, RPMQV_TRIGGEREDBY, RPMQV_DBOFFSET, RPMQV_SPECFILE, RPMQV_PKGID, RPMQV_HDRID, RPMQV_FILEID, RPMQV_TID }
	The command line argument will be used to retrieve header(s) . More...
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) }
	Bit(s) for rpmVerifyFile() attributes and result. More...
typedef struct rpmQVArguments_s *	QVA_t
typedef enum rpmQVSources_e	rpmQVSources
	The command line argument will be used to retrieve header(s) .
typedef enum rpmVerifyAttrs_e	rpmVerifyAttrs
	Bit(s) for rpmVerifyFile() attributes and result.
int	rpmVerifyFile (const char root, Header h, int filenum, rpmVerifyAttrs result, rpmVerifyAttrs omitMask)
	Verify file attributes (including MD5 sum).
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), INSTALL_INSTALL = (1 << 7), INSTALL_ERASE = (1 << 8) }
	Bit(s) to control rpmInstall() operation. More...
enum	rpmEraseInterfaceFlags_e { UNINSTALL_NONE = 0, UNINSTALL_NODEPS = (1 << 0), UNINSTALL_ALLMATCHES = (1 << 1) }
	Bit(s) to control rpmErase() operation. More...
typedef enum rpmInstallInterfaceFlags_e	rpmInstallInterfaceFlags
	Bit(s) to control rpmInstall() operation.
typedef enum rpmEraseInterfaceFlags_e	rpmEraseInterfaceFlags
	Bit(s) to control rpmErase() operation.
RPMBT
struct rpmBuildArguments_s	rpmBTArgs
struct poptOption	rpmBuildPoptTable []
typedef struct rpmBuildArguments_s *	BTA_t
RPMEIU
struct rpmInstallArguments_s	rpmIArgs
struct poptOption	rpmInstallPoptTable []
int	rpmInstall (const char rootdir, const char fileArgv, rpmtransFlags transFlags, rpmInstallInterfaceFlags interfaceFlags, rpmprobFilterFlags probFilter, rpmRelocation relocations)
	Install/upgrade/freshen binary rpm package.
int	rpmInstallSource (const char rootdir, const char arg, const char specFile, char cookie)
	Install source rpm package.
int	rpmErase (const char rootdir, const char *argv, rpmtransFlags transFlags, rpmEraseInterfaceFlags interfaceFlags)
	Erase binary rpm package.
int	rpmRollback (struct rpmInstallArguments_s ia, const char *argv)
	Rollback transactions, erasing new, reinstalling old, package(s).
RPMDB
struct rpmDatabaseArguments_s	rpmDBArgs
struct poptOption	rpmDatabasePoptTable []
RPMTS
void	rpmShowRpmlibProvides (FILE *fp)
	Display current rpmlib feature provides.
Functions
static int	checkSpec (Header h)
	Parse spec file and build package.
Variables
int	_noDirTokens
	Should version 3 packages be produced?

Typedef Documentation

typedef struct rpmBuildArguments_s* BTA_t

Definition at line 52 of file rpmcli.h.

typedef struct rpmQVArguments_s* QVA_t

Definition at line 1623 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 141 of file rpmcli.h.

typedef enum rpmCheckSigFlags_e rpmCheckSigFlags

Bit(s) to control rpmCheckSig() operation.

typedef enum rpmEraseInterfaceFlags_e rpmEraseInterfaceFlags

Bit(s) to control rpmErase() operation.

typedef enum rpmInstallInterfaceFlags_e rpmInstallInterfaceFlags

Bit(s) to control rpmInstall() operation.

Todo:: Move to rpmcli.h

typedef enum rpmQueryFlags_e rpmQueryFlags

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

Todo:: Merge rpmQueryFlags, rpmVerifyFlags, and rpmVerifyAttrs?.

typedef enum rpmQVSources_e rpmQVSources

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

..

Todo:: Move to rpmcli.h

typedef enum rpmResignFlags_e rpmResignFlags

Bit(s) to control rpmReSign() operation.

typedef enum rpmVerifyAttrs_e rpmVerifyAttrs

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

Todo:: Move to rpmcli.h.

typedef enum rpmVerifyFlags_e rpmVerifyFlags

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

Todo:: Merge rpmQueryFlags, rpmVerifyFlags, and rpmVerifyAttrs values?.

Enumeration Type Documentation

enum rpmCheckSigFlags_e

Bit(s) to control rpmCheckSig() operation.

Enumerator:

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 506 of file rpmcli.h.

enum rpmEraseInterfaceFlags_e

Bit(s) to control rpmErase() operation.

Enumerator:

UNINSTALL_NONE
UNINSTALL_NODEPS	from --nodeps
UNINSTALL_ALLMATCHES	from --allmatches

Definition at line 1725 of file rpmlib.h.

enum rpmInstallInterfaceFlags_e

Bit(s) to control rpmInstall() operation.

Todo:: Move to rpmcli.h

Enumerator:

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
INSTALL_INSTALL	from --install
INSTALL_ERASE	from --erase

Definition at line 1709 of file rpmlib.h.

enum rpmQueryFlags_e

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

Todo:: Merge rpmQueryFlags, rpmVerifyFlags, and rpmVerifyAttrs?.

Enumerator:

QUERY_FOR_DEFAULT
QUERY_MD5	from --nomd5
QUERY_SIZE	from --nosize
QUERY_LINKTO	from --nolink
QUERY_USER	from --nouser)
QUERY_GROUP	from --nogroup)
QUERY_MTIME	from --nomtime)
QUERY_MODE	from --nomode)
QUERY_RDEV	from --nodev
QUERY_FILES	verify: from --nofiles
QUERY_DEPS	verify: from --nodeps
QUERY_SCRIPT	verify: from --noscripts
QUERY_DIGEST	verify: from --nodigest
QUERY_FOR_LIST	query: from --list
QUERY_FOR_STATE	query: from --state
QUERY_FOR_DOCS	query: from --docfiles
QUERY_FOR_CONFIG	query: from --configfiles
QUERY_FOR_DUMPFILES	query: from --dump

Definition at line 73 of file rpmcli.h.

enum rpmQVSources_e

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

..

Todo:: Move to rpmcli.h

Enumerator:

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).
RPMQV_PKGID	... from package id (header+payload MD5).
RPMQV_HDRID	... from header id (immutable header SHA1).
RPMQV_FILEID	... from file id (file MD5).
RPMQV_TID	... from install transaction id (time stamp).

Definition at line 1629 of file rpmlib.h.

enum rpmResignFlags_e

Bit(s) to control rpmReSign() operation.

Enumerator:

RESIGN_NONE
RESIGN_CHK_SIGNATURE	from --checksig
RESIGN_NEW_SIGNATURE	from --resign
RESIGN_ADD_SIGNATURE	from --addsign

Definition at line 529 of file rpmcli.h.

enum rpmVerifyAttrs_e

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

Todo:: Move to rpmcli.h.

Enumerator:

RPMVERIFY_NONE
RPMVERIFY_MD5	from verify(md5)
RPMVERIFY_FILESIZE	from verify(size)
RPMVERIFY_LINKTO	from verify(link)
RPMVERIFY_USER	from verify(user)
RPMVERIFY_GROUP	from verify(group)
RPMVERIFY_MTIME	from verify(mtime)
RPMVERIFY_MODE	from verify(mode)
RPMVERIFY_RDEV	from verify(rdev)
RPMVERIFY_READLINKFAIL
RPMVERIFY_READFAIL
RPMVERIFY_LSTATFAIL

Definition at line 1650 of file rpmlib.h.

enum rpmVerifyFlags_e

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

Todo:: Merge rpmQueryFlags, rpmVerifyFlags, and rpmVerifyAttrs values?.

Enumerator:

VERIFY_DEFAULT
VERIFY_MD5	from --nomd5
VERIFY_SIZE	from --nosize
VERIFY_LINKTO	from --nolinkto
VERIFY_USER	from --nouser
VERIFY_GROUP	from --nogroup
VERIFY_MTIME	from --nomtime
VERIFY_MODE	from --nomode
VERIFY_RDEV	from --nodev
VERIFY_FILES	verify: from --nofiles
VERIFY_DEPS	verify: from --nodeps
VERIFY_SCRIPT	verify: from --noscripts
VERIFY_DIGEST	verify: from --nodigest
VERIFY_FOR_LIST	query: from --list
VERIFY_FOR_STATE	query: from --state
VERIFY_FOR_DOCS	query: from --docfiles
VERIFY_FOR_CONFIG	query: from --configfiles
VERIFY_FOR_DUMPFILES	query: from --dump

Definition at line 102 of file rpmcli.h.

Function Documentation

static int checkSpec ( Header h ) [static]

Parse spec file and build package.

Definition at line 19 of file build.c.

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 250 of file rpmchecksig.c.

void rpmDisplayQueryTags ( FILE * fp )

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

Parameters:

fp

file handle to use for display

Definition at line 507 of file query.c.

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 593 of file rpminstall.c.

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

Install/upgrade/freshen binary rpm package.

Parameters:

	rootdir	path to top of install tree
	fileArgv	array of package file names (NULL terminated)
	transFlags	bits to control rpmRunTransactions()
	interfaceFlags	bits to control rpmInstall()
	probFilter	bits to filter problem types
	relocations	package file relocations

Returns:: 0 on success

Todo:: Generalize --freshen policies.

Definition at line 201 of file rpminstall.c.

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

Install source rpm package.

Parameters:

	rootdir	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 681 of file rpminstall.c.

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

Display package information.

Todo:: hack: RPMQV_ALL can pass char ** arglist = NULL, not char * arg. Union?

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 953 of file query.c.

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 580 of file query.c.

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 105 of file rpmchecksig.c.

int rpmRollback	(	struct rpmInstallArguments_s *	ia,
		const char **	argv
	)

Rollback transactions, erasing new, reinstalling old, package(s).

Returns:: 0 on success

Definition at line 902 of file rpminstall.c.

void rpmShowRpmlibProvides ( FILE * fp )

Display current rpmlib feature provides.

Parameters:

fp

output file handle

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

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

Verify file attributes (including MD5 sum).

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

Parameters:

	root	path to top of install tree
	h	header
	filenum	index of file in header file info arrays

Return values:

result

address of bit(s) returned to indicate failure

Parameters:

omitMask

bit(s) to disable verify checks

Returns:: 0 on success (or not installed), 1 on error

Definition at line 22 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 534 of file query.c.

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 150 of file query.c.

int showVerifyPackage	(	QVA_t	qva,
		rpmdb	db,
		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 520 of file verify.c.

Variable Documentation

int _noDirTokens

Should version 3 packages be produced?

Definition at line 289 of file misc.c.

struct rpmBuildArguments_s rpmBTArgs

Definition at line 15 of file poptBT.c.

struct poptOption rpmBuildPoptTable[]

Definition at line 140 of file poptBT.c.

struct poptOption rpmDatabasePoptTable[]

Definition at line 20 of file poptDB.c.

struct rpmDatabaseArguments_s rpmDBArgs

Definition at line 12 of file poptDB.c.

struct rpmInstallArguments_s rpmIArgs

Definition at line 17 of file poptI.c.

struct poptOption rpmInstallPoptTable[]

Definition at line 96 of file poptI.c.

struct rpmSignArguments_s rpmKArgs

Definition at line 13 of file poptK.c.

struct poptOption rpmQueryPoptTable[]

Query mode options.

Definition at line 165 of file poptQV.c.

struct rpmQVArguments_s rpmQVArgs

Definition at line 14 of file poptQV.c.

struct poptOption rpmQVSourcePoptTable[]

Common query/verify mode options.

Definition at line 84 of file poptQV.c.

struct poptOption rpmSignPoptTable[]

Definition at line 50 of file poptK.c.

struct poptOption rpmVerifyPoptTable[]

Verify mode options.

Definition at line 209 of file poptQV.c.

int specedit

Definition at line 17 of file poptQV.c.

RPMCLI.

Files

Data Structures

RPMQV

RPMK

RPMQV

RPMEIU

RPMBT

RPMEIU

RPMDB

RPMTS

Functions

Variables

Typedef Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation