lib/psm.c File Reference

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

#include "system.h"
#include <rpmio_internal.h>
#include <rpmlib.h>
#include <rpmmacro.h>
#include <rpmurl.h>
#include <rpmlua.h>
#include "cpio.h"
#include "fsm.h"
#include "psm.h"
#include "rpmds.h"
#include "rpmfi.h"
#include "rpmte.h"
#include "rpmts.h"
#include "rpmlead.h"
#include "signature.h"
#include "legacy.h"
#include "misc.h"
#include "rpmdb.h"
#include "debug.h"

Go to the source code of this file.

Data Structures

struct  tagMacro
 Macros to be defined from per-header tag values. More...

Defines

#define _RPMFI_INTERNAL
#define _RPMTE_INTERNAL
#define _RPMTS_INTERNAL
#define _PSM_DEBUG   0

Functions

int rpmVersionCompare (Header first, Header second)
 Compare headers to determine which header is "newer".
static int rpmInstallLoadMacros (rpmfi fi, Header h)
 Define per-header macros.
static rpmRC markReplacedFiles (const rpmpsm psm)
 Mark files in database shared with this package as "replaced".
rpmRC rpmInstallSourcePackage (rpmts ts, FD_t fd, const char **specFilePtr, const char **cookie)
 Install source package.
static const char *const tag2sln (int tag)
 Return scriptlet name from tag.
static pid_t psmWait (rpmpsm psm)
 Wait for child process to be reaped.
static rpmRC runScript (rpmpsm psm, Header h, const char *sln, int progArgc, const char **progArgv, const char *script, int arg1, int arg2)
 Run scriptlet with args.
static rpmRC runInstScript (rpmpsm psm)
 Retrieve and run scriptlet from header.
static rpmRC handleOneTrigger (const rpmpsm psm, Header sourceH, Header triggeredH, int arg2, unsigned char *triggersAlreadyRun)
 Execute triggers.
static rpmRC runTriggers (rpmpsm psm)
 Run trigger scripts in the database that are fired by this header.
static rpmRC runImmedTriggers (rpmpsm psm)
 Run triggers from this header that are fired by headers in the database.
static const char *const pkgStageString (pkgStage a)
rpmpsm XrpmpsmUnlink (rpmpsm psm, const char *msg, const char *fn, unsigned ln)
rpmpsm XrpmpsmLink (rpmpsm psm, const char *msg, const char *fn, unsigned ln)
rpmpsm rpmpsmFree (rpmpsm psm)
 Destroy a package state machine.
rpmpsm rpmpsmNew (rpmts ts, rpmte te, rpmfi fi)
 Create and load a package state machine.
static void * rpmpsmThread (void *arg)
static int rpmpsmNext (rpmpsm psm, pkgStage nstage)
rpmRC rpmpsmStage (rpmpsm psm, pkgStage stage)
 Package state machine driver.

Variables

int _psm_debug = 0
int _psm_threads = 0
unsigned int myinstall_instance
static struct tagMacro tagMacros []
 Macros to be defined from per-header tag values.
static char * SCRIPT_PATH = "PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin"
static int ldconfig_done = 0
static const char * ldconfig_path = "/sbin/ldconfig"


Detailed Description

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

Definition in file psm.c.


Define Documentation

#define _PSM_DEBUG   0

Definition at line 36 of file psm.c.

#define _RPMFI_INTERNAL

Definition at line 20 of file psm.c.

#define _RPMTE_INTERNAL

Definition at line 23 of file psm.c.

#define _RPMTS_INTERNAL

Definition at line 26 of file psm.c.


Function Documentation

static rpmRC handleOneTrigger ( const rpmpsm  psm,
Header  sourceH,
Header  triggeredH,
int  arg2,
unsigned char *  triggersAlreadyRun 
) [static]

Execute triggers.

Todo:
Trigger on any provides, not just package NVR.
Parameters:
psm package state machine data
sourceH 
triggeredH 
arg2 
triggersAlreadyRun 
Returns:

Definition at line 1017 of file psm.c.

