rpm 4.19.92
The RPM Package Manager
Loading...
Searching...
No Matches
Files | Typedefs | Enumerations | Functions
Transaction Set API.

How to create, run & destroy a package transaction. More...

Collaboration diagram for Transaction Set API.:

Files

file  rpmte.h
 
file  rpmts.h
 

Typedefs

typedef void *(* rpmCallbackFunction) (const void *h, const rpmCallbackType what, const rpm_loff_t amount, const rpm_loff_t total, fnpyKey key, rpmCallbackData data)
 
typedef enum rpmtsOpX_e rpmtsOpX
 
typedef int(* rpmtsChangeFunction) (int event, rpmte te, rpmte other, void *data)
 

Enumerations

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_NOPLUGINS = (1 << 7) , RPMTRANS_FLAG_NOCONTEXTS = (1 << 8) , RPMTRANS_FLAG_NOCAPS = (1 << 9) , RPMTRANS_FLAG_NODB = (1 << 10) ,
  RPMTRANS_FLAG_NOPREUNTRANS = (1 << 14) , RPMTRANS_FLAG_NOPOSTUNTRANS = (1 << 15) , 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_NOPRETRANS = (1 << 24) , RPMTRANS_FLAG_NOPOSTTRANS = (1 << 25) ,
  RPMTRANS_FLAG_NOSYSUSERS = (1 << 26) , RPMTRANS_FLAG_NOMD5 = (1 << 27) , RPMTRANS_FLAG_NOFILEDIGEST = (1 << 27) , RPMTRANS_FLAG_NOARTIFACTS = (1 << 29) ,
  RPMTRANS_FLAG_NOCONFIGS = (1 << 30) , RPMTRANS_FLAG_DEPLOOPS = (1 << 31)
}
 
enum  rpmVSFlags_e {
  RPMVSF_DEFAULT = 0 , RPMVSF_NOHDRCHK = (1 << 0) , RPMVSF_NEEDPAYLOAD = (1 << 1) , RPMVSF_NOSHA1HEADER = (1 << 8) ,
  RPMVSF_NOSHA256HEADER = (1 << 9) , RPMVSF_NODSAHEADER = (1 << 10) , RPMVSF_NORSAHEADER = (1 << 11) , RPMVSF_NOPAYLOAD = (1 << 16) ,
  RPMVSF_NOMD5 = (1 << 17) , RPMVSF_NODSA = (1 << 18) , RPMVSF_NORSA = (1 << 19)
}
 
enum  rpmtsOpX_e {
  RPMTS_OP_TOTAL = 0 , RPMTS_OP_CHECK = 1 , RPMTS_OP_ORDER = 2 , RPMTS_OP_FINGERPRINT = 3 ,
  RPMTS_OP_INSTALL = 5 , RPMTS_OP_ERASE = 6 , RPMTS_OP_SCRIPTLETS = 7 , RPMTS_OP_COMPRESS = 8 ,
  RPMTS_OP_UNCOMPRESS = 9 , RPMTS_OP_DIGEST = 10 , RPMTS_OP_SIGNATURE = 11 , RPMTS_OP_DBADD = 12 ,
  RPMTS_OP_DBREMOVE = 13 , RPMTS_OP_DBGET = 14 , RPMTS_OP_DBPUT = 15 , RPMTS_OP_DBDEL = 16 ,
  RPMTS_OP_VERIFY = 17 , RPMTS_OP_MAX = 18
}
 

Functions

int rpmtsCheck (rpmts ts)
 
int rpmtsOrder (rpmts ts)
 
int rpmtsRun (rpmts ts, rpmps okProbs, rpmprobFilterFlags ignoreSet)
 
rpmts rpmtsLink (rpmts ts)
 
int rpmtsCloseDB (rpmts ts)
 
int rpmtsOpenDB (rpmts ts, int dbmode)
 
int rpmtsInitDB (rpmts ts, int perms)
 
