rpm 5.3.7
Data Structures | Defines | Typedefs | Enumerations | Functions | Variables

rpmdb/rpmtag.h File Reference

#include <rpmiotypes.h>
#include <rpmsw.h>
Include dependency graph for rpmtag.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

union  rpmDataType_u
struct  _HE_s

Defines

#define RPM_MIN_TYPE   2
#define RPM_MAX_TYPE   9
#define RPM_MASK_TYPE   0x0000ffff
#define HEADER_IMAGE   61
 Header private tags.
#define HEADER_SIGNATURES   62
#define HEADER_IMMUTABLE   63
#define HEADER_REGIONS   64
#define HEADER_I18NTABLE   100
#define HEADER_SIGBASE   256
#define HEADER_TAGBASE   1000
#define RPMDBI_PACKAGES   0
 Pseudo-tags used by the rpmdb and rpmgi iterator API's.
#define RPMDBI_DEPENDS   1
#define RPMDBI_ADDED   3
#define RPMDBI_REMOVED   4
#define RPMDBI_AVAILABLE   5
#define RPMDBI_HDLIST   6
#define RPMDBI_ARGLIST   7
#define RPMDBI_FTSWALK   8
#define RPMDBI_SEQNO   9
#define RPMDBI_BTREE   10
#define RPMDBI_HASH   11
#define RPMDBI_QUEUE   12
#define RPMDBI_RECNO   13
#define RPMDBI_REPACKAGES   14
#define RPMDBI_REPOSITORY   15
#define RPMTAG_PKGID   RPMTAG_SIGMD5
#define RPMTAG_HDRID   RPMTAG_SHA1HEADER
#define RPMTAG_N   RPMTAG_NAME
#define RPMTAG_V   RPMTAG_VERSION
#define RPMTAG_R   RPMTAG_RELEASE
#define RPMTAG_E   RPMTAG_EPOCH
#define RPMTAG_FILEMD5S   RPMTAG_FILEDIGESTS
#define RPMTAG_PROVIDES   RPMTAG_PROVIDENAME
#define RPMTAG_P   RPMTAG_PROVIDENAME
#define RPMTAG_REQUIRES   RPMTAG_REQUIRENAME
#define RPMTAG_CONFLICTS   RPMTAG_CONFLICTNAME
#define RPMTAG_C   RPMTAG_CONFLICTNAME
#define RPMTAG_OBSOLETES   RPMTAG_OBSOLETENAME
#define RPMTAG_O   RPMTAG_OBSOLETENAME
#define RPMTAG_SUGGESTS   RPMTAG_SUGGESTSNAME
#define RPMTAG_ENHANCES   RPMTAG_ENHANCESNAME
#define RPMTAG_SVNID   RPMTAG_CVSID
#define RPMTAG_D   RPMTAG_DISTEPOCH
#define RPMTAG_EXTERNAL_TAG   1000000
#define HEADERGET_NOEXTENSION   (1 << 0)
#define HEADERGET_NOI18NSTRING   (1 << 1)
#define headerLink(_h)   ((Header)rpmioLinkPoolItem((rpmioItem)(_h), __FUNCTION__, __FILE__, __LINE__))
#define headerUnlink(_h)   ((Header)rpmioUnlinkPoolItem((rpmioItem)(_h), __FUNCTION__, __FILE__, __LINE__))
#define headerFree(_h)   ((Header)rpmioFreePoolItem((rpmioItem)(_h), __FUNCTION__, __FILE__, __LINE__))

Typedefs

typedef const char * errmsg_t
typedef struct headerToken_sHeader
typedef enum rpmTagType_e rpmTagType
typedef union rpmDataType_u rpmTagData
typedef rpmuint32_t rpmTagCount
typedef struct _HE_sHE_t
typedef enum rpmSubTagType_e rpmSubTagType
typedef enum rpmTagReturnType_e rpmTagReturnType
 Identify how to return the header data type.
