rpmts.h

Go to the documentation of this file.

#ifndef H_RPMTS
#define H_RPMTS

 
#include <sys/types.h>
 
#include <rpm/rpmtypes.h>
#include <rpm/rpmte.h>
#include <rpm/rpmps.h>
#include <rpm/rpmsw.h>
#include <rpm/rpmfi.h>
#include <rpm/rpmcallback.h>
#include <rpm/rpmkeyring.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
RPM_PUBLIC_API
extern int _rpmts_stats;

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),    
    /* bits 11-13 unused */
    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),    
    /* bit 28 unused */
    RPMTRANS_FLAG_NOARTIFACTS   = (1 << 29),    
    RPMTRANS_FLAG_NOCONFIGS = (1 << 30),    
    RPMTRANS_FLAG_DEPLOOPS  = (1U << 31)    
};
 
typedef rpmFlags rpmtransFlags;
 
#define _noTransScripts     \
  ( RPMTRANS_FLAG_NOPRE |   \
    RPMTRANS_FLAG_NOPOST |  \
    RPMTRANS_FLAG_NOPREUN | \
    RPMTRANS_FLAG_NOPOSTUN |    \
    RPMTRANS_FLAG_NOPRETRANS |  \
    RPMTRANS_FLAG_NOPOSTTRANS | \
    RPMTRANS_FLAG_NOPREUNTRANS |\
    RPMTRANS_FLAG_NOPOSTUNTRANS \
  )
 
#define _noTransTriggers    \
  ( RPMTRANS_FLAG_NOTRIGGERPREIN | \
    RPMTRANS_FLAG_NOTRIGGERIN | \
    RPMTRANS_FLAG_NOTRIGGERUN | \
    RPMTRANS_FLAG_NOTRIGGERPOSTUN \
  )
 
/* Avoid unnecessary breakage for stuff referring to these unused flags */
#define RPMTRANS_FLAG_NOPAYLOAD 0
#define RPMTRANS_FLAG_APPLYONLY 0
#define RPMTRANS_FLAG_KEEPOBSOLETE 0
#define RPMTRANS_FLAG_DIRSTASH 0
#define RPMTRANS_FLAG_REPACKAGE 0
#define RPMTRANS_FLAG_PKGCOMMIT 0
#define RPMTRANS_FLAG_PKGUNDO 0
#define RPMTRANS_FLAG_COMMIT 0
#define RPMTRANS_FLAG_UNDO 0
#define RPMTRANS_FLAG_REVERSE 0
#define RPMTRANS_FLAG_NOSUGGEST 0
#define RPMTRANS_FLAG_ADDINDEPS 0

enum rpmVSFlags_e {
    RPMVSF_DEFAULT  = 0,
    RPMVSF_NOHDRCHK = (1 <<  0),
    RPMVSF_NEEDPAYLOAD  = (1 <<  1),
    /* bit(s) 2-7 unused */
    RPMVSF_NOSHA1HEADER = (1 <<  8),
    RPMVSF_NOSHA256HEADER = (1 <<  9),
    RPMVSF_NODSAHEADER  = (1 << 10),
    RPMVSF_NORSAHEADER  = (1 << 11),
    RPMVSF_NOOPENPGP    = (1 << 12),
    RPMVSF_NOSHA3_256HEADER = (1 << 13),
    RPMVSF_NOSHA512PAYLOAD = (1 << 14),
    RPMVSF_NOSHA3_256PAYLOAD = (1 << 15),
    RPMVSF_NOSHA256PAYLOAD = (1 << 16),
    RPMVSF_NOMD5    = (1 << 17),
    RPMVSF_NODSA    = (1 << 18),
    RPMVSF_NORSA    = (1 << 19)
    /* bit(s) 16-31 unused */
};
 
typedef rpmFlags rpmVSFlags;
 
#define RPMVSF_NOPAYLOAD    \
  ( RPMVSF_NOSHA3_256PAYLOAD |  \
    RPMVSF_NOSHA512PAYLOAD |    \
    RPMVSF_NOSHA256PAYLOAD )
 
