lib/rpmlib.h

Go to the documentation of this file.

#ifndef H_RPMLIB
#define H_RPMLIB

#include "rpmio.h"
#include "rpmmessages.h"
#include "rpmerr.h"
#include "header.h"
#include "popt.h"

typedef enum rpmRC_e {
    RPMRC_OK            = 0,    
    RPMRC_NOTFOUND      = 1,    
    RPMRC_FAIL          = 2,    
    RPMRC_NOTTRUSTED    = 3,    
    RPMRC_NOKEY         = 4     
} rpmRC;

/*@-redecl@*/
/*@checked@*/
extern struct MacroContext_s * rpmGlobalMacroContext;

/*@checked@*/
extern struct MacroContext_s * rpmCLIMacroContext;

/*@unchecked@*/ /*@observer@*/
extern const char * RPMVERSION;

/*@unchecked@*/ /*@observer@*/
extern const char * rpmNAME;

/*@unchecked@*/ /*@observer@*/
extern const char * rpmEVR;

/*@unchecked@*/
extern int rpmFLAGS;
/*@=redecl@*/

#ifdef __cplusplus
extern "C" {
#endif

/*@unused@*/ static inline /*@null@*/
void * _free(/*@only@*/ /*@null@*/ /*@out@*/ const void * p)
        /*@modifies p @*/
{
    if (p != NULL)      free((void *)p);
    return NULL;
}

typedef /*@abstract@*/ /*@refcounted@*/ struct rpmts_s * rpmts;

typedef struct Spec_s * Spec;

typedef /*@abstract@*/ void * alKey;
#define RPMAL_NOMATCH   ((alKey)-1L)

/*@-mutrep@*/
typedef /*@abstract@*/ int alNum;
/*@=mutrep@*/

typedef /*@abstract@*/ /*@refcounted@*/ struct rpmds_s * rpmds;

typedef /*@abstract@*/ /*@refcounted@*/ struct rpmfi_s * rpmfi;

typedef /*@abstract@*/ struct rpmte_s * rpmte;

typedef /*@abstract@*/ /*@refcounted@*/ struct rpmdb_s * rpmdb;

typedef /*@abstract@*/ struct _rpmdbMatchIterator * rpmdbMatchIterator;

typedef /*@abstract@*/ /*@refcounted@*/ struct rpmgi_s * rpmgi;

int headerNVR(Header h,
                /*@null@*/ /*@out@*/ const char ** np,
                /*@null@*/ /*@out@*/ const char ** vp,
                /*@null@*/ /*@out@*/ const char ** rp)
        /*@modifies *np, *vp, *rp @*/;

int headerNEVRA(Header h,
                /*@null@*/ /*@out@*/ const char ** np,
                /*@null@*/ /*@out@*/ /*@unused@*/ const char ** ep,
                /*@null@*/ /*@out@*/ const char ** vp,
                /*@null@*/ /*@out@*/ const char ** rp,
                /*@null@*/ /*@out@*/ const char ** ap)
        /*@modifies *np, *vp, *rp, *ap @*/;

void headerMergeLegacySigs(Header h, const Header sigh)
        /*@modifies h, sigh @*/;

Header headerRegenSigHeader(const Header h, int noArchiveSize)
        /*@modifies h @*/;

/*@unused@*/
int rpmHeaderGetEntry(Header h, int_32 tag, /*@out@*/ int_32 *type,
                /*@out@*/ void **p, /*@out@*/ int_32 *c)
        /*@modifies *type, *p, *c @*/;

/*@-redecl@*/
/*@observer@*/ /*@unchecked@*/
extern const struct headerTagTableEntry_s * rpmTagTable;
/*@=redecl@*/

/*@-redecl@*/
/*@unchecked@*/
extern const int rpmTagTableSize;
/*@=redecl@*/

/*@-redecl@*/
/*@unchecked@*/
extern const struct headerSprintfExtension_s rpmHeaderFormats[];
/*@=redecl@*/

#define RPMDBI_PACKAGES         0       /* Installed package headers. */
#define RPMDBI_DEPENDS          1       /* Dependency resolution cache. */
#define RPMDBI_LABEL            2       /* Fingerprint search marker. */
#define RPMDBI_ADDED            3       /* Added package headers. */
#define RPMDBI_REMOVED          4       /* Removed package headers. */
#define RPMDBI_AVAILABLE        5       /* Available package headers. */
#define RPMDBI_HDLIST           6       /* (rpmgi) Header list. */
#define RPMDBI_ARGLIST          7       /* (rpmgi) Argument list. */
#define RPMDBI_FTSWALK          8       /* (rpmgi) File tree  walk. */

typedef enum rpmTag_e {

    RPMTAG_HEADERIMAGE          = HEADER_IMAGE,         
    RPMTAG_HEADERSIGNATURES     = HEADER_SIGNATURES,    
    RPMTAG_HEADERIMMUTABLE      = HEADER_IMMUTABLE,     
/*@-enummemuse@*/
    RPMTAG_HEADERREGIONS        = HEADER_REGIONS,       
    RPMTAG_HEADERI18NTABLE      = HEADER_I18NTABLE, 
/*@=enummemuse@*/

/* Retrofit (and uniqify) signature tags for use by tagName() and rpmQuery. */
/* the md5 sum was broken *twice* on big endian machines */
/* XXX 2nd underscore prevents tagTable generation */
    RPMTAG_SIG_BASE             = HEADER_SIGBASE,
    RPMTAG_SIGSIZE              = RPMTAG_SIG_BASE+1,    /* i */
    RPMTAG_SIGLEMD5_1           = RPMTAG_SIG_BASE+2,    
    RPMTAG_SIGPGP               = RPMTAG_SIG_BASE+3,    /* x */
    RPMTAG_SIGLEMD5_2           = RPMTAG_SIG_BASE+4,    
    RPMTAG_SIGMD5               = RPMTAG_SIG_BASE+5,    /* x */
#define RPMTAG_PKGID    RPMTAG_SIGMD5                   /* x */
    RPMTAG_SIGGPG               = RPMTAG_SIG_BASE+6,    /* x */
    RPMTAG_SIGPGP5              = RPMTAG_SIG_BASE+7,    
    RPMTAG_BADSHA1_1            = RPMTAG_SIG_BASE+8,    
    RPMTAG_BADSHA1_2            = RPMTAG_SIG_BASE+9,    
    RPMTAG_PUBKEYS              = RPMTAG_SIG_BASE+10,   /* s[] */
    RPMTAG_DSAHEADER            = RPMTAG_SIG_BASE+11,   /* x */
    RPMTAG_RSAHEADER            = RPMTAG_SIG_BASE+12,   /* x */
    RPMTAG_SHA1HEADER           = RPMTAG_SIG_BASE+13,   /* s */
#define RPMTAG_HDRID    RPMTAG_SHA1HEADER       /* s */

    RPMTAG_NAME                 = 1000, /* s */
#define RPMTAG_N        RPMTAG_NAME     /* s */
    RPMTAG_VERSION              = 1001, /* s */
#define RPMTAG_V        RPMTAG_VERSION  /* s */
    RPMTAG_RELEASE              = 1002, /* s */
#define RPMTAG_R        RPMTAG_RELEASE  /* s */
    RPMTAG_EPOCH                = 1003, /* i */
#define RPMTAG_E        RPMTAG_EPOCH    /* i */
#define RPMTAG_SERIAL   RPMTAG_EPOCH    /* i backward comaptibility */
    RPMTAG_SUMMARY              = 1004, /* s{} */
    RPMTAG_DESCRIPTION          = 1005, /* s{} */
    RPMTAG_BUILDTIME            = 1006, /* i */
    RPMTAG_BUILDHOST            = 1007, /* s */
    RPMTAG_INSTALLTIME          = 1008, /* i */
    RPMTAG_SIZE                 = 1009, /* i */
    RPMTAG_DISTRIBUTION         = 1010, /* s */
    RPMTAG_VENDOR               = 1011, /* s */
    RPMTAG_GIF                  = 1012, /* x */
    RPMTAG_XPM                  = 1013, /* x */
    RPMTAG_LICENSE              = 1014, /* s */
#define RPMTAG_COPYRIGHT RPMTAG_LICENSE /* s backward comaptibility */
    RPMTAG_PACKAGER             = 1015, /* s */
    RPMTAG_GROUP                = 1016, /* s{} */
/*@-enummemuse@*/
    RPMTAG_CHANGELOG            = 1017, 
/*@=enummemuse@*/
    RPMTAG_SOURCE               = 1018, /* s[] */
    RPMTAG_PATCH                = 1019, /* s[] */
    RPMTAG_URL                  = 1020, /* s */
    RPMTAG_OS                   = 1021, /* s legacy used int */
    RPMTAG_ARCH                 = 1022, /* s legacy used int */
    RPMTAG_PREIN                = 1023, /* s */
    RPMTAG_POSTIN               = 1024, /* s */
    RPMTAG_PREUN                = 1025, /* s */
    RPMTAG_POSTUN               = 1026, /* s */
    RPMTAG_OLDFILENAMES         = 1027, /* s[] obsolete */
    RPMTAG_FILESIZES            = 1028, /* i */
    RPMTAG_FILESTATES           = 1029, /* c */
    RPMTAG_FILEMODES            = 1030, /* h */
    RPMTAG_FILEUIDS             = 1031, 
    RPMTAG_FILEGIDS             = 1032, 
    RPMTAG_FILERDEVS            = 1033, /* h */
    RPMTAG_FILEMTIMES           = 1034, /* i */
    RPMTAG_FILEMD5S             = 1035, /* s[] */
    RPMTAG_FILELINKTOS          = 1036, /* s[] */
    RPMTAG_FILEFLAGS            = 1037, /* i */
/*@-enummemuse@*/
    RPMTAG_ROOT                 = 1038, 
/*@=enummemuse@*/
    RPMTAG_FILEUSERNAME         = 1039, /* s[] */
    RPMTAG_FILEGROUPNAME        = 1040, /* s[] */
/*@-enummemuse@*/
    RPMTAG_EXCLUDE              = 1041, 
    RPMTAG_EXCLUSIVE            = 1042, 
/*@=enummemuse@*/
    RPMTAG_ICON                 = 1043,
    RPMTAG_SOURCERPM            = 1044, /* s */
    RPMTAG_FILEVERIFYFLAGS      = 1045, /* i */
    RPMTAG_ARCHIVESIZE          = 1046, /* i */
    RPMTAG_PROVIDENAME          = 1047, /* s[] */
#define RPMTAG_PROVIDES RPMTAG_PROVIDENAME      /* s[] */
#define RPMTAG_P        RPMTAG_PROVIDENAME      /* s[] */
    RPMTAG_REQUIREFLAGS         = 1048, /* i */
    RPMTAG_REQUIRENAME          = 1049, /* s[] */
#define RPMTAG_REQUIRES RPMTAG_REQUIRENAME      /* s[] */
#define RPMTAG_D        RPMTAG_REQUIRENAME      /* s[] */
    RPMTAG_REQUIREVERSION       = 1050, /* s[] */
    RPMTAG_NOSOURCE             = 1051, 
    RPMTAG_NOPATCH              = 1052, 
    RPMTAG_CONFLICTFLAGS        = 1053, /* i */
    RPMTAG_CONFLICTNAME         = 1054, /* s[] */
#define RPMTAG_CONFLICTS RPMTAG_CONFLICTNAME    /* s[] */
#define RPMTAG_C        RPMTAG_CONFLICTNAME     /* s[] */
    RPMTAG_CONFLICTVERSION      = 1055, /* s[] */
    RPMTAG_DEFAULTPREFIX        = 1056, 
    RPMTAG_BUILDROOT            = 1057, 
    RPMTAG_INSTALLPREFIX        = 1058, 
    RPMTAG_EXCLUDEARCH          = 1059,
    RPMTAG_EXCLUDEOS            = 1060,
    RPMTAG_EXCLUSIVEARCH        = 1061,
    RPMTAG_EXCLUSIVEOS          = 1062,
    RPMTAG_AUTOREQPROV          = 1063, 
    RPMTAG_RPMVERSION           = 1064, /* s */
    RPMTAG_TRIGGERSCRIPTS       = 1065, /* s[] */
    RPMTAG_TRIGGERNAME          = 1066, /* s[] */
    RPMTAG_TRIGGERVERSION       = 1067, /* s[] */
    RPMTAG_TRIGGERFLAGS         = 1068, /* i */
    RPMTAG_TRIGGERINDEX         = 1069, /* i */
    RPMTAG_VERIFYSCRIPT         = 1079, /* s */
    RPMTAG_CHANGELOGTIME        = 1080, /* i */
    RPMTAG_CHANGELOGNAME        = 1081, /* s[] */
    RPMTAG_CHANGELOGTEXT        = 1082, /* s[] */
/*@-enummemuse@*/
    RPMTAG_BROKENMD5            = 1083, 
/*@=enummemuse@*/
    RPMTAG_PREREQ               = 1084, 
    RPMTAG_PREINPROG            = 1085, /* s */
    RPMTAG_POSTINPROG           = 1086, /* s */
    RPMTAG_PREUNPROG            = 1087, /* s */
    RPMTAG_POSTUNPROG           = 1088, /* s */
    RPMTAG_BUILDARCHS           = 1089,
    RPMTAG_OBSOLETENAME         = 1090, /* s[] */
#define RPMTAG_OBSOLETES RPMTAG_OBSOLETENAME    /* s[] */
#define RPMTAG_O        RPMTAG_OBSOLETENAME     /* s[] */
    RPMTAG_VERIFYSCRIPTPROG     = 1091, /* s */
    RPMTAG_TRIGGERSCRIPTPROG    = 1092, /* s */
    RPMTAG_DOCDIR               = 1093, 
    RPMTAG_COOKIE               = 1094, /* s */
    RPMTAG_FILEDEVICES          = 1095, /* i */
    RPMTAG_FILEINODES           = 1096, /* i */
    RPMTAG_FILELANGS            = 1097, /* s[] */
    RPMTAG_PREFIXES             = 1098, /* s[] */
    RPMTAG_INSTPREFIXES         = 1099, /* s[] */
    RPMTAG_TRIGGERIN            = 1100, 
    RPMTAG_TRIGGERUN            = 1101, 
    RPMTAG_TRIGGERPOSTUN        = 1102, 
    RPMTAG_AUTOREQ              = 1103, 
    RPMTAG_AUTOPROV             = 1104, 
/*@-enummemuse@*/
    RPMTAG_CAPABILITY           = 1105, 
/*@=enummemuse@*/
    RPMTAG_SOURCEPACKAGE        = 1106, 
/*@-enummemuse@*/
    RPMTAG_OLDORIGFILENAMES     = 1107, 
/*@=enummemuse@*/
    RPMTAG_BUILDPREREQ          = 1108, 
    RPMTAG_BUILDREQUIRES        = 1109, 
    RPMTAG_BUILDCONFLICTS       = 1110, 
/*@-enummemuse@*/
    RPMTAG_BUILDMACROS          = 1111, 
/*@=enummemuse@*/
    RPMTAG_PROVIDEFLAGS         = 1112, /* i */
    RPMTAG_PROVIDEVERSION       = 1113, /* s[] */
    RPMTAG_OBSOLETEFLAGS        = 1114, /* i */
    RPMTAG_OBSOLETEVERSION      = 1115, /* s[] */
    RPMTAG_DIRINDEXES           = 1116, /* i */
    RPMTAG_BASENAMES            = 1117, /* s[] */
    RPMTAG_DIRNAMES             = 1118, /* s[] */
    RPMTAG_ORIGDIRINDEXES       = 1119, 
    RPMTAG_ORIGBASENAMES        = 1120, 
    RPMTAG_ORIGDIRNAMES         = 1121, 
    RPMTAG_OPTFLAGS             = 1122, /* s */
    RPMTAG_DISTURL              = 1123, /* s */
    RPMTAG_PAYLOADFORMAT        = 1124, /* s */
    RPMTAG_PAYLOADCOMPRESSOR    = 1125, /* s */
    RPMTAG_PAYLOADFLAGS         = 1126, /* s */
    RPMTAG_INSTALLCOLOR         = 1127, 
    RPMTAG_INSTALLTID           = 1128, /* i */
    RPMTAG_REMOVETID            = 1129, /* i */
/*@-enummemuse@*/
    RPMTAG_SHA1RHN              = 1130, 
/*@=enummemuse@*/
    RPMTAG_RHNPLATFORM          = 1131, /* s */
    RPMTAG_PLATFORM             = 1132, /* s */
    RPMTAG_PATCHESNAME          = 1133, 
    RPMTAG_PATCHESFLAGS         = 1134, 
    RPMTAG_PATCHESVERSION       = 1135, 
    RPMTAG_CACHECTIME           = 1136, /* i */
    RPMTAG_CACHEPKGPATH         = 1137, /* s */
    RPMTAG_CACHEPKGSIZE         = 1138, /* i */
    RPMTAG_CACHEPKGMTIME        = 1139, /* i */
    RPMTAG_FILECOLORS           = 1140, /* i */
    RPMTAG_FILECLASS            = 1141, /* i */
    RPMTAG_CLASSDICT            = 1142, /* s[] */
    RPMTAG_FILEDEPENDSX         = 1143, /* i */
    RPMTAG_FILEDEPENDSN         = 1144, /* i */
    RPMTAG_DEPENDSDICT          = 1145, /* i */
    RPMTAG_SOURCEPKGID          = 1146, /* x */
    RPMTAG_FILECONTEXTS         = 1147, /* s[] */
    RPMTAG_FSCONTEXTS           = 1148, 
    RPMTAG_RECONTEXTS           = 1149, 
    RPMTAG_POLICIES             = 1150, 
    RPMTAG_PRETRANS             = 1151, /* s */
    RPMTAG_POSTTRANS            = 1152, /* s */
    RPMTAG_PRETRANSPROG         = 1153, /* s */
    RPMTAG_POSTTRANSPROG        = 1154, /* s */
    RPMTAG_DISTTAG              = 1155, /* s */
    RPMTAG_SUGGESTSNAME         = 1156, /* s[] extension placeholder */
    RPMTAG_SUGGESTSVERSION      = 1157, /* s[] extension placeholder */
    RPMTAG_SUGGESTSFLAGS        = 1158, /* i   extension placeholder */
    RPMTAG_ENHANCESNAME         = 1159, /* s[] extension placeholder */
    RPMTAG_ENHANCESVERSION      = 1160, /* s[] extension placeholder */
    RPMTAG_ENHANCESFLAGS        = 1161, /* i   extension placeholder */
    RPMTAG_PRIORITY             = 1162, /* i   extension placeholder */
    RPMTAG_CVSID                = 1163, /* s */
#define RPMTAG_SVNID    RPMTAG_CVSID    /* s */

/*@-enummemuse@*/
    RPMTAG_FIRSTFREE_TAG        
/*@=enummemuse@*/
} rpmTag;

#define RPMTAG_EXTERNAL_TAG             1000000

typedef enum rpmfileState_e {
    RPMFILE_STATE_NORMAL        = 0,
    RPMFILE_STATE_REPLACED      = 1,
    RPMFILE_STATE_NOTINSTALLED  = 2,
    RPMFILE_STATE_NETSHARED     = 3,
    RPMFILE_STATE_WRONGCOLOR    = 4
} rpmfileState;
#define RPMFILE_STATE_MISSING   -1      /* XXX used for unavailable data */

typedef enum rpmfileAttrs_e {
/*@-enummemuse@*/
    RPMFILE_NONE        = 0,
/*@=enummemuse@*/
    RPMFILE_CONFIG      = (1 <<  0),    
    RPMFILE_DOC         = (1 <<  1),    
    RPMFILE_ICON        = (1 <<  2),    
    RPMFILE_MISSINGOK   = (1 <<  3),    
    RPMFILE_NOREPLACE   = (1 <<  4),    
    RPMFILE_SPECFILE    = (1 <<  5),    
    RPMFILE_GHOST       = (1 <<  6),    
    RPMFILE_LICENSE     = (1 <<  7),    
    RPMFILE_README      = (1 <<  8),    
    RPMFILE_EXCLUDE     = (1 <<  9),    
    RPMFILE_UNPATCHED   = (1 << 10),    
    RPMFILE_PUBKEY      = (1 << 11),    
    RPMFILE_POLICY      = (1 << 12)     
} rpmfileAttrs;

#define RPMFILE_ALL     ~(RPMFILE_NONE)

typedef enum rpmsenseFlags_e {
    RPMSENSE_ANY        = 0,
/*@-enummemuse@*/
    RPMSENSE_SERIAL     = (1 << 0),     
/*@=enummemuse@*/
    RPMSENSE_LESS       = (1 << 1),
    RPMSENSE_GREATER    = (1 << 2),
    RPMSENSE_EQUAL      = (1 << 3),
    RPMSENSE_PROVIDES   = (1 << 4), /* only used internally by builds */
    RPMSENSE_CONFLICTS  = (1 << 5), /* only used internally by builds */
    RPMSENSE_PREREQ     = (1 << 6),     
    RPMSENSE_OBSOLETES  = (1 << 7), /* only used internally by builds */
    RPMSENSE_INTERP     = (1 << 8),     
    RPMSENSE_SCRIPT_PRE = ((1 << 9)|RPMSENSE_PREREQ), 
    RPMSENSE_SCRIPT_POST = ((1 << 10)|RPMSENSE_PREREQ), 
    RPMSENSE_SCRIPT_PREUN = ((1 << 11)|RPMSENSE_PREREQ), 
    RPMSENSE_SCRIPT_POSTUN = ((1 << 12)|RPMSENSE_PREREQ), 
    RPMSENSE_SCRIPT_VERIFY = (1 << 13), 
    RPMSENSE_FIND_REQUIRES = (1 << 14), 
    RPMSENSE_FIND_PROVIDES = (1 << 15), 
    RPMSENSE_TRIGGERIN  = (1 << 16),    
    RPMSENSE_TRIGGERUN  = (1 << 17),    
    RPMSENSE_TRIGGERPOSTUN = (1 << 18), 
    RPMSENSE_MISSINGOK  = (1 << 19),    
    RPMSENSE_SCRIPT_PREP = (1 << 20),   
    RPMSENSE_SCRIPT_BUILD = (1 << 21),  
    RPMSENSE_SCRIPT_INSTALL = (1 << 22),
    RPMSENSE_SCRIPT_CLEAN = (1 << 23),  
    RPMSENSE_RPMLIB = ((1 << 24) | RPMSENSE_PREREQ), 
/*@-enummemuse@*/
    RPMSENSE_TRIGGERPREIN = (1 << 25),  
/*@=enummemuse@*/
    RPMSENSE_KEYRING    = (1 << 26),
    RPMSENSE_PATCHES    = (1 << 27),
    RPMSENSE_CONFIG     = (1 << 28)
} rpmsenseFlags;

#define RPMSENSE_SENSEMASK      15       /* Mask to get senses, ie serial, */
                                         /* less, greater, equal.          */

#define RPMSENSE_TRIGGER        \
        (RPMSENSE_TRIGGERIN | RPMSENSE_TRIGGERUN | RPMSENSE_TRIGGERPOSTUN)

#define _ALL_REQUIRES_MASK      (\
    RPMSENSE_INTERP | \
    RPMSENSE_SCRIPT_PRE | \
    RPMSENSE_SCRIPT_POST | \
    RPMSENSE_SCRIPT_PREUN | \
    RPMSENSE_SCRIPT_POSTUN | \
    RPMSENSE_SCRIPT_VERIFY | \
    RPMSENSE_FIND_REQUIRES | \
    RPMSENSE_SCRIPT_PREP | \
    RPMSENSE_SCRIPT_BUILD | \
    RPMSENSE_SCRIPT_INSTALL | \
    RPMSENSE_SCRIPT_CLEAN | \
    RPMSENSE_RPMLIB | \
    RPMSENSE_KEYRING )

