rpm  5.4.10
Files | Typedefs | Enumerations | Functions
RPM Transaction Element API (RPMTE)
Collaboration diagram for RPM Transaction Element API (RPMTE):

Files

file  rpmlib.h
 In Memoriam: Steve Taylor stayl.nosp@m.or@r.nosp@m.edhat.nosp@m..com was here, now he's not.
file  rpmte.h
 Structures used for an "rpmte" transaction element.

Typedefs

typedef struct tsortInfo_s * tsortInfo
 Transaction element ordering chain linkage.
typedef struct rpmtsi_s * rpmtsi
 Transaction element iterator.
typedef enum rpmElementType_e rpmElementType
 Transaction element type.
typedef struct rpmte_s * rpmte
 An element of a transaction set, i.e.

Enumerations

enum  rpmElementType_e { TR_ADDED = (1 << 0), TR_REMOVED = (1 << 1) }
 Transaction element type. More...

Functions

rpmte rpmteFree (rpmte te)
 Destroy a transaction element.
rpmte rpmteNew (const rpmts ts, Header h, rpmElementType type, fnpyKey key, rpmRelocation relocs, uint32_t dboffset, alKey pkgKey)
 Create a transaction element.
Header rpmteHeader (rpmte te)
 Retrieve header from transaction element.
Header rpmteSetHeader (rpmte te, Header h)
 Save header into transaction element.
rpmElementType rpmteType (rpmte te)
 Retrieve type of transaction element.
const char * rpmteN (rpmte te)
 Retrieve name string of transaction element.
const char * rpmteE (rpmte te)
 Retrieve epoch string of transaction element.
const char * rpmteV (rpmte te)
 Retrieve version string of transaction element.
const char * rpmteR (rpmte te)
 Retrieve release string of transaction element.
const char * rpmteD (rpmte te)
 Retrieve distepoch string of transaction element.
const char * rpmteA (rpmte te)
 Retrieve arch string of transaction element.
const char * rpmteO (rpmte te)
 Retrieve os string of transaction element.
int rpmteIsSource (rpmte te)
 Retrieve isSource attribute of transaction element.
rpmuint32_t rpmteColor (rpmte te)
 Retrieve color bits of transaction element.
rpmuint32_t rpmteSetColor (rpmte te, rpmuint32_t color)
 Set color bits of transaction element.
uint32_t rpmteDBInstance (rpmte te)
 Retrieve last instance installed to the database.
void rpmteSetDBInstance (rpmte te, unsigned int instance)
 Set last instance installed to the database.
rpmuint32_t rpmtePkgFileSize (rpmte te)
 Retrieve size in bytes of package file.
rpmuint32_trpmteOriginTid (rpmte te)
 Retrieve transaction start time that package was first installed.
rpmuint32_trpmteOriginTime (rpmte te)
 Retrieve time that package was first installed.
int rpmteDepth (rpmte te)
 Retrieve dependency tree depth of transaction element.
int rpmteSetDepth (rpmte te, int ndepth)
 Set dependency tree depth of transaction element.
int rpmteBreadth (rpmte te)
 Retrieve dependency tree breadth of transaction element.
int rpmteSetBreadth (rpmte te, int nbreadth)
 Set dependency tree breadth of transaction element.
int rpmteNpreds (rpmte te)
 Retrieve tsort no.
int rpmteSetNpreds (rpmte te, int npreds)
 Set tsort no.
int rpmteTree (rpmte te)
 Retrieve tree index of transaction element.
int rpmteSetTree (rpmte te, int ntree)
 Set tree index of transaction element.
rpmte rpmteParent (rpmte te)
 Retrieve parent transaction element.
rpmte rpmteSetParent (rpmte te, rpmte pte)
 Set parent transaction element.
int rpmteDegree (rpmte te)
 Retrieve number of children of transaction element.
int rpmteSetDegree (rpmte te, int ndegree)
 Set number of children of transaction element.
tsortInfo rpmteTSI (rpmte te)
 Retrieve tsort info for transaction element.