int rpmtsGetDBMode (rpmts ts)
 
int rpmtsSetDBMode (rpmts ts, int dbmode)
 
int rpmtsRebuildDB (rpmts ts)
 
int rpmtsVerifyDB (rpmts ts)
 
rpmdbMatchIterator rpmtsInitIterator (const rpmts ts, rpmDbiTagVal rpmtag, const void *keyp, size_t keylen)
 
rpmRC rpmtsImportHeader (rpmtxn txn, Header h, rpmFlags flags)
 
rpmRC rpmtsImportPubkey (rpmts ts, const unsigned char *pkt, size_t pktlen)
 
rpmKeyring rpmtsGetKeyring (rpmts ts, int autoload)
 
int rpmtsSetKeyring (rpmts ts, rpmKeyring keyring)
 
int rpmtsSetSolveCallback (rpmts ts, int(*solve)(rpmts ts, rpmds ds, const void *data), const void *solveData)
 
rpmps rpmtsProblems (rpmts ts)
 
void rpmtsCleanProblems (rpmts ts)
 
void rpmtsClean (rpmts ts)
 
void rpmtsEmpty (rpmts ts)
 
rpmts rpmtsFree (rpmts ts)
 
rpmVSFlags rpmtsVSFlags (rpmts ts)
 
rpmVSFlags rpmtsSetVSFlags (rpmts ts, rpmVSFlags vsflags)
 
rpmVSFlags rpmtsVfyFlags (rpmts ts)
 
rpmVSFlags rpmtsSetVfyFlags (rpmts ts, rpmVSFlags vfyflags)
 
int rpmtsVfyLevel (rpmts ts)
 
int rpmtsSetVfyLevel (rpmts ts, int vfylevel)
 
const char * rpmtsRootDir (rpmts ts)
 
int rpmtsSetRootDir (rpmts ts, const char *rootDir)
 
FD_t rpmtsScriptFd (rpmts ts)
 
void rpmtsSetScriptFd (rpmts ts, FD_t scriptFd)
 
rpm_tid_t rpmtsGetTid (rpmts ts)
 
rpm_tid_t rpmtsSetTid (rpmts ts, rpm_tid_t tid)
 
rpmdb rpmtsGetRdb (rpmts ts)
 
void * rpmtsNotify (rpmts ts, rpmte te, rpmCallbackType what, rpm_loff_t amount, rpm_loff_t total)
 
int rpmtsNElements (rpmts ts)
 
rpmte rpmtsElement (rpmts ts, int ix)
 
rpmprobFilterFlags rpmtsFilterFlags (rpmts ts)
 
rpmtransFlags rpmtsFlags (rpmts ts)
 
rpmtransFlags rpmtsSetFlags (rpmts ts, rpmtransFlags transFlags)
 
rpm_color_t rpmtsColor (rpmts ts)
 
rpm_color_t rpmtsPrefColor (rpmts ts)
 
rpm_color_t rpmtsSetColor (rpmts ts, rpm_color_t color)
 
rpm_color_t rpmtsSetPrefColor (rpmts ts, rpm_color_t color)
 
rpmop rpmtsOp (rpmts ts, rpmtsOpX opx)
 
rpmPlugins rpmtsPlugins (rpmts ts)
 
int rpmtsSetNotifyCallback (rpmts ts, rpmCallbackFunction notify, rpmCallbackData notifyData)
 
int rpmtsSetNotifyStyle (rpmts ts, int style)
 
int rpmtsGetNotifyStyle (rpmts ts)
 
int rpmtsSetChangeCallback (rpmts ts, rpmtsChangeFunction notify, void *data)
 
rpmts rpmtsCreate (void)
 
int rpmtsAddInstallElement (rpmts ts, Header h, const fnpyKey key, int upgrade, rpmRelocation *relocs)
 
int rpmtsAddReinstallElement (rpmts ts, Header h, const fnpyKey key)
 
int rpmtsAddRestoreElement (rpmts ts, Header h)
 