#define _notpre(_x)             ((_x) & ~RPMSENSE_PREREQ)
#define _INSTALL_ONLY_MASK \
    _notpre(RPMSENSE_SCRIPT_PRE|RPMSENSE_SCRIPT_POST|RPMSENSE_RPMLIB|RPMSENSE_KEYRING)
#define _ERASE_ONLY_MASK  \
    _notpre(RPMSENSE_SCRIPT_PREUN|RPMSENSE_SCRIPT_POSTUN)

#define isLegacyPreReq(_x)  (((_x) & _ALL_REQUIRES_MASK) == RPMSENSE_PREREQ)
#define isInstallPreReq(_x)     ((_x) & _INSTALL_ONLY_MASK)
#define isErasePreReq(_x)       ((_x) & _ERASE_ONLY_MASK)

/* ==================================================================== */

/* Stuff for maintaining "variables" like SOURCEDIR, BUILDDIR, etc */
#define RPMVAR_OPTFLAGS                 3
#define RPMVAR_PROVIDES                 38
#define RPMVAR_INCLUDE                  43
#define RPMVAR_MACROFILES               49

#define RPMVAR_NUM                      55      /* number of RPMVAR entries */

/*@-redecl@*/
/*@observer@*/ /*@null@*/ extern const char * rpmGetVar(int var)
        /*@*/;