void rpmteFreeTSI (rpmte te)
 Destroy tsort info of transaction element.
void rpmteNewTSI (rpmte te)
 Initialize tsort info of transaction element.
void rpmteCleanDS (rpmte te)
 Destroy dependency set info of transaction element.
int rpmteDBOffset (rpmte te)
 Retrieve rpmdb instance of TR_REMOVED transaction element.
const char * rpmteNEVR (rpmte te)
 Retrieve name-version-release string from transaction element.
const char * rpmteNEVRA (rpmte te)
 Retrieve name-version-release.arch string from transaction element.
const char * rpmtePkgid (rpmte te)
 Retrieve pkgid string from transaction element.
const char * rpmteHdrid (rpmte te)
 Retrieve hdrid string from transaction element.
const char * rpmteSourcerpm (rpmte te)
 Retrieve sourcerpm string from transaction element.
FD_t rpmteFd (rpmte te)
 Retrieve file handle from transaction element.
fnpyKey rpmteKey (rpmte te)
 Retrieve key from transaction element.
rpmds rpmteDS (rpmte te, rpmTag tag)
 Retrieve dependency tag set from transaction element.
rpmfi rpmteFI (rpmte te, rpmTag tag)
 Retrieve file info tag set from transaction element.
void rpmteColorDS (rpmte te, rpmTag tag)
 Calculate transaction element dependency colors/refs from file info.
int rpmteChain (rpmte p, rpmte q, Header oh, const char *msg)
 Chain p <-> q forward/backward transaction element links.
int rpmtsiOc (rpmtsi tsi)
 Return transaction element index.
rpmtsi rpmtsiFree (rpmtsi tsi)
 Destroy transaction element iterator.
rpmtsi rpmtsiInit (rpmts ts)
 Create transaction element iterator.
rpmtsi XrpmtsiInit (rpmts ts, const char *fn, unsigned int ln)
 Create transaction element iterator.
rpmte rpmtsiNext (rpmtsi tsi, rpmElementType type)
 Return next transaction element of type.

Detailed Description

Typedef Documentation

Transaction element type.

typedef struct rpmte_s* rpmte

An element of a transaction set, i.e.

a TR_ADDED or TR_REMOVED package.

Definition at line 38 of file rpmtypes.h.

typedef struct rpmtsi_s* rpmtsi

Transaction element iterator.

Definition at line 25 of file rpmte.h.

typedef struct tsortInfo_s* tsortInfo

Transaction element ordering chain linkage.

Definition at line 20 of file rpmte.h.

Enumeration Type Documentation

Transaction element type.

Enumerator:
TR_ADDED 

Package will be installed.

TR_REMOVED 

Package will be removed.

Definition at line 30 of file rpmte.h.

Function Documentation

const char* rpmteA ( rpmte  te)

Retrieve arch string of transaction element.

Parameters
tetransaction element
Returns
arch string

Definition at line 345 of file rpmte.c.

Referenced by _rpmtsCheck(), rpmpsmStage(), rpmte_A(), rpmte_print(), rpmtsAddInstallElement(), rpmtsProcess(), and rpmtsSanityCheck().

int rpmteBreadth ( rpmte  te)

Retrieve dependency tree breadth of transaction element.

Parameters
tetransaction element
Returns
breadth

Definition at line 405 of file rpmte.c.

Referenced by rpmte_Breadth().

int rpmteChain ( rpmte  p,
rpmte  q,
Header  oh,
const char *  msg 
)

Chain p <-> q forward/backward transaction element links.

Parameters
pinstalled element (needs backward link)
qerased element (needs forward link)
oherased element header
msgoperation identifier for debugging (NULL uses "")
Returns
0 on success

Definition at line 682 of file rpmte.c.

References _free(), alloca(), argvAdd(), _HE_s::c, headerGet(), _HE_s::p, rpmDataType_u::ptr, RPMTAG_HDRID, RPMTAG_NVRA, RPMTAG_PKGID, rpmDataType_u::str, _HE_s::tag, rpmDataType_u::ui8p, and xmalloc.

