lib/rpmts.c File Reference

Routine(s) to handle a "rpmts" transaction sets. More...

#include "system.h"
#include "rpmio_internal.h"
#include <rpmlib.h>
#include <rpmmacro.h>
#include "rpmdb.h"
#include "rpmevr.h"
#include "rpmal.h"
#include "rpmds.h"
#include "rpmfi.h"
#include "rpmlock.h"
#include "rpmns.h"
#include "rpmte.h"
#include "rpmts.h"
#include "fs.h"
#include "debug.h"

Include dependency graph for rpmts.c:

Go to the source code of this file.

Defines
#define	_RPMDB_INTERNAL
#define	_RPMEVR_INTERNAL
#define	_RPMTE_INTERNAL
#define	_RPMTS_INTERNAL
#define	ST_RDONLY   1
Functions
rpmts	XrpmtsUnlink (rpmts ts, const char *msg, const char *fn, unsigned ln)
rpmts	XrpmtsLink (rpmts ts, const char *msg, const char *fn, unsigned ln)
int	rpmtsCloseDB (rpmts ts)
	Close the database used by the transaction.
int	rpmtsOpenDB (rpmts ts, int dbmode)
	Open the database used by the transaction.
int	rpmtsInitDB (rpmts ts, int dbmode)
	Initialize the database used by the transaction.
int	rpmtsRebuildDB (rpmts ts)
	Rebuild the database used by the transaction.
int	rpmtsVerifyDB (rpmts ts)
	Verify the database used by the transaction.
rpmdbMatchIterator	rpmtsInitIterator (const rpmts ts, rpmTag rpmtag, const void *keyp, size_t keylen)
	Return transaction database iterator.
rpmRC	rpmtsFindPubkey (rpmts ts)
	Retrieve pubkey from rpm database.
int	rpmtsCloseSDB (rpmts ts)
	Close the database used by the transaction to solve dependencies.
int	rpmtsOpenSDB (rpmts ts, int dbmode)
	Open the database used by the transaction to solve dependencies.
static int	sugcmp (const void *a, const void *b)
	Compare suggested package resolutions (qsort/bsearch).
int	rpmtsSolve (rpmts ts, rpmds ds, const void *data)
	Attempt to solve a needed dependency using the solve database.
int	rpmtsAvailable (rpmts ts, const rpmds ds)
	Attempt to solve a needed dependency using memory resident tables.
int	rpmtsSetSolveCallback (rpmts ts, int(*solve)(rpmts ts, rpmds key, const void *data), const void *solveData)
rpmps	rpmtsProblems (rpmts ts)
	Return current transaction set problems.
void	rpmtsCleanDig (rpmts ts)
	Free signature verification data.
void	rpmtsClean (rpmts ts)
	Free memory needed only for dependency checks and ordering.
void	rpmtsEmpty (rpmts ts)
	Re-create an empty transaction set.
static void	rpmtsPrintStat (const char *name, struct rpmop_s *op)
static void	rpmtsPrintStats (rpmts ts)
rpmts	rpmtsFree (rpmts ts)
	Destroy transaction set, closing the database as well.
rpmVSFlags	rpmtsVSFlags (rpmts ts)
	Get verify signatures flag(s).
rpmVSFlags	rpmtsSetVSFlags (rpmts ts, rpmVSFlags vsflags)
	Set verify signatures flag(s).
rpmTSType	rpmtsType (rpmts ts)
	Return the type of a transaction.
void	rpmtsSetType (rpmts ts, rpmTSType type)
	Set transaction type.
uint_32	rpmtsARBGoal (rpmts ts)
	Return the autorollback goal.
void	rpmtsSetARBGoal (rpmts ts, uint_32 goal)
	Set autorollback goal.
int	rpmtsUnorderedSuccessors (rpmts ts, int first)
	Set index of 1st element of successors.
const char *	rpmtsRootDir (rpmts ts)
	Get transaction rootDir, i.e.
void	rpmtsSetRootDir (rpmts ts, const char *rootDir)
	Set transaction rootDir, i.e.
const char *	rpmtsCurrDir (rpmts ts)
	Get transaction currDir, i.e.
void	rpmtsSetCurrDir (rpmts ts, const char *currDir)
	Set transaction currDir, i.e.
