Проект OpenNet: MAN header.h (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

header.h (3)

>> header.h (3) ( Linux man: Библиотечные вызовы )

NAME

lib/header.h - An rpm header carries all information about a package.

SYNOPSIS

#include <stdio.h>
#include <rpmio.h>
#include <hdrinline.h>

Data Structures

struct HE_s

struct headerSprintfExtension_s

struct headerTagTableEntry_s

union hRET_s

struct HV_s

Defines

#define RPM_MIN_TYPE 0

#define RPM_MAX_TYPE 9

#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

Typedefs

typedef int int_32

typedef short int int_16

typedef char int_8

typedef unsigned int uint_32

typedef unsigned short uint_16

typedef const char * errmsg_t

typedef int_32 * hTAG_t

typedef int_32 * hTYP_t

typedef const void * hPTR_t

typedef int_32 * hCNT_t

typedef headerToken * Header

typedef headerIteratorS * HeaderIterator

typedef headerTagTableEntry_s * headerTagTableEntry

typedef char *(* headerTagFormatFunction )(int_32 type, const void *data, char *formatPrefix, int padding, int element)

typedef int(* headerTagTagFunction )(Header h, hTYP_t type, hPTR_t *data, hCNT_t count, int *freeData)

typedef headerSprintfExtension_s * headerSprintfExtension

typedef enum rpmTagType_e rpmTagType

typedef enum rpmSubTagType_e rpmSubTagType

typedef hRET_s * hRET_t

typedef HE_s * HE_t

typedef Header(* HDRnew )(void)

typedef Header(* HDRfree )(Header h)

typedef Header(* HDRlink )(Header h)

typedef Header(* HDRunlink )(Header h)

typedef void(* HDRsort )(Header h)

typedef void(* HDRunsort )(Header h)

typedef unsigned int(* HDRsizeof )(Header h, enum hMagic magicp)

typedef void *(* HDRunload )(Header h)

typedef Header(* HDRreload )(Header h, int tag)

typedef Header(* HDRcopy )(Header h)

typedef Header(* HDRload )(void *uh)

typedef Header(* HDRcopyload )(const void *uh)

typedef Header(* HDRhdrread )(FD_t fd, enum hMagic magicp)

typedef int(* HDRhdrwrite )(FD_t fd, Header h, enum hMagic magicp)

typedef int(* HDRisentry )(Header h, int_32 tag)

typedef void *(* HDRfreetag )(Header h, const void *data, rpmTagType type)

typedef int(* HDRget )(Header h, int_32 tag, hTYP_t type, void **p, hCNT_t c)

typedef int(* HDRgetmin )(Header h, int_32 tag, hTYP_t type, hPTR_t *p, hCNT_t c)

typedef int(* HDRadd )(Header h, int_32 tag, int_32 type, const void *p, int_32 c)

typedef int(* HDRappend )(Header h, int_32 tag, int_32 type, const void *p, int_32 c)

typedef int(* HDRaddorappend )(Header h, int_32 tag, int_32 type, const void *p, int_32 c)

typedef int(* HDRaddi18n )(Header h, int_32 tag, const char *string, const char *lang)

typedef int(* HDRmodify )(Header h, int_32 tag, int_32 type, const void *p, int_32 c)

typedef int(* HDRremove )(Header h, int_32 tag)

typedef char *(* HDRhdrsprintf )(Header h, const char *fmt, const struct headerTagTableEntry_s *tags, const struct headerSprintfExtension_s *extensions, errmsg_t *errmsg)

typedef void(* HDRcopytags )(Header headerFrom, Header headerTo, hTAG_t tagstocopy)

typedef HeaderIterator(* HDRfreeiter )(HeaderIterator hi)

typedef HeaderIterator(* HDRinititer )(Header h)

typedef int(* HDRnextiter )(HeaderIterator hi, hTAG_t tag, hTYP_t type, hPTR_t *p, hCNT_t c)

typedef HV_s * HV_t

Enumerations

enum headerSprintfExtenstionType { HEADER_EXT_LAST = 0, HEADER_EXT_FORMAT, HEADER_EXT_MORE, HEADER_EXT_TAG }

enum hMagic { HEADER_MAGIC_NO = 0, HEADER_MAGIC_YES = 1 }

enum rpmTagType_e { RPM_NULL_TYPE = 0, RPM_CHAR_TYPE = 1, RPM_INT8_TYPE = 2, RPM_INT16_TYPE = 3, RPM_INT32_TYPE = 4, RPM_STRING_TYPE = 6, RPM_BIN_TYPE = 7, RPM_STRING_ARRAY_TYPE = 8, RPM_I18NSTRING_TYPE }

enum rpmSubTagType_e { RPM_REGION_TYPE = -10, RPM_BIN_ARRAY_TYPE = -11, RPM_XREF_TYPE = -12 }

Functions

void * headerFreeData (const void *data, rpmTagType type)

Variables

const struct headerSprintfExtension_s headerDefaultFormats []

DETAILED DESCRIPTION

An rpm header carries all information about a package.

A header is a collection of data elements called tags. Each tag has a data type, and includes 1 or more values.

Historical Issues
Here's a brief description of features/incompatibilities that have been added to headers and tags.

version 1
Support for version 1 headers was removed in rpm-4.0.

version 2

Todo: Document version2 headers.

version 3 (added in rpm-3.0)
Added RPM_I18NSTRING_TYPE as an associative array reference for i18n locale dependent single element tags (i.e Group).
Added an 8 byte magic string to headers in packages on-disk. The magic string was not added to headers in the database.

version 4 (added in rpm-4.0)
Represent file names as a (dirname/basename/dirindex) triple rather than as an absolute path name. Legacy package headers are converted when the header is read. Legacy database headers are converted when the database is rebuilt.
Simplify dependencies by eliminating the implict check on package name/version/release in favor of an explict check on package provides. Legacy package headers are converted when the header is read. Legacy database headers are converted when the database is rebuilt.
(rpm-4.0.2) The original package header (and all original metadata) is preserved in what's called an 'immutable header region'. The original header can be retrieved as an RPM_BIN_TYPE, just like any other tag, and the original header reconstituted using headerLoad().
(rpm-4.0.2) The signature tags are added (and renumbered to avoid tag value collisions) to the package header during package installation.
(rpm-4.0.3) A SHA1 digest of the original header is appended (i.e. detached digest) to the immutable header region to verify changes to the original header.
(rpm-4.0.3) Private methods (e.g. headerLoad(), headerUnload(), etc.) to permit header data to be manipulated opaquely through vectors.
(rpm-4.0.3) Sanity checks on header data to limit tags to 65K, bytes to 16Mb, and total metadata size to 32Mb added.

Development Issues
Here's a brief description of future features/incompatibilities that will be added to headers.

Private header methods.
Private methods for the transaction element file info TFI_t may be used as proof-of-concept, binary XML may be implemented as a header format representation soon thereafter.

DSA signature for header metadata.
The manner in which rpm packages are signed is going to change. The SHA1 digest in the header will be signed, equivalent to a DSA digital signature on the original header metadata. As the original header will contain 'trusted' (i.e. because the header is signed with DSA) file MD5 digests, there will be little or no reason to sign the payload, but that may happen as well. Note that cpio headers in the payload are not used to install package metadata, only the name field in the cpio header is used to associate an archive file member with the corresponding entry for the file in header metadata.

Definition in file header.h.

DEFINE DOCUMENTATION

#define HEADER_I18NTABLE 100

Definition at line 256 of file header.h.

Referenced by getTagString(), getTagVal(), headerAddI18NString(), headerFindI18NString(), headerGetLangs(), headerLoad(), initSourceHeader(), and regionSwab().

#define HEADER_IMAGE 61

Header private tags.

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

Definition at line 252 of file header.h.

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

#define HEADER_IMMUTABLE 63

Definition at line 254 of file header.h.

Referenced by headerReload().

#define HEADER_REGIONS 64

Definition at line 255 of file header.h.

#define HEADER_SIGBASE 256

Definition at line 257 of file header.h.

Referenced by headerMergeLegacySigs(), and headerRegenSigHeader().

#define HEADER_SIGNATURES 62

Definition at line 253 of file header.h.

Referenced by headerReload().

#define HEADER_TAGBASE 1000

Definition at line 258 of file header.h.

Referenced by headerMergeLegacySigs(), and headerRegenSigHeader().

#define RPM_MAX_TYPE 9

#define RPM_MIN_TYPE 0

TYPEDEF DOCUMENTATION

typedef int_32* hCNT_t

Definition at line 117 of file header.h.

Referenced by copyEntry(), getExtension(), headerGetEntry(), headerGetEntryMinMemory(), headerNextIterator(), and intGetEntry().

typedef struct HE_s * HE_t

typedef const void* hPTR_t

Definition at line 116 of file header.h.

Referenced by copyEntry(), dataLength(), dateFormat(), dayFormat(), formatValue(), getExtension(), grabData(), headerCopy(), headerCopyTags(), headerGetEntry(), headerGetEntryMinMemory(), headerGetRawEntry(), headerNextIterator(), hexFormat(), intGetEntry(), octalFormat(), psmStage(), realDateFormat(), rpmReSign(), and shescapeFormat().

typedef union hRET_s * hRET_t

typedef int_32* hTYP_t

Definition at line 115 of file header.h.

Referenced by copyEntry(), getExtension(), headerGetEntry(), headerGetEntryMinMemory(), and headerNextIterator().

typedef short int int_16

Definition at line 100 of file header.h.

Referenced by countLinks(), doHeaderUnload(), findPackagesWithRelocatedFiles(), headerDump(), mergeFiles(), mireSkip(), and regionSwab().

typedef int int_32

Definition at line 99 of file header.h.

Referenced by addChangelogEntry(), addLostFiles(), addOrAppendListEntry(), alAddPackage(), armorFormat(), base64Format(), checkPackageDeps(), compressFilelist(), convertAMD(), convertExistingAMD(), copyData(), copyEntry(), countLinks(), dataLength(), dateFormat(), dayFormat(), depflagsFormat(), descriptionTag(), doHeaderUnload(), fflagsFormat(), filenamesTag(), findEntry(), findPackagesWithRelocatedFiles(), findUpgradePackages(), formatValue(), fpLookupHeader(), fsmMapAttrs(), fsnamesTag(), fssizesTag(), getBuildTime(), grabData(), groupTag(), handleOneTrigger(), headerAddEntry(), headerAddI18NString(), headerAddOrAppendEntry(), headerAppendEntry(), headerCopy(), headerCopyLoad(), headerCopyTags(), headerCopyWithConvert(), headerDump(), headerFree(), headerGetEntry(), headerGetEntryMinMemory(), headerGetRawEntry(), headerInject(), headerIsEntry(), headerLoad(), headerMatchesDepFlags(), headerMergeLegacySigs(), headerModifyEntry(), headerRead(), headerRegenSigHeader(), headerRemoveEntry(), headerSizeof(), hexFormat(), i18nTag(), identifyDepend(), IDTXglob(), IDTXload(), initSourceHeader(), instprefixTag(), intGetEntry(), makeGPGSignature(), makePGPSignature(), mergeFiles(), mireSkip(), octalFormat(), parsePreamble(), permsFormat(), providePackageNVR(), psmStage(), rangeMatchesDepFlags(), readPackageHeaders(), realDateFormat(), regionSwab(), relocateFileList(), removeMovedFilesAlreadyHandled(), rpmAddSignature(), rpmCheckSig(), rpmdbAdd(), rpmdbFindByFile(), rpmdbFindFpList(), rpmdbRemove(), rpmdepCheck(), rpmGetFilesystemUsage(), rpmHeaderGetEntry(), rpmInstallLoadMacros(), rpmPackageGetEntry(), rpmReadSignature(), rpmReSign(), rpmtransAddPackage(), rpmVerifyDigest(), rpmVerifyFile(), rpmVerifySignature(), rpmVersionCompare(), runImmedTriggers(), shescapeFormat(), showQueryPackage(), summaryTag(), triggercondsTag(), triggertypeFormat(), triggertypeTag(), verifyHeader(), verifySizeSignature(), and writeRPM().

typedef char int_8

Definition at line 101 of file header.h.

Referenced by archOkay(), formatValue(), headerDump(), mergeFiles(), and mireSkip().

typedef unsigned short uint_16

Definition at line 104 of file header.h.

Referenced by formatValue(), genCpioListAndHeader(), handleInstInstalledFiles(), relocateFileList(), showQueryPackage(), and whatis().

typedef unsigned int uint_32

Definition at line 103 of file header.h.

Referenced by alAddPackage(), checkPackageDeps(), fssizesTag(), genCpioListAndHeader(), handleInstInstalledFiles(), handleOverlappedFiles(), loadFi(), mergeFiles(), psmStage(), relocateFileList(), rpmGetFilesystemUsage(), and rpmtransAddPackage().

AUTHOR

Generated automatically by Doxygen for rpm from the source code.

Index

NAME

SYNOPSIS

Data Structures
Defines
Typedefs
Enumerations
Functions
Variables

DETAILED DESCRIPTION

DEFINE DOCUMENTATION

#define HEADER_I18NTABLE 100
#define HEADER_IMAGE 61
#define HEADER_IMMUTABLE 63
#define HEADER_REGIONS 64
#define HEADER_SIGBASE 256
#define HEADER_SIGNATURES 62
#define HEADER_TAGBASE 1000
#define RPM_MAX_TYPE 9
#define RPM_MIN_TYPE 0

TYPEDEF DOCUMENTATION

typedef int_32* hCNT_t
typedef struct HE_s * HE_t
typedef const void* hPTR_t
typedef union hRET_s * hRET_t
typedef int_32* hTYP_t
typedef short int int_16
typedef int int_32
typedef char int_8
typedef unsigned short uint_16
typedef unsigned int uint_32

AUTHOR

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру