rpm  4.5
Files | Typedefs | Functions
RPMTS Transaction Set API.
Collaboration diagram for RPMTS Transaction Set API.:

Files

file  depends.c
file  psm.c
 

Package state machine to handle a package from a transaction set.


file  rpmlib.h
 

In Memoriam: Steve Taylor <staylor@redhat.com> was here, now he's not.


file  rpmte.h
 

Structures used for an "rpmte" transaction element.


file  rpmts.h
 

Structures and prototypes used for an "rpmts" transaction set.


file  transaction.c

Typedefs

typedef struct rpmts_s * rpmts
 The RPM Transaction Set.
typedef void * alKey
 An added/available package retrieval key.
typedef int alNum
 An added/available package retrieval index.

Functions

int rpmtsCheck (rpmts ts)
 Check that all dependencies can be resolved.
int rpmtsOrder (rpmts ts)
 Determine package order in a transaction set according to dependencies.
int rpmtsRun (rpmts ts, rpmps okProbs, rpmprobFilterFlags ignoreSet)
 Process all package elements in a transaction set.
rpmRC rpmtsRollback (rpmts rbts, rpmprobFilterFlags ignoreSet, int running, rpmte rbte)
 Rollback a failed transaction.
rpmts rpmtsUnlink (rpmts ts, const char *msg)
 Unreference a transaction instance.