FD_t	rpmtsScriptFd (rpmts ts)
	Get transaction script file handle, i.e.
void	rpmtsSetScriptFd (rpmts ts, FD_t scriptFd)
	Set transaction script file handle, i.e.
int	rpmtsSELinuxEnabled (rpmts ts)
	Get selinuxEnabled flag, i.e.
int	rpmtsChrootDone (rpmts ts)
	Get chrootDone flag, i.e.
int	rpmtsSetChrootDone (rpmts ts, int chrootDone)
	Set chrootDone flag, i.e.
rpmsx	rpmtsREContext (rpmts ts)
	Get file security context patterns.
int	rpmtsSetREContext (rpmts ts, rpmsx sx)
	Get file security context patterns.
int_32	rpmtsGetTid (rpmts ts)
	Get transaction id, i.e.
int_32	rpmtsSetTid (rpmts ts, int_32 tid)
	Set transaction id, i.e.
int_32	rpmtsSigtag (const rpmts ts)
	Get signature tag.
int_32	rpmtsSigtype (const rpmts ts)
	Get signature tag type.
const void *	rpmtsSig (const rpmts ts)
	Get signature tag data, i.e.
int_32	rpmtsSiglen (const rpmts ts)
	Get signature tag data length, i.e.
int	rpmtsSetSig (rpmts ts, int_32 sigtag, int_32 sigtype, const void *sig, int_32 siglen)
	Set signature tag info, i.e.
pgpDig	rpmtsDig (rpmts ts)
	Get OpenPGP packet parameters, i.e.
pgpDigParams	rpmtsSignature (const rpmts ts)
	Get OpenPGP signature constants.
pgpDigParams	rpmtsPubkey (const rpmts ts)
	Get OpenPGP pubkey constants.
rpmdb	rpmtsGetRdb (rpmts ts)
	Get transaction set database handle.
rpmPRCO	rpmtsPRCO (rpmts ts)
	Get transaction set dependencies.
int	rpmtsInitDSI (const rpmts ts)
	Initialize disk space info for each and every mounted file systems.
void	rpmtsUpdateDSI (const rpmts ts, dev_t dev, uint_32 fileSize, uint_32 prevSize, uint_32 fixupSize, fileAction action)
	Update disk space info for a file.
void	rpmtsCheckDSIProblems (const rpmts ts, const rpmte te)
	Check a transaction element for disk space problems.
void *	rpmtsNotify (rpmts ts, rpmte te, rpmCallbackType what, unsigned long long amount, unsigned long long total)
	Perform transaction progress notify callback.
int	rpmtsNElements (rpmts ts)
	Return number of (ordered) transaction set elements.
rpmte	rpmtsElement (rpmts ts, int ix)
	Return (ordered) transaction set element.
rpmprobFilterFlags	rpmtsFilterFlags (rpmts ts)
	Get problem ignore bit mask, i.e.
rpmtransFlags	rpmtsFlags (rpmts ts)
	Get transaction flags, i.e.
rpmtransFlags	rpmtsSetFlags (rpmts ts, rpmtransFlags transFlags)
	Set transaction flags, i.e.
rpmdepFlags	rpmtsDFlags (rpmts ts)
	Get dependency flags, i.e.
rpmdepFlags	rpmtsSetDFlags (rpmts ts, rpmdepFlags depFlags)
	Set dependency flags, i.e.
Spec	rpmtsSpec (rpmts ts)
	Get spec control structure from transaction set.
Spec	rpmtsSetSpec (rpmts ts, Spec spec)
	Set a spec control structure in transaction set.
rpmte	rpmtsRelocateElement (rpmts ts)
	Get current relocate transaction element.
rpmte	rpmtsSetRelocateElement (rpmts ts, rpmte relocateElement)
	Set current relocate transaction element.
uint_32	rpmtsColor (rpmts ts)
	Retrieve color bits of transaction set.
uint_32	rpmtsSetColor (rpmts ts, uint_32 color)
	Set color bits of transaction set.
uint_32	rpmtsPrefColor (rpmts ts)
	Retrieve prefered file color.
rpmop	rpmtsOp (rpmts ts, rpmtsOpX opx)
	Retrieve operation timestamp from a transaction set.
int	rpmtsSetNotifyCallback (rpmts ts, rpmCallbackFunction notify, rpmCallbackData notifyData)
	Set transaction notify callback function and argument.