/*@=redecl@*/

void rpmSetVar(int var, const char * val)
        /*@globals internalState@*/
        /*@modifies internalState @*/;

enum rpm_machtable_e {
    RPM_MACHTABLE_INSTARCH      = 0,    
    RPM_MACHTABLE_INSTOS        = 1,    
    RPM_MACHTABLE_BUILDARCH     = 2,    
    RPM_MACHTABLE_BUILDOS       = 3     
};
#define RPM_MACHTABLE_COUNT     4       
int rpmReadConfigFiles(/*@null@*/ const char * file,
                /*@null@*/ const char * target)
        /*@globals rpmGlobalMacroContext, rpmCLIMacroContext, h_errno,
                fileSystem, internalState @*/
        /*@modifies rpmGlobalMacroContext, rpmCLIMacroContext,
                fileSystem, internalState @*/;

void rpmGetArchInfo( /*@null@*/ /*@out@*/ const char ** name,
                /*@null@*/ /*@out@*/ int * num)
        /*@modifies *name, *num @*/;

void rpmGetOsInfo( /*@null@*/ /*@out@*/ const char ** name,
                /*@null@*/ /*@out@*/ int * num)
        /*@modifies *name, *num @*/;

int rpmMachineScore(int type, const char * name)
        /*@*/;