References rpmpsm_s::countCorrection, rpmpsm_s::fi, headerFreeData(), headerNVR(), rpmdbCountPackages(), rpmdsAnyMatchesDep(), rpmdsFlags(), rpmdsFree(), rpmdsInit(), rpmdsN(), rpmdsNew(), rpmdsNext(), rpmdsSetNoPromote(), RPMRC_FAIL, RPMRC_OK, RPMTAG_TRIGGERINDEX, RPMTAG_TRIGGERNAME, RPMTAG_TRIGGERSCRIPTPROG, RPMTAG_TRIGGERSCRIPTS, rpmtsGetRdb(), runScript(), rpmpsm_s::sense, and rpmpsm_s::ts.

Referenced by runImmedTriggers(), and runTriggers().

static rpmRC markReplacedFiles ( const rpmpsm  psm  )  [static]

Mark files in database shared with this package as "replaced".

Parameters:
psm package state machine data
Returns:
0 always

Definition at line 163 of file psm.c.

References alloca(), rpmpsm_s::fi, rpmdbAppendIterator(), rpmdbFreeIterator(), rpmdbGetIteratorOffset(), RPMDBI_PACKAGES, rpmdbNextIterator(), rpmdbSetIteratorModified(), rpmdbSetIteratorRewrite(), rpmfiFC(), RPMFILE_STATE_REPLACED, RPMRC_OK, RPMTAG_FILESTATES, rpmtsInitIterator(), and rpmpsm_s::ts.

Referenced by rpmpsmStage().

static const char* const pkgStageString ( pkgStage  a  )  [static]

Definition at line 1215 of file psm.c.

References PSM_CHROOT_IN, PSM_CHROOT_OUT, PSM_COMMIT, PSM_CREATE, PSM_DESTROY, PSM_FINI, PSM_IMMED_TRIGGERS, PSM_INIT, PSM_NOTIFY, PSM_PKGCOMMIT, PSM_PKGERASE, PSM_PKGINSTALL, PSM_PKGSAVE, PSM_POST, PSM_PRE, PSM_PROCESS, PSM_RPMDB_ADD, PSM_RPMDB_LOAD, PSM_RPMDB_REMOVE, PSM_RPMIO_FLAGS, PSM_SCRIPT, PSM_TRIGGERS, PSM_UNDO, and PSM_UNKNOWN.

Referenced by rpmpsmStage().

static pid_t psmWait ( rpmpsm  psm  )  [static]

Wait for child process to be reaped.

Parameters:
psm package state machine data
Returns:

Definition at line 476 of file psm.c.

References _, rpmsqElem::child, rpmsqElem::op, rpmsqElem::reaped, RPMMESS_DEBUG, rpmMessage, rpmsqWait(), rpmswAdd(), RPMTS_OP_SCRIPTLETS, rpmtsOp(), rpmpsm_s::sq, rpmsqElem::status, rpmpsm_s::stepName, rpmpsm_s::ts, and rpmop_s::usecs.

Referenced by runScript().

static int rpmInstallLoadMacros ( rpmfi  fi,
Header  h 
) [static]

Define per-header macros.

Parameters:
fi transaction element file info
h header
Returns:
0 always

Definition at line 115 of file psm.c.

References argv.

Referenced by rpmInstallSourcePackage().

rpmRC rpmInstallSourcePackage ( rpmts  ts,
FD_t  fd,
const char **  specFilePtr,
const char **  cookie 
)

Install source package.

Parameters:
ts transaction set
fd file handle
Return values:
specFilePtr address of spec file name (or NULL)
cookie address of cookie pointer (or NULL)
Returns:
rpmRC return code

Definition at line 238 of file psm.c.