#define RPMVSF_MASK_NODIGESTS   \
  ( RPMVSF_NOSHA1HEADER |   \
    RPMVSF_NOSHA256HEADER | \
    RPMVSF_NOSHA256PAYLOAD |    \
    RPMVSF_NOSHA512PAYLOAD |    \
    RPMVSF_NOSHA3_256PAYLOAD |  \
    RPMVSF_NOSHA3_256HEADER |   \
    RPMVSF_NOMD5 )
#define _RPMVSF_NODIGESTS   RPMVSF_MASK_NODIGESTS
 
#define RPMVSF_MASK_NOSIGNATURES    \
  ( RPMVSF_NODSAHEADER |    \
    RPMVSF_NORSAHEADER |    \
    RPMVSF_NOOPENPGP |  \
    RPMVSF_NODSA |      \
    RPMVSF_NORSA )
#define _RPMVSF_NOSIGNATURES    RPMVSF_MASK_NOSIGNATURES
 
#define RPMVSF_MASK_NOHEADER    \
  ( RPMVSF_NOSHA1HEADER |   \
    RPMVSF_NOSHA256HEADER | \
    RPMVSF_NOSHA3_256HEADER |   \
    RPMVSF_NOOPENPGP |      \
    RPMVSF_NODSAHEADER |    \
    RPMVSF_NORSAHEADER )
#define _RPMVSF_NOHEADER    RPMVSF_MASK_NOHEADER
 
#define RPMVSF_MASK_NOPAYLOAD   \
  ( RPMVSF_NOMD5 |      \
    RPMVSF_NOSHA256PAYLOAD |    \
    RPMVSF_NOSHA512PAYLOAD |    \
    RPMVSF_NOSHA3_256PAYLOAD |  \
    RPMVSF_NODSA |      \
    RPMVSF_NORSA )
#define _RPMVSF_NOPAYLOAD   RPMVSF_MASK_NOPAYLOAD
 
enum {
    RPMSIG_NONE_TYPE        = 0,
    RPMSIG_DIGEST_TYPE      = (1 << 0),
    RPMSIG_SIGNATURE_TYPE   = (1 << 1),
    RPMSIG_OTHER_TYPE       = (1 << 2),
};
 
#define RPMSIG_VERIFIABLE_TYPE (RPMSIG_DIGEST_TYPE|RPMSIG_SIGNATURE_TYPE)
#define RPMSIG_UNVERIFIED_TYPE  (1 << 30)

typedef 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
} rpmtsOpX;
 
enum rpmtxnFlags_e {
    RPMTXN_READ     = (1 << 0),
    RPMTXN_WRITE    = (1 << 1),
};
typedef rpmFlags rpmtxnFlags;
 
typedef enum rpmtsEvent_e {
    RPMTS_EVENT_ADD     = 1,
    RPMTS_EVENT_DEL     = 2,
} rpmtsEvent;

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

RPM_PUBLIC_API
int rpmtsCheck(rpmts ts);

RPM_PUBLIC_API
int rpmtsOrder(rpmts ts);

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

RPM_PUBLIC_API
rpmts rpmtsLink (rpmts ts);

RPM_PUBLIC_API
int rpmtsCloseDB(rpmts ts);

RPM_PUBLIC_API
int rpmtsOpenDB(rpmts ts, int dbmode);

RPM_PUBLIC_API
int rpmtsInitDB(rpmts ts, int perms);

RPM_PUBLIC_API
int rpmtsGetDBMode(rpmts ts);

RPM_PUBLIC_API
int rpmtsSetDBMode(rpmts ts, int dbmode);

RPM_PUBLIC_API
int rpmtsRebuildDB(rpmts ts);

RPM_PUBLIC_API
int rpmtsParkDB(rpmts ts);

RPM_PUBLIC_API
int rpmtsVerifyDB(rpmts ts);

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

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

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

RPM_PUBLIC_API
rpmRC rpmtxnImportPubkey(rpmtxn kxn, const unsigned char * pkt, size_t pktlen);

RPM_PUBLIC_API
rpmRC rpmtxnDeletePubkey(rpmtxn kxn, rpmPubkey key);

RPM_PUBLIC_API
rpmRC rpmtxnRebuildKeystore(rpmtxn kxn, const char * from);

RPM_PUBLIC_API
rpmKeyring rpmtsGetKeyring(rpmts ts, int autoload);