Referenced by findErases(), rpmtsAddObsoletes(), rpmtsAddUpgrades(), and rpmtsEraseDebuginfo().

void rpmteCleanDS ( rpmte  te)

Destroy dependency set info of transaction element.

Parameters
tetransaction element

Definition at line 38 of file rpmte.c.

References rpmdsFreePRCO().

Referenced by delTE(), and rpmtsClean().

rpmuint32_t rpmteColor ( rpmte  te)

Retrieve color bits of transaction element.

Parameters
tetransaction element
Returns
color bits

Definition at line 360 of file rpmte.c.

Referenced by _rpmtsCheck(), populateInstallHeader(), rpmte_Color(), and rpmtsProcess().

void rpmteColorDS ( rpmte  te,
rpmTag  tag 
)

Calculate transaction element dependency colors/refs from file info.

Parameters
tetransaction element
tagdependency tag (RPMTAG_PROVIDENAME, RPMTAG_REQUIRENAME)

Definition at line 613 of file rpmte.c.

References alloca(), rpmdsCount(), rpmdsInit(), rpmdsNext(), rpmdsSetColor(), rpmdsSetRefs(), rpmfiFC(), rpmfiFColor(), rpmfiFDepends(), rpmfiInit(), rpmfiNext(), RPMTAG_BASENAMES, RPMTAG_PROVIDENAME, RPMTAG_REQUIRENAME, rpmteDS(), and rpmteFI().

Referenced by addTE().

const char* rpmteD ( rpmte  te)

Retrieve distepoch string of transaction element.

Parameters
tetransaction element
Returns
distepoch string

Definition at line 336 of file rpmte.c.

Referenced by ensureOlder(), rpmpsmStage(), and rpmtsSanityCheck().

uint32_t rpmteDBInstance ( rpmte  te)

Retrieve last instance installed to the database.

Parameters
tetransaction element
Returns
last install instance.

Definition at line 279 of file rpmte.c.

Referenced by rpmteOpen().

int rpmteDBOffset ( rpmte  te)

Retrieve rpmdb instance of TR_REMOVED transaction element.

Parameters
tetransaction element
Returns
rpmdb instance

Definition at line 531 of file rpmte.c.

Referenced by rpmte_DBOffset(), and rpmtsPrepare().

int rpmteDegree ( rpmte  te)

Retrieve number of children of transaction element.

Parameters
tetransaction element
Returns
tree index

Definition at line 467 of file rpmte.c.

Referenced by rpmte_Degree().

int rpmteDepth ( rpmte  te)

Retrieve dependency tree depth of transaction element.

Parameters
tetransaction element
Returns
depth

Definition at line 390 of file rpmte.c.

Referenced by rpmte_Depth().

rpmds rpmteDS ( rpmte  te,
rpmTag  tag 
)

Retrieve dependency tag set from transaction element.

Parameters
tetransaction element
tagdependency tag
Returns
dependency tag set

Definition at line 573 of file rpmte.c.

References rpmdsFromPRCO().

Referenced by _rpmtsCheck(), rpmte_DS(), rpmteColorDS(), rpmtsAddInstallElement(), and rpmtsAddObsoletes().

const char* rpmteE ( rpmte  te)

Retrieve epoch string of transaction element.

Parameters
tetransaction element
Returns
epoch string

Definition at line 321 of file rpmte.c.

Referenced by ensureOlder(), rpmpsmStage(), rpmte_E(), and rpmtsSanityCheck().

FD_t rpmteFd ( rpmte  te)

Retrieve file handle from transaction element.

Parameters
tetransaction element
Returns
file handle

Definition at line 561 of file rpmte.c.

Referenced by rpmpsmStage(), rpmteFDHeader(), and rpmtsProcess().

rpmfi rpmteFI ( rpmte  te,
rpmTag  tag 
)

Retrieve file info tag set from transaction element.

Parameters
tetransaction element
tagfile info tag (RPMTAG_BASENAMES)
Returns
file info tag set