int rpmtsAddEraseElement (rpmts ts, Header h, int dboffset)
 
rpmtxn rpmtxnBegin (rpmts ts, rpmtxnFlags flags)
 
rpmtxn rpmtxnEnd (rpmtxn txn)
 

Detailed Description

How to create, run & destroy a package transaction.

Typedef Documentation

◆ rpmCallbackFunction

typedef void *(* rpmCallbackFunction) (const void *h, const rpmCallbackType what, const rpm_loff_t amount, const rpm_loff_t total, fnpyKey key, rpmCallbackData data)

Function pointer type for rpmtsSetNotifyCallback() triggered by rpmtsNotify()

Parameters
hrelated header or NULL
whatkind of notification (See RPMCALLBACK_ constants above)
amountnumber of bytes/packages already processed or tag of the scriptlet involved or 0 or some other number
totaltotal number of bytes/packages to be processed or return code of the scriptlet or 0
keyresult of rpmteKey() of related rpmte or 0
datauser data as passed to rpmtsSetNotifyCallback()

◆ rpmtsChangeFunction

typedef int(* rpmtsChangeFunction) (int event, rpmte te, rpmte other, void *data)

Transaction change callback type.

On explicit install/erase add events, "other" is NULL, on implicit add events (erasures due to obsolete/upgrade, replaced by newer) it points to the replacing package.

Parameters
eventChange event (see rpmtsEvent enum)
teTransaction element
otherRelated transaction element (or NULL)
dataApplication private data from rpmtsSetChangeCallback()

◆ rpmtsOpX

typedef enum rpmtsOpX_e rpmtsOpX

Indices for timestamps.

Enumeration Type Documentation

◆ rpmtransFlags_e

Bit(s) to control rpmtsRun() operation.

Enumerator
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_NOPLUGINS 

from –noplugins

RPMTRANS_FLAG_NOCONTEXTS 

from –nocontexts

RPMTRANS_FLAG_NOCAPS 

from –nocaps

RPMTRANS_FLAG_NODB 

from –nodb

RPMTRANS_FLAG_NOPREUNTRANS 

from –nopreuntrans

RPMTRANS_FLAG_NOPOSTUNTRANS 

from –nopostuntrans

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_NOPRETRANS 

from –nopretrans

RPMTRANS_FLAG_NOPOSTTRANS 

from –noposttrans

RPMTRANS_FLAG_NOSYSUSERS 

from –nosysusers

RPMTRANS_FLAG_NOMD5 

from –nomd5

RPMTRANS_FLAG_NOFILEDIGEST 

from –nofiledigest (alias to –nomd5)

RPMTRANS_FLAG_NOARTIFACTS 

from –noartifacts

RPMTRANS_FLAG_NOCONFIGS 

from –noconfigs

RPMTRANS_FLAG_DEPLOOPS 

from –deploops

◆ rpmtsOpX_e

enum rpmtsOpX_e

Indices for timestamps.

◆ rpmVSFlags_e

Bit(s) to control digest and signature verification.

Function Documentation

◆ rpmtsAddEraseElement()

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

Add package to be erased to transaction set.

Parameters
tstransaction set
hheader
dboffsetununsed
Returns
0 on success, 1 on error (not installed)

◆ rpmtsAddInstallElement()

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

◆ rpmtsAddReinstallElement()

int rpmtsAddReinstallElement ( rpmts  ts,
Header  h,
const fnpyKey  key 
)

Add package to be reinstalled to transaction set.

Parameters
tstransaction set
hheader
keypackage retrieval key (e.g. file name)
Returns
0 on success

◆ rpmtsAddRestoreElement()

int rpmtsAddRestoreElement ( rpmts  ts,
Header  h 
)

Add package to be restored to transaction set.

Parameters
tstransaction set
hheader
Returns
0 on success, 1 on error (not installed)

◆ rpmtsCheck()

int rpmtsCheck ( rpmts  ts)

Perform dependency resolution on the transaction set.

Any problems found by rpmtsCheck() can be examined by retrieving the problem set with rpmtsProblems(), success here only means that the resolution was successfully attempted for all packages in the set.

Parameters
tstransaction set
Returns
0 on success

◆ rpmtsClean()

void rpmtsClean ( rpmts  ts)

Free memory needed only for dependency checks and ordering.

Parameters
tstransaction set

◆ rpmtsCleanProblems()

void rpmtsCleanProblems ( rpmts  ts)

Clean current transaction problem set.

Parameters
tstransaction set

◆ rpmtsCloseDB()

int rpmtsCloseDB ( rpmts  ts)

Close the database used by the transaction.

Parameters
tstransaction set
Returns
0 on success

◆ rpmtsColor()

rpm_color_t rpmtsColor ( rpmts  ts)

Retrieve color bits of transaction set.

Parameters
tstransaction set
Returns
color bits

◆ rpmtsCreate()

rpmts rpmtsCreate ( void  )

Create an empty transaction set.

Returns
new transaction set

◆ rpmtsElement()

rpmte rpmtsElement ( rpmts  ts,
int  ix 
)

Return (ordered) transaction set element.

Parameters
tstransaction set
ixtransaction element index
Returns
transaction element (or NULL)

◆ rpmtsEmpty()

void rpmtsEmpty ( rpmts  ts)

Re-create an empty transaction set.

Parameters
tstransaction set

◆ rpmtsFilterFlags()

rpmprobFilterFlags rpmtsFilterFlags ( rpmts  ts)

Get problem ignore bit mask, i.e. bits to filter encountered problems.

Parameters
tstransaction set
Returns
ignore bit mask

◆ rpmtsFlags()

rpmtransFlags rpmtsFlags ( rpmts  ts)

Get transaction flags, i.e. bits that control rpmtsRun().

Parameters
tstransaction set
Returns
transaction flags

◆ rpmtsFree()

rpmts rpmtsFree ( rpmts  ts)

Destroy transaction set, closing the database as well.

Parameters
tstransaction set
Returns
NULL always

◆ rpmtsGetDBMode()

int rpmtsGetDBMode ( rpmts  ts)

Return the transaction database mode

Parameters
tstransaction set
Returns
O_RDONLY, O_RDWR or -1 (lazy opens disabled)

◆ rpmtsGetKeyring()

rpmKeyring rpmtsGetKeyring ( rpmts  ts,
int  autoload 
)

Retrieve handle for keyring used for this transaction set

Parameters
tstransaction set
autoloadload default keyring if keyring is not set
Returns
keyring handle (or NULL)

◆ rpmtsGetNotifyStyle()

int rpmtsGetNotifyStyle ( rpmts  ts)

Get transaction notify callback style.

Parameters
tstransaction set
Returns
current callback style (see above)

◆ rpmtsGetRdb()

rpmdb rpmtsGetRdb ( rpmts  ts)

Get transaction set database handle.

Parameters
tstransaction set
Returns
transaction database handle

◆ rpmtsGetTid()

rpm_tid_t rpmtsGetTid ( rpmts  ts)

Get transaction id, i.e. transaction time stamp.

Parameters
tstransaction set
Returns
transaction id

◆ rpmtsImportHeader()

rpmRC rpmtsImportHeader ( rpmtxn  txn,
Header  h,
rpmFlags  flags 
)

Import a header into the rpmdb

Parameters
txntransaction handle
hheader
flags(unused)
Returns
RPMRC_OK/RPMRC_FAIL

◆ rpmtsImportPubkey()

rpmRC rpmtsImportPubkey ( rpmts  ts,
const unsigned char *  pkt,
size_t  pktlen 
)

Import public key packet(s).

Todo:
Implicit –update policy for gpg-pubkey headers.
Parameters
tstransaction set
pktpgp pubkey packet(s)
pktlenpgp pubkey length
Returns
RPMRC_OK/RPMRC_FAIL

