rpm  4.17.1.1
header.h
Go to the documentation of this file.
1 #ifndef H_HEADER
2 #define H_HEADER
3 
13 /* RPM - Copyright (C) 1995-2001 Red Hat Software */
14 
15 #include <rpm/rpmio.h>
16 #include <rpm/rpmtypes.h>
17 #include <rpm/rpmtd.h>
18 #include <rpm/rpmutil.h>
19 
20 #ifdef __cplusplus
21 extern "C" {
22 #endif
23 
27 extern const unsigned char rpm_header_magic[8];
28 
32 enum hMagic {
35 };
36 
41 Header headerNew(void);
42 
49 
56 
63 unsigned int headerSizeof(Header h, int magicp);
64 
72 void * headerUnload(Header h);
73 
80 void * headerExport(Header h, unsigned int * bsize);
81 
90 
97 
105 Header headerLoad(void * uh);
106 
114 Header headerCopyLoad(const void * uh);
115 
117  HEADERIMPORT_COPY = (1 << 0), /* Make copy of blob on import? */
118  HEADERIMPORT_FAST = (1 << 1), /* Faster but less safe? */
119 };
120 
122 
130 Header headerImport(void *blob, unsigned int bsize, headerImportFlags flags);
131 
138 Header headerRead(FD_t fd, int magicp);
139 
147 int headerWrite(FD_t fd, Header h, int magicp);
148 
155 int headerIsEntry(Header h, rpmTagVal tag);
156 
167  HEADERGET_DEFAULT = 0, /* legacy headerGetEntry() behavior */
168  HEADERGET_MINMEM = (1 << 0), /* pointers can refer to header memory */
169  HEADERGET_EXT = (1 << 1), /* lookup extension types too */
170  HEADERGET_RAW = (1 << 2), /* return raw contents (no i18n lookups) */
171  HEADERGET_ALLOC = (1 << 3), /* always allocate memory for all data */
172  HEADERGET_ARGV = (1 << 4), /* return string arrays NULL-terminated */
173 };
174 
176 
185 int headerGet(Header h, rpmTagVal tag, rpmtd td, headerGetFlags flags);
186 
187 
190  HEADERPUT_APPEND = (1 << 0),
191 };
192 
194 
203 int headerPut(Header h, rpmtd td, headerPutFlags flags);
204 
228 int headerPutBin(Header h, rpmTagVal tag, const uint8_t *val, rpm_count_t size);
229 int headerPutString(Header h, rpmTagVal tag, const char *val);
230 int headerPutStringArray(Header h, rpmTagVal tag, const char **val, rpm_count_t size);
231 int headerPutChar(Header h, rpmTagVal tag, const char *val, rpm_count_t size);
232 int headerPutUint8(Header h, rpmTagVal tag, const uint8_t *val, rpm_count_t size);
233 int headerPutUint16(Header h, rpmTagVal tag, const uint16_t *val, rpm_count_t size);
234 int headerPutUint32(Header h, rpmTagVal tag, const uint32_t *val, rpm_count_t size);
235 int headerPutUint64(Header h, rpmTagVal tag, const uint64_t *val, rpm_count_t size);
258 int headerAddI18NString(Header h, rpmTagVal tag, const char * string,
259  const char * lang);
260 
268 int headerMod(Header h, rpmtd td);
269 
279 int headerDel(Header h, rpmTagVal tag);
280 
290 char * headerFormat(Header h, const char * fmt, errmsg_t * errmsg);
291 
298 void headerCopyTags(Header headerFrom, Header headerTo,
299  const rpmTagVal * tagstocopy);
300 
307 
314 
321 int headerNext(HeaderIterator hi, rpmtd td);
322 
329 
336 char * headerGetAsString(Header h, rpmTagVal tag);
337 
344 const char * headerGetString(Header h, rpmTagVal tag);
345 
352 uint64_t headerGetNumber(Header h, rpmTagVal tag);
353 
359 int headerIsSource(Header h);
360 
366 unsigned int headerGetInstance(Header h);
367 
368 typedef enum headerConvOps_e {
372 } headerConvOps;
373 
380 int headerConvert(Header h, int op);
381 
382 #ifdef __cplusplus
383 }
384 #endif
385 
386 #endif /* H_HEADER */
void * headerExport(Header h, unsigned int *bsize)
Export header to on-disk representation.
Header headerNew(void)
Create new (empty) header instance.
int headerPutBin(Header h, rpmTagVal tag, const uint8_t *val, rpm_count_t size)
Type-safe methods for inserting tag data to header.
HeaderIterator headerInitIterator(Header h)
Create header tag iterator.
unsigned int headerSizeof(Header h, int magicp)
Return size of on-disk header representation in bytes.
Header headerImport(void *blob, unsigned int bsize, headerImportFlags flags)
Import header to in-memory representation.
RPM_GNUC_DEPRECATED Header headerLoad(void *uh)
Convert header to in-memory representation.
headerImportFlags_e
Definition: header.h:116
int headerPut(Header h, rpmtd td, headerPutFlags flags)
Add or append tag to header.
void headerCopyTags(Header headerFrom, Header headerTo, const rpmTagVal *tagstocopy)
Duplicate tag values from one header into another.
char * headerFormat(Header h, const char *fmt, errmsg_t *errmsg)
Return formatted output string from header tags.
uint64_t headerGetNumber(Header h, rpmTagVal tag)
Return a simple number tag (or extension) from header.
Header headerFree(Header h)
Dereference a header instance.
HeaderIterator headerFreeIterator(HeaderIterator hi)
Destroy header tag iterator.
Header headerLink(Header h)
Reference a header instance.
#define RPM_GNUC_DEPRECATED
Definition: rpmutil.h:81
RPM_GNUC_DEPRECATED Header headerCopyLoad(const void *uh)
Make a copy and convert header to in-memory representation.
int headerDel(Header h, rpmTagVal tag)
Delete tag in header.
headerGetFlags_e
Modifier flags for headerGet() operation.
Definition: header.h:166
uint32_t rpmFlags
Definition: rpmtypes.h:42
int headerPutString(Header h, rpmTagVal tag, const char *val)
int headerGet(Header h, rpmTagVal tag, rpmtd td, headerGetFlags flags)
Retrieve tag value.
const unsigned char rpm_header_magic[8]
Header magic value.
int headerPutStringArray(Header h, rpmTagVal tag, const char **val, rpm_count_t size)
struct _FD_s * FD_t
RPM IO file descriptor type.
Definition: rpmtypes.h:99
rpmFlags headerImportFlags
Definition: header.h:121
int headerConvert(Header h, int op)
Convert header to/from (legacy) data presentation.
int headerPutUint8(Header h, rpmTagVal tag, const uint8_t *val, rpm_count_t size)
struct headerToken_s * Header
RPM header and data retrieval types.
Definition: rpmtypes.h:24
struct headerIterator_s * HeaderIterator
Definition: rpmtypes.h:25
rpmTagVal headerNextTag(HeaderIterator hi)
Return next tag number from header.
uint32_t rpm_count_t
Definition: rpmtypes.h:29
Header headerCopy(Header h)
Duplicate a header.
int headerPutUint64(Header h, rpmTagVal tag, const uint64_t *val, rpm_count_t size)
Header headerReload(Header h, rpmTagVal tag)
Convert header to on-disk representation, and then reload.
rpm_tag_t rpmTagVal
Definition: rpmtypes.h:30
Header headerRead(FD_t fd, int magicp)
Read (and load) header from file handle.
int headerMod(Header h, rpmtd td)
Modify tag in header.
rpmFlags headerPutFlags
Definition: header.h:193
char * headerGetAsString(Header h, rpmTagVal tag)
Return any non-array tag from header, converted to string.
int headerPutChar(Header h, rpmTagVal tag, const char *val, rpm_count_t size)
unsigned int headerGetInstance(Header h)
Return header instance, ie is the header from rpmdb.
headerPutFlags_e
Definition: header.h:188
int headerNext(HeaderIterator hi, rpmtd td)
Return next tag contents from header.
rpmFlags headerGetFlags
Definition: header.h:175
Container for rpm tag data (from headers or extensions).
Definition: rpmtd.h:32
int headerIsSource(Header h)
Check if header is a source or binary package header.
int headerIsEntry(Header h, rpmTagVal tag)
Check if tag is in header.
int headerAddI18NString(Header h, rpmTagVal tag, const char *string, const char *lang)
Add locale specific tag to header.
RPM_GNUC_DEPRECATED void * headerUnload(Header h)
Convert header to on-disk representation.
int headerWrite(FD_t fd, Header h, int magicp)
Write (with unload) header to file handle.
enum headerConvOps_e headerConvOps
const char * headerGetString(Header h, rpmTagVal tag)
Return a simple string tag from header.
const char * errmsg_t
Definition: rpmtypes.h:17
int headerPutUint16(Header h, rpmTagVal tag, const uint16_t *val, rpm_count_t size)
hMagic
Include calculation for 8 bytes of (magic, 0)?
Definition: header.h:32
int headerPutUint32(Header h, rpmTagVal tag, const uint32_t *val, rpm_count_t size)
headerConvOps_e
Definition: header.h:368