---

lib/header.c File Reference

More...

#include "system.h"
#include <header_internal.h>
#include "debug.h"

Go to the source code of this file.

Data Structures
struct	headerIteratorS
	Header tag iterator data structure. More...
Defines
#define	__HEADER_PROTOTYPES__
#define	PARSER_BEGIN   0
#define	PARSER_IN_ARRAY   1
#define	PARSER_IN_EXPR   2
#define	hdrchkTags(_ntags)   ((_ntags) & 0xffff0000)
	Sanity check on no. More...
#define	hdrchkData(_nbytes)   ((_nbytes) & 0xff000000)
	Sanity check on data size and/or offset. More...
Functions
const char* const	tagName (int tag)
	Return name of tag from value. More...
void*	_free (const void *p)
	Wrapper to free(3), hides const compilation noise, permit NULL, return NULL. More...
Header	headerLink (Header h)
Header	headerUnlink (Header h)
Header	headerFree (Header h)
Header	headerNew (void)
int	indexCmp (const void *avp, const void *bvp)
void	headerSort (Header h)
int	offsetCmp (const void *avp, const void *bvp)
void	headerUnsort (Header h)
unsigned int	headerSizeof (Header h, enum hMagic magicp)
int	dataLength (int_32 type, hPTR_t p, int_32 count, int onDisk)
	Return length of entry data. More...
int	regionSwab (indexEntry entry, int il, int dl, entryInfo pe, char *dataStart, int regionid)
void*	doHeaderUnload (Header h, int *lengthPtr)
void*	headerUnload (Header h)
indexEntry	findEntry (Header h, int_32 tag, int_32 type)
	Find matching (tag,type) entry in header. More...
int	headerRemoveEntry (Header h, int_32 tag)
Header	headerLoad (void *uh)
Header	headerReload (Header h, int tag)
Header	headerCopyLoad (const void *uh)
Header	headerRead (FD_t fd, enum hMagic magicp)
int	headerWrite (FD_t fd, Header h, enum hMagic magicp)
int	headerIsEntry (Header h, int_32 tag)
int	copyEntry (const indexEntry entry, hTYP_t type, hPTR_t *p, hCNT_t c, int minMem)
int	headerMatchLocale (const char *td, const char *l, const char *le)
	Does locale match entry in header i18n table? More...
char*	headerFindI18NString (Header h, indexEntry entry)
	Return i18n string from header that matches locale. More...
int	intGetEntry (Header h, int_32 tag, hTAG_t type, hPTR_t *p, hCNT_t c, int minMem)
	Retrieve tag data from header. More...