◆ rpmtsInitDB()

int rpmtsInitDB ( rpmts  ts,
int  perms 
)

Initialize the database used by the transaction.

Parameters
tstransaction set
permsdatabase permissions (ie mode bits)
Returns
0 on success

◆ rpmtsInitIterator()

rpmdbMatchIterator rpmtsInitIterator ( const rpmts  ts,
rpmDbiTagVal  rpmtag,
const void *  keyp,
size_t  keylen 
)

Return transaction database iterator.

Parameters
tstransaction set
rpmtagdatabase index tag
keypkey data (NULL for sequential access)
keylenkey data length (0 will use strlen(keyp))
Returns
NULL on failure

◆ rpmtsLink()

rpmts rpmtsLink ( rpmts  ts)

Reference a transaction set instance.

Parameters
tstransaction set
Returns
new transaction set reference

◆ rpmtsNElements()

int rpmtsNElements ( rpmts  ts)

Return number of (ordered) transaction set elements.

Parameters
tstransaction set
Returns
no. of transaction set elements

◆ rpmtsNotify()

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

Perform transaction progress notify callback.

Parameters
tstransaction set
tecurrent transaction element
whattype of call back
amountcurrent value
totalfinal value
Returns
callback dependent pointer

◆ rpmtsOp()

rpmop rpmtsOp ( rpmts  ts,
rpmtsOpX  opx 
)

Retrieve operation timestamp from a transaction set.

Parameters
tstransaction set
opxoperation timestamp index
Returns
pointer to operation timestamp.

◆ rpmtsOpenDB()

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

◆ rpmtsOrder()

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

◆ rpmtsPlugins()

rpmPlugins rpmtsPlugins ( rpmts  ts)

Get the plugins associated with a transaction set

Parameters
tstransaction set
Returns
plugins

◆ rpmtsPrefColor()

rpm_color_t rpmtsPrefColor ( rpmts  ts)

Retrieve preferred file color

Parameters
tstransaction set
Returns
color bits

◆ rpmtsProblems()

rpmps rpmtsProblems ( rpmts  ts)

Return current transaction set problems.

Parameters
tstransaction set
Returns
current problem set (or NULL if no problems)

◆ rpmtsRebuildDB()

int rpmtsRebuildDB ( rpmts  ts)

Rebuild the database used by the transaction.

Parameters
tstransaction set
Returns
0 on success

◆ rpmtsRootDir()

const char * rpmtsRootDir ( rpmts  ts)

Get transaction rootDir, i.e. path to chroot(2).

Parameters
tstransaction set
Returns
transaction rootDir

◆ rpmtsRun()

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
okProbsunused
ignoreSetbits to filter problem types
Returns
0 on success, -1 on error, >0 with newProbs set

◆ rpmtsScriptFd()

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

◆ rpmtsSetChangeCallback()

int rpmtsSetChangeCallback ( rpmts  ts,
rpmtsChangeFunction  notify,
void *  data 
)

Set transaction change callback function and argument.

The change callback gets called when transaction elements are added, replaced or removed from a transaction set.

Parameters
tstransaction set
notifyelement change callback
dataelement change callback private data
Returns
0 on success

◆ rpmtsSetColor()

rpm_color_t rpmtsSetColor ( rpmts  ts,
rpm_color_t  color 
)

Set color bits of transaction set.

Parameters
tstransaction set
colornew color bits
Returns
previous color bits

◆ rpmtsSetDBMode()

int rpmtsSetDBMode ( rpmts  ts,
int  dbmode 
)

Set the transaction database mode. Only permitted when when backing database hasn't been opened yet (ie rpmtsGetRdb(ts) == NULL)

Parameters
tstransaction set
dbmodeO_RDONLY, O_RDWR or -1 (disable lazy opens)
Returns
0 on success, 1 on error

◆ rpmtsSetFlags()

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