Definition at line 587 of file rpmte.c.

References RPMTAG_BASENAMES.

Referenced by _rpmtsCheck(), handleOverlappedFiles(), removePackage(), rpmInstallSourcePackage(), rpmte_FI(), rpmteColorDS(), rpmtsAddFingerprints(), rpmtsAddInstallElement(), rpmtsCheckDSIProblems(), rpmtsCheckInstalledFiles(), rpmtsFindBaseNamesInDB(), and rpmtsPrepare().

rpmte rpmteFree ( rpmte  te)

Destroy a transaction element.

Parameters
tetransaction element
Returns
NULL on last dereference

Referenced by rpmpsmFini(), rpmte_free(), rpmtsAddInstallElement(), and rpmtsEmpty().

void rpmteFreeTSI ( rpmte  te)

Destroy tsort info of transaction element.

Parameters
tetransaction element

Definition at line 489 of file rpmte.c.

References _free(), and rpmteTSI().

Referenced by rpmteNewTSI().

const char* rpmteHdrid ( rpmte  te)

Retrieve hdrid string from transaction element.

Parameters
tetransaction element
Returns
hdrid string

Definition at line 551 of file rpmte.c.

Referenced by rpmpsmStage(), and rpmte_Hdrid().

Header rpmteHeader ( rpmte  te)

Retrieve header from transaction element.

Parameters
tetransaction element
Returns
header

Definition at line 291 of file rpmte.c.

References headerLink().

Referenced by rpmgiNext().

int rpmteIsSource ( rpmte  te)

Retrieve isSource attribute of transaction element.

Parameters
tetransaction element
Returns
isSource attribute

Definition at line 355 of file rpmte.c.

Referenced by rpmtsAddInstallElement(), and rpmtsProcess().

fnpyKey rpmteKey ( rpmte  te)

Retrieve key from transaction element.

Parameters
tetransaction element
Returns
key

Definition at line 568 of file rpmte.c.

Referenced by ensureOlder(), handleInstInstalledFile(), handleOverlappedFiles(), relocateFileList(), rpmte_Key(), rpmtsAddInstallElement(), rpmtsCheckDSIProblems(), rpmtsNotify(), and rpmtsSanityCheck().

const char* rpmteN ( rpmte  te)

Retrieve name string of transaction element.

Parameters
tetransaction element
Returns
name string

Definition at line 316 of file rpmte.c.

Referenced by ensureOlder(), rpmpsmStage(), rpmte_N(), rpmtsAddInstallElement(), rpmtsAddObsoletes(), rpmtsAddUpgrades(), rpmtsSanityCheck(), and runTriggers().

const char* rpmteNEVR ( rpmte  te)

Retrieve name-version-release string from transaction element.

Parameters
tetransaction element
Returns
name-version-release string

Definition at line 536 of file rpmte.c.

Referenced by _rpmtsCheck(), ensureOlder(), handleOverlappedFiles(), relocateFileList(), rpmpsmStage(), rpmte_NEVR(), rpmte_print(), rpmteFDHeader(), rpmtsCheckDSIProblems(), rpmtsProcess(), and rpmtsSanityCheck().

const char* rpmteNEVRA ( rpmte  te)

Retrieve name-version-release.arch string from transaction element.

Parameters
tetransaction element
Returns
name-version-release.arch string

Definition at line 541 of file rpmte.c.

Referenced by _rpmtsCheck(), handleInstInstalledFile(), rpmte_NEVRA(), rpmtsAddObsoletes(), rpmtsAddUpgrades(), rpmtsEraseDebuginfo(), rpmtsProcess(), rpmtsRollback(), and rpmtsSanityCheck().

rpmte rpmteNew ( const rpmts  ts,
Header  h,
rpmElementType  type,
fnpyKey  key,
rpmRelocation  relocs,
uint32_t  dboffset,
alKey  pkgKey 
)

Create a transaction element.