References _, _free(), CPIO_MAP_GID, CPIO_MAP_MODE, CPIO_MAP_PATH, CPIO_MAP_UID, FA_CREATE, rpmpsm_s::fd, fdLink, headerFree(), headerIsEntry(), headerLink(), RPMERR_NOTSRPM, rpmError, rpmfiBuildFNames(), RPMFILE_SPECFILE, rpmfiLink, rpmfiNew(), rpmInstallLoadMacros(), RPMRC_FAIL, RPMRC_NOKEY, RPMRC_NOTTRUSTED, RPMRC_OK, rpmReadPackageFile(), RPMTAG_BASENAMES, RPMTAG_COOKIE, RPMTAG_SOURCEPACKAGE, rpmtsAddInstallElement(), rpmtsElement(), rpmtsLink, and xstrdup().

Referenced by rpmInstall(), and rpmInstallSource().

rpmpsm rpmpsmFree ( rpmpsm  psm  ) 

Destroy a package state machine.

Parameters:
psm package state machine
Returns:
NULL always

Definition at line 1279 of file psm.c.

References _free(), rpmpsm_s::fi, rpmpsm_s::nrefs, rpmfiFree(), rpmpsmUnlink, rpmteFree(), rpmtsFree(), rpmpsm_s::te, and rpmpsm_s::ts.

Referenced by rpmtsRun(), and rpmVerifyScript().

rpmpsm rpmpsmNew ( rpmts  ts,
rpmte  te,
rpmfi  fi 
)

Create and load a package state machine.

Parameters:
ts transaction set
te transaction set element
fi file info set
Returns:
new package state machine

Definition at line 1312 of file psm.c.

References rpmfiLink, rpmpsmLink, rpmtsLink, and xcalloc().

Referenced by rpmtsRun(), and rpmVerifyScript().

static int rpmpsmNext ( rpmpsm  psm,
pkgStage  nstage 
) [static]

Definition at line 1340 of file psm.c.

References _psm_threads, rpmpsm_s::nstage, rpmpsmStage(), rpmpsmThread(), rpmsqJoin(), and rpmsqThread().

Referenced by rpmpsmStage().

rpmRC rpmpsmStage ( rpmpsm  psm,
pkgStage  stage 
)

Package state machine driver.

Todo:
Packages w/o files never get a callback, hence don't get displayed on install with -v.

Definition at line 1355 of file psm.c.