◆ rpmtsSetKeyring()

int rpmtsSetKeyring ( rpmts  ts,
rpmKeyring  keyring 
)

Set keyring to use for this transaction set. Keyring can be only changed while the underlying rpm database is not yet open.

Parameters
tstransaction set
keyringkeyring handle (NULL to free current keyring)
Returns
0 on success, -1 on error

◆ rpmtsSetNotifyCallback()

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

◆ rpmtsSetNotifyStyle()

int rpmtsSetNotifyStyle ( rpmts  ts,
int  style 
)

Set transaction notify callback style.

Parameters
tstransaction set
style0 (default) for header, 1 for transaction element as the first argument
Returns
0 on success

◆ rpmtsSetPrefColor()

rpm_color_t rpmtsSetPrefColor ( rpmts  ts,
rpm_color_t  color 
)

Set preferred file color

Parameters
tstransaction set
colornew color bits
Returns
previous color bits

◆ rpmtsSetRootDir()

int rpmtsSetRootDir ( rpmts  ts,
const char *  rootDir 
)

Set transaction rootDir, i.e. path to chroot(2).

Note that rpm assumes the environment inside the root is set up by the caller, such as any mounts needed for the operation inside the root directory.

Parameters
tstransaction set
rootDirnew transaction rootDir (or NULL)
Returns
0 on success, -1 on error (invalid rootDir)

◆ rpmtsSetScriptFd()

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)

◆ rpmtsSetSolveCallback()

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

Set dependency solver callback.

Parameters
tstransaction set
(*solve)dependency solver callback
solveDatadependency solver callback data (opaque)
Returns
0 on success

◆ rpmtsSetTid()

rpm_tid_t rpmtsSetTid ( rpmts  ts,
rpm_tid_t  tid 
)

Set transaction id, i.e. transaction time stamp.

Parameters
tstransaction set
tidnew transaction id
Returns
previous transaction id

◆ rpmtsSetVfyFlags()

rpmVSFlags rpmtsSetVfyFlags ( rpmts  ts,
rpmVSFlags  vfyflags 
)

Set package verify flag(s).

Parameters
tstransaction set
vfyflagsnew package verify flags
Returns
old package verify flags

◆ rpmtsSetVfyLevel()

int rpmtsSetVfyLevel ( rpmts  ts,
int  vfylevel 
)

Set enforced package verify level

Parameters
tstransaction set
vfylevelnew package verify level
Returns
old package verify level

◆ rpmtsSetVSFlags()

rpmVSFlags rpmtsSetVSFlags ( rpmts  ts,
rpmVSFlags  vsflags 
)

Set verify signatures flag(s).

Parameters
tstransaction set
vsflagsnew verify signatures flags
Returns
previous value

◆ rpmtsVerifyDB()

int rpmtsVerifyDB ( rpmts  ts)

Verify the database used by the transaction.

Parameters
tstransaction set
Returns
0 on success

◆ rpmtsVfyFlags()

rpmVSFlags rpmtsVfyFlags ( rpmts  ts)

Get package verify flag(s).

Parameters
tstransaction set
Returns
verify signatures flags

◆ rpmtsVfyLevel()

int rpmtsVfyLevel ( rpmts  ts)

Get enforced package verify level

Parameters
tstransaction set
Returns
package verify level

◆ rpmtsVSFlags()

rpmVSFlags rpmtsVSFlags ( rpmts  ts)

Get verify signatures flag(s).

Parameters
tstransaction set
Returns
verify signatures flags

◆ rpmtxnBegin()

rpmtxn rpmtxnBegin ( rpmts  ts,
rpmtxnFlags  flags 
)

Create a transaction (lock) handle

Parameters
tstransaction set
flagsflags
Returns
transaction handle

◆ rpmtxnEnd()

rpmtxn rpmtxnEnd ( rpmtxn  txn)

Destroy transaction (lock) handle

Parameters
txntransaction handle
Returns
NULL always