typedef struct headerIterator_sHeaderIterator
typedef struct headerTagIndices_s * headerTagIndices
typedef struct
headerSprintfExtension_s * 
headerSprintfExtension
typedef enum rpmTag_e rpmTag
typedef enum rpmSigTag_e rpmSigTag
typedef struct _HE_s HE_s
typedef struct tagStore_s * tagStore_t
typedef struct
headerTagTableEntry_s * 
headerTagTableEntry

Enumerations

enum  rpmTagType_e {
  RPM_UINT8_TYPE = 2, RPM_UINT16_TYPE = 3, RPM_UINT32_TYPE = 4, RPM_UINT64_TYPE = 5,
  RPM_STRING_TYPE = 6, RPM_BIN_TYPE = 7, RPM_STRING_ARRAY_TYPE = 8, RPM_I18NSTRING_TYPE = 9
}
 

The basic types of data in tags from headers.

More...
enum  rpmSubTagType_e { RPM_REGION_TYPE = -10, RPM_BIN_ARRAY_TYPE = -11, RPM_XREF_TYPE = -12 }
enum  rpmTagReturnType_e {
  RPM_ANY_RETURN_TYPE = 0, RPM_SCALAR_RETURN_TYPE = 0x00010000, RPM_ARRAY_RETURN_TYPE = 0x00020000, RPM_MAPPING_RETURN_TYPE = 0x00040000,
  RPM_PROBE_RETURN_TYPE = 0x00100000, RPM_TREE_RETURN_TYPE = 0x00200000, RPM_OPENPGP_RETURN_TYPE = 0x00400000, RPM_X509_RETURN_TYPE = 0x00800000,
  RPM_ASN1_RETURN_TYPE = 0x01000000, RPM_OPAQUE_RETURN_TYPE = 0x10000000, RPM_MASK_RETURN_TYPE = 0xffff0000
}
 

Identify how to return the header data type.

More...
enum  rpmTag_e {
  RPMTAG_HEADERIMAGE = 61, RPMTAG_HEADERSIGNATURES = 62, RPMTAG_HEADERIMMUTABLE = 63, RPMTAG_HEADERREGIONS = 64,
  RPMTAG_HEADERI18NTABLE = 100, RPMTAG_SIG_BASE = 256, RPMTAG_SIGSIZE = RPMTAG_SIG_BASE+1, RPMTAG_SIGLEMD5_1 = RPMTAG_SIG_BASE+2,
  RPMTAG_SIGPGP = RPMTAG_SIG_BASE+3, RPMTAG_SIGLEMD5_2 = RPMTAG_SIG_BASE+4, RPMTAG_SIGMD5 = RPMTAG_SIG_BASE+5
}
 

Tags identify data in package headers.

More...
enum  rpmSigTag_e {
  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, RPMSIGTAG_PADDING = 0x3fffffff
}
 

Tags found in signature header from package.

More...

Functions

const char * tagName (rpmTag tag)
 Return tag name from value.
unsigned int tagType (rpmTag tag)
 Return tag data type from value.
rpmTag tagValue (const char *tagstr)
 Return tag value from name.
char * tagCanonicalize (const char *s)
 Canonicalize a rpmTag string.
rpmTag tagGenerate (const char *s)
 Generate a tag from arbitrary string.
void tagClean (headerTagIndices _rpmTags)
 Free memory in header tag indices.
tagStore_t tagStoreFree (tagStore_t dbiTags, size_t dbiNTags)
 Destroy tagStore array.
void rpmDisplayQueryTags (FILE *fp, headerTagTableEntry _rpmTagTable, headerSprintfExtension _rpmHeaderFormats)
 Display list of tags that can be used in --queryformat.
char * headerSprintf (Header h, const char *fmt, headerTagTableEntry tags, headerSprintfExtension exts, errmsg_t *errmsg)
 Return formatted output string from header tags.
int headerGet (Header h, HE_t he, unsigned int flags)
 Retrieve extension or tag value from a header.
int headerPut (Header h, HE_t he, unsigned int flags)
 Add or append tag container to header.
int headerDel (Header h, HE_t he, unsigned int flags)
 Remove tag container from header.