References _, _free(), rpmpsm_s::amount, rpmpsm_s::cfd, rpmpsm_s::chrootDone, rpmpsm_s::countCorrection, CPIO_MAP_GID, CPIO_MAP_MODE, CPIO_MAP_PATH, CPIO_MAP_UID, CPIO_SBIT_CHECK, cpioStrerror(), dbiOpen(), errno, FA_COPYOUT, rpmpsm_s::failedFile, Fclose(), rpmpsm_s::fd, fdDup(), Fdopen(), FDSTAT_DIGEST, fdstat_op(), FDSTAT_READ, FDSTAT_WRITE, Ferror(), Fflush(), rpmpsm_s::fi, Fileno(), Fopen(), FSM_PKGBUILD, FSM_PKGCOMMIT, FSM_PKGERASE, FSM_PKGINSTALL, fsmSetup(), fsmTeardown(), Fstrerror(), rpmpsm_s::goal, HEADER_MAGIC_YES, headerAddEntry(), headerCheck(), headerCopyLoad(), headerFree(), headerFreeData(), headerFreeIterator(), headerGetEntry(), headerInitIterator(), headerIsEntry(), headerLink(), headerNew(), headerNextIterator(), headerRegenSigHeader(), headerReload(), headerSprintf(), headerWrite(), markReplacedFiles(), rpmpsm_s::mi, myinstall_instance, rpmpsm_s::npkgs_installed, rpmpsm_s::oh, rpmpsm_s::pkgfn, pkgStageString(), rpmpsm_s::pkgURL, rpmpsm_s::progTag, PSM_CHROOT_IN, PSM_CHROOT_OUT, PSM_COMMIT, PSM_CREATE, PSM_DESTROY, PSM_FINI, PSM_IMMED_TRIGGERS, PSM_INIT, PSM_NOTIFY, PSM_PKGCOMMIT, PSM_PKGERASE, PSM_PKGINSTALL, PSM_PKGSAVE, PSM_POST, PSM_PRE, PSM_PROCESS, PSM_RPMDB_ADD, PSM_RPMDB_LOAD, PSM_RPMDB_REMOVE, PSM_RPMIO_FLAGS, PSM_SCRIPT, PSM_TRIGGERS, PSM_UNDO, PSM_UNKNOWN, rpmpsm_s::rc, RPM_CHAR_TYPE, RPM_INT32_TYPE, RPMCALLBACK_CPIO_ERROR, RPMCALLBACK_INST_PROGRESS, RPMCALLBACK_INST_START, RPMCALLBACK_UNINST_START, RPMCALLBACK_UNINST_STOP, RPMCALLBACK_UNPACK_ERROR, rpmdbAdd(), rpmdbCountPackages(), rpmdbFreeIterator(), rpmdbGetIteratorOffset(), RPMDBI_PACKAGES, rpmdbNextIterator(), rpmdbRemove(), rpmdbSetIteratorRE(), RPMERR_CPIO, RPMERR_NOSPACE, RPMERR_SCRIPT, rpmError, rpmfiBuildFNames(), rpmfiFC(), RPMFILE_STATE_NORMAL, rpmFreeSignature(), rpmGenPath(), rpmGetArchInfo(), rpmGetOsInfo(), rpmGetPath(), rpmHeaderFormats, rpmpsm_s::rpmio_flags, RPMLEAD_BINARY, RPMMESS_DEBUG, RPMMESS_VERBOSE, rpmMessage, RPMMIRE_STRCMP, rpmpsmNext(), RPMRC_FAIL, RPMRC_OK, RPMSENSE_TRIGGERIN, RPMSENSE_TRIGGERPOSTUN, RPMSENSE_TRIGGERUN, RPMSIGTYPE_HEADERSIG, rpmswAdd(), rpmswEnter(), rpmswExit(), RPMTAG_ARCH, RPMTAG_ARCHIVESIZE, RPMTAG_BASENAMES, RPMTAG_DEFAULTPREFIX, RPMTAG_EPOCH, RPMTAG_FILEGROUPNAME, RPMTAG_FILESTATES, RPMTAG_FILEUSERNAME, RPMTAG_HEADERIMAGE, RPMTAG_HEADERIMMUTABLE, RPMTAG_HEADERSIGNATURES, RPMTAG_INSTALLCOLOR, RPMTAG_INSTALLTIME, RPMTAG_NAME, RPMTAG_ORIGBASENAMES, RPMTAG_OS, RPMTAG_PAYLOADCOMPRESSOR, RPMTAG_POSTIN, RPMTAG_POSTINPROG, RPMTAG_POSTUN, RPMTAG_POSTUNPROG, RPMTAG_PREIN, RPMTAG_PREINPROG, RPMTAG_PREUN, RPMTAG_PREUNPROG, RPMTAG_RELEASE, RPMTAG_REMOVETID, RPMTAG_TRIGGERNAME, RPMTAG_VERSION, rpmTagTable, rpmteA(), rpmteE(), rpmteFd(), rpmteN(), rpmteNEVR(), rpmteO(), rpmteR(), rpmteSetDBInstance(), rpmteV(), RPMTRANS_FLAG_APPLYONLY, RPMTRANS_FLAG_JUSTDB, RPMTRANS_FLAG_NOPOST, RPMTRANS_FLAG_NOPOSTUN, RPMTRANS_FLAG_NOPRE, RPMTRANS_FLAG_NOPREUN, RPMTRANS_FLAG_NOTRIGGERIN, RPMTRANS_FLAG_NOTRIGGERPOSTUN, RPMTRANS_FLAG_NOTRIGGERPREIN, RPMTRANS_FLAG_NOTRIGGERUN, RPMTRANS_FLAG_PKGCOMMIT, RPMTRANS_FLAG_TEST, RPMTRANS_TYPE_AUTOROLLBACK, RPMTRANS_TYPE_ROLLBACK, RPMTS_OP_COMPRESS, RPMTS_OP_DBADD, RPMTS_OP_DBREMOVE, RPMTS_OP_DIGEST, RPMTS_OP_UNCOMPRESS, rpmtsChrootDone(), rpmtsColor(), rpmtsCurrDir(), rpmtsFlags(), rpmtsGetRdb(), rpmtsGetScore(), rpmtsGetTid(), rpmtsGetType(), rpmtsInitIterator(), rpmtsNotify(), rpmtsOp(), rpmtsRootDir(), rpmtsScoreGetEntry(), rpmtsSetChrootDone(), rpmtsVSFlags(), RPMVSF_NOHDRCHK, rpmWriteSignature(), runImmedTriggers(), runInstScript(), runTriggers(), rpmpsm_s::scriptArg, rpmpsm_s::scriptTag, rpmpsm_s::sense, rpmpsm_s::stepName, stpcpy(), tag2sln(), rpmpsm_s::te, rpmpsm_s::total, TR_ADDED, TR_REMOVED, rpmpsm_s::ts, urlPath(), rpmpsm_s::what, writeLead(), and xmalloc().

