Page 322
This function frees the rpmDependencies structure pointed to by rpmdep:
#include <rpm/rpmlib.h> void rpmdepDone(rpmDependencies rpmdep);
The functions in this section are used to control the amount of diagnostic output produced by other rpmlib functions. The rpmlib library can produce a wealth of diagnostic output, making it easy to see what is going on at any given time.
There are several different verbosity levels defined in rpmlib.h. Their symbolic names are in the form RPMMESS_xxx, where xxx is the name of the verbosity level. Note that the numeric values of the verbosity levels increase with a decrease in verbosity.
Unless otherwise set, the default verbosity level is RPMMESS_NORMAL.
This function is used to increase the current verbosity level by one:
#include <rpm/rpmlib.h> void rpmIncreaseVerbosity(void);
This function is used to set the current verbosity level to level. Note that no range checking is done to level:
#include <rpm/rpmlib.h> void rpmSetVerbosity(int level);
This function returns the current verbosity level:
#include <rpm/rpmlib.h> int rpmGetVerbosity(void);
This function checks the current verbosity level and returns 1 if the current level is set to RPMMESS_VERBOSE or a level of higher verbosity. Otherwise, it returns 0:
Page 323
#include <rpm/rpmlib.h> int rpmIsVerbose(void);
This function checks the current verbosity level and returns 1 if the current level is set to RPMMESS_DEBUG or a level of higher verbosity. Otherwise, it returns 0:
#include <rpm/rpmlib.h> int rpmIsDebug(void);
The functions in this section deal with the verification of package signatures. A package file may contain more than one type of signature. For example, a package may contain a signature that contains the package's size, as well as a signature that contains cryptographically derived data that can be used to prove the package's origin.
Each type of signature has its own tag value. These tag values are defined in rpmlib.h and are in the form RPMSIGTAG_xxx, where xxx is the type of signature.
This function verifies the signature of the package pointed to by file. The result of the verification is stored in result, in a format suitable for printing:
#include <rpm/rpmlib.h>
int rpmVerifySignature(char *file,
int_32 sigTag,
void *sig,
int count,
char *result);
The sigTag parameter specifies the type of signature to be checked. The sig parameter specifies the signature against which the package is to be verified. The count parameter specifies the size of the signature; at present, this parameter is only used for PGP-based signatures.
This function returns the following values:
Page 324
This function frees the signature h:
#include <rpm/rpmlib.h> #include <rpm/header.h> void rpmFreeSignature(Header h);
The header is one of the key data structures in rpmlib. The functions in this section perform basic manipulations of the header.
The header is actually a data structure. It is not necessary to fully understand the actual data structure, but it is necessary to understand the basic concepts on which the header is based.
The header serves as a kind of miniature database. It can be searched for specific information, which can then be retrieved easily. As in a database, the information contained in the header can be of varying sizes.
This function reads a header from file fd, converting it from network byte order to the host system's byte order:
#include <rpm/rpmlib.h>
#include <rpm/header.h>
Header headerRead(int fd,
int magicp);
If magicp is defined to be HEADER_MAGIC_YES, headerRead() will expect header magic numbers and will return an error if they are not present. Likewise, if magicp is defined to be HEADER_MAGIC_NO, headerRead() will not check the header's magic numbers and will return an error if they are present.
On error, this function returns NULL.
This function writes the header h to the file fd, converting it from host byte order to network byte order. If magicp is defined to be HEADER_MAGIC_YES, headerWrite() will add the appropriate magic numbers to the header being written. If magicp is defined to be HEADER_MAGIC_NO, headerWrite() will not include magic numbers:
#include <rpm/rpmlib.h> #include <rpm/header.h>
Page 325
void headerWrite(int fd,
Header h,
int magicp);
This function returns a copy of header h:
#include <rpm/rpmlib.h> #include <rpm/header.h> Header headerCopy(Header h);
This function returns the number of bytes the header h takes up on disk. Note that in versions of RPM prior to 2.3.3, this function also changes the location of the data in the header. The result is that pointers from headerGetEntry() will no longer be valid. Therefore, any pointers acquired before calling headerSizeof() should be discarded:
#include <rpm/rpmlib.h>
#include <rpm/header.h>
unsigned int headerSizeof(Header h,
int magicp);
This function returns a new header.
#include <rpm/rpmlib.h> #include <rpm/header.h> Header headerNew(void);
This function deallocates the header specified by h:
#include <rpm/rpmlib.h> #include <rpm/header.h> void headerFree(Header h);
This function prints the structure of the header h to the file f. If the flags parameter is defined to be HEADER_DUMP_INLINE, the header's data is also printed:
#include <rpm/rpmlib.h>
#include <rpm/header.h>
void headerDump(Header h,
FILE *f,
int flags);