rpmts rpmtsLink (rpmts ts, const char *msg)
 Reference a transaction set instance.
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.
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.
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.
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).
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 (const 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.
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.
int rpmtsSetNotifyCallback (rpmts ts, rpmCallbackFunction notify, rpmCallbackData notifyData)
 Set transaction notify callback function and argument.
rpmts rpmtsCreate (void)
 Create an empty transaction set.
int rpmtsAddInstallElement (rpmts ts, Header h, const fnpyKey key, int upgrade, rpmRelocation relocs)
 Add package to be installed to transaction set.
int rpmtsAddEraseElement (rpmts ts, Header h, int dboffset)
 Add package to be erased to transaction set.

RPMTS

enum  rpmdepFlags_e {
  RPMDEPS_FLAG_NONE = 0, RPMDEPS_FLAG_NOUPGRADE = (1 << 0), RPMDEPS_FLAG_NOREQUIRES = (1 << 1), RPMDEPS_FLAG_NOCONFLICTS = (1 << 2),
  RPMDEPS_FLAG_NOOBSOLETES = (1 << 3), RPMDEPS_FLAG_NOPARENTDIRS = (1 << 4), RPMDEPS_FLAG_NOLINKTOS = (1 << 5), RPMDEPS_FLAG_ANACONDA = (1 << 6),
  RPMDEPS_FLAG_NOSUGGEST = (1 << 7), RPMDEPS_FLAG_ADDINDEPS = (1 << 8), RPMDEPS_FLAG_DEPLOOPS = (1 << 9)
}
 Bit(s) to control rpmtsCheck() and rpmtsOrder() operation. More...
enum  rpmtransFlags_e {
  RPMTRANS_FLAG_NONE = 0, RPMTRANS_FLAG_TEST = (1 << 0), RPMTRANS_FLAG_BUILD_PROBS = (1 << 1), RPMTRANS_FLAG_NOSCRIPTS = (1 << 2),
  RPMTRANS_FLAG_JUSTDB = (1 << 3), RPMTRANS_FLAG_NOTRIGGERS = (1 << 4), RPMTRANS_FLAG_NODOCS = (1 << 5), RPMTRANS_FLAG_ALLFILES = (1 << 6),
  RPMTRANS_FLAG_KEEPOBSOLETE = (1 << 7), RPMTRANS_FLAG_NOCONTEXTS = (1 << 8), RPMTRANS_FLAG_DIRSTASH = (1 << 9), RPMTRANS_FLAG_REPACKAGE = (1 << 10),
  RPMTRANS_FLAG_PKGCOMMIT = (1 << 11), RPMTRANS_FLAG_PKGUNDO = (1 << 12), RPMTRANS_FLAG_COMMIT = (1 << 13), RPMTRANS_FLAG_UNDO = (1 << 14),
  RPMTRANS_FLAG_NOTRIGGERPREIN = (1 << 16), RPMTRANS_FLAG_NOPRE = (1 << 17), RPMTRANS_FLAG_NOPOST = (1 << 18), RPMTRANS_FLAG_NOTRIGGERIN = (1 << 19),
  RPMTRANS_FLAG_NOTRIGGERUN = (1 << 20), RPMTRANS_FLAG_NOPREUN = (1 << 21), RPMTRANS_FLAG_NOPOSTUN = (1 << 22), RPMTRANS_FLAG_NOTRIGGERPOSTUN = (1 << 23),
  RPMTRANS_FLAG_NOPAYLOAD = (1 << 24), RPMTRANS_FLAG_APPLYONLY = (1 << 25), RPMTRANS_FLAG_NOFDIGESTS = (1 << 27), RPMTRANS_FLAG_NOCONFIGS = (1 << 30)
}
 Bit(s) to control rpmtsRun() operation. More...
typedef struct rpmpsm_srpmpsm
 Package state machine data.
typedef enum rpmdepFlags_e rpmdepFlags
 Bit(s) to control rpmtsCheck() and rpmtsOrder() operation.
typedef enum rpmtransFlags_e rpmtransFlags
 Bit(s) to control rpmtsRun() operation.

Typedef Documentation

typedef void* alKey

An added/available package retrieval key.

Definition at line 71 of file rpmlib.h.

typedef int alNum

An added/available package retrieval index.

Definition at line 78 of file rpmlib.h.

typedef enum rpmdepFlags_e rpmdepFlags

Bit(s) to control rpmtsCheck() and rpmtsOrder() operation.

Todo:
Move to rpmts.h.
typedef struct rpmpsm_s* rpmpsm

Package state machine data.

Definition at line 807 of file rpmlib.h.

Bit(s) to control rpmtsRun() operation.

Todo:
Move to rpmts.h.
typedef struct rpmts_s* rpmts

The RPM Transaction Set.

Transaction sets are inherently unordered! RPM may reorder transaction sets to reduce errors. In general, installs/upgrades are done before strict removals, and prerequisite ordering is done on installs/upgrades.

Definition at line 62 of file rpmlib.h.


Enumeration Type Documentation

Bit(s) to control rpmtsCheck() and rpmtsOrder() operation.

Todo:
Move to rpmts.h.
Enumerator:
RPMDEPS_FLAG_NONE 
RPMDEPS_FLAG_NOUPGRADE 

from --noupgrade

RPMDEPS_FLAG_NOREQUIRES 

from --norequires

RPMDEPS_FLAG_NOCONFLICTS 

from --noconflicts

RPMDEPS_FLAG_NOOBSOLETES 

from --noobsoletes

RPMDEPS_FLAG_NOPARENTDIRS 

from --noparentdirs

RPMDEPS_FLAG_NOLINKTOS 

from --nolinktos

RPMDEPS_FLAG_ANACONDA 

from --anaconda

RPMDEPS_FLAG_NOSUGGEST 

from --nosuggest

RPMDEPS_FLAG_ADDINDEPS 

from --aid

RPMDEPS_FLAG_DEPLOOPS 

from --deploops

Definition at line 887 of file rpmlib.h.

Bit(s) to control rpmtsRun() operation.

Todo:
Move to rpmts.h.
Enumerator:
RPMTRANS_FLAG_NONE 
RPMTRANS_FLAG_TEST 

from --test

RPMTRANS_FLAG_BUILD_PROBS 

don't process payload

RPMTRANS_FLAG_NOSCRIPTS 

from --noscripts

RPMTRANS_FLAG_JUSTDB 

from --justdb

RPMTRANS_FLAG_NOTRIGGERS 

from --notriggers

RPMTRANS_FLAG_NODOCS 

from --excludedocs

RPMTRANS_FLAG_ALLFILES 

from --allfiles

RPMTRANS_FLAG_KEEPOBSOLETE 
Todo:
Document.
RPMTRANS_FLAG_NOCONTEXTS 

from --nocontexts

RPMTRANS_FLAG_DIRSTASH 

from --dirstash

RPMTRANS_FLAG_REPACKAGE 

from --repackage

RPMTRANS_FLAG_PKGCOMMIT 
RPMTRANS_FLAG_PKGUNDO 
RPMTRANS_FLAG_COMMIT 
RPMTRANS_FLAG_UNDO 
RPMTRANS_FLAG_NOTRIGGERPREIN 

from --notriggerprein

RPMTRANS_FLAG_NOPRE 

from --nopre

RPMTRANS_FLAG_NOPOST 

from --nopost

RPMTRANS_FLAG_NOTRIGGERIN 

from --notriggerin

RPMTRANS_FLAG_NOTRIGGERUN 

from --notriggerun

RPMTRANS_FLAG_NOPREUN 

from --nopreun

RPMTRANS_FLAG_NOPOSTUN 

from --nopostun

RPMTRANS_FLAG_NOTRIGGERPOSTUN 

from --notriggerpostun

RPMTRANS_FLAG_NOPAYLOAD 
RPMTRANS_FLAG_APPLYONLY 
RPMTRANS_FLAG_NOFDIGESTS 

from --nofdigests

RPMTRANS_FLAG_NOCONFIGS 

from --noconfigs

Definition at line 905 of file rpmlib.h.


Function Documentation

int rpmtsAddEraseElement ( rpmts  ts,
Header  h,
int  dboffset 
)

Add package to be erased to transaction set.

Parameters:
tstransaction set
hheader
dboffsetrpm database instance
Returns:
0 on success

Definition at line 720 of file depends.c.

References removePackage(), and RPMAL_NOMATCH.

Referenced by findErases(), rpmErase(), rpmgiNext(), rpmts_AddErase(), and verifyDependencies().

int rpmtsAddInstallElement ( rpmts  ts,
Header  h,
const fnpyKey  key,
int  upgrade,
rpmRelocation  relocs 
)

Add package to be installed to transaction set.

The transaction set is checked for duplicate package names. If found, the package with the "newest" EVR will be replaced.

Parameters:
tstransaction set
hheader
keypackage retrieval key (e.g. file name)
upgradeis package being upgraded?
relocspackage file relocations
Returns:
0 on success, 1 on I/O error, 2 needs capabilities

Definition at line 479 of file depends.c.

References _, _free(), headerGetEntryMinMemory(), headerIsEntry(), hGetColor(), hGetNEVRA(), nplatpat, platform, platpat, RPMAL_NOMATCH, rpmalAdd(), rpmcliPackagesTotal, RPMDEPS_FLAG_NOOBSOLETES, RPMDEPS_FLAG_NOUPGRADE, rpmdsCompare(), rpmdsDNEVR(), rpmdsFree(), rpmdsThis(), rpmExpand(), rpmIsVerbose, RPMMESS_WARNING, rpmMessage, rpmPlatformScore(), RPMPROB_BADPLATFORM, rpmpsAppend(), rpmpsFree(), RPMSENSE_EQUAL, RPMSENSE_GREATER, RPMSENSE_LESS, rpmteA(), rpmteAddedKey(), rpmteDS(), rpmteFI(), rpmteFree(), rpmteIsSource(), rpmteKey(), rpmteN(), rpmteNew(), rpmteO(), rpmteSetAddedKey(), rpmteSetHeader(), rpmteType(), rpmtsAddObsoletes(), rpmtsAddUpgrades(), rpmtsColor(), rpmtsDFlags(), rpmtsGetRdb(), rpmtsiFree(), rpmtsiInit(), rpmtsiNext(), rpmtsOpenDB(), rpmtsProblems(), TR_ADDED, TR_REMOVED, xrealloc(), and xstrdup().

Referenced by rpmgiNext(), rpmInstall(), rpmInstallSourcePackage(), rpmRollback(), rpmts_AddInstall(), rpmtsSolve(), and verifyDependencies().

int rpmtsCheck ( rpmts  ts)
void rpmtsCheckDSIProblems ( const rpmts  ts,
const rpmte  te 
)

Check a transaction element for disk space problems.

Parameters:
tstransaction set
tecurrent transaction element

Definition at line 1294 of file rpmts.c.

References rpmfiFC(), RPMPROB_DISKNODES, RPMPROB_DISKSPACE, RPMPROB_RDONLY, rpmpsAppend(), rpmpsFree(), rpmteFI(), rpmteKey(), rpmteNEVR(), rpmtsProblems(), and ST_RDONLY.

Referenced by rpmtsRun().

int rpmtsChrootDone ( rpmts  ts)

Get chrootDone flag, i.e.

has chroot(2) been performed?

Parameters:
tstransaction set
Returns:
chrootDone flag

Definition at line 992 of file rpmts.c.

Referenced by rpmpsmStage(), rpmtsRun(), and runScript().

void rpmtsClean ( rpmts  ts)

Free memory needed only for dependency checks and ordering.

Parameters:
tstransaction set

Definition at line 674 of file rpmts.c.

References _free(), rpmalFree(), rpmpsFree(), rpmteCleanDS(), rpmtsCleanDig(), rpmtsiFree(), rpmtsiInit(), and rpmtsiNext().

Referenced by rpmcliImportPubkeys(), rpmErase(), rpmInstall(), rpmInstallSourcePackage(), rpmRollback(), rpmts_Clean(), rpmtsEmpty(), and rpmtsOrder().

void rpmtsCleanDig ( rpmts  ts)

Free signature verification data.

Parameters:
tstransaction set

Definition at line 668 of file rpmts.c.

References headerFreeData(), and pgpFreeDig().

Referenced by headerCheck(), rpmReadPackageFile(), rpmtsClean(), and rpmVerifySignatures().

int rpmtsCloseDB ( rpmts  ts)

Close the database used by the transaction.

Parameters:
tstransaction set
Returns:
0 on success

Definition at line 98 of file rpmts.c.

References rpmdbClose(), rpmswAdd(), RPMTS_OP_DBDEL, RPMTS_OP_DBGET, RPMTS_OP_DBPUT, and rpmtsOp().

Referenced by rpmts_CloseDB(), rpmts_InitDB(), rpmtsCheck(), rpmtsFree(), and rpmtsOpenDB().

int rpmtsCloseSDB ( rpmts  ts)

Close the database used by the transaction to solve dependencies.

Parameters:
tstransaction set
Returns:
0 on success

Definition at line 391 of file rpmts.c.

References rpmdbClose(), rpmswAdd(), RPMTS_OP_DBDEL, RPMTS_OP_DBGET, RPMTS_OP_DBPUT, and rpmtsOp().

Referenced by rpmtsFree().

rpmts rpmtsCreate ( void  )
const char* rpmtsCurrDir ( rpmts  ts)

Get transaction currDir, i.e.

current directory before chroot(2).

Parameters:
tstransaction set
Returns:
transaction currDir

Definition at line 943 of file rpmts.c.

Referenced by rpmpsmStage(), and rpmtsRun().

rpmdepFlags rpmtsDFlags ( rpmts  ts)

Get dependency flags, i.e.

bits that control rpmtsCheck() and rpmtsOrder().

Parameters:
tstransaction set
Returns:
dependency flags

Definition at line 1394 of file rpmts.c.

Referenced by checkPackageSet(), ignoreDep(), rpmgiNext(), rpmtsAddInstallElement(), rpmtsCheck(), rpmtsOrder(), rpmtsRollback(), and unsatisfiedDepend().

pgpDig rpmtsDig ( rpmts  ts)

Get OpenPGP packet parameters, i.e.

signature/pubkey constants.

Parameters:
tstransaction set
Returns:
signature/pubkey constants.

Definition at line 1093 of file rpmts.c.

References pgpNewDig().

Referenced by headerCheck(), rpmReadPackageFile(), rpmtsFindPubkey(), rpmtsPubkey(), rpmtsSignature(), rpmtsStashKeyid(), rpmVerifySignature(), rpmVerifySignatures(), verifyDSASignature(), verifyMD5Signature(), verifyRSASignature(), verifySHA1Signature(), and verifySizeSignature().

void rpmtsEmpty ( rpmts  ts)

Re-create an empty transaction set.

Parameters:
tstransaction set

Definition at line 701 of file rpmts.c.

References rpmteFree(), rpmtsClean(), rpmtsiFree(), rpmtsiInit(), and rpmtsiNext().

Referenced by rpmcliArgIter(), rpmcliVerify(), rpmErase(), rpmInstall(), rpmRollback(), rpmtsFree(), rpmtsRollback(), and verifyDependencies().

rpmprobFilterFlags rpmtsFilterFlags ( rpmts  ts)

Get problem ignore bit mask, i.e.

bits to filter encountered problems.

Parameters:
tstransaction set
Returns:
ignore bit mask

Definition at line 1374 of file rpmts.c.

Referenced by handleOverlappedFiles(), relocateFileList(), rpmtsInitDSI(), and rpmtsRun().

rpmtransFlags rpmtsFlags ( rpmts  ts)

Get transaction flags, i.e.

bits that control rpmtsRun().

Parameters:
tstransaction set
Returns:
transaction flags

Definition at line 1379 of file rpmts.c.

Referenced by fsmMapAttrs(), fsmMapFContext(), fsmMkdirs(), fsmStage(), handleInstInstalledFiles(), rpmInstall(), rpmpsmStage(), rpmtsRollback(), rpmtsRun(), and skipFiles().

rpmts rpmtsFree ( rpmts  ts)

Destroy transaction set, closing the database as well.

Parameters:
tstransaction set
Returns:
NULL always

Definition at line 768 of file rpmts.c.

References _free(), _rpmts_stats, fdFree(), rpmalFree(), rpmdsFreePRCO(), rpmsxFree(), rpmtsCloseDB(), rpmtsCloseSDB(), rpmtsEmpty(), rpmtsPrintStats(), and rpmtsUnlink().

Referenced by cpio_doio(), main(), mapFreeIterator(), readRPM(), rpmfcFindRequiredPackages(), rpmgiFree(), rpmInstallSourcePackage(), rpmpsmFree(), rpmts_dealloc(), rpmts_free(), and XrpmtsiFree().

rpmdb rpmtsGetRdb ( rpmts  ts)

Get transaction set database handle.

Parameters:
tstransaction set
Returns:
transaction database handle

Definition at line 1122 of file rpmts.c.

Referenced by checkDependentConflicts(), checkDependentPackages(), handleOneTrigger(), rpmcliImportPubkey(), rpmpsmStage(), rpmtsAddInstallElement(), rpmtsCheck(), rpmtsRollback(), rpmtsRun(), runTriggers(), and unsatisfiedDepend().

int_32 rpmtsGetTid ( rpmts  ts)

Get transaction id, i.e.

transaction time stamp.

Parameters:
tstransaction set
Returns:
transaction id

Definition at line 1026 of file rpmts.c.

Referenced by fsmSetup(), rpmcliImportPubkey(), rpmpsmStage(), and rpmtsRollback().

int rpmtsInitDB ( rpmts  ts,
int  dbmode 
)

Initialize the database used by the transaction.

Deprecated:
An explicit rpmdbInit() is almost never needed.
Parameters:
tstransaction set
dbmodeO_RDONLY or O_RDWR
Returns:
0 on success

Definition at line 135 of file rpmts.c.

References rpmdbInit().

Referenced by main(), and rpmts_InitDB().

int rpmtsInitDSI ( const rpmts  ts)

Initialize disk space info for each and every mounted file systems.

Parameters:
tstransaction set
Returns:
0 on success

Definition at line 1140 of file rpmts.c.

References _free(), D_, rpmGetFilesystemList(), RPMMESS_DEBUG, rpmMessage, RPMPROB_FILTER_DISKSPACE, rpmtsFilterFlags(), ST_RDONLY, and xcalloc().

Referenced by rpmtsRun(), and unsatisfiedDepend().

rpmdbMatchIterator rpmtsInitIterator ( const rpmts  ts,
rpmTag  rpmtag,
const void *  keyp,
size_t  keylen 
)
rpmts rpmtsLink ( rpmts  ts,
const char *  msg 
)

Reference a transaction set instance.

Parameters:
tstransaction set
msg
Returns:
new transaction set reference

Referenced by mapInitIterator(), rpmgiNew(), rpmInstallSourcePackage(), rpmpsmNew(), rpmtsCreate(), and XrpmtsiInit().

int rpmtsOpenDB ( rpmts  ts,
int  dbmode 
)

Open the database used by the transaction.

Parameters:
tstransaction set
dbmodeO_RDONLY or O_RDWR
Returns:
0 on success

Definition at line 112 of file rpmts.c.

References _, _free(), rpmdbOpen(), rpmGetPath(), RPMMESS_ERROR, rpmMessage, and rpmtsCloseDB().

Referenced by rpmcliImportPubkey(), rpmts_Match(), rpmts_OpenDB(), rpmtsAddInstallElement(), rpmtsCheck(), rpmtsInitIterator(), rpmtsRollback(), and rpmtsRun().

int rpmtsOpenSDB ( rpmts  ts,
int  dbmode 
)

Open the database used by the transaction to solve dependencies.

Parameters:
tstransaction set
dbmodeO_RDONLY or O_RDWR
Returns:
0 on success

Definition at line 405 of file rpmts.c.

References _, _free(), addMacro(), delMacro(), RMIL_DEFAULT, rpmdbOpen(), rpmExpandNumeric(), rpmGetPath(), RPMMESS_WARNING, and rpmMessage.

Referenced by rpmtsSolve().

int rpmtsOrder ( rpmts  ts)

Determine package order in a transaction set according to dependencies.

Order packages, returning error if circular dependencies cannot be eliminated by removing Requires's from the loop(s). Only dependencies from added or removed packages are used to determine ordering using a topological sort (Knuth vol. 1, p. 262). Use rpmtsCheck() to verify that all dependencies can be resolved.

The final order ends up as installed packages followed by removed packages, with packages removed for upgrades immediately following the new package to be installed.

Parameters:
tstransaction set
Returns:
no. of (added) packages that could not be ordered

Definition at line 2066 of file depends.c.

References _, _free(), addQ(), addRelation(), alloca(), D_, freeBadDeps(), isAuto, markLoop(), orderListIndexCmp(), orderListIndex_s::orIndex, orderListIndex_s::pkgKey, RPMAL_NOMATCH, rpmalAdd(), rpmalMakeIndex(), RPMDEPS_FLAG_ANACONDA, RPMDEPS_FLAG_DEPLOOPS, rpmdsFlags(), rpmdsFromPRCO(), rpmdsInit(), rpmdsNext(), RPMMESS_DEBUG, RPMMESS_ERROR, RPMMESS_WARNING, rpmMessage, RPMPROB_FILTER_NONE, rpmswEnter(), rpmswExit(), rpmteAddedKey(), rpmteDegree(), rpmteDepth(), rpmteDS(), rpmteFI(), rpmteFreeTSI(), rpmteNEVRA(), rpmteNewTSI(), rpmteNpreds(), rpmtePkgFileSize(), rpmteSetAddedKey(), rpmteSetBreadth(), rpmteSetDegree(), rpmteSetDepth(), rpmteSetNpreds(), rpmteSetParent(), rpmteSetTree(), rpmteTree(), rpmteTSI(), rpmteType(), RPMTS_OP_ORDER, rpmtsClean(), rpmtsColor(), rpmtsDFlags(), rpmtsiFree(), rpmtsiInit(), rpmtsiNext(), rpmtsiOc(), rpmtsOp(), rpmtsPrefColor(), rpmtsRollback(), rpmtsUnorderedSuccessors(), stpcpy(), TR_ADDED, TR_REMOVED, xcalloc(), and zapRelation().

Referenced by rpmErase(), rpmgiNew(), rpmInstall(), rpmrbOrder(), and rpmts_Order().

rpmPRCO rpmtsPRCO ( rpmts  ts)

Get transaction set dependencies.

Parameters:
tstransaction set
Returns:
transaction set dependencies.

Definition at line 1133 of file rpmts.c.

pgpDigParams rpmtsPubkey ( const rpmts  ts)

Get OpenPGP pubkey constants.

Parameters:
tstransaction set
Returns:
pubkey constants.

Definition at line 1113 of file rpmts.c.

References pgpDig_s::pubkey, and rpmtsDig().

Referenced by rpmtsFindPubkey().

int rpmtsRebuildDB ( rpmts  ts)

Rebuild the database used by the transaction.

Parameters:
tstransaction set
Returns:
0 on success

Definition at line 143 of file rpmts.c.

References headerCheck(), rpmdbRebuild(), and RPMVSF_NOHDRCHK.

Referenced by main(), and rpmts_RebuildDB().

rpmsx rpmtsREContext ( const rpmts  ts)

Get file security context patterns.

Parameters:
tstransaction set
Returns:
file security context patterns

Definition at line 1009 of file rpmts.c.

References rpmsxLink().

Referenced by fsmMkdirs().

rpmte rpmtsRelocateElement ( rpmts  ts)

Get current relocate transaction element.

Parameters:
tstransaction set
Returns:
current relocate transaction element

Definition at line 1425 of file rpmts.c.

Referenced by relocateFileList(), and rpmfiNew().

rpmRC rpmtsRollback ( rpmts  rbts,
rpmprobFilterFlags  ignoreSet,
int  running,
rpmte  rbte 
)
const char* rpmtsRootDir ( rpmts  ts)

Get transaction rootDir, i.e.

path to chroot(2).

Parameters:
tstransaction set
Returns:
transaction rootDir

Definition at line 890 of file rpmts.c.

References URL_IS_DASH, URL_IS_FTP, URL_IS_HKP, URL_IS_HTTP, URL_IS_HTTPS, URL_IS_PATH, URL_IS_UNKNOWN, and urlPath().

Referenced by rpmInstall(), rpmInstallSourcePackage(), rpmpsmStage(), rpmtsRun(), rpmVerifyFile(), and runScript().

int rpmtsRun ( rpmts  ts,
rpmps  okProbs,
rpmprobFilterFlags  ignoreSet 
)

Process all package elements in a transaction set.

Before calling rpmtsRun be sure to have:

Additionally, though not required you may want to:

Parameters:
tstransaction set
okProbspreviously known problems (or NULL)
ignoreSetbits to filter problem types
Returns:
0 on success, -1 on error, >0 with newProbs set

Definition at line 1132 of file transaction.c.

References _, _free(), _noTransScripts, _noTransTriggers, Chdir(), Chroot(), CPIO_ALL_HARDLINKS, CPIO_MAP_ABSOLUTE, CPIO_MAP_ADDDOT, CPIO_SBIT_CHECK, currentDirectory(), D_, dbiFreeIndexSet(), dbiIndexRecordFileNumber(), dbiIndexRecordOffset(), dbiIndexSetCount(), ensureOlder(), rpmpsm_s::fi, fpCacheCreate(), fpCacheFree(), fpEqual(), fpHashFunction(), fpLookupList(), handleInstInstalledFiles(), handleOverlappedFiles(), handleRmvdInstalledFiles(), headerFree(), htAddEntry(), htCreate(), htFree(), Lstat(), markLinkedFailed(), NOTIFY, rpmpsm_s::progTag, PSM_PKGERASE, PSM_PKGINSTALL, PSM_PKGSAVE, PSM_SCRIPT, RPMCALLBACK_INST_CLOSE_FILE, RPMCALLBACK_INST_OPEN_FILE, RPMCALLBACK_REPACKAGE_PROGRESS, RPMCALLBACK_REPACKAGE_START, RPMCALLBACK_REPACKAGE_STOP, RPMCALLBACK_TRANS_PROGRESS, RPMCALLBACK_TRANS_START, RPMCALLBACK_TRANS_STOP, rpmdbCheckSignals(), rpmdbFindFpList(), rpmdbFreeIterator(), rpmdbNextIterator(), rpmdbOpenAll(), rpmdbSetIteratorRE(), rpmdbSync(), rpmExpandNumeric(), rpmfiFC(), rpmfiFFlags(), rpmfiFN(), rpmfiFree(), rpmfiInit(), RPMFILE_CONFIG, RPMFILE_EXISTS, RPMFILE_SPARSE, rpmfiLink(), rpmfiNew(), rpmfiNext(), rpmfiSetFFlags(), RPMMESS_DEBUG, RPMMESS_ERROR, rpmMessage, RPMPROB_FILTER_OLDPACKAGE, RPMPROB_FILTER_REPLACEOLDFILES, RPMPROB_FILTER_REPLACEPKG, RPMPROB_PKG_INSTALLED, rpmpsAppend(), rpmpsCreate(), rpmpsFree(), rpmpsmFree(), rpmpsmNew(), rpmpsmStage(), rpmpsNumProblems(), rpmpsTrim(), RPMRC_NOKEY, RPMRC_NOTTRUSTED, RPMRC_OK, rpmReadPackageFile(), rpmswEnter(), rpmswExit(), rpmteA(), rpmteAddedKey(), rpmteColor(), rpmteDBOffset(), rpmteE(), rpmteFd(), rpmteKey(), rpmteN(), rpmteNEVR(), rpmteO(), rpmteR(), rpmteType(), rpmteV(), RPMTRANS_FLAG_BUILD_PROBS, RPMTRANS_FLAG_DIRSTASH, RPMTRANS_FLAG_JUSTDB, RPMTRANS_FLAG_NOSCRIPTS, RPMTRANS_FLAG_NOTRIGGERS, RPMTRANS_FLAG_REPACKAGE, RPMTRANS_FLAG_TEST, RPMTRANS_TYPE_AUTOROLLBACK, RPMTRANS_TYPE_ROLLBACK, RPMTS_OP_ERASE, RPMTS_OP_FINGERPRINT, RPMTS_OP_INSTALL, RPMTS_OP_REPACKAGE, rpmtsCheckDSIProblems(), rpmtsChrootDone(), rpmtsColor(), rpmtsCurrDir(), rpmtsFilterFlags(), rpmtsFlags(), rpmtsGetRdb(), rpmtsiFi(), rpmtsiFree(), rpmtsiInit(), rpmtsiNext(), rpmtsInitDSI(), rpmtsInitIterator(), rpmtsiOc(), rpmtsNElements(), rpmtsOp(), rpmtsOpenDB(), rpmtsProblems(), rpmtsRollback(), rpmtsRootDir(), rpmtsSetChrootDone(), rpmtsSetCurrDir(), rpmtsSetFlags(), rpmtsSetRelocateElement(), rpmtsSetTid(), rpmtsSetVSFlags(), rpmtsType(), rpmtsUnorderedSuccessors(), rpmtsVSFlags(), RPMVSF_NEEDPAYLOAD, rpmpsm_s::scriptTag, sharedCmp(), skipFiles(), rpmpsm_s::stepName, TR_ADDED, TR_REMOVED, rpmpsm_s::unorderedSuccessor, xcalloc(), XFA_SKIPPING, and xmalloc().

Referenced by rpmErase(), rpmInstall(), rpmrbRun(), and rpmts_Run().

FD_t rpmtsScriptFd ( rpmts  ts)

Get transaction script file handle, i.e.

stdout/stderr on scriptlet execution

Parameters:
tstransaction set
Returns:
transaction script file handle

Definition at line 961 of file rpmts.c.

Referenced by runScript().

int rpmtsSELinuxEnabled ( rpmts  ts)

Get selinuxEnabled flag, i.e.

is SE linux enabled?

Parameters:
tstransaction set
Returns:
selinuxEnabled flag

Definition at line 987 of file rpmts.c.

Referenced by fsmMapFContext(), fsmMkdirs(), and runScript().

int rpmtsSetChrootDone ( rpmts  ts,
int  chrootDone 
)

Set chrootDone flag, i.e.

has chroot(2) been performed?

Parameters:
tstransaction set
chrootDonenew chrootDone flag
Returns:
previous chrootDone flag

Definition at line 997 of file rpmts.c.

Referenced by rpmpsmStage(), and rpmtsRun().

void rpmtsSetCurrDir ( rpmts  ts,
const char *  currDir 
)

Set transaction currDir, i.e.

current directory before chroot(2).

Parameters:
tstransaction set
currDirnew transaction currDir (or NULL)

Definition at line 952 of file rpmts.c.

References _free(), and xstrdup().

Referenced by rpmtsRun().

rpmdepFlags rpmtsSetDFlags ( rpmts  ts,
rpmdepFlags  depFlags 
)

Set dependency flags, i.e.

bits that control rpmtsCheck() and rpmtsOrder().

Parameters:
tstransaction set
depFlagsnew dependency flags
Returns:
previous dependency flags

Definition at line 1399 of file rpmts.c.

Referenced by rpmcliQuery(), rpmcliVerify(), rpmErase(), rpmgiNext(), rpmInstall(), rpmRollback(), and rpmts_SetDFlags().

rpmtransFlags rpmtsSetFlags ( rpmts  ts,
rpmtransFlags  transFlags 
)

Set transaction flags, i.e.

bits that control rpmtsRun().

Parameters:
tstransaction set
transFlagsnew transaction flags
Returns:
previous transaction flags

Definition at line 1384 of file rpmts.c.

Referenced by rpmcliQuery(), rpmcliVerify(), rpmErase(), rpmInstall(), rpmRollback(), rpmts_Rollback(), rpmts_SetFlags(), rpmtsRollback(), and rpmtsRun().

int rpmtsSetNotifyCallback ( rpmts  ts,
rpmCallbackFunction  notify,
rpmCallbackData  notifyData 
)

Set transaction notify callback function and argument.

Warning:
This call must be made before rpmtsRun() for install/upgrade/freshen to function correctly.
Parameters:
tstransaction set
notifyprogress callback
notifyDataprogress callback private data
Returns:
0 on success

Definition at line 1472 of file rpmts.c.

Referenced by rpmErase(), rpmInstall(), rpmRollback(), and rpmts_Run().

int rpmtsSetREContext ( rpmts  ts,
rpmsx  sx 
)

Get file security context patterns.

Parameters:
tstransaction set
sxsecurity context patterns
Returns:
0 on success

Definition at line 1014 of file rpmts.c.

References rpmsxFree(), and rpmsxLink().

rpmte rpmtsSetRelocateElement ( rpmts  ts,
rpmte  relocateElement 
)

Set current relocate transaction element.

Parameters:
tstransaction set
relocateElementnew relocate transaction element
Returns:
previous relocate transaction element

Definition at line 1432 of file rpmts.c.

Referenced by addTE(), and rpmtsRun().

void rpmtsSetRootDir ( rpmts  ts,
const char *  rootDir 
)

Set transaction rootDir, i.e.

path to chroot(2).

Parameters:
tstransaction set
rootDirnew transaction rootDir (or NULL)

Definition at line 915 of file rpmts.c.

References _free(), alloca(), stpcpy(), and xstrdup().

Referenced by main(), rpmts_Create(), and rpmts_init().

void rpmtsSetScriptFd ( rpmts  ts,
FD_t  scriptFd 
)

Set transaction script file handle, i.e.

stdout/stderr on scriptlet execution

Parameters:
tstransaction set
scriptFdnew script file handle (or NULL)

Definition at line 972 of file rpmts.c.

References fdFree(), and fdLink().

Referenced by rpmts_setattro(), and rpmVerifyScript().

int rpmtsSetSig ( rpmts  ts,
int_32  sigtag,
int_32  sigtype,
const void *  sig,
int_32  siglen 
)

Set signature tag info, i.e.

from header.

Parameters:
tstransaction set
sigtagsignature tag
sigtypesignature tag type
sigsignature tag data
siglensignature tag data length
Returns:
0 always

Definition at line 1077 of file rpmts.c.

References headerFreeData().

Referenced by headerCheck(), rpmReadPackageFile(), and rpmVerifySignatures().

Spec rpmtsSetSpec ( rpmts  ts,
Spec  spec 
)

Set a spec control structure in transaction set.

Parameters:
tstransaction set
specnew spec control structure
Returns:
previous spec control structure

Definition at line 1416 of file rpmts.c.

Referenced by _specQuery(), and parseSpec().

int_32 rpmtsSetTid ( rpmts  ts,
int_32  tid 
)

Set transaction id, i.e.

transaction time stamp.

Parameters:
tstransaction set
tidnew transaction id
Returns:
previous transaction id

Definition at line 1035 of file rpmts.c.

Referenced by rpmtsRun().

rpmVSFlags rpmtsSetVSFlags ( rpmts  ts,
rpmVSFlags  vsflags 
)

Set verify signatures flag(s).

Parameters:
tstransaction set
vsflagsnew verify signatures flags
Returns:
previous value

Definition at line 832 of file rpmts.c.

Referenced by main(), rpmcliQuery(), rpmcliVerify(), rpmErase(), rpmInstall(), rpmInstallSource(), rpmRollback(), rpmts_Create(), rpmts_init(), rpmts_SetVSFlags(), rpmtsRollback(), and rpmtsRun().

const void* rpmtsSig ( const rpmts  ts)

Get signature tag data, i.e.

from header.

Parameters:
tstransaction set
Returns:
signature tag data

Definition at line 1061 of file rpmts.c.

Referenced by rpmtsFindPubkey(), rpmtsStashKeyid(), rpmVerifySignature(), verifyDSASignature(), verifyMD5Signature(), verifyRSASignature(), verifySHA1Signature(), and verifySizeSignature().

int_32 rpmtsSiglen ( const rpmts  ts)

Get signature tag data length, i.e.

no. of bytes of data.

Parameters:
tstransaction set
Returns:
signature tag data length

Definition at line 1069 of file rpmts.c.

Referenced by rpmVerifySignature(), verifyDSASignature(), verifyMD5Signature(), verifyRSASignature(), and verifySHA1Signature().

pgpDigParams rpmtsSignature ( const rpmts  ts)

Get OpenPGP signature constants.

Parameters:
tstransaction set
Returns:
signature constants.

Definition at line 1104 of file rpmts.c.

References rpmtsDig(), and pgpDig_s::signature.

Referenced by rpmtsFindPubkey(), rpmtsStashKeyid(), rpmVerifySignatures(), verifyDSASignature(), and verifyRSASignature().

int_32 rpmtsSigtag ( const rpmts  ts)

Get signature tag.

Parameters:
tstransaction set
Returns:
signature tag

Definition at line 1045 of file rpmts.c.

Referenced by rpmVerifySignature(), verifyDSASignature(), and verifyRSASignature().

int_32 rpmtsSigtype ( const rpmts  ts)

Get signature tag type.

Parameters:
tstransaction set
Returns:
signature tag type

Definition at line 1053 of file rpmts.c.

Spec rpmtsSpec ( rpmts  ts)

Get spec control structure from transaction set.

Parameters:
tstransaction set
Returns:
spec control structure

Definition at line 1409 of file rpmts.c.

Referenced by spec_Parse().

rpmts rpmtsUnlink ( rpmts  ts,
const char *  msg 
)

Unreference a transaction instance.

Parameters:
tstransaction set
msg
Returns:
NULL always

Referenced by rpmtsFree().

int rpmtsUnorderedSuccessors ( rpmts  ts,
int  first 
)

Set index of 1st element of successors.

Parameters:
tstransaction set
firstnew index of 1st element of successors
Returns:
previous value

Definition at line 879 of file rpmts.c.

Referenced by rpmtsOrder(), and rpmtsRun().

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.

Parameters:
tstransaction set
devmount point device
fileSizefile size
prevSizeprevious file size (if upgrading)
fixupSizesize difference (if
actionfile disposition

Definition at line 1244 of file rpmts.c.

References FA_ALTNAME, FA_BACKUP, FA_CREATE, FA_ERASE, and FA_SAVE.

Referenced by handleOverlappedFiles().

int rpmtsVerifyDB ( rpmts  ts)

Verify the database used by the transaction.

Parameters:
tstransaction set
Returns:
0 on success

Definition at line 155 of file rpmts.c.

References rpmdbVerify().

Referenced by main(), and rpmts_VerifyDB().

rpmVSFlags rpmtsVSFlags ( rpmts  ts)

Get verify signatures flag(s).

Parameters:
tstransaction set
Returns:
verify signatures flags

Definition at line 824 of file rpmts.c.

Referenced by headerCheck(), rpmInstallSource(), rpmpsmStage(), rpmReadPackageFile(), and rpmtsRun().