int rpmShowRC(FILE * fp)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies *fp, rpmGlobalMacroContext, fileSystem, internalState  @*/;

void rpmSetTables(int archTable, int osTable)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies rpmGlobalMacroContext, fileSystem, internalState @*/;

void rpmSetMachine(/*@null@*/ const char * arch, /*@null@*/ const char * os)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies rpmGlobalMacroContext, fileSystem, internalState @*/;

/*@unused@*/
void rpmGetMachine( /*@null@*/ /*@out@*/ const char **arch,
                /*@null@*/ /*@out@*/ const char **os)
        /*@modifies *arch, *os @*/;

void rpmFreeRpmrc(void)
        /*@globals internalState @*/
        /*@modifies internalState @*/;

/* ==================================================================== */
typedef /*@null@*/
    void * (*HFD_t) (/*@only@*/ /*@null@*/ const void * data, rpmTagType type)
        /*@modifies data @*/;

typedef int (*HGE_t) (Header h, rpmTag tag,
                        /*@null@*/ /*@out@*/ rpmTagType * type,
                        /*@null@*/ /*@out@*/ void ** p,
                        /*@null@*/ /*@out@*/ int_32 * c)
        /*@modifies *type, *p, *c @*/;

typedef int (*HAE_t) (Header h, rpmTag tag, rpmTagType type,
                        const void * p, int_32 c)
        /*@modifies h @*/;