int headerMod (Header h, HE_t he, unsigned int flags)
 Modify tag container in header.
HeaderIterator headerFini (HeaderIterator hi)
 Destroy header tag container iterator.
HeaderIterator headerInit (Header h)
 Create header tag iterator.
int headerNext (HeaderIterator hi, HE_t he, unsigned int flags)
 Return next tag from header.
Header headerLink (Header h)
 Reference a header instance.
Header headerUnlink (Header h)
 Dereference a header instance.
Header headerFree (Header h)
 Dereference a header instance.
Header headerNew (void)
 Create new (empty) header instance.
size_t headerSizeof (Header h)
 Return size of on-disk header representation in bytes.
void * headerUnload (Header h, size_t *lenp)
 headerUnload.
Header headerReload (Header h, int tag)
 Convert header to on-disk representation, and then reload.
Header headerCopy (Header h)
 Duplicate a header.
Header headerLoad (void *uh)
 Convert header to in-memory representation.
Header headerCopyLoad (const void *uh)
 Make a copy and convert header to in-memory representation.
int headerIsEntry (Header h, rpmTag tag)
 Check if tag is in header.
int headerAddI18NString (Header h, rpmTag tag, const char *string, const char *lang)
 Add locale specific tag to header.
void headerCopyTags (Header headerFrom, Header headerTo, rpmTag *tagstocopy)
 Duplicate tag values from one header into another.
int headerGetMagic (Header h, unsigned char **magicp, size_t *nmagicp)
 Return header magic.
int headerSetMagic (Header h, unsigned char *magic, size_t nmagic)
 Store header magic.
const char * headerGetOrigin (Header h)
 Return header origin (e.g path or URL).
int headerSetOrigin (Header h, const char *origin)
 Store header origin (e.g path or URL).