rpmts	rpmtsCreate (void)
	Create an empty transaction set.
Variables
int	_rpmts_debug = 0
int	_rpmts_stats = 0

---

Detailed Description

Routine(s) to handle a "rpmts" transaction sets.

Definition in file rpmts.c.

---

Define Documentation

#define _RPMDB_INTERNAL

Definition at line 11 of file rpmts.c.

#define _RPMEVR_INTERNAL

Definition at line 14 of file rpmts.c.

#define _RPMTE_INTERNAL

Definition at line 23 of file rpmts.c.

#define _RPMTS_INTERNAL

Definition at line 26 of file rpmts.c.

#define ST_RDONLY   1

Referenced by rpmtsCheckDSIProblems(), and rpmtsInitDSI().

---

Function Documentation

uint_32 rpmtsARBGoal

(

rpmts

ts

)

Return the autorollback goal.

Parameters:

ts

transaction set

Returns:

autorollback goal

Definition at line 868 of file rpmts.c.

Referenced by rpmtsRollback().

int rpmtsAvailable	(	rpmts	ts,
		const rpmds	ds
	)

Attempt to solve a needed dependency using memory resident tables.

Deprecated:

This function will move from rpmlib to the python bindings.

Parameters:

	ts	transaction set
	ds	dependency set

Returns:

0 if resolved (and added to ts), 1 not found

Definition at line 615 of file rpmts.c.

References _free(), rpmalAllSatisfiesDepend(), and xrealloc().

uint_32 rpmtsColor

(

rpmts

ts

)

Retrieve color bits of transaction set.

Parameters:

ts

transaction set

Returns:

color bits

Definition at line 1441 of file rpmts.c.

Referenced by checkPackageSet(), handleInstInstalledFiles(), handleOverlappedFiles(), populateInstallHeader(), rpmpsmStage(), rpmtsAddAvailableElement(), rpmtsAddInstallElement(), rpmtsAddObsoletes(), rpmtsAddUpgrades(), rpmtsCheck(), rpmtsOrder(), rpmtsRun(), and skipFiles().

rpmte rpmtsElement	(	rpmts	ts,
		int	ix
	)

Return (ordered) transaction set element.

Parameters:

	ts	transaction set
	ix	transaction element index

Returns:

transaction element (or NULL)

Definition at line 1362 of file rpmts.c.

Referenced by rpmInstallSourcePackage(), rpmtsiFi(), and rpmtsiNextElement().

rpmRC rpmtsFindPubkey

(

rpmts

ts

)

Retrieve pubkey from rpm database.

Parameters:

ts

rpm transaction

Returns:

RPMRC_OK on success, RPMRC_NOKEY if not found

Definition at line 243 of file rpmts.c.

References _free(), pgpDigParams_s::hash_algo, headerFreeData(), headerGetEntry(), PGPARMOR_PUBKEY, pgpGrab(), pgpHexStr(), pgpPrtPkts(), PGPPUBKEYALGO_DSA, PGPPUBKEYALGO_RSA, pgpReadPkts(), pgpDigParams_s::pubkey_algo, rpmdbFreeIterator(), rpmdbGetIteratorFileNum(), rpmdbGetIteratorOffset(), rpmdbNextIterator(), rpmExpand(), RPMMESS_DEBUG, rpmMessage, RPMRC_NOKEY, RPMRC_OK, RPMTAG_PUBKEYS, rpmtsDig(), rpmtsInitIterator(), rpmtsPubkey(), rpmtsSig(), rpmtsSignature(), pgpDigParams_s::signid, and xstrdup().

Referenced by verifyDSASignature(), and verifyRSASignature().

int rpmtsNElements

(

rpmts

ts

)

Return number of (ordered) transaction set elements.

Parameters:

ts

transaction set

Returns:

no. of transaction set elements

Definition at line 1353 of file rpmts.c.

Referenced by rpmtsiNextElement(), rpmtsRun(), and XrpmtsiInit().

void* rpmtsNotify	(	rpmts	ts,
		rpmte	te,
		rpmCallbackType	what,
		unsigned long long	amount,
		unsigned long long	total
	)

Perform transaction progress notify callback.

Warning:

This function's args have changed, so the function cannot be used portably

Parameters:

	ts	transaction set
	te	current transaction element
	what	type of call back
	amount	current value
	total	final value