typedef int (*HME_t) (Header h, rpmTag tag, rpmTagType type,
                        const void * p, int_32 c)
        /*@modifies h @*/;

typedef int (*HRE_t) (Header h, int_32 tag)
        /*@modifies h @*/;

typedef enum rpmprobFilterFlags_e {
    RPMPROB_FILTER_NONE         = 0,
    RPMPROB_FILTER_IGNOREOS     = (1 << 0),     
    RPMPROB_FILTER_IGNOREARCH   = (1 << 1),     
    RPMPROB_FILTER_REPLACEPKG   = (1 << 2),     
    RPMPROB_FILTER_FORCERELOCATE= (1 << 3),     
    RPMPROB_FILTER_REPLACENEWFILES= (1 << 4),   
    RPMPROB_FILTER_REPLACEOLDFILES= (1 << 5),   
    RPMPROB_FILTER_OLDPACKAGE   = (1 << 6),     
    RPMPROB_FILTER_DISKSPACE    = (1 << 7),     
    RPMPROB_FILTER_DISKNODES    = (1 << 8)      
} rpmprobFilterFlags;

typedef struct rpmRelocation_s {
/*@only@*/ /*@null@*/
    const char * oldPath;       
/*@only@*/ /*@null@*/
    const char * newPath;       
} rpmRelocation;