Parameters
tstransaction set
hheader
typeTR_ADDED/TR_REMOVED
key(TR_ADDED) package retrieval key (e.g. file name)
relocs(TR_ADDED) package file relocations
dboffset(TR_REMOVED) rpmdb instance
pkgKeyassociated added package (if any)
Returns
new transaction element

Definition at line 245 of file rpmte.c.

References _free(), addTE(), alloca(), headerGet(), _HE_s::p, rpmDataType_u::ptr, RPMTAG_SIGSIZE, rpmteGetPool(), _HE_s::tag, TR_ADDED, TR_REMOVED, and rpmDataType_u::ui32p.

Referenced by removePackage(), and rpmtsAddInstallElement().

void rpmteNewTSI ( rpmte  te)

Initialize tsort info of transaction element.

Parameters
tetransaction element

Definition at line 507 of file rpmte.c.

References rpmteFreeTSI(), and xcalloc().

int rpmteNpreds ( rpmte  te)

Retrieve tsort no.

of predecessors of transaction element.

Parameters
tetransaction element
Returns
no. of predecessors

Definition at line 420 of file rpmte.c.

Referenced by rpmte_Npreds().

const char* rpmteO ( rpmte  te)

Retrieve os string of transaction element.

Parameters
tetransaction element
Returns
os string

Definition at line 350 of file rpmte.c.

Referenced by _rpmtsCheck(), rpmpsmStage(), rpmte_O(), rpmtsAddInstallElement(), rpmtsProcess(), and rpmtsSanityCheck().

rpmuint32_t* rpmteOriginTid ( rpmte  te)

Retrieve transaction start time that package was first installed.

Parameters
tetransaction element
Returns
origin time

Definition at line 380 of file rpmte.c.

Referenced by populateInstallHeader().

rpmuint32_t* rpmteOriginTime ( rpmte  te)

Retrieve time that package was first installed.

Parameters
tetransaction element
Returns
origin time

Definition at line 385 of file rpmte.c.

Referenced by populateInstallHeader().

rpmte rpmteParent ( rpmte  te)

Retrieve parent transaction element.

Parameters
tetransaction element
Returns
parent transaction element

Definition at line 450 of file rpmte.c.

Referenced by rpmte_Parent().

rpmuint32_t rpmtePkgFileSize ( rpmte  te)

Retrieve size in bytes of package file.

Todo:
Signature header is estimated at 256b.
Parameters
tetransaction element
Returns
size in bytes of package file.

Definition at line 375 of file rpmte.c.

Referenced by rpmte_PkgFileSize().

const char* rpmtePkgid ( rpmte  te)

Retrieve pkgid string from transaction element.

Parameters
tetransaction element
Returns
pkgid string

Definition at line 546 of file rpmte.c.

Referenced by rpmte_Pkgid().

const char* rpmteR ( rpmte  te)

Retrieve release string of transaction element.

Parameters
tetransaction element
Returns
release string

Definition at line 331 of file rpmte.c.

Referenced by ensureOlder(), rpmpsmStage(), and rpmte_R().

int rpmteSetBreadth ( rpmte  te,
int  nbreadth 
)

Set dependency tree breadth of transaction element.

Parameters
tetransaction element
nbreadthnew breadth
Returns
previous breadth

Definition at line 410 of file rpmte.c.

rpmuint32_t rpmteSetColor ( rpmte  te,
rpmuint32_t  color 
)

Set color bits of transaction element.

Parameters
tetransaction element
colornew color bits
Returns
previous color bits

Definition at line 365 of file rpmte.c.

void rpmteSetDBInstance ( rpmte  te,
unsigned int  instance 
)

Set last instance installed to the database.

Parameters
tetransaction element
instanceDatabase instance of last install element.
Returns
last install instance.

Definition at line 285 of file rpmte.c.

Referenced by rpmpsmStage().

int rpmteSetDegree ( rpmte  te,
int  ndegree 
)

Set number of children of transaction element.

Parameters
tetransaction element
ndegreenew number of children
Returns
previous number of children

Definition at line 472 of file rpmte.c.