Referenced by rpmpsmNext(), rpmpsmThread(), rpmtsRun(), and rpmVerifyScript().

static void* rpmpsmThread ( void *  arg  )  [static]

Definition at line 1330 of file psm.c.

References rpmpsm_s::nstage, and rpmpsmStage().

Referenced by rpmpsmNext().

int rpmVersionCompare ( Header  first,
Header  second 
)

Compare headers to determine which header is "newer".

Parameters:
first 1st header
second 2nd header
Returns:
result of comparison

Definition at line 61 of file psm.c.

References headerGetEntry(), RPMTAG_EPOCH, RPMTAG_RELEASE, RPMTAG_VERSION, and rpmvercmp().

Referenced by hdr_compare(), rpmInstall(), and rpmtsAddInstallElement().

static rpmRC runImmedTriggers ( rpmpsm  psm  )  [static]

Run triggers from this header that are fired by headers in the database.

Parameters:
psm package state machine data
Returns:
0 on success

Definition at line 1161 of file psm.c.

References alloca(), rpmpsm_s::fi, handleOneTrigger(), headerFreeData(), rpmpsm_s::mi, rpmdbFreeIterator(), rpmdbGetIteratorCount(), rpmdbNextIterator(), RPMRC_OK, RPMTAG_NAME, RPMTAG_TRIGGERINDEX, RPMTAG_TRIGGERNAME, rpmtsInitIterator(), and rpmpsm_s::ts.

Referenced by rpmpsmStage().

static rpmRC runInstScript ( rpmpsm  psm  )  [static]

Retrieve and run scriptlet from header.

Parameters:
psm package state machine data
Returns:
rpmRC return code

Definition at line 964 of file psm.c.

References alloca(), argv, rpmpsm_s::fi, headerFreeData(), rpmpsm_s::progTag, RPM_STRING_TYPE, RPMRC_OK, runScript(), rpmpsm_s::scriptArg, rpmpsm_s::scriptTag, and tag2sln().

Referenced by rpmpsmStage().

static rpmRC runScript ( rpmpsm  psm,
Header  h,
const char *  sln,
int  progArgc,
const char **  progArgv,
const char *  script,
int  arg1,
int  arg2 
) [static]

Run scriptlet with args.

Run a script with an interpreter. If the interpreter is not specified, /bin/sh will be used. If the interpreter is /bin/sh, then the args from the header will be ignored, passing instead arg1 and arg2.

Parameters:
psm package state machine data
h header
sln name of scriptlet section
progArgc no. of args from header
progArgv args from header, progArgv[0] is the interpreter to use
script scriptlet from header
arg1 no. instances of package installed after scriptlet exec (-1 is no arg)
arg2 ditto, but for the target package
Returns:
0 on success

Definition at line 607 of file psm.c.