int rpmVersionCompare(Header first, Header second)
        /*@*/;

typedef enum fileAction_e {
    FA_UNKNOWN = 0,     
    FA_CREATE,          
    FA_COPYIN,          
    FA_COPYOUT,         
    FA_BACKUP,          
    FA_SAVE,            
    FA_SKIP,            
    FA_ALTNAME,         
    FA_ERASE,           
    FA_SKIPNSTATE,      
    FA_SKIPNETSHARED,   
    FA_SKIPCOLOR        
} fileAction;

#define XFA_SKIPPING(_a)        \
    ((_a) == FA_SKIP || (_a) == FA_SKIPNSTATE || (_a) == FA_SKIPNETSHARED || (_a) == FA_SKIPCOLOR)

typedef enum fileTypes_e {
    PIPE        =  1,   
    CDEV        =  2,   
    XDIR        =  4,   
    BDEV        =  6,   
    REG         =  8,   
    LINK        = 10,   
    SOCK        = 12    
} fileTypes;

typedef /*@abstract@*/ struct fsmIterator_s * FSMI_t;

typedef /*@abstract@*/ struct fsm_s * FSM_t;

typedef /*@abstract@*/ /*@refcounted@*/ struct rpmpsm_s * rpmpsm;

int headerVerifyInfo(int il, int dl, const void * pev, void * iv, int negate)
        /*@modifies *iv @*/;