Returns:

callback dependent pointer

Definition at line 1337 of file rpmts.c.

References rpmteKey(), and TR_ADDED.

Referenced by fsmSetup(), fsmStage(), and rpmpsmStage().

rpmop rpmtsOp	(	rpmts	ts,
		rpmtsOpX	opx
	)

Retrieve operation timestamp from a transaction set.

Parameters:

	ts	transaction set
	opx	operation timestamp index

Returns:

pointer to operation timestamp.

Definition at line 1461 of file rpmts.c.

References RPMTS_OP_MAX.

Referenced by fsmStage(), headerCheck(), psmWait(), rpmpsmStage(), rpmReadPackageFile(), rpmtsCheck(), rpmtsCloseDB(), rpmtsCloseSDB(), rpmtsCreate(), rpmtsOrder(), rpmtsPrintStats(), rpmtsRun(), verifyDSASignature(), verifyMD5Signature(), verifyRSASignature(), and verifySHA1Signature().

uint_32 rpmtsPrefColor

(

rpmts

ts

)

Retrieve prefered file color.

Parameters:

ts

transaction set

Returns:

color bits

Definition at line 1456 of file rpmts.c.

Referenced by handleInstInstalledFiles(), handleOverlappedFiles(), and rpmtsOrder().

static void rpmtsPrintStat	(	const char *	name,
		struct rpmop_s *	op
	)			[static]

Definition at line 730 of file rpmts.c.

References rpmop_s::bytes, rpmop_s::count, and rpmop_s::usecs.

Referenced by rpmtsPrintStats().

static void rpmtsPrintStats

(

rpmts

ts

)

[static]

Definition at line 742 of file rpmts.c.

References rpmswExit(), RPMTS_OP_CHECK, RPMTS_OP_COMPRESS, RPMTS_OP_DBADD, RPMTS_OP_DBDEL, RPMTS_OP_DBGET, RPMTS_OP_DBPUT, RPMTS_OP_DBREMOVE, RPMTS_OP_DIGEST, RPMTS_OP_ERASE, RPMTS_OP_FINGERPRINT, RPMTS_OP_INSTALL, RPMTS_OP_ORDER, RPMTS_OP_READHDR, RPMTS_OP_REPACKAGE, RPMTS_OP_SCRIPTLETS, RPMTS_OP_SIGNATURE, RPMTS_OP_TOTAL, RPMTS_OP_UNCOMPRESS, rpmtsOp(), and rpmtsPrintStat().

Referenced by rpmtsFree().

rpmps rpmtsProblems

(

rpmts

ts

)

Return current transaction set problems.

Parameters:

ts

transaction set

Returns:

current problem set (or NULL)

Definition at line 658 of file rpmts.c.

References rpmpsLink.

Referenced by checkPackageDeps(), cmpArgvStr(), ensureOlder(), handleInstInstalledFiles(), handleOverlappedFiles(), relocateFileList(), rpmErase(), rpmgiNext(), rpmInstall(), rpmrbProblems(), rpmts_Check(), rpmts_Problems(), rpmts_Run(), rpmtsAddInstallElement(), rpmtsCheck(), rpmtsCheckDSIProblems(), rpmtsRun(), and verifyDependencies().

void rpmtsSetARBGoal	(	rpmts	ts,
		uint_32	goal
	)

Set autorollback goal.

Parameters:

	ts	transaction set
	goal	autorollback goal

Definition at line 873 of file rpmts.c.

Referenced by rpmErase(), and rpmInstall().

uint_32 rpmtsSetColor	(	rpmts	ts,
		uint_32	color
	)

Set color bits of transaction set.

Parameters:

	ts	transaction set
	color	new color bits

Returns:

previous color bits

Definition at line 1446 of file rpmts.c.

Referenced by rpmts_SetColor().

int rpmtsSetSolveCallback	(	rpmts	ts,
		int(*)(rpmts ts, rpmds key, const void *data)	solve,
		const void *	solveData
	)

Definition at line 641 of file rpmts.c.

Referenced by rpmts_Check().

void rpmtsSetType	(	rpmts	ts,
		rpmTSType	type
	)

Set transaction type.

Allowed types are: RPMTRANS_TYPE_NORMAL RPMTRANS_TYPE_ROLLBACK RPMTRANS_TYPE_AUTOROLLBACK