int rpmteSetDepth ( rpmte  te,
int  ndepth 
)

Set dependency tree depth of transaction element.

Parameters
tetransaction element
ndepthnew depth
Returns
previous depth

Definition at line 395 of file rpmte.c.

Header rpmteSetHeader ( rpmte  te,
Header  h 
)

Save header into transaction element.

Parameters
tetransaction element
hheader
Returns
NULL always

Definition at line 298 of file rpmte.c.

References headerFree(), and headerLink().

Referenced by rpmInstallSourcePackage(), rpmpsmStage(), rpmteClose(), rpmteOpen(), and rpmtsAddInstallElement().

int rpmteSetNpreds ( rpmte  te,
int  npreds 
)

Set tsort no.

of predecessors of transaction element.

Parameters
tetransaction element
npredsnew no. of predecessors
Returns
previous no. of predecessors

Definition at line 425 of file rpmte.c.

rpmte rpmteSetParent ( rpmte  te,
rpmte  pte 
)

Set parent transaction element.

Parameters
tetransaction element
ptenew parent transaction element
Returns
previous parent transaction element

Definition at line 455 of file rpmte.c.

int rpmteSetTree ( rpmte  te,
int  ntree 
)

Set tree index of transaction element.

Parameters
tetransaction element
ntreenew tree index
Returns
previous tree index

Definition at line 440 of file rpmte.c.

const char* rpmteSourcerpm ( rpmte  te)

Retrieve sourcerpm string from transaction element.

Parameters
tetransaction element
Returns
sourcerpm string

Definition at line 556 of file rpmte.c.

Referenced by rpmtsEraseDebuginfo().

int rpmteTree ( rpmte  te)

Retrieve tree index of transaction element.

Parameters
tetransaction element
Returns
tree index

Definition at line 435 of file rpmte.c.

Referenced by rpmte_Tree().

tsortInfo rpmteTSI ( rpmte  te)

Retrieve tsort info for transaction element.

Parameters
tetransaction element
Returns
tsort info

Definition at line 482 of file rpmte.c.

Referenced by rpmteFreeTSI().

rpmElementType rpmteType ( rpmte  te)
const char* rpmteV ( rpmte  te)

Retrieve version string of transaction element.

Parameters
tetransaction element
Returns
version string

Definition at line 326 of file rpmte.c.

Referenced by ensureOlder(), rpmpsmStage(), and rpmte_V().

rpmtsi rpmtsiFree ( rpmtsi  tsi)
rpmtsi rpmtsiInit ( rpmts  ts)
rpmte rpmtsiNext ( rpmtsi  tsi,
rpmElementType  type 
)

Return next transaction element of type.

Parameters
tsitransaction element iterator
typetransaction element type selector (0 for any)
Returns
next transaction element of type, NULL on termination

Definition at line 831 of file rpmte.c.

References rpmtsiNextElement().

Referenced by _rpmtsCheck(), rpmgiNext(), rpmts_iternext(), rpmtsAddFingerprints(), rpmtsAddInstallElement(), rpmtsClean(), rpmtsEmpty(), rpmtsFindBaseNamesInDB(), rpmtsMarkLinkedFailed(), rpmtsPrepare(), rpmtsProcess(), rpmtsRepackage(), rpmtsRollback(), rpmtsRunScript(), rpmtsSanityCheck(), and rpmtsSetup().

int rpmtsiOc ( rpmtsi  tsi)

Return transaction element index.

Parameters
tsitransaction element iterator
Returns
transaction element index

Definition at line 755 of file rpmte.c.

Referenced by rpmtsFindBaseNamesInDB(), and rpmtsProcess().

rpmtsi XrpmtsiInit ( rpmts  ts,
const char *  fn,
unsigned int  ln 
)

Create transaction element iterator.

Parameters
tstransaction set
fn
ln
Returns
transaction element iterator

Definition at line 791 of file rpmte.c.

References rpmioLinkPoolItem(), rpmtsiGetPool(), rpmtsLink(), and rpmtsNElements().