rpmRC headerCheckPayloadFormat(Header h);

rpmRC headerCheck(rpmts ts, const void * uh, size_t uc,
                /*@out@*/ /*@null@*/ const char ** msg)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies ts, *msg, rpmGlobalMacroContext,
                fileSystem, internalState @*/;

rpmRC rpmReadHeader(rpmts ts, FD_t fd, /*@out@*/ Header *hdrp,
                /*@out@*/ /*@null@*/ const char ** msg)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies ts, *hdrp, *msg, rpmGlobalMacroContext,
                fileSystem, internalState @*/;

rpmRC rpmReadPackageFile(rpmts ts, FD_t fd,
                const char * fn, /*@null@*/ /*@out@*/ Header * hdrp)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies ts, fd, *hdrp, rpmGlobalMacroContext,
                fileSystem, internalState @*/;

rpmRC rpmInstallSourcePackage(rpmts ts, FD_t fd,
                        /*@null@*/ /*@out@*/ const char ** specFilePtr,
                        /*@null@*/ /*@out@*/ const char ** cookie)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies ts, fd, *specFilePtr, *cookie, rpmGlobalMacroContext,
                fileSystem, internalState @*/;

typedef 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),    
/*@-enummemuse@*/
    RPMTRANS_FLAG_KEEPOBSOLETE  = (1 <<  7),    
/*@=enummemuse@*/
    RPMTRANS_FLAG_NOCONTEXTS    = (1 <<  8),    
    RPMTRANS_FLAG_DIRSTASH      = (1 <<  9),    
    RPMTRANS_FLAG_REPACKAGE     = (1 << 10),    
    RPMTRANS_FLAG_PKGCOMMIT     = (1 << 11),
/*@-enummemuse@*/
    RPMTRANS_FLAG_PKGUNDO       = (1 << 12),
/*@=enummemuse@*/
    RPMTRANS_FLAG_COMMIT        = (1 << 13),
/*@-enummemuse@*/
    RPMTRANS_FLAG_UNDO          = (1 << 14),
/*@=enummemuse@*/
    RPMTRANS_FLAG_REVERSE       = (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),  
/*@-enummemuse@*/
    RPMTRANS_FLAG_NOPAYLOAD     = (1 << 24),
/*@=enummemuse@*/
    RPMTRANS_FLAG_APPLYONLY     = (1 << 25),

    RPMTRANS_FLAG_ANACONDA      = (1 << 26),    
    RPMTRANS_FLAG_NOMD5         = (1 << 27),    
    RPMTRANS_FLAG_NOSUGGEST     = (1 << 28),    
    RPMTRANS_FLAG_ADDINDEPS     = (1 << 29),    
    RPMTRANS_FLAG_NOCONFIGS     = (1 << 30),    
    RPMTRANS_FLAG_DEPLOOPS      = (1 << 31)     
} rpmtransFlags;

#define _noTransScripts         \
  ( RPMTRANS_FLAG_NOPRE |       \
    RPMTRANS_FLAG_NOPOST |      \
    RPMTRANS_FLAG_NOPREUN |     \
    RPMTRANS_FLAG_NOPOSTUN      \
  )

#define _noTransTriggers        \
  ( RPMTRANS_FLAG_NOTRIGGERPREIN | \
    RPMTRANS_FLAG_NOTRIGGERIN | \
    RPMTRANS_FLAG_NOTRIGGERUN | \
    RPMTRANS_FLAG_NOTRIGGERPOSTUN \
  )

/*@unused@*/
int rpmGetRpmlibProvides(/*@null@*/ /*@out@*/ const char *** provNames,
                        /*@null@*/ /*@out@*/ int ** provFlags,
                        /*@null@*/ /*@out@*/ const char *** provVersions)
        /*@modifies *provNames, *provFlags, *provVersions @*/;

int rpmvercmp(const char * a, const char * b)
        /*@*/;

int rpmCheckRpmlibProvides(const rpmds key)
        /*@*/;

void rpmShowRpmlibProvides(FILE * fp)
        /*@globals fileSystem @*/
        /*@modifies *fp, fileSystem @*/;

int tagType(int tag)
        /*@*/;

/*@-redecl@*/
/*@observer@*/ extern const char *const tagName(int tag)
        /*@*/;
/*@=redecl@*/

int tagValue(const char * tagstr)
        /*@*/;

#define RPMLEAD_BINARY 0
#define RPMLEAD_SOURCE 1

#define RPMLEAD_MAGIC0 0xed
#define RPMLEAD_MAGIC1 0xab
#define RPMLEAD_MAGIC2 0xee
#define RPMLEAD_MAGIC3 0xdb

#define RPMLEAD_SIZE 96         
struct rpmlead {
    unsigned char magic[4];
    unsigned char major;
    unsigned char minor;
    short type;
    short archnum;
    char name[66];
    short osnum;
    short signature_type;       
/*@unused@*/ char reserved[16]; 
} ;

void freeFilesystems(void)
        /*@globals internalState@*/
        /*@modifies internalState@*/;

/*@-incondefs@*/
int rpmGetFilesystemList( /*@null@*/ /*@out@*/ const char *** listptr,
                /*@null@*/ /*@out@*/ int * num)
        /*@globals fileSystem, internalState @*/
        /*@modifies *listptr, *num, fileSystem, internalState @*/
        /*@requires maxSet(listptr) >= 0 /\ maxSet(num) >= 0 @*/
        /*@ensures maxRead(num) == 0 @*/;
/*@=incondefs@*/

/*@-incondefs@*/
int rpmGetFilesystemUsage(const char ** fileList, int_32 * fssizes,
                int numFiles, /*@null@*/ /*@out@*/ uint_32 ** usagesPtr,
                int flags)
        /*@globals rpmGlobalMacroContext, h_errno,
                fileSystem, internalState @*/
        /*@modifies *usagesPtr, rpmGlobalMacroContext,
                fileSystem, internalState @*/
        /*@requires maxSet(fileList) >= 0 /\ maxSet(fssizes) == 0
                /\ maxSet(usagesPtr) >= 0 @*/
        /*@ensures maxRead(usagesPtr) == 0 @*/;
/*@=incondefs@*/

/* ==================================================================== */
/* --- install/upgrade/erase modes */

typedef enum rpmInstallInterfaceFlags_e {
    INSTALL_NONE        = 0,
    INSTALL_PERCENT     = (1 << 0),     
    INSTALL_HASH        = (1 << 1),     
    INSTALL_NODEPS      = (1 << 2),     
    INSTALL_NOORDER     = (1 << 3),     
    INSTALL_LABEL       = (1 << 4),     
    INSTALL_UPGRADE     = (1 << 5),     
    INSTALL_FRESHEN     = (1 << 6),     
    INSTALL_INSTALL     = (1 << 7),     
    INSTALL_ERASE       = (1 << 8)      
} rpmInstallInterfaceFlags;

typedef enum rpmEraseInterfaceFlags_e {
    UNINSTALL_NONE      = 0,
    UNINSTALL_NODEPS    = (1 << 0),     
    UNINSTALL_ALLMATCHES= (1 << 1)      
} rpmEraseInterfaceFlags;

/* ==================================================================== */

enum rpmtagSignature {
    RPMSIGTAG_SIZE      = 1000, 
    RPMSIGTAG_LEMD5_1   = 1001, 
    RPMSIGTAG_PGP       = 1002, 
    RPMSIGTAG_LEMD5_2   = 1003, 
    RPMSIGTAG_MD5       = 1004, 
    RPMSIGTAG_GPG       = 1005, 
    RPMSIGTAG_PGP5      = 1006, 
    RPMSIGTAG_PAYLOADSIZE = 1007,
    RPMSIGTAG_BADSHA1_1 = RPMTAG_BADSHA1_1,     
    RPMSIGTAG_BADSHA1_2 = RPMTAG_BADSHA1_2,     
    RPMSIGTAG_SHA1      = RPMTAG_SHA1HEADER,    
    RPMSIGTAG_DSA       = RPMTAG_DSAHEADER,     
    RPMSIGTAG_RSA       = RPMTAG_RSAHEADER      
};

rpmRC rpmVerifySignature(const rpmts ts,
                /*@out@*/ char * result)
        /*@globals rpmGlobalMacroContext, h_errno, fileSystem, internalState @*/
        /*@modifies ts, *result, rpmGlobalMacroContext,
                fileSystem, internalState @*/;

/*@null@*/ Header rpmFreeSignature(/*@null@*/ /*@killref@*/ Header h)
        /*@modifies h @*/;

#ifdef __cplusplus
}
#endif

#endif  /* H_RPMLIB */

---