References _, _free(), alloca(), argv, rpmsqElem::child, doputenv(), environ, errno, Fclose(), rpmpsm_s::fd, fdDup(), Ferror(), rpmpsm_s::fi, Fileno(), Fopen(), Fwrite(), headerFreeData(), headerNVR(), headerSprintf(), ipath, makeTempFile(), psmWait(), rpmsqElem::reaped, rpmsqElem::reaper, rpm_execcon, RPMERR_FORK, RPMERR_SCRIPT, rpmError, rpmExpand(), rpmGetPath(), rpmHeaderFormats, rpmIsDebug, rpmIsVerbose, RPMMESS_DEBUG, rpmMessage, RPMRC_FAIL, RPMRC_OK, rpmsqFork(), RPMTAG_ARCH, RPMTAG_INSTALLPREFIX, RPMTAG_INSTPREFIXES, rpmTagTable, rpmtsChrootDone(), rpmtsRootDir(), rpmtsScriptFd(), rpmtsSELinuxEnabled(), rpmpsm_s::scriptTag, rpmpsm_s::sq, rpmsqElem::status, rpmpsm_s::stepName, stpcpy(), strerror, tag2sln(), rpmpsm_s::ts, rpmpsm_s::unorderedSuccessor, unsetenv(), URL_IS_DASH, URL_IS_FTP, URL_IS_HKP, URL_IS_HTTP, URL_IS_HTTPS, URL_IS_PATH, URL_IS_UNKNOWN, and urlIsURL().

Referenced by handleOneTrigger(), and runInstScript().

static rpmRC runTriggers ( rpmpsm  psm  )  [static]

Run trigger scripts in the database that are fired by this header.

Parameters:
psm package state machine data
Returns:
0 on success

Definition at line 1119 of file psm.c.

References rpmpsm_s::countCorrection, rpmpsm_s::fi, handleOneTrigger(), rpmpsm_s::mi, rpmdbCountPackages(), rpmdbFreeIterator(), rpmdbNextIterator(), RPMRC_NOTFOUND, RPMRC_OK, RPMTAG_TRIGGERNAME, rpmteN(), rpmtsGetRdb(), rpmtsInitIterator(), rpmpsm_s::te, and rpmpsm_s::ts.

Referenced by rpmpsmStage().

static const char* const tag2sln ( int  tag  )  [static]

Return scriptlet name from tag.

Parameters:
tag scriptlet tag
Returns:
name of scriptlet

Definition at line 453 of file psm.c.

References RPMTAG_POSTIN, RPMTAG_POSTTRANS, RPMTAG_POSTUN, RPMTAG_PREIN, RPMTAG_PRETRANS, RPMTAG_PREUN, RPMTAG_TRIGGERIN, RPMTAG_TRIGGERPOSTUN, RPMTAG_TRIGGERUN, and RPMTAG_VERIFYSCRIPT.

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

rpmpsm XrpmpsmLink ( rpmpsm  psm,
const char *  msg,
const char *  fn,
unsigned  ln 
)

Todo:
Remove debugging entry from the ABI.

Definition at line 1266 of file psm.c.

References _psm_debug, and rpmpsm_s::nrefs.

rpmpsm XrpmpsmUnlink ( rpmpsm  psm,
const char *  msg,
const char *  fn,
unsigned  ln 
)

Todo:
Remove debugging entry from the ABI.

Definition at line 1255 of file psm.c.

References _psm_debug, and rpmpsm_s::nrefs.


Variable Documentation

int _psm_debug = 0

Definition at line 38 of file psm.c.

int _psm_threads = 0

Definition at line 40 of file psm.c.

Referenced by rpmpsmNext().

int ldconfig_done = 0 [static]

Definition at line 584 of file psm.c.

const char* ldconfig_path = "/sbin/ldconfig" [static]

Definition at line 587 of file psm.c.

unsigned int myinstall_instance

Definition at line 69 of file rpmdb.c.

Referenced by rpmdbAdd(), and rpmpsmStage().

char* SCRIPT_PATH = "PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin" [static]

Definition at line 446 of file psm.c.

struct tagMacro tagMacros[] [static]

Macros to be defined from per-header tag values.

Todo:
Should other macros be added from header when installing a package?


Generated on Fri Oct 12 08:44:55 2007 for rpm by  doxygen 1.5.2