allow rpm to custom systemd installation
[platform/upstream/rpm.git] / lib / rpmtag.h
1 #ifndef _RPMTAG_H
2 #define _RPMTAG_H
3
4 #include <rpm/rpmtypes.h>
5
6 #ifdef __cplusplus
7 extern "C" {
8 #endif
9
10 /**
11  * Header private tags.
12  * @note General use tags should start at 1000 (RPM's tag space starts there).
13  */
14 #define HEADER_IMAGE            61
15 #define HEADER_SIGNATURES       62
16 #define HEADER_IMMUTABLE        63
17 #define HEADER_REGIONS          64
18 #define HEADER_I18NTABLE        100
19 #define HEADER_SIGBASE          256
20 #define HEADER_TAGBASE          1000
21
22 /** \ingroup rpmtag
23  * Tags identify data in package headers.
24  * @note tags should not have value 0!
25  * @note all new tags should be added above 5000
26  */
27 /** @todo: Somehow supply type **/
28 typedef enum rpmTag_e {
29     RPMTAG_NOT_FOUND            = -1,                   /*!< Unknown tag */
30
31     RPMTAG_HEADERIMAGE          = HEADER_IMAGE,         /*!< Current image. */
32     RPMTAG_HEADERSIGNATURES     = HEADER_SIGNATURES,    /*!< Signatures. */
33     RPMTAG_HEADERIMMUTABLE      = HEADER_IMMUTABLE,     /*!< Original image. */
34     RPMTAG_HEADERREGIONS        = HEADER_REGIONS,       /*!< Regions. */
35
36     RPMTAG_HEADERI18NTABLE      = HEADER_I18NTABLE,     /* s[] !< I18N string locales. */
37
38 /* Retrofit (and uniqify) signature tags for use by rpmTagGetName() and rpmQuery. */
39 /* the md5 sum was broken *twice* on big endian machines */
40 /* XXX 2nd underscore prevents tagTable generation */
41     RPMTAG_SIG_BASE             = HEADER_SIGBASE,
42     RPMTAG_SIGSIZE              = RPMTAG_SIG_BASE+1,    /* i */
43     RPMTAG_SIGLEMD5_1           = RPMTAG_SIG_BASE+2,    /* internal - obsolete */
44     RPMTAG_SIGPGP               = RPMTAG_SIG_BASE+3,    /* x */
45     RPMTAG_SIGLEMD5_2           = RPMTAG_SIG_BASE+4,    /* x internal - obsolete */
46     RPMTAG_SIGMD5               = RPMTAG_SIG_BASE+5,    /* x */
47 #define RPMTAG_PKGID    RPMTAG_SIGMD5                   /* x */
48     RPMTAG_SIGGPG               = RPMTAG_SIG_BASE+6,    /* x */
49     RPMTAG_SIGPGP5              = RPMTAG_SIG_BASE+7,    /* internal - obsolete */
50
51     RPMTAG_BADSHA1_1            = RPMTAG_SIG_BASE+8,    /* internal - obsolete */
52     RPMTAG_BADSHA1_2            = RPMTAG_SIG_BASE+9,    /* internal - obsolete */
53     RPMTAG_PUBKEYS              = RPMTAG_SIG_BASE+10,   /* s[] */
54     RPMTAG_DSAHEADER            = RPMTAG_SIG_BASE+11,   /* x */
55     RPMTAG_RSAHEADER            = RPMTAG_SIG_BASE+12,   /* x */
56     RPMTAG_SHA1HEADER           = RPMTAG_SIG_BASE+13,   /* s */
57 #define RPMTAG_HDRID    RPMTAG_SHA1HEADER       /* s */
58     RPMTAG_LONGSIGSIZE          = RPMTAG_SIG_BASE+14,   /* l */
59     RPMTAG_LONGARCHIVESIZE      = RPMTAG_SIG_BASE+15,   /* l */
60
61     RPMTAG_NAME                 = 1000, /* s */
62 #define RPMTAG_N        RPMTAG_NAME     /* s */
63     RPMTAG_VERSION              = 1001, /* s */
64 #define RPMTAG_V        RPMTAG_VERSION  /* s */
65     RPMTAG_RELEASE              = 1002, /* s */
66 #define RPMTAG_R        RPMTAG_RELEASE  /* s */
67     RPMTAG_EPOCH                = 1003, /* i */
68 #define RPMTAG_E        RPMTAG_EPOCH    /* i */
69     RPMTAG_SUMMARY              = 1004, /* s{} */
70     RPMTAG_DESCRIPTION          = 1005, /* s{} */
71     RPMTAG_BUILDTIME            = 1006, /* i */
72     RPMTAG_BUILDHOST            = 1007, /* s */
73     RPMTAG_INSTALLTIME          = 1008, /* i */
74     RPMTAG_SIZE                 = 1009, /* i */
75     RPMTAG_DISTRIBUTION         = 1010, /* s */
76     RPMTAG_VENDOR               = 1011, /* s */
77     RPMTAG_GIF                  = 1012, /* x */
78     RPMTAG_XPM                  = 1013, /* x */
79     RPMTAG_LICENSE              = 1014, /* s */
80     RPMTAG_PACKAGER             = 1015, /* s */
81     RPMTAG_GROUP                = 1016, /* s{} */
82     RPMTAG_CHANGELOG            = 1017, /* s[] internal */
83     RPMTAG_SOURCE               = 1018, /* s[] */
84     RPMTAG_PATCH                = 1019, /* s[] */
85     RPMTAG_URL                  = 1020, /* s */
86     RPMTAG_OS                   = 1021, /* s legacy used int */
87     RPMTAG_ARCH                 = 1022, /* s legacy used int */
88     RPMTAG_PREIN                = 1023, /* s */
89     RPMTAG_POSTIN               = 1024, /* s */
90     RPMTAG_PREUN                = 1025, /* s */
91     RPMTAG_POSTUN               = 1026, /* s */
92     RPMTAG_OLDFILENAMES         = 1027, /* s[] obsolete */
93     RPMTAG_FILESIZES            = 1028, /* i[] */
94     RPMTAG_FILESTATES           = 1029, /* c[] */
95     RPMTAG_FILEMODES            = 1030, /* h[] */
96     RPMTAG_FILEUIDS             = 1031, /* i[] internal - obsolete */
97     RPMTAG_FILEGIDS             = 1032, /* i[] internal - obsolete */
98     RPMTAG_FILERDEVS            = 1033, /* h[] */
99     RPMTAG_FILEMTIMES           = 1034, /* i[] */
100     RPMTAG_FILEDIGESTS          = 1035, /* s[] */
101 #define RPMTAG_FILEMD5S RPMTAG_FILEDIGESTS /* s[] */
102     RPMTAG_FILELINKTOS          = 1036, /* s[] */
103     RPMTAG_FILEFLAGS            = 1037, /* i[] */
104     RPMTAG_ROOT                 = 1038, /* internal - obsolete */
105     RPMTAG_FILEUSERNAME         = 1039, /* s[] */
106     RPMTAG_FILEGROUPNAME        = 1040, /* s[] */
107     RPMTAG_EXCLUDE              = 1041, /* internal - obsolete */
108     RPMTAG_EXCLUSIVE            = 1042, /* internal - obsolete */
109     RPMTAG_ICON                 = 1043, /* x */
110     RPMTAG_SOURCERPM            = 1044, /* s */
111     RPMTAG_FILEVERIFYFLAGS      = 1045, /* i[] */
112     RPMTAG_ARCHIVESIZE          = 1046, /* i */
113     RPMTAG_PROVIDENAME          = 1047, /* s[] */
114 #define RPMTAG_PROVIDES RPMTAG_PROVIDENAME      /* s[] */
115 #define RPMTAG_P        RPMTAG_PROVIDENAME      /* s[] */
116     RPMTAG_REQUIREFLAGS         = 1048, /* i[] */
117     RPMTAG_REQUIRENAME          = 1049, /* s[] */
118 #define RPMTAG_REQUIRES RPMTAG_REQUIRENAME      /* s[] */
119     RPMTAG_REQUIREVERSION       = 1050, /* s[] */
120     RPMTAG_NOSOURCE             = 1051, /* i */
121     RPMTAG_NOPATCH              = 1052, /* i */
122     RPMTAG_CONFLICTFLAGS        = 1053, /* i[] */
123     RPMTAG_CONFLICTNAME         = 1054, /* s[] */
124 #define RPMTAG_CONFLICTS RPMTAG_CONFLICTNAME    /* s[] */
125 #define RPMTAG_C        RPMTAG_CONFLICTNAME     /* s[] */
126     RPMTAG_CONFLICTVERSION      = 1055, /* s[] */
127     RPMTAG_DEFAULTPREFIX        = 1056, /* s internal - deprecated */
128     RPMTAG_BUILDROOT            = 1057, /* s internal - obsolete */
129     RPMTAG_INSTALLPREFIX        = 1058, /* s internal - deprecated */
130     RPMTAG_EXCLUDEARCH          = 1059, /* s[] */
131     RPMTAG_EXCLUDEOS            = 1060, /* s[] */
132     RPMTAG_EXCLUSIVEARCH        = 1061, /* s[] */
133     RPMTAG_EXCLUSIVEOS          = 1062, /* s[] */
134     RPMTAG_AUTOREQPROV          = 1063, /* s internal */
135     RPMTAG_RPMVERSION           = 1064, /* s */
136     RPMTAG_TRIGGERSCRIPTS       = 1065, /* s[] */
137     RPMTAG_TRIGGERNAME          = 1066, /* s[] */
138     RPMTAG_TRIGGERVERSION       = 1067, /* s[] */
139     RPMTAG_TRIGGERFLAGS         = 1068, /* i[] */
140     RPMTAG_TRIGGERINDEX         = 1069, /* i[] */
141     RPMTAG_VERIFYSCRIPT         = 1079, /* s */
142     RPMTAG_CHANGELOGTIME        = 1080, /* i[] */
143     RPMTAG_CHANGELOGNAME        = 1081, /* s[] */
144     RPMTAG_CHANGELOGTEXT        = 1082, /* s[] */
145     RPMTAG_BROKENMD5            = 1083, /* internal - obsolete */
146     RPMTAG_PREREQ               = 1084, /* internal */
147     RPMTAG_PREINPROG            = 1085, /* s[] */
148     RPMTAG_POSTINPROG           = 1086, /* s[] */
149     RPMTAG_PREUNPROG            = 1087, /* s[] */
150     RPMTAG_POSTUNPROG           = 1088, /* s[] */
151     RPMTAG_BUILDARCHS           = 1089, /* s[] */
152     RPMTAG_OBSOLETENAME         = 1090, /* s[] */
153 #define RPMTAG_OBSOLETES RPMTAG_OBSOLETENAME    /* s[] */
154 #define RPMTAG_O        RPMTAG_OBSOLETENAME     /* s[] */
155     RPMTAG_VERIFYSCRIPTPROG     = 1091, /* s[] */
156     RPMTAG_TRIGGERSCRIPTPROG    = 1092, /* s[] */
157     RPMTAG_DOCDIR               = 1093, /* internal */
158     RPMTAG_COOKIE               = 1094, /* s */
159     RPMTAG_FILEDEVICES          = 1095, /* i[] */
160     RPMTAG_FILEINODES           = 1096, /* i[] */
161     RPMTAG_FILELANGS            = 1097, /* s[] */
162     RPMTAG_PREFIXES             = 1098, /* s[] */
163     RPMTAG_INSTPREFIXES         = 1099, /* s[] */
164     RPMTAG_TRIGGERIN            = 1100, /* internal */
165     RPMTAG_TRIGGERUN            = 1101, /* internal */
166     RPMTAG_TRIGGERPOSTUN        = 1102, /* internal */
167     RPMTAG_AUTOREQ              = 1103, /* internal */
168     RPMTAG_AUTOPROV             = 1104, /* internal */
169     RPMTAG_CAPABILITY           = 1105, /* i internal - obsolete */
170     RPMTAG_SOURCEPACKAGE        = 1106, /* i */
171     RPMTAG_OLDORIGFILENAMES     = 1107, /* internal - obsolete */
172     RPMTAG_BUILDPREREQ          = 1108, /* internal */
173     RPMTAG_BUILDREQUIRES        = 1109, /* internal */
174     RPMTAG_BUILDCONFLICTS       = 1110, /* internal */
175     RPMTAG_BUILDMACROS          = 1111, /* internal - unused */
176     RPMTAG_PROVIDEFLAGS         = 1112, /* i[] */
177     RPMTAG_PROVIDEVERSION       = 1113, /* s[] */
178     RPMTAG_OBSOLETEFLAGS        = 1114, /* i[] */
179     RPMTAG_OBSOLETEVERSION      = 1115, /* s[] */
180     RPMTAG_DIRINDEXES           = 1116, /* i[] */
181     RPMTAG_BASENAMES            = 1117, /* s[] */
182     RPMTAG_DIRNAMES             = 1118, /* s[] */
183     RPMTAG_ORIGDIRINDEXES       = 1119, /* i[] relocation */
184     RPMTAG_ORIGBASENAMES        = 1120, /* s[] relocation */
185     RPMTAG_ORIGDIRNAMES         = 1121, /* s[] relocation */
186     RPMTAG_OPTFLAGS             = 1122, /* s */
187     RPMTAG_DISTURL              = 1123, /* s */
188     RPMTAG_PAYLOADFORMAT        = 1124, /* s */
189     RPMTAG_PAYLOADCOMPRESSOR    = 1125, /* s */
190     RPMTAG_PAYLOADFLAGS         = 1126, /* s */
191     RPMTAG_INSTALLCOLOR         = 1127, /* i transaction color when installed */
192     RPMTAG_INSTALLTID           = 1128, /* i */
193     RPMTAG_REMOVETID            = 1129, /* i */
194     RPMTAG_SHA1RHN              = 1130, /* internal - obsolete */
195     RPMTAG_RHNPLATFORM          = 1131, /* s internal - obsolete */
196     RPMTAG_PLATFORM             = 1132, /* s */
197     RPMTAG_PATCHESNAME          = 1133, /* s[] deprecated placeholder (SuSE) */
198     RPMTAG_PATCHESFLAGS         = 1134, /* i[] deprecated placeholder (SuSE) */
199     RPMTAG_PATCHESVERSION       = 1135, /* s[] deprecated placeholder (SuSE) */
200     RPMTAG_CACHECTIME           = 1136, /* i internal - obsolete */
201     RPMTAG_CACHEPKGPATH         = 1137, /* s internal - obsolete */
202     RPMTAG_CACHEPKGSIZE         = 1138, /* i internal - obsolete */
203     RPMTAG_CACHEPKGMTIME        = 1139, /* i internal - obsolete */
204     RPMTAG_FILECOLORS           = 1140, /* i[] */
205     RPMTAG_FILECLASS            = 1141, /* i[] */
206     RPMTAG_CLASSDICT            = 1142, /* s[] */
207     RPMTAG_FILEDEPENDSX         = 1143, /* i[] */
208     RPMTAG_FILEDEPENDSN         = 1144, /* i[] */
209     RPMTAG_DEPENDSDICT          = 1145, /* i[] */
210     RPMTAG_SOURCEPKGID          = 1146, /* x */
211     RPMTAG_FILECONTEXTS         = 1147, /* s[] - obsolete */
212     RPMTAG_FSCONTEXTS           = 1148, /* s[] extension */
213     RPMTAG_RECONTEXTS           = 1149, /* s[] extension */
214     RPMTAG_POLICIES             = 1150, /* s[] selinux *.te policy file. */
215     RPMTAG_PRETRANS             = 1151, /* s */
216     RPMTAG_POSTTRANS            = 1152, /* s */
217     RPMTAG_PRETRANSPROG         = 1153, /* s[] */
218     RPMTAG_POSTTRANSPROG        = 1154, /* s[] */
219     RPMTAG_DISTTAG              = 1155, /* s */
220     RPMTAG_SUGGESTSNAME         = 1156, /* s[] extension */
221 #define RPMTAG_SUGGESTS RPMTAG_SUGGESTSNAME     /* s[] */
222     RPMTAG_SUGGESTSVERSION      = 1157, /* s[] extension */
223     RPMTAG_SUGGESTSFLAGS        = 1158, /* i[] extension */
224     RPMTAG_ENHANCESNAME         = 1159, /* s[] extension */
225 #define RPMTAG_ENHANCES RPMTAG_ENHANCESNAME     /* s[] */
226     RPMTAG_ENHANCESVERSION      = 1160, /* s[] extension */
227     RPMTAG_ENHANCESFLAGS        = 1161, /* i[] extension */
228     RPMTAG_PRIORITY             = 1162, /* i[] extension placeholder (unimplemented) */
229     RPMTAG_CVSID                = 1163, /* s (unimplemented) */
230 #define RPMTAG_SVNID    RPMTAG_CVSID    /* s (unimplemented) */
231     RPMTAG_BLINKPKGID           = 1164, /* s[] (unimplemented) */
232     RPMTAG_BLINKHDRID           = 1165, /* s[] (unimplemented) */
233     RPMTAG_BLINKNEVRA           = 1166, /* s[] (unimplemented) */
234     RPMTAG_FLINKPKGID           = 1167, /* s[] (unimplemented) */
235     RPMTAG_FLINKHDRID           = 1168, /* s[] (unimplemented) */
236     RPMTAG_FLINKNEVRA           = 1169, /* s[] (unimplemented) */
237     RPMTAG_PACKAGEORIGIN        = 1170, /* s (unimplemented) */
238     RPMTAG_TRIGGERPREIN         = 1171, /* internal */
239     RPMTAG_BUILDSUGGESTS        = 1172, /* internal (unimplemented) */
240     RPMTAG_BUILDENHANCES        = 1173, /* internal (unimplemented) */
241     RPMTAG_SCRIPTSTATES         = 1174, /* i[] scriptlet exit codes (unimplemented) */
242     RPMTAG_SCRIPTMETRICS        = 1175, /* i[] scriptlet execution times (unimplemented) */
243     RPMTAG_BUILDCPUCLOCK        = 1176, /* i (unimplemented) */
244     RPMTAG_FILEDIGESTALGOS      = 1177, /* i[] (unimplemented) */
245     RPMTAG_VARIANTS             = 1178, /* s[] (unimplemented) */
246     RPMTAG_XMAJOR               = 1179, /* i (unimplemented) */
247     RPMTAG_XMINOR               = 1180, /* i (unimplemented) */
248     RPMTAG_REPOTAG              = 1181, /* s (unimplemented) */
249     RPMTAG_KEYWORDS             = 1182, /* s[] (unimplemented) */
250     RPMTAG_BUILDPLATFORMS       = 1183, /* s[] (unimplemented) */
251     RPMTAG_PACKAGECOLOR         = 1184, /* i (unimplemented) */
252     RPMTAG_PACKAGEPREFCOLOR     = 1185, /* i (unimplemented) */
253     RPMTAG_XATTRSDICT           = 1186, /* s[] (unimplemented) */
254     RPMTAG_FILEXATTRSX          = 1187, /* i[] (unimplemented) */
255     RPMTAG_DEPATTRSDICT         = 1188, /* s[] (unimplemented) */
256     RPMTAG_CONFLICTATTRSX       = 1189, /* i[] (unimplemented) */
257     RPMTAG_OBSOLETEATTRSX       = 1190, /* i[] (unimplemented) */
258     RPMTAG_PROVIDEATTRSX        = 1191, /* i[] (unimplemented) */
259     RPMTAG_REQUIREATTRSX        = 1192, /* i[] (unimplemented) */
260     RPMTAG_BUILDPROVIDES        = 1193, /* internal (unimplemented) */
261     RPMTAG_BUILDOBSOLETES       = 1194, /* internal (unimplemented) */
262     RPMTAG_DBINSTANCE           = 1195, /* i extension */
263     RPMTAG_NVRA                 = 1196, /* s extension */
264     /* tags 1997-4999 reserved */
265     RPMTAG_FILENAMES            = 5000, /* s[] extension */
266     RPMTAG_FILEPROVIDE          = 5001, /* s[] extension */
267     RPMTAG_FILEREQUIRE          = 5002, /* s[] extension */
268     RPMTAG_FSNAMES              = 5003, /* s[] (unimplemented) */
269     RPMTAG_FSSIZES              = 5004, /* l[] (unimplemented) */
270     RPMTAG_TRIGGERCONDS         = 5005, /* s[] extension */
271     RPMTAG_TRIGGERTYPE          = 5006, /* s[] extension */
272     RPMTAG_ORIGFILENAMES        = 5007, /* s[] extension */
273     RPMTAG_LONGFILESIZES        = 5008, /* l[] */
274     RPMTAG_LONGSIZE             = 5009, /* l */
275     RPMTAG_FILECAPS             = 5010, /* s[] */
276     RPMTAG_FILEDIGESTALGO       = 5011, /* i file digest algorithm */
277     RPMTAG_BUGURL               = 5012, /* s */
278     RPMTAG_EVR                  = 5013, /* s extension */
279     RPMTAG_NVR                  = 5014, /* s extension */
280     RPMTAG_NEVR                 = 5015, /* s extension */
281     RPMTAG_NEVRA                = 5016, /* s extension */
282     RPMTAG_HEADERCOLOR          = 5017, /* i extension */
283     RPMTAG_VERBOSE              = 5018, /* i extension */
284     RPMTAG_EPOCHNUM             = 5019, /* i extension */
285     RPMTAG_PREINFLAGS           = 5020, /* i */
286     RPMTAG_POSTINFLAGS          = 5021, /* i */
287     RPMTAG_PREUNFLAGS           = 5022, /* i */
288     RPMTAG_POSTUNFLAGS          = 5023, /* i */
289     RPMTAG_PRETRANSFLAGS        = 5024, /* i */
290     RPMTAG_POSTTRANSFLAGS       = 5025, /* i */
291     RPMTAG_VERIFYSCRIPTFLAGS    = 5026, /* i */
292     RPMTAG_TRIGGERSCRIPTFLAGS   = 5027, /* i[] */
293     RPMTAG_COLLECTIONS          = 5029, /* s[] list of collections */
294     RPMTAG_POLICYNAMES          = 5030, /* s[] */
295     RPMTAG_POLICYTYPES          = 5031, /* s[] */
296     RPMTAG_POLICYTYPESINDEXES   = 5032, /* i[] */
297     RPMTAG_POLICYFLAGS          = 5033, /* i[] */
298     RPMTAG_VCS                  = 5034, /* s */
299     RPMTAG_ORDERNAME            = 5035, /* s[] */
300     RPMTAG_ORDERVERSION         = 5036, /* s[] */
301     RPMTAG_ORDERFLAGS           = 5037, /* i[] */
302     RPMTAG_SECMANIFEST          = 5038, /* s[] security manifest file */
303     RPMTAG_SECSWSOURCE          = 5039, /* s[] security software source */
304     RPMTAG_INSTFILENAMES        = 5040, /* s[] extension */
305     RPMTAG_REQUIRENEVRS         = 5041, /* s[] extension */
306     RPMTAG_PROVIDENEVRS         = 5042, /* s[] extension */
307     RPMTAG_OBSOLETENEVRS        = 5043, /* s[] extension */
308     RPMTAG_CONFLICTNEVRS        = 5044, /* s[] extension */
309     RPMTAG_FILENLINKS           = 5045, /* i[] extension */
310
311     RPMTAG_FIRSTFREE_TAG        /*!< internal */
312 } rpmTag;
313
314 #define RPMTAG_EXTERNAL_TAG             1000000
315
316 /** \ingroup rpmtag
317  * Rpm database index tags.
318  */
319 typedef enum rpmDbiTag_e {
320     RPMDBI_PACKAGES             = 0,    /* Installed package headers. */
321     RPMDBI_LABEL                = 2,    /* NEVRA label pseudo index */
322     RPMDBI_NAME                 = RPMTAG_NAME,
323     RPMDBI_BASENAMES            = RPMTAG_BASENAMES,
324     RPMDBI_GROUP                = RPMTAG_GROUP,
325     RPMDBI_REQUIRENAME          = RPMTAG_REQUIRENAME,
326     RPMDBI_PROVIDENAME          = RPMTAG_PROVIDENAME,
327     RPMDBI_CONFLICTNAME         = RPMTAG_CONFLICTNAME,
328     RPMDBI_OBSOLETENAME         = RPMTAG_OBSOLETENAME,
329     RPMDBI_TRIGGERNAME          = RPMTAG_TRIGGERNAME,
330     RPMDBI_DIRNAMES             = RPMTAG_DIRNAMES,
331     RPMDBI_INSTALLTID           = RPMTAG_INSTALLTID,
332     RPMDBI_SIGMD5               = RPMTAG_SIGMD5,
333     RPMDBI_SHA1HEADER           = RPMTAG_SHA1HEADER,
334     RPMDBI_INSTFILENAMES        = RPMTAG_INSTFILENAMES,
335 } rpmDbiTag;
336
337 /** \ingroup signature
338  * Tags found in signature header from package.
339  */
340 typedef enum rpmSigTag_e {
341     RPMSIGTAG_SIZE      = 1000, /*!< internal Header+Payload size (32bit) in bytes. */
342     RPMSIGTAG_LEMD5_1   = 1001, /*!< internal Broken MD5, take 1 @deprecated legacy. */
343     RPMSIGTAG_PGP       = 1002, /*!< internal PGP 2.6.3 signature. */
344     RPMSIGTAG_LEMD5_2   = 1003, /*!< internal Broken MD5, take 2 @deprecated legacy. */
345     RPMSIGTAG_MD5       = 1004, /*!< internal MD5 signature. */
346     RPMSIGTAG_GPG       = 1005, /*!< internal GnuPG signature. */
347     RPMSIGTAG_PGP5      = 1006, /*!< internal PGP5 signature @deprecated legacy. */
348     RPMSIGTAG_PAYLOADSIZE = 1007,/*!< internal uncompressed payload size (32bit) in bytes. */
349     RPMSIGTAG_BADSHA1_1 = RPMTAG_BADSHA1_1,     /*!< internal Broken SHA1, take 1. */
350     RPMSIGTAG_BADSHA1_2 = RPMTAG_BADSHA1_2,     /*!< internal Broken SHA1, take 2. */
351     RPMSIGTAG_SHA1      = RPMTAG_SHA1HEADER,    /*!< internal sha1 header digest. */
352     RPMSIGTAG_DSA       = RPMTAG_DSAHEADER,     /*!< internal DSA header signature. */
353     RPMSIGTAG_RSA       = RPMTAG_RSAHEADER,     /*!< internal RSA header signature. */
354     RPMSIGTAG_LONGSIZE  = RPMTAG_LONGSIGSIZE,   /*!< internal Header+Payload size (64bit) in bytes. */
355     RPMSIGTAG_LONGARCHIVESIZE = RPMTAG_LONGARCHIVESIZE, /*!< internal uncompressed payload size (64bit) in bytes. */
356 } rpmSigTag;
357
358
359 /** \ingroup header
360  * The basic types of data in tags from headers.
361  */
362 typedef enum rpmTagType_e {
363 #define RPM_MIN_TYPE            0
364     RPM_NULL_TYPE               =  0,
365     RPM_CHAR_TYPE               =  1,
366     RPM_INT8_TYPE               =  2,
367     RPM_INT16_TYPE              =  3,
368     RPM_INT32_TYPE              =  4,
369     RPM_INT64_TYPE              =  5,
370     RPM_STRING_TYPE             =  6,
371     RPM_BIN_TYPE                =  7,
372     RPM_STRING_ARRAY_TYPE       =  8,
373     RPM_I18NSTRING_TYPE         =  9,
374 #define RPM_MAX_TYPE            9
375 #define RPM_FORCEFREE_TYPE      0xff
376 #define RPM_MASK_TYPE           0x0000ffff
377 } rpmTagType;
378
379 /** \ingroup rpmtag
380  * The classes of data in tags from headers.
381  */
382 typedef enum rpmTagClass_e {
383     RPM_NULL_CLASS      = 0,
384     RPM_NUMERIC_CLASS   = 1,
385     RPM_STRING_CLASS    = 2,
386     RPM_BINARY_CLASS    = 3,
387 } rpmTagClass;
388
389 /** \ingroup header
390  * New rpm data types under consideration/development.
391  * These data types may (or may not) be added to rpm at some point. In order
392  * to avoid incompatibility with legacy versions of rpm, these data (sub-)types
393  * are introduced into the header by overloading RPM_BIN_TYPE, with the binary
394  * value of the tag a 16 byte image of what should/will be in the header index,
395  * followed by per-tag private data.
396  */
397 typedef enum rpmSubTagType_e {
398     RPM_REGION_TYPE             = -10,
399     RPM_BIN_ARRAY_TYPE          = -11,
400   /*!<@todo Implement, kinda like RPM_STRING_ARRAY_TYPE for known (but variable)
401         length binary data. */
402     RPM_XREF_TYPE               = -12
403   /*!<@todo Implement, intent is to to carry a (???,tagNum,valNum) cross
404         reference to retrieve data from other tags. */
405 } rpmSubTagType;
406
407 /** \ingroup header
408  *  * Identify how to return the header data type.
409  *   */
410 enum rpmTagReturnType_e {
411     RPM_ANY_RETURN_TYPE         = 0,
412     RPM_SCALAR_RETURN_TYPE      = 0x00010000,
413     RPM_ARRAY_RETURN_TYPE       = 0x00020000,
414     RPM_MAPPING_RETURN_TYPE     = 0x00040000,
415     RPM_MASK_RETURN_TYPE        = 0xffff0000
416 };
417
418 typedef rpmFlags rpmTagReturnType;
419
420 /** \ingroup rpmtag
421  * Return tag name from value.
422  * @param tag           tag value
423  * @return              tag name, "(unknown)" on not found
424  */
425 const char * rpmTagGetName(rpmTagVal tag);
426
427 /** \ingroup rpmtag
428  * Return tag data type from value.
429  * @param tag           tag value
430  * @return              tag data type + return type, RPM_NULL_TYPE on not found.
431  */
432 rpmTagType rpmTagGetType(rpmTagVal tag);
433
434 /** \ingroup rpmtag
435  * Return tag data type from value.
436  * @param tag           tag value
437  * @return              tag data type, RPM_NULL_TYPE on not found.
438  */
439 rpmTagType rpmTagGetTagType(rpmTagVal tag);
440
441 /** \ingroup rpmtag
442  * Return tag data type from value.
443  * @param tag           tag value
444  * @return              tag data return type, RPM_NULL_TYPE on not found.
445  */
446 rpmTagReturnType rpmTagGetReturnType(rpmTagVal tag);
447
448 /** \ingroup rpmtag
449  * Return tag data class from value.
450  * @param tag           tag value
451  * @return              tag data class, RPM_NULL_CLASS on not found.
452  */
453 rpmTagClass rpmTagGetClass(rpmTagVal tag);
454
455 /** \ingroup rpmtag
456  * Return tag value from name.
457  * @param tagstr        name of tag
458  * @return              tag value, -1 on not found
459  */
460 rpmTagVal rpmTagGetValue(const char * tagstr);
461
462 /** \ingroup rpmtag
463  * Return data class of type
464  * @param type          tag type
465  * @return              data class, RPM_NULL_CLASS on unknown.
466  */
467 rpmTagClass rpmTagTypeGetClass(rpmTagType type);
468
469 /** \ingroup rpmtag
470  * Return known rpm tag names, sorted by name.
471  * @retval tagnames     tag container of string array type
472  * @param fullname      return short or full name
473  * @return              number of tag names, 0 on error
474  */
475 int rpmTagGetNames(rpmtd tagnames, int fullname);
476
477 #ifdef __cplusplus
478 }
479 #endif
480
481 #endif /* _RPMTAG_H */