Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages  

lib/rpmlib.h

Go to the documentation of this file.
00001 #ifndef H_RPMLIB
00002 #define H_RPMLIB
00003 
00011 #include "rpmio.h"
00012 #include "rpmmessages.h"
00013 #include "rpmerr.h"
00014 #include "header.h"
00015 #include "popt.h"
00016 
00020 typedef enum rpmRC_e {
00021     RPMRC_OK            = 0,    
00022     RPMRC_NOTFOUND      = 1,    
00023     RPMRC_FAIL          = 2,    
00024     RPMRC_NOTTRUSTED    = 3,    
00025     RPMRC_NOKEY         = 4     
00026 } rpmRC;
00027 
00028 /*@-redecl@*/
00029 /*@checked@*/
00030 extern struct MacroContext_s * rpmGlobalMacroContext;
00031 
00032 /*@checked@*/
00033 extern struct MacroContext_s * rpmCLIMacroContext;
00034 
00035 /*@unchecked@*/ /*@observer@*/
00036 extern const char * RPMVERSION;
00037 
00038 /*@unchecked@*/ /*@observer@*/
00039 extern const char * rpmNAME;
00040 
00041 /*@unchecked@*/ /*@observer@*/
00042 extern const char * rpmEVR;
00043 
00044 /*@unchecked@*/
00045 extern int rpmFLAGS;
00046 /*@=redecl@*/
00047 
00048 #ifdef __cplusplus
00049 extern "C" {
00050 #endif
00051 
00057 /*@unused@*/ static inline /*@null@*/
00058 void * _free(/*@only@*/ /*@null@*/ /*@out@*/ const void * p)
00059         /*@modifies p @*/
00060 {
00061     if (p != NULL)      free((void *)p);
00062     return NULL;
00063 }
00064 
00071 typedef /*@abstract@*/ /*@refcounted@*/ struct rpmts_s * rpmts;
00072 
00075 typedef struct Spec_s * Spec;
00076 
00080 typedef /*@abstract@*/ void * alKey;
00081 #define RPMAL_NOMATCH   ((alKey)-1L)
00082 
00086 /*@-mutrep@*/
00087 typedef /*@abstract@*/ int alNum;
00088 /*@=mutrep@*/
00089 
00093 typedef /*@abstract@*/ /*@refcounted@*/ struct rpmds_s * rpmds;
00094 
00098 typedef /*@abstract@*/ /*@refcounted@*/ struct rpmfi_s * rpmfi;
00099 
00103 typedef /*@abstract@*/ struct rpmte_s * rpmte;
00104 
00108 typedef /*@abstract@*/ /*@refcounted@*/ struct rpmdb_s * rpmdb;
00109 
00113 typedef /*@abstract@*/ struct _rpmdbMatchIterator * rpmdbMatchIterator;
00114 
00123 int headerNVR(Header h,
00124                 /*@null@*/ /*@out@*/ const char ** np,
00125                 /*@null@*/ /*@out@*/ const char ** vp,
00126                 /*@null@*/ /*@out@*/ const char ** rp)
00127         /*@modifies *np, *vp, *rp @*/;
00128 
00139 int headerNEVRA(Header h,
00140                 /*@null@*/ /*@out@*/ const char ** np,
00141                 /*@null@*/ /*@out@*/ /*@unused@*/ const char ** ep,
00142                 /*@null@*/ /*@out@*/ const char ** vp,
00143                 /*@null@*/ /*@out@*/ const char ** rp,
00144                 /*@null@*/ /*@out@*/ const char ** ap)
00145         /*@modifies *np, *vp, *rp, *ap @*/;
00146 
00153 void headerMergeLegacySigs(Header h, const Header sigh)
00154         /*@modifies h, sigh @*/;
00155 
00163 Header headerRegenSigHeader(const Header h, int noArchiveSize)
00164         /*@modifies h @*/;
00165 
00179 /*@unused@*/
00180 int rpmHeaderGetEntry(Header h, int_32 tag, /*@out@*/ int_32 *type,
00181                 /*@out@*/ void **p, /*@out@*/ int_32 *c)
00182         /*@modifies *type, *p, *c @*/;
00183 
00187 /*@-redecl@*/
00188 /*@observer@*/ /*@unchecked@*/
00189 extern const struct headerTagTableEntry_s * rpmTagTable;
00190 /*@=redecl@*/
00191 
00195 /*@-redecl@*/
00196 /*@unchecked@*/
00197 extern const int rpmTagTableSize;
00198 /*@=redecl@*/
00199 
00204 /*@-redecl@*/
00205 /*@unchecked@*/
00206 extern const struct headerSprintfExtension_s rpmHeaderFormats[];
00207 /*@=redecl@*/
00208 
00212 #define RPMDBI_PACKAGES         0       
00213 #define RPMDBI_DEPENDS          1       
00214 #define RPMDBI_LABEL            2       
00215 #define RPMDBI_ADDED            3       
00216 #define RPMDBI_REMOVED          4       
00217 #define RPMDBI_AVAILABLE        5       
00223 typedef enum rpmTag_e {
00224 
00225     RPMTAG_HEADERIMAGE          = HEADER_IMAGE,         
00226     RPMTAG_HEADERSIGNATURES     = HEADER_SIGNATURES,    
00227     RPMTAG_HEADERIMMUTABLE      = HEADER_IMMUTABLE,     
00228 /*@-enummemuse@*/
00229     RPMTAG_HEADERREGIONS        = HEADER_REGIONS,       
00231     RPMTAG_HEADERI18NTABLE      = HEADER_I18NTABLE, 
00232 /*@=enummemuse@*/
00233 
00234 /* Retrofit (and uniqify) signature tags for use by tagName() and rpmQuery. */
00235 /* the md5 sum was broken *twice* on big endian machines */
00236 /* XXX 2nd underscore prevents tagTable generation */
00237     RPMTAG_SIG_BASE             = HEADER_SIGBASE,
00238     RPMTAG_SIGSIZE              = RPMTAG_SIG_BASE+1,
00239     RPMTAG_SIGLEMD5_1           = RPMTAG_SIG_BASE+2,    
00240     RPMTAG_SIGPGP               = RPMTAG_SIG_BASE+3,
00241     RPMTAG_SIGLEMD5_2           = RPMTAG_SIG_BASE+4,    
00242     RPMTAG_SIGMD5               = RPMTAG_SIG_BASE+5,
00243 #define RPMTAG_PKGID    RPMTAG_SIGMD5
00244     RPMTAG_SIGGPG               = RPMTAG_SIG_BASE+6,
00245     RPMTAG_SIGPGP5              = RPMTAG_SIG_BASE+7,    
00247     RPMTAG_BADSHA1_1            = RPMTAG_SIG_BASE+8,    
00248     RPMTAG_BADSHA1_2            = RPMTAG_SIG_BASE+9,    
00249     RPMTAG_PUBKEYS              = RPMTAG_SIG_BASE+10,
00250     RPMTAG_DSAHEADER            = RPMTAG_SIG_BASE+11,
00251     RPMTAG_RSAHEADER            = RPMTAG_SIG_BASE+12,
00252     RPMTAG_SHA1HEADER           = RPMTAG_SIG_BASE+13,
00253 #define RPMTAG_HDRID    RPMTAG_SHA1HEADER
00254 
00255     RPMTAG_NAME                 = 1000,
00256 #define RPMTAG_N        RPMTAG_NAME
00257     RPMTAG_VERSION              = 1001,
00258 #define RPMTAG_V        RPMTAG_VERSION
00259     RPMTAG_RELEASE              = 1002,
00260 #define RPMTAG_R        RPMTAG_RELEASE
00261     RPMTAG_EPOCH                = 1003,
00262 #define RPMTAG_E        RPMTAG_EPOCH
00263 #define RPMTAG_SERIAL   RPMTAG_EPOCH    /* backward comaptibility */
00264     RPMTAG_SUMMARY              = 1004,
00265     RPMTAG_DESCRIPTION          = 1005,
00266     RPMTAG_BUILDTIME            = 1006,
00267     RPMTAG_BUILDHOST            = 1007,
00268     RPMTAG_INSTALLTIME          = 1008,
00269     RPMTAG_SIZE                 = 1009,
00270     RPMTAG_DISTRIBUTION         = 1010,
00271     RPMTAG_VENDOR               = 1011,
00272     RPMTAG_GIF                  = 1012,
00273     RPMTAG_XPM                  = 1013,
00274     RPMTAG_LICENSE              = 1014,
00275 #define RPMTAG_COPYRIGHT RPMTAG_LICENSE /* backward comaptibility */
00276     RPMTAG_PACKAGER             = 1015,
00277     RPMTAG_GROUP                = 1016,
00278 /*@-enummemuse@*/
00279     RPMTAG_CHANGELOG            = 1017, 
00280 /*@=enummemuse@*/
00281     RPMTAG_SOURCE               = 1018,
00282     RPMTAG_PATCH                = 1019,
00283     RPMTAG_URL                  = 1020,
00284     RPMTAG_OS                   = 1021,
00285     RPMTAG_ARCH                 = 1022,
00286     RPMTAG_PREIN                = 1023,
00287     RPMTAG_POSTIN               = 1024,
00288     RPMTAG_PREUN                = 1025,
00289     RPMTAG_POSTUN               = 1026,
00290     RPMTAG_OLDFILENAMES         = 1027, /* obsolete */
00291     RPMTAG_FILESIZES            = 1028,
00292     RPMTAG_FILESTATES           = 1029,
00293     RPMTAG_FILEMODES            = 1030,
00294     RPMTAG_FILEUIDS             = 1031, 
00295     RPMTAG_FILEGIDS             = 1032, 
00296     RPMTAG_FILERDEVS            = 1033,
00297     RPMTAG_FILEMTIMES           = 1034,
00298     RPMTAG_FILEMD5S             = 1035,
00299     RPMTAG_FILELINKTOS          = 1036,
00300     RPMTAG_FILEFLAGS            = 1037,
00301 /*@-enummemuse@*/
00302     RPMTAG_ROOT                 = 1038, 
00303 /*@=enummemuse@*/
00304     RPMTAG_FILEUSERNAME         = 1039,
00305     RPMTAG_FILEGROUPNAME        = 1040,
00306 /*@-enummemuse@*/
00307     RPMTAG_EXCLUDE              = 1041, 
00308     RPMTAG_EXCLUSIVE            = 1042, 
00309 /*@=enummemuse@*/
00310     RPMTAG_ICON                 = 1043,
00311     RPMTAG_SOURCERPM            = 1044,
00312     RPMTAG_FILEVERIFYFLAGS      = 1045,
00313     RPMTAG_ARCHIVESIZE          = 1046,
00314     RPMTAG_PROVIDENAME          = 1047,
00315 #define RPMTAG_PROVIDES RPMTAG_PROVIDENAME      /* backward comaptibility */
00316     RPMTAG_REQUIREFLAGS         = 1048,
00317     RPMTAG_REQUIRENAME          = 1049,
00318     RPMTAG_REQUIREVERSION       = 1050,
00319     RPMTAG_NOSOURCE             = 1051, 
00320     RPMTAG_NOPATCH              = 1052, 
00321     RPMTAG_CONFLICTFLAGS        = 1053,
00322     RPMTAG_CONFLICTNAME         = 1054,
00323     RPMTAG_CONFLICTVERSION      = 1055,
00324     RPMTAG_DEFAULTPREFIX        = 1056, 
00325     RPMTAG_BUILDROOT            = 1057, 
00326     RPMTAG_INSTALLPREFIX        = 1058, 
00327     RPMTAG_EXCLUDEARCH          = 1059,
00328     RPMTAG_EXCLUDEOS            = 1060,
00329     RPMTAG_EXCLUSIVEARCH        = 1061,
00330     RPMTAG_EXCLUSIVEOS          = 1062,
00331     RPMTAG_AUTOREQPROV          = 1063, 
00332     RPMTAG_RPMVERSION           = 1064,
00333     RPMTAG_TRIGGERSCRIPTS       = 1065,
00334     RPMTAG_TRIGGERNAME          = 1066,
00335     RPMTAG_TRIGGERVERSION       = 1067,
00336     RPMTAG_TRIGGERFLAGS         = 1068,
00337     RPMTAG_TRIGGERINDEX         = 1069,
00338     RPMTAG_VERIFYSCRIPT         = 1079,
00339     RPMTAG_CHANGELOGTIME        = 1080,
00340     RPMTAG_CHANGELOGNAME        = 1081,
00341     RPMTAG_CHANGELOGTEXT        = 1082,
00342 /*@-enummemuse@*/
00343     RPMTAG_BROKENMD5            = 1083, 
00344 /*@=enummemuse@*/
00345     RPMTAG_PREREQ               = 1084, 
00346     RPMTAG_PREINPROG            = 1085,
00347     RPMTAG_POSTINPROG           = 1086,
00348     RPMTAG_PREUNPROG            = 1087,
00349     RPMTAG_POSTUNPROG           = 1088,
00350     RPMTAG_BUILDARCHS           = 1089,
00351     RPMTAG_OBSOLETENAME         = 1090,
00352 #define RPMTAG_OBSOLETES RPMTAG_OBSOLETENAME    /* backward comaptibility */
00353     RPMTAG_VERIFYSCRIPTPROG     = 1091,
00354     RPMTAG_TRIGGERSCRIPTPROG    = 1092,
00355     RPMTAG_DOCDIR               = 1093, 
00356     RPMTAG_COOKIE               = 1094,
00357     RPMTAG_FILEDEVICES          = 1095,
00358     RPMTAG_FILEINODES           = 1096,
00359     RPMTAG_FILELANGS            = 1097,
00360     RPMTAG_PREFIXES             = 1098,
00361     RPMTAG_INSTPREFIXES         = 1099,
00362     RPMTAG_TRIGGERIN            = 1100, 
00363     RPMTAG_TRIGGERUN            = 1101, 
00364     RPMTAG_TRIGGERPOSTUN        = 1102, 
00365     RPMTAG_AUTOREQ              = 1103, 
00366     RPMTAG_AUTOPROV             = 1104, 
00367 /*@-enummemuse@*/
00368     RPMTAG_CAPABILITY           = 1105, 
00369 /*@=enummemuse@*/
00370     RPMTAG_SOURCEPACKAGE        = 1106, 
00371 /*@-enummemuse@*/
00372     RPMTAG_OLDORIGFILENAMES     = 1107, 
00373 /*@=enummemuse@*/
00374     RPMTAG_BUILDPREREQ          = 1108, 
00375     RPMTAG_BUILDREQUIRES        = 1109, 
00376     RPMTAG_BUILDCONFLICTS       = 1110, 
00377 /*@-enummemuse@*/
00378     RPMTAG_BUILDMACROS          = 1111, 
00379 /*@=enummemuse@*/
00380     RPMTAG_PROVIDEFLAGS         = 1112,
00381     RPMTAG_PROVIDEVERSION       = 1113,
00382     RPMTAG_OBSOLETEFLAGS        = 1114,
00383     RPMTAG_OBSOLETEVERSION      = 1115,
00384     RPMTAG_DIRINDEXES           = 1116,
00385     RPMTAG_BASENAMES            = 1117,
00386     RPMTAG_DIRNAMES             = 1118,
00387     RPMTAG_ORIGDIRINDEXES       = 1119, 
00388     RPMTAG_ORIGBASENAMES        = 1120, 
00389     RPMTAG_ORIGDIRNAMES         = 1121, 
00390     RPMTAG_OPTFLAGS             = 1122,
00391     RPMTAG_DISTURL              = 1123,
00392     RPMTAG_PAYLOADFORMAT        = 1124,
00393     RPMTAG_PAYLOADCOMPRESSOR    = 1125,
00394     RPMTAG_PAYLOADFLAGS         = 1126,
00395     RPMTAG_INSTALLCOLOR         = 1127, 
00396     RPMTAG_INSTALLTID           = 1128,
00397     RPMTAG_REMOVETID            = 1129,
00398 /*@-enummemuse@*/
00399     RPMTAG_SHA1RHN              = 1130, 
00400 /*@=enummemuse@*/
00401     RPMTAG_RHNPLATFORM          = 1131,
00402     RPMTAG_PLATFORM             = 1132,
00403     RPMTAG_PATCHESNAME          = 1133, 
00404     RPMTAG_PATCHESFLAGS         = 1134, 
00405     RPMTAG_PATCHESVERSION       = 1135, 
00406     RPMTAG_CACHECTIME           = 1136,
00407     RPMTAG_CACHEPKGPATH         = 1137,
00408     RPMTAG_CACHEPKGSIZE         = 1138,
00409     RPMTAG_CACHEPKGMTIME        = 1139,
00410     RPMTAG_FILECOLORS           = 1140,
00411     RPMTAG_FILECLASS            = 1141,
00412     RPMTAG_CLASSDICT            = 1142,
00413     RPMTAG_FILEDEPENDSX         = 1143,
00414     RPMTAG_FILEDEPENDSN         = 1144,
00415     RPMTAG_DEPENDSDICT          = 1145,
00416     RPMTAG_SOURCEPKGID          = 1146,
00417 /*@-enummemuse@*/
00418     RPMTAG_FIRSTFREE_TAG        
00419 /*@=enummemuse@*/
00420 } rpmTag;
00421 
00422 #define RPMTAG_EXTERNAL_TAG             1000000
00423 
00427 typedef enum rpmfileState_e {
00428     RPMFILE_STATE_NORMAL        = 0,
00429     RPMFILE_STATE_REPLACED      = 1,
00430     RPMFILE_STATE_NOTINSTALLED  = 2,
00431     RPMFILE_STATE_NETSHARED     = 3,
00432     RPMFILE_STATE_WRONGCOLOR    = 4
00433 } rpmfileState;
00434 #define RPMFILE_STATE_MISSING   -1      /* XXX used for unavailable data */
00435 
00439 typedef enum rpmfileAttrs_e {
00440 /*@-enummemuse@*/
00441     RPMFILE_NONE        = 0,
00442 /*@=enummemuse@*/
00443     RPMFILE_CONFIG      = (1 <<  0),    
00444     RPMFILE_DOC         = (1 <<  1),    
00445     RPMFILE_ICON        = (1 <<  2),    
00446     RPMFILE_MISSINGOK   = (1 <<  3),    
00447     RPMFILE_NOREPLACE   = (1 <<  4),    
00448     RPMFILE_SPECFILE    = (1 <<  5),    
00449     RPMFILE_GHOST       = (1 <<  6),    
00450     RPMFILE_LICENSE     = (1 <<  7),    
00451     RPMFILE_README      = (1 <<  8),    
00452     RPMFILE_EXCLUDE     = (1 <<  9),    
00453     RPMFILE_UNPATCHED   = (1 << 10),    
00454     RPMFILE_PUBKEY      = (1 << 11)     
00455 } rpmfileAttrs;
00456 
00457 #define RPMFILE_ALL     ~(RPMFILE_NONE)
00458 
00462 typedef enum rpmsenseFlags_e {
00463     RPMSENSE_ANY        = 0,
00464 /*@-enummemuse@*/
00465     RPMSENSE_SERIAL     = (1 << 0),     
00466 /*@=enummemuse@*/
00467     RPMSENSE_LESS       = (1 << 1),
00468     RPMSENSE_GREATER    = (1 << 2),
00469     RPMSENSE_EQUAL      = (1 << 3),
00470     RPMSENSE_PROVIDES   = (1 << 4), /* only used internally by builds */
00471     RPMSENSE_CONFLICTS  = (1 << 5), /* only used internally by builds */
00472     RPMSENSE_PREREQ     = (1 << 6),     
00473     RPMSENSE_OBSOLETES  = (1 << 7), /* only used internally by builds */
00474     RPMSENSE_INTERP     = (1 << 8),     
00475     RPMSENSE_SCRIPT_PRE = ((1 << 9)|RPMSENSE_PREREQ), 
00476     RPMSENSE_SCRIPT_POST = ((1 << 10)|RPMSENSE_PREREQ), 
00477     RPMSENSE_SCRIPT_PREUN = ((1 << 11)|RPMSENSE_PREREQ), 
00478     RPMSENSE_SCRIPT_POSTUN = ((1 << 12)|RPMSENSE_PREREQ), 
00479     RPMSENSE_SCRIPT_VERIFY = (1 << 13), 
00480     RPMSENSE_FIND_REQUIRES = (1 << 14), 
00481     RPMSENSE_FIND_PROVIDES = (1 << 15), 
00483     RPMSENSE_TRIGGERIN  = (1 << 16),    
00484     RPMSENSE_TRIGGERUN  = (1 << 17),    
00485     RPMSENSE_TRIGGERPOSTUN = (1 << 18), 
00486         /* (1 << 19) unused. */
00487     RPMSENSE_SCRIPT_PREP = (1 << 20),   
00488     RPMSENSE_SCRIPT_BUILD = (1 << 21),  
00489     RPMSENSE_SCRIPT_INSTALL = (1 << 22),
00490     RPMSENSE_SCRIPT_CLEAN = (1 << 23),  
00491     RPMSENSE_RPMLIB     = ((1 << 24) | RPMSENSE_PREREQ), 
00492 /*@-enummemuse@*/
00493     RPMSENSE_TRIGGERPREIN = (1 << 25),  
00494 /*@=enummemuse@*/
00495     RPMSENSE_KEYRING    = (1 << 26),
00496     RPMSENSE_PATCHES    = (1 << 27),
00497     RPMSENSE_CONFIG     = (1 << 28)
00498 } rpmsenseFlags;
00499 
00500 #define RPMSENSE_SENSEMASK      15       /* Mask to get senses, ie serial, */
00501                                          /* less, greater, equal.          */
00502 
00503 #define RPMSENSE_TRIGGER        \
00504         (RPMSENSE_TRIGGERIN | RPMSENSE_TRIGGERUN | RPMSENSE_TRIGGERPOSTUN)
00505 
00506 #define _ALL_REQUIRES_MASK      (\
00507     RPMSENSE_INTERP | \
00508     RPMSENSE_SCRIPT_PRE | \
00509     RPMSENSE_SCRIPT_POST | \
00510     RPMSENSE_SCRIPT_PREUN | \
00511     RPMSENSE_SCRIPT_POSTUN | \
00512     RPMSENSE_SCRIPT_VERIFY | \
00513     RPMSENSE_FIND_REQUIRES | \
00514     RPMSENSE_SCRIPT_PREP | \
00515     RPMSENSE_SCRIPT_BUILD | \
00516     RPMSENSE_SCRIPT_INSTALL | \
00517     RPMSENSE_SCRIPT_CLEAN | \
00518     RPMSENSE_RPMLIB | \
00519     RPMSENSE_KEYRING )
00520 
00521 #define _notpre(_x)             ((_x) & ~RPMSENSE_PREREQ)
00522 #define _INSTALL_ONLY_MASK \
00523     _notpre(RPMSENSE_SCRIPT_PRE|RPMSENSE_SCRIPT_POST|RPMSENSE_RPMLIB|RPMSENSE_KEYRING)
00524 #define _ERASE_ONLY_MASK  \
00525     _notpre(RPMSENSE_SCRIPT_PREUN|RPMSENSE_SCRIPT_POSTUN)
00526 
00527 #define isLegacyPreReq(_x)  (((_x) & _ALL_REQUIRES_MASK) == RPMSENSE_PREREQ)
00528 #define isInstallPreReq(_x)     ((_x) & _INSTALL_ONLY_MASK)
00529 #define isErasePreReq(_x)       ((_x) & _ERASE_ONLY_MASK)
00530 
00531 /* ==================================================================== */
00534 
00535 /* Stuff for maintaining "variables" like SOURCEDIR, BUILDDIR, etc */
00536 #define RPMVAR_OPTFLAGS                 3
00537 #define RPMVAR_PROVIDES                 38
00538 #define RPMVAR_INCLUDE                  43
00539 #define RPMVAR_MACROFILES               49
00540 
00541 #define RPMVAR_NUM                      55      /* number of RPMVAR entries */
00542 
00548 /*@-redecl@*/
00549 /*@observer@*/ /*@null@*/ extern const char * rpmGetVar(int var)
00550         /*@*/;
00551 /*@=redecl@*/
00552 
00558 void rpmSetVar(int var, const char * val)
00559         /*@globals internalState@*/
00560         /*@modifies internalState @*/;
00561 
00566 enum rpm_machtable_e {
00567     RPM_MACHTABLE_INSTARCH      = 0,    
00568     RPM_MACHTABLE_INSTOS        = 1,    
00569     RPM_MACHTABLE_BUILDARCH     = 2,    
00570     RPM_MACHTABLE_BUILDOS       = 3     
00571 };
00572 #define RPM_MACHTABLE_COUNT     4       
00580 int rpmReadConfigFiles(/*@null@*/ const char * file,
00581                 /*@null@*/ const char * target)
00582         /*@globals rpmGlobalMacroContext, rpmCLIMacroContext,
00583                 fileSystem, internalState @*/
00584         /*@modifies rpmGlobalMacroContext, rpmCLIMacroContext,
00585                 fileSystem, internalState @*/;
00586 
00593 void rpmGetArchInfo( /*@null@*/ /*@out@*/ const char ** name,
00594                 /*@null@*/ /*@out@*/ int * num)
00595         /*@modifies *name, *num @*/;
00596 
00603 void rpmGetOsInfo( /*@null@*/ /*@out@*/ const char ** name,
00604                 /*@null@*/ /*@out@*/ int * num)
00605         /*@modifies *name, *num @*/;
00606 
00620 int rpmMachineScore(int type, const char * name)
00621         /*@*/;
00622 
00628 int rpmShowRC(FILE * fp)
00629         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00630         /*@modifies *fp, rpmGlobalMacroContext, fileSystem, internalState  @*/;
00631 
00639 void rpmSetTables(int archTable, int osTable)
00640         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00641         /*@modifies rpmGlobalMacroContext, fileSystem, internalState @*/;
00642 
00653 void rpmSetMachine(/*@null@*/ const char * arch, /*@null@*/ const char * os)
00654         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00655         /*@modifies rpmGlobalMacroContext, fileSystem, internalState @*/;
00656 
00665 /*@unused@*/
00666 void rpmGetMachine( /*@null@*/ /*@out@*/ const char **arch,
00667                 /*@null@*/ /*@out@*/ const char **os)
00668         /*@modifies *arch, *os @*/;
00669 
00674 void rpmFreeRpmrc(void)
00675         /*@globals internalState @*/
00676         /*@modifies internalState @*/;
00677 
00679 /* ==================================================================== */
00689 typedef /*@null@*/
00690     void * (*HFD_t) (/*@only@*/ /*@null@*/ const void * data, rpmTagType type)
00691         /*@modifies data @*/;
00692 
00707 typedef int (*HGE_t) (Header h, rpmTag tag,
00708                         /*@null@*/ /*@out@*/ rpmTagType * type,
00709                         /*@null@*/ /*@out@*/ void ** p,
00710                         /*@null@*/ /*@out@*/ int_32 * c)
00711         /*@modifies *type, *p, *c @*/;
00712 
00728 typedef int (*HAE_t) (Header h, rpmTag tag, rpmTagType type,
00729                         const void * p, int_32 c)
00730         /*@modifies h @*/;
00731 
00743 typedef int (*HME_t) (Header h, rpmTag tag, rpmTagType type,
00744                         const void * p, int_32 c)
00745         /*@modifies h @*/;
00746 
00757 typedef int (*HRE_t) (Header h, int_32 tag)
00758         /*@modifies h @*/;
00759 
00763 typedef enum rpmprobFilterFlags_e {
00764     RPMPROB_FILTER_NONE         = 0,
00765     RPMPROB_FILTER_IGNOREOS     = (1 << 0),     
00766     RPMPROB_FILTER_IGNOREARCH   = (1 << 1),     
00767     RPMPROB_FILTER_REPLACEPKG   = (1 << 2),     
00768     RPMPROB_FILTER_FORCERELOCATE= (1 << 3),     
00769     RPMPROB_FILTER_REPLACENEWFILES= (1 << 4),   
00770     RPMPROB_FILTER_REPLACEOLDFILES= (1 << 5),   
00771     RPMPROB_FILTER_OLDPACKAGE   = (1 << 6),     
00772     RPMPROB_FILTER_DISKSPACE    = (1 << 7),     
00773     RPMPROB_FILTER_DISKNODES    = (1 << 8)      
00774 } rpmprobFilterFlags;
00775 
00779 typedef struct rpmRelocation_s {
00780 /*@only@*/ /*@null@*/
00781     const char * oldPath;       
00782 /*@only@*/ /*@null@*/
00783     const char * newPath;       
00784 } rpmRelocation;
00785 
00792 int rpmVersionCompare(Header first, Header second)
00793         /*@*/;
00794 
00798 typedef enum fileAction_e {
00799     FA_UNKNOWN = 0,     
00800     FA_CREATE,          
00801     FA_COPYIN,          
00802     FA_COPYOUT,         
00803     FA_BACKUP,          
00804     FA_SAVE,            
00805     FA_SKIP,            
00806     FA_ALTNAME,         
00807     FA_ERASE,           
00808     FA_SKIPNSTATE,      
00809     FA_SKIPNETSHARED,   
00810     FA_SKIPCOLOR        
00811 } fileAction;
00812 
00813 #define XFA_SKIPPING(_a)        \
00814     ((_a) == FA_SKIP || (_a) == FA_SKIPNSTATE || (_a) == FA_SKIPNETSHARED || (_a) == FA_SKIPCOLOR)
00815 
00823 typedef enum fileTypes_e {
00824     PIPE        =  1,   
00825     CDEV        =  2,   
00826     XDIR        =  4,   
00827     BDEV        =  6,   
00828     REG         =  8,   
00829     LINK        = 10,   
00830     SOCK        = 12    
00831 } fileTypes;
00832 
00836 typedef /*@abstract@*/ struct fsmIterator_s * FSMI_t;
00837 
00841 typedef /*@abstract@*/ struct fsm_s * FSM_t;
00842 
00846 typedef /*@abstract@*/ /*@refcounted@*/ struct rpmpsm_s * rpmpsm;
00847 
00857 int headerVerifyInfo(int il, int dl, const void * pev, void * iv, int negate)
00858         /*@modifies *iv @*/;
00859 
00873 rpmRC headerCheck(rpmts ts, const void * uh, size_t uc,
00874                 /*@out@*/ /*@null@*/ const char ** msg)
00875         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00876         /*@modifies ts, *msg, rpmGlobalMacroContext,
00877                 fileSystem, internalState @*/;
00878 
00887 rpmRC rpmReadHeader(rpmts ts, FD_t fd, /*@out@*/ Header *hdrp,
00888                 /*@out@*/ /*@null@*/ const char ** msg)
00889         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00890         /*@modifies ts, *hdrp, *msg, rpmGlobalMacroContext,
00891                 fileSystem, internalState @*/;
00892 
00901 int rpmReadPackageFile(rpmts ts, FD_t fd,
00902                 const char * fn, /*@null@*/ /*@out@*/ Header * hdrp)
00903         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00904         /*@modifies ts, fd, *hdrp, rpmGlobalMacroContext,
00905                 fileSystem, internalState @*/;
00906 
00915 rpmRC rpmInstallSourcePackage(rpmts ts, FD_t fd,
00916                         /*@null@*/ /*@out@*/ const char ** specFilePtr,
00917                         /*@null@*/ /*@out@*/ const char ** cookie)
00918         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
00919         /*@modifies ts, fd, *specFilePtr, *cookie, rpmGlobalMacroContext,
00920                 fileSystem, internalState @*/;
00921 
00925 typedef enum rpmtransFlags_e {
00926     RPMTRANS_FLAG_NONE          = 0,
00927     RPMTRANS_FLAG_TEST          = (1 <<  0),    
00928     RPMTRANS_FLAG_BUILD_PROBS   = (1 <<  1),    
00929     RPMTRANS_FLAG_NOSCRIPTS     = (1 <<  2),    
00930     RPMTRANS_FLAG_JUSTDB        = (1 <<  3),    
00931     RPMTRANS_FLAG_NOTRIGGERS    = (1 <<  4),    
00932     RPMTRANS_FLAG_NODOCS        = (1 <<  5),    
00933     RPMTRANS_FLAG_ALLFILES      = (1 <<  6),    
00934 /*@-enummemuse@*/
00935     RPMTRANS_FLAG_KEEPOBSOLETE  = (1 <<  7),    
00936 /*@=enummemuse@*/
00937         /* (1 << 8) unused. */
00938     RPMTRANS_FLAG_DIRSTASH      = (1 <<  9),    
00939     RPMTRANS_FLAG_REPACKAGE     = (1 << 10),    
00941     RPMTRANS_FLAG_PKGCOMMIT     = (1 << 11),
00942 /*@-enummemuse@*/
00943     RPMTRANS_FLAG_PKGUNDO       = (1 << 12),
00944 /*@=enummemuse@*/
00945     RPMTRANS_FLAG_COMMIT        = (1 << 13),
00946 /*@-enummemuse@*/
00947     RPMTRANS_FLAG_UNDO          = (1 << 14),
00948 /*@=enummemuse@*/
00949     RPMTRANS_FLAG_REVERSE       = (1 << 15),
00950 
00951     RPMTRANS_FLAG_NOTRIGGERPREIN= (1 << 16),    
00952     RPMTRANS_FLAG_NOPRE         = (1 << 17),    
00953     RPMTRANS_FLAG_NOPOST        = (1 << 18),    
00954     RPMTRANS_FLAG_NOTRIGGERIN   = (1 << 19),    
00955     RPMTRANS_FLAG_NOTRIGGERUN   = (1 << 20),    
00956     RPMTRANS_FLAG_NOPREUN       = (1 << 21),    
00957     RPMTRANS_FLAG_NOPOSTUN      = (1 << 22),    
00958     RPMTRANS_FLAG_NOTRIGGERPOSTUN = (1 << 23),  
00959 /*@-enummemuse@*/
00960     RPMTRANS_FLAG_NOPAYLOAD     = (1 << 24),
00961 /*@=enummemuse@*/
00962     RPMTRANS_FLAG_APPLYONLY     = (1 << 25),
00963 
00964     RPMTRANS_FLAG_ANACONDA      = (1 << 26),
00965     RPMTRANS_FLAG_NOMD5         = (1 << 27),    
00966     RPMTRANS_FLAG_NOSUGGEST     = (1 << 28),    
00967     RPMTRANS_FLAG_ADDINDEPS     = (1 << 29),    
00968     RPMTRANS_FLAG_NOCONFIGS     = (1 << 30)     
00969 } rpmtransFlags;
00970 
00971 #define _noTransScripts         \
00972   ( RPMTRANS_FLAG_NOPRE |       \
00973     RPMTRANS_FLAG_NOPOST |      \
00974     RPMTRANS_FLAG_NOPREUN |     \
00975     RPMTRANS_FLAG_NOPOSTUN      \
00976   )
00977 
00978 #define _noTransTriggers        \
00979   ( RPMTRANS_FLAG_NOTRIGGERPREIN | \
00980     RPMTRANS_FLAG_NOTRIGGERIN | \
00981     RPMTRANS_FLAG_NOTRIGGERUN | \
00982     RPMTRANS_FLAG_NOTRIGGERPOSTUN \
00983   )
00984 
00992 /*@unused@*/
00993 int rpmGetRpmlibProvides(/*@null@*/ /*@out@*/ const char *** provNames,
00994                         /*@null@*/ /*@out@*/ int ** provFlags,
00995                         /*@null@*/ /*@out@*/ const char *** provVersions)
00996         /*@modifies *provNames, *provFlags, *provVersions @*/;
00997 
01005 int rpmvercmp(const char * a, const char * b)
01006         /*@*/;
01007 
01013 int rpmCheckRpmlibProvides(const rpmds key)
01014         /*@*/;
01015 
01020 void rpmShowRpmlibProvides(FILE * fp)
01021         /*@globals fileSystem @*/
01022         /*@modifies *fp, fileSystem @*/;
01023 
01031 /*@-redecl@*/
01032 /*@observer@*/ extern const char *const tagName(int tag)
01033         /*@*/;
01034 /*@=redecl@*/
01035 
01041 int tagValue(const char * tagstr)
01042         /*@*/;
01043 
01044 #define RPMLEAD_BINARY 0
01045 #define RPMLEAD_SOURCE 1
01046 
01047 #define RPMLEAD_MAGIC0 0xed
01048 #define RPMLEAD_MAGIC1 0xab
01049 #define RPMLEAD_MAGIC2 0xee
01050 #define RPMLEAD_MAGIC3 0xdb
01051 
01052 #define RPMLEAD_SIZE 96         
01060 struct rpmlead {
01061     unsigned char magic[4];
01062     unsigned char major;
01063     unsigned char minor;
01064     short type;
01065     short archnum;
01066     char name[66];
01067     short osnum;
01068     short signature_type;       
01069 /*@unused@*/ char reserved[16]; 
01070 } ;
01071 
01075 void freeFilesystems(void)
01076         /*@globals internalState@*/
01077         /*@modifies internalState@*/;
01078 
01085 /*@-incondefs@*/
01086 int rpmGetFilesystemList( /*@null@*/ /*@out@*/ const char *** listptr,
01087                 /*@null@*/ /*@out@*/ int * num)
01088         /*@globals fileSystem, internalState @*/
01089         /*@modifies *listptr, *num, fileSystem, internalState @*/
01090         /*@requires maxSet(listptr) >= 0 /\ maxSet(num) >= 0 @*/
01091         /*@ensures maxRead(num) == 0 @*/;
01092 /*@=incondefs@*/
01093 
01103 /*@-incondefs@*/
01104 int rpmGetFilesystemUsage(const char ** fileList, int_32 * fssizes,
01105                 int numFiles, /*@null@*/ /*@out@*/ uint_32 ** usagesPtr,
01106                 int flags)
01107         /*@globals rpmGlobalMacroContext,
01108                 fileSystem, internalState @*/
01109         /*@modifies *usagesPtr, rpmGlobalMacroContext,
01110                 fileSystem, internalState @*/
01111         /*@requires maxSet(fileList) >= 0 /\ maxSet(fssizes) == 0
01112                 /\ maxSet(usagesPtr) >= 0 @*/
01113         /*@ensures maxRead(usagesPtr) == 0 @*/;
01114 /*@=incondefs@*/
01115 
01116 /* ==================================================================== */
01119 /* --- install/upgrade/erase modes */
01120 
01125 typedef enum rpmInstallInterfaceFlags_e {
01126     INSTALL_NONE        = 0,
01127     INSTALL_PERCENT     = (1 << 0),     
01128     INSTALL_HASH        = (1 << 1),     
01129     INSTALL_NODEPS      = (1 << 2),     
01130     INSTALL_NOORDER     = (1 << 3),     
01131     INSTALL_LABEL       = (1 << 4),     
01132     INSTALL_UPGRADE     = (1 << 5),     
01133     INSTALL_FRESHEN     = (1 << 6),     
01134     INSTALL_INSTALL     = (1 << 7),     
01135     INSTALL_ERASE       = (1 << 8)      
01136 } rpmInstallInterfaceFlags;
01137 
01141 typedef enum rpmEraseInterfaceFlags_e {
01142     UNINSTALL_NONE      = 0,
01143     UNINSTALL_NODEPS    = (1 << 0),     
01144     UNINSTALL_ALLMATCHES= (1 << 1)      
01145 } rpmEraseInterfaceFlags;
01146 
01148 /* ==================================================================== */
01151 
01155 enum rpmtagSignature {
01156     RPMSIGTAG_SIZE      = 1000, 
01157     RPMSIGTAG_LEMD5_1   = 1001, 
01158     RPMSIGTAG_PGP       = 1002, 
01159     RPMSIGTAG_LEMD5_2   = 1003, 
01160     RPMSIGTAG_MD5       = 1004, 
01161     RPMSIGTAG_GPG       = 1005, 
01162     RPMSIGTAG_PGP5      = 1006, 
01163     RPMSIGTAG_PAYLOADSIZE = 1007,
01164     RPMSIGTAG_BADSHA1_1 = RPMTAG_BADSHA1_1,     
01165     RPMSIGTAG_BADSHA1_2 = RPMTAG_BADSHA1_2,     
01166     RPMSIGTAG_SHA1      = RPMTAG_SHA1HEADER,    
01167     RPMSIGTAG_DSA       = RPMTAG_DSAHEADER,     
01168     RPMSIGTAG_RSA       = RPMTAG_RSAHEADER      
01169 };
01170 
01184 rpmRC rpmVerifySignature(const rpmts ts,
01185                 /*@out@*/ char * result)
01186         /*@globals rpmGlobalMacroContext, fileSystem, internalState @*/
01187         /*@modifies ts, *result, rpmGlobalMacroContext,
01188                 fileSystem, internalState @*/;
01189 
01195 /*@null@*/ Header rpmFreeSignature(/*@null@*/ /*@killref@*/ Header h)
01196         /*@modifies h @*/;
01197 
01200 #ifdef __cplusplus
01201 }
01202 #endif
01203 
01204 #endif  /* H_RPMLIB */

Generated on Sun Oct 26 13:02:00 2003 for rpm by doxygen1.2.18