505 lines
12 KiB
C
505 lines
12 KiB
C
#ifndef H_RPMTE
|
|
#define H_RPMTE
|
|
|
|
/** \ingroup rpmts rpmte
|
|
* \file lib/rpmte.h
|
|
* Structures used for an "rpmte" transaction element.
|
|
*/
|
|
|
|
#include <rpmal.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
*/
|
|
extern int _rpmte_debug;
|
|
|
|
/**
|
|
* Transaction element ordering chain linkage.
|
|
*/
|
|
typedef struct tsortInfo_s * tsortInfo;
|
|
|
|
/**
|
|
* Transaction element iterator.
|
|
*/
|
|
typedef struct rpmtsi_s * rpmtsi;
|
|
|
|
/** \ingroup rpmte
|
|
* Transaction element type.
|
|
*/
|
|
typedef enum rpmElementType_e {
|
|
TR_ADDED = (1 << 0), /*!< Package will be installed. */
|
|
TR_REMOVED = (1 << 1) /*!< Package will be removed. */
|
|
} rpmElementType;
|
|
|
|
#if defined(_RPMTE_INTERNAL)
|
|
/** \ingroup rpmte
|
|
* Dependncy ordering information.
|
|
*/
|
|
struct tsortInfo_s {
|
|
union {
|
|
int count;
|
|
rpmte suc;
|
|
} tsi_u;
|
|
#define tsi_count tsi_u.count
|
|
#define tsi_suc tsi_u.suc
|
|
struct tsortInfo_s * tsi_next;
|
|
rpmte tsi_chain;
|
|
int tsi_reqx;
|
|
int tsi_qcnt;
|
|
};
|
|
|
|
/** \ingroup rpmte
|
|
* A single package instance to be installed/removed atomically.
|
|
*/
|
|
struct rpmte_s {
|
|
rpmElementType type; /*!< Package disposition (installed/removed). */
|
|
|
|
Header h; /*!< Package header. */
|
|
const char * NEVR; /*!< Package name-version-release. */
|
|
const char * NEVRA; /*!< Package name-version-release.arch. */
|
|
const char * name; /*!< Name: */
|
|
char * epoch;
|
|
char * version; /*!< Version: */
|
|
char * release; /*!< Release: */
|
|
const char * arch; /*!< Architecture hint. */
|
|
const char * os; /*!< Operating system hint. */
|
|
int archScore; /*!< (TR_ADDED) Arch score. */
|
|
int osScore; /*!< (TR_ADDED) Os score. */
|
|
int isSource; /*!< (TR_ADDED) source rpm? */
|
|
|
|
rpmte parent; /*!< Parent transaction element. */
|
|
int degree; /*!< No. of immediate children. */
|
|
int npreds; /*!< No. of predecessors. */
|
|
int tree; /*!< Tree index. */
|
|
int depth; /*!< Depth in dependency tree. */
|
|
int breadth; /*!< Breadth in dependency tree. */
|
|
unsigned int db_instance; /*!< Database Instance after add */
|
|
tsortInfo tsi; /*!< Dependency ordering chains. */
|
|
|
|
rpmds this; /*!< This package's provided NEVR. */
|
|
rpmds provides; /*!< Provides: dependencies. */
|
|
rpmds requires; /*!< Requires: dependencies. */
|
|
rpmds conflicts; /*!< Conflicts: dependencies. */
|
|
rpmds obsoletes; /*!< Obsoletes: dependencies. */
|
|
rpmfi fi; /*!< File information. */
|
|
|
|
uint32_t color; /*!< Color bit(s) from package dependencies. */
|
|
uint32_t pkgFileSize; /*!< No. of bytes in package file (approx). */
|
|
|
|
fnpyKey key; /*!< (TR_ADDED) Retrieval key. */
|
|
rpmRelocation * relocs; /*!< (TR_ADDED) Payload file relocations. */
|
|
int nrelocs; /*!< (TR_ADDED) No. of relocations. */
|
|
int autorelocatex; /*!< (TR_ADDED) Auto relocation entry index. */
|
|
FD_t fd; /*!< (TR_ADDED) Payload file descriptor. */
|
|
|
|
union {
|
|
rpmalKey addedKey;
|
|
struct {
|
|
rpmalKey dependsOnKey;
|
|
int dboffset;
|
|
} removed;
|
|
} u;
|
|
|
|
};
|
|
|
|
/**
|
|
* Iterator across transaction elements, forward on install, backward on erase.
|
|
*/
|
|
struct rpmtsi_s {
|
|
rpmts ts; /*!< transaction set. */
|
|
int reverse; /*!< reversed traversal? */
|
|
int ocsave; /*!< last returned iterator index. */
|
|
int oc; /*!< iterator index. */
|
|
};
|
|
|
|
#endif /* _RPMTE_INTERNAL */
|
|
|
|
/**
|
|
* Destroy a transaction element.
|
|
* @param te transaction element
|
|
* @return NULL always
|
|
*/
|
|
rpmte rpmteFree(rpmte te);
|
|
|
|
/**
|
|
* Create a transaction element.
|
|
* @param ts transaction set
|
|
* @param h header
|
|
* @param type TR_ADDED/TR_REMOVED
|
|
* @param key (TR_ADDED) package retrieval key (e.g. file name)
|
|
* @param relocs (TR_ADDED) package file relocations
|
|
* @param dboffset (TR_REMOVED) rpmdb instance
|
|
* @param pkgKey associated added package (if any)
|
|
* @return new transaction element
|
|
*/
|
|
rpmte rpmteNew(const rpmts ts, Header h, rpmElementType type,
|
|
fnpyKey key,
|
|
rpmRelocation * relocs,
|
|
int dboffset,
|
|
rpmalKey pkgKey);
|
|
|
|
/**
|
|
* Retrieve header from transaction element.
|
|
* @param te transaction element
|
|
* @return header
|
|
*/
|
|
extern Header rpmteHeader(rpmte te);
|
|
|
|
/**
|
|
* Save header into transaction element.
|
|
* @param te transaction element
|
|
* @param h header
|
|
* @return NULL always
|
|
*/
|
|
extern Header rpmteSetHeader(rpmte te, Header h);
|
|
|
|
/**
|
|
* Retrieve type of transaction element.
|
|
* @param te transaction element
|
|
* @return type
|
|
*/
|
|
rpmElementType rpmteType(rpmte te);
|
|
|
|
/**
|
|
* Retrieve name string of transaction element.
|
|
* @param te transaction element
|
|
* @return name string
|
|
*/
|
|
extern const char * rpmteN(rpmte te);
|
|
|
|
/**
|
|
* Retrieve epoch string of transaction element.
|
|
* @param te transaction element
|
|
* @return epoch string
|
|
*/
|
|
extern const char * rpmteE(rpmte te);
|
|
|
|
/**
|
|
* Retrieve version string of transaction element.
|
|
* @param te transaction element
|
|
* @return version string
|
|
*/
|
|
extern const char * rpmteV(rpmte te);
|
|
|
|
/**
|
|
* Retrieve release string of transaction element.
|
|
* @param te transaction element
|
|
* @return release string
|
|
*/
|
|
extern const char * rpmteR(rpmte te);
|
|
|
|
/**
|
|
* Retrieve arch string of transaction element.
|
|
* @param te transaction element
|
|
* @return arch string
|
|
*/
|
|
extern const char * rpmteA(rpmte te);
|
|
|
|
/**
|
|
* Retrieve os string of transaction element.
|
|
* @param te transaction element
|
|
* @return os string
|
|
*/
|
|
extern const char * rpmteO(rpmte te);
|
|
|
|
/**
|
|
* Retrieve isSource attribute of transaction element.
|
|
* @param te transaction element
|
|
* @return isSource attribute
|
|
*/
|
|
extern int rpmteIsSource(rpmte te);
|
|
|
|
/**
|
|
* Retrieve color bits of transaction element.
|
|
* @param te transaction element
|
|
* @return color bits
|
|
*/
|
|
uint32_t rpmteColor(rpmte te);
|
|
|
|
/**
|
|
* Set color bits of transaction element.
|
|
* @param te transaction element
|
|
* @param color new color bits
|
|
* @return previous color bits
|
|
*/
|
|
uint32_t rpmteSetColor(rpmte te, uint32_t color);
|
|
|
|
/**
|
|
* Retrieve last instance installed to the database.
|
|
* @param te transaction element
|
|
* @return last install instance.
|
|
*/
|
|
unsigned int rpmteDBInstance(rpmte te);
|
|
|
|
/**
|
|
* Set last instance installed to the database.
|
|
* @param te transaction element
|
|
* @param instance Database instance of last install element.
|
|
* @return last install instance.
|
|
*/
|
|
void rpmteSetDBInstance(rpmte te, unsigned int instance);
|
|
|
|
/**
|
|
* Retrieve size in bytes of package file.
|
|
* @todo Signature header is estimated at 256b.
|
|
* @param te transaction element
|
|
* @return size in bytes of package file.
|
|
*/
|
|
uint32_t rpmtePkgFileSize(rpmte te);
|
|
|
|
/**
|
|
* Retrieve dependency tree depth of transaction element.
|
|
* @param te transaction element
|
|
* @return depth
|
|
*/
|
|
int rpmteDepth(rpmte te);
|
|
|
|
/**
|
|
* Set dependency tree depth of transaction element.
|
|
* @param te transaction element
|
|
* @param ndepth new depth
|
|
* @return previous depth
|
|
*/
|
|
int rpmteSetDepth(rpmte te, int ndepth);
|
|
|
|
/**
|
|
* Retrieve dependency tree breadth of transaction element.
|
|
* @param te transaction element
|
|
* @return breadth
|
|
*/
|
|
int rpmteBreadth(rpmte te);
|
|
|
|
/**
|
|
* Set dependency tree breadth of transaction element.
|
|
* @param te transaction element
|
|
* @param nbreadth new breadth
|
|
* @return previous breadth
|
|
*/
|
|
int rpmteSetBreadth(rpmte te, int nbreadth);
|
|
|
|
/**
|
|
* Retrieve tsort no. of predecessors of transaction element.
|
|
* @param te transaction element
|
|
* @return no. of predecessors
|
|
*/
|
|
int rpmteNpreds(rpmte te);
|
|
|
|
/**
|
|
* Set tsort no. of predecessors of transaction element.
|
|
* @param te transaction element
|
|
* @param npreds new no. of predecessors
|
|
* @return previous no. of predecessors
|
|
*/
|
|
int rpmteSetNpreds(rpmte te, int npreds);
|
|
|
|
/**
|
|
* Retrieve tree index of transaction element.
|
|
* @param te transaction element
|
|
* @return tree index
|
|
*/
|
|
int rpmteTree(rpmte te);
|
|
|
|
/**
|
|
* Set tree index of transaction element.
|
|
* @param te transaction element
|
|
* @param ntree new tree index
|
|
* @return previous tree index
|
|
*/
|
|
int rpmteSetTree(rpmte te, int ntree);
|
|
|
|
/**
|
|
* Retrieve parent transaction element.
|
|
* @param te transaction element
|
|
* @return parent transaction element
|
|
*/
|
|
rpmte rpmteParent(rpmte te);
|
|
|
|
/**
|
|
* Set parent transaction element.
|
|
* @param te transaction element
|
|
* @param pte new parent transaction element
|
|
* @return previous parent transaction element
|
|
*/
|
|
rpmte rpmteSetParent(rpmte te, rpmte pte);
|
|
|
|
/**
|
|
* Retrieve number of children of transaction element.
|
|
* @param te transaction element
|
|
* @return tree index
|
|
*/
|
|
int rpmteDegree(rpmte te);
|
|
|
|
/**
|
|
* Set number of children of transaction element.
|
|
* @param te transaction element
|
|
* @param ndegree new number of children
|
|
* @return previous number of children
|
|
*/
|
|
int rpmteSetDegree(rpmte te, int ndegree);
|
|
|
|
/**
|
|
* Retrieve tsort info for transaction element.
|
|
* @param te transaction element
|
|
* @return tsort info
|
|
*/
|
|
tsortInfo rpmteTSI(rpmte te);
|
|
|
|
/**
|
|
* Destroy tsort info of transaction element.
|
|
* @param te transaction element
|
|
*/
|
|
void rpmteFreeTSI(rpmte te);
|
|
|
|
/**
|
|
* Initialize tsort info of transaction element.
|
|
* @param te transaction element
|
|
*/
|
|
void rpmteNewTSI(rpmte te);
|
|
|
|
/**
|
|
* Destroy dependency set info of transaction element.
|
|
* @param te transaction element
|
|
*/
|
|
void rpmteCleanDS(rpmte te);
|
|
|
|
/**
|
|
* Retrieve pkgKey of TR_ADDED transaction element.
|
|
* @param te transaction element
|
|
* @return pkgKey
|
|
*/
|
|
rpmalKey rpmteAddedKey(rpmte te);
|
|
|
|
/**
|
|
* Set pkgKey of TR_ADDED transaction element.
|
|
* @param te transaction element
|
|
* @param npkgKey new pkgKey
|
|
* @return previous pkgKey
|
|
*/
|
|
rpmalKey rpmteSetAddedKey(rpmte te,
|
|
rpmalKey npkgKey);
|
|
|
|
/**
|
|
* Retrieve dependent pkgKey of TR_REMOVED transaction element.
|
|
* @param te transaction element
|
|
* @return dependent pkgKey
|
|
*/
|
|
rpmalKey rpmteDependsOnKey(rpmte te);
|
|
|
|
/**
|
|
* Retrieve rpmdb instance of TR_REMOVED transaction element.
|
|
* @param te transaction element
|
|
* @return rpmdb instance
|
|
*/
|
|
int rpmteDBOffset(rpmte te);
|
|
|
|
/**
|
|
* Retrieve name-version-release string from transaction element.
|
|
* @param te transaction element
|
|
* @return name-version-release string
|
|
*/
|
|
extern const char * rpmteNEVR(rpmte te);
|
|
|
|
/**
|
|
* Retrieve name-version-release.arch string from transaction element.
|
|
* @param te transaction element
|
|
* @return name-version-release.arch string
|
|
*/
|
|
extern const char * rpmteNEVRA(rpmte te);
|
|
|
|
/**
|
|
* Retrieve file handle from transaction element.
|
|
* @param te transaction element
|
|
* @return file handle
|
|
*/
|
|
FD_t rpmteFd(rpmte te);
|
|
|
|
/**
|
|
* Retrieve key from transaction element.
|
|
* @param te transaction element
|
|
* @return key
|
|
*/
|
|
fnpyKey rpmteKey(rpmte te);
|
|
|
|
/**
|
|
* Retrieve dependency tag set from transaction element.
|
|
* @param te transaction element
|
|
* @param tag dependency tag
|
|
* @return dependency tag set
|
|
*/
|
|
rpmds rpmteDS(rpmte te, rpmTag tag);
|
|
|
|
/**
|
|
* Retrieve file info tag set from transaction element.
|
|
* @param te transaction element
|
|
* @param tag file info tag (RPMTAG_BASENAMES)
|
|
* @return file info tag set
|
|
*/
|
|
rpmfi rpmteFI(rpmte te, rpmTag tag);
|
|
|
|
/**
|
|
* Calculate transaction element dependency colors/refs from file info.
|
|
* @param te transaction element
|
|
* @param tag dependency tag (RPMTAG_PROVIDENAME, RPMTAG_REQUIRENAME)
|
|
*/
|
|
void rpmteColorDS(rpmte te, rpmTag tag);
|
|
|
|
/**
|
|
* Return transaction element index.
|
|
* @param tsi transaction element iterator
|
|
* @return transaction element index
|
|
*/
|
|
int rpmtsiOc(rpmtsi tsi);
|
|
|
|
/**
|
|
* Destroy transaction element iterator.
|
|
* @param tsi transaction element iterator
|
|
* @return NULL always
|
|
*/
|
|
rpmtsi rpmtsiFree(rpmtsi tsi);
|
|
|
|
/**
|
|
* Destroy transaction element iterator.
|
|
* @param tsi transaction element iterator
|
|
* @param fn
|
|
* @param ln
|
|
* @return NULL always
|
|
*/
|
|
rpmtsi XrpmtsiFree(rpmtsi tsi,
|
|
const char * fn, unsigned int ln);
|
|
#define rpmtsiFree(_tsi) XrpmtsiFree(_tsi, __FILE__, __LINE__)
|
|
|
|
/**
|
|
* Create transaction element iterator.
|
|
* @param ts transaction set
|
|
* @return transaction element iterator
|
|
*/
|
|
rpmtsi rpmtsiInit(rpmts ts);
|
|
|
|
/**
|
|
* Create transaction element iterator.
|
|
* @param ts transaction set
|
|
* @param fn
|
|
* @param ln
|
|
* @return transaction element iterator
|
|
*/
|
|
rpmtsi XrpmtsiInit(rpmts ts,
|
|
const char * fn, unsigned int ln);
|
|
#define rpmtsiInit(_ts) XrpmtsiInit(_ts, __FILE__, __LINE__)
|
|
|
|
/**
|
|
* Return next transaction element of type.
|
|
* @param tsi transaction element iterator
|
|
* @param type transaction element type selector (0 for any)
|
|
* @return next transaction element of type, NULL on termination
|
|
*/
|
|
rpmte rpmtsiNext(rpmtsi tsi, rpmElementType type);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* H_RPMTE */
|