const char * headerGetParent (Header h)
 Return header parent identifier (e.g parent's NVRA).
int headerSetParent (Header h, const char *parent)
 Store header parent (e.g parent's NVRA).
const char * headerGetBaseURL (Header h)
 Return header base URL (e.g path or URL).
int headerSetBaseURL (Header h, const char *baseurl)
 Store header base URL (e.g path or URL).
struct stat * headerGetStatbuf (Header h)
 Return header stat(2) buffer (of origin *.rpm file).
int headerSetStatbuf (Header h, struct stat *st)
 Copy into header stat(2) buffer (of origin *.rpm file).
const char * headerGetDigest (Header h)
 Return digest of origin *.rpm file.
int headerSetDigest (Header h, const char *digest)
 Store digest of origin *.rpm file.
void * headerGetRpmdb (Header h)
 Return rpmdb pointer.
void * headerSetRpmdb (Header h, void *rpmdb)
 Store rpmdb pointer.
uint32_t headerGetInstance (Header h)
 Return header instance (if from rpmdb).
uint32_t headerSetInstance (Header h, uint32_t instance)
 Store header instance (e.g path or URL).
rpmuint32_t headerGetStartOff (Header h)
 Return header starting byte offset.
rpmuint32_t headerSetStartOff (Header h, rpmuint32_t startoff)
 Store header starting byte offset.
rpmuint32_t headerGetEndOff (Header h)
 Return header ending byte offset.
rpmuint32_t headerSetEndOff (Header h, rpmuint32_t endoff)
 Store header ending byte offset.
void * headerGetStats (Header h, int opx)
 Return header stats accumulator structure.
int headerMacrosLoad (Header h)
 Define per-header macros.
int headerMacrosUnload (Header h)
 Define per-header macros.
int headerNEVRA (Header h, const char **np, const char **ep, const char **vp, const char **rp, const char **ap)
 Return name, epoch, version, release, arch strings from header.
rpmuint32_t hGetColor (Header h)
 Return header color.
void headerMergeLegacySigs (Header h, const Header sigh)
 Translate and merge legacy signature tags into header.
Header headerRegenSigHeader (const Header h, int noArchiveSize)
 Regenerate signature header.

Variables

headerTagTableEntry rpmTagTable
 Automatically generated table of tag name/value pairs.
int rpmTagTableSize
 Number of entries in rpmTagTable.
headerTagIndices rpmTags
headerSprintfExtension headerDefaultFormats
 Supported default header tag output formats.
headerSprintfExtension headerCompoundFormats
 Supported default header extension/tag output formats.

Detailed Description

Definition in file rpmtag.h.


Define Documentation

#define HEADER_I18NTABLE   100
#define HEADER_IMAGE   61

Header private tags.

Note:
General use tags should start at 1000 (RPM's tag space starts there).

Definition at line 115 of file rpmtag.h.

Referenced by copyEntry(), headerCopy(), headerLoad(), and regionSwab().

#define HEADER_IMMUTABLE   63

Definition at line 117 of file rpmtag.h.

Referenced by headerReload().

#define HEADER_REGIONS   64

Definition at line 118 of file rpmtag.h.

#define HEADER_SIGBASE   256

Definition at line 120 of file rpmtag.h.

Referenced by headerMergeLegacySigs(), and headerRegenSigHeader().

#define HEADER_SIGNATURES   62

Definition at line 116 of file rpmtag.h.

Referenced by headerReload().

#define HEADER_TAGBASE   1000

Definition at line 121 of file rpmtag.h.

Referenced by headerMergeLegacySigs(), and headerRegenSigHeader().

#define headerFree (   _h)    ((Header)rpmioFreePoolItem((rpmioItem)(_h), __FUNCTION__, __FILE__, __LINE__))

Definition at line 867 of file rpmtag.h.

#define HEADERGET_NOEXTENSION   (1 << 0)

Extension search disabler.

Definition at line 770 of file rpmtag.h.

Referenced by headerGet(), i18nTag(), localeTag(), pkgbaseurlTag(), and pkgoriginTag().

#define HEADERGET_NOI18NSTRING   (1 << 1)

Return i18n strings as argv.

Definition at line 771 of file rpmtag.h.

Referenced by intGetEntry().

#define headerLink (   _h)    ((Header)rpmioLinkPoolItem((rpmioItem)(_h), __FUNCTION__, __FILE__, __LINE__))

Definition at line 845 of file rpmtag.h.

#define headerUnlink (   _h)    ((Header)rpmioUnlinkPoolItem((rpmioItem)(_h), __FUNCTION__, __FILE__, __LINE__))

Definition at line 856 of file rpmtag.h.

#define RPM_MASK_TYPE   0x0000ffff

Definition at line 42 of file rpmtag.h.

Referenced by rpmDisplayQueryTags(), sql_bind_key(), sql_copen(), and sql_initDB().

#define RPM_MAX_TYPE   9

Definition at line 41 of file rpmtag.h.

Referenced by rpmDisplayQueryTags().

#define RPM_MIN_TYPE   2

Definition at line 40 of file rpmtag.h.

#define RPMDBI_ADDED   3
#define RPMDBI_ARGLIST   7
#define RPMDBI_AVAILABLE   5
#define RPMDBI_BTREE   10

Definition at line 148 of file rpmtag.h.

Referenced by _tagName(), _tagType(), _tagValue(), rpmdbOpenAll(), and rpmtsRebuildDB().

#define RPMDBI_DEPENDS   1
#define RPMDBI_FTSWALK   8
#define RPMDBI_HASH   11

Definition at line 149 of file rpmtag.h.

Referenced by _tagName(), _tagType(), _tagValue(), rpmdbOpenAll(), and rpmtsRebuildDB().

#define RPMDBI_HDLIST   6

Definition at line 144 of file rpmtag.h.

Referenced by _tagName(), _tagType(), _tagValue(), rpmcliArgIter(), rpmgiGlobArgv(), and rpmgiNext().

#define RPMDBI_PACKAGES   0
#define RPMDBI_QUEUE   12

Definition at line 150 of file rpmtag.h.

Referenced by _tagName(), _tagType(), _tagValue(), rpmdbOpenAll(), and rpmtsRebuildDB().

#define RPMDBI_RECNO   13

Definition at line 151 of file rpmtag.h.

Referenced by _tagName(), _tagType(), _tagValue(), rpmdbOpenAll(), and rpmtsRebuildDB().

#define RPMDBI_REMOVED   4
#define RPMDBI_REPACKAGES   14

Definition at line 152 of file rpmtag.h.

#define RPMDBI_REPOSITORY   15

Definition at line 153 of file rpmtag.h.

#define RPMDBI_SEQNO   9

Definition at line 147 of file rpmtag.h.

Referenced by _tagName(), _tagType(), _tagValue(), rpmdbAdd(), rpmdbRemove(), and rpmtsRebuildDB().

#define RPMTAG_C   RPMTAG_CONFLICTNAME

Definition at line 261 of file rpmtag.h.

#define RPMTAG_CONFLICTS   RPMTAG_CONFLICTNAME

Definition at line 260 of file rpmtag.h.

Referenced by _tagName().

#define RPMTAG_D   RPMTAG_DISTEPOCH

Definition at line 432 of file rpmtag.h.

#define RPMTAG_E   RPMTAG_EPOCH

Definition at line 198 of file rpmtag.h.

#define RPMTAG_ENHANCES   RPMTAG_ENHANCESNAME

Definition at line 371 of file rpmtag.h.

#define RPMTAG_EXTERNAL_TAG   1000000

Definition at line 463 of file rpmtag.h.

#define RPMTAG_FILEMD5S   RPMTAG_FILEDIGESTS

Definition at line 233 of file rpmtag.h.

Referenced by hdr_subscript().

#define RPMTAG_HDRID   RPMTAG_SHA1HEADER

Definition at line 189 of file rpmtag.h.

Referenced by _tagName(), addTE(), hdruuidTag(), rpmHeadersIdentical(), rpmteChain(), and singleSprintf().

#define RPMTAG_N   RPMTAG_NAME

Definition at line 192 of file rpmtag.h.

#define RPMTAG_O   RPMTAG_OBSOLETENAME

Definition at line 292 of file rpmtag.h.

#define RPMTAG_OBSOLETES   RPMTAG_OBSOLETENAME

Definition at line 291 of file rpmtag.h.

#define RPMTAG_P   RPMTAG_PROVIDENAME

Definition at line 251 of file rpmtag.h.

#define RPMTAG_PKGID   RPMTAG_SIGMD5

Definition at line 179 of file rpmtag.h.

Referenced by addTE(), pkguuidTag(), rpmQueryVerify(), and rpmteChain().

#define RPMTAG_PROVIDES   RPMTAG_PROVIDENAME

Definition at line 250 of file rpmtag.h.

Referenced by rpmdsELF().

#define RPMTAG_R   RPMTAG_RELEASE

Definition at line 196 of file rpmtag.h.

#define RPMTAG_REQUIRES   RPMTAG_REQUIRENAME

Definition at line 254 of file rpmtag.h.

#define RPMTAG_SUGGESTS   RPMTAG_SUGGESTSNAME

Definition at line 367 of file rpmtag.h.

#define RPMTAG_SVNID   RPMTAG_CVSID

Definition at line 376 of file rpmtag.h.

#define RPMTAG_V   RPMTAG_VERSION

Definition at line 194 of file rpmtag.h.


Typedef Documentation

typedef struct _HE_s HE_s

Definition at line 512 of file rpmtag.h.

typedef struct headerTagTableEntry_s* headerTagTableEntry

Definition at line 520 of file rpmtag.h.


Function Documentation

int headerMacrosLoad ( Header  h)
int headerMacrosUnload ( Header  h)
rpmuint32_t hGetColor ( Header  h)

Return header color.

Parameters:
hheader
Returns:
header color

Definition at line 217 of file hdrNVR.c.

References _free(), alloca(), _HE_s::c, headerGet(), _HE_s::p, rpmDataType_u::ptr, _HE_s::tag, and rpmDataType_u::ui32p.

Referenced by rpmtsAddInstallElement(), rpmtsAddObsoletes(), and rpmtsAddUpgrades().

void rpmDisplayQueryTags ( FILE *  fp,
headerTagTableEntry  _rpmTagTable,
headerSprintfExtension  _rpmHeaderFormats 
)

Display list of tags that can be used in --queryformat.

Parameters:
fpfile handle to use for display (NULL uses stdout)
_rpmTagTablerpm tag table (NULL uses rpmTagTable)
_rpmHeaderFormatsrpm tag extensions & formats (NULL uses headerCompoundFormats)

Definition at line 5133 of file hdrfmt.c.

References _rpmHeaderFormats, headerCompoundFormats, RPM_ARRAY_RETURN_TYPE, RPM_ASN1_RETURN_TYPE, RPM_MAPPING_RETURN_TYPE, RPM_MASK_TYPE, RPM_MAX_TYPE, RPM_OPAQUE_RETURN_TYPE, RPM_OPENPGP_RETURN_TYPE, RPM_PROBE_RETURN_TYPE, RPM_TREE_RETURN_TYPE, RPM_X509_RETURN_TYPE, rpmIsVerbose, rpmTagTable, and tagValue().

Referenced by rpmcliAllArgCallback().

char* tagCanonicalize ( const char *  s)

Canonicalize a rpmTag string.

Parameters:
sstring
Returns:
canonicalized string

Definition at line 440 of file tagname.c.

Referenced by fillOutMainPackage(), findPreambleTag(), and isPart().

void tagClean ( headerTagIndices  _rpmTags)

Free memory in header tag indices.

Parameters:
_rpmTagsheader tag indices (NULL uses rpmTags)

Definition at line 450 of file tagname.c.

References _free(), argvFree(), and rpmTags.

Referenced by main(), and rpmcliFini().

rpmTag tagGenerate ( const char *  s)

Generate a tag from arbitrary string.

Parameters:
sstring
Returns:
generated tag value

Definition at line 445 of file tagname.c.

Referenced by fillOutMainPackage(), findPreambleTag(), and isPart().

const char* tagName ( rpmTag  tag)
tagStore_t tagStoreFree ( tagStore_t  dbiTags,
size_t  dbiNTags 
)

Destroy tagStore array.

Parameters:
dbiTagsdbi tag storage
dbiNTagsno. of dbi tags
Returns:
NULL always

Definition at line 462 of file tagname.c.

References _free(), and rpmiobFree().

Referenced by dbiTagsInit(), rpmdbClose(), and specFini().

unsigned int tagType ( rpmTag  tag)

Return tag data type from value.

Todo:
Return rpmTagType-like, not unsigned int. There's no clear typedef yet.
Parameters:
tagtag value
Returns:
tag data type, 0 on not found.

Definition at line 430 of file tagname.c.

Referenced by formatValue(), myTagName(), rpmmiInit(), sql_bind_key(), sql_copen(), and sql_initDB().

rpmTag tagValue ( const char *  tagstr)

Return tag value from name.

Parameters:
tagstrname of tag
Returns:
tag value, 0xffffffff on not found

Definition at line 435 of file tagname.c.

Referenced by db3open(), dbiTagsInit(), debconflictsTag(), debdependsTag(), debmd5sumsTag(), debobsoletesTag(), debprovidesTag(), doIcon(), filenamesTag(), findTag(), initSourceHeader(), initSourceHeaderScriptlets(), myTagValue(), rpmDisplayQueryTags(), rpmdsSysinfo(), rpmgiInitFilter(), and tagNumFromPyObject().


Variable Documentation

Definition at line 179 of file tagname.c.

Referenced by findPreambleTag(), isPart(), and tagClean().

Automatically generated table of tag name/value pairs.

Definition at line 238 of file tagtbl.c.

Referenced by addRpmTags(), headerSprintf(), myTagName(), myTagValue(), rpmDisplayQueryTags(), and tagLoadIndex().

Number of entries in rpmTagTable.

Definition at line 241 of file tagtbl.c.

Referenced by tagLoadIndex().