Parameters:

	ts	transaction set
	type	transaction type

Definition at line 862 of file rpmts.c.

Referenced by rpmRollback().

int rpmtsSolve	(	rpmts	ts,
		rpmds	ds,
		const void *	data
	)

Attempt to solve a needed dependency using the solve database.

Parameters:

	ts	transaction set
	ds	dependency set
	data	opaque data associated with callback

Returns:

-1 retry, 0 ignore, 1 not found

Definition at line 454 of file rpmts.c.

References _, _free(), D_, Fclose(), Ferror(), Fopen(), Fstrerror(), headerFree(), headerGetEntry(), headerLink(), headerSprintf(), rpmdbFreeIterator(), rpmdbInitIterator(), rpmdbNextIterator(), RPMDEPS_FLAG_ADDINDEPS, rpmdsAnyMatchesDep(), rpmdsN(), rpmdsTagN(), RPMERR_OPEN, RPMERR_QFMT, rpmError, rpmExpand(), rpmHeaderFormats, RPMMESS_DEBUG, rpmMessage, RPMRC_NOKEY, RPMRC_NOTTRUSTED, RPMRC_OK, rpmReadPackageFile(), RPMTAG_BASENAMES, RPMTAG_BUILDTIME, RPMTAG_CONFLICTNAME, RPMTAG_DIRNAMES, RPMTAG_FILELINKTOS, RPMTAG_NAME, RPMTAG_PROVIDENAME, RPMTAG_REQUIRENAME, rpmTagTable, rpmtsAddInstallElement(), rpmtsOpenSDB(), sugcmp(), and xrealloc().

Referenced by rpmInstall(), rpmts_Check(), and rpmtsCreate().

rpmTSType rpmtsType

(

rpmts

ts

)

Return the type of a transaction.

Parameters:

ts

transaction set

Returns:

transaction type, 0 on unknown

Definition at line 857 of file rpmts.c.

Referenced by populateInstallHeader(), rpmpsmStage(), rpmtsRollback(), and rpmtsRun().

static int sugcmp	(	const void *	a,
		const void *	b
	)			[static]

Compare suggested package resolutions (qsort/bsearch).

Parameters:

	a	1st instance address
	b	2nd instance address

Returns:

result of comparison

Definition at line 443 of file rpmts.c.

Referenced by rpmtsSolve().

rpmts XrpmtsLink	(	rpmts	ts,
		const char *	msg,
		const char *	fn,
		unsigned	ln
	)

Todo:

Remove debugging entry from the ABI.

Definition at line 88 of file rpmts.c.

References _rpmts_debug.

rpmts XrpmtsUnlink	(	rpmts	ts,
		const char *	msg,
		const char *	fn,
		unsigned	ln
	)

Todo:

Remove debugging entry from the ABI.

Definition at line 78 of file rpmts.c.

References _rpmts_debug.

---

Variable Documentation

int _rpmts_debug = 0

Definition at line 73 of file rpmts.c.

Referenced by rpmts_AddErase(), rpmts_AddInstall(), rpmts_alloc(), rpmts_Check(), rpmts_Clean(), rpmts_CloseDB(), rpmts_Create(), rpmts_dealloc(), rpmts_Debug(), rpmts_free(), rpmts_HdrCheck(), rpmts_HdrFromFdno(), rpmts_IDTXglob(), rpmts_IDTXload(), rpmts_init(), rpmts_InitDB(), rpmts_iter(), rpmts_iternext(), rpmts_Match(), rpmts_new(), rpmts_Next(), rpmts_OpenDB(), rpmts_Order(), rpmts_PgpImportPubkey(), rpmts_PgpPrtPkts(), rpmts_Problems(), rpmts_RebuildDB(), rpmts_Rollback(), rpmts_Run(), rpmts_SetColor(), rpmts_SetDFlags(), rpmts_SetFlags(), rpmts_SetProbFilter(), rpmts_SetVSFlags(), rpmts_SolveCallback(), rpmts_VerifyDB(), rpmtsAddAvailableElement(), rpmtsCallback(), XrpmtsLink(), and XrpmtsUnlink().

int _rpmts_stats = 0

Definition at line 76 of file rpmts.c.

Referenced by rpmtsFree(), and setStats().