void*	headerFreeTag (Header h, const void *data, rpmTagType type)
int	headerGetEntry (Header h, int_32 tag, hTYP_t type, void **p, hCNT_t c)
int	headerGetEntryMinMemory (Header h, int_32 tag, hTYP_t type, hPTR_t *p, hCNT_t c)
int	headerGetRawEntry (Header h, int_32 tag, int_32 *type, hPTR_t *p, int_32 *c)
void	copyData (int_32 type, void *dstPtr, const void *srcPtr, int_32 c, int dataLength)
void*	grabData (int_32 type, hPTR_t p, int_32 c, int *lengthPtr)
	Return (malloc'ed) copy of entry data. More...
int	headerAddEntry (Header h, int_32 tag, int_32 type, const void *p, int_32 c)
int	headerAppendEntry (Header h, int_32 tag, int_32 type, const void *p, int_32 c)
int	headerAddOrAppendEntry (Header h, int_32 tag, int_32 type, const void *p, int_32 c)
int	headerAddI18NString (Header h, int_32 tag, const char *string, const char *lang)
int	headerModifyEntry (Header h, int_32 tag, int_32 type, const void *p, int_32 c)
char	escapedChar (const char ch)
sprintfToken	freeFormat (sprintfToken format, int num)
	Destroy headerSprintf format array. More...
void	findTag (char *name, const headerTagTableEntry tags, const headerSprintfExtension extensions, headerTagTableEntry *tagMatch, headerSprintfExtension *extMatch)
int	parseExpression (sprintfToken token, char *str, const headerTagTableEntry tags, const headerSprintfExtension extensions, char **endPtr, errmsg_t *errmsg)
int	parseFormat (char *str, const headerTagTableEntry tags, const headerSprintfExtension extensions, sprintfToken *formatPtr, int *numTokensPtr, char **endPtr, int state, errmsg_t *errmsg)
int	getExtension (Header h, headerTagTagFunction fn, hTYP_t typeptr, hPTR_t *data, hCNT_t countptr, extensionCache ext)
char*	formatValue (sprintfTag tag, Header h, const headerSprintfExtension extensions, extensionCache extCache, int element)
const char*	singleSprintf (Header h, sprintfToken token, const headerSprintfExtension extensions, extensionCache extCache, int element)
extensionCache	allocateExtensionCache (const headerSprintfExtension extensions)
extensionCache	freeExtensionCache (const headerSprintfExtension extensions, extensionCache cache)
char*	headerSprintf (Header h, const char *fmt, const struct headerTagTableEntry_s *tbltags, const struct headerSprintfExtension_s *extensions, errmsg_t *errmsg)
char*	octalFormat (int_32 type, hPTR_t data, char *formatPrefix, int padding, int element)
char*	hexFormat (int_32 type, hPTR_t data, char *formatPrefix, int padding, int element)
char*	realDateFormat (int_32 type, hPTR_t data, char *formatPrefix, int padding, int element, const char *strftimeFormat)
char*	dateFormat (int_32 type, hPTR_t data, char *formatPrefix, int padding, int element)
char*	dayFormat (int_32 type, hPTR_t data, char *formatPrefix, int padding, int element)
char*	shescapeFormat (int_32 type, hPTR_t data, char *formatPrefix, int padding, int element)
void	headerCopyTags (Header headerFrom, Header headerTo, hTAG_t tagstocopy)
HeaderIterator	headerFreeIterator (HeaderIterator hi)
HeaderIterator	headerInitIterator (Header h)
int	headerNextIterator (HeaderIterator hi, hTAG_t tag, hTYP_t type, hPTR_t *p, hCNT_t c)
Header	headerCopy (Header h)
Variables
unsigned char	header_magic [8]
size_t	headerMaxbytes = (32*1024*1024)
int	typeSizes []
HV_t	hdrVec = &hdrVec1
const struct headerSprintfExtension_s	headerDefaultFormats []
struct HV_s	hdrVec1

---

Detailed Description

Definition in file header.c.

---

Define Documentation

#define PARSER_BEGIN   0

Definition at line 31 of file header.c.

#define PARSER_IN_ARRAY   1

Definition at line 32 of file header.c.

#define PARSER_IN_EXPR   2

Definition at line 33 of file header.c.

#define __HEADER_PROTOTYPES__

Value: Definition at line 13 of file header.c.

#define hdrchkData( _nbytes )   ((_nbytes) & 0xff000000)

Sanity check on data size and/or offset. This check imposes a limit of 16Mb, more than enough. Definition at line 58 of file header.c. Referenced by doHeaderUnload(), headerCopyLoad(), headerLoad(), and headerRead().

#define hdrchkTags( _ntags )   ((_ntags) & 0xffff0000)

Sanity check on no. of tags. This check imposes a limit of 65K tags, more than enough. Definition at line 52 of file header.c. Referenced by doHeaderUnload(), headerCopyLoad(), headerLoad(), and headerRead().

---

Function Documentation

void * _free ( const void * p ) [inline, static]

Wrapper to free(3), hides const compilation noise, permit NULL, return NULL. Parameters: p   memory to free Returns: NULL always Definition at line 86 of file header.c.

extensionCache allocateExtensionCache ( const headerSprintfExtension extensions ) [static]

Definition at line 2809 of file header.c. Referenced by headerSprintf().

void copyData ( int_32 type, void * dstPtr, const void * srcPtr, int_32 c, int dataLength ) [static]

Definition at line 1632 of file header.c. Referenced by grabData(), and headerAppendEntry().

int dataLength ( int_32 type, hPTR_t p, int_32 count, int onDisk ) [static]

Return length of entry data. Todo: Remove sanity check exit's. Parameters: type   entry data type p   entry data count   entry item count onDisk   data is concatenated strings (with NUL's))? Returns: no. bytes in data Definition at line 319 of file header.c. Referenced by grabData(), headerAppendEntry(), and regionSwab().

char * dateFormat ( int_32 type, hPTR_t data, char * formatPrefix, int padding, int element ) [static]

Definition at line 3005 of file header.c.

char * dayFormat ( int_32 type, hPTR_t data, char * formatPrefix, int padding, int element ) [static]

Definition at line 3014 of file header.c.

char escapedChar ( const char ch ) [static]

Definition at line 2003 of file header.c. Referenced by parseFormat().

indexEntry findEntry ( Header h, int_32 tag, int_32 type ) [static]

Find matching (tag,type) entry in header. Parameters: h   header tag   entry tag type   entry type Returns: header entry Definition at line 771 of file header.c.

void findTag ( char * name, const headerTagTableEntry tags, const headerSprintfExtension extensions, headerTagTableEntry * tagMatch, headerSprintfExtension * extMatch ) [static]

Definition at line 2058 of file header.c. Referenced by parseExpression(), and parseFormat().

char * formatValue ( sprintfTag tag, Header h, const headerSprintfExtension extensions, extensionCache extCache, int element ) [static]

Definition at line 2515 of file header.c. Referenced by singleSprintf().

extensionCache freeExtensionCache ( const headerSprintfExtension extensions, extensionCache cache ) [static]

Returns: NULL always Definition at line 2832 of file header.c. Referenced by headerSprintf().

sprintfToken freeFormat ( sprintfToken format, int num ) [static]

Destroy headerSprintf format array. Parameters: format   sprintf format array num   number of elements Returns: NULL always Definition at line 2024 of file header.c. Referenced by parseExpression(), and parseFormat().

int getExtension ( Header h, headerTagTagFunction fn, hTYP_t typeptr, hPTR_t * data, hCNT_t countptr, extensionCache ext ) [static]

Returns: 0 on success, 1 on failure Definition at line 2493 of file header.c. Referenced by formatValue(), and singleSprintf().

void * grabData ( int_32 type, hPTR_t p, int_32 c, int * lengthPtr ) [static]

Return (malloc'ed) copy of entry data. Parameters: type   entry data type p   entry data c   entry item count Return values: lengthPtr   no. bytes in returned data Returns: (malloc'ed) copy of entry data Definition at line 1671 of file header.c. Referenced by headerAddEntry(), and headerModifyEntry().

char * headerFindI18NString ( Header h, indexEntry entry ) [static]

Return i18n string from header that matches locale. Parameters: h   header entry   i18n string data Returns: matching i18n string (or 1st string if no match) Definition at line 1445 of file header.c. Referenced by intGetEntry().

int headerGetRawEntry ( Header h, int_32 tag, int_32 * type, hPTR_t * p, int_32 * c )

Definition at line 1606 of file header.c.

int headerMatchLocale ( const char * td, const char * l, const char * le ) [static]

Does locale match entry in header i18n table? * The range [l,le) contains the next locale to match: * ll[_CC][.EEEEE][@dddd] * where * ll ISO language code (in lowercase). * CC (optional) ISO coutnry code (in uppercase). * EEEEE (optional) encoding (not really standardized). * dddd (optional) dialect. * Parameters: td   header i18n table data, NUL terminated l   start of locale to match le   end of locale to match Returns: 1 on match, 0 on no match Definition at line 1372 of file header.c. Referenced by headerFindI18NString().

char * hexFormat ( int_32 type, hPTR_t data, char * formatPrefix, int padding, int element ) [static]

Definition at line 2951 of file header.c.

int indexCmp ( const void * avp, const void * bvp ) [static]

Definition at line 188 of file header.c.

int intGetEntry ( Header h, int_32 tag, hTAG_t type, hPTR_t * p, hCNT_t c, int minMem ) [static]

Retrieve tag data from header. Parameters: h   header tag   tag to retrieve Return values: type   address of type (or NULL) p   address of data (or NULL) c   address of count (or NULL) Parameters: minMem   string pointers reference header memory? Returns: 1 on success, 0 on not found Definition at line 1499 of file header.c. Referenced by headerGetEntry(), and headerGetEntryMinMemory().

char * octalFormat ( int_32 type, hPTR_t data, char * formatPrefix, int padding, int element ) [static]

Definition at line 2930 of file header.c.

int offsetCmp ( const void * avp, const void * bvp ) [static]

Definition at line 212 of file header.c.

int parseExpression ( sprintfToken token, char * str, const headerTagTableEntry tags, const headerSprintfExtension extensions, char ** endPtr, errmsg_t * errmsg ) [static]

Definition at line 2367 of file header.c. Referenced by parseFormat().

int parseFormat ( char * str, const headerTagTableEntry tags, const headerSprintfExtension extensions, sprintfToken * formatPtr, int * numTokensPtr, char ** endPtr, int state, errmsg_t * errmsg ) [static]

Definition at line 2117 of file header.c. Referenced by headerSprintf(), and parseExpression().

char * realDateFormat ( int_32 type, hPTR_t data, char * formatPrefix, int padding, int element, const char * strftimeFormat ) [static]

Definition at line 2972 of file header.c. Referenced by dateFormat(), and dayFormat().

char * shescapeFormat ( int_32 type, hPTR_t data, char * formatPrefix, int padding, int element ) [static]

Definition at line 3024 of file header.c.

const char * singleSprintf ( Header h, sprintfToken token, const headerSprintfExtension extensions, extensionCache extCache, int element ) [static]

Definition at line 2691 of file header.c. Referenced by headerSprintf().

const char *const tagName ( int tag )

Return name of tag from value. Parameters: tag   tag value Returns: name of tag Definition at line 10 of file tagName.c.

---

Variable Documentation

HV_t hdrVec = &hdrVec1

Header methods for rpm headers. Definition at line 3250 of file header.c.

struct HV_s hdrVec1 [static]

Definition at line 3214 of file header.c.

---