RPM_PUBLIC_API
int rpmtsSetKeyring(rpmts ts, rpmKeyring keyring);

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

RPM_PUBLIC_API
rpmps rpmtsProblems(rpmts ts);

RPM_PUBLIC_API
void rpmtsCleanProblems(rpmts ts);

RPM_PUBLIC_API
void rpmtsClean(rpmts ts);

RPM_PUBLIC_API
void rpmtsEmpty(rpmts ts);

RPM_PUBLIC_API
rpmts rpmtsFree(rpmts ts);

RPM_PUBLIC_API
rpmVSFlags rpmtsVSFlags(rpmts ts);

RPM_PUBLIC_API
rpmVSFlags rpmtsSetVSFlags(rpmts ts, rpmVSFlags vsflags);

RPM_PUBLIC_API
rpmVSFlags rpmtsVfyFlags(rpmts ts);

RPM_PUBLIC_API
rpmVSFlags rpmtsSetVfyFlags(rpmts ts, rpmVSFlags vfyflags);

RPM_PUBLIC_API
int rpmtsVfyLevel(rpmts ts);

RPM_PUBLIC_API
int rpmtsSetVfyLevel(rpmts ts, int vfylevel);

RPM_PUBLIC_API
const char * rpmtsRootDir(rpmts ts);

RPM_PUBLIC_API
int rpmtsSetRootDir(rpmts ts, const char * rootDir);

RPM_PUBLIC_API
FD_t rpmtsScriptFd(rpmts ts);

RPM_PUBLIC_API
void rpmtsSetScriptFd(rpmts ts, FD_t scriptFd);

RPM_PUBLIC_API
rpm_tid_t rpmtsGetTid(rpmts ts);

RPM_PUBLIC_API
rpm_tid_t rpmtsSetTid(rpmts ts, rpm_tid_t tid);

RPM_PUBLIC_API
rpmdb rpmtsGetRdb(rpmts ts);

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

RPM_PUBLIC_API
int rpmtsNElements(rpmts ts);

RPM_PUBLIC_API
rpmte rpmtsElement(rpmts ts, int ix);

RPM_PUBLIC_API
rpmprobFilterFlags rpmtsFilterFlags(rpmts ts);

RPM_PUBLIC_API
rpmtransFlags rpmtsFlags(rpmts ts);

RPM_PUBLIC_API
rpmtransFlags rpmtsSetFlags(rpmts ts, rpmtransFlags transFlags);

RPM_PUBLIC_API
rpm_color_t rpmtsColor(rpmts ts);

RPM_PUBLIC_API
rpm_color_t rpmtsPrefColor(rpmts ts);

RPM_PUBLIC_API
rpm_color_t rpmtsSetColor(rpmts ts, rpm_color_t color);

RPM_PUBLIC_API
rpm_color_t rpmtsSetPrefColor(rpmts ts, rpm_color_t color);

RPM_PUBLIC_API
rpmop rpmtsOp(rpmts ts, rpmtsOpX opx);

RPM_PUBLIC_API
rpmPlugins rpmtsPlugins(rpmts ts);

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

RPM_PUBLIC_API
int rpmtsSetNotifyStyle(rpmts ts, int style);

RPM_PUBLIC_API
int rpmtsGetNotifyStyle(rpmts ts);

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

RPM_PUBLIC_API
rpmts rpmtsCreate(void);

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

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

RPM_PUBLIC_API
int rpmtsAddRestoreElement(rpmts ts, Header h);

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

RPM_PUBLIC_API
rpmtxn rpmkxnBegin(rpmts ts, rpmtxnFlags flags);

RPM_PUBLIC_API
rpmtxn rpmtxnBegin(rpmts ts, rpmtxnFlags flags);

RPM_PUBLIC_API
rpmtxn rpmtxnEnd(rpmtxn txn);

RPM_PUBLIC_API
rpmtsi rpmtsiFree(rpmtsi tsi);

RPM_PUBLIC_API
rpmtsi rpmtsiInit(rpmts ts);

RPM_PUBLIC_API
rpmte rpmtsiNext(rpmtsi tsi, rpmElementTypes types);
 
#ifdef __cplusplus
}
#endif
 
 
#endif  /* H_RPMTS */