PK vFZ+�]�� � rpmutil.hnu �[��� #ifndef _RPMUTIL_H
#define _RPMUTIL_H
#include <unistd.h>
/** \file rpmio/rpmutil.h
*
* Miscellaneous utility macros:
* - portability wrappers for various gcc extensions like __attribute__()
* - ...
*
* Copied from glib, names replaced to avoid clashing with glib.
*
*/
/* Here we provide RPM_GNUC_EXTENSION as an alias for __extension__,
* where this is valid. This allows for warningless compilation of
* "long long" types even in the presence of '-ansi -pedantic'.
*/
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8)
# define RPM_GNUC_EXTENSION __extension__
#else
# define RPM_GNUC_EXTENSION
#endif
/* Provide macros to feature the GCC function attribute.
*/
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
#define RPM_GNUC_PURE \
__attribute__((__pure__))
#define RPM_GNUC_MALLOC \
__attribute__((__malloc__))
#else
#define RPM_GNUC_PURE
#define RPM_GNUC_MALLOC
#endif
#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3)
#define RPM_GNUC_ALLOC_SIZE(x) __attribute__((__alloc_size__(x)))
#define RPM_GNUC_ALLOC_SIZE2(x,y) __attribute__((__alloc_size__(x,y)))
#else
#define RPM_GNUC_ALLOC_SIZE(x)
#define RPM_GNUC_ALLOC_SIZE2(x,y)
#endif
#if __GNUC__ >= 4
#define RPM_GNUC_NULL_TERMINATED __attribute__((__sentinel__))
#else
#define RPM_GNUC_NULL_TERMINATED
#endif
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4)
#define RPM_GNUC_PRINTF( format_idx, arg_idx ) \
__attribute__((__format__ (__printf__, format_idx, arg_idx)))
#define RPM_GNUC_SCANF( format_idx, arg_idx ) \
__attribute__((__format__ (__scanf__, format_idx, arg_idx)))
#define RPM_GNUC_FORMAT( arg_idx ) \
__attribute__((__format_arg__ (arg_idx)))
#define RPM_GNUC_NORETURN \
__attribute__((__noreturn__))
#define RPM_GNUC_CONST \
__attribute__((__const__))
#define RPM_GNUC_UNUSED \
__attribute__((__unused__))
#define RPM_GNUC_NO_INSTRUMENT \
__attribute__((__no_instrument_function__))
#else /* !__GNUC__ */
#define RPM_GNUC_PRINTF( format_idx, arg_idx )
#define RPM_GNUC_SCANF( format_idx, arg_idx )
#define RPM_GNUC_FORMAT( arg_idx )
#define RPM_GNUC_NORETURN
#define RPM_GNUC_CONST
#define RPM_GNUC_UNUSED
#define RPM_GNUC_NO_INSTRUMENT
#endif /* !__GNUC__ */
#if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1)
#define RPM_GNUC_DEPRECATED \
__attribute__((__deprecated__))
#else
#define RPM_GNUC_DEPRECATED
#endif /* __GNUC__ */
#if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 3)
#define RPM_GNUC_MAY_ALIAS __attribute__((may_alias))
#define RPM_GNUC_NONNULL( ... ) \
__attribute__((__nonnull__ (__VA_ARGS__)))
#else
#define RPM_GNUC_MAY_ALIAS
#define RPM_GNUC_NONNULL( ... )
#endif
#if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)
#define RPM_GNUC_WARN_UNUSED_RESULT \
__attribute__((warn_unused_result))
#else
#define RPM_GNUC_WARN_UNUSED_RESULT
#endif /* __GNUC__ */
#if __GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 3)
# define RPM_GNUC_INTERNAL __attribute__((visibility("hidden")))
#else
# define RPM_GNUC_INTERNAL
#endif
/* Guard C code in headers, while including them from C++ */
#ifdef __cplusplus
# define RPM_BEGIN_DECLS extern "C" {
# define RPM_END_DECLS }
#else
# define RPM_BEGIN_DECLS
# define RPM_END_DECLS
#endif
#ifdef __cplusplus
extern "C" {
#endif
/* Rpm specific allocators which never return NULL but terminate on failure */
RPM_GNUC_MALLOC RPM_GNUC_ALLOC_SIZE(1)
void * rmalloc(size_t size);
RPM_GNUC_MALLOC RPM_GNUC_ALLOC_SIZE2(1,2)
void * rcalloc(size_t nmemb, size_t size);
RPM_GNUC_ALLOC_SIZE(2)
void * rrealloc(void *ptr, size_t size);
char * rstrdup(const char *str);
/* Rpm specific free() which returns NULL */
void * rfree(void *ptr);
/** \ingroup rpmutil
* Memory allocation failure callback prototype. When registered through
* rpmSetMemFail(), this gets called if memory allocation through rmalloc()
* and friends fails. If the application can somehow recover memory here,
* it can return a newly allocated memory block of requested size, otherwise
* it must return NULL after performing it's own shutdown deeds or
* terminate itself.
* @param size Size of allocation request in bytes
* @param data User data (or NULL)
* @return Allocated memory block of requested size or NULL
*/
typedef void * (*rpmMemFailFunc) (size_t size, void *data);
/** \ingroup rpmutil
* Set memory allocation failure callback.
* @param func Allocation failure callback function
* @param data User data (or NULL)
* @return Previous callback function
*/
rpmMemFailFunc rpmSetMemFail(rpmMemFailFunc func, void *data);
#ifdef __cplusplus
}
#endif
#endif /* _RPMUTIL_H */
PK vFZk� � � rpmpol.hnu �[��� #ifndef H_RPMPOL
#define H_RPMPOL
/** \ingroup rpmpol
* \file lib/rpmpol.h
* Structure(s) used for policy sets.
*/
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
enum rpmpolFlags_e {
RPMPOL_FLAG_NONE = 0,
RPMPOL_FLAG_BASE = (1 << 0)
};
typedef rpmFlags rpmpolFlags;
#define RPMPOL_TYPE_DEFAULT "default"
#ifdef __cplusplus
}
#endif
#endif /* H_rpmpol */
PK vFZ���� �
rpmcallback.hnu �[��� #ifndef _RPMCALLBACK_H
#define _RPMCALLBACK_H
/** \ingroup rpmcallback
* \file lib/rpmcallback.h
*
* (un)install callbacks
*/
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* Bit(s) to identify progress callbacks.
*/
typedef enum rpmCallbackType_e {
RPMCALLBACK_UNKNOWN = 0,
RPMCALLBACK_INST_PROGRESS = (1 << 0),
RPMCALLBACK_INST_START = (1 << 1),
RPMCALLBACK_INST_OPEN_FILE = (1 << 2),
RPMCALLBACK_INST_CLOSE_FILE = (1 << 3),
RPMCALLBACK_TRANS_PROGRESS = (1 << 4),
RPMCALLBACK_TRANS_START = (1 << 5),
RPMCALLBACK_TRANS_STOP = (1 << 6),
RPMCALLBACK_UNINST_PROGRESS = (1 << 7),
RPMCALLBACK_UNINST_START = (1 << 8),
RPMCALLBACK_UNINST_STOP = (1 << 9),
RPMCALLBACK_REPACKAGE_PROGRESS = (1 << 10), /* obsolete, unused */
RPMCALLBACK_REPACKAGE_START = (1 << 11), /* obsolete, unused */
RPMCALLBACK_REPACKAGE_STOP = (1 << 12), /* obsolete, unused */
RPMCALLBACK_UNPACK_ERROR = (1 << 13),
RPMCALLBACK_CPIO_ERROR = (1 << 14),
RPMCALLBACK_SCRIPT_ERROR = (1 << 15),
RPMCALLBACK_SCRIPT_START = (1 << 16),
RPMCALLBACK_SCRIPT_STOP = (1 << 17),
RPMCALLBACK_INST_STOP = (1 << 18),
RPMCALLBACK_ELEM_PROGRESS = (1 << 19),
RPMCALLBACK_VERIFY_PROGRESS = (1 << 20),
RPMCALLBACK_VERIFY_START = (1 << 21),
RPMCALLBACK_VERIFY_STOP = (1 << 22),
} rpmCallbackType;
/** \ingroup rpmts
* Function pointer type for rpmtsSetNotifyCallback() triggered by
* rpmtsNotify()
*
* @param h related header or NULL
* @param what kind of notification (See RPMCALLBACK_ constants above)
* @param amount number of bytes/packages already processed or
* tag of the scriptlet involved
* or 0 or some other number
* @param total total number of bytes/packages to be processed or
* return code of the scriptlet or 0
* @param key result of rpmteKey() of related rpmte or 0
* @param data user data as passed to rpmtsSetNotifyCallback()
*/
typedef void * (*rpmCallbackFunction)
(const void * h,
const rpmCallbackType what,
const rpm_loff_t amount,
const rpm_loff_t total,
fnpyKey key,
rpmCallbackData data);
#ifdef __cplusplus
}
#endif
#endif /* _RPMCALLBACK_H */
PK vFZ<� �� � rpmlog.hnu �[��� #ifndef H_RPMLOG
#define H_RPMLOG 1
/** \ingroup rpmio
* \file rpmio/rpmlog.h
* Yet Another syslog(3) API clone.
* Used to unify rpmError() and rpmMessage() interfaces in rpm.
*/
#include <stdarg.h>
#include <stdio.h>
#include <rpm/rpmutil.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmlog
* RPM Log levels.
* priorities/facilities are encoded into a single 32-bit quantity, where the
* bottom 3 bits are the priority (0-7) and the top 28 bits are the facility
* (0-big number). Both the priorities and the facilities map roughly
* one-to-one to strings in the syslogd(8) source code. This mapping is
* included in this file.
*
* priorities (these are ordered)
*/
typedef enum rpmlogLvl_e {
RPMLOG_EMERG = 0, /*!< system is unusable */
RPMLOG_ALERT = 1, /*!< action must be taken immediately */
RPMLOG_CRIT = 2, /*!< critical conditions */
RPMLOG_ERR = 3, /*!< error conditions */
RPMLOG_WARNING = 4, /*!< warning conditions */
RPMLOG_NOTICE = 5, /*!< normal but significant condition */
RPMLOG_INFO = 6, /*!< informational */
RPMLOG_DEBUG = 7 /*!< debug-level messages */
} rpmlogLvl;
#define RPMLOG_PRIMASK 0x07 /* mask to extract priority part (internal) */
/* extract priority */
#define RPMLOG_PRI(p) ((p) & RPMLOG_PRIMASK)
#define RPMLOG_MAKEPRI(fac, pri) ((((unsigned)(fac)) << 3) | (pri))
/** \ingroup rpmlog
* facility codes
*/
typedef enum rpmlogFac_e {
RPMLOG_KERN = (0<<3), /*!< kernel messages */
RPMLOG_USER = (1<<3), /*!< random user-level messages */
RPMLOG_MAIL = (2<<3), /*!< mail system */
RPMLOG_DAEMON = (3<<3), /*!< system daemons */
RPMLOG_AUTH = (4<<3), /*!< security/authorization messages */
RPMLOG_SYSLOG = (5<<3), /*!< messages generated internally by syslogd */
RPMLOG_LPR = (6<<3), /*!< line printer subsystem */
RPMLOG_NEWS = (7<<3), /*!< network news subsystem */
RPMLOG_UUCP = (8<<3), /*!< UUCP subsystem */
RPMLOG_CRON = (9<<3), /*!< clock daemon */
RPMLOG_AUTHPRIV = (10<<3), /*!< security/authorization messages (private) */
RPMLOG_FTP = (11<<3), /*!< ftp daemon */
/* other codes through 15 reserved for system use */
RPMLOG_LOCAL0 = (16<<3), /*!< reserved for local use */
RPMLOG_LOCAL1 = (17<<3), /*!< reserved for local use */
RPMLOG_LOCAL2 = (18<<3), /*!< reserved for local use */
RPMLOG_LOCAL3 = (19<<3), /*!< reserved for local use */
RPMLOG_LOCAL4 = (20<<3), /*!< reserved for local use */
RPMLOG_LOCAL5 = (21<<3), /*!< reserved for local use */
RPMLOG_LOCAL6 = (22<<3), /*!< reserved for local use */
RPMLOG_LOCAL7 = (23<<3), /*!< reserved for local use */
#define RPMLOG_NFACILITIES 24 /*!< current number of facilities */
RPMLOG_ERRMSG = (((unsigned)(RPMLOG_NFACILITIES+0))<<3)
} rpmlogFac;
#define RPMLOG_FACMASK 0x03f8 /*!< mask to extract facility part */
#define RPMLOG_FAC(p) (((p) & RPMLOG_FACMASK) >> 3)
/*
* arguments to setlogmask.
*/
#define RPMLOG_MASK(pri) (1 << ((unsigned)(pri))) /*!< mask for one priority */
#define RPMLOG_UPTO(pri) ((1 << (((unsigned)(pri))+1)) - 1) /*!< all priorities through pri */
/*
* Option flags for openlog.
*
* RPMLOG_ODELAY no longer does anything.
* RPMLOG_NDELAY is the inverse of what it used to be.
*/
#define RPMLOG_PID 0x01 /*!< log the pid with each message */
#define RPMLOG_CONS 0x02 /*!< log on the console if errors in sending */
#define RPMLOG_ODELAY 0x04 /*!< delay open until first syslog() (default) */
#define RPMLOG_NDELAY 0x08 /*!< don't delay open */
#define RPMLOG_NOWAIT 0x10 /*!< don't wait for console forks: DEPRECATED */
#define RPMLOG_PERROR 0x20 /*!< log to stderr as well */
/* \ingroup rpmlog
* Option flags for callback return value.
*/
#define RPMLOG_DEFAULT 0x01 /*!< perform default logging */
#define RPMLOG_EXIT 0x02 /*!< exit after logging */
/** \ingroup rpmlog
*/
typedef struct rpmlogRec_s * rpmlogRec;
/** \ingroup rpmlog
* Retrieve log message string from rpmlog record
* @param rec rpmlog record
* @return log message
*/
const char * rpmlogRecMessage(rpmlogRec rec);
/** \ingroup rpmlog
* Retrieve log priority from rpmlog record
* @param rec rpmlog record
* @return log priority
*/
rpmlogLvl rpmlogRecPriority(rpmlogRec rec);
typedef void * rpmlogCallbackData;
/** \ingroup rpmlog
* @param rec rpmlog record
* @param data private callback data
* @return flags to define further behavior:
* RPMLOG_DEFAULT to perform default logging,
* RPMLOG_EXIT to exit after processing,
* 0 to return after callback
*/
typedef int (*rpmlogCallback) (rpmlogRec rec, rpmlogCallbackData data);
/** \ingroup rpmlog
* Return number of rpmError() ressages.
* @return number of messages
*/
int rpmlogGetNrecs(void) ;
/** \ingroup rpmlog
* Print all rpmError() messages.
* @param f file handle (NULL uses stderr)
*/
void rpmlogPrint(FILE *f);
/** \ingroup rpmlog
* Close desriptor used to write to system logger.
* @todo Implement.
*/
void rpmlogClose (void);
/** \ingroup rpmlog
* Open connection to system logger.
* @todo Implement.
*/
void rpmlogOpen (const char * ident, int option, int facility);
/** \ingroup rpmlog
* Set the log mask level.
* @param mask log mask (0 is no operation)
* @return previous log mask
*/
int rpmlogSetMask (int mask);
/** \ingroup rpmlog
* Generate a log message using FMT string and option arguments.
*/
void rpmlog (int code, const char *fmt, ...) RPM_GNUC_PRINTF(2, 3);
/** \ingroup rpmlog
* Return text of last rpmError() message.
* @return text of last message
*/
const char * rpmlogMessage(void);
/** \ingroup rpmlog
* Return error code from last rpmError() message.
* @deprecated Perl-RPM needs, what's really needed is predictable, non-i18n
* encumbered, error text that can be retrieved through rpmlogMessage()
* and parsed IMHO.
* @return code from last message
*/
int rpmlogCode(void);
/** \ingroup rpmlog
* Return translated prefix string (if any) given log level.
* @param pri log priority
* @return message prefix (or "" for none)
*/
const char * rpmlogLevelPrefix(rpmlogLvl pri);
/** \ingroup rpmlog
* Set rpmlog callback function.
* @param cb rpmlog callback function
* @param data callback private (user) data
* @return previous rpmlog callback function
*/
rpmlogCallback rpmlogSetCallback(rpmlogCallback cb, rpmlogCallbackData data);
/** \ingroup rpmlog
* Set rpmlog file handle.
* @param fp rpmlog file handle (NULL uses stdout/stderr)
* @return previous rpmlog file handle
*/
FILE * rpmlogSetFile(FILE * fp);
#define rpmSetVerbosity(_lvl) \
((void)rpmlogSetMask( RPMLOG_UPTO( RPMLOG_PRI(_lvl))))
#define rpmIncreaseVerbosity() \
((void)rpmlogSetMask(((((unsigned)(rpmlogSetMask(0) & 0xff)) << 1) | 1)))
#define rpmDecreaseVerbosity() \
((void)rpmlogSetMask((((int)(rpmlogSetMask(0) & 0xff)) >> 1)))
#define rpmIsNormal() \
(rpmlogSetMask(0) >= RPMLOG_MASK( RPMLOG_NOTICE ))
#define rpmIsVerbose() \
(rpmlogSetMask(0) >= RPMLOG_MASK( RPMLOG_INFO ))
#define rpmIsDebug() \
(rpmlogSetMask(0) >= RPMLOG_MASK( RPMLOG_DEBUG ))
#ifdef __cplusplus
}
#endif
#endif /* H_RPMLOG */
PK vFZ�l#�� � argv.hnu �[��� #ifndef _H_ARGV_
#define _H_ARGV_
/** \ingroup rpmargv
* \file rpmio/argv.h
*
* Argument Manipulation API.
*/
#include <stdio.h>
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef char ** ARGV_t;
typedef char * const *ARGV_const_t;
typedef int * ARGint_t;
struct ARGI_s {
unsigned nvals;
ARGint_t vals;
};
typedef struct ARGI_s * ARGI_t;
typedef struct ARGI_s const * const ARGI_const_t;
/** \ingroup rpmargv
* Print argv array elements.
* @param msg output message prefix (or NULL)
* @param argv argv array
* @param fp output file handle (NULL uses stderr)
*/
void argvPrint(const char * msg, ARGV_const_t argv, FILE * fp);
/** \ingroup rpmargv
* Destroy an argi array.
* @param argi argi array
* @return NULL always
*/
ARGI_t argiFree(ARGI_t argi);
/** \ingroup rpmargv
* Create an empty argv array.
* @return pointer to empty argv
*/
ARGV_t argvNew(void);
/** \ingroup rpmargv
* Destroy an argv array.
* @param argv argv array
* @return NULL always
*/
ARGV_t argvFree(ARGV_t argv);
/** \ingroup rpmargv
* Return no. of elements in argi array.
* @param argi argi array
* @return no. of elements
*/
int argiCount(ARGI_const_t argi);
/** \ingroup rpmargv
* Return data from argi array.
* @param argi argi array
* @return argi array data address
*/
ARGint_t argiData(ARGI_const_t argi);
/** \ingroup rpmargv
* Return no. of elements in argv array.
* @param argv argv array
* @return no. of elements
*/
int argvCount(ARGV_const_t argv);
/** \ingroup rpmargv
* Return data from argv array.
* @param argv argv array
* @return argv array data address
*/
ARGV_t argvData(ARGV_t argv);
/** \ingroup rpmargv
* Compare argv arrays (qsort/bsearch).
* @param a 1st instance address
* @param b 2nd instance address
* @return result of comparison
*/
int argvCmp(const void * a, const void * b);
/** \ingroup rpmargv
* Sort an argv array.
* @param argv argv array
* @param compar strcmp-like comparison function, or NULL for argvCmp()
* @return 0 always
*/
int argvSort(ARGV_t argv, int (*compar)(const void *, const void *));
/** \ingroup rpmargv
* Find an element in an argv array.
* @param argv argv array
* @param val string to find
* @param compar strcmp-like comparison function, or NULL for argvCmp()
* @return found string (NULL on failure)
*/
ARGV_t argvSearch(ARGV_const_t argv, const char *val,
int (*compar)(const void *, const void *));
/** \ingroup rpmargv
* Add an int to an argi array.
* @retval *argip argi array
* @param ix argi array index (or -1 to append)
* @param val int arg to add
* @return 0 always
*/
int argiAdd(ARGI_t * argip, int ix, int val);
/** \ingroup rpmargv
* Add a string to an argv array.
* @retval *argvp argv array
* @param val string arg to append
* @return 0 always
*/
int argvAdd(ARGV_t * argvp, const char *val);
/** \ingroup rpmargv
* Add a number to an argv array (converting to a string).
* @retval *argvp argv array
* @param val numeric arg to append
* @return 0 always
*/
int argvAddNum(ARGV_t * argvp, int val);
/** \ingroup rpmargv
* Append one argv array to another.
* @retval *argvp argv array
* @param av argv array to append
* @return 0 always
*/
int argvAppend(ARGV_t * argvp, ARGV_const_t av);
enum argvFlags_e {
ARGV_NONE = 0,
ARGV_SKIPEMPTY = (1 << 0), /* omit empty strings from result */
};
typedef rpmFlags argvFlags;
/** \ingroup rpmargv
* Split a string into an argv array.
* @param str string arg to split
* @param seps separator characters
* @param flags flags to control behavior
* @return argv array
*/
ARGV_t argvSplitString(const char * str, const char * seps, argvFlags flags);
/** \ingroup rpmargv
* Split a string into an argv array.
* @retval *argvp argv array
* @param str string arg to split
* @param seps separator characters
* @return 0 always
*/
int argvSplit(ARGV_t * argvp, const char * str, const char * seps);
/** \ingroup rpmargv
* Join an argv array into a string.
* @param *argv argv array to join
* @param sep separator string to use
* @return malloc'ed string
*/
char *argvJoin(ARGV_const_t argv, const char *sep);
#ifdef __cplusplus
}
#endif
#endif /* _H_ARGV_ */
PK vFZ#d}�\ \ rpmio.hnu �[��� #ifndef H_RPMIO
#define H_RPMIO
/** \ingroup rpmio
* \file rpmio/rpmio.h
*
* RPM I/O API (Fd_t is RPM equivalent to libc's FILE)
*/
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmsw.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmio
*/
typedef const struct FDIO_s * FDIO_t;
/** \ingroup rpmio
* \name RPMIO Interface.
*/
/** \ingroup rpmio
* strerror(3) clone.
*/
const char * Fstrerror(FD_t fd);
/** \ingroup rpmio
* Like fread(3) but with read(3)-style return values.
*/
ssize_t Fread(void * buf, size_t size, size_t nmemb, FD_t fd);
/** \ingroup rpmio
* Like fwrite(3) but with write(3)-style return values.
*/
ssize_t Fwrite(const void * buf, size_t size, size_t nmemb, FD_t fd);
/** \ingroup rpmio
* fseek(3) clone.
*/
int Fseek(FD_t fd, off_t offset, int whence);
/** \ingroup rpmio
* ftell(3) clone.
*/
off_t Ftell(FD_t fd);
/** \ingroup rpmio
* fclose(3) clone.
*/
int Fclose( FD_t fd);
/** \ingroup rpmio
*/
FD_t Fdopen(FD_t ofd, const char * fmode);
/** \ingroup rpmio
* fopen(3) clone.
*/
FD_t Fopen(const char * path,
const char * fmode);
/** \ingroup rpmio
* fflush(3) clone.
*/
int Fflush(FD_t fd);
/** \ingroup rpmio
* ferror(3) clone.
*/
int Ferror(FD_t fd);
/** \ingroup rpmio
* fileno(3) clone.
*/
int Fileno(FD_t fd);
/** \ingroup rpmio
* fcntl(2) clone.
*/
int Fcntl(FD_t fd, int op, void *lip);
/** \ingroup rpmio
* Get informative description (eg file name) from fd for diagnostic output.
*/
const char * Fdescr(FD_t fd);
/** \ingroup rpmio
* \name RPMIO Utilities.
*/
/** \ingroup rpmio
*/
off_t fdSize(FD_t fd);
/** \ingroup rpmio
*/
FD_t fdDup(int fdno);
/** \ingroup rpmio
*/
FD_t fdLink(FD_t fd);
/** \ingroup rpmio
*/
FD_t fdFree(FD_t fd);
/**
*/
off_t ufdCopy(FD_t sfd, FD_t tfd);
/** \ingroup rpmio
* Identify per-desciptor I/O operation statistics.
*/
typedef enum fdOpX_e {
FDSTAT_READ = 0, /*!< Read statistics index. */
FDSTAT_WRITE = 1, /*!< Write statistics index. */
FDSTAT_SEEK = 2, /*!< Seek statistics index. */
FDSTAT_CLOSE = 3, /*!< Close statistics index */
FDSTAT_DIGEST = 4, /*!< Digest statistics index. */
FDSTAT_MAX = 5
} fdOpX;
/** \ingroup rpmio
*
*/
rpmop fdOp(FD_t fd, fdOpX opx);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMIO */
PK vFZ`։�0 0 rpmsign.hnu �[��� #ifndef _RPMSIGN_H
#define _RPMSIGN_H
/** \file sign/rpmsign.h
*
* Signature API
*/
#include <rpm/argv.h>
#include <rpm/rpmpgp.h>
#ifdef __cplusplus
extern "C" {
#endif
struct rpmSignArgs {
char *keyid;
pgpHashAlgo hashalgo;
int signfiles;
/* ... what else? */
};
/** \ingroup rpmsign
* Sign a package
* @param path path to package
* @param args signing parameters (or NULL for defaults)
* @return 0 on success
*/
int rpmPkgSign(const char *path, const struct rpmSignArgs * args);
/** \ingroup rpmsign
* Delete signature(s) from a package
* @param path path to package
* @param args signing parameters (or NULL for defaults)
* @return 0 on success
*/
int rpmPkgDelSign(const char *path, const struct rpmSignArgs * args);
#ifdef __cplusplus
}
#endif
#endif /* _RPMSIGN_H */
PK vFZ�뭘p p rpmsw.hnu �[��� #ifndef H_RPMSW
#define H_RPMSW
/** \ingroup rpmio
* \file rpmio/rpmsw.h
*
* Statistics API
*/
#include <unistd.h>
#include <sys/time.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmsw
*/
typedef unsigned long int rpmtime_t;
/** \ingroup rpmsw
*/
typedef struct rpmsw_s * rpmsw;
/** \ingroup rpmsw
*/
typedef struct rpmop_s * rpmop;
/** \ingroup rpmsw
*/
struct rpmsw_s {
union {
struct timeval tv;
unsigned long long int ticks;
unsigned long int tocks[2];
} u;
};
/** \ingroup rpmsw
* Cumulative statistics for an operation.
*/
struct rpmop_s {
struct rpmsw_s begin; /*!< Starting time stamp. */
int count; /*!< Number of operations. */
size_t bytes; /*!< Number of bytes transferred. */
rpmtime_t usecs; /*!< Number of ticks. */
};
/** \ingroup rpmsw
* Return benchmark time stamp.
* @param *sw time stamp
* @return 0 on success
*/
rpmsw rpmswNow(rpmsw sw);
/** \ingroup rpmsw
* Return benchmark time stamp difference.
* @param *end end time stamp
* @param *begin begin time stamp
* @return difference in micro-seconds
*/
rpmtime_t rpmswDiff(rpmsw end, rpmsw begin);
/** \ingroup rpmsw
* Return benchmark time stamp overhead.
* @return overhead in micro-seconds
*/
rpmtime_t rpmswInit(void);
/** \ingroup rpmsw
* Enter timed operation.
* @param op operation statistics
* @param rc -1 clears usec counter
* @return 0 always
*/
int rpmswEnter(rpmop op, ssize_t rc);
/** \ingroup rpmsw
* Exit timed operation.
* @param op operation statistics
* @param rc per-operation data (e.g. bytes transferred)
* @return cumulative usecs for operation
*/
rpmtime_t rpmswExit(rpmop op, ssize_t rc);
/** \ingroup rpmsw
* Sum statistic counters.
* @param to result statistics
* @param from operation statistics
* @return cumulative usecs for operation
*/
rpmtime_t rpmswAdd(rpmop to, rpmop from);
/** \ingroup rpmsw
* Subtract statistic counters.
* @param to result statistics
* @param from operation statistics
* @return cumulative usecs for operation
*/
rpmtime_t rpmswSub(rpmop to, rpmop from);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMSW */
PK vFZR �;� � rpmarchive.hnu �[��� #ifndef H_ARCHIVE
#define H_ARCHIVE
/** \ingroup payload
* \file lib/rpmarchive.h
* File archive (aka payload) API.
*/
#define RPMERR_CHECK_ERRNO -32768
/** \ingroup payload
* Error codes for archive and file handling
*/
enum rpmfilesErrorCodes {
RPMERR_ITER_END = -1,
RPMERR_BAD_MAGIC = -2,
RPMERR_BAD_HEADER = -3,
RPMERR_HDR_SIZE = -4,
RPMERR_UNKNOWN_FILETYPE= -5,
RPMERR_MISSING_FILE = -6,
RPMERR_DIGEST_MISMATCH = -7,
RPMERR_INTERNAL = -8,
RPMERR_UNMAPPED_FILE = -9,
RPMERR_ENOENT = -10,
RPMERR_ENOTEMPTY = -11,
RPMERR_FILE_SIZE = -12,
RPMERR_ITER_SKIP = -13,
RPMERR_EXIST_AS_DIR = -14,
RPMERR_INVALID_SYMLINK = -15,
RPMERR_ENOTDIR = -16,
RPMERR_OPEN_FAILED = -32768,
RPMERR_CHMOD_FAILED = -32769,
RPMERR_CHOWN_FAILED = -32770,
RPMERR_WRITE_FAILED = -32771,
RPMERR_UTIME_FAILED = -32772,
RPMERR_UNLINK_FAILED = -32773,
RPMERR_RENAME_FAILED = -32774,
RPMERR_SYMLINK_FAILED = -32775,
RPMERR_STAT_FAILED = -32776,
RPMERR_LSTAT_FAILED = -32777,
RPMERR_MKDIR_FAILED = -32778,
RPMERR_RMDIR_FAILED = -32779,
RPMERR_MKNOD_FAILED = -32780,
RPMERR_MKFIFO_FAILED = -32781,
RPMERR_LINK_FAILED = -32782,
RPMERR_READLINK_FAILED = -32783,
RPMERR_READ_FAILED = -32784,
RPMERR_COPY_FAILED = -32785,
RPMERR_LSETFCON_FAILED = -32786,
RPMERR_SETCAP_FAILED = -32787,
RPMERR_CLOSE_FAILED = -32788,
};
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup payload
* Return formatted error message on payload handling failure.
* @param rc error code
* @return formatted error string (malloced)
*/
char * rpmfileStrerror(int rc);
/** \ingroup payload
* Get new file iterator for writing the archive content.
* The returned rpmfi will only visit the files needing some content.
* You need to provide the content using rpmfiArchiveWrite() or
* rpmfiArchiveWriteFile(). Make sure to close the rpmfi with
* rpmfiArchiveClose() to get the trailer written.
* rpmfiSetFX() is not supported for this type of iterator.
* @param fd file
* @param files file info
* @return new rpmfi
*/
rpmfi rpmfiNewArchiveWriter(FD_t fd, rpmfiles files);
/** \ingroup payload
* Get new file iterator for looping over the archive content.
* Returned rpmfi visites files in the order they are read from the payload.
* Content of the regular files can be retrieved with rpmfiArchiveRead() or
* rpmfiArchiveReadToFile() when they are visited with rpmfiNext().
* rpmfiSetFX() is not supported for this type of iterator.
* @param fd file
* @param files file info
* @param itype how to handle hard links. See rpmFileIter.
* @return new rpmfi
*/
rpmfi rpmfiNewArchiveReader(FD_t fd, rpmfiles files, int itype);
/** \ingroup payload
* Close payload archive
* @param fi file info
* @return > 0 on error
*/
int rpmfiArchiveClose(rpmfi fi);
/** \ingroup payload
* Return current position in payload archive
* @param fi file info
* @return position
*/
rpm_loff_t rpmfiArchiveTell(rpmfi fi);
/** \ingroup payload
* Write content into current file in archive
* @param fi file info
* @param buf pointer to content
* @param size number of bytes to write
* @return bytes actually written
*/
size_t rpmfiArchiveWrite(rpmfi fi, const void * buf, size_t size);
/** \ingroup payload
* Write content from given file into current file in archive
* @param fi file info
* @param fd file descriptor of file to read
* @return > 0 on error
*/
int rpmfiArchiveWriteFile(rpmfi fi, FD_t fd);
/** \ingroup payload
* Read content from current file in archive
* @param fi file info
* @param buf pointer to buffer
* @param size number of bytes to read
* @return bytes actually read
*/
size_t rpmfiArchiveRead(rpmfi fi, void * buf, size_t size);
/** \ingroup payload
* Has current file content stored in the archive
* @param fi file info
* @ return 1 for regular files but 0 for hardlinks without content
*/
int rpmfiArchiveHasContent(rpmfi fi);
/** \ingroup payload
* Write content from current file in archive to a file
* @param fi file info
* @param fd file descriptor of file to write to
* @param nodigest omit checksum check if 1
* @return > 0 on error
*/
int rpmfiArchiveReadToFile(rpmfi fi, FD_t fd, int nodigest);
#ifdef __cplusplus
}
#endif
#endif /* H_ARCHIVE */
PK vFZ�2��� � rpmspec.hnu �[��� #ifndef _H_SPEC_
#define _H_SPEC_
/** \ingroup rpmbuild
* \file build/rpmspec.h
* The rpmSpec and Package data structures used during build.
*/
#include <rpm/rpmstring.h> /* StringBuf */
#include <rpm/rpmcli.h> /* for QVA_t */
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmbuild
*/
typedef struct Package_s * rpmSpecPkg;
typedef struct Source * rpmSpecSrc;
typedef struct rpmSpecIter_s * rpmSpecPkgIter;
typedef struct rpmSpecIter_s * rpmSpecSrcIter;
enum rpmSourceFlags_e {
RPMBUILD_ISSOURCE = (1 << 0),
RPMBUILD_ISPATCH = (1 << 1),
RPMBUILD_ISICON = (1 << 2),
RPMBUILD_ISNO = (1 << 3),
};
typedef rpmFlags rpmSourceFlags;
#define RPMBUILD_DEFAULT_LANG "C"
enum rpmSpecFlags_e {
RPMSPEC_NONE = 0,
RPMSPEC_ANYARCH = (1 << 0),
RPMSPEC_FORCE = (1 << 1),
RPMSPEC_NOLANG = (1 << 2),
RPMSPEC_NOUTF8 = (1 << 3),
};
typedef rpmFlags rpmSpecFlags;
/** \ingroup rpmbuild
* Destroy Spec structure.
* @param spec spec file control structure
* @return NULL always
*/
rpmSpec rpmSpecFree(rpmSpec spec);
/* Iterator for spec packages */
rpmSpecPkgIter rpmSpecPkgIterInit(rpmSpec spec);
rpmSpecPkg rpmSpecPkgIterNext(rpmSpecPkgIter iter);
rpmSpecPkgIter rpmSpecPkgIterFree(rpmSpecPkgIter iter);
/* Getters for spec package attributes */
Header rpmSpecPkgHeader(rpmSpecPkg pkg);
/*
* Retrieve package specific parsed spec script section (RPMBUILD_FILE_LIST,
* RPMBUILD_FILE_FILE, RPMBUILD_POLICY) as a malloc'ed string.
*/
char * rpmSpecPkgGetSection(rpmSpecPkg pkg, int section);
/* Iterator for spec sources */
rpmSpecSrcIter rpmSpecSrcIterInit(rpmSpec spec);
rpmSpecSrc rpmSpecSrcIterNext(rpmSpecSrcIter iter);
rpmSpecSrcIter rpmSpecSrcIterFree(rpmSpecSrcIter iter);
/* Getters for spec source attributes */
rpmSourceFlags rpmSpecSrcFlags(rpmSpecSrc src);
int rpmSpecSrcNum(rpmSpecSrc src);
const char * rpmSpecSrcFilename(rpmSpecSrc src, int full);
/*
* Retrieve parsed spec script section (RPMBUILD_PREP, RPMBUILD_BUILD etc).
* As a special case, RPMBUILD_NONE as section returns the entire spec in
* preprocessed (macros expanded etc) format.
*/
const char * rpmSpecGetSection(rpmSpec spec, int section);
/** \ingroup rpmbuild
* Function to query spec file(s).
* @param ts transaction set
* @param qva parsed query/verify options
* @param arg query argument
* @return 0 on success, else no. of failures
*/
int rpmspecQuery(rpmts ts, QVA_t qva, const char * arg);
#ifdef __cplusplus
}
#endif
#endif /* _H_SPEC_ */
PK vFZj���h h rpmdb.hnu �[��� #ifndef H_RPMDB
#define H_RPMDB
/** \ingroup rpmdb dbi
* \file lib/rpmdb.h
* RPM database API.
*/
#include <rpm/rpmtypes.h>
#include <rpm/rpmsw.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* Tag value pattern match mode.
*/
typedef enum rpmMireMode_e {
RPMMIRE_DEFAULT = 0, /*!< regex with \., .* and ^...$ added */
RPMMIRE_STRCMP = 1, /*!< strings using strcmp(3) */
RPMMIRE_REGEX = 2, /*!< regex(7) patterns through regcomp(3) */
RPMMIRE_GLOB = 3 /*!< glob(7) patterns through fnmatch(3) */
} rpmMireMode;
typedef enum rpmdbOpX_e {
RPMDB_OP_DBGET = 1,
RPMDB_OP_DBPUT = 2,
RPMDB_OP_DBDEL = 3,
RPMDB_OP_MAX = 4
} rpmdbOpX;
typedef enum rpmdbCtrlOp_e {
RPMDB_CTRL_LOCK_RO = 1,
RPMDB_CTRL_UNLOCK_RO = 2,
RPMDB_CTRL_LOCK_RW = 3,
RPMDB_CTRL_UNLOCK_RW = 4,
RPMDB_CTRL_INDEXSYNC = 5
} rpmdbCtrlOp;
/** \ingroup rpmdb
* Retrieve operation timestamp from rpm database.
* @param db rpm database
* @param opx operation timestamp index
* @return pointer to operation timestamp.
*/
rpmop rpmdbOp(rpmdb db, rpmdbOpX opx);
/** \ingroup rpmdb
* Open all database indices.
* @param db rpm database
* @return 0 on success
*/
int rpmdbOpenAll (rpmdb db);
/** \ingroup rpmdb
* Return number of instances of package in rpm database.
* @param db rpm database
* @param name rpm package name
* @return number of instances
*/
int rpmdbCountPackages(rpmdb db, const char * name);
/** \ingroup rpmdb
* Return header join key for current position of rpm database iterator.
* @param mi rpm database iterator
* @return current header join key
*/
unsigned int rpmdbGetIteratorOffset(rpmdbMatchIterator mi);
/** \ingroup rpmdb
* Return number of elements in rpm database iterator.
* @param mi rpm database iterator
* @return number of elements
*/
int rpmdbGetIteratorCount(rpmdbMatchIterator mi);
/** \ingroup rpmdb
*/
unsigned int rpmdbGetIteratorFileNum(rpmdbMatchIterator mi);
/** \ingroup rpmdb
* Append items to set of package instances to iterate.
* @param mi rpm database iterator
* @param hdrNums array of package instances
* @param nHdrNums number of elements in array
* @return 0 on success, 1 on failure (bad args)
*/
int rpmdbAppendIterator(rpmdbMatchIterator mi,
const unsigned int * hdrNums, unsigned int nHdrNums);
/** \ingroup rpmdb
* Add pattern to iterator selector.
* @param mi rpm database iterator
* @param tag rpm tag
* @param mode type of pattern match
* @param pattern pattern to match
* @return 0 on success
*/
int rpmdbSetIteratorRE(rpmdbMatchIterator mi, rpmTagVal tag,
rpmMireMode mode, const char * pattern);
/** \ingroup rpmdb
* Prepare iterator for lazy writes.
* @note Must be called before rpmdbNextIterator() with CDB model database.
* @param mi rpm database iterator
* @param rewrite new value of rewrite
* @return previous value
*/
int rpmdbSetIteratorRewrite(rpmdbMatchIterator mi, int rewrite);
/** \ingroup rpmdb
* Modify iterator to mark header for lazy write on release.
* @param mi rpm database iterator
* @param modified new value of modified
* @return previous value
*/
int rpmdbSetIteratorModified(rpmdbMatchIterator mi, int modified);
/** \ingroup rpmdb
* Modify iterator to verify retrieved header blobs.
* @param mi rpm database iterator
* @param ts transaction set
* @param (*hdrchk) headerCheck() vector
* @return 0 always
*/
int rpmdbSetHdrChk(rpmdbMatchIterator mi, rpmts ts,
rpmRC (*hdrchk) (rpmts ts, const void * uh, size_t uc, char ** msg));
/** \ingroup rpmdb
* Return database iterator.
* @param db rpm database
* @param rpmtag database index tag
* @param keyp key data (NULL for sequential access)
* @param keylen key data length (0 will use strlen(keyp))
* @return NULL on failure
*/
rpmdbMatchIterator rpmdbInitIterator(rpmdb db, rpmDbiTagVal rpmtag,
const void * keyp, size_t keylen);
/** \ingroup rpmdb
* Return next package header from iteration.
* @param mi rpm database iterator
* @return NULL on end of iteration.
*/
Header rpmdbNextIterator(rpmdbMatchIterator mi);
/** \ingroup rpmdb
* Destroy rpm database iterator.
* @param mi rpm database iterator
* @return NULL always
*/
rpmdbMatchIterator rpmdbFreeIterator(rpmdbMatchIterator mi);
/** \ingroup rpmdb
* Get an iterator for an index
* @param db rpm database
* @param rpmtag the index to iterate over
* @return the index iterator
*/
rpmdbIndexIterator rpmdbIndexIteratorInit(rpmdb db, rpmDbiTag rpmtag);
/** \ingroup rpmdb
* Get the next key - Warning! Keys are not zero terminated!
* Binary tags may even contain zero bytes
* @param ii index iterator
* @param key address to save the pointer to the key
* @param keylen address to save the length of the key to
* @return 0 on success; != 0 on error or end of index
*/
int rpmdbIndexIteratorNext(rpmdbIndexIterator ii, const void ** key, size_t * keylen);
/** \ingroup rpmdb
* Get the next key into a tag data container.
* Caller is responsible for calling rpmtdFreeData() to freeing the
* data returned in keytd once done with it.
* @param ii index iterator
* @param keytd tag container to store the key in
* @return 0 on success; != 0 on error or end of index
*/
int rpmdbIndexIteratorNextTd(rpmdbIndexIterator ii, rpmtd keytd);
/** \ingroup rpmdb
* Get number of entries for current key
* @param ii index iterator
* @return number of entries. 0 on error.
*/
unsigned int rpmdbIndexIteratorNumPkgs(rpmdbIndexIterator ii);
/** \ingroup rpmdb
* Get package offset of entry
* @param ii index iterator
* @param nr number of the entry
* @return db offset of pkg
*/
unsigned int rpmdbIndexIteratorPkgOffset(rpmdbIndexIterator ii, unsigned int nr);
/** \ingroup rpmdb
* Get tag number of entry
* @param ii index iterator
* @param nr number of the entry
* @return number of tag within the package
*/
unsigned int rpmdbIndexIteratorTagNum(rpmdbIndexIterator ii, unsigned int nr);
/** \ingroup rpmdb
* Free index iterator
* @param ii index iterator
* return NULL
*/
rpmdbIndexIterator rpmdbIndexIteratorFree(rpmdbIndexIterator ii);
/** \ingroup rpmdb
* manipulate the rpm database
* @param db rpm database
* @param ctrl operation
* @return 0 on success; != 0 on error
*/
int rpmdbCtrl(rpmdb db, rpmdbCtrlOp ctrl);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMDB */
PK vFZ�o@[� � rpmurl.hnu �[��� #ifndef H_RPMURL
#define H_RPMURL
/** \ingroup rpmio
* \file rpmio/rpmurl.h
*
* A couple utils for URL Manipulation
*/
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmurl
* Supported URL types.
*/
typedef enum urltype_e {
URL_IS_UNKNOWN = 0, /*!< unknown (aka a file) */
URL_IS_DASH = 1, /*!< stdin/stdout */
URL_IS_PATH = 2, /*!< file://... */
URL_IS_FTP = 3, /*!< ftp://... */
URL_IS_HTTP = 4, /*!< http://... */
URL_IS_HTTPS = 5, /*!< https://... */
URL_IS_HKP = 6 /*!< hkp://... */
} urltype;
/** \ingroup rpmurl
* Return type of URL.
* @param url url string
* @return type of url
*/
urltype urlIsURL(const char * url);
/** \ingroup rpmurl
* Return path component of URL.
* @param url url string
* @retval pathp pointer to path component of url
* @return type of url
*/
urltype urlPath(const char * url, const char ** pathp);
/** \ingroup rpmurl
* Copy data from URL to local file.
* @param url url string of source
* @param dest file name of destination
* @return 0 on success, -1 on error
*/
int urlGetFile(const char * url, const char * dest);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMURL */
PK vFZd/,W� � rpmfc.hnu �[��� #ifndef _H_RPMFC_
#define _H_RPMFC_
/** \ingroup rpmfc rpmbuild
* \file build/rpmfc.h
* Structures and methods for build-time file classification.
*/
#include <rpm/rpmtypes.h>
#include <rpm/argv.h> /* for ARGV_t */
#include <rpm/rpmspec.h> /* for Package */
#ifdef __cplusplus
extern "C" {
#endif
extern int _rpmfc_debug;
/** \ingroup rpmfc
*/
typedef struct rpmfc_s * rpmfc;
/** \ingroup rpmfc
*/
enum FCOLOR_e {
RPMFC_BLACK = 0,
RPMFC_ELF32 = (1 << 0),
RPMFC_ELF64 = (1 << 1),
RPMFC_ELFMIPSN32 = (1 << 2),
#define RPMFC_ELF (RPMFC_ELF32|RPMFC_ELF64|RPMFC_ELFMIPSN32)
/* (1 << 3) leaks into package headers, reserved */
RPMFC_WHITE = (1 << 29),
RPMFC_INCLUDE = (1 << 30),
RPMFC_ERROR = (1 << 31)
};
/** \ingroup rpmfc
*/
typedef rpmFlags FCOLOR_t;
/** \ingroup rpmfc
*/
typedef const struct rpmfcTokens_s * rpmfcToken;
/** \ingroup rpmfc
* Print results of file classification.
* @param msg message prefix (NULL for none)
* @param fc file classifier
* @param fp output file handle (NULL for stderr)
*/
void rpmfcPrint(const char * msg, rpmfc fc, FILE * fp);
/** \ingroup rpmfc
* Destroy a file classifier.
* @param fc file classifier
* @return NULL always
*/
rpmfc rpmfcFree(rpmfc fc);
/** \ingroup rpmfc
* Create a file classifier.
* @param rootDir (build) root directory
* @param flags (unused)
* @return new file classifier
*/
rpmfc rpmfcCreate(const char *rootDir, rpmFlags flags);
/** \ingroup rpmfc
* @deprecated
* Create a file classifier.
* @return new file classifier
*/
RPM_GNUC_DEPRECATED
rpmfc rpmfcNew(void);
/** \ingroup rpmfc
* Build file class dictionary and mappings.
* @param fc file classifier
* @param argv files to classify
* @param fmode files mode_t array (or NULL)
* @return RPMRC_OK on success
*/
rpmRC rpmfcClassify(rpmfc fc, ARGV_t argv, rpm_mode_t * fmode);
/** \ingroup rpmfc
* Build file/package dependency dictionary and mappings.
* @param fc file classifier
* @return RPMRC_OK on success
*/
rpmRC rpmfcApply(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification provides
* @param fc file classifier
* @return rpmds dependency set of fc provides
*/
rpmds rpmfcProvides(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification requires
* @param fc file classifier
* @return rpmds dependency set of fc requires
*/
rpmds rpmfcRequires(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification recommends
* @param fc file classifier
* @return rpmds dependency set of fc recommends
*/
rpmds rpmfcRecommends(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification suggests
* @param fc file classifier
* @return rpmds dependency set of fc suggests
*/
rpmds rpmfcSuggests(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification supplements
* @param fc file classifier
* @return rpmds dependency set of fc supplements
*/
rpmds rpmfcSupplements(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification enhances
* @param fc file classifier
* @return rpmds dependency set of fc enhances
*/
rpmds rpmfcEnhances(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification conflicts
* @param fc file classifier
* @return rpmds dependency set of fc conflicts
*/
rpmds rpmfcConflicts(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification obsoletes
* @param fc file classifier
* @return rpmds dependency set of fc obsoletes
*/
rpmds rpmfcObsoletes(rpmfc fc);
/** \ingroup rpmfc
* Retrieve file classification dependencies
* @param fc file classifier
* @param tagN name tag of the wanted dependency
* @return rpmds dependency set of fc requires
*/
rpmds rpmfcDependencies(rpmfc fc, rpmTagVal tagN);
#ifdef __cplusplus
}
#endif
#endif /* _H_RPMFC_ */
PK vFZw~'�GZ GZ rpmtag.hnu �[��� #ifndef _RPMTAG_H
#define _RPMTAG_H
/** \ingroup rpmtag
* \file lib/rpmtag.h
*
* Accessing RPM tags: values, types, ...
*/
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* Header private tags.
* @note General use tags should start at 1000 (RPM's tag space starts there).
*/
#define HEADER_IMAGE 61
#define HEADER_SIGNATURES 62
#define HEADER_IMMUTABLE 63
#define HEADER_REGIONS 64
#define HEADER_I18NTABLE 100
#define HEADER_SIGBASE 256
#define HEADER_TAGBASE 1000
/** \ingroup rpmtag
* Tags identify data in package headers.
* @note tags should not have value 0!
* @note all new tags should be added above 5000
*/
/** @todo: Somehow supply type **/
typedef enum rpmTag_e {
RPMTAG_NOT_FOUND = -1, /*!< Unknown tag */
RPMTAG_HEADERIMAGE = HEADER_IMAGE, /*!< Current image. */
RPMTAG_HEADERSIGNATURES = HEADER_SIGNATURES, /*!< Signatures. */
RPMTAG_HEADERIMMUTABLE = HEADER_IMMUTABLE, /*!< Original image. */
RPMTAG_HEADERREGIONS = HEADER_REGIONS, /*!< Regions. */
RPMTAG_HEADERI18NTABLE = HEADER_I18NTABLE, /* s[] !< I18N string locales. */
/* Retrofit (and uniqify) signature tags for use by rpmTagGetName() and rpmQuery. */
/* the md5 sum was broken *twice* on big endian machines */
/* XXX 2nd underscore prevents tagTable generation */
RPMTAG_SIG_BASE = HEADER_SIGBASE,
RPMTAG_SIGSIZE = RPMTAG_SIG_BASE+1, /* i */
RPMTAG_SIGLEMD5_1 = RPMTAG_SIG_BASE+2, /* internal - obsolete */
RPMTAG_SIGPGP = RPMTAG_SIG_BASE+3, /* x */
RPMTAG_SIGLEMD5_2 = RPMTAG_SIG_BASE+4, /* x internal - obsolete */
RPMTAG_SIGMD5 = RPMTAG_SIG_BASE+5, /* x */
#define RPMTAG_PKGID RPMTAG_SIGMD5 /* x */
RPMTAG_SIGGPG = RPMTAG_SIG_BASE+6, /* x */
RPMTAG_SIGPGP5 = RPMTAG_SIG_BASE+7, /* internal - obsolete */
RPMTAG_BADSHA1_1 = RPMTAG_SIG_BASE+8, /* internal - obsolete */
RPMTAG_BADSHA1_2 = RPMTAG_SIG_BASE+9, /* internal - obsolete */
RPMTAG_PUBKEYS = RPMTAG_SIG_BASE+10, /* s[] */
RPMTAG_DSAHEADER = RPMTAG_SIG_BASE+11, /* x */
RPMTAG_RSAHEADER = RPMTAG_SIG_BASE+12, /* x */
RPMTAG_SHA1HEADER = RPMTAG_SIG_BASE+13, /* s */
#define RPMTAG_HDRID RPMTAG_SHA1HEADER /* s */
RPMTAG_LONGSIGSIZE = RPMTAG_SIG_BASE+14, /* l */
RPMTAG_LONGARCHIVESIZE = RPMTAG_SIG_BASE+15, /* l */
/* RPMTAG_SIG_BASE+16 reserved */
RPMTAG_SHA256HEADER = RPMTAG_SIG_BASE+17, /* s */
RPMTAG_NAME = 1000, /* s */
#define RPMTAG_N RPMTAG_NAME /* s */
RPMTAG_VERSION = 1001, /* s */
#define RPMTAG_V RPMTAG_VERSION /* s */
RPMTAG_RELEASE = 1002, /* s */
#define RPMTAG_R RPMTAG_RELEASE /* s */
RPMTAG_EPOCH = 1003, /* i */
#define RPMTAG_E RPMTAG_EPOCH /* i */
RPMTAG_SUMMARY = 1004, /* s{} */
RPMTAG_DESCRIPTION = 1005, /* s{} */
RPMTAG_BUILDTIME = 1006, /* i */
RPMTAG_BUILDHOST = 1007, /* s */
RPMTAG_INSTALLTIME = 1008, /* i */
RPMTAG_SIZE = 1009, /* i */
RPMTAG_DISTRIBUTION = 1010, /* s */
RPMTAG_VENDOR = 1011, /* s */
RPMTAG_GIF = 1012, /* x */
RPMTAG_XPM = 1013, /* x */
RPMTAG_LICENSE = 1014, /* s */
RPMTAG_PACKAGER = 1015, /* s */
RPMTAG_GROUP = 1016, /* s{} */
RPMTAG_CHANGELOG = 1017, /* s[] internal */
RPMTAG_SOURCE = 1018, /* s[] */
RPMTAG_PATCH = 1019, /* s[] */
RPMTAG_URL = 1020, /* s */
RPMTAG_OS = 1021, /* s legacy used int */
RPMTAG_ARCH = 1022, /* s legacy used int */
RPMTAG_PREIN = 1023, /* s */
RPMTAG_POSTIN = 1024, /* s */
RPMTAG_PREUN = 1025, /* s */
RPMTAG_POSTUN = 1026, /* s */
RPMTAG_OLDFILENAMES = 1027, /* s[] obsolete */
RPMTAG_FILESIZES = 1028, /* i[] */
RPMTAG_FILESTATES = 1029, /* c[] */
RPMTAG_FILEMODES = 1030, /* h[] */
RPMTAG_FILEUIDS = 1031, /* i[] internal - obsolete */
RPMTAG_FILEGIDS = 1032, /* i[] internal - obsolete */
RPMTAG_FILERDEVS = 1033, /* h[] */
RPMTAG_FILEMTIMES = 1034, /* i[] */
RPMTAG_FILEDIGESTS = 1035, /* s[] */
#define RPMTAG_FILEMD5S RPMTAG_FILEDIGESTS /* s[] */
RPMTAG_FILELINKTOS = 1036, /* s[] */
RPMTAG_FILEFLAGS = 1037, /* i[] */
RPMTAG_ROOT = 1038, /* internal - obsolete */
RPMTAG_FILEUSERNAME = 1039, /* s[] */
RPMTAG_FILEGROUPNAME = 1040, /* s[] */
RPMTAG_EXCLUDE = 1041, /* internal - obsolete */
RPMTAG_EXCLUSIVE = 1042, /* internal - obsolete */
RPMTAG_ICON = 1043, /* x */
RPMTAG_SOURCERPM = 1044, /* s */
RPMTAG_FILEVERIFYFLAGS = 1045, /* i[] */
RPMTAG_ARCHIVESIZE = 1046, /* i */
RPMTAG_PROVIDENAME = 1047, /* s[] */
#define RPMTAG_PROVIDES RPMTAG_PROVIDENAME /* s[] */
#define RPMTAG_P RPMTAG_PROVIDENAME /* s[] */
RPMTAG_REQUIREFLAGS = 1048, /* i[] */
RPMTAG_REQUIRENAME = 1049, /* s[] */
#define RPMTAG_REQUIRES RPMTAG_REQUIRENAME /* s[] */
RPMTAG_REQUIREVERSION = 1050, /* s[] */
RPMTAG_NOSOURCE = 1051, /* i[] */
RPMTAG_NOPATCH = 1052, /* i[] */
RPMTAG_CONFLICTFLAGS = 1053, /* i[] */
RPMTAG_CONFLICTNAME = 1054, /* s[] */
#define RPMTAG_CONFLICTS RPMTAG_CONFLICTNAME /* s[] */
#define RPMTAG_C RPMTAG_CONFLICTNAME /* s[] */
RPMTAG_CONFLICTVERSION = 1055, /* s[] */
RPMTAG_DEFAULTPREFIX = 1056, /* s internal - deprecated */
RPMTAG_BUILDROOT = 1057, /* s internal - obsolete */
RPMTAG_INSTALLPREFIX = 1058, /* s internal - deprecated */
RPMTAG_EXCLUDEARCH = 1059, /* s[] */
RPMTAG_EXCLUDEOS = 1060, /* s[] */
RPMTAG_EXCLUSIVEARCH = 1061, /* s[] */
RPMTAG_EXCLUSIVEOS = 1062, /* s[] */
RPMTAG_AUTOREQPROV = 1063, /* s internal */
RPMTAG_RPMVERSION = 1064, /* s */
RPMTAG_TRIGGERSCRIPTS = 1065, /* s[] */
RPMTAG_TRIGGERNAME = 1066, /* s[] */
RPMTAG_TRIGGERVERSION = 1067, /* s[] */
RPMTAG_TRIGGERFLAGS = 1068, /* i[] */
RPMTAG_TRIGGERINDEX = 1069, /* i[] */
RPMTAG_VERIFYSCRIPT = 1079, /* s */
RPMTAG_CHANGELOGTIME = 1080, /* i[] */
RPMTAG_CHANGELOGNAME = 1081, /* s[] */
RPMTAG_CHANGELOGTEXT = 1082, /* s[] */
RPMTAG_BROKENMD5 = 1083, /* internal - obsolete */
RPMTAG_PREREQ = 1084, /* internal */
RPMTAG_PREINPROG = 1085, /* s[] */
RPMTAG_POSTINPROG = 1086, /* s[] */
RPMTAG_PREUNPROG = 1087, /* s[] */
RPMTAG_POSTUNPROG = 1088, /* s[] */
RPMTAG_BUILDARCHS = 1089, /* s[] */
RPMTAG_OBSOLETENAME = 1090, /* s[] */
#define RPMTAG_OBSOLETES RPMTAG_OBSOLETENAME /* s[] */
#define RPMTAG_O RPMTAG_OBSOLETENAME /* s[] */
RPMTAG_VERIFYSCRIPTPROG = 1091, /* s[] */
RPMTAG_TRIGGERSCRIPTPROG = 1092, /* s[] */
RPMTAG_DOCDIR = 1093, /* internal */
RPMTAG_COOKIE = 1094, /* s */
RPMTAG_FILEDEVICES = 1095, /* i[] */
RPMTAG_FILEINODES = 1096, /* i[] */
RPMTAG_FILELANGS = 1097, /* s[] */
RPMTAG_PREFIXES = 1098, /* s[] */
RPMTAG_INSTPREFIXES = 1099, /* s[] */
RPMTAG_TRIGGERIN = 1100, /* internal */
RPMTAG_TRIGGERUN = 1101, /* internal */
RPMTAG_TRIGGERPOSTUN = 1102, /* internal */
RPMTAG_AUTOREQ = 1103, /* internal */
RPMTAG_AUTOPROV = 1104, /* internal */
RPMTAG_CAPABILITY = 1105, /* i internal - obsolete */
RPMTAG_SOURCEPACKAGE = 1106, /* i */
RPMTAG_OLDORIGFILENAMES = 1107, /* internal - obsolete */
RPMTAG_BUILDPREREQ = 1108, /* internal */
RPMTAG_BUILDREQUIRES = 1109, /* internal */
RPMTAG_BUILDCONFLICTS = 1110, /* internal */
RPMTAG_BUILDMACROS = 1111, /* internal - unused */
RPMTAG_PROVIDEFLAGS = 1112, /* i[] */
RPMTAG_PROVIDEVERSION = 1113, /* s[] */
RPMTAG_OBSOLETEFLAGS = 1114, /* i[] */
RPMTAG_OBSOLETEVERSION = 1115, /* s[] */
RPMTAG_DIRINDEXES = 1116, /* i[] */
RPMTAG_BASENAMES = 1117, /* s[] */
RPMTAG_DIRNAMES = 1118, /* s[] */
RPMTAG_ORIGDIRINDEXES = 1119, /* i[] relocation */
RPMTAG_ORIGBASENAMES = 1120, /* s[] relocation */
RPMTAG_ORIGDIRNAMES = 1121, /* s[] relocation */
RPMTAG_OPTFLAGS = 1122, /* s */
RPMTAG_DISTURL = 1123, /* s */
RPMTAG_PAYLOADFORMAT = 1124, /* s */
RPMTAG_PAYLOADCOMPRESSOR = 1125, /* s */
RPMTAG_PAYLOADFLAGS = 1126, /* s */
RPMTAG_INSTALLCOLOR = 1127, /* i transaction color when installed */
RPMTAG_INSTALLTID = 1128, /* i */
RPMTAG_REMOVETID = 1129, /* i */
RPMTAG_SHA1RHN = 1130, /* internal - obsolete */
RPMTAG_RHNPLATFORM = 1131, /* s internal - obsolete */
RPMTAG_PLATFORM = 1132, /* s */
RPMTAG_PATCHESNAME = 1133, /* s[] deprecated placeholder (SuSE) */
RPMTAG_PATCHESFLAGS = 1134, /* i[] deprecated placeholder (SuSE) */
RPMTAG_PATCHESVERSION = 1135, /* s[] deprecated placeholder (SuSE) */
RPMTAG_CACHECTIME = 1136, /* i internal - obsolete */
RPMTAG_CACHEPKGPATH = 1137, /* s internal - obsolete */
RPMTAG_CACHEPKGSIZE = 1138, /* i internal - obsolete */
RPMTAG_CACHEPKGMTIME = 1139, /* i internal - obsolete */
RPMTAG_FILECOLORS = 1140, /* i[] */
RPMTAG_FILECLASS = 1141, /* i[] */
RPMTAG_CLASSDICT = 1142, /* s[] */
RPMTAG_FILEDEPENDSX = 1143, /* i[] */
RPMTAG_FILEDEPENDSN = 1144, /* i[] */
RPMTAG_DEPENDSDICT = 1145, /* i[] */
RPMTAG_SOURCEPKGID = 1146, /* x */
RPMTAG_FILECONTEXTS = 1147, /* s[] - obsolete */
RPMTAG_FSCONTEXTS = 1148, /* s[] extension */
RPMTAG_RECONTEXTS = 1149, /* s[] extension */
RPMTAG_POLICIES = 1150, /* s[] selinux *.te policy file. */
RPMTAG_PRETRANS = 1151, /* s */
RPMTAG_POSTTRANS = 1152, /* s */
RPMTAG_PRETRANSPROG = 1153, /* s[] */
RPMTAG_POSTTRANSPROG = 1154, /* s[] */
RPMTAG_DISTTAG = 1155, /* s */
RPMTAG_OLDSUGGESTSNAME = 1156, /* s[] - obsolete */
#define RPMTAG_OLDSUGGESTS RPMTAG_OLDSUGGESTSNAME /* s[] - obsolete */
RPMTAG_OLDSUGGESTSVERSION = 1157, /* s[] - obsolete */
RPMTAG_OLDSUGGESTSFLAGS = 1158, /* i[] - obsolete */
RPMTAG_OLDENHANCESNAME = 1159, /* s[] - obsolete */
#define RPMTAG_OLDENHANCES RPMTAG_OLDENHANCESNAME /* s[] - obsolete */
RPMTAG_OLDENHANCESVERSION = 1160, /* s[] - obsolete */
RPMTAG_OLDENHANCESFLAGS = 1161, /* i[] - obsolete */
RPMTAG_PRIORITY = 1162, /* i[] extension placeholder (unimplemented) */
RPMTAG_CVSID = 1163, /* s (unimplemented) */
#define RPMTAG_SVNID RPMTAG_CVSID /* s (unimplemented) */
RPMTAG_BLINKPKGID = 1164, /* s[] (unimplemented) */
RPMTAG_BLINKHDRID = 1165, /* s[] (unimplemented) */
RPMTAG_BLINKNEVRA = 1166, /* s[] (unimplemented) */
RPMTAG_FLINKPKGID = 1167, /* s[] (unimplemented) */
RPMTAG_FLINKHDRID = 1168, /* s[] (unimplemented) */
RPMTAG_FLINKNEVRA = 1169, /* s[] (unimplemented) */
RPMTAG_PACKAGEORIGIN = 1170, /* s (unimplemented) */
RPMTAG_TRIGGERPREIN = 1171, /* internal */
RPMTAG_BUILDSUGGESTS = 1172, /* internal (unimplemented) */
RPMTAG_BUILDENHANCES = 1173, /* internal (unimplemented) */
RPMTAG_SCRIPTSTATES = 1174, /* i[] scriptlet exit codes (unimplemented) */
RPMTAG_SCRIPTMETRICS = 1175, /* i[] scriptlet execution times (unimplemented) */
RPMTAG_BUILDCPUCLOCK = 1176, /* i (unimplemented) */
RPMTAG_FILEDIGESTALGOS = 1177, /* i[] (unimplemented) */
RPMTAG_VARIANTS = 1178, /* s[] (unimplemented) */
RPMTAG_XMAJOR = 1179, /* i (unimplemented) */
RPMTAG_XMINOR = 1180, /* i (unimplemented) */
RPMTAG_REPOTAG = 1181, /* s (unimplemented) */
RPMTAG_KEYWORDS = 1182, /* s[] (unimplemented) */
RPMTAG_BUILDPLATFORMS = 1183, /* s[] (unimplemented) */
RPMTAG_PACKAGECOLOR = 1184, /* i (unimplemented) */
RPMTAG_PACKAGEPREFCOLOR = 1185, /* i (unimplemented) */
RPMTAG_XATTRSDICT = 1186, /* s[] (unimplemented) */
RPMTAG_FILEXATTRSX = 1187, /* i[] (unimplemented) */
RPMTAG_DEPATTRSDICT = 1188, /* s[] (unimplemented) */
RPMTAG_CONFLICTATTRSX = 1189, /* i[] (unimplemented) */
RPMTAG_OBSOLETEATTRSX = 1190, /* i[] (unimplemented) */
RPMTAG_PROVIDEATTRSX = 1191, /* i[] (unimplemented) */
RPMTAG_REQUIREATTRSX = 1192, /* i[] (unimplemented) */
RPMTAG_BUILDPROVIDES = 1193, /* internal (unimplemented) */
RPMTAG_BUILDOBSOLETES = 1194, /* internal (unimplemented) */
RPMTAG_DBINSTANCE = 1195, /* i extension */
RPMTAG_NVRA = 1196, /* s extension */
/* tags 1997-4999 reserved */
RPMTAG_FILENAMES = 5000, /* s[] extension */
RPMTAG_FILEPROVIDE = 5001, /* s[] extension */
RPMTAG_FILEREQUIRE = 5002, /* s[] extension */
RPMTAG_FSNAMES = 5003, /* s[] (unimplemented) */
RPMTAG_FSSIZES = 5004, /* l[] (unimplemented) */
RPMTAG_TRIGGERCONDS = 5005, /* s[] extension */
RPMTAG_TRIGGERTYPE = 5006, /* s[] extension */
RPMTAG_ORIGFILENAMES = 5007, /* s[] extension */
RPMTAG_LONGFILESIZES = 5008, /* l[] */
RPMTAG_LONGSIZE = 5009, /* l */
RPMTAG_FILECAPS = 5010, /* s[] */
RPMTAG_FILEDIGESTALGO = 5011, /* i file digest algorithm */
RPMTAG_BUGURL = 5012, /* s */
RPMTAG_EVR = 5013, /* s extension */
RPMTAG_NVR = 5014, /* s extension */
RPMTAG_NEVR = 5015, /* s extension */
RPMTAG_NEVRA = 5016, /* s extension */
RPMTAG_HEADERCOLOR = 5017, /* i extension */
RPMTAG_VERBOSE = 5018, /* i extension */
RPMTAG_EPOCHNUM = 5019, /* i extension */
RPMTAG_PREINFLAGS = 5020, /* i */
RPMTAG_POSTINFLAGS = 5021, /* i */
RPMTAG_PREUNFLAGS = 5022, /* i */
RPMTAG_POSTUNFLAGS = 5023, /* i */
RPMTAG_PRETRANSFLAGS = 5024, /* i */
RPMTAG_POSTTRANSFLAGS = 5025, /* i */
RPMTAG_VERIFYSCRIPTFLAGS = 5026, /* i */
RPMTAG_TRIGGERSCRIPTFLAGS = 5027, /* i[] */
RPMTAG_COLLECTIONS = 5029, /* s[] list of collections (unimplemented) */
RPMTAG_POLICYNAMES = 5030, /* s[] */
RPMTAG_POLICYTYPES = 5031, /* s[] */
RPMTAG_POLICYTYPESINDEXES = 5032, /* i[] */
RPMTAG_POLICYFLAGS = 5033, /* i[] */
RPMTAG_VCS = 5034, /* s */
RPMTAG_ORDERNAME = 5035, /* s[] */
RPMTAG_ORDERVERSION = 5036, /* s[] */
RPMTAG_ORDERFLAGS = 5037, /* i[] */
RPMTAG_MSSFMANIFEST = 5038, /* s[] reservation (unimplemented) */
RPMTAG_MSSFDOMAIN = 5039, /* s[] reservation (unimplemented) */
RPMTAG_INSTFILENAMES = 5040, /* s[] extension */
RPMTAG_REQUIRENEVRS = 5041, /* s[] extension */
RPMTAG_PROVIDENEVRS = 5042, /* s[] extension */
RPMTAG_OBSOLETENEVRS = 5043, /* s[] extension */
RPMTAG_CONFLICTNEVRS = 5044, /* s[] extension */
RPMTAG_FILENLINKS = 5045, /* i[] extension */
RPMTAG_RECOMMENDNAME = 5046, /* s[] */
#define RPMTAG_RECOMMENDS RPMTAG_RECOMMENDNAME /* s[] */
RPMTAG_RECOMMENDVERSION = 5047, /* s[] */
RPMTAG_RECOMMENDFLAGS = 5048, /* i[] */
RPMTAG_SUGGESTNAME = 5049, /* s[] */
#define RPMTAG_SUGGESTS RPMTAG_SUGGESTNAME /* s[] */
RPMTAG_SUGGESTVERSION = 5050, /* s[] extension */
RPMTAG_SUGGESTFLAGS = 5051, /* i[] extension */
RPMTAG_SUPPLEMENTNAME = 5052, /* s[] */
#define RPMTAG_SUPPLEMENTS RPMTAG_SUPPLEMENTNAME /* s[] */
RPMTAG_SUPPLEMENTVERSION = 5053, /* s[] */
RPMTAG_SUPPLEMENTFLAGS = 5054, /* i[] */
RPMTAG_ENHANCENAME = 5055, /* s[] */
#define RPMTAG_ENHANCES RPMTAG_ENHANCENAME /* s[] */
RPMTAG_ENHANCEVERSION = 5056, /* s[] */
RPMTAG_ENHANCEFLAGS = 5057, /* i[] */
RPMTAG_RECOMMENDNEVRS = 5058, /* s[] extension */
RPMTAG_SUGGESTNEVRS = 5059, /* s[] extension */
RPMTAG_SUPPLEMENTNEVRS = 5060, /* s[] extension */
RPMTAG_ENHANCENEVRS = 5061, /* s[] extension */
RPMTAG_ENCODING = 5062, /* s */
RPMTAG_FILETRIGGERIN = 5063, /* internal */
RPMTAG_FILETRIGGERUN = 5064, /* internal */
RPMTAG_FILETRIGGERPOSTUN = 5065, /* internal */
RPMTAG_FILETRIGGERSCRIPTS = 5066, /* s[] */
RPMTAG_FILETRIGGERSCRIPTPROG = 5067, /* s[] */
RPMTAG_FILETRIGGERSCRIPTFLAGS = 5068, /* i[] */
RPMTAG_FILETRIGGERNAME = 5069, /* s[] */
RPMTAG_FILETRIGGERINDEX = 5070, /* i[] */
RPMTAG_FILETRIGGERVERSION = 5071, /* s[] */
RPMTAG_FILETRIGGERFLAGS = 5072, /* i[] */
RPMTAG_TRANSFILETRIGGERIN = 5073, /* internal */
RPMTAG_TRANSFILETRIGGERUN = 5074, /* internal */
RPMTAG_TRANSFILETRIGGERPOSTUN = 5075, /* internal */
RPMTAG_TRANSFILETRIGGERSCRIPTS = 5076, /* s[] */
RPMTAG_TRANSFILETRIGGERSCRIPTPROG = 5077, /* s[] */
RPMTAG_TRANSFILETRIGGERSCRIPTFLAGS = 5078, /* i[] */
RPMTAG_TRANSFILETRIGGERNAME = 5079, /* s[] */
RPMTAG_TRANSFILETRIGGERINDEX = 5080, /* i[] */
RPMTAG_TRANSFILETRIGGERVERSION = 5081, /* s[] */
RPMTAG_TRANSFILETRIGGERFLAGS = 5082, /* i[] */
RPMTAG_REMOVEPATHPOSTFIXES = 5083, /* s internal */
RPMTAG_FILETRIGGERPRIORITIES = 5084, /* i[] */
RPMTAG_TRANSFILETRIGGERPRIORITIES = 5085, /* i[] */
RPMTAG_FILETRIGGERCONDS = 5086, /* s[] extension */
RPMTAG_FILETRIGGERTYPE = 5087, /* s[] extension */
RPMTAG_TRANSFILETRIGGERCONDS = 5088, /* s[] extension */
RPMTAG_TRANSFILETRIGGERTYPE = 5089, /* s[] extension */
RPMTAG_FILESIGNATURES = 5090, /* s[] */
RPMTAG_FILESIGNATURELENGTH = 5091, /* i */
RPMTAG_PAYLOADDIGEST = 5092, /* s[] */
RPMTAG_PAYLOADDIGESTALGO = 5093, /* i */
RPMTAG_MODULARITYLABEL = 5096, /* s */
RPMTAG_FIRSTFREE_TAG /*!< internal */
} rpmTag;
#define RPMTAG_EXTERNAL_TAG 1000000
/** \ingroup rpmtag
* Rpm database index tags.
*/
typedef enum rpmDbiTag_e {
RPMDBI_PACKAGES = 0, /* Installed package headers. */
RPMDBI_LABEL = 2, /* NEVRA label pseudo index */
RPMDBI_NAME = RPMTAG_NAME,
RPMDBI_BASENAMES = RPMTAG_BASENAMES,
RPMDBI_GROUP = RPMTAG_GROUP,
RPMDBI_REQUIRENAME = RPMTAG_REQUIRENAME,
RPMDBI_PROVIDENAME = RPMTAG_PROVIDENAME,
RPMDBI_CONFLICTNAME = RPMTAG_CONFLICTNAME,
RPMDBI_OBSOLETENAME = RPMTAG_OBSOLETENAME,
RPMDBI_TRIGGERNAME = RPMTAG_TRIGGERNAME,
RPMDBI_DIRNAMES = RPMTAG_DIRNAMES,
RPMDBI_INSTALLTID = RPMTAG_INSTALLTID,
RPMDBI_SIGMD5 = RPMTAG_SIGMD5,
RPMDBI_SHA1HEADER = RPMTAG_SHA1HEADER,
RPMDBI_INSTFILENAMES = RPMTAG_INSTFILENAMES,
RPMDBI_FILETRIGGERNAME = RPMTAG_FILETRIGGERNAME,
RPMDBI_TRANSFILETRIGGERNAME = RPMTAG_TRANSFILETRIGGERNAME,
RPMDBI_RECOMMENDNAME = RPMTAG_RECOMMENDNAME,
RPMDBI_SUGGESTNAME = RPMTAG_SUGGESTNAME,
RPMDBI_SUPPLEMENTNAME = RPMTAG_SUPPLEMENTNAME,
RPMDBI_ENHANCENAME = RPMTAG_ENHANCENAME,
} rpmDbiTag;
/** \ingroup signature
* Tags found in signature header from package.
*/
typedef enum rpmSigTag_e {
RPMSIGTAG_SIZE = 1000, /*!< internal Header+Payload size (32bit) in bytes. */
RPMSIGTAG_LEMD5_1 = 1001, /*!< internal Broken MD5, take 1 @deprecated legacy. */
RPMSIGTAG_PGP = 1002, /*!< internal PGP 2.6.3 signature. */
RPMSIGTAG_LEMD5_2 = 1003, /*!< internal Broken MD5, take 2 @deprecated legacy. */
RPMSIGTAG_MD5 = 1004, /*!< internal MD5 signature. */
RPMSIGTAG_GPG = 1005, /*!< internal GnuPG signature. */
RPMSIGTAG_PGP5 = 1006, /*!< internal PGP5 signature @deprecated legacy. */
RPMSIGTAG_PAYLOADSIZE = 1007,/*!< internal uncompressed payload size (32bit) in bytes. */
RPMSIGTAG_RESERVEDSPACE = 1008,/*!< internal space reserved for signatures */
RPMSIGTAG_BADSHA1_1 = RPMTAG_BADSHA1_1, /*!< internal Broken SHA1, take 1. */
RPMSIGTAG_BADSHA1_2 = RPMTAG_BADSHA1_2, /*!< internal Broken SHA1, take 2. */
RPMSIGTAG_DSA = RPMTAG_DSAHEADER, /*!< internal DSA header signature. */
RPMSIGTAG_RSA = RPMTAG_RSAHEADER, /*!< internal RSA header signature. */
RPMSIGTAG_SHA1 = RPMTAG_SHA1HEADER, /*!< internal sha1 header digest. */
RPMSIGTAG_LONGSIZE = RPMTAG_LONGSIGSIZE, /*!< internal Header+Payload size (64bit) in bytes. */
RPMSIGTAG_LONGARCHIVESIZE = RPMTAG_LONGARCHIVESIZE, /*!< internal uncompressed payload size (64bit) in bytes. */
RPMSIGTAG_SHA256 = RPMTAG_SHA256HEADER,
} rpmSigTag;
/** \ingroup header
* The basic types of data in tags from headers.
*/
typedef enum rpmTagType_e {
#define RPM_MIN_TYPE 0
RPM_NULL_TYPE = 0,
RPM_CHAR_TYPE = 1,
RPM_INT8_TYPE = 2,
RPM_INT16_TYPE = 3,
RPM_INT32_TYPE = 4,
RPM_INT64_TYPE = 5,
RPM_STRING_TYPE = 6,
RPM_BIN_TYPE = 7,
RPM_STRING_ARRAY_TYPE = 8,
RPM_I18NSTRING_TYPE = 9,
#define RPM_MAX_TYPE 9
#define RPM_FORCEFREE_TYPE 0xff
#define RPM_MASK_TYPE 0x0000ffff
} rpmTagType;
/** \ingroup rpmtag
* The classes of data in tags from headers.
*/
typedef enum rpmTagClass_e {
RPM_NULL_CLASS = 0,
RPM_NUMERIC_CLASS = 1,
RPM_STRING_CLASS = 2,
RPM_BINARY_CLASS = 3,
} rpmTagClass;
/** \ingroup header
* New rpm data types under consideration/development.
* These data types may (or may not) be added to rpm at some point. In order
* to avoid incompatibility with legacy versions of rpm, these data (sub-)types
* are introduced into the header by overloading RPM_BIN_TYPE, with the binary
* value of the tag a 16 byte image of what should/will be in the header index,
* followed by per-tag private data.
*/
typedef enum rpmSubTagType_e {
RPM_REGION_TYPE = -10,
RPM_BIN_ARRAY_TYPE = -11,
/*!<@todo Implement, kinda like RPM_STRING_ARRAY_TYPE for known (but variable)
length binary data. */
RPM_XREF_TYPE = -12
/*!<@todo Implement, intent is to to carry a (???,tagNum,valNum) cross
reference to retrieve data from other tags. */
} rpmSubTagType;
/** \ingroup header
* * Identify how to return the header data type.
* */
enum rpmTagReturnType_e {
RPM_ANY_RETURN_TYPE = 0,
RPM_SCALAR_RETURN_TYPE = 0x00010000,
RPM_ARRAY_RETURN_TYPE = 0x00020000,
RPM_MAPPING_RETURN_TYPE = 0x00040000,
RPM_MASK_RETURN_TYPE = 0xffff0000
};
typedef rpmFlags rpmTagReturnType;
/** \ingroup rpmtag
* Return tag name from value.
* @param tag tag value
* @return tag name, "(unknown)" on not found
*/
const char * rpmTagGetName(rpmTagVal tag);
/** \ingroup rpmtag
* Return tag data type from value.
* @param tag tag value
* @return tag data type + return type, RPM_NULL_TYPE on not found.
*/
rpmTagType rpmTagGetType(rpmTagVal tag);
/** \ingroup rpmtag
* Return tag data type from value.
* @param tag tag value
* @return tag data type, RPM_NULL_TYPE on not found.
*/
rpmTagType rpmTagGetTagType(rpmTagVal tag);
/** \ingroup rpmtag
* Return tag data type from value.
* @param tag tag value
* @return tag data return type, RPM_NULL_TYPE on not found.
*/
rpmTagReturnType rpmTagGetReturnType(rpmTagVal tag);
/** \ingroup rpmtag
* Return tag data class from value.
* @param tag tag value
* @return tag data class, RPM_NULL_CLASS on not found.
*/
rpmTagClass rpmTagGetClass(rpmTagVal tag);
/** \ingroup rpmtag
* Return tag value from name.
* @param tagstr name of tag
* @return tag value, -1 on not found
*/
rpmTagVal rpmTagGetValue(const char * tagstr);
/** \ingroup rpmtag
* Return data class of type
* @param type tag type
* @return data class, RPM_NULL_CLASS on unknown.
*/
rpmTagClass rpmTagTypeGetClass(rpmTagType type);
/** \ingroup rpmtag
* Return known rpm tag names, sorted by name.
* @retval tagnames tag container of string array type
* @param fullname return short or full name
* @return number of tag names, 0 on error
*/
int rpmTagGetNames(rpmtd tagnames, int fullname);
#ifdef __cplusplus
}
#endif
#endif /* _RPMTAG_H */
PK vFZ#p�� > >
rpmfiles.hnu �[��� #ifndef _RPMFILES_H
#define _RPMFILES_H
/** \ingroup rpmfilesles
* \file lib/rpmfiles.h
* File info set API.
*/
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmvf.h>
#include <rpm/rpmpgp.h>
/** \ingroup rpmfiles
* File types.
* These are the file types used internally by rpm. The file
* type is determined by applying stat(2) macros like S_ISDIR to
* the file mode tag from a header. The values are arbitrary,
* but are identical to the linux stat(2) file types.
*/
typedef enum rpmFileTypes_e {
PIPE = 1, /*!< pipe/fifo */
CDEV = 2, /*!< character device */
XDIR = 4, /*!< directory */
BDEV = 6, /*!< block device */
REG = 8, /*!< regular file */
LINK = 10, /*!< hard link */
SOCK = 12 /*!< socket */
} rpmFileTypes;
/**
* File States (when installed).
*/
typedef enum rpmfileState_e {
RPMFILE_STATE_MISSING = -1, /* used for unavailable data */
RPMFILE_STATE_NORMAL = 0,
RPMFILE_STATE_REPLACED = 1,
RPMFILE_STATE_NOTINSTALLED = 2,
RPMFILE_STATE_NETSHARED = 3,
RPMFILE_STATE_WRONGCOLOR = 4
} rpmfileState;
#define RPMFILE_IS_INSTALLED(_x) ((_x) == RPMFILE_STATE_NORMAL || (_x) == RPMFILE_STATE_NETSHARED)
/**
* Exported File Attributes (ie RPMTAG_FILEFLAGS)
*/
enum rpmfileAttrs_e {
RPMFILE_NONE = 0,
RPMFILE_CONFIG = (1 << 0), /*!< from %%config */
RPMFILE_DOC = (1 << 1), /*!< from %%doc */
RPMFILE_ICON = (1 << 2), /*!< from %%donotuse. */
RPMFILE_MISSINGOK = (1 << 3), /*!< from %%config(missingok) */
RPMFILE_NOREPLACE = (1 << 4), /*!< from %%config(noreplace) */
RPMFILE_SPECFILE = (1 << 5), /*!< @todo (unnecessary) marks 1st file in srpm. */
RPMFILE_GHOST = (1 << 6), /*!< from %%ghost */
RPMFILE_LICENSE = (1 << 7), /*!< from %%license */
RPMFILE_README = (1 << 8), /*!< from %%readme */
/* bits 9-10 unused */
RPMFILE_PUBKEY = (1 << 11), /*!< from %%pubkey */
RPMFILE_ARTIFACT = (1 << 12), /*!< from %%artifact */
};
typedef rpmFlags rpmfileAttrs;
#define RPMFILE_ALL ~(RPMFILE_NONE)
/** \ingroup rpmfiles
* File disposition(s) during package install/erase transaction.
*/
typedef enum rpmFileAction_e {
FA_UNKNOWN = 0, /*!< initial action for file ... */
FA_CREATE = 1, /*!< ... create from payload. */
FA_COPYIN = 2, /*!< obsolete, unused. */
FA_COPYOUT = 3, /*!< obsolete, unused. */
FA_BACKUP = 4, /*!< ... renamed with ".rpmorig" extension. */
FA_SAVE = 5, /*!< ... renamed with ".rpmsave" extension. */
FA_SKIP = 6, /*!< ... already replaced, don't remove. */
FA_ALTNAME = 7, /*!< ... create with ".rpmnew" extension. */
FA_ERASE = 8, /*!< ... to be removed. */
FA_SKIPNSTATE = 9, /*!< ... untouched, state "not installed". */
FA_SKIPNETSHARED = 10, /*!< ... untouched, state "netshared". */
FA_SKIPCOLOR = 11, /*!< ... untouched, state "wrong color". */
FA_TOUCH = 12, /*!< ... change metadata only. */
/* bits 16-31 reserved */
} rpmFileAction;
#define XFA_SKIPPING(_a) \
((_a) == FA_SKIP || (_a) == FA_SKIPNSTATE || (_a) == FA_SKIPNETSHARED || (_a) == FA_SKIPCOLOR)
#define XFA_CREATING(_a) \
((_a) == FA_CREATE || (_a) == FA_BACKUP || (_a) == FA_SAVE || (_a) == FA_ALTNAME)
/**
* We pass these around as an array with a sentinel.
*/
struct rpmRelocation_s {
char * oldPath; /*!< NULL here evals to RPMTAG_DEFAULTPREFIX, */
char * newPath; /*!< NULL means to omit the file completely! */
};
enum rpmfiFlags_e {
RPMFI_NOHEADER = 0,
RPMFI_KEEPHEADER = (1 << 0),
RPMFI_NOFILECLASS = (1 << 1),
RPMFI_NOFILEDEPS = (1 << 2),
RPMFI_NOFILELANGS = (1 << 3),
RPMFI_NOFILEUSER = (1 << 4),
RPMFI_NOFILEGROUP = (1 << 5),
RPMFI_NOFILEMODES = (1 << 6),
RPMFI_NOFILESIZES = (1 << 7),
RPMFI_NOFILECAPS = (1 << 8),
RPMFI_NOFILELINKTOS = (1 << 9),
RPMFI_NOFILEDIGESTS = (1 << 10),
RPMFI_NOFILEMTIMES = (1 << 11),
RPMFI_NOFILERDEVS = (1 << 12),
RPMFI_NOFILEINODES = (1 << 13),
RPMFI_NOFILESTATES = (1 << 14),
RPMFI_NOFILECOLORS = (1 << 15),
RPMFI_NOFILEVERIFYFLAGS = (1 << 16),
RPMFI_NOFILEFLAGS = (1 << 17),
RPMFI_NOFILESIGNATURES = (1 << 18),
};
typedef rpmFlags rpmfiFlags;
#define RPMFI_FLAGS_ERASE \
(RPMFI_NOFILECLASS | RPMFI_NOFILELANGS | \
RPMFI_NOFILEMTIMES | RPMFI_NOFILERDEVS | \
RPMFI_NOFILEVERIFYFLAGS)
#define RPMFI_FLAGS_INSTALL \
(RPMFI_NOFILECLASS | RPMFI_NOFILEVERIFYFLAGS)
#define RPMFI_FLAGS_VERIFY \
(RPMFI_NOFILECLASS | RPMFI_NOFILEDEPS | RPMFI_NOFILELANGS | \
RPMFI_NOFILECOLORS)
#define RPMFI_FLAGS_QUERY \
(RPMFI_NOFILECLASS | RPMFI_NOFILEDEPS | RPMFI_NOFILELANGS | \
RPMFI_NOFILECOLORS | RPMFI_NOFILEVERIFYFLAGS)
#define RPMFI_FLAGS_FILETRIGGER \
(RPMFI_NOFILECLASS | RPMFI_NOFILEDEPS | RPMFI_NOFILELANGS | \
RPMFI_NOFILEUSER | RPMFI_NOFILEGROUP | RPMFI_NOFILEMODES | \
RPMFI_NOFILESIZES | RPMFI_NOFILECAPS | RPMFI_NOFILELINKTOS | \
RPMFI_NOFILEDIGESTS | RPMFI_NOFILEMTIMES | RPMFI_NOFILERDEVS | \
RPMFI_NOFILEINODES | RPMFI_NOFILECOLORS | \
RPMFI_NOFILEVERIFYFLAGS | RPMFI_NOFILEFLAGS)
#define RPMFI_FLAGS_ONLY_FILENAMES \
(RPMFI_FLAGS_FILETRIGGER | RPMFI_NOFILESTATES)
typedef enum rpmFileIter_e {
RPMFI_ITER_FWD = 0,
RPMFI_ITER_BACK = 1,
RPMFI_ITER_WRITE_ARCHIVE = 2,
RPMFI_ITER_READ_ARCHIVE = 3,
RPMFI_ITER_READ_ARCHIVE_CONTENT_FIRST = 4,
RPMFI_ITER_READ_ARCHIVE_OMIT_HARDLINKS = 5,
RPMFI_ITER_INTERVAL = 6,
} rpmFileIter;
#define RPMFILEITERMAX 6
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmfiles
* Create and load a file info set.
* @param pool shared string pool (or NULL for private pool)
* @param h header
* @param tagN unused
* @param flags Flags to control what information is loaded.
* @return new file info set
*/
rpmfiles rpmfilesNew(rpmstrPool pool, Header h, rpmTagVal tagN, rpmfiFlags flags);
/** \ingroup rpmfiles
* Reference a file info set instance.
* @param fi file info set
* @return new file info set reference
*/
rpmfiles rpmfilesLink(rpmfiles fi);
/** \ingroup rpmfiles
* Destroy a file info set.
* @param fi file info set
* @return NULL always
*/
rpmfiles rpmfilesFree(rpmfiles fi);
/** \ingroup rpmfiles
* Return file count from file info set.
* @param fi file info set
* @return file count
*/
rpm_count_t rpmfilesFC(rpmfiles fi);
/** \ingroup rpmfiles
* Return directory count from file info set.
* @param fi file info set
* @return directory count
*/
rpm_count_t rpmfilesDC(rpmfiles fi);
/** \ingroup rpmfiles
* Return file index of the given file name or -1 if file is not in the rpmfi.
* The file name may have "." prefixed but is then interpreted as a global
* path without the prefixing "."
* @param files file info set
* @param fn file name
* @return file index or -1
*/
int rpmfilesFindFN(rpmfiles files, const char * fn);
/** \ingroup rpmfiles
* Return file index of the given original file name or -1 if file is not
* in the rpmfi. The file name may have "." prefixed but is then interpreted
* as a global path without the prefixing "."
* @param files file info set
* @param fn file name
* @return file index or -1
*/
int rpmfilesFindOFN(rpmfiles files, const char * fn);
rpmfi rpmfilesIter(rpmfiles files, int itype);
/** \ingroup rpmfiles
* Return digest algorithm of a file info set.
* @param fi file info set
* @return digest algorithm of file info set, 0 on invalid
*/
int rpmfilesDigestAlgo(rpmfiles fi);
/** \ingroup rpmfiles
* Return union of all file color bits from file info set.
* @param files file info set
* @return color
*/
rpm_color_t rpmfilesColor(rpmfiles files);
/** \ingroup rpmfiles
* Return file info comparison.
* @param afi 1st file info
* @param aix index of the 1st file
* @param bfi 2nd file info
* @param bix index of the 2nd file
* @return 0 if identical
*/
int rpmfilesCompare(rpmfiles afi, int aix, rpmfiles bfi, int bix);
/** \ingroup rpmfiles
* Return base name from file info set.
* @param fi file info set
* @param ix file index
* @return base name, NULL on invalid
*/
const char * rpmfilesBN(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return directory name from file info set. Note the index is on
* distinct directories within the file set, not a file index. The
* directory index associated with a given file index can be retrieved
* with rpmfilesDI(). Ie to constuct the full path of file index X
* you'd catenate the results of rpmfilesDN(f, rpmfilesDI(f, X)) and
* rpmfilesBN(f, X).
* @param fi file info set
* @param jx directory index
* @return directory, NULL on invalid
*/
const char * rpmfilesDN(rpmfiles fi, int jx);
/** \ingroup rpmfiles
* Return directory index from file info set.
* @param fi file info set
* @param ix file index
* @return directory index, -1 on invalid
*/
int rpmfilesDI(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file name from file info set.
* @param fi file info set
* @param ix file index
* @return file name (malloced)
*/
char * rpmfilesFN(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return original directory index from file info set.
* @param fi file info set
* @param ix file index
* @return directory index, -1 on invalid
*/
int rpmfilesODI(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return original base name from file info set.
* @param fi file info set
* @param ix file index
* @return base name, NULL on invalid
*/
const char * rpmfilesOBN(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return original directory name from file info set. Note the index is on
* distinct directories within the file set, not a file index. The
* directory index associated with a given file index can be retrieved
* with rpmfilesODI(). Ie to constuct the full path of file index X
* you'd catenate the results of rpmfilesODN(f, rpmfilesODI(f, X)) and
* rpmfilesOBN(f, X).
* @param fi file info set
* @param jx directory index
* @return directory, NULL on invalid
*/
const char * rpmfilesODN(rpmfiles fi, int jx);
/** \ingroup rpmfiles
* Return original file name from file info set.
* @param fi file info set
* @param ix file index
* @return file name
*/
char * rpmfilesOFN(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file verify flags from file info set.
* @param fi file info set
* @param ix file index
* @return file verify flags, 0 on invalid
*/
rpmVerifyAttrs rpmfilesVFlags(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file state from file info set.
* @param fi file info set
* @param ix file index
* @return file state, 0 on invalid
*/
rpmfileState rpmfilesFState(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file linkto (i.e. symlink(2) target) from file info set.
* @param fi file info set
* @param ix file index
* @return file linkto, NULL on invalid
*/
const char * rpmfilesFLink(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file size from file info set.
* @param fi file info set
* @param ix file index
* @return file size, 0 on invalid
*/
rpm_loff_t rpmfilesFSize(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file color bits from file info set.
* @param fi file info set
* @param ix file index
* @return file color
*/
rpm_color_t rpmfilesFColor(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file class from file info set.
* @param fi file info set
* @param ix file index
* @return file class, 0 on invalid
*/
const char * rpmfilesFClass(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file depends dictionary from file info set.
* @param fi file info set
* @param ix file index
* @retval *fddictp file depends dictionary array (or NULL)
* @return no. of file depends entries, 0 on invalid
*/
uint32_t rpmfilesFDepends(rpmfiles fi, int ix, const uint32_t ** fddictp);
/** \ingroup rpmfiles
* Return (calculated) file nlink count from file info set.
* @param fi file info set
* @param ix file index
* @return file nlink count, 0 on invalid
*/
uint32_t rpmfilesFNlink(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return (calculated) file nlink count from file info set.
* @param fi file info set
* @param ix file index
* @param files returns array of file ids hardlinked including ix,
NULL for nlink count == 1
* @return file nlink count, 0 on invalid
*/
uint32_t rpmfilesFLinks(rpmfiles fi, int ix, const int ** files);
/** \ingroup rpmfiles
* Return file language(s) from file info set.
* @param fi file info set
* @param ix file index
* @return file language(s), NULL on invalid
*/
const char * rpmfilesFLangs(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file flags from file info set.
* @param fi file info set
* @param ix file index
* @return file flags, 0 on invalid
*/
rpmfileAttrs rpmfilesFFlags(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file mode from file info set.
* @param fi file info set
* @param ix file index
* @return file mode, 0 on invalid
*/
rpm_mode_t rpmfilesFMode(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file (binary) digest of file info set.
* @param fi file info set
* @param ix file index
* @retval algo digest hash algorithm used (pass NULL to ignore)
* @retval len digest hash length (pass NULL to ignore)
* @return file digest, NULL on invalid
*/
const unsigned char * rpmfilesFDigest(rpmfiles fi, int ix, int *algo, size_t *len);
/** \ingroup rpmfiles
* Return file (binary) digest of file info set.
* @param fi file info set
* @param ix file index
* @retval len signature length (pass NULL to ignore)
* @return file signature, NULL on invalid
*/
const unsigned char * rpmfilesFSignature(rpmfiles fi, int ix, size_t *len);
/** \ingroup rpmfiles
* Return file rdev from file info set.
* @param fi file info set
* @param ix file index
* @return file rdev, 0 on invalid
*/
rpm_rdev_t rpmfilesFRdev(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file inode from file info set.
* @param fi file info set
* @param ix file index
* @return file inode, 0 on invalid
*/
rpm_ino_t rpmfilesFInode(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file modify time from file info set.
* @param fi file info set
* @param ix file index
* @return file modify time, 0 on invalid
*/
rpm_time_t rpmfilesFMtime(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file owner from file info set.
* @param fi file info set
* @param ix file index
* @return file owner, NULL on invalid
*/
const char * rpmfilesFUser(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return file group from file info set.
* @param fi file info set
* @param ix file index
* @return file group, NULL on invalid
*/
const char * rpmfilesFGroup(rpmfiles fi, int ix);
/** \ingroup rpmfiles
* Return textual representation of file capabilities
* from file info set. See cap_from_text(3) for details.
* @param fi file info set
* @param ix file index
* @return file capability description, "" for no capabilities
* and NULL on invalid
*/
const char * rpmfilesFCaps(rpmfiles fi, int ix);
/** \ingroup rpmfi
* Map file stat(2) info.
* @param fi file info set
* @param ix file index
* @param flags flags
* @retval sb mapped stat(2) data
* @return 0 on success
*/
int rpmfilesStat(rpmfiles fi, int ix, int flags, struct stat *sb);
/** \ingroup rpmfiles
* Verify file attributes (including digest).
* @param fi file info set
* @param ix file index
* @param omitMask bit(s) to disable verify checks
* @return bit(s) to indicate failure (ie 0 for passed verify)
*/
rpmVerifyAttrs rpmfilesVerify(rpmfiles fi, int ix, rpmVerifyAttrs omitMask);
#ifdef __cplusplus
}
#endif
#endif /* _RPMFILES_H */
PK vFZ #=5- 5- rpmfi.hnu �[��� #ifndef H_RPMFI
#define H_RPMFI
/** \ingroup rpmfi
* \file lib/rpmfi.h
* File info set iterator API.
*/
#include <rpm/rpmtypes.h>
#include <rpm/rpmfiles.h>
#include <rpm/rpmarchive.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmfi
* Reference a file info set iterator instance.
* @param fi file info set iterator
* @return new file info set iterator reference
*/
rpmfi rpmfiLink (rpmfi fi);
/** \ingroup rpmfi
* Return file count from file info set iterator.
* @param fi file info set iterator
* @return current file count
*/
rpm_count_t rpmfiFC(rpmfi fi);
/** \ingroup rpmfi
* Return current file index from file info set iterator.
* @param fi file info set iterator
* @return current file index
*/
int rpmfiFX(rpmfi fi);
/** \ingroup rpmfi
* Set current file index in file info set iterator.
* @param fi file info set iterator
* @param fx new file index
* @return current file index
*/
int rpmfiSetFX(rpmfi fi, int fx);
/** \ingroup rpmfi
* Return directory count from file info set iterator.
* @param fi file info set iterator
* @return current directory count
*/
rpm_count_t rpmfiDC(rpmfi fi);
/** \ingroup rpmfi
* Return current directory index from file info set iterator.
* @param fi file info set iterator
* @return current directory index
*/
int rpmfiDX(rpmfi fi);
/** \ingroup rpmfi
* Set current directory index in file info set iterator.
* @param fi file info set iterator
* @param dx new directory index
* @return current directory index
*/
int rpmfiSetDX(rpmfi fi, int dx);
/** \ingroup rpmfi
* Return current base name from file info set iterator.
* @param fi file info set iterator
* @return current base name, NULL on invalid
*/
const char * rpmfiBN(rpmfi fi);
/** \ingroup rpmfi
* Return current directory name from file info set iterator.
* @param fi file info set iterator
* @return current directory, NULL on invalid
*/
const char * rpmfiDN(rpmfi fi);
/** \ingroup rpmfi
* Return current file name from file info set iterator.
* @param fi file info set iterator
* @return current file name
*/
const char * rpmfiFN(rpmfi fi);
/** \ingroup rpmfi
* Return file index of the given file name or -1 if file is not in the rpmfi.
* The file name may have "." prefixed but is then interpreted as a global
* path without the prefixing "."
* @param fi file info set iterator
* @param fn file name
* @return file index or -1
*/
int rpmfiFindFN(rpmfi fi, const char * fn);
/** \ingroup rpmfi
* Return current original base name from file info set iterator.
* @param fi file info set iterator
* @return current base name, NULL on invalid
*/
const char * rpmfiOBN(rpmfi fi);
/** \ingroup rpmfi
* Return current original directory name from file info set iterator.
* @param fi file info set iterator
* @return current directory, NULL on invalid
*/
const char * rpmfiODN(rpmfi fi);
/** \ingroup rpmfi
* Return current original file name from file info set iterator.
* @param fi file info set iterator
* @return current file name
*/
const char * rpmfiOFN(rpmfi fi);
/** \ingroup rpmfi
* Return file index of the given original file name or -1 if file is not
* in the rpmfi. The file name may have "." prefixed but is then interpreted
* as a global path without the prefixing "."
* @param fi file info set iterator
* @param fn file name
* @return file index or -1
*/
int rpmfiFindOFN(rpmfi fi, const char * fn);
/** \ingroup rpmfi
* Return current file flags from file info set iterator.
* @param fi file info set iterator
* @return current file flags, 0 on invalid
*/
rpmfileAttrs rpmfiFFlags(rpmfi fi);
/** \ingroup rpmfi
* Return current file verify flags from file info set iterator.
* @param fi file info set iterator
* @return current file verify flags, 0 on invalid
*/
rpmVerifyAttrs rpmfiVFlags(rpmfi fi);
/** \ingroup rpmfi
* Return current file mode from file info set iterator.
* @param fi file info set iterator
* @return current file mode, 0 on invalid
*/
rpm_mode_t rpmfiFMode(rpmfi fi);
/** \ingroup rpmfi
* Return current file state from file info set iterator.
* @param fi file info set iterator
* @return current file state, 0 on invalid
*/
rpmfileState rpmfiFState(rpmfi fi);
/** \ingroup rpmfi
* Return digest algorithm of a file info set iterator.
* @param fi file info set iterator
* @return digest algorithm of file info set iterator, 0 on invalid
*/
int rpmfiDigestAlgo(rpmfi fi);
/** \ingroup rpmfi
* Return current file (binary) digest of file info set iterator.
* @param fi file info set iterator
* @retval algo digest hash algorithm used (pass NULL to ignore)
* @retval diglen digest hash length (pass NULL to ignore)
* @return current file digest, NULL on invalid
*/
const unsigned char * rpmfiFDigest(rpmfi fi, int *algo, size_t *diglen);
/** \ingroup rpmfi
* Return current file (hex) digest of file info set iterator.
* The file info set iterator stores file digests in binary format to conserve
* memory, this converts the binary data back to hex presentation used in
* headers.
* @param fi file info set iterator
* @retval algo digest hash algorithm used (pass NULL to ignore)
* @return current file digest (malloc'ed), NULL on invalid
*/
char * rpmfiFDigestHex(rpmfi fi, int *algo);
/** \ingroup rpmfi
* Return current file (binary) signature of file info set iterator.
* @param fi file info set iterator
* @retval siglen signature length (pass NULL to ignore)
* @return current file signature, NULL on invalid
*/
const unsigned char * rpmfiFSignature(rpmfi fi, size_t *siglen);
/** \ingroup rpmfi
* Return current file linkto (i.e. symlink(2) target) from file info set iterator.
* @param fi file info set iterator
* @return current file linkto, NULL on invalid
*/
const char * rpmfiFLink(rpmfi fi);
/** \ingroup rpmfi
* Return current file size from file info set iterator.
* @param fi file info set iterator
* @return current file size, 0 on invalid
*/
rpm_loff_t rpmfiFSize(rpmfi fi);
/** \ingroup rpmfi
* Return current file rdev from file info set iterator.
* @param fi file info set iterator
* @return current file rdev, 0 on invalid
*/
rpm_rdev_t rpmfiFRdev(rpmfi fi);
/** \ingroup rpmfi
* Return current file inode from file info set iterator.
* @param fi file info set iterator
* @return current file inode, 0 on invalid
*/
rpm_ino_t rpmfiFInode(rpmfi fi);
/** \ingroup rpmfi
* Return union of all file color bits from file info set iterator.
* @param fi file info set iterator
* @return current color
*/
rpm_color_t rpmfiColor(rpmfi fi);
/** \ingroup rpmfi
* Return current file color bits from file info set iterator.
* @param fi file info set iterator
* @return current file color
*/
rpm_color_t rpmfiFColor(rpmfi fi);
/** \ingroup rpmfi
* Return current file class from file info set iterator.
* @param fi file info set iterator
* @return current file class, 0 on invalid
*/
const char * rpmfiFClass(rpmfi fi);
/** \ingroup rpmfi
* Return current file depends dictionary from file info set iterator.
* @param fi file info set iterator
* @retval *fddictp file depends dictionary array (or NULL)
* @return no. of file depends entries, 0 on invalid
*/
uint32_t rpmfiFDepends(rpmfi fi,
const uint32_t ** fddictp);
/** \ingroup rpmfi
* Return (calculated) current file nlink count from file info set iterator.
* @param fi file info set iterator
* @return current file nlink count, 0 on invalid
*/
uint32_t rpmfiFNlink(rpmfi fi);
/** \ingroup rpmfi
* Return (calculated) current file nlink count from file info set iterator.
* @param fi file info set iterator
* @param files returns array of file ids hardlinked including ix,
NULL for nlink count == 1
* @return current file nlink count, 0 on invalid
*/
uint32_t rpmfiFLinks(rpmfi fi, const int ** files);
/** \ingroup rpmfi
* Return current file modify time from file info set iterator.
* @param fi file info set iterator
* @return current file modify time, 0 on invalid
*/
rpm_time_t rpmfiFMtime(rpmfi fi);
/** \ingroup rpmfi
* Return current file owner from file info set iterator.
* @param fi file info set iterator
* @return current file owner, NULL on invalid
*/
const char * rpmfiFUser(rpmfi fi);
/** \ingroup rpmfi
* Return current file group from file info set iterator.
* @param fi file info set iterator
* @return current file group, NULL on invalid
*/
const char * rpmfiFGroup(rpmfi fi);
/** \ingroup rpmfi
* Return textual representation of current file capabilities
* from file info set iterator. See cap_from_text(3) for details.
* @param fi file info set iterator
* @return file capability description, "" for no capabilities
* and NULL on invalid
*/
const char * rpmfiFCaps(rpmfi fi);
/** \ingroup rpmfi
* Return current file language(s) from file info set iterator.
* @param fi file info set iterator
* @return current file language(s), NULL on invalid
*/
const char * rpmfiFLangs(rpmfi fi);
/** \ingroup rpmfi
* Map file stat(2) info.
* @param fi file info iterator
* @param flags flags
* @retval sb mapped stat(2) data
*/
int rpmfiStat(rpmfi fi, int flags, struct stat *sb);
/** \ingroup rpmfi
* Return next file iterator index.
* @param fi file info set iterator
* @return file iterator index, -1 on termination
*/
int rpmfiNext(rpmfi fi);
/** \ingroup rpmfi
* Initialize file iterator index.
* @param fi file info set iterator
* @param fx file iterator index
* @return file info set iterator
*/
rpmfi rpmfiInit(rpmfi fi, int fx);
/** \ingroup rpmfi
* Return next directory iterator index.
* @param fi file info set iterator
* @return directory iterator index, -1 on termination
*/
int rpmfiNextD(rpmfi fi);
/** \ingroup rpmfi
* Initialize directory iterator index.
* @param fi file info set iterator
* @param dx directory iterator index
* @return file info set iterator, NULL if dx is out of range
*/
rpmfi rpmfiInitD(rpmfi fi, int dx);
/** \ingroup rpmfi
* Destroy a file info set iterator.
* @param fi file info set iterator
* @return NULL always
*/
rpmfi rpmfiFree(rpmfi fi);
/** \ingroup rpmfi
* Create and load a file info set iterator.
* @param pool shared string pool (or NULL for private pool)
* @param h header
* @param tagN unused
* @param flags Flags to control what information is loaded.
* @return new file info set iterator
*/
rpmfi rpmfiNewPool(rpmstrPool pool, Header h, rpmTagVal tagN, rpmfiFlags flags);
/** \ingroup rpmfi
* Create and load a file info set iterator.
* @param ts unused
* @param h header
* @param tagN unused
* @param flags Flags to control what information is loaded.
* @return new file info set iterator
*/
rpmfi rpmfiNew(const rpmts ts, Header h, rpmTagVal tagN, rpmfiFlags flags);
/** \ingroup rpmfi
* Return file type from mode_t.
* @param mode file mode bits (from header)
* @return file type
*/
rpmFileTypes rpmfiWhatis(rpm_mode_t mode);
/** \ingroup rpmfi
* Return file info comparison.
* @param afi 1st file info
* @param bfi 2nd file info
* @return 0 if identical
*/
int rpmfiCompare(const rpmfi afi, const rpmfi bfi);
/** \ingroup rpmfi
* Verify file attributes (including digest).
* @param fi file info iterator
* @param omitMask bit(s) to disable verify checks
* @return bit(s) to indicate failure (ie 0 for passed verify)
*/
rpmVerifyAttrs rpmfiVerify(rpmfi fi, rpmVerifyAttrs omitMask);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMDS */
PK vFZ��U]�? �? rpmds.hnu �[��� #ifndef H_RPMDS
#define H_RPMDS
/** \ingroup rpmdep rpmtrans
* \file lib/rpmds.h
* Structure(s) used for dependency tag sets.
*/
#include <time.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmps.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
*/
extern int _rpmds_nopromote;
/** \ingroup rpmds
* Dependency Attributes.
*/
enum rpmsenseFlags_e {
RPMSENSE_ANY = 0,
RPMSENSE_LESS = (1 << 1),
RPMSENSE_GREATER = (1 << 2),
RPMSENSE_EQUAL = (1 << 3),
/* bit 4 unused */
RPMSENSE_POSTTRANS = (1 << 5), /*!< %posttrans dependency */
RPMSENSE_PREREQ = (1 << 6), /* legacy prereq dependency */
RPMSENSE_PRETRANS = (1 << 7), /*!< Pre-transaction dependency. */
RPMSENSE_INTERP = (1 << 8), /*!< Interpreter used by scriptlet. */
RPMSENSE_SCRIPT_PRE = (1 << 9), /*!< %pre dependency. */
RPMSENSE_SCRIPT_POST = (1 << 10), /*!< %post dependency. */
RPMSENSE_SCRIPT_PREUN = (1 << 11), /*!< %preun dependency. */
RPMSENSE_SCRIPT_POSTUN = (1 << 12), /*!< %postun dependency. */
RPMSENSE_SCRIPT_VERIFY = (1 << 13), /*!< %verify dependency. */
RPMSENSE_FIND_REQUIRES = (1 << 14), /*!< find-requires generated dependency. */
RPMSENSE_FIND_PROVIDES = (1 << 15), /*!< find-provides generated dependency. */
RPMSENSE_TRIGGERIN = (1 << 16), /*!< %triggerin dependency. */
RPMSENSE_TRIGGERUN = (1 << 17), /*!< %triggerun dependency. */
RPMSENSE_TRIGGERPOSTUN = (1 << 18), /*!< %triggerpostun dependency. */
RPMSENSE_MISSINGOK = (1 << 19), /*!< suggests/enhances hint. */
/* bits 20-23 unused */
RPMSENSE_RPMLIB = (1 << 24), /*!< rpmlib(feature) dependency. */
RPMSENSE_TRIGGERPREIN = (1 << 25), /*!< %triggerprein dependency. */
RPMSENSE_KEYRING = (1 << 26),
/* bit 27 unused */
RPMSENSE_CONFIG = (1 << 28)
};
typedef rpmFlags rpmsenseFlags;
#define RPMSENSE_SENSEMASK 15 /* Mask to get senses, ie serial, */
/* less, greater, equal. */
#define RPMSENSE_TRIGGER \
(RPMSENSE_TRIGGERPREIN | RPMSENSE_TRIGGERIN | RPMSENSE_TRIGGERUN | RPMSENSE_TRIGGERPOSTUN)
#define _ALL_REQUIRES_MASK (\
RPMSENSE_INTERP | \
RPMSENSE_SCRIPT_PRE | \
RPMSENSE_SCRIPT_POST | \
RPMSENSE_SCRIPT_PREUN | \
RPMSENSE_SCRIPT_POSTUN | \
RPMSENSE_SCRIPT_VERIFY | \
RPMSENSE_FIND_REQUIRES | \
RPMSENSE_RPMLIB | \
RPMSENSE_KEYRING | \
RPMSENSE_PRETRANS | \
RPMSENSE_POSTTRANS | \
RPMSENSE_PREREQ | \
RPMSENSE_MISSINGOK)
#define _notpre(_x) ((_x) & ~RPMSENSE_PREREQ)
#define _INSTALL_ONLY_MASK \
_notpre(RPMSENSE_SCRIPT_PRE|RPMSENSE_SCRIPT_POST|RPMSENSE_RPMLIB|RPMSENSE_KEYRING|RPMSENSE_PRETRANS|RPMSENSE_POSTTRANS)
#define _ERASE_ONLY_MASK \
_notpre(RPMSENSE_SCRIPT_PREUN|RPMSENSE_SCRIPT_POSTUN)
#define _UNORDERED_ONLY_MASK \
_notpre(RPMSENSE_RPMLIB|RPMSENSE_CONFIG|RPMSENSE_PRETRANS|RPMSENSE_POSTTRANS|RPMSENSE_SCRIPT_VERIFY)
#define isLegacyPreReq(_x) (((_x) & _ALL_REQUIRES_MASK) == RPMSENSE_PREREQ)
#define isInstallPreReq(_x) ((_x) & _INSTALL_ONLY_MASK)
#define isErasePreReq(_x) ((_x) & _ERASE_ONLY_MASK)
#define isUnorderedReq(_x) ((_x) & _UNORDERED_ONLY_MASK)
/** \ingroup rpmds
* Return only those flags allowed for given type of dependencies
* @param tagN type of dependency
* @param Flags flags
* @return flags filtered to allowed bits
*/
rpmsenseFlags rpmSanitizeDSFlags(rpmTagVal tagN, rpmsenseFlags Flags);
/** \ingroup rpmds
* Convert a string to the sense flags
* @param str the string
* @param len length of the string
* @return flags, zero for unknown relations
*/
rpmsenseFlags rpmParseDSFlags(const char *str, size_t len);
/** \ingroup rpmds
* Reference a dependency set instance.
* @param ds dependency set
* @return new dependency set reference
*/
rpmds rpmdsLink(rpmds ds);
/** \ingroup rpmds
* Destroy a dependency set.
* @param ds dependency set
* @return NULL always
*/
rpmds rpmdsFree(rpmds ds);
/** \ingroup rpmds
* Create and load a dependency set.
* @param h header
* @param tagN type of dependency
* @param flags unused
* @return new dependency set
*/
rpmds rpmdsNew(Header h, rpmTagVal tagN, int flags);
/** \ingroup rpmds
* Return new formatted dependency string.
* @param dspfx formatted dependency string prefix
* @param ds dependency set
* @return new formatted dependency (malloc'ed)
*/
char * rpmdsNewDNEVR(const char * dspfx, const rpmds ds);
/** \ingroup rpmds
* Create, load and initialize a dependency for this header.
* @param h header
* @param tagN type of dependency
* @param Flags comparison flags
* @return new dependency set
*/
rpmds rpmdsThis(Header h, rpmTagVal tagN, rpmsenseFlags Flags);
/** \ingroup rpmds
* Create, load and initialize a dependency set of size 1.
* @param tagN type of dependency
* @param N name
* @param EVR epoch:version-release
* @param Flags comparison flags
* @return new dependency set
*/
rpmds rpmdsSingle(rpmTagVal tagN, const char * N, const char * EVR, rpmsenseFlags Flags);
/** \ingroup rpmds
* Return a new dependency set of size 1 from the current iteration index
* @param ds dependency set
* @return new dependency set
*/
rpmds rpmdsCurrent(rpmds ds);
/** \ingroup rpmds
* Write content of the dependency set to the header
* @param ds dependency set
* @param h header
* @return 0 on success
*/
int rpmdsPutToHeader(rpmds ds, Header h);
/** \ingroup rpmds
* Return dependency set count.
* @param ds dependency set
* @return current count
*/
int rpmdsCount(const rpmds ds);
/** \ingroup rpmds
* Return dependency set index.
* @param ds dependency set
* @return current index
*/
int rpmdsIx(const rpmds ds);
/** \ingroup rpmds
* Set dependency set index.
* @param ds dependency set
* @param ix new index
* @return current index
*/
int rpmdsSetIx(rpmds ds, int ix);
/** \ingroup rpmds
* Return current formatted dependency string.
* @param ds dependency set
* @return current dependency DNEVR, NULL on invalid
*/
const char * rpmdsDNEVR(const rpmds ds);
/** \ingroup rpmds
* Return one char indicating the type of the dependency.
* @param ds dependency set
* @return character
*/
char rpmdsD(const rpmds ds);
/** \ingroup rpmds
* Return matching tagN for one char dependency type description.
* @param deptype character
* @return type of dependency
*/
rpmTagVal rpmdsDToTagN(char deptype);
/** \ingroup rpmds
* Return current dependency name.
* @param ds dependency set
* @return current dependency name, NULL on invalid
*/
const char * rpmdsN(const rpmds ds);
/** \ingroup rpmds
* Return current dependency epoch-version-release.
* @param ds dependency set
* @return current dependency EVR, NULL on invalid
*/
const char * rpmdsEVR(const rpmds ds);
/** \ingroup rpmds
* Return current dependency triggerindex.
* @param ds dependency set
* @return current dependency trigger index, 0 on invalid
*/
int rpmdsTi(const rpmds ds);
/** \ingroup rpmds
* Return current dependency flags.
* @param ds dependency set
* @return current dependency flags, 0 on invalid
*/
rpmsenseFlags rpmdsFlags(const rpmds ds);
/** \ingroup rpmds
* Return current dependency type.
* @param ds dependency set
* @return current dependency type, 0 on invalid
*/
rpmTagVal rpmdsTagN(const rpmds ds);
/** \ingroup rpmds
* Return current dependency type.
* @param ds dependency set
* @return current dependency type version tag, 0 on invalid
*/
rpmTagVal rpmdsTagEVR(const rpmds ds);
/** \ingroup rpmds
* Return current dependency type.
* @param ds dependency set
* @return current dependency type flags tag, 0 on invalid
*/
rpmTagVal rpmdsTagF(const rpmds ds);
/** \ingroup rpmds
* Return current dependency type.
* @param ds dependency set
* @return current dependency type trigger index tag, 0 on invalid
*/
rpmTagVal rpmdsTagTi(const rpmds ds);
/** \ingroup rpmds
* Return dependency header instance, ie whether the dependency comes from
* an installed header or not.
* @param ds dependency set
* @return header instance of dependency (0 for not installed)
*/
unsigned int rpmdsInstance(rpmds ds);
/** \ingroup rpmds
* Return current "Don't promote Epoch:" flag.
*
* This flag controls for Epoch: promotion when a dependency set is
* compared. If the flag is set (for already installed packages), then
* an unspecified value will be treated as Epoch: 0. Otherwise (for added
* packages), the Epoch: portion of the comparison is skipped if the value
* is not specified, i.e. an unspecified Epoch: is assumed to be equal
* in dependency comparisons.
*
* @param ds dependency set
* @return current "Don't promote Epoch:" flag
*/
int rpmdsNoPromote(const rpmds ds);
/** \ingroup rpmds
* Set "Don't promote Epoch:" flag.
* @param ds dependency set
* @param nopromote Should an unspecified Epoch: be treated as Epoch: 0?
* @return previous "Don't promote Epoch:" flag
*/
int rpmdsSetNoPromote(rpmds ds, int nopromote);
/** \ingroup rpmds
* Return current dependency color.
* @param ds dependency set
* @return current dependency color
*/
rpm_color_t rpmdsColor(const rpmds ds);
/** \ingroup rpmds
* Return current dependency color.
* @param ds dependency set
* @param color new dependency color
* @return previous dependency color
*/
rpm_color_t rpmdsSetColor(const rpmds ds, rpm_color_t color);
/** \ingroup rpmds
* Return next dependency set iterator index.
* @param ds dependency set
* @return dependency set iterator index, -1 on termination
*/
int rpmdsNext(rpmds ds);
/** \ingroup rpmds
* Initialize dependency set iterator.
* @param ds dependency set
* @return dependency set
*/
rpmds rpmdsInit(rpmds ds);
/** \ingroup rpmds
* Find a dependency set element using binary search.
* @param ds dependency set to search
* @param ods dependency set element to find.
* @return dependency index (or -1 if not found)
*/
int rpmdsFind(rpmds ds, const rpmds ods);
/** \ingroup rpmds
* Merge a dependency set maintaining (N,EVR,Flags) sorted order.
* @retval *dsp (merged) dependency set
* @param ods dependency set to merge
* @return number of merged dependencies, -1 on error
*/
int rpmdsMerge(rpmds * dsp, rpmds ods);
/** \ingroup rpmds
* Search a sorted dependency set for an element that overlaps.
* A boolean result is saved (if allocated) and accessible through
* rpmdsResult(ods) afterwards.
* @param ds dependency set to search
* @param ods dependency set element to find.
* @return dependency index (or -1 if not found)
**/
int rpmdsSearch(rpmds ds, rpmds ods);
/** \ingroup rpmds
* Compare two versioned dependency ranges, looking for overlap.
* @param A 1st dependency
* @param B 2nd dependency
* @return 1 if dependencies overlap, 0 otherwise
*/
int rpmdsCompare(const rpmds A, const rpmds B);
/** \ingroup rpmds
* Compare package provides dependencies from header with a single dependency.
* @param h header
* @param req dependency set
* @param nopromote Don't promote Epoch: in comparison?
* @return 1 if any dependency overlaps, 0 otherwise
*/
int rpmdsAnyMatchesDep (const Header h, const rpmds req, int nopromote);
/** \ingroup rpmds
* Compare package provides dependencies from header with a single dependency.
* @param h header
* @param ix index in header provides
* @param req dependency set
* @param nopromote Don't promote Epoch: in comparison?
* @return 1 if any dependency overlaps, 0 otherwise
*/
int rpmdsMatchesDep (const Header h, int ix, const rpmds req, int nopromote);
/** \ingroup rpmds
* Compare package name-version-release from header with a single dependency.
* @param h header
* @param req dependency set
* @param nopromote Don't promote Epoch: in comparison?
* @return 1 if dependency overlaps, 0 otherwise
*/
int rpmdsNVRMatchesDep(const Header h, const rpmds req, int nopromote);
/**
* Load rpmlib provides into a dependency set.
* @retval *dsp (loaded) dependency set
* @param tblp rpmlib provides table (NULL uses internal table)
* @return 0 on success
*/
int rpmdsRpmlib(rpmds * dsp, const void * tblp);
/** \ingroup rpmds
* Create and load a dependency set.
* @param pool shared string pool (or NULL for private pool)
* @param h header
* @param tagN type of dependency
* @param flags unused
* @return new dependency set
*/
rpmds rpmdsNewPool(rpmstrPool pool, Header h, rpmTagVal tagN, int flags);
/** \ingroup rpmds
* Create, load and initialize a dependency for this header.
* @param pool string pool (or NULL for private pool)
* @param h header
* @param tagN type of dependency
* @param Flags comparison flags
* @return new dependency set
*/
rpmds rpmdsThisPool(rpmstrPool pool,
Header h, rpmTagVal tagN, rpmsenseFlags Flags);
/** \ingroup rpmds
* Create, load and initialize a dependency set of size 1.
* @param pool string pool (or NULL for private pool)
* @param tagN type of dependency
* @param N name
* @param EVR epoch:version-release
* @param Flags comparison flags
* @return new dependency set
*/
rpmds rpmdsSinglePool(rpmstrPool pool, rpmTagVal tagN,
const char * N, const char * EVR, rpmsenseFlags Flags);
/** \ingroup rpmds
* Create, load and initialize a trigger dependency set of size 1.
* @param pool string pool (or NULL for private pool)
* @param tagN type of dependency
* @param N name
* @param EVR epoch:version-release
* @param Flags comparison flags
* @param triggerIndex trigger index
* @return new dependency set
*/
rpmds rpmdsSinglePoolTix(rpmstrPool pool, rpmTagVal tagN,
const char * N, const char * EVR,
rpmsenseFlags Flags, int triggerIndex);
/**
* Load rpmlib provides into a dependency set.
* @param pool shared string pool (or NULL for private pool)
* @retval *dsp (loaded) dependency set
* @param tblp rpmlib provides table (NULL uses internal table)
* @return 0 on success
*/
int rpmdsRpmlibPool(rpmstrPool pool, rpmds * dsp, const void * tblp);
typedef enum rpmrichOp_e {
RPMRICHOP_SINGLE = 1,
RPMRICHOP_AND = 2,
RPMRICHOP_OR = 3,
RPMRICHOP_IF = 4,
RPMRICHOP_ELSE = 5,
RPMRICHOP_WITH = 6,
RPMRICHOP_WITHOUT = 7,
RPMRICHOP_UNLESS = 8
} rpmrichOp;
typedef enum rpmrichParseType_e {
RPMRICH_PARSE_SIMPLE = 1, /* standard N <=> EVR dep */
RPMRICH_PARSE_ENTER = 2, /* entering sub-dependency */
RPMRICH_PARSE_LEAVE = 3, /* leaving sub-dependency */
RPMRICH_PARSE_OP = 4 /* parsed a rich dependency op */
} rpmrichParseType;
typedef rpmRC (*rpmrichParseFunction) (void *cbdata, rpmrichParseType type,
const char *n, int nl, const char *e, int el, rpmsenseFlags sense,
rpmrichOp op, char **emsg);
/**
* Parse a rich dependency string
* @param dstrp pointer to sting, will be updated
* @param emsg returns the error string, can be NULL
* @param cb callback function
* @param cbdata callback function data
* @return RPMRC_OK on success
*/
rpmRC rpmrichParse(const char **dstrp, char **emsg, rpmrichParseFunction cb, void *cbdata);
/**
* Parse a rich dependency string for a specific tag
* @param dstrp pointer to sting, will be updated
* @param emsg returns the error string, can be NULL
* @param cb callback function
* @param cbdata callback function data
* @param tagN type of dependency
* @return RPMRC_OK on success
*/
rpmRC rpmrichParseForTag(const char **dstrp, char **emsg, rpmrichParseFunction cb, void *cbdata, rpmTagVal tagN);
/**
* Return if current depenency is rich
* @param dep the dependency
* @return 1 is dependency is a rich 0 otherwise
*/
int rpmdsIsRich(rpmds dep);
/**
* Return a string representation of the rich dependency op
* @param op the dependency op
* @return constant string, do not free
*/
const char *rpmrichOpStr(rpmrichOp op);
/**
* Parse a rich dependency string
* @param dep the dependency
* @param leftds returns the left dependency
* @param rightds returns the right dependency
* @param op returns the rich dep op
* @param emsg returns the error string
* @return RPMRC_OK on success
*/
rpmRC rpmdsParseRichDep(rpmds dep, rpmds *leftds, rpmds *rightds, rpmrichOp *op, char **emsg);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMDS */
PK vFZ � rpmkeyring.hnu �[��� #ifndef _RPMKEYRING_H
#define _RPMKEYRING_H
/** \ingroup rpmkeyring
* \file rpmio/rpmkeyring.h
*
* RPM keyring API
*/
#include <rpm/rpmtypes.h>
#include <rpm/rpmpgp.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmkeyring
* Create a new, empty keyring
* @return new keyring handle
*/
rpmKeyring rpmKeyringNew(void);
/** \ingroup rpmkeyring
* Free keyring and the keys within it
* @return NULL always
*/
rpmKeyring rpmKeyringFree(rpmKeyring keyring);
/** \ingroup rpmkeyring
* Add a public key to keyring.
* @param keyring keyring handle
* @param key pubkey handle
* @return 0 on success, -1 on error, 1 if key already present
*/
int rpmKeyringAddKey(rpmKeyring keyring, rpmPubkey key);
/** \ingroup rpmkeyring
* Perform keyring lookup for a key matching a signature
* @param keyring keyring handle
* @param sig OpenPGP packet container of signature
* @return RPMRC_OK if found, RPMRC_NOKEY otherwise
*/
rpmRC rpmKeyringLookup(rpmKeyring keyring, pgpDig sig);
/** \ingroup rpmkeyring
* Perform combined keyring lookup and signature verification
* @param keyring keyring handle
* @param sig OpenPGP signature parameters
* @param ctx signature hash context
* @return RPMRC_OK / RPMRC_FAIL / RPMRC_NOKEY
*/
rpmRC rpmKeyringVerifySig(rpmKeyring keyring, pgpDigParams sig, DIGEST_CTX ctx);
/** \ingroup rpmkeyring
* Reference a keyring.
* @param keyring keyring handle
* @return new keyring reference
*/
rpmKeyring rpmKeyringLink(rpmKeyring keyring);
/** \ingroup rpmkeyring
* Create a new rpmPubkey from OpenPGP packet
* @param pkt OpenPGP packet data
* @param pktlen Data length
* @return new pubkey handle
*/
rpmPubkey rpmPubkeyNew(const uint8_t *pkt, size_t pktlen);
/** \ingroup rpmkeyring
* Return array of subkeys belonging to maikey
* param mainkey main rpmPubkey
* param count count of returned subkeys
* @return an array of subkey's handles
*/
rpmPubkey *rpmGetSubkeys(rpmPubkey mainkey, int *count);
/** \ingroup rpmkeyring
* Create a new rpmPubkey from ASCII-armored pubkey file
* @param filename Path to pubkey file
* @return new pubkey handle
*/
rpmPubkey rpmPubkeyRead(const char *filename);
/** \ingroup rpmkeyring
* Free a pubkey.
* @param key Pubkey to free
* @return NULL always
*/
rpmPubkey rpmPubkeyFree(rpmPubkey key);
/** \ingroup rpmkeyring
* Reference a pubkey.
* @param key Pubkey
* @return new pubkey reference
*/
rpmPubkey rpmPubkeyLink(rpmPubkey key);
/** \ingroup rpmkeyring
* Parse OpenPGP pubkey parameters.
* @param key Pubkey
* @return parsed output of pubkey packet parameters
*/
pgpDig rpmPubkeyDig(rpmPubkey key);
/** \ingroup rpmkeyring
* Return base64 encoding of pubkey
* @param key Pubkey
* @return base64 encoded pubkey (malloced), NULL on error
*/
char * rpmPubkeyBase64(rpmPubkey key);
/** \ingroup rpmkeyring
* Return pgp params of key
* @param key Pubkey
* @return pgp params, NULL on error
*/
pgpDigParams rpmPubkeyPgpDigParams(rpmPubkey key);
#ifdef __cplusplus
}
#endif
#endif /* _RPMKEYDB_H */
PK vFZ�ϖ>� �
rpmfileutil.hnu �[��� #ifndef _RPMFILEUTIL_H
#define _RPMFILEUTIL_H
/** \ingroup rpmfileutil rpmio
* \file rpmio/rpmfileutil.h
* File and path manipulation helper functions.
*/
#include <rpm/rpmutil.h>
#include <rpm/rpmio.h>
#include <rpm/rpmpgp.h>
#include <rpm/argv.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmfileutil
*/
typedef enum rpmCompressedMagic_e {
COMPRESSED_NOT = 0, /*!< not compressed */
COMPRESSED_OTHER = 1, /*!< gzip can handle */
COMPRESSED_BZIP2 = 2, /*!< bzip2 can handle */
COMPRESSED_ZIP = 3, /*!< unzip can handle */
COMPRESSED_LZMA = 4, /*!< lzma can handle */
COMPRESSED_XZ = 5, /*!< xz can handle */
COMPRESSED_LZIP = 6, /*!< lzip can handle */
COMPRESSED_LRZIP = 7, /*!< lrzip can handle */
COMPRESSED_7ZIP = 8, /*!< 7zip can handle */
COMPRESSED_GEM = 9, /*!< gem can handle */
COMPRESSED_ZSTD = 10 /*!< zstd can handle */
} rpmCompressedMagic;
/** \ingroup rpmfileutil
* Calculate a file digest and size.
* @param algo digest algorithm
* @param fn file name
* @param asAscii return digest as ascii string?
* @retval digest address of calculated digest
* @retval *fsizep file size pointer (or NULL)
* @return 0 on success, 1 on error
*/
int rpmDoDigest(int algo, const char * fn,int asAscii,
unsigned char * digest, rpm_loff_t * fsizep);
/** \ingroup rpmfileutil
* Thin wrapper for mkstemp(3).
* @param templ template for temporary filename
* @return file handle or NULL on error
*/
FD_t rpmMkTemp(char *templ);
/** \ingroup rpmfileutil
* Return file handle for a temporaray file.
* A unique temporaray file path will be created in
* [prefix/]%{_tmppath} directory.
* The file name and the open file handle are returned.
*
* @param prefix leading part of temp file path
* @retval fn temp file name (or NULL)
* @return fdptr open file handle or NULL on error
*/
FD_t rpmMkTempFile(const char * prefix, char **fn);
/** \ingroup rpmfileutil
* Insure that directories in path exist, creating as needed.
* @param path directory path
* @param mode directory mode (if created)
* @param uid directory uid (if created), or -1 to skip
* @param gid directory uid (if created), or -1 to skip
* @return 0 on success, errno (or -1) on error
*/
int rpmioMkpath(const char * path, mode_t mode, uid_t uid, gid_t gid);
/** \ingroup rpmfileutil
* Create several directories (including parents if needed) in one go.
* Macros in pathstr will be expanded in the process.
* @param root leading root directory (or NULL for none)
* @param pathstr list of directories separated with :
* @return 0 if all directories were successfully created
* (or already existed), non-zero otherwise
*/
int rpmMkdirs(const char *root, const char *pathstr);
/** \ingroup rpmfileutil
* Canonicalize file path.
* @param path path to canonicalize (in-place)
* @return pointer to path
*/
char * rpmCleanPath (char * path);
/** \ingroup rpmfileutil
* Merge 3 args into path, any or all of which may be a url.
* The leading part of the first URL encountered is used
* for the result, other URL prefixes are discarded, permitting
* a primitive form of URL inheiritance.
* @param urlroot root URL (often path to chroot, or NULL)
* @param urlmdir directory URL (often a directory, or NULL)
* @param urlfile file URL (often a file, or NULL)
* @return expanded, merged, canonicalized path (malloc'ed)
*/
char * rpmGenPath (const char * urlroot,
const char * urlmdir,
const char * urlfile);
/** \ingroup rpmfileutil
* Return (malloc'ed) expanded, canonicalized, file path.
* @param path macro(s) to expand (NULL terminates list)
* @return canonicalized path (malloc'ed)
*/
char * rpmGetPath (const char * path, ...) RPM_GNUC_NULL_TERMINATED;
/** \ingroup rpmfileutil
* Check whether pattern contains any glob metacharacters.
* @param pattern glob pattern
* @param quote allow backslash quoting of metacharacters?
* @return 1 if pattern contains globs, 0 otherwise
*/
int rpmIsGlob(const char * pattern, int quote);
/** \ingroup rpmfileutil
* Return URL path(s) from a (URL prefixed) pattern glob.
* @param patterns glob pattern
* @retval *argcPtr no. of paths
* @retval *argvPtr ARGV_t array of paths
* @return 0 on success
*/
int rpmGlob(const char * patterns, int * argcPtr, ARGV_t * argvPtr);
/** \ingroup rpmfileutil
* Escape isspace(3) characters in string.
* @param s string
* @return escaped string
*/
char * rpmEscapeSpaces(const char * s);
/** \ingroup rpmfileutil
* Return type of compression used in file.
* @param file name of file
* @retval compressed address of compression type
* @return 0 on success, 1 on I/O error
*/
int rpmFileIsCompressed (const char * file, rpmCompressedMagic * compressed);
/** \ingroup rpmfileutil
* Check if path (string) ends with given suffix
* @param path (path) string
* @param suffix suffix string to check for
* @return 1 if true, 0 otherwise
*/
int rpmFileHasSuffix(const char *path, const char *suffix);
/** \ingroup rpmfileutil
* Like getcwd() but the result is malloced.
* @return current working directory (malloc'ed)
*/
char * rpmGetCwd(void);
#ifdef __cplusplus
}
#endif
#endif /* _RPMFILEUTIL_H */
PK vFZ껗�� � rpmstring.hnu �[��� #ifndef _RPMSTRING_H_
#define _RPMSTRING_H_
/** \ingroup rpmstring
* \file rpmio/rpmstring.h
* String manipulation helper functions
*/
#include <stddef.h>
#include <string.h>
#include <stdarg.h>
#include <rpm/rpmutil.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmstring
* Locale insensitive islower(3)
*/
RPM_GNUC_CONST
static inline int rislower(int c) {
return (c >= 'a' && c <= 'z');
}
/** \ingroup rpmstring
* Locale insensitive isupper(3)
*/
RPM_GNUC_CONST
static inline int risupper(int c) {
return (c >= 'A' && c <= 'Z');
}
/** \ingroup rpmstring
* Locale insensitive isalpha(3)
*/
RPM_GNUC_CONST
static inline int risalpha(int c) {
return (rislower(c) || risupper(c));
}
/** \ingroup rpmstring
* Locale insensitive isdigit(3)
*/
RPM_GNUC_CONST
static inline int risdigit(int c) {
return (c >= '0' && c <= '9');
}
/** \ingroup rpmstring
* Locale insensitive isalnum(3)
*/
RPM_GNUC_CONST
static inline int risalnum(int c) {
return (risalpha(c) || risdigit(c));
}
/** \ingroup rpmstring
* Locale insensitive isblank(3)
*/
RPM_GNUC_CONST
static inline int risblank(int c) {
return (c == ' ' || c == '\t');
}
/** \ingroup rpmstring
* Locale insensitive isspace(3)
*/
RPM_GNUC_CONST
static inline int risspace(int c) {
return (risblank(c) || c == '\n' || c == '\r' || c == '\f' || c == '\v');
}
/** \ingroup rpmstring
* Locale insensitive tolower(3)
*/
RPM_GNUC_CONST
static inline int rtolower(int c) {
return ((risupper(c)) ? (c | ('a' - 'A')) : c);
}
/** \ingroup rpmstring
* Locale insensitive toupper(3)
*/
RPM_GNUC_CONST
static inline int rtoupper(int c) {
return ((rislower(c)) ? (c & ~('a' - 'A')) : c);
}
/**
* Convert hex to binary nibble.
* @param c hex character
* @return binary nibble
*/
RPM_GNUC_CONST
static inline unsigned char rnibble(char c)
{
if (c >= '0' && c <= '9')
return (c - '0');
if (c >= 'a' && c <= 'f')
return (c - 'a') + 10;
if (c >= 'A' && c <= 'F')
return (c - 'A') + 10;
return 0;
}
/**
* Test for string equality
* @param s1 string 1
* @param s2 string 2
* @return 0 if strings differ, 1 if equal
*/
static inline int rstreq(const char *s1, const char *s2)
{
return (strcmp(s1, s2) == 0);
}
/**
* Test for string equality
* @param s1 string 1
* @param s2 string 2
* @param n compare at most n characters
* @return 0 if strings differ, 1 if equal
*/
static inline int rstreqn(const char *s1, const char *s2, size_t n)
{
return (strncmp(s1, s2, n) == 0);
}
/** \ingroup rpmstring
* Locale insensitive strcasecmp(3).
*/
RPM_GNUC_PURE
int rstrcasecmp(const char * s1, const char * s2) ;
/** \ingroup rpmstring
* Locale insensitive strncasecmp(3).
*/
RPM_GNUC_PURE
int rstrncasecmp(const char *s1, const char * s2, size_t n) ;
/** \ingroup rpmstring
* asprintf() clone
*/
int rasprintf(char **strp, const char *fmt, ...) RPM_GNUC_PRINTF(2, 3);
/** \ingroup rpmstring
* vasprintf() clone
*/
int rvasprintf(char **strp, const char *fmt, va_list ap);
/** \ingroup rpmstring
* Concatenate two strings with dynamically (re)allocated memory.
* @param dest pointer to destination string
* @param src source string
* @return realloc'd dest with src appended
*/
char *rstrcat(char **dest, const char *src);
/** \ingroup rpmstring
* Concatenate multiple strings with dynamically (re)allocated memory.
* @param dest pointer to destination string
* @param arg NULL terminated list of strings to concatenate
* @return realloc'd dest with strings appended
*/
char *rstrscat(char **dest, const char *arg, ...) RPM_GNUC_NULL_TERMINATED;
/** \ingroup rpmstring
* strlcpy() clone:
* Copy src to string dest of size n. At most n-1 characters
* will be copied. Always zero-terminates (unless n == 0).
* Length of src is returned; if retval >= n, truncation occurred.
* @param dest destination buffer
* @param src string to copy
* @param n destination buffer size
* @return length of src string
*/
size_t rstrlcpy(char *dest, const char *src, size_t n);
/** \ingroup rpmstring
* String hashing function
* @param string string to hash
* @return hash id
*/
RPM_GNUC_PURE
unsigned int rstrhash(const char * string);
#ifdef __cplusplus
}
#endif
#endif /* _RPMSTRING_H_ */
PK vFZΤ1�* * rpmprob.hnu �[��� #ifndef _RPMPROB_H
#define _RPMPROB_H
/** \ingroup rpmprob
* \file lib/rpmprob.h
* Structures and prototypes used for an rpm problem item.
*/
#include <stdio.h>
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef struct rpmProblem_s * rpmProblem;
/** \ingroup rpmprob
* @todo Generalize filter mechanism.
*/
enum rpmprobFilterFlags_e {
RPMPROB_FILTER_NONE = 0,
RPMPROB_FILTER_IGNOREOS = (1 << 0), /*!< from --ignoreos */
RPMPROB_FILTER_IGNOREARCH = (1 << 1), /*!< from --ignorearch */
RPMPROB_FILTER_REPLACEPKG = (1 << 2), /*!< from --replacepkgs */
RPMPROB_FILTER_FORCERELOCATE= (1 << 3), /*!< from --badreloc */
RPMPROB_FILTER_REPLACENEWFILES= (1 << 4), /*!< from --replacefiles */
RPMPROB_FILTER_REPLACEOLDFILES= (1 << 5), /*!< from --replacefiles */
RPMPROB_FILTER_OLDPACKAGE = (1 << 6), /*!< from --oldpackage */
RPMPROB_FILTER_DISKSPACE = (1 << 7), /*!< from --ignoresize */
RPMPROB_FILTER_DISKNODES = (1 << 8), /*!< from --ignoresize */
RPMPROB_FILTER_VERIFY = (1 << 9), /*!< from --noverify */
};
typedef rpmFlags rpmprobFilterFlags;
/** \ingroup rpmprob
* Enumerate transaction set problem types.
*/
typedef enum rpmProblemType_e {
RPMPROB_BADARCH, /*!< package ... is for a different architecture */
RPMPROB_BADOS, /*!< package ... is for a different operating system */
RPMPROB_PKG_INSTALLED, /*!< package ... is already installed */
RPMPROB_BADRELOCATE,/*!< path ... is not relocatable for package ... */
RPMPROB_REQUIRES, /*!< package ... has unsatisfied Requires: ... */
RPMPROB_CONFLICT, /*!< package ... has unsatisfied Conflicts: ... */
RPMPROB_NEW_FILE_CONFLICT, /*!< file ... conflicts between attempted installs of ... */
RPMPROB_FILE_CONFLICT,/*!< file ... from install of ... conflicts with file from package ... */
RPMPROB_OLDPACKAGE, /*!< package ... (which is newer than ...) is already installed */
RPMPROB_DISKSPACE, /*!< installing package ... needs ... on the ... filesystem */
RPMPROB_DISKNODES, /*!< installing package ... needs ... on the ... filesystem */
RPMPROB_OBSOLETES, /*!< package ... is obsoleted by ... */
RPMPROB_VERIFY, /*!< package did not pass verification */
} rpmProblemType;
/** \ingroup rpmprob
* Create a problem item.
* @param type type of problem
* @param pkgNEVR package name
* @param key filename or python object address
* @param altNEVR related (e.g. through a dependency) package name
* @param str generic string attribute
* @param number generic number attribute
* @return rpmProblem
*/
rpmProblem rpmProblemCreate(rpmProblemType type,
const char * pkgNEVR, fnpyKey key,
const char * altNEVR,
const char * str, uint64_t number);
/** \ingroup rpmprob
* Destroy a problem item.
* @param prob rpm problem
* @return rpm problem (NULL)
*/
rpmProblem rpmProblemFree(rpmProblem prob);
/** \ingroup rpmprob
* Reference an rpmProblem instance
* @param prob rpm problem
* @return rpm problem
*/
rpmProblem rpmProblemLink(rpmProblem prob);
/** \ingroup rpmprob
* Compare two problems for equality.
* @param ap 1st problem
* @param bp 2nd problem
* @return 1 if the problems differ, 0 otherwise
*/
int rpmProblemCompare(rpmProblem ap, rpmProblem bp);
/** \ingroup rpmprob
* Return package NEVR
* @param prob rpm problem
* @return package NEVR
*/
const char * rpmProblemGetPkgNEVR(rpmProblem prob);
/** \ingroup rpmprob
* Return related (e.g. through a dependency) package NEVR
* @param prob rpm problem
* @return related (e.g. through a dependency) package NEVR
*/
const char * rpmProblemGetAltNEVR(rpmProblem prob);
/** \ingroup rpmprob
* Return type of problem (dependency, diskpace etc)
* @param prob rpm problem
* @return type of problem
*/
rpmProblemType rpmProblemGetType(rpmProblem prob);
/** \ingroup rpmprob
* Return filename or python object address of a problem
* @param prob rpm problem
* @return filename or python object address
*/
fnpyKey rpmProblemGetKey(rpmProblem prob);
/** \ingroup rpmprob
* Return a generic data string from a problem
* @param prob rpm problem
* @return a generic data string
* @todo needs a better name
*/
const char * rpmProblemGetStr(rpmProblem prob);
/** \ingroup rpmprob
* Return disk requirement (needed disk space / number of inodes)
* depending on problem type. On problem types other than RPMPROB_DISKSPACE
* and RPMPROB_DISKNODES return value is undefined.
* @param prob rpm problem
* @return disk requirement
*/
rpm_loff_t rpmProblemGetDiskNeed(rpmProblem prob);
/** \ingroup rpmprob
* Return formatted string representation of a problem.
* @param prob rpm problem
* @return formatted string (malloc'd)
*/
char * rpmProblemString(rpmProblem prob);
#ifdef __cplusplus
}
#endif
#endif /* _RPMPROB_H */
PK vFZ8/ �� � rpmte.hnu �[��� #ifndef H_RPMTE
#define H_RPMTE
/** \ingroup rpmts rpmte
* \file lib/rpmte.h
* Structures used for an "rpmte" transaction element.
*/
#include <rpm/rpmtypes.h>
#include <rpm/argv.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmte
* Transaction element type.
*/
typedef enum rpmElementType_e {
TR_ADDED = (1 << 0), /*!< Package will be installed. */
TR_REMOVED = (1 << 1) /*!< Package will be removed. */
} rpmElementType;
typedef rpmFlags rpmElementTypes;
/** \ingroup rpmte
* Retrieve header from transaction element.
* @param te transaction element
* @return header (new reference)
*/
Header rpmteHeader(rpmte te);
/** \ingroup rpmte
* Save header into transaction element.
* @param te transaction element
* @param h header
* @return NULL always
*/
Header rpmteSetHeader(rpmte te, Header h);
/** \ingroup rpmte
* Retrieve type of transaction element.
* @param te transaction element
* @return type
*/
rpmElementType rpmteType(rpmte te);
/** \ingroup rpmte
* Retrieve name string of transaction element.
* @param te transaction element
* @return name string
*/
const char * rpmteN(rpmte te);
/** \ingroup rpmte
* Retrieve epoch string of transaction element.
* @param te transaction element
* @return epoch string
*/
const char * rpmteE(rpmte te);
/** \ingroup rpmte
* Retrieve version string of transaction element.
* @param te transaction element
* @return version string
*/
const char * rpmteV(rpmte te);
/** \ingroup rpmte
* Retrieve release string of transaction element.
* @param te transaction element
* @return release string
*/
const char * rpmteR(rpmte te);
/** \ingroup rpmte
* Retrieve arch string of transaction element.
* @param te transaction element
* @return arch string
*/
const char * rpmteA(rpmte te);
/** \ingroup rpmte
* Retrieve os string of transaction element.
* @param te transaction element
* @return os string
*/
const char * rpmteO(rpmte te);
/** \ingroup rpmte
* Retrieve isSource attribute of transaction element.
* @param te transaction element
* @return isSource attribute
*/
int rpmteIsSource(rpmte te);
/** \ingroup rpmte
* Retrieve color bits of transaction element.
* @param te transaction element
* @return color bits
*/
rpm_color_t rpmteColor(rpmte te);
/** \ingroup rpmte
* Set color bits of transaction element.
* @param te transaction element
* @param color new color bits
* @return previous color bits
*/
rpm_color_t rpmteSetColor(rpmte te, rpm_color_t color);
/** \ingroup rpmte
* Retrieve last instance installed to the database.
* @param te transaction element
* @return last install instance.
*/
unsigned int rpmteDBInstance(rpmte te);
/** \ingroup rpmte
* Set last instance installed to the database.
* @param te transaction element
* @param instance Database instance of last install element.
* @return last install instance.
*/
void rpmteSetDBInstance(rpmte te, unsigned int instance);
/** \ingroup rpmte
* Retrieve size in bytes of package file.
* @todo Signature header is estimated at 256b.
* @param te transaction element
* @return size in bytes of package file.
*/
rpm_loff_t rpmtePkgFileSize(rpmte te);
/** \ingroup rpmte
* Retrieve parent transaction element.
* @param te transaction element
* @return parent transaction element
*/
rpmte rpmteParent(rpmte te);
/** \ingroup rpmte
* Set parent transaction element.
* @param te transaction element
* @param pte new parent transaction element
* @return previous parent transaction element
*/
rpmte rpmteSetParent(rpmte te, rpmte pte);
/** \ingroup rpmte
* Return problem set info of transaction element.
* @param te transaction element
* @return problem set (or NULL if none)
*/
rpmps rpmteProblems(rpmte te);
/** \ingroup rpmte
* Destroy problem set info of transaction element.
* @param te transaction element
*/
void rpmteCleanProblems(rpmte te);
/** \ingroup rpmte
* Destroy dependency set info of transaction element.
* @param te transaction element
*/
void rpmteCleanDS(rpmte te);
/** \ingroup rpmte
* Set dependent element of TR_REMOVED transaction element.
* @param te transaction element
* @param depends dependent transaction element
*/
void rpmteSetDependsOn(rpmte te, rpmte depends);
/** \ingroup rpmte
* Retrieve dependent element of TR_REMOVED transaction element.
* @param te transaction element
* @return dependent transaction element
*/
rpmte rpmteDependsOn(rpmte te);
/** \ingroup rpmte
* Retrieve rpmdb instance of TR_REMOVED transaction element.
* @param te transaction element
* @return rpmdb instance
*/
int rpmteDBOffset(rpmte te);
/** \ingroup rpmte
* Retrieve [epoch:]version-release string from transaction element.
* @param te transaction element
* @return [epoch:]version-release string
*/
const char * rpmteEVR(rpmte te);
/** \ingroup rpmte
* Retrieve name-[epoch:]version-release string from transaction element.
* @param te transaction element
* @return name-[epoch:]version-release string
*/
const char * rpmteNEVR(rpmte te);
/** \ingroup rpmte
* Retrieve name-[epoch:]version-release.arch string from transaction element.
* @param te transaction element
* @return name-[epoch:]version-release.arch string
*/
const char * rpmteNEVRA(rpmte te);
/** \ingroup rpmte
* Retrieve key from transaction element.
* @param te transaction element
* @return key
*/
fnpyKey rpmteKey(rpmte te);
/** \ingroup rpmte
* Return failure status of transaction element.
* If the element itself failed, this is 1, larger count means one of
* it's parents failed.
* @param te transaction element
* @return number of failures for this transaction element
*/
int rpmteFailed(rpmte te);
/** \ingroup rpmte
* Retrieve dependency tag set from transaction element.
* @param te transaction element
* @param tag dependency tag
* @return dependency tag set
*/
rpmds rpmteDS(rpmte te, rpmTagVal tag);
/** \ingroup rpmte
* Retrieve file info set from transaction element.
* @param te transaction element
* @return file info set (refcounted)
*/
rpmfiles rpmteFiles(rpmte te);
/** \ingroup rpmte
* Retrieve file info iterator from transaction element.
* @deprecated use rpmteFiles() instead
* @param te transaction element
* @return file info tag set
*/
rpmfi rpmteFI(rpmte te);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMTE */
PK vFZ�Ț�3 3 rpmtd.hnu �[��� #ifndef _RPMTD_H
#define _RPMTD_H
/** \ingroup rpmtd
* \file lib/rpmtd.h
*
* RPM Tag Data Container API
*/
#include <rpm/rpmtypes.h>
#include <rpm/argv.h>
#ifdef __cplusplus
extern "C" {
#endif
enum rpmtdFlags_e {
RPMTD_NONE = 0,
RPMTD_ALLOCED = (1 << 0), /* was memory allocated? */
RPMTD_PTR_ALLOCED = (1 << 1), /* were array pointers allocated? */
RPMTD_IMMUTABLE = (1 << 2), /* header data or modifiable? */
RPMTD_ARGV = (1 << 3), /* string array is NULL-terminated? */
RPMTD_INVALID = (1 << 4), /* invalid data (in header) */
};
typedef rpmFlags rpmtdFlags;
/** \ingroup rpmtd
* Container for rpm tag data (from headers or extensions).
* @todo Make this opaque (at least outside rpm itself)
*/
struct rpmtd_s {
rpm_tag_t tag; /* rpm tag of this data entry*/
rpm_tagtype_t type; /* data type */
rpm_count_t count; /* number of entries */
rpm_data_t data; /* pointer to actual data */
rpmtdFlags flags; /* flags on memory allocation etc */
int ix; /* iteration index */
rpm_count_t size; /* size of data (only works for RPMTD_IMMUTABLE atm) */
};
/** \ingroup rpmtd
* Create new tag data container
* @return New, initialized tag data container.
*/
rpmtd rpmtdNew(void);
/** \ingroup rpmtd
* Destroy tag data container.
* @param td Tag data container
* @return NULL always
*/
rpmtd rpmtdFree(rpmtd td);
/** \ingroup rpmtd
* (Re-)initialize tag data container. Contents will be zeroed out
* and iteration index reset.
* @param td Tag data container
*/
void rpmtdReset(rpmtd td);
/** \ingroup rpmtd
* Free contained data. This is always safe to call as the container knows
* if data was malloc'ed or not. Container is reinitialized.
* @param td Tag data container
*/
void rpmtdFreeData(rpmtd td);
/** \ingroup rpmtd
* Retrieve array size of the container. For non-array types this is always 1.
* @param td Tag data container
* @return Number of entries in contained data.
*/
rpm_count_t rpmtdCount(rpmtd td);
/** \ingroup rpmtd
* Retrieve container data size (eg required for allocation).
* Note this currently only works for RPMTD_IMMUTABLE data.
* @param td Tag data container
* @return Data size in bytes.
*/
rpm_count_t rpmtdSize(rpmtd td);
/** \ingroup rpmtd
* Retrieve tag of the container.
* @param td Tag data container
* @return Rpm tag.
*/
rpmTagVal rpmtdTag(rpmtd td);
/** \ingroup rpmtd
* Retrieve type of the container.
* @param td Tag data container
* @return Rpm tag type.
*/
rpmTagType rpmtdType(rpmtd td);
/** \ingroup rpmtd
* Retrieve class of the container.
* @param td Tag data container
* @return Rpm tag class
*/
rpmTagClass rpmtdClass(rpmtd td);
/** \ingroup rpmtd
* Retrieve flags of the container (allocation details etc)
* @param td Tag data container
* @return Container flags
*/
rpmtdFlags rpmtdGetFlags(rpmtd td);
/** \ingroup rpmtd
* Retrieve current iteration index of the container.
* @param td Tag data container
* @return Iteration index (or -1 if not iterating)
*/
int rpmtdGetIndex(rpmtd td);
/** \ingroup rpmtd
* Set iteration index of the container.
* If new index is out of bounds for the container, -1 is returned and
* iteration index is left untouched.
* @param td Tag data container
* @param index New index
* @return New index, or -1 if index out of bounds
*/
int rpmtdSetIndex(rpmtd td, int index);
/** \ingroup rpmtd
* Initialize tag container for iteration
* @param td Tag data container
* @return 0 on success
*/
int rpmtdInit(rpmtd td);
/** \ingroup rpmtd
* Iterate over tag data container.
* @param td Tag data container
* @return Tag data container iterator index, -1 on termination
*/
int rpmtdNext(rpmtd td);
/** \ingroup rpmtd
* Iterate over uint32_t type tag data container.
* @param td Tag data container
* @return Pointer to next value, NULL on termination or error
*/
uint32_t *rpmtdNextUint32(rpmtd td);
/** \ingroup rpmtd
* Iterate over uint64_t type tag data container.
* @param td Tag data container
* @return Pointer to next value, NULL on termination or error
*/
uint64_t *rpmtdNextUint64(rpmtd td);
/** \ingroup rpmtd
* Iterate over string / string array type tag data container.
* @param td Tag data container
* @return Pointer to next value, NULL on termination or error
*/
const char *rpmtdNextString(rpmtd td);
/** \ingroup rpmtd
* Return char data from tag container.
* For scalar return type, just return pointer to the integer. On array
* types, return pointer to current iteration index. If the tag container
* is not for char type, NULL is returned.
* @param td Tag data container
* @return Pointer to uint16_t, NULL on error
*/
char *rpmtdGetChar(rpmtd td);
/** \ingroup rpmtd
* Return uint16_t data from tag container.
* For scalar return type, just return pointer to the integer. On array
* types, return pointer to current iteration index. If the tag container
* is not for int16 type, NULL is returned.
* @param td Tag data container
* @return Pointer to uint16_t, NULL on error
*/
uint16_t * rpmtdGetUint16(rpmtd td);
/** \ingroup rpmtd
* Return uint32_t data from tag container.
* For scalar return type, just return pointer to the integer. On array
* types, return pointer to current iteration index. If the tag container
* is not for int32 type, NULL is returned.
* @param td Tag data container
* @return Pointer to uint32_t, NULL on error
*/
uint32_t * rpmtdGetUint32(rpmtd td);
/** \ingroup rpmtd
* Return uint64_t data from tag container.
* For scalar return type, just return pointer to the integer. On array
* types, return pointer to current iteration index. If the tag container
* is not for int64 type, NULL is returned.
* @param td Tag data container
* @return Pointer to uint64_t, NULL on error
*/
uint64_t * rpmtdGetUint64(rpmtd td);
/** \ingroup rpmtd
* Return string data from tag container.
* For string types, just return the string. On string array types,
* return the string from current iteration index. If the tag container
* is not for a string type, NULL is returned.
* @param td Tag data container
* @return String constant from container, NULL on error
*/
const char * rpmtdGetString(rpmtd td);
/** \ingroup rpmtd
* Return numeric value from tag container.
* Returns the value of numeric container (RPM_NUMERIC_CLASS) from
* current iteration index as uint64_t regardless of its internal
* presentation (8/16/32/64-bit integer).
* @param td Tag data container
* @return Value of current iteration item as uint64_t,
* 0 for non-numeric types (error)
*/
uint64_t rpmtdGetNumber(rpmtd td);
typedef enum rpmtdFormats_e {
RPMTD_FORMAT_STRING = 0, /* plain string (any type) */
RPMTD_FORMAT_ARMOR = 1, /* ascii armor format (bin types) */
RPMTD_FORMAT_BASE64 = 2, /* base64 encoding (bin types) */
RPMTD_FORMAT_PGPSIG = 3, /* pgp/gpg signature (bin types) */
RPMTD_FORMAT_DEPFLAGS = 4, /* dependency flags (int types) */
RPMTD_FORMAT_FFLAGS = 5, /* file flags (int types) */
RPMTD_FORMAT_PERMS = 6, /* permission string (int types) */
RPMTD_FORMAT_TRIGGERTYPE = 7, /* trigger types (int types) */
RPMTD_FORMAT_XML = 8, /* xml format (any type) */
RPMTD_FORMAT_OCTAL = 9, /* octal format (int types) */
RPMTD_FORMAT_HEX = 10, /* hex format (int types) */
RPMTD_FORMAT_DATE = 11, /* date format (int types) */
RPMTD_FORMAT_DAY = 12, /* day format (int types) */
RPMTD_FORMAT_SHESCAPE = 13, /* shell escaped (any type) */
RPMTD_FORMAT_ARRAYSIZE = 14, /* size of contained array (any type) */
RPMTD_FORMAT_DEPTYPE = 15, /* dependency types (int types) */
RPMTD_FORMAT_FSTATE = 16, /* file states (int types) */
RPMTD_FORMAT_VFLAGS = 17, /* file verify flags (int types) */
RPMTD_FORMAT_EXPAND = 18, /* macro expansion (string types) */
RPMTD_FORMAT_FSTATUS = 19, /* file verify status (int types) */
RPMTD_FORMAT_HUMANSI = 20, /* human readable value, K = 1000 (int types) */
RPMTD_FORMAT_HUMANIEC = 21, /* human readable value, K = 1024 (int types) */
} rpmtdFormats;
/** \ingroup rpmtd
* Format data from tag container to string presentation of given format.
* Return malloced string presentation of current data in container,
* converting from integers etc as necessary. On array types, data from
* current iteration index is used for formatting.
* @param td Tag data container
* @param fmt Format to apply
* @param errmsg Error message from conversion (or NULL)
* @return String representation of current data (malloc'ed),
* NULL on error
*/
char *rpmtdFormat(rpmtd td, rpmtdFormats fmt, const char *errmsg);
/** \ingroup rpmtd
* Set container tag and type.
* For empty container, any valid tag can be set. If the container has
* data, changing is only permitted to tag of same type.
* @param td Tag data container
* @param tag New tag
* @return 1 on success, 0 on error
*/
int rpmtdSetTag(rpmtd td, rpmTagVal tag);
/** \ingroup rpmtd
* Construct tag container from uint8_t pointer.
* Tag type is checked to be of compatible type (CHAR, INT8 or BIN).
* For non-array types (BIN is a special case of INT8 array)
* count must be exactly 1.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param data Pointer to uint8_t (value or array)
* @param count Number of entries
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromUint8(rpmtd td, rpmTagVal tag, uint8_t *data, rpm_count_t count);
/** \ingroup rpmtd
* Construct tag container from uint16_t pointer.
* Tag type is checked to be of INT16 type. For non-array types count
* must be exactly 1.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param data Pointer to uint16_t (value or array)
* @param count Number of entries
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromUint16(rpmtd td, rpmTagVal tag, uint16_t *data, rpm_count_t count);
/** \ingroup rpmtd
* Construct tag container from uint32_t pointer.
* Tag type is checked to be of INT32 type. For non-array types count
* must be exactly 1.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param data Pointer to uint32_t (value or array)
* @param count Number of entries
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromUint32(rpmtd td, rpmTagVal tag, uint32_t *data, rpm_count_t count);
/** \ingroup rpmtd
* Construct tag container from uint64_t pointer.
* Tag type is checked to be of INT64 type. For non-array types count
* must be exactly 1.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param data Pointer to uint64_t (value or array)
* @param count Number of entries
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromUint64(rpmtd td, rpmTagVal tag, uint64_t *data, rpm_count_t count);
/** \ingroup rpmtd
* Construct tag container from a string.
* Tag type is checked to be of string type.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param data String to use
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromString(rpmtd td, rpmTagVal tag, const char *data);
/** \ingroup rpmtd
* Construct tag container from a string array.
* Tag type is checked to be of string or string array type. For non-array
* types count must be exactly 1.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param data Pointer to string array
* @param count Number of entries
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromStringArray(rpmtd td, rpmTagVal tag, const char **data, rpm_count_t count);
/** \ingroup rpmtd
* Construct tag container from ARGV_t array.
* Tag type is checked to be of string array type and array is checked
* to be non-empty.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param argv ARGV array
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromArgv(rpmtd td, rpmTagVal tag, ARGV_t argv);
/** \ingroup rpmtd
* Construct tag container from ARGI_t array.
* Tag type is checked to be of integer array type and array is checked
* to be non-empty.
* @param td Tag data container
* @param tag Rpm tag to construct
* @param argi ARGI array
* @return 1 on success, 0 on error (eg wrong type)
*/
int rpmtdFromArgi(rpmtd td, rpmTagVal tag, ARGI_t argi);
/* \ingroup rpmtd
* Perform deep copy of container.
* Create a modifiable copy of tag data container (on string arrays each
* string is separately allocated)
* @todo Only string arrays types are supported currently
* @param td Container to copy
* @return New container or NULL on error
*/
rpmtd rpmtdDup(rpmtd td);
/* \ingroup rpmtd
* Push string array container contents to a string pool, return string ids.
* @param td Tag data container
* @param pool String pool
* @return Array of string id's (malloced)
*/
rpmsid * rpmtdToPool(rpmtd td, rpmstrPool pool);
#ifdef __cplusplus
}
#endif
#endif /* _RPMTD_H */
PK vFZs`|�, , header.hnu �[��� #ifndef H_HEADER
#define H_HEADER
/** \ingroup header
* \file lib/header.h
*
* 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.
*
*/
/* RPM - Copyright (C) 1995-2001 Red Hat Software */
#include <rpm/rpmio.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmtd.h>
#include <rpm/rpmutil.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup header
* Header magic value
*/
extern const unsigned char rpm_header_magic[8];
/** \ingroup header
* Include calculation for 8 bytes of (magic, 0)?
*/
enum hMagic {
HEADER_MAGIC_NO = 0,
HEADER_MAGIC_YES = 1
};
/** \ingroup header
* Create new (empty) header instance.
* @return header
*/
Header headerNew(void);
/** \ingroup header
* Dereference a header instance.
* @param h header
* @return NULL always
*/
Header headerFree( Header h);
/** \ingroup header
* Reference a header instance.
* @param h header
* @return new header reference
*/
Header headerLink(Header h);
/** \ingroup header
* Return size of on-disk header representation in bytes.
* @param h header
* @param magicp include size of 8 bytes for (magic, 0)?
* @return size of on-disk header
*/
unsigned int headerSizeof(Header h, int magicp);
/** \ingroup header
* Convert header to on-disk representation.
* @deprecated Use headerExport() instead
* @param h header (with pointers)
* @return on-disk header blob (i.e. with offsets)
*/
void * headerUnload(Header h);
/** \ingroup header
* Export header to on-disk representation.
* @param h header (with pointers)
* @retval bsize on-disk header blob size in bytes
* @return on-disk header blob (i.e. with offsets)
*/
void * headerExport(Header h, unsigned int * bsize);
/** \ingroup header
* Convert header to on-disk representation, and then reload.
* This is used to insure that all header data is in one chunk.
* @param h header (with pointers)
* @param tag region tag
* @return on-disk header (with offsets)
*/
Header headerReload(Header h, rpmTagVal tag);
/** \ingroup header
* Duplicate a header.
* @param h header
* @return new header instance
*/
Header headerCopy(Header h);
/** \ingroup header
* Convert header to in-memory representation.
* @deprecated Use headerImport() instead
* @param uh on-disk header blob (i.e. with offsets)
* @return header
*/
Header headerLoad(void * uh);
/** \ingroup header
* Make a copy and convert header to in-memory representation.
* @deprecated Use headerImport() instead
* @param uh on-disk header blob (i.e. with offsets)
* @return header
*/
Header headerCopyLoad(const void * uh);
enum headerImportFlags_e {
HEADERIMPORT_COPY = (1 << 0), /* Make copy of blob on import? */
HEADERIMPORT_FAST = (1 << 1), /* Faster but less safe? */
};
typedef rpmFlags headerImportFlags;
/** \ingroup header
* Import header to in-memory representation.
* @param blob on-disk header blob (i.e. with offsets)
* @param bsize on-disk header blob size in bytes (0 if unknown)
* @param flags flags to control operation
* @return header
*/
Header headerImport(void *blob, unsigned int bsize, headerImportFlags flags);
/** \ingroup header
* Read (and load) header from file handle.
* @param fd file handle
* @param magicp read (and verify) 8 bytes of (magic, 0)?
* @return header (or NULL on error)
*/
Header headerRead(FD_t fd, int magicp);
/** \ingroup header
* Write (with unload) header to file handle.
* @param fd file handle
* @param h header
* @param magicp prefix write with 8 bytes of (magic, 0)?
* @return 0 on success, 1 on error
*/
int headerWrite(FD_t fd, Header h, int magicp);
/** \ingroup header
* Check if tag is in header.
* @param h header
* @param tag tag
* @return 1 on success, 0 on failure
*/
int headerIsEntry(Header h, rpmTagVal tag);
/** \ingroup header
* Modifier flags for headerGet() operation.
* For consistent behavior you'll probably want to use ALLOC to ensure
* the caller owns the data, but MINMEM is useful for avoiding extra
* copy of data when you are sure the header wont go away.
* Most of the time you'll probably want EXT too, but note that extensions
* tags don't generally honor the other flags, MINMEM, RAW, ALLOC and ARGV
* are only relevant for non-extension data.
*/
enum headerGetFlags_e {
HEADERGET_DEFAULT = 0, /* legacy headerGetEntry() behavior */
HEADERGET_MINMEM = (1 << 0), /* pointers can refer to header memory */
HEADERGET_EXT = (1 << 1), /* lookup extension types too */
HEADERGET_RAW = (1 << 2), /* return raw contents (no i18n lookups) */
HEADERGET_ALLOC = (1 << 3), /* always allocate memory for all data */
HEADERGET_ARGV = (1 << 4), /* return string arrays NULL-terminated */
};
typedef rpmFlags headerGetFlags;
/** \ingroup header
* Retrieve tag value.
* @param h header
* @param tag tag
* @retval td tag data container
* @param flags retrieval modifier flags
* @return 1 on success, 0 on failure
*/
int headerGet(Header h, rpmTagVal tag, rpmtd td, headerGetFlags flags);
enum headerPutFlags_e {
HEADERPUT_DEFAULT = 0,
HEADERPUT_APPEND = (1 << 0),
};
typedef rpmFlags headerPutFlags;
/** \ingroup header
* Add or append tag to header.
*
* @param h header
* @param td tag data container
* @param flags flags to control operation
* @return 1 on success, 0 on failure
*/
int headerPut(Header h, rpmtd td, headerPutFlags flags);
/** \ingroup header
* @{
* Type-safe methods for inserting tag data to header.
* Tag data type is validated to match the function type, ie things like
* headerPutUint32(h, RPMTAG_NAME, ...) will return failure. For non-array
* types size must equal 1, and data is checked to be non-NULL. For array
* types, add-or-append mode is always used.
*
* headerPutString() can be used on both RPM_STRING_TYPE and
* RPM_STRING_ARRAY_TYPE (to add a single string into the array) tags,
* for others the type must match exactly.
*
* These are intended to "do the right thing" in the common case, if you
* need more fine grained control use headerPut() & friends instead.
* @todo Make doxygen group these meaningfully.
*
* @param h header
* @param tag tag to insert
* @param val pointer to value(s)
* @param size number of items in array (1 or larger)
* @return 1 on success, 0 on failure
*
*/
int headerPutBin(Header h, rpmTagVal tag, const uint8_t *val, rpm_count_t size);
int headerPutString(Header h, rpmTagVal tag, const char *val);
int headerPutStringArray(Header h, rpmTagVal tag, const char **val, rpm_count_t size);
int headerPutChar(Header h, rpmTagVal tag, const char *val, rpm_count_t size);
int headerPutUint8(Header h, rpmTagVal tag, const uint8_t *val, rpm_count_t size);
int headerPutUint16(Header h, rpmTagVal tag, const uint16_t *val, rpm_count_t size);
int headerPutUint32(Header h, rpmTagVal tag, const uint32_t *val, rpm_count_t size);
int headerPutUint64(Header h, rpmTagVal tag, const uint64_t *val, rpm_count_t size);
/** @} */
/** \ingroup header
* Add locale specific tag to header.
* A NULL lang is interpreted as the C locale. Here are the rules:
* \verbatim
* - If the tag isn't in the header, it's added with the passed string
* as new value.
* - If the tag occurs multiple times in entry, which tag is affected
* by the operation is undefined.
* - If the tag is in the header w/ this language, the entry is
* *replaced* (like headerMod()).
* \endverbatim
* This function is intended to just "do the right thing". If you need
* more fine grained control use headerPut() and headerMod().
*
* @param h header
* @param tag tag
* @param string tag value
* @param lang locale
* @return 1 on success, 0 on failure
*/
int headerAddI18NString(Header h, rpmTagVal tag, const char * string,
const char * lang);
/** \ingroup header
* Modify tag in header.
* If there are multiple entries with this tag, the first one gets replaced.
* @param h header
* @param td tag data container
* @return 1 on success, 0 on failure
*/
int headerMod(Header h, rpmtd td);
/** \ingroup header
* Delete tag in header.
* Removes all entries of type tag from the header, returns 1 if none were
* found.
*
* @param h header
* @param tag tag
* @return 0 on success, 1 on failure (INCONSISTENT)
*/
int headerDel(Header h, rpmTagVal tag);
/** \ingroup header
* Return formatted output string from header tags.
* The returned string must be free()d.
*
* @param h header
* @param fmt format to use
* @retval errmsg error message (if any)
* @return formatted output string (malloc'ed)
*/
char * headerFormat(Header h, const char * fmt, errmsg_t * errmsg);
/** \ingroup header
* Duplicate tag values from one header into another.
* @param headerFrom source header
* @param headerTo destination header
* @param tagstocopy array of tags that are copied
*/
void headerCopyTags(Header headerFrom, Header headerTo,
const rpmTagVal * tagstocopy);
/** \ingroup header
* Destroy header tag iterator.
* @param hi header tag iterator
* @return NULL always
*/
HeaderIterator headerFreeIterator(HeaderIterator hi);
/** \ingroup header
* Create header tag iterator.
* @param h header
* @return header tag iterator
*/
HeaderIterator headerInitIterator(Header h);
/** \ingroup header
* Return next tag contents from header.
* @param hi header tag iterator
* @retval td tag data container
* @return 1 on success, 0 on failure
*/
int headerNext(HeaderIterator hi, rpmtd td);
/** \ingroup header
* Return next tag number from header.
* @param hi header tag iterator
* @return next tag, RPMTAG_NOT_FOUND to stop iteration
*/
rpmTagVal headerNextTag(HeaderIterator hi);
/** \ingroup header
* Return any non-array tag from header, converted to string
* @param h header
* @param tag tag to retrieve
* @return string pointer (malloced) or NULL on failure
*/
char * headerGetAsString(Header h, rpmTagVal tag);
/** \ingroup header
* Return a simple string tag from header
* @param h header
* @param tag tag to retrieve
* @return string pointer (to header memory) or NULL on failure
*/
const char * headerGetString(Header h, rpmTagVal tag);
/* \ingroup header
* Return a simple number tag (or extension) from header
* @param h header
* @param tag tag to retrieve
* @return numeric tag value or 0 on failure
*/
uint64_t headerGetNumber(Header h, rpmTagVal tag);
/** \ingroup header
* Check if header is a source or binary package header
* @param h header
* @return 0 == binary, 1 == source
*/
int headerIsSource(Header h);
/** \ingroup header
* Return header instance, ie is the header from rpmdb.
* @param h header
* @return rpmdb record number or 0
*/
unsigned int headerGetInstance(Header h);
typedef enum headerConvOps_e {
HEADERCONV_EXPANDFILELIST = 0,
HEADERCONV_COMPRESSFILELIST = 1,
HEADERCONV_RETROFIT_V3 = 2,
} headerConvOps;
/** \ingroup header
* Convert header to/from (legacy) data presentation
* @param h header
* @param op one of headerConvOps operations
* @return 1 on success, 0 on failure
*/
int headerConvert(Header h, int op);
#ifdef __cplusplus
}
#endif
#endif /* H_HEADER */
PK vFZ"�XSU U rpmlib.hnu �[��� #ifndef H_RPMLIB
#define H_RPMLIB
/** \ingroup rpmcli rpmrc rpmdep rpmtrans rpmdb lead signature header payload dbi
* \file lib/rpmlib.h
*
* In Memoriam: Steve Taylor <staylor@redhat.com> was here, now he's not.
*
*/
#include <popt.h>
#include <rpm/rpmio.h>
#include <rpm/header.h>
#include <rpm/rpmtag.h>
#include <rpm/rpmds.h> /* XXX move rpmlib provides to rpmds instead */
#include <rpm/rpmpgp.h>
#ifdef _RPM_4_4_COMPAT
#warning RPM 4.4.x compatibility layer has been removed in RPM >= 4.14
#endif
#ifdef __cplusplus
extern "C" {
#endif
extern struct rpmMacroContext_s * rpmGlobalMacroContext;
extern struct rpmMacroContext_s * rpmCLIMacroContext;
extern const char * const RPMVERSION;
extern const char * const rpmNAME;
extern const char * const rpmEVR;
extern const int rpmFLAGS;
/* ==================================================================== */
/** \name RPMRC */
/** \ingroup rpmrc
* Build and install arch/os table identifiers.
* @todo Eliminate from API.
*/
enum rpm_machtable_e {
RPM_MACHTABLE_INSTARCH = 0, /*!< Install platform architecture. */
RPM_MACHTABLE_INSTOS = 1, /*!< Install platform operating system. */
RPM_MACHTABLE_BUILDARCH = 2, /*!< Build platform architecture. */
RPM_MACHTABLE_BUILDOS = 3 /*!< Build platform operating system. */
};
#define RPM_MACHTABLE_COUNT 4 /*!< No. of arch/os tables. */
/** \ingroup rpmrc
* Read macro configuration file(s) for a target.
* @param file colon separated files to read (NULL uses default)
* @param target target platform (NULL uses default)
* @return 0 on success, -1 on error
*/
int rpmReadConfigFiles(const char * file,
const char * target);
/** \ingroup rpmrc
* Return current arch name and/or number.
* @todo Generalize to extract arch component from target_platform macro.
* @retval name address of arch name (or NULL)
* @retval num address of arch number (or NULL)
*/
void rpmGetArchInfo( const char ** name,
int * num);
/** \ingroup rpmrc
* Return color for an arch
* @param arch name of an architecture
* @return color color of arch, -1 if the arch couldn't be determined
*/
int rpmGetArchColor(const char *arch);
/** \ingroup rpmrc
* Return current os name and/or number.
* @todo Generalize to extract os component from target_platform macro.
* @retval name address of os name (or NULL)
* @retval num address of os number (or NULL)
*/
void rpmGetOsInfo( const char ** name,
int * num);
/** \ingroup rpmrc
* Return arch/os score of a name.
* An arch/os score measures the "nearness" of a name to the currently
* running (or defined) platform arch/os. For example, the score of arch
* "i586" on an i686 platform is (usually) 2. The arch/os score is used
* to select one of several otherwise identical packages using the arch/os
* tags from the header as hints of the intended platform for the package.
* @todo Rewrite to use RE's against config.guess target platform output.
*
* @param type any of the RPM_MACHTABLE_* constants
* @param name name
* @return arch score (0 is no match, lower is preferred)
*/
int rpmMachineScore(int type, const char * name);
/** \ingroup rpmrc
* Display current rpmrc (and macro) configuration.
* @param fp output file handle
* @return 0 always
*/
int rpmShowRC(FILE * fp);
/** \ingroup rpmrc
* Destroy rpmrc arch/os compatibility tables.
* @todo Eliminate from API.
*/
void rpmFreeRpmrc(void);
/**
* Compare headers to determine which header is "newer".
* @param first 1st header
* @param second 2nd header
* @return result of comparison
*/
int rpmVersionCompare(Header first, Header second);
/** \ingroup header
* Check header consistency, performing headerGetEntry() the hard way.
*
* Sanity checks on the header are performed while looking for a
* header-only digest or signature to verify the blob. If found,
* the digest or signature is verified.
*
* @param ts transaction set
* @param uh unloaded header blob
* @param uc no. of bytes in blob (or 0 to disable)
* @retval *msg verification error message (or NULL)
* @return RPMRC_OK on success
*/
rpmRC headerCheck(rpmts ts, const void * uh, size_t uc, char ** msg);
/** \ingroup header
* Return checked and loaded header.
* @param ts unused
* @param fd file handle
* @retval hdrp address of header (or NULL)
* @retval *msg verification error message (or NULL)
* @return RPMRC_OK on success
*/
rpmRC rpmReadHeader(rpmts ts, FD_t fd, Header *hdrp, char ** msg);
/** \ingroup header
* Return package header from file handle, verifying digests/signatures.
* @param ts transaction set
* @param fd file handle
* @param fn file name
* @retval hdrp address of header (or NULL)
* @return RPMRC_OK on success
*/
rpmRC rpmReadPackageFile(rpmts ts, FD_t fd,
const char * fn, Header * hdrp);
/** \ingroup rpmtrans
* Install source package.
* @param ts transaction set
* @param fd file handle
* @retval specFilePtr address of spec file name (or NULL)
* @retval cookie address of cookie pointer (or NULL)
* @return rpmRC return code
*/
rpmRC rpmInstallSourcePackage(rpmts ts, FD_t fd,
char ** specFilePtr,
char ** cookie);
/** \ingroup rpmtrans
* Segmented string compare for version or release strings.
*
* @param a 1st string
* @param b 2nd string
* @return +1 if a is "newer", 0 if equal, -1 if b is "newer"
*/
int rpmvercmp(const char * a, const char * b);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMLIB */
PK vFZ���l l
rpmmacro.hnu �[��� #ifndef _H_MACRO_
#define _H_MACRO_
/** \ingroup rpmio
* \file rpmio/rpmmacro.h
*
* Macro API
*/
#include <stdio.h>
#include <stddef.h>
#include <rpm/rpmutil.h>
#include <rpm/rpmfileutil.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef struct rpmMacroEntry_s * rpmMacroEntry;
typedef struct rpmMacroContext_s * rpmMacroContext;
extern rpmMacroContext rpmGlobalMacroContext;
extern rpmMacroContext rpmCLIMacroContext;
/** \ingroup rpmrc
* List of macro files to read when configuring rpm.
* This is a colon separated list of files. URI's are permitted as well,
* identified by the token '://', so file paths must not begin with '//'.
*/
extern const char * macrofiles;
/**
* Markers for sources of macros added throughout rpm.
*/
#define RMIL_DEFAULT -15
#define RMIL_MACROFILES -13
#define RMIL_RPMRC -11
#define RMIL_CMDLINE -7
#define RMIL_TARBALL -5
#define RMIL_SPEC -3
#define RMIL_OLDSPEC -1
#define RMIL_GLOBAL 0
/* Deprecated compatibility wrappers */
#define addMacro(_mc, _n, _o, _b, _l) rpmPushMacro(_mc, _n, _o, _b, _l)
#define delMacro(_mc, _n) rpmPopMacro(_mc, _n)
/** \ingroup rpmmacro
* Print macros to file stream.
* @param mc macro context (NULL uses global context).
* @param fp file stream (NULL uses stderr).
*/
void rpmDumpMacroTable (rpmMacroContext mc,
FILE * fp);
/** \ingroup rpmmacro
* Expand macro into buffer.
* @param mc macro context (NULL uses global context).
* @param sbuf input macro to expand
* @param obuf macro expansion (malloc'ed)
* @param flags flags (currently unused)
* @return negative on failure
*/
int rpmExpandMacros (rpmMacroContext mc, const char * sbuf,
char ** obuf, int flags);
/** \ingroup rpmmacro
* Push macro to context.
* @param mc macro context (NULL uses global context).
* @param n macro name
* @param o macro parameters
* @param b macro body
* @param level macro recursion level (0 is entry API)
* @return 0 on success
*/
int rpmPushMacro (rpmMacroContext mc, const char * n,
const char * o,
const char * b, int level);
/** \ingroup rpmmacro
* Pop macro from context.
* @param mc macro context (NULL uses global context).
* @param n macro name
* @return 0 on success
*/
int rpmPopMacro (rpmMacroContext mc, const char * n);
/** \ingroup rpmmacro
* Define macro in context.
* @param mc macro context (NULL uses global context).
* @param macro macro name, options, body
* @param level macro recursion level (0 is entry API)
* @return 0 on success (always)
*/
int rpmDefineMacro (rpmMacroContext mc, const char * macro,
int level);
/** \ingroup rpmmacro
* Load macros from specific context into global context.
* @param mc macro context (NULL does nothing).
* @param level macro recursion level (0 is entry API)
*/
void rpmLoadMacros (rpmMacroContext mc, int level);
/** \ingroup rpmmacro
* Load macro context from a macro file.
* @param mc (unused)
* @param fn macro file name
*/
int rpmLoadMacroFile(rpmMacroContext mc, const char * fn);
/** \ingroup rpmmacro
* Initialize macro context from set of macrofile(s).
* @param mc macro context
* @param macrofiles colon separated list of macro files (NULL does nothing)
*/
void rpmInitMacros (rpmMacroContext mc, const char * macrofiles);
/** \ingroup rpmmacro
* Destroy macro context.
* @param mc macro context (NULL uses global context).
*/
void rpmFreeMacros (rpmMacroContext mc);
/** \ingroup rpmmacro
* Return (malloc'ed) concatenated macro expansion(s).
* @param arg macro(s) to expand (NULL terminates list)
* @return macro expansion (malloc'ed)
*/
char * rpmExpand (const char * arg, ...) RPM_GNUC_NULL_TERMINATED;
/** \ingroup rpmmacro
* Return macro expansion as a numeric value.
* Boolean values ('Y' or 'y' returns 1, 'N' or 'n' returns 0)
* are permitted as well. An undefined macro returns 0.
* @param arg macro to expand
* @return numeric value
*/
int rpmExpandNumeric (const char * arg);
/** \ingroup rpmmacro
* Return rpm configuration base directory.
* If RPM_CONFIGDIR environment variable is set, it's value will be used.
* Otherwise the configuration directory is the one set at build time,
* typically /usr/lib/rpm. The value of rpmConfigDir() is determined
* on first call to this function and is guaranteed to remain the same
* on subsequent calls.
* @return rpm configuration directory name
*/
const char *rpmConfigDir(void);
#ifdef __cplusplus
}
#endif
#endif /* _H_ MACRO_ */
PK vFZ�$�=M M
rpmbuild.hnu �[��� #ifndef _H_RPMBUILD_
#define _H_RPMBUILD_
/** \ingroup rpmbuild
* \file build/rpmbuild.h
* This is the *only* module users of librpmbuild should need to include.
*/
#include <rpm/rpmcli.h>
#include <rpm/rpmds.h>
#include <rpm/rpmspec.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmbuild
* Bit(s) to control rpmSpecBuild() operation. Also used as argument to
* rpmSpecGetSection and rpmSpecPkgGetSection.
*/
enum rpmBuildFlags_e {
RPMBUILD_NONE = 0,
RPMBUILD_PREP = (1 << 0), /*!< Execute %%prep. */
RPMBUILD_BUILD = (1 << 1), /*!< Execute %%build. */
RPMBUILD_INSTALL = (1 << 2), /*!< Execute %%install. */
RPMBUILD_CHECK = (1 << 3), /*!< Execute %%check. */
RPMBUILD_CLEAN = (1 << 4), /*!< Execute %%clean. */
RPMBUILD_FILECHECK = (1 << 5), /*!< Check %%files manifest. */
RPMBUILD_PACKAGESOURCE = (1 << 6), /*!< Create source package. */
RPMBUILD_PACKAGEBINARY = (1 << 7), /*!< Create binary package(s). */
RPMBUILD_RMSOURCE = (1 << 8), /*!< Remove source(s) and patch(s). */
RPMBUILD_RMBUILD = (1 << 9), /*!< Remove build sub-tree. */
RPMBUILD_STRINGBUF = (1 << 10), /*!< Internal use only */
RPMBUILD_RMSPEC = (1 << 11), /*!< Remove spec file. */
RPMBUILD_FILE_FILE = (1 << 16), /*!< rpmSpecPkgGetSection: %files -f */
RPMBUILD_FILE_LIST = (1 << 17), /*!< rpmSpecPkgGetSection: %files */
RPMBUILD_POLICY = (1 << 18), /*!< rpmSpecPkgGetSection: %policy */
RPMBUILD_NOBUILD = (1 << 31) /*!< Don't execute or package. */
};
typedef rpmFlags rpmBuildFlags;
/** \ingroup rpmbuild
* Bit(s) to control package generation
*/
enum rpmBuildPkgFlags_e {
RPMBUILD_PKG_NONE = 0,
RPMBUILD_PKG_NODIRTOKENS = (1 << 0), /*!< Legacy filename layout */
};
typedef rpmFlags rpmBuildPkgFlags;
/** \ingroup rpmbuild
* Describe build request.
*/
struct rpmBuildArguments_s {
rpmBuildPkgFlags pkgFlags; /*!< Bit(s) to control package generation. */
rpmBuildFlags buildAmount; /*!< Bit(s) to control build execution. */
char * buildRootOverride; /*!< from --buildroot */
char * cookie; /*!< NULL for binary, ??? for source, rpm's */
const char * rootdir;
};
/** \ingroup rpmbuild
*/
typedef struct rpmBuildArguments_s * BTA_t;
/** \ingroup rpmbuild
* Parse spec file into spec control structure.
* @todo Eliminate buildRoot from here, its a build, not spec property
*
* @param specFile path to spec file
* @param flags flags to control operation
* @param buildRoot buildRoot override or NULL for default
* @return new spec control structure
*/
rpmSpec rpmSpecParse(const char *specFile, rpmSpecFlags flags,
const char *buildRoot);
/** \ingroup rpmbuild
* Return the headers of the SRPM that would be built from the spec file
* @param spec path to spec file
* @return Header
*/
Header rpmSpecSourceHeader(rpmSpec spec);
/** \ingroup rpmbuild
* Verify build depencies of a spec against.
* @param ts (empty) transaction set
* @param spec parsed spec control structure
* @return rpm problem set or NULL on no problems
*/
rpmps rpmSpecCheckDeps(rpmts ts, rpmSpec spec);
/** \ingroup rpmbuild
* Retrieve build dependency set from spec.
* @param spec parsed spec control structure
* @param tag dependency tag
* @return dependency set of tag (or NULL)
*/
rpmds rpmSpecDS(rpmSpec spec, rpmTagVal tag);
/** \ingroup rpmbuild
* Spec build stages state machine driver.
* @param spec spec file control structure
* @param buildArgs build arguments
* @return RPMRC_OK on success
*/
rpmRC rpmSpecBuild(rpmSpec spec, BTA_t buildArgs);
#ifdef __cplusplus
}
#endif
#endif /* _H_RPMBUILD_ */
PK vFZُ��1� 1� rpmpgp.hnu �[��� #ifndef H_RPMPGP
#define H_RPMPGP
/** \ingroup rpmpgp
* \file rpmio/rpmpgp.h
*
* OpenPGP constants and structures from RFC-2440.
*
* Text from RFC-2440 in comments is
* Copyright (C) The Internet Society (1998). All Rights Reserved.
*/
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmstring.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmpgp
*/
typedef struct DIGEST_CTX_s * DIGEST_CTX;
typedef struct rpmDigestBundle_s * rpmDigestBundle;
/** \ingroup rpmpgp
*/
typedef struct pgpDig_s * pgpDig;
/** \ingroup rpmpgp
*/
typedef struct pgpDigParams_s * pgpDigParams;
typedef uint8_t pgpKeyID_t[8];
typedef uint8_t pgpTime_t[4];
/** \ingroup rpmpgp
* 4.3. Packet Tags
*
* The packet tag denotes what type of packet the body holds. Note that
* old format headers can only have tags less than 16, whereas new
* format headers can have tags as great as 63.
*/
typedef enum pgpTag_e {
PGPTAG_RESERVED = 0, /*!< Reserved/Invalid */
PGPTAG_PUBLIC_SESSION_KEY = 1, /*!< Public-Key Encrypted Session Key */
PGPTAG_SIGNATURE = 2, /*!< Signature */
PGPTAG_SYMMETRIC_SESSION_KEY= 3, /*!< Symmetric-Key Encrypted Session Key*/
PGPTAG_ONEPASS_SIGNATURE = 4, /*!< One-Pass Signature */
PGPTAG_SECRET_KEY = 5, /*!< Secret Key */
PGPTAG_PUBLIC_KEY = 6, /*!< Public Key */
PGPTAG_SECRET_SUBKEY = 7, /*!< Secret Subkey */
PGPTAG_COMPRESSED_DATA = 8, /*!< Compressed Data */
PGPTAG_SYMMETRIC_DATA = 9, /*!< Symmetrically Encrypted Data */
PGPTAG_MARKER = 10, /*!< Marker */
PGPTAG_LITERAL_DATA = 11, /*!< Literal Data */
PGPTAG_TRUST = 12, /*!< Trust */
PGPTAG_USER_ID = 13, /*!< User ID */
PGPTAG_PUBLIC_SUBKEY = 14, /*!< Public Subkey */
PGPTAG_COMMENT_OLD = 16, /*!< Comment (from OpenPGP draft) */
PGPTAG_PHOTOID = 17, /*!< PGP's photo ID */
PGPTAG_ENCRYPTED_MDC = 18, /*!< Integrity protected encrypted data */
PGPTAG_MDC = 19, /*!< Manipulaion detection code packet */
PGPTAG_PRIVATE_60 = 60, /*!< Private or Experimental Values */
PGPTAG_COMMENT = 61, /*!< Comment */
PGPTAG_PRIVATE_62 = 62, /*!< Private or Experimental Values */
PGPTAG_CONTROL = 63 /*!< Control (GPG) */
} pgpTag;
/** \ingroup rpmpgp
* 5.1. Public-Key Encrypted Session Key Packets (Tag 1)
*
* A Public-Key Encrypted Session Key packet holds the session key used
* to encrypt a message. Zero or more Encrypted Session Key packets
* (either Public-Key or Symmetric-Key) may precede a Symmetrically
* Encrypted Data Packet, which holds an encrypted message. The message
* is encrypted with the session key, and the session key is itself
* encrypted and stored in the Encrypted Session Key packet(s). The
* Symmetrically Encrypted Data Packet is preceded by one Public-Key
* Encrypted Session Key packet for each OpenPGP key to which the
* message is encrypted. The recipient of the message finds a session
* key that is encrypted to their public key, decrypts the session key,
* and then uses the session key to decrypt the message.
*
* The body of this packet consists of:
* - A one-octet number giving the version number of the packet type.
* The currently defined value for packet version is 3. An
* implementation should accept, but not generate a version of 2,
* which is equivalent to V3 in all other respects.
* - An eight-octet number that gives the key ID of the public key
* that the session key is encrypted to.
* - A one-octet number giving the public key algorithm used.
* - A string of octets that is the encrypted session key. This string
* takes up the remainder of the packet, and its contents are
* dependent on the public key algorithm used.
*
* Algorithm Specific Fields for RSA encryption
* - multiprecision integer (MPI) of RSA encrypted value m**e mod n.
*
* Algorithm Specific Fields for Elgamal encryption:
* - MPI of Elgamal (Diffie-Hellman) value g**k mod p.
* - MPI of Elgamal (Diffie-Hellman) value m * y**k mod p.
*/
typedef struct pgpPktPubkey_s {
uint8_t version; /*!< version number (generate 3, accept 2). */
pgpKeyID_t keyid; /*!< key ID of the public key for session key. */
uint8_t algo; /*!< public key algorithm used. */
} pgpPktPubkey;
/** \ingroup rpmpgp
* 5.2.1. Signature Types
*
* There are a number of possible meanings for a signature, which are
* specified in a signature type octet in any given signature.
*/
typedef enum pgpSigType_e {
PGPSIGTYPE_BINARY = 0x00, /*!< Binary document */
PGPSIGTYPE_TEXT = 0x01, /*!< Canonical text document */
PGPSIGTYPE_STANDALONE = 0x02, /*!< Standalone */
PGPSIGTYPE_GENERIC_CERT = 0x10,
/*!< Generic certification of a User ID & Public Key */
PGPSIGTYPE_PERSONA_CERT = 0x11,
/*!< Persona certification of a User ID & Public Key */
PGPSIGTYPE_CASUAL_CERT = 0x12,
/*!< Casual certification of a User ID & Public Key */
PGPSIGTYPE_POSITIVE_CERT = 0x13,
/*!< Positive certification of a User ID & Public Key */
PGPSIGTYPE_SUBKEY_BINDING = 0x18, /*!< Subkey Binding */
PGPSIGTYPE_SIGNED_KEY = 0x1F, /*!< Signature directly on a key */
PGPSIGTYPE_KEY_REVOKE = 0x20, /*!< Key revocation */
PGPSIGTYPE_SUBKEY_REVOKE = 0x28, /*!< Subkey revocation */
PGPSIGTYPE_CERT_REVOKE = 0x30, /*!< Certification revocation */
PGPSIGTYPE_TIMESTAMP = 0x40 /*!< Timestamp */
} pgpSigType;
/** \ingroup rpmpgp
* 9.1. Public Key Algorithms
*
\verbatim
ID Algorithm
-- ---------
1 - RSA (Encrypt or Sign)
2 - RSA Encrypt-Only
3 - RSA Sign-Only
16 - Elgamal (Encrypt-Only), see [ELGAMAL]
17 - DSA (Digital Signature Standard)
18 - Reserved for Elliptic Curve
19 - Reserved for ECDSA
20 - Elgamal (Encrypt or Sign)
21 - Reserved for Diffie-Hellman (X9.42,
as defined for IETF-S/MIME)
100 to 110 - Private/Experimental algorithm.
\endverbatim
*
* Implementations MUST implement DSA for signatures, and Elgamal for
* encryption. Implementations SHOULD implement RSA keys.
* Implementations MAY implement any other algorithm.
*/
typedef enum pgpPubkeyAlgo_e {
PGPPUBKEYALGO_RSA = 1, /*!< RSA */
PGPPUBKEYALGO_RSA_ENCRYPT = 2, /*!< RSA(Encrypt-Only) */
PGPPUBKEYALGO_RSA_SIGN = 3, /*!< RSA(Sign-Only) */
PGPPUBKEYALGO_ELGAMAL_ENCRYPT = 16, /*!< Elgamal(Encrypt-Only) */
PGPPUBKEYALGO_DSA = 17, /*!< DSA */
PGPPUBKEYALGO_EC = 18, /*!< Elliptic Curve */
PGPPUBKEYALGO_ECDSA = 19, /*!< ECDSA */
PGPPUBKEYALGO_ELGAMAL = 20, /*!< Elgamal */
PGPPUBKEYALGO_DH = 21 /*!< Diffie-Hellman (X9.42) */
} pgpPubkeyAlgo;
/** \ingroup rpmpgp
* 9.2. Symmetric Key Algorithms
*
\verbatim
ID Algorithm
-- ---------
0 - Plaintext or unencrypted data
1 - IDEA [IDEA]
2 - Triple-DES (DES-EDE, as per spec -
168 bit key derived from 192)
3 - CAST5 (128 bit key, as per RFC 2144)
4 - Blowfish (128 bit key, 16 rounds) [BLOWFISH]
5 - SAFER-SK128 (13 rounds) [SAFER]
6 - Reserved for DES/SK
7 - Reserved for AES with 128-bit key
8 - Reserved for AES with 192-bit key
9 - Reserved for AES with 256-bit key
100 to 110 - Private/Experimental algorithm.
\endverbatim
*
* Implementations MUST implement Triple-DES. Implementations SHOULD
* implement IDEA and CAST5. Implementations MAY implement any other
* algorithm.
*/
typedef enum pgpSymkeyAlgo_e {
PGPSYMKEYALGO_PLAINTEXT = 0, /*!< Plaintext */
PGPSYMKEYALGO_IDEA = 1, /*!< IDEA */
PGPSYMKEYALGO_TRIPLE_DES = 2, /*!< 3DES */
PGPSYMKEYALGO_CAST5 = 3, /*!< CAST5 */
PGPSYMKEYALGO_BLOWFISH = 4, /*!< BLOWFISH */
PGPSYMKEYALGO_SAFER = 5, /*!< SAFER */
PGPSYMKEYALGO_DES_SK = 6, /*!< DES/SK */
PGPSYMKEYALGO_AES_128 = 7, /*!< AES(128-bit key) */
PGPSYMKEYALGO_AES_192 = 8, /*!< AES(192-bit key) */
PGPSYMKEYALGO_AES_256 = 9, /*!< AES(256-bit key) */
PGPSYMKEYALGO_TWOFISH = 10, /*!< TWOFISH(256-bit key) */
PGPSYMKEYALGO_NOENCRYPT = 110 /*!< no encryption */
} pgpSymkeyAlgo;
/** \ingroup rpmpgp
* 9.3. Compression Algorithms
*
\verbatim
ID Algorithm
-- ---------
0 - Uncompressed
1 - ZIP (RFC 1951)
2 - ZLIB (RFC 1950)
100 to 110 - Private/Experimental algorithm.
\endverbatim
*
* Implementations MUST implement uncompressed data. Implementations
* SHOULD implement ZIP. Implementations MAY implement ZLIB.
*/
typedef enum pgpCompressAlgo_e {
PGPCOMPRESSALGO_NONE = 0, /*!< Uncompressed */
PGPCOMPRESSALGO_ZIP = 1, /*!< ZIP */
PGPCOMPRESSALGO_ZLIB = 2, /*!< ZLIB */
PGPCOMPRESSALGO_BZIP2 = 3 /*!< BZIP2 */
} pgpCompressAlgo;
/** \ingroup rpmpgp
* 9.4. Hash Algorithms
*
\verbatim
ID Algorithm Text Name
-- --------- ---- ----
1 - MD5 "MD5"
2 - SHA-1 "SHA1"
3 - RIPE-MD/160 "RIPEMD160"
4 - Reserved for double-width SHA (experimental)
5 - MD2 "MD2"
6 - Reserved for TIGER/192 "TIGER192"
7 - Reserved for HAVAL (5 pass, 160-bit) "HAVAL-5-160"
8 - SHA-256 "SHA256"
9 - SHA-384 "SHA384"
10 - SHA-512 "SHA512"
11 - SHA-224 "SHA224"
100 to 110 - Private/Experimental algorithm.
\endverbatim
*
* Implementations MUST implement SHA-1. Implementations SHOULD
* implement MD5.
*/
typedef enum pgpHashAlgo_e {
PGPHASHALGO_MD5 = 1, /*!< MD5 */
PGPHASHALGO_SHA1 = 2, /*!< SHA1 */
PGPHASHALGO_RIPEMD160 = 3, /*!< RIPEMD160 */
PGPHASHALGO_MD2 = 5, /*!< MD2 */
PGPHASHALGO_TIGER192 = 6, /*!< TIGER192 */
PGPHASHALGO_HAVAL_5_160 = 7, /*!< HAVAL-5-160 */
PGPHASHALGO_SHA256 = 8, /*!< SHA256 */
PGPHASHALGO_SHA384 = 9, /*!< SHA384 */
PGPHASHALGO_SHA512 = 10, /*!< SHA512 */
PGPHASHALGO_SHA224 = 11, /*!< SHA224 */
} pgpHashAlgo;
/** \ingroup rpmpgp
* 5.2.2. Version 3 Signature Packet Format
*
* The body of a version 3 Signature Packet contains:
* - One-octet version number (3).
* - One-octet length of following hashed material. MUST be 5.
* - One-octet signature type.
* - Four-octet creation time.
* - Eight-octet key ID of signer.
* - One-octet public key algorithm.
* - One-octet hash algorithm.
* - Two-octet field holding left 16 bits of signed hash value.
* - One or more multi-precision integers comprising the signature.
*
* Algorithm Specific Fields for RSA signatures:
* - multiprecision integer (MPI) of RSA signature value m**d.
*
* Algorithm Specific Fields for DSA signatures:
* - MPI of DSA value r.
* - MPI of DSA value s.
*/
typedef struct pgpPktSigV3_s {
uint8_t version; /*!< version number (3). */
uint8_t hashlen; /*!< length of following hashed material. MUST be 5. */
uint8_t sigtype; /*!< signature type. */
pgpTime_t time; /*!< 4 byte creation time. */
pgpKeyID_t signid; /*!< key ID of signer. */
uint8_t pubkey_algo; /*!< public key algorithm. */
uint8_t hash_algo; /*!< hash algorithm. */
uint8_t signhash16[2]; /*!< left 16 bits of signed hash value. */
} * pgpPktSigV3;
/** \ingroup rpmpgp
* 5.2.3. Version 4 Signature Packet Format
*
* The body of a version 4 Signature Packet contains:
* - One-octet version number (4).
* - One-octet signature type.
* - One-octet public key algorithm.
* - One-octet hash algorithm.
* - Two-octet scalar octet count for following hashed subpacket
* data. Note that this is the length in octets of all of the hashed
* subpackets; a pointer incremented by this number will skip over
* the hashed subpackets.
* - Hashed subpacket data. (zero or more subpackets)
* - Two-octet scalar octet count for following unhashed subpacket
* data. Note that this is the length in octets of all of the
* unhashed subpackets; a pointer incremented by this number will
* skip over the unhashed subpackets.
* - Unhashed subpacket data. (zero or more subpackets)
* - Two-octet field holding left 16 bits of signed hash value.
* - One or more multi-precision integers comprising the signature.
*/
typedef struct pgpPktSigV4_s {
uint8_t version; /*!< version number (4). */
uint8_t sigtype; /*!< signature type. */
uint8_t pubkey_algo; /*!< public key algorithm. */
uint8_t hash_algo; /*!< hash algorithm. */
uint8_t hashlen[2]; /*!< length of following hashed material. */
} * pgpPktSigV4;
/** \ingroup rpmpgp
* 5.2.3.1. Signature Subpacket Specification
*
* The subpacket fields consist of zero or more signature subpackets.
* Each set of subpackets is preceded by a two-octet scalar count of the
* length of the set of subpackets.
*
* Each subpacket consists of a subpacket header and a body. The header
* consists of:
* - the subpacket length (1, 2, or 5 octets)
* - the subpacket type (1 octet)
* and is followed by the subpacket specific data.
*
* The length includes the type octet but not this length. Its format is
* similar to the "new" format packet header lengths, but cannot have
* partial body lengths. That is:
\verbatim
if the 1st octet < 192, then
lengthOfLength = 1
subpacketLen = 1st_octet
if the 1st octet >= 192 and < 255, then
lengthOfLength = 2
subpacketLen = ((1st_octet - 192) << 8) + (2nd_octet) + 192
if the 1st octet = 255, then
lengthOfLength = 5
subpacket length = [four-octet scalar starting at 2nd_octet]
\endverbatim
*
* The value of the subpacket type octet may be:
*
\verbatim
2 = signature creation time
3 = signature expiration time
4 = exportable certification
5 = trust signature
6 = regular expression
7 = revocable
9 = key expiration time
10 = placeholder for backward compatibility
11 = preferred symmetric algorithms
12 = revocation key
16 = issuer key ID
20 = notation data
21 = preferred hash algorithms
22 = preferred compression algorithms
23 = key server preferences
24 = preferred key server
25 = primary user id
26 = policy URL
27 = key flags
28 = signer's user id
29 = reason for revocation
100 to 110 = internal or user-defined
\endverbatim
*
* An implementation SHOULD ignore any subpacket of a type that it does
* not recognize.
*
* Bit 7 of the subpacket type is the "critical" bit. If set, it
* denotes that the subpacket is one that is critical for the evaluator
* of the signature to recognize. If a subpacket is encountered that is
* marked critical but is unknown to the evaluating software, the
* evaluator SHOULD consider the signature to be in error.
*/
typedef enum pgpSubType_e {
PGPSUBTYPE_NONE = 0, /*!< none */
PGPSUBTYPE_SIG_CREATE_TIME = 2, /*!< signature creation time */
PGPSUBTYPE_SIG_EXPIRE_TIME = 3, /*!< signature expiration time */
PGPSUBTYPE_EXPORTABLE_CERT = 4, /*!< exportable certification */
PGPSUBTYPE_TRUST_SIG = 5, /*!< trust signature */
PGPSUBTYPE_REGEX = 6, /*!< regular expression */
PGPSUBTYPE_REVOCABLE = 7, /*!< revocable */
PGPSUBTYPE_KEY_EXPIRE_TIME = 9, /*!< key expiration time */
PGPSUBTYPE_ARR = 10, /*!< additional recipient request */
PGPSUBTYPE_PREFER_SYMKEY = 11, /*!< preferred symmetric algorithms */
PGPSUBTYPE_REVOKE_KEY = 12, /*!< revocation key */
PGPSUBTYPE_ISSUER_KEYID = 16, /*!< issuer key ID */
PGPSUBTYPE_NOTATION = 20, /*!< notation data */
PGPSUBTYPE_PREFER_HASH = 21, /*!< preferred hash algorithms */
PGPSUBTYPE_PREFER_COMPRESS = 22, /*!< preferred compression algorithms */
PGPSUBTYPE_KEYSERVER_PREFERS= 23, /*!< key server preferences */
PGPSUBTYPE_PREFER_KEYSERVER = 24, /*!< preferred key server */
PGPSUBTYPE_PRIMARY_USERID = 25, /*!< primary user id */
PGPSUBTYPE_POLICY_URL = 26, /*!< policy URL */
PGPSUBTYPE_KEY_FLAGS = 27, /*!< key flags */
PGPSUBTYPE_SIGNER_USERID = 28, /*!< signer's user id */
PGPSUBTYPE_REVOKE_REASON = 29, /*!< reason for revocation */
PGPSUBTYPE_FEATURES = 30, /*!< feature flags (gpg) */
PGPSUBTYPE_EMBEDDED_SIG = 32, /*!< embedded signature (gpg) */
PGPSUBTYPE_INTERNAL_100 = 100, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_101 = 101, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_102 = 102, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_103 = 103, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_104 = 104, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_105 = 105, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_106 = 106, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_107 = 107, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_108 = 108, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_109 = 109, /*!< internal or user-defined */
PGPSUBTYPE_INTERNAL_110 = 110, /*!< internal or user-defined */
PGPSUBTYPE_CRITICAL = 128 /*!< critical subpacket marker */
} pgpSubType;
/** \ingroup rpmpgp
* 5.2. Signature Packet (Tag 2)
*
* A signature packet describes a binding between some public key and
* some data. The most common signatures are a signature of a file or a
* block of text, and a signature that is a certification of a user ID.
*
* Two versions of signature packets are defined. Version 3 provides
* basic signature information, while version 4 provides an expandable
* format with subpackets that can specify more information about the
* signature. PGP 2.6.x only accepts version 3 signatures.
*
* Implementations MUST accept V3 signatures. Implementations SHOULD
* generate V4 signatures. Implementations MAY generate a V3 signature
* that can be verified by PGP 2.6.x.
*
* Note that if an implementation is creating an encrypted and signed
* message that is encrypted to a V3 key, it is reasonable to create a
* V3 signature.
*/
typedef union pgpPktSig_u {
struct pgpPktSigV3_s v3;
struct pgpPktSigV4_s v4;
} * pgpPktSig;
/**
* 5.3. Symmetric-Key Encrypted Session-Key Packets (Tag 3)
*
* The Symmetric-Key Encrypted Session Key packet holds the symmetric-
* key encryption of a session key used to encrypt a message. Zero or
* more Encrypted Session Key packets and/or Symmetric-Key Encrypted
* Session Key packets may precede a Symmetrically Encrypted Data Packet
* that holds an encrypted message. The message is encrypted with a
* session key, and the session key is itself encrypted and stored in
* the Encrypted Session Key packet or the Symmetric-Key Encrypted
* Session Key packet.
*
* If the Symmetrically Encrypted Data Packet is preceded by one or more
* Symmetric-Key Encrypted Session Key packets, each specifies a
* passphrase that may be used to decrypt the message. This allows a
* message to be encrypted to a number of public keys, and also to one
* or more pass phrases. This packet type is new, and is not generated
* by PGP 2.x or PGP 5.0.
*
* The body of this packet consists of:
* - A one-octet version number. The only currently defined version
* is 4.
* - A one-octet number describing the symmetric algorithm used.
* - A string-to-key (S2K) specifier, length as defined above.
* - Optionally, the encrypted session key itself, which is decrypted
* with the string-to-key object.
*
*/
typedef struct pgpPktSymkey_s {
uint8_t version; /*!< version number (4). */
uint8_t symkey_algo;
uint8_t s2k[1];
} pgpPktSymkey;
/** \ingroup rpmpgp
* 5.4. One-Pass Signature Packets (Tag 4)
*
* The One-Pass Signature packet precedes the signed data and contains
* enough information to allow the receiver to begin calculating any
* hashes needed to verify the signature. It allows the Signature
* Packet to be placed at the end of the message, so that the signer can
* compute the entire signed message in one pass.
*
* A One-Pass Signature does not interoperate with PGP 2.6.x or earlier.
*
* The body of this packet consists of:
* - A one-octet version number. The current version is 3.
* - A one-octet signature type. Signature types are described in
* section 5.2.1.
* - A one-octet number describing the hash algorithm used.
* - A one-octet number describing the public key algorithm used.
* - An eight-octet number holding the key ID of the signing key.
* - A one-octet number holding a flag showing whether the signature
* is nested. A zero value indicates that the next packet is
* another One-Pass Signature packet that describes another
* signature to be applied to the same message data.
*
* Note that if a message contains more than one one-pass signature,
* then the signature packets bracket the message; that is, the first
* signature packet after the message corresponds to the last one-pass
* packet and the final signature packet corresponds to the first one-
* pass packet.
*/
typedef struct pgpPktOnepass_s {
uint8_t version; /*!< version number (3). */
uint8_t sigtype; /*!< signature type. */
uint8_t hash_algo; /*!< hash algorithm. */
uint8_t pubkey_algo; /*!< public key algorithm. */
pgpKeyID_t signid; /*!< key ID of signer. */
uint8_t nested;
} * pgpPktOnepass;
/** \ingroup rpmpgp
* 5.5.1. Key Packet Variants
*
* 5.5.1.1. Public Key Packet (Tag 6)
*
* A Public Key packet starts a series of packets that forms an OpenPGP
* key (sometimes called an OpenPGP certificate).
*
* 5.5.1.2. Public Subkey Packet (Tag 14)
*
* A Public Subkey packet (tag 14) has exactly the same format as a
* Public Key packet, but denotes a subkey. One or more subkeys may be
* associated with a top-level key. By convention, the top-level key
* provides signature services, and the subkeys provide encryption
* services.
*
* Note: in PGP 2.6.x, tag 14 was intended to indicate a comment packet.
* This tag was selected for reuse because no previous version of PGP
* ever emitted comment packets but they did properly ignore them.
* Public Subkey packets are ignored by PGP 2.6.x and do not cause it to
* fail, providing a limited degree of backward compatibility.
*
* 5.5.1.3. Secret Key Packet (Tag 5)
*
* A Secret Key packet contains all the information that is found in a
* Public Key packet, including the public key material, but also
* includes the secret key material after all the public key fields.
*
* 5.5.1.4. Secret Subkey Packet (Tag 7)
*
* A Secret Subkey packet (tag 7) is the subkey analog of the Secret Key
* packet, and has exactly the same format.
*
* 5.5.2. Public Key Packet Formats
*
* There are two versions of key-material packets. Version 3 packets
* were first generated by PGP 2.6. Version 2 packets are identical in
* format to Version 3 packets, but are generated by PGP 2.5 or before.
* V2 packets are deprecated and they MUST NOT be generated. PGP 5.0
* introduced version 4 packets, with new fields and semantics. PGP
* 2.6.x will not accept key-material packets with versions greater than
* 3.
*
* OpenPGP implementations SHOULD create keys with version 4 format. An
* implementation MAY generate a V3 key to ensure interoperability with
* old software; note, however, that V4 keys correct some security
* deficiencies in V3 keys. These deficiencies are described below. An
* implementation MUST NOT create a V3 key with a public key algorithm
* other than RSA.
*
* A version 3 public key or public subkey packet contains:
* - A one-octet version number (3).
* - A four-octet number denoting the time that the key was created.
* - A two-octet number denoting the time in days that this key is
* valid. If this number is zero, then it does not expire.
* - A one-octet number denoting the public key algorithm of this key
* - A series of multi-precision integers comprising the key
* material:
* - a multiprecision integer (MPI) of RSA public modulus n;
* - an MPI of RSA public encryption exponent e.
*
* V3 keys SHOULD only be used for backward compatibility because of
* three weaknesses in them. First, it is relatively easy to construct a
* V3 key that has the same key ID as any other key because the key ID
* is simply the low 64 bits of the public modulus. Secondly, because
* the fingerprint of a V3 key hashes the key material, but not its
* length, which increases the opportunity for fingerprint collisions.
* Third, there are minor weaknesses in the MD5 hash algorithm that make
* developers prefer other algorithms. See below for a fuller discussion
* of key IDs and fingerprints.
*
*/
typedef struct pgpPktKeyV3_s {
uint8_t version; /*!< version number (3). */
pgpTime_t time; /*!< time that the key was created. */
uint8_t valid[2]; /*!< time in days that this key is valid. */
uint8_t pubkey_algo; /*!< public key algorithm. */
} * pgpPktKeyV3;
/** \ingroup rpmpgp
* The version 4 format is similar to the version 3 format except for
* the absence of a validity period. This has been moved to the
* signature packet. In addition, fingerprints of version 4 keys are
* calculated differently from version 3 keys, as described in section
* "Enhanced Key Formats."
*
* A version 4 packet contains:
* - A one-octet version number (4).
* - A four-octet number denoting the time that the key was created.
* - A one-octet number denoting the public key algorithm of this key
* - A series of multi-precision integers comprising the key
* material. This algorithm-specific portion is:
*
* Algorithm Specific Fields for RSA public keys:
* - multiprecision integer (MPI) of RSA public modulus n;
* - MPI of RSA public encryption exponent e.
*
* Algorithm Specific Fields for DSA public keys:
* - MPI of DSA prime p;
* - MPI of DSA group order q (q is a prime divisor of p-1);
* - MPI of DSA group generator g;
* - MPI of DSA public key value y (= g**x where x is secret).
*
* Algorithm Specific Fields for Elgamal public keys:
* - MPI of Elgamal prime p;
* - MPI of Elgamal group generator g;
* - MPI of Elgamal public key value y (= g**x where x is
* secret).
*
*/
typedef struct pgpPktKeyV4_s {
uint8_t version; /*!< version number (4). */
pgpTime_t time; /*!< time that the key was created. */
uint8_t pubkey_algo; /*!< public key algorithm. */
} * pgpPktKeyV4;
/** \ingroup rpmpgp
* 5.5.3. Secret Key Packet Formats
*
* The Secret Key and Secret Subkey packets contain all the data of the
* Public Key and Public Subkey packets, with additional algorithm-
* specific secret key data appended, in encrypted form.
*
* The packet contains:
* - A Public Key or Public Subkey packet, as described above
* - One octet indicating string-to-key usage conventions. 0
* indicates that the secret key data is not encrypted. 255
* indicates that a string-to-key specifier is being given. Any
* other value is a symmetric-key encryption algorithm specifier.
* - [Optional] If string-to-key usage octet was 255, a one-octet
* symmetric encryption algorithm.
* - [Optional] If string-to-key usage octet was 255, a string-to-key
* specifier. The length of the string-to-key specifier is implied
* by its type, as described above.
* - [Optional] If secret data is encrypted, eight-octet Initial
* Vector (IV).
* - Encrypted multi-precision integers comprising the secret key
* data. These algorithm-specific fields are as described below.
* - Two-octet checksum of the plaintext of the algorithm-specific
* portion (sum of all octets, mod 65536).
*
* Algorithm Specific Fields for RSA secret keys:
* - multiprecision integer (MPI) of RSA secret exponent d.
* - MPI of RSA secret prime value p.
* - MPI of RSA secret prime value q (p < q).
* - MPI of u, the multiplicative inverse of p, mod q.
*
* Algorithm Specific Fields for DSA secret keys:
* - MPI of DSA secret exponent x.
*
* Algorithm Specific Fields for Elgamal secret keys:
* - MPI of Elgamal secret exponent x.
*
* Secret MPI values can be encrypted using a passphrase. If a string-
* to-key specifier is given, that describes the algorithm for
* converting the passphrase to a key, else a simple MD5 hash of the
* passphrase is used. Implementations SHOULD use a string-to-key
* specifier; the simple hash is for backward compatibility. The cipher
* for encrypting the MPIs is specified in the secret key packet.
*
* Encryption/decryption of the secret data is done in CFB mode using
* the key created from the passphrase and the Initial Vector from the
* packet. A different mode is used with V3 keys (which are only RSA)
* than with other key formats. With V3 keys, the MPI bit count prefix
* (i.e., the first two octets) is not encrypted. Only the MPI non-
* prefix data is encrypted. Furthermore, the CFB state is
* resynchronized at the beginning of each new MPI value, so that the
* CFB block boundary is aligned with the start of the MPI data.
*
* With V4 keys, a simpler method is used. All secret MPI values are
* encrypted in CFB mode, including the MPI bitcount prefix.
*
* The 16-bit checksum that follows the algorithm-specific portion is
* the algebraic sum, mod 65536, of the plaintext of all the algorithm-
* specific octets (including MPI prefix and data). With V3 keys, the
* checksum is stored in the clear. With V4 keys, the checksum is
* encrypted like the algorithm-specific data. This value is used to
* check that the passphrase was correct.
*
*/
typedef union pgpPktKey_u {
struct pgpPktKeyV3_s v3;
struct pgpPktKeyV4_s v4;
} pgpPktKey;
/* \ingroup rpmpgp
* 5.6. Compressed Data Packet (Tag 8)
*
* The Compressed Data packet contains compressed data. Typically, this
* packet is found as the contents of an encrypted packet, or following
* a Signature or One-Pass Signature packet, and contains literal data
* packets.
*
* The body of this packet consists of:
* - One octet that gives the algorithm used to compress the packet.
* - The remainder of the packet is compressed data.
*
* A Compressed Data Packet's body contains an block that compresses
* some set of packets. See section "Packet Composition" for details on
* how messages are formed.
*
* ZIP-compressed packets are compressed with raw RFC 1951 DEFLATE
* blocks. Note that PGP V2.6 uses 13 bits of compression. If an
* implementation uses more bits of compression, PGP V2.6 cannot
* decompress it.
*
* ZLIB-compressed packets are compressed with RFC 1950 ZLIB-style
* blocks.
*/
typedef struct pgpPktCdata_s {
uint8_t compressalgo;
uint8_t data[1];
} pgpPktCdata;
/* \ingroup rpmpgp
* 5.7. Symmetrically Encrypted Data Packet (Tag 9)
*
* The Symmetrically Encrypted Data packet contains data encrypted with
* a symmetric-key algorithm. When it has been decrypted, it will
* typically contain other packets (often literal data packets or
* compressed data packets).
*
* The body of this packet consists of:
* - Encrypted data, the output of the selected symmetric-key cipher
* operating in PGP's variant of Cipher Feedback (CFB) mode.
*
* The symmetric cipher used may be specified in an Public-Key or
* Symmetric-Key Encrypted Session Key packet that precedes the
* Symmetrically Encrypted Data Packet. In that case, the cipher
* algorithm octet is prefixed to the session key before it is
* encrypted. If no packets of these types precede the encrypted data,
* the IDEA algorithm is used with the session key calculated as the MD5
* hash of the passphrase.
*
* The data is encrypted in CFB mode, with a CFB shift size equal to the
* cipher's block size. The Initial Vector (IV) is specified as all
* zeros. Instead of using an IV, OpenPGP prefixes a 10-octet string to
* the data before it is encrypted. The first eight octets are random,
* and the 9th and 10th octets are copies of the 7th and 8th octets,
* respectively. After encrypting the first 10 octets, the CFB state is
* resynchronized if the cipher block size is 8 octets or less. The
* last 8 octets of ciphertext are passed through the cipher and the
* block boundary is reset.
*
* The repetition of 16 bits in the 80 bits of random data prefixed to
* the message allows the receiver to immediately check whether the
* session key is incorrect.
*/
typedef struct pgpPktEdata_s {
uint8_t data[1];
} pgpPktEdata;
/* \ingroup rpmpgp
* 5.8. Marker Packet (Obsolete Literal Packet) (Tag 10)
*
* An experimental version of PGP used this packet as the Literal
* packet, but no released version of PGP generated Literal packets with
* this tag. With PGP 5.x, this packet has been re-assigned and is
* reserved for use as the Marker packet.
*
* The body of this packet consists of:
* - The three octets 0x50, 0x47, 0x50 (which spell "PGP" in UTF-8).
*
* Such a packet MUST be ignored when received. It may be placed at the
* beginning of a message that uses features not available in PGP 2.6.x
* in order to cause that version to report that newer software is
* necessary to process the message.
*/
/* \ingroup rpmpgp
* 5.9. Literal Data Packet (Tag 11)
*
* A Literal Data packet contains the body of a message; data that is
* not to be further interpreted.
*
* The body of this packet consists of:
* - A one-octet field that describes how the data is formatted.
*
* If it is a 'b' (0x62), then the literal packet contains binary data.
* If it is a 't' (0x74), then it contains text data, and thus may need
* line ends converted to local form, or other text-mode changes. RFC
* 1991 also defined a value of 'l' as a 'local' mode for machine-local
* conversions. This use is now deprecated.
* - File name as a string (one-octet length, followed by file name),
* if the encrypted data should be saved as a file.
*
* If the special name "_CONSOLE" is used, the message is considered to
* be "for your eyes only". This advises that the message data is
* unusually sensitive, and the receiving program should process it more
* carefully, perhaps avoiding storing the received data to disk, for
* example.
* - A four-octet number that indicates the modification date of the
* file, or the creation time of the packet, or a zero that
* indicates the present time.
* - The remainder of the packet is literal data.
*
* Text data is stored with <CR><LF> text endings (i.e. network-normal
* line endings). These should be converted to native line endings by
* the receiving software.
*/
typedef struct pgpPktLdata_s {
uint8_t format;
uint8_t filenamelen;
uint8_t filename[1];
} pgpPktLdata;
/* \ingroup rpmpgp
* 5.10. Trust Packet (Tag 12)
*
* The Trust packet is used only within keyrings and is not normally
* exported. Trust packets contain data that record the user's
* specifications of which key holders are trustworthy introducers,
* along with other information that implementing software uses for
* trust information.
*
* Trust packets SHOULD NOT be emitted to output streams that are
* transferred to other users, and they SHOULD be ignored on any input
* other than local keyring files.
*/
typedef struct pgpPktTrust_s {
uint8_t flag;
} pgpPktTrust;
/* \ingroup rpmpgp
* 5.11. User ID Packet (Tag 13)
*
* A User ID packet consists of data that is intended to represent the
* name and email address of the key holder. By convention, it includes
* an RFC 822 mail name, but there are no restrictions on its content.
* The packet length in the header specifies the length of the user id.
* If it is text, it is encoded in UTF-8.
*
*/
typedef struct pgpPktUid_s {
uint8_t userid[1];
} pgpPktUid;
/** \ingroup rpmpgp
*/
union pgpPktPre_u {
pgpPktPubkey pubkey; /*!< 5.1. Public-Key Encrypted Session Key */
pgpPktSig sig; /*!< 5.2. Signature */
pgpPktSymkey symkey; /*!< 5.3. Symmetric-Key Encrypted Session-Key */
pgpPktOnepass onepass; /*!< 5.4. One-Pass Signature */
pgpPktKey key; /*!< 5.5. Key Material */
pgpPktCdata cdata; /*!< 5.6. Compressed Data */
pgpPktEdata edata; /*!< 5.7. Symmetrically Encrypted Data */
/*!< 5.8. Marker (obsolete) */
pgpPktLdata ldata; /*!< 5.9. Literal Data */
pgpPktTrust tdata; /*!< 5.10. Trust */
pgpPktUid uid; /*!< 5.11. User ID */
};
/** \ingroup rpmpgp
*/
typedef enum pgpArmor_e {
PGPARMOR_ERR_CRC_CHECK = -7,
PGPARMOR_ERR_BODY_DECODE = -6,
PGPARMOR_ERR_CRC_DECODE = -5,
PGPARMOR_ERR_NO_END_PGP = -4,
PGPARMOR_ERR_UNKNOWN_PREAMBLE_TAG = -3,
PGPARMOR_ERR_UNKNOWN_ARMOR_TYPE = -2,
PGPARMOR_ERR_NO_BEGIN_PGP = -1,
#define PGPARMOR_ERROR PGPARMOR_ERR_NO_BEGIN_PGP
PGPARMOR_NONE = 0,
PGPARMOR_MESSAGE = 1, /*!< MESSAGE */
PGPARMOR_PUBKEY = 2, /*!< PUBLIC KEY BLOCK */
PGPARMOR_SIGNATURE = 3, /*!< SIGNATURE */
PGPARMOR_SIGNED_MESSAGE = 4, /*!< SIGNED MESSAGE */
PGPARMOR_FILE = 5, /*!< ARMORED FILE */
PGPARMOR_PRIVKEY = 6, /*!< PRIVATE KEY BLOCK */
PGPARMOR_SECKEY = 7 /*!< SECRET KEY BLOCK */
} pgpArmor;
/** \ingroup rpmpgp
*/
typedef enum pgpArmorKey_e {
PGPARMORKEY_VERSION = 1, /*!< Version: */
PGPARMORKEY_COMMENT = 2, /*!< Comment: */
PGPARMORKEY_MESSAGEID = 3, /*!< MessageID: */
PGPARMORKEY_HASH = 4, /*!< Hash: */
PGPARMORKEY_CHARSET = 5 /*!< Charset: */
} pgpArmorKey;
typedef enum pgpValType_e {
PGPVAL_TAG = 1,
PGPVAL_ARMORBLOCK = 2,
PGPVAL_ARMORKEY = 3,
PGPVAL_SIGTYPE = 4,
PGPVAL_SUBTYPE = 5,
PGPVAL_PUBKEYALGO = 6,
PGPVAL_SYMKEYALGO = 7,
PGPVAL_COMPRESSALGO = 8,
PGPVAL_HASHALGO = 9,
PGPVAL_SERVERPREFS = 10,
} pgpValType;
/** \ingroup rpmpgp
* Bit(s) to control digest operation.
*/
enum rpmDigestFlags_e {
RPMDIGEST_NONE = 0
};
typedef rpmFlags rpmDigestFlags;
/** \ingroup rpmpgp
* Return string representation of am OpenPGP value.
* @param type type of value
* @param val byte value to lookup
* @return string value of byte
*/
const char * pgpValString(pgpValType type, uint8_t val);
/** \ingroup rpmpgp
* Return (native-endian) integer from big-endian representation.
* @param s pointer to big-endian integer
* @param nbytes no. of bytes
* @return native-endian integer
*/
static inline
unsigned int pgpGrab(const uint8_t *s, size_t nbytes)
{
size_t i = 0;
size_t nb = (nbytes <= sizeof(i) ? nbytes : sizeof(i));
while (nb--)
i = (i << 8) | *s++;
return i;
}
/** \ingroup rpmpgp
* Return hex formatted representation of bytes.
* @param p bytes
* @param plen no. of bytes
* @return hex formatted string (malloc'ed)
*/
char * pgpHexStr(const uint8_t *p, size_t plen);
/** \ingroup rpmpgp
* Calculate OpenPGP public key fingerprint.
* @param pkt OpenPGP packet (i.e. PGPTAG_PUBLIC_KEY)
* @param pktlen OpenPGP packet length (no. of bytes)
* @retval fp public key fingerprint
* @retval fplen public key fingerprint length
* @return 0 on success, else -1
*/
int pgpPubkeyFingerprint(const uint8_t * pkt, size_t pktlen,
uint8_t **fp, size_t *fplen);
/** \ingroup rpmpgp
* Calculate OpenPGP public key Key ID
* @param pkt OpenPGP packet (i.e. PGPTAG_PUBLIC_KEY)
* @param pktlen OpenPGP packet length (no. of bytes)
* @retval keyid public key Key ID
* @return 0 on success, else -1
*/
int pgpPubkeyKeyID(const uint8_t * pkt, size_t pktlen, pgpKeyID_t keyid);
/** \ingroup rpmpgp
* Parse a OpenPGP packet(s).
* @param pkts OpenPGP packet(s)
* @param pktlen OpenPGP packet(s) length (no. of bytes)
* @param pkttype Expected packet type (signature/key) or 0 for any
* @retval ret signature/pubkey packet parameters on success (alloced)
* @return -1 on error, 0 on success
*/
int pgpPrtParams(const uint8_t *pkts, size_t pktlen, unsigned int pkttype,
pgpDigParams * ret);
/** \ingroup rpmpgp
* Parse subkey parameters from OpenPGP packet(s).
* @param pkts OpenPGP packet(s)
* @param pktlen OpenPGP packet(s) length (no. of bytes)
* @param mainkey parameters of main key
* @param subkeys array of subkey parameters (alloced)
* @param subkeysCount count of subkeys
* @return -1 on error, 0 on success
*/
int pgpPrtParamsSubkeys(const uint8_t *pkts, size_t pktlen,
pgpDigParams mainkey, pgpDigParams **subkeys,
int *subkeysCount);
/** \ingroup rpmpgp
* Print/parse a OpenPGP packet(s).
* @param pkts OpenPGP packet(s)
* @param pktlen OpenPGP packet(s) length (no. of bytes)
* @retval dig parsed output of signature/pubkey packet parameters
* @param printing should packets be printed?
* @return -1 on error, 0 on success
*/
int pgpPrtPkts(const uint8_t *pkts, size_t pktlen, pgpDig dig, int printing);
/** \ingroup rpmpgp
* Parse armored OpenPGP packets from a file.
* @param fn file name
* @retval pkt dearmored OpenPGP packet(s) (malloced)
* @retval pktlen dearmored OpenPGP packet(s) length in bytes
* @return type of armor found
*/
pgpArmor pgpReadPkts(const char * fn, uint8_t ** pkt, size_t * pktlen);
/** \ingroup rpmpgp
* Parse armored OpenPGP packets from memory.
* @param armor armored OpenPGP packet string
* @retval pkt dearmored OpenPGP packet(s) (malloced)
* @retval pktlen dearmored OpenPGP packet(s) length in bytes
* @return type of armor found
*/
pgpArmor pgpParsePkts(const char *armor, uint8_t ** pkt, size_t * pktlen);
/** \ingroup rpmpgp
* Return a length of the first public key certificate in a buffer given
* by pkts that contains one or more certificates. A public key certificate
* consits of packets like Public key packet, User ID packet and so on.
* In a buffer every certificate starts with Public key packet and it ends
* with the start of the next certificate or with the end of the buffer.
*
* @param pkts pointer to a buffer with certificates
* @param pktslen length of the buffer with certificates
* @param certlen length of the first certificate in the buffer
* @return 0 on success
*/
int pgpPubKeyCertLen(const uint8_t *pkts, size_t pktslen, size_t *certlen);
/** \ingroup rpmpgp
* Wrap a OpenPGP packets in ascii armor for transport.
* @param atype type of armor
* @param s binary pkt data
* @param ns binary pkt data length
* @return formatted string
*/
char * pgpArmorWrap(int atype, const unsigned char * s, size_t ns);
/** \ingroup rpmpgp
* Create a container for parsed OpenPGP packet(s).
* @return container
*/
pgpDig pgpNewDig(void);
/** \ingroup rpmpgp
* Release (malloc'd) data from container.
* @param dig container
*/
void pgpCleanDig(pgpDig dig);
/** \ingroup rpmpgp
* Destroy a container for parsed OpenPGP packet(s).
* @param dig container
* @return NULL always
*/
pgpDig pgpFreeDig(pgpDig dig);
/** \ingroup rpmpgp
* Retrieve parameters for parsed OpenPGP packet(s).
* @param dig container
* @param pkttype type of params to retrieve (signature / pubkey)
* @return pointer to OpenPGP parameters, NULL on error/not found
*/
pgpDigParams pgpDigGetParams(pgpDig dig, unsigned int pkttype);
/** \ingroup rpmpgp
* Compare OpenPGP packet parameters
* param p1 1st parameter container
* param p2 2nd parameter container
* return 1 if the parameters differ, 0 otherwise
*/
int pgpDigParamsCmp(pgpDigParams p1, pgpDigParams p2);
/** \ingroup rpmpgp
* Retrieve OpenPGP algorithm parameters
* param digp parameter container
* param algotype PGPVAL_HASHALGO / PGPVAL_PUBKEYALGO
* return algorithm value, 0 on error
*/
unsigned int pgpDigParamsAlgo(pgpDigParams digp, unsigned int algotype);
/** \ingroup rpmpgp
* Destroy parsed OpenPGP packet parameter(s).
* @param digp parameter container
* @return NULL always
*/
pgpDigParams pgpDigParamsFree(pgpDigParams digp);
/** \ingroup rpmpgp
* Verify a PGP signature.
* @param key public key
* @param sig signature
* @param hashctx digest context
* @return RPMRC_OK on success
*/
rpmRC pgpVerifySignature(pgpDigParams key, pgpDigParams sig, DIGEST_CTX hashctx);
/** \ingroup rpmpgp
* Verify a PGP signature.
* @deprecated use pgpVerifySignature() instead
*
* @param dig container
* @param hashctx digest context
* @return RPMRC_OK on success
*/
rpmRC pgpVerifySig(pgpDig dig, DIGEST_CTX hashctx);
/** \ingroup rpmpgp
* Return a string identification of a PGP signature/pubkey.
* @param digp signature/pubkey container
* @return string describing the item and parameters
*/
char *pgpIdentItem(pgpDigParams digp);
/** \ingroup rpmpgp
* Perform cryptography initialization.
* It must be called before any cryptography can be used within rpm.
* It's not normally necessary to call it directly as it's called in
* general rpm initialization routines.
* @return 0 on success, -1 on failure
*/
int rpmInitCrypto(void);
/** \ingroup rpmpgp
* Shutdown cryptography
*/
int rpmFreeCrypto(void);
/** \ingroup rpmpgp
* Duplicate a digest context.
* @param octx existing digest context
* @return duplicated digest context
*/
DIGEST_CTX rpmDigestDup(DIGEST_CTX octx);
/** \ingroup rpmpgp
* Obtain digest length in bytes.
* @param hashalgo type of digest
* @return digest length, zero on invalid algorithm
*/
size_t rpmDigestLength(int hashalgo);
/** \ingroup rpmpgp
* Initialize digest.
* Set bit count to 0 and buffer to mysterious initialization constants.
* @param hashalgo type of digest
* @param flags bit(s) to control digest operation
* @return digest context
*/
DIGEST_CTX rpmDigestInit(int hashalgo, rpmDigestFlags flags);
/** \ingroup rpmpgp
* Update context with next plain text buffer.
* @param ctx digest context
* @param data next data buffer
* @param len no. bytes of data
* @return 0 on success
*/
int rpmDigestUpdate(DIGEST_CTX ctx, const void * data, size_t len);
/** \ingroup rpmpgp
* Return digest and destroy context.
* Final wrapup - pad to 64-byte boundary with the bit pattern
* 1 0* (64-bit count of bits processed, MSB-first)
*
* @param ctx digest context
* @retval datap address of returned digest
* @retval lenp address of digest length
* @param asAscii return digest as ascii string?
* @return 0 on success
*/
int rpmDigestFinal(DIGEST_CTX ctx,
void ** datap,
size_t * lenp, int asAscii);
/** \ingroup rpmpgp
* Create a new digest bundle.
* @return New digest bundle
*/
rpmDigestBundle rpmDigestBundleNew(void);
/** \ingroup rpmpgp
* Free a digest bundle and all contained digest contexts.
* @param bundle digest bundle
* @return NULL always
*/
rpmDigestBundle rpmDigestBundleFree(rpmDigestBundle bundle);
/** \ingroup rpmpgp
* Add a new type of digest to a bundle. Same as calling
* rpmDigestBundleAddID() with algo == id value.
* @param bundle digest bundle
* @param algo type of digest
* @param flags bit(s) to control digest operation
* @return 0 on success
*/
int rpmDigestBundleAdd(rpmDigestBundle bundle, int algo,
rpmDigestFlags flags);
/** \ingroup rpmpgp
* Add a new type of digest to a bundle.
* @param bundle digest bundle
* @param algo type of digest
* @param id id of digest (arbitrary, must be > 0)
* @param flags bit(s) to control digest operation
* @return 0 on success
*/
int rpmDigestBundleAddID(rpmDigestBundle bundle, int algo, int id,
rpmDigestFlags flags);
/** \ingroup rpmpgp
* Update contexts within bundle with next plain text buffer.
* @param bundle digest bundle
* @param data next data buffer
* @param len no. bytes of data
* @return 0 on success
*/
int rpmDigestBundleUpdate(rpmDigestBundle bundle, const void *data, size_t len);
/** \ingroup rpmpgp
* Return digest from a bundle and destroy context, see rpmDigestFinal().
*
* @param bundle digest bundle
* @param id id of digest to return
* @retval datap address of returned digest
* @retval lenp address of digest length
* @param asAscii return digest as ascii string?
* @return 0 on success
*/
int rpmDigestBundleFinal(rpmDigestBundle bundle, int id,
void ** datap, size_t * lenp, int asAscii);
/** \ingroup rpmpgp
* Duplicate a digest context from a bundle.
* @param bundle digest bundle
* @param id id of digest to dup
* @return duplicated digest context
*/
DIGEST_CTX rpmDigestBundleDupCtx(rpmDigestBundle bundle, int id);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMPGP */
PK vFZ��2jl3 l3 rpmcli.hnu �[��� #ifndef H_RPMCLI
#define H_RPMCLI
/** \ingroup rpmcli rpmbuild
* \file lib/rpmcli.h
*
* Parsing RPM command line arguments
*/
#include <popt.h>
#include <rpm/rpmlib.h>
#include <rpm/rpmurl.h>
#include <rpm/rpmmacro.h>
#include <rpm/rpmcallback.h>
#include <rpm/rpmts.h>
#include <rpm/rpmfi.h>
#include <rpm/rpmvf.h>
#include <rpm/argv.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmcli
* Popt option table for options shared by all modes and executables.
*/
extern struct poptOption rpmcliAllPoptTable[];
extern const char * rpmcliPipeOutput;
extern const char * rpmcliRcfile;
extern const char * rpmcliRootDir;
/** \ingroup rpmcli
* Initialize most everything needed by an rpm CLI executable context.
* @param argc no. of args
* @param argv arg array
* @param optionsTable popt option table
* @return popt context (or NULL)
*/
poptContext
rpmcliInit(int argc, char *const argv[], struct poptOption * optionsTable);
/** \ingroup rpmcli
* Make sure that rpm configuration has been read.
* @warning Options like --rcfile and --verbose must precede callers option.
*/
void rpmcliConfigured(void);
/** \ingroup rpmcli
* Destroy most everything needed by an rpm CLI executable context.
* @param optCon popt context
* @return NULL always
*/
poptContext
rpmcliFini(poptContext optCon);
/**
* Common/global popt tokens used for command line option tables.
*/
#define RPMCLI_POPT_NODEPS -1025
#define RPMCLI_POPT_FORCE -1026
#define RPMCLI_POPT_NOMD5 -1027
#define RPMCLI_POPT_NOFILEDIGEST -1027 /* same as obsolete RPMCLI_POPT_NOMD5 */
#define RPMCLI_POPT_NOSCRIPTS -1028
#define RPMCLI_POPT_NOSIGNATURE -1029
#define RPMCLI_POPT_NODIGEST -1030
#define RPMCLI_POPT_NOHDRCHK -1031
#define RPMCLI_POPT_NOCONTEXTS -1032
#define RPMCLI_POPT_NOCAPS -1033
#define RPMCLI_POPT_TARGETPLATFORM -1034
/* ==================================================================== */
/** \name RPMQV */
/** \ingroup rpmcli
* Query/Verify argument qualifiers.
* @todo Reassign to tag values.
*/
enum rpmQVSources_e {
RPMQV_PACKAGE = 0, /*!< ... from package name db search. */
RPMQV_PATH, /*!< ... from file path db search. */
RPMQV_ALL, /*!< ... from each installed package. */
RPMQV_RPM, /*!< ... from reading binary rpm package. */
RPMQV_GROUP, /*!< ... from group db search. */
RPMQV_WHATPROVIDES, /*!< ... from provides db search. */
RPMQV_WHATREQUIRES, /*!< ... from requires db search. */
RPMQV_TRIGGEREDBY, /*!< ... from trigger db search. */
RPMQV_DBOFFSET, /*!< ... from database header instance. */
RPMQV_SPECRPMS, /*!< ... from spec file binaries (query only). */
RPMQV_SPECFILE = RPMQV_SPECRPMS, /*!< ... backwards compatibility */
RPMQV_PKGID, /*!< ... from package id (header+payload MD5). */
RPMQV_HDRID, /*!< ... from header id (immutable header SHA1). */
RPMQV_TID, /*!< ... from install transaction id (time stamp). */
RPMQV_SPECSRPM, /*!< ... from spec file source (query only). */
RPMQV_WHATRECOMMENDS, /*!< ... from recommends db search. */
RPMQV_WHATSUGGESTS, /*!< ... from suggests db search. */
RPMQV_WHATSUPPLEMENTS, /*!< ... from supplements db search. */
RPMQV_WHATENHANCES, /*!< ... from enhances db search. */
RPMQV_SPECBUILTRPMS, /*!< ... from pkgs which would be built from spec */
RPMQV_WHATOBSOLETES, /*!< ... from obsoletes db search. */
RPMQV_WHATCONFLICTS, /*!< ... from conflicts db search. */
RPMQV_PATH_ALL, /*!< ... from file path db search (all states). */
};
typedef rpmFlags rpmQVSources;
/** \ingroup rpmcli
* Bit(s) to control rpmQuery() operation, stored in qva_flags.
* @todo Merge rpmQueryFlags, rpmVerifyFlags, and rpmVerifyAttrs?.
*/
enum rpmQueryFlags_e {
QUERY_FOR_DEFAULT = 0, /*!< */
QUERY_MD5 = (1 << 0), /*!< from --nomd5 */
QUERY_FILEDIGEST = (1 << 0), /*!< from --nofiledigest, same as --nomd5 */
QUERY_SIZE = (1 << 1), /*!< from --nosize */
QUERY_LINKTO = (1 << 2), /*!< from --nolink */
QUERY_USER = (1 << 3), /*!< from --nouser) */
QUERY_GROUP = (1 << 4), /*!< from --nogroup) */
QUERY_MTIME = (1 << 5), /*!< from --nomtime) */
QUERY_MODE = (1 << 6), /*!< from --nomode) */
QUERY_RDEV = (1 << 7), /*!< from --nodev */
/* bits 8-14 unused, reserved for rpmVerifyAttrs */
QUERY_CONTEXTS = (1 << 15), /*!< verify: from --nocontexts */
QUERY_FILES = (1 << 16), /*!< verify: from --nofiles */
QUERY_DEPS = (1 << 17), /*!< verify: from --nodeps */
QUERY_SCRIPT = (1 << 18), /*!< verify: from --noscripts */
QUERY_DIGEST = (1 << 19), /*!< verify: from --nodigest */
QUERY_SIGNATURE = (1 << 20), /*!< verify: from --nosignature */
QUERY_PATCHES = (1 << 21), /*!< verify: from --nopatches */
QUERY_HDRCHK = (1 << 22), /*!< verify: from --nohdrchk */
QUERY_FOR_LIST = (1 << 23), /*!< query: from --list */
QUERY_FOR_STATE = (1 << 24), /*!< query: from --state */
QUERY_FOR_DOCS = (1 << 25), /*!< query: from --docfiles */
QUERY_FOR_CONFIG = (1 << 26), /*!< query: from --configfiles */
QUERY_FOR_DUMPFILES = (1 << 27), /*!< query: from --dump */
QUERY_FOR_LICENSE = (1 << 28), /*!< query: from --licensefiles */
QUERY_FOR_ARTIFACT = (1 << 29), /*!< query: from --artifacts */
};
typedef rpmFlags rpmQueryFlags;
#define _QUERY_FOR_BITS \
(QUERY_FOR_LIST|QUERY_FOR_STATE|QUERY_FOR_DOCS|QUERY_FOR_CONFIG|\
QUERY_FOR_LICENSE|QUERY_FOR_DUMPFILES)
/** \ingroup rpmcli
* Bit(s) from common command line options.
*/
extern rpmQueryFlags rpmcliQueryFlags;
extern rpmVSFlags rpmcliVSFlags;
extern int rpmcliVfyLevelMask;
/** \ingroup rpmcli
*/
typedef struct rpmQVKArguments_s * QVA_t;
/** \ingroup rpmcli
* Function to display iterator matches.
*
* @param qva parsed query/verify options
* @param ts transaction set
* @param h header to use for query/verify
* @return 0 on success
*/
typedef int (*QVF_t) (QVA_t qva, rpmts ts, Header h);
/** \ingroup rpmcli
* Function to query spec file.
*
* @param ts transaction set
* @param qva parsed query/verify options
* @param arg query argument
* @return 0 on success
*/
typedef int (*QSpecF_t) (rpmts ts, QVA_t qva, const char * arg);
/** \ingroup rpmcli
* Describe query/verify/signature command line operation.
*/
struct rpmQVKArguments_s {
rpmQVSources qva_source; /*!< Identify CLI arg type. */
int qva_sourceCount;/*!< Exclusive option check (>1 is error). */
rpmQueryFlags qva_flags; /*!< Bit(s) to control operation. */
rpmfileAttrs qva_fflags; /*!< Bit(s) to filter on attribute. */
QVF_t qva_showPackage; /*!< Function to display iterator matches. */
QSpecF_t qva_specQuery; /*!< Function to query spec file. */
char * qva_queryFormat; /*!< Format for headerFormat(). */
char qva_mode;
/*!<
- 'q' from --query, -q
- 'Q' from --querytags
- 'V' from --verify, -V
- 'I' from --import
- 'K' from --checksig, -K
*/
};
/** \ingroup rpmcli
*/
extern struct rpmQVKArguments_s rpmQVKArgs;
/** \ingroup rpmcli
*/
extern struct poptOption rpmQVSourcePoptTable[];
/** \ingroup rpmcli
*/
extern struct poptOption rpmQueryPoptTable[];
/** \ingroup rpmcli
*/
extern struct poptOption rpmVerifyPoptTable[];
/** \ingroup rpmcli
* Display list of tags that can be used in --queryformat.
* @param fp file handle to use for display
*/
void rpmDisplayQueryTags(FILE * fp);
/** \ingroup rpmcli
* Display results of package query.
* @todo Devise a meaningful return code.
* @param qva parsed query/verify options
* @param ts transaction set
* @param h header to use for query
* @return 0 always
*/
int showQueryPackage(QVA_t qva, rpmts ts, Header h);
/** \ingroup rpmcli
* Iterate over query/verify arg list.
* @param ts transaction set
* @param qva parsed query/verify options
* @param argv query argument(s) (or NULL)
* @return 0 on success, else no. of failures
*/
int rpmcliArgIter(rpmts ts, QVA_t qva, ARGV_const_t argv);
/** \ingroup rpmcli
* Display package information.
* @todo hack: RPMQV_ALL can pass char ** arglist = NULL, not char * arg. Union?
* @param ts transaction set
* @param qva parsed query/verify options
* @param argv query argument(s) (or NULL)
* @return 0 on success, else no. of failures
*/
int rpmcliQuery(rpmts ts, QVA_t qva, ARGV_const_t argv);
/** \ingroup rpmcli
* Display results of package verify.
* @param qva parsed query/verify options
* @param ts transaction set
* @param h header to use for verify
* @return result of last non-zero verify return
*/
int showVerifyPackage(QVA_t qva, rpmts ts, Header h);
/**
* Check package and header signatures.
* @param qva unused
* @param ts transaction set
* @param fd package file handle
* @param fn package file name
* @return 0 on success, 1 on failure
*/
int rpmVerifySignatures(QVA_t qva, rpmts ts, FD_t fd, const char * fn);
/** \ingroup rpmcli
* Verify package install.
* @todo hack: RPMQV_ALL can pass char ** arglist = NULL, not char * arg. Union?
* @param ts transaction set
* @param qva parsed query/verify options
* @param argv verify argument(s) (or NULL)
* @return 0 on success, else no. of failures
*/
int rpmcliVerify(rpmts ts, QVA_t qva, ARGV_const_t argv);
/* ==================================================================== */
/** \name RPMEIU */
/* --- install/upgrade/erase modes */
/** \ingroup rpmcli
* Bit(s) to control rpmInstall() operation.
*/
enum rpmInstallFlags_e {
INSTALL_NONE = 0,
INSTALL_PERCENT = (1 << 0), /*!< from --percent */
INSTALL_HASH = (1 << 1), /*!< from --hash */
INSTALL_NODEPS = (1 << 2), /*!< from --nodeps */
INSTALL_NOORDER = (1 << 3), /*!< from --noorder */
INSTALL_LABEL = (1 << 4), /*!< from --verbose (notify) */
INSTALL_UPGRADE = (1 << 5), /*!< from --upgrade */
INSTALL_FRESHEN = (1 << 6), /*!< from --freshen */
INSTALL_INSTALL = (1 << 7), /*!< from --install */
INSTALL_ERASE = (1 << 8), /*!< from --erase */
INSTALL_ALLMATCHES = (1 << 9), /*!< from --allmatches */
INSTALL_REINSTALL = (1 << 10), /*!< from --reinstall */
};
typedef rpmFlags rpmInstallFlags;
/** \ingroup rpmcli
* Bit(s) to control rpmErase() operation.
*/
#define UNINSTALL_NONE INSTALL_NONE
#define UNINSTALL_NODEPS INSTALL_NODEPS
#define UNINSTALL_ALLMATCHES INSTALL_ALLMATCHES
/** \ingroup rpmcli
* The rpm CLI generic transaction callback handler.
* @todo Remove headerFormat() from the progress callback.
* @deprecated Transaction callback arguments need to change, so don't rely on
* this routine in the rpmcli API.
*
* @param arg per-callback private data (e.g. an rpm header)
* @param what callback identifier
* @param amount per-callback progress info
* @param total per-callback progress info
* @param key opaque header key (e.g. file name or PyObject)
* @param data private data (e.g. rpmInstallInterfaceFlags)
* @return per-callback data (e.g. an opened FD_t)
*/
void * rpmShowProgress(const void * arg,
const rpmCallbackType what,
const rpm_loff_t amount,
const rpm_loff_t total,
fnpyKey key,
void * data);
/** \ingroup rpmcli
* Install source rpm package.
* @param ts transaction set
* @param arg source rpm file name
* @retval *specFilePtr (installed) spec file name
* @retval *cookie
* @return 0 on success
*/
int rpmInstallSource(rpmts ts, const char * arg,
char ** specFilePtr,
char ** cookie);
/** \ingroup rpmcli
* Describe database command line requests.
*/
struct rpmInstallArguments_s {
rpmtransFlags transFlags;
rpmprobFilterFlags probFilter;
rpmInstallFlags installInterfaceFlags;
int numRelocations;
int noDeps;
int incldocs;
rpmRelocation * relocations;
char * prefix;
};
/** \ingroup rpmcli
* Install/upgrade/freshen/reinstall binary rpm package.
* @param ts transaction set
* @param ia mode flags and parameters
* @param fileArgv array of package file names (NULL terminated)
* @return 0 on success
*
* @todo fileArgv is modified on errors, should be ARGV_const_t
*/
int rpmInstall(rpmts ts, struct rpmInstallArguments_s * ia, ARGV_t fileArgv);
/** \ingroup rpmcli
* Erase binary rpm package.
* @param ts transaction set
* @param ia control args/bits
* @param argv array of package file names (NULL terminated)
* @return 0 on success
*/
int rpmErase(rpmts ts, struct rpmInstallArguments_s * ia, ARGV_const_t argv);
/** \ingroup rpmcli
*/
extern struct rpmInstallArguments_s rpmIArgs;
/** \ingroup rpmcli
*/
extern struct poptOption rpmInstallPoptTable[];
/* ==================================================================== */
/** \name RPMK */
/** Import public key(s) to rpm keyring
* @param ts transaction set
* @param argv array of pubkey path arguments (NULL terminated)
* @return 0 on success
*/
int rpmcliImportPubkeys(rpmts ts, ARGV_const_t argv);
/** \ingroup rpmcli
* Verify package signatures
* @param ts transaction set
* @param argv array of package path arguments (NULL terminated)
* @return 0 on success
*/
int rpmcliVerifySignatures(rpmts ts, ARGV_const_t argv);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMCLI */
PK vFZCn�B� � rpmstrpool.hnu �[��� #ifndef _RPMSTRPOOL_H
#define _RPMSTRPOOL_H
/** \ingroup rpmstrpool
* \file rpmio/rpmstrpool.h
*
* String pools manipulation helper functions
*
*/
#include <rpm/rpmtypes.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmstrpool
* Create a new, empty string pool.
* @return new string pool
*/
rpmstrPool rpmstrPoolCreate(void);
/** \ingroup rpmstrpool
* Free a string pool and its contents. While other references exist,
* this only decrements the reference count.
* @param pool string pool
* @return NULL always
*/
rpmstrPool rpmstrPoolFree(rpmstrPool pool);
/** \ingroup rpmstrpool
* Reference a string pool
* @param pool string pool
* @return new string pool reference
*/
rpmstrPool rpmstrPoolLink(rpmstrPool pool);
/** \ingroup rpmstrpool
* Freeze a string pool: new strings cannot be added to a frozen pool.
* If keephash is 0, memory usage is minimized but string -> id lookups
* are no longer possible and unfreezing is an expensive operation.
* Id -> string lookups are always possible on a frozen pool too.
* @param pool string pool
* @param keephash should string -> id hash be kept around?
*/
void rpmstrPoolFreeze(rpmstrPool pool, int keephash);
/** \ingroup rpmstrpool
* Unfreeze a string pool to allow new additions again.
* If keephash was not specified on freezing, this requires rehashing
* the entire pool contents.
* @param pool string pool
*/
void rpmstrPoolUnfreeze(rpmstrPool pool);
/** \ingroup rpmstrpool
* Look up the id of a string. If create is specified the string is
* added to the pool if it does not already exist. Creation can only
* fail if the pool is in frozen state.
* @param pool string pool
* @param s \0-terminated string to look up
* @param create should an id be created if not already present?
* @return id of the string or 0 for not found
*/
rpmsid rpmstrPoolId(rpmstrPool pool, const char *s, int create);
/** \ingroup rpmstrpool
* Look up the id of a string with predetermined length. The string does
* not have to be \0-terminated. If create is specified the string is
* added to the pool if it does not already exist. Creation can only
* fail if the pool is in frozen state.
* @param pool string pool
* @param s string to look up
* @param slen number of characters from s to consider
* @param create should an id be created if not already present?
* @return id of the string or 0 for not found
*/
rpmsid rpmstrPoolIdn(rpmstrPool pool, const char *s, size_t slen, int create);
/** \ingroup rpmstrpool
* Look up a string by its pool id.
* @param pool string pool
* @param sid pool id of a string
* @return pointer to the string or NULL for invalid id
*/
const char * rpmstrPoolStr(rpmstrPool pool, rpmsid sid);
/** \ingroup rpmstrpool
* Return length of a string by its pool id. The result is equal to
* calling strlen() on a string retrieved through rpmstrPoolStr(), but
* the pool might be able to optimize the calculation.
* @param pool string pool
* @param sid pool id of a string
* @return length of the string, 0 for invalid pool or id
*/
size_t rpmstrPoolStrlen(rpmstrPool pool, rpmsid sid);
/** \ingroup rpmstrpool
* Compare two strings for equality by their ids. The result is equal to
* calling rstreq() on two strings retrieved through rpmstrPoolStr() but
* when the id's are within the same pool, this runs in constant time.
* @param poolA string pool of the first string
* @param sidA pool id of the first string
* @param poolB string pool of the second string
* @param sidB pool id of the second string
* @return 1 if strings are equal, 0 otherwise
*/
int rpmstrPoolStreq(rpmstrPool poolA, rpmsid sidA,
rpmstrPool poolB, rpmsid sidB);
/** \ingroup rpmstrpool
* Return the number of strings stored in the pool. This number is
* also the highest legal id for the pool.
* @param pool string pool
* @return number of strings in the pool
*/
rpmsid rpmstrPoolNumStr(rpmstrPool pool);
#ifdef __cplusplus
}
#endif
#endif /* _RPMSIDPOOL_H */
PK vFZI�ׁ. . rpmps.hnu �[��� #ifndef H_RPMPS
#define H_RPMPS
/** \ingroup rpmps
* \file lib/rpmps.h
* Structures and prototypes used for an "rpmps" problem set.
*/
#include <stdio.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmprob.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmps
* Problem set iterator
*/
typedef struct rpmpsi_s * rpmpsi;
/** \ingroup rpmps
* Reference a problem set instance.
* @param ps transaction set
* @return new transaction set reference
*/
rpmps rpmpsLink (rpmps ps);
/** \ingroup rpmps
* Return number of problems in set.
* @param ps problem set
* @return number of problems
*/
int rpmpsNumProblems(rpmps ps);
/** \ingroup rpmps
* Initialize problem set iterator.
* @param ps problem set
* @return problem set iterator
*/
rpmpsi rpmpsInitIterator(rpmps ps);
/** \ingroup rpmps
* Destroy problem set iterator.
* @param psi problem set iterator
* @return problem set iterator (NULL)
*/
rpmpsi rpmpsFreeIterator(rpmpsi psi);
/** \ingroup rpmps
* Return next problem from iterator
* @param psi problem set iterator
* @return next problem (weak ref), NULL on termination
*/
rpmProblem rpmpsiNext(rpmpsi psi);
/** \ingroup rpmps
* Return next problem set iterator index
* @param psi problem set iterator
* @return iterator index, -1 on termination
*/
int rpmpsNextIterator(rpmpsi psi);
/** \ingroup rpmps
* Return current problem from problem set
* @param psi problem set iterator
* @return current rpmProblem
*/
rpmProblem rpmpsGetProblem(rpmpsi psi);
/** \ingroup rpmps
* Create a problem set.
* @return new problem set
*/
rpmps rpmpsCreate(void);
/** \ingroup rpmps
* Destroy a problem set.
* @param ps problem set
* @return NULL always
*/
rpmps rpmpsFree(rpmps ps);
/** \ingroup rpmps
* Print problems to file handle.
* @param fp file handle (NULL uses stderr)
* @param ps problem set
*/
void rpmpsPrint(FILE *fp, rpmps ps);
/** \ingroup rpmps
* Append a problem to current set of problems.
* @param ps problem set
* @param prob rpmProblem
*/
void rpmpsAppendProblem(rpmps ps, rpmProblem prob);
/** \ingroup rpmps
* Merge problem set into another.
* @param dest destination problem set
* @param src source problem set
* @return number of problems merged
*/
int rpmpsMerge(rpmps dest, rpmps src);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMPS */
PK vFZO
xEK EK rpmts.hnu �[��� #ifndef H_RPMTS
#define H_RPMTS
/** \ingroup rpmts
* \file lib/rpmts.h
* Structures and prototypes used for an "rpmts" transaction set.
*/
#include <sys/types.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmte.h>
#include <rpm/rpmps.h>
#include <rpm/rpmsw.h>
#include <rpm/rpmpgp.h>
#include <rpm/rpmfi.h>
#include <rpm/rpmcallback.h>
#ifdef __cplusplus
extern "C" {
#endif
extern int _rpmts_stats;
/** \ingroup rpmts
* Bit(s) to control rpmtsRun() operation.
*/
enum rpmtransFlags_e {
RPMTRANS_FLAG_NONE = 0,
RPMTRANS_FLAG_TEST = (1 << 0), /*!< from --test */
RPMTRANS_FLAG_BUILD_PROBS = (1 << 1), /*!< don't process payload */
RPMTRANS_FLAG_NOSCRIPTS = (1 << 2), /*!< from --noscripts */
RPMTRANS_FLAG_JUSTDB = (1 << 3), /*!< from --justdb */
RPMTRANS_FLAG_NOTRIGGERS = (1 << 4), /*!< from --notriggers */
RPMTRANS_FLAG_NODOCS = (1 << 5), /*!< from --excludedocs */
RPMTRANS_FLAG_ALLFILES = (1 << 6), /*!< from --allfiles */
RPMTRANS_FLAG_NOPLUGINS = (1 << 7), /*!< from --noplugins */
RPMTRANS_FLAG_NOCONTEXTS = (1 << 8), /*!< from --nocontexts */
RPMTRANS_FLAG_NOCAPS = (1 << 9), /*!< from --nocaps */
/* bits 10-15 unused */
RPMTRANS_FLAG_NOTRIGGERPREIN= (1 << 16), /*!< from --notriggerprein */
RPMTRANS_FLAG_NOPRE = (1 << 17), /*!< from --nopre */
RPMTRANS_FLAG_NOPOST = (1 << 18), /*!< from --nopost */
RPMTRANS_FLAG_NOTRIGGERIN = (1 << 19), /*!< from --notriggerin */
RPMTRANS_FLAG_NOTRIGGERUN = (1 << 20), /*!< from --notriggerun */
RPMTRANS_FLAG_NOPREUN = (1 << 21), /*!< from --nopreun */
RPMTRANS_FLAG_NOPOSTUN = (1 << 22), /*!< from --nopostun */
RPMTRANS_FLAG_NOTRIGGERPOSTUN = (1 << 23), /*!< from --notriggerpostun */
RPMTRANS_FLAG_NOPRETRANS = (1 << 24), /*!< from --nopretrans */
RPMTRANS_FLAG_NOPOSTTRANS = (1 << 25), /*!< from --noposttrans */
/* bit 26 unused */
RPMTRANS_FLAG_NOMD5 = (1 << 27), /*!< from --nomd5 */
RPMTRANS_FLAG_NOFILEDIGEST = (1 << 27), /*!< from --nofiledigest (alias to --nomd5) */
/* bits 28-29 unused */
RPMTRANS_FLAG_NOCONFIGS = (1 << 30), /*!< from --noconfigs */
RPMTRANS_FLAG_DEPLOOPS = (1 << 31) /*!< from --deploops */
};
typedef rpmFlags rpmtransFlags;
#define _noTransScripts \
( RPMTRANS_FLAG_NOPRE | \
RPMTRANS_FLAG_NOPOST | \
RPMTRANS_FLAG_NOPREUN | \
RPMTRANS_FLAG_NOPOSTUN | \
RPMTRANS_FLAG_NOPRETRANS | \
RPMTRANS_FLAG_NOPOSTTRANS \
)
#define _noTransTriggers \
( RPMTRANS_FLAG_NOTRIGGERPREIN | \
RPMTRANS_FLAG_NOTRIGGERIN | \
RPMTRANS_FLAG_NOTRIGGERUN | \
RPMTRANS_FLAG_NOTRIGGERPOSTUN \
)
/* Avoid unnecessary breakage for stuff referring to these unused flags */
#define RPMTRANS_FLAG_NOPAYLOAD 0
#define RPMTRANS_FLAG_APPLYONLY 0
#define RPMTRANS_FLAG_KEEPOBSOLETE 0
#define RPMTRANS_FLAG_DIRSTASH 0
#define RPMTRANS_FLAG_REPACKAGE 0
#define RPMTRANS_FLAG_PKGCOMMIT 0
#define RPMTRANS_FLAG_PKGUNDO 0
#define RPMTRANS_FLAG_COMMIT 0
#define RPMTRANS_FLAG_UNDO 0
#define RPMTRANS_FLAG_REVERSE 0
#define RPMTRANS_FLAG_NOSUGGEST 0
#define RPMTRANS_FLAG_ADDINDEPS 0
/** \ingroup rpmts
* Bit(s) to control digest and signature verification.
*/
enum rpmVSFlags_e {
RPMVSF_DEFAULT = 0,
RPMVSF_NOHDRCHK = (1 << 0),
RPMVSF_NEEDPAYLOAD = (1 << 1),
/* bit(s) 2-7 unused */
RPMVSF_NOSHA1HEADER = (1 << 8),
RPMVSF_NOSHA256HEADER = (1 << 9),
RPMVSF_NODSAHEADER = (1 << 10),
RPMVSF_NORSAHEADER = (1 << 11),
/* bit(s) 12-15 unused */
RPMVSF_NOPAYLOAD = (1 << 16),
RPMVSF_NOMD5 = (1 << 17),
RPMVSF_NODSA = (1 << 18),
RPMVSF_NORSA = (1 << 19)
/* bit(s) 16-31 unused */
};
typedef rpmFlags rpmVSFlags;
#define RPMVSF_MASK_NODIGESTS \
( RPMVSF_NOSHA1HEADER | \
RPMVSF_NOSHA256HEADER | \
RPMVSF_NOPAYLOAD | \
RPMVSF_NOMD5 )
#define _RPMVSF_NODIGESTS RPMVSF_MASK_NODIGESTS
#define RPMVSF_MASK_NOSIGNATURES \
( RPMVSF_NODSAHEADER | \
RPMVSF_NORSAHEADER | \
RPMVSF_NODSA | \
RPMVSF_NORSA )
#define _RPMVSF_NOSIGNATURES RPMVSF_MASK_NOSIGNATURES
#define RPMVSF_MASK_NOHEADER \
( RPMVSF_NOSHA1HEADER | \
RPMVSF_NOSHA256HEADER | \
RPMVSF_NODSAHEADER | \
RPMVSF_NORSAHEADER )
#define _RPMVSF_NOHEADER RPMVSF_MASK_NOHEADER
#define RPMVSF_MASK_NOPAYLOAD \
( RPMVSF_NOMD5 | \
RPMVSF_NOPAYLOAD | \
RPMVSF_NODSA | \
RPMVSF_NORSA )
#define _RPMVSF_NOPAYLOAD RPMVSF_MASK_NOPAYLOAD
enum {
RPMSIG_NONE_TYPE = 0,
RPMSIG_DIGEST_TYPE = (1 << 0),
RPMSIG_SIGNATURE_TYPE = (1 << 1),
RPMSIG_OTHER_TYPE = (1 << 2),
};
#define RPMSIG_VERIFIABLE_TYPE (RPMSIG_DIGEST_TYPE|RPMSIG_SIGNATURE_TYPE)
/** \ingroup rpmts
* Indices for timestamps.
*/
typedef enum rpmtsOpX_e {
RPMTS_OP_TOTAL = 0,
RPMTS_OP_CHECK = 1,
RPMTS_OP_ORDER = 2,
RPMTS_OP_FINGERPRINT = 3,
RPMTS_OP_INSTALL = 5,
RPMTS_OP_ERASE = 6,
RPMTS_OP_SCRIPTLETS = 7,
RPMTS_OP_COMPRESS = 8,
RPMTS_OP_UNCOMPRESS = 9,
RPMTS_OP_DIGEST = 10,
RPMTS_OP_SIGNATURE = 11,
RPMTS_OP_DBADD = 12,
RPMTS_OP_DBREMOVE = 13,
RPMTS_OP_DBGET = 14,
RPMTS_OP_DBPUT = 15,
RPMTS_OP_DBDEL = 16,
RPMTS_OP_VERIFY = 17,
RPMTS_OP_MAX = 18
} rpmtsOpX;
enum rpmtxnFlags_e {
RPMTXN_READ = (1 << 0),
RPMTXN_WRITE = (1 << 1),
};
typedef rpmFlags rpmtxnFlags;
/** \ingroup rpmts
* Perform dependency resolution on the transaction set.
*
* Any problems found by rpmtsCheck() can be examined by retrieving the
* problem set with rpmtsProblems(), success here only means that
* the resolution was successfully attempted for all packages in the set.
*
* @param ts transaction set
* @return 0 on success
*/
int rpmtsCheck(rpmts ts);
/** \ingroup rpmts
* Determine package order in a transaction set according to dependencies.
*
* Order packages, returning error if circular dependencies cannot be
* eliminated by removing Requires's from the loop(s). Only dependencies from
* added or removed packages are used to determine ordering using a
* topological sort (Knuth vol. 1, p. 262). Use rpmtsCheck() to verify
* that all dependencies can be resolved.
*
* The final order ends up as installed packages followed by removed packages,
* with packages removed for upgrades immediately following the new package
* to be installed.
*
* @param ts transaction set
* @return no. of (added) packages that could not be ordered
*/
int rpmtsOrder(rpmts ts);
/** \ingroup rpmts
* Process all package elements in a transaction set. Before calling
* rpmtsRun be sure to have:
*
* - setup the rpm root dir via rpmtsSetRoot().
* - setup the rpm notify callback via rpmtsSetNotifyCallback().
* - setup the rpm transaction flags via rpmtsSetFlags().
*
* Additionally, though not required you may want to:
*
* - setup the rpm verify signature flags via rpmtsSetVSFlags().
*
* @param ts transaction set
* @param okProbs unused
* @param ignoreSet bits to filter problem types
* @return 0 on success, -1 on error, >0 with newProbs set
*/
int rpmtsRun(rpmts ts, rpmps okProbs, rpmprobFilterFlags ignoreSet);
/** \ingroup rpmts
* Reference a transaction set instance.
* @param ts transaction set
* @return new transaction set reference
*/
rpmts rpmtsLink (rpmts ts);
/** \ingroup rpmts
* Close the database used by the transaction.
* @param ts transaction set
* @return 0 on success
*/
int rpmtsCloseDB(rpmts ts);
/** \ingroup rpmts
* Open the database used by the transaction.
* @param ts transaction set
* @param dbmode O_RDONLY or O_RDWR
* @return 0 on success
*/
int rpmtsOpenDB(rpmts ts, int dbmode);
/** \ingroup rpmts
* Initialize the database used by the transaction.
* @deprecated An explicit rpmdbInit() is almost never needed.
* @param ts transaction set
* @param dbmode O_RDONLY or O_RDWR
* @return 0 on success
*/
int rpmtsInitDB(rpmts ts, int dbmode);
/** \ingroup rpmts
* Return the transaction database mode
* @param ts transaction set
* @return O_RDONLY, O_RDWR or -1 (lazy opens disabled)
*/
int rpmtsGetDBMode(rpmts ts);
/** \ingroup rpmts
* Set the transaction database mode. Only permitted when when backing
* database hasn't been opened yet (ie rpmtsGetRdb(ts) == NULL)
* @param ts transaction set
* @param dbmode O_RDONLY, O_RDWR or -1 (disable lazy opens)
* @return 0 on success, 1 on error
*/
int rpmtsSetDBMode(rpmts ts, int dbmode);
/** \ingroup rpmts
* Rebuild the database used by the transaction.
* @param ts transaction set
* @return 0 on success
*/
int rpmtsRebuildDB(rpmts ts);
/** \ingroup rpmts
* Verify the database used by the transaction.
* @param ts transaction set
* @return 0 on success
*/
int rpmtsVerifyDB(rpmts ts);
/** \ingroup rpmts
* Return transaction database iterator.
* @param ts transaction set
* @param rpmtag database index tag
* @param keyp key data (NULL for sequential access)
* @param keylen key data length (0 will use strlen(keyp))
* @return NULL on failure
*/
rpmdbMatchIterator rpmtsInitIterator(const rpmts ts, rpmDbiTagVal rpmtag,
const void * keyp, size_t keylen);
/** \ingroup rpmts
* Import a header into the rpmdb
* @param txn transaction handle
* @param h header
* @param flags (unused)
* @return RPMRC_OK/RPMRC_FAIL
*/
rpmRC rpmtsImportHeader(rpmtxn txn, Header h, rpmFlags flags);
/** \ingroup rpmts
* Import public key packet(s).
* @todo Implicit --update policy for gpg-pubkey headers.
* @param ts transaction set
* @param pkt pgp pubkey packet(s)
* @param pktlen pgp pubkey length
* @return RPMRC_OK/RPMRC_FAIL
*/
rpmRC rpmtsImportPubkey(rpmts ts, const unsigned char * pkt, size_t pktlen);
/** \ingroup rpmts
* Retrieve handle for keyring used for this transaction set
* @param ts transaction set
* @param autoload load default keyring if keyring is not set
* @return keyring handle (or NULL)
*/
rpmKeyring rpmtsGetKeyring(rpmts ts, int autoload);
/** \ingroup rpmts
* Set keyring to use for this transaction set.
* Keyring can be only changed while the underlying rpm database is not
* yet open.
* @param ts transaction set
* @param keyring keyring handle (NULL to free current keyring)
* @return 0 on success, -1 on error
*/
int rpmtsSetKeyring(rpmts ts, rpmKeyring keyring);
/** \ingroup rpmts
* Set dependency solver callback.
* @param ts transaction set
* @param (*solve) dependency solver callback
* @param solveData dependency solver callback data (opaque)
* @return 0 on success
*/
int rpmtsSetSolveCallback(rpmts ts,
int (*solve) (rpmts ts, rpmds ds, const void * data),
const void * solveData);
/** \ingroup rpmts
* Return current transaction set problems.
* @param ts transaction set
* @return current problem set (or NULL if no problems)
*/
rpmps rpmtsProblems(rpmts ts);
/** \ingroup rpmts
* Clean current transaction problem set.
* @param ts transaction set
*/
void rpmtsCleanProblems(rpmts ts);
/** \ingroup rpmts
* Free memory needed only for dependency checks and ordering.
* @param ts transaction set
*/
void rpmtsClean(rpmts ts);
/** \ingroup rpmts
* Re-create an empty transaction set.
* @param ts transaction set
*/
void rpmtsEmpty(rpmts ts);
/** \ingroup rpmts
* Destroy transaction set, closing the database as well.
* @param ts transaction set
* @return NULL always
*/
rpmts rpmtsFree(rpmts ts);
/** \ingroup rpmts
* Get verify signatures flag(s).
* @param ts transaction set
* @return verify signatures flags
*/
rpmVSFlags rpmtsVSFlags(rpmts ts);
/** \ingroup rpmts
* Set verify signatures flag(s).
* @param ts transaction set
* @param vsflags new verify signatures flags
* @return previous value
*/
rpmVSFlags rpmtsSetVSFlags(rpmts ts, rpmVSFlags vsflags);
/** \ingroup rpmts
* Get package verify flag(s).
* @param ts transaction set
* @return verify signatures flags
*/
rpmVSFlags rpmtsVfyFlags(rpmts ts);
/** \ingroup rpmts
* Set package verify flag(s).
* @param ts transaction set
* @param vfyflags new package verify flags
* @return old package verify flags
*/
rpmVSFlags rpmtsSetVfyFlags(rpmts ts, rpmVSFlags vfyflags);
/** \ingroup rpmts
* Get enforced package verify level
* @param ts transaction set
* @return package verify level
*/
int rpmtsVfyLevel(rpmts ts);
/** \ingroup rpmts
* Set enforced package verify level
* @param ts transaction set
* @param vfylevel new package verify level
* @return old package verify level
*/
int rpmtsSetVfyLevel(rpmts ts, int vfylevel);
/** \ingroup rpmts
* Get transaction rootDir, i.e. path to chroot(2).
* @param ts transaction set
* @return transaction rootDir
*/
const char * rpmtsRootDir(rpmts ts);
/** \ingroup rpmts
* Set transaction rootDir, i.e. path to chroot(2).
* @param ts transaction set
* @param rootDir new transaction rootDir (or NULL)
* @return 0 on success, -1 on error (invalid rootDir)
*/
int rpmtsSetRootDir(rpmts ts, const char * rootDir);
/** \ingroup rpmts
* Get transaction script file handle, i.e. stdout/stderr on scriptlet execution
* @param ts transaction set
* @return transaction script file handle
*/
FD_t rpmtsScriptFd(rpmts ts);
/** \ingroup rpmts
* Set transaction script file handle, i.e. stdout/stderr on scriptlet execution
* @param ts transaction set
* @param scriptFd new script file handle (or NULL)
*/
void rpmtsSetScriptFd(rpmts ts, FD_t scriptFd);
/** \ingroup rpmts
* Get transaction id, i.e. transaction time stamp.
* @param ts transaction set
* @return transaction id
*/
rpm_tid_t rpmtsGetTid(rpmts ts);
/** \ingroup rpmts
* Set transaction id, i.e. transaction time stamp.
* @param ts transaction set
* @param tid new transaction id
* @return previous transaction id
*/
rpm_tid_t rpmtsSetTid(rpmts ts, rpm_tid_t tid);
/** \ingroup rpmts
* Get transaction set database handle.
* @param ts transaction set
* @return transaction database handle
*/
rpmdb rpmtsGetRdb(rpmts ts);
/** \ingroup rpmts
* Perform transaction progress notify callback.
* @param ts transaction set
* @param te current transaction element
* @param what type of call back
* @param amount current value
* @param total final value
* @return callback dependent pointer
*/
void * rpmtsNotify(rpmts ts, rpmte te,
rpmCallbackType what, rpm_loff_t amount, rpm_loff_t total);
/** \ingroup rpmts
* Return number of (ordered) transaction set elements.
* @param ts transaction set
* @return no. of transaction set elements
*/
int rpmtsNElements(rpmts ts);
/** \ingroup rpmts
* Return (ordered) transaction set element.
* @param ts transaction set
* @param ix transaction element index
* @return transaction element (or NULL)
*/
rpmte rpmtsElement(rpmts ts, int ix);
/** \ingroup rpmts
* Get problem ignore bit mask, i.e. bits to filter encountered problems.
* @param ts transaction set
* @return ignore bit mask
*/
rpmprobFilterFlags rpmtsFilterFlags(rpmts ts);
/** \ingroup rpmts
* Get transaction flags, i.e. bits that control rpmtsRun().
* @param ts transaction set
* @return transaction flags
*/
rpmtransFlags rpmtsFlags(rpmts ts);
/** \ingroup rpmts
* Set transaction flags, i.e. bits that control rpmtsRun().
* @param ts transaction set
* @param transFlags new transaction flags
* @return previous transaction flags
*/
rpmtransFlags rpmtsSetFlags(rpmts ts, rpmtransFlags transFlags);
/** \ingroup rpmts
* Retrieve color bits of transaction set.
* @param ts transaction set
* @return color bits
*/
rpm_color_t rpmtsColor(rpmts ts);
/** \ingroup rpmts
* Retrieve preferred file color
* @param ts transaction set
* @return color bits
*/
rpm_color_t rpmtsPrefColor(rpmts ts);
/** \ingroup rpmts
* Set color bits of transaction set.
* @param ts transaction set
* @param color new color bits
* @return previous color bits
*/
rpm_color_t rpmtsSetColor(rpmts ts, rpm_color_t color);
/** \ingroup rpmts
* Set preferred file color
* @param ts transaction set
* @param color new color bits
* @return previous color bits
*/
rpm_color_t rpmtsSetPrefColor(rpmts ts, rpm_color_t color);
/** \ingroup rpmts
* Retrieve operation timestamp from a transaction set.
* @param ts transaction set
* @param opx operation timestamp index
* @return pointer to operation timestamp.
*/
rpmop rpmtsOp(rpmts ts, rpmtsOpX opx);
/** \ingroup rpmts
* Get the plugins associated with a transaction set
* @param ts transaction set
* @return plugins
*/
rpmPlugins rpmtsPlugins(rpmts ts);
/** \ingroup rpmts
* Set transaction notify callback function and argument.
*
* @warning This call must be made before rpmtsRun() for
* install/upgrade/freshen to function correctly.
*
* @param ts transaction set
* @param notify progress callback
* @param notifyData progress callback private data
* @return 0 on success
*/
int rpmtsSetNotifyCallback(rpmts ts,
rpmCallbackFunction notify,
rpmCallbackData notifyData);
/** \ingroup rpmts
* Create an empty transaction set.
* @return new transaction set
*/
rpmts rpmtsCreate(void);
/** \ingroup rpmts
* Add package to be installed to transaction set.
*
* The transaction set is checked for duplicate package names.
* If found, the package with the "newest" EVR will be replaced.
*
* @param ts transaction set
* @param h header
* @param key package retrieval key (e.g. file name)
* @param upgrade is package being upgraded?
* @param relocs package file relocations
* @return 0 on success, 1 on I/O error, 2 needs capabilities
*/
int rpmtsAddInstallElement(rpmts ts, Header h,
const fnpyKey key, int upgrade,
rpmRelocation * relocs);
/** \ingroup rpmts
* Add package to be reinstalled to transaction set.
*
* @param ts transaction set
* @param h header
* @param key package retrieval key (e.g. file name)
* @return 0 on success
*/
int rpmtsAddReinstallElement(rpmts ts, Header h, const fnpyKey key);
/** \ingroup rpmts
* Add package to be erased to transaction set.
* @param ts transaction set
* @param h header
* @param dboffset ununsed
* @return 0 on success, 1 on error (not installed)
*/
int rpmtsAddEraseElement(rpmts ts, Header h, int dboffset);
/** \ingroup rpmts
* Create a transaction (lock) handle
* @param ts transaction set
* @param flags flags
* @return transaction handle
*/
rpmtxn rpmtxnBegin(rpmts ts, rpmtxnFlags flags);
/** \ingroup rpmts
* Destroy transaction (lock) handle
* @param txn transaction handle
* @return NULL always
*/
rpmtxn rpmtxnEnd(rpmtxn txn);
/** \ingroup rpmte
* Destroy transaction element iterator.
* @param tsi transaction element iterator
* @return NULL always
*/
rpmtsi rpmtsiFree(rpmtsi tsi);
/** \ingroup rpmte
* Create transaction element iterator.
* @param ts transaction set
* @return transaction element iterator
*/
rpmtsi rpmtsiInit(rpmts ts);
/** \ingroup rpmte
* Return next transaction element of type.
* @param tsi transaction element iterator
* @param types transaction element type selector (0 for any)
* @return next transaction element of type, NULL on termination
*/
rpmte rpmtsiNext(rpmtsi tsi, rpmElementTypes types);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMTS */
PK vFZ��z$g g rpmvf.hnu �[��� #ifndef _RPMVF_H
#define _RPMVF_H
/** \ingroup rpmvf
* \file lib/rpmvf.h
*
* \brief Verify a package. The constants that enable/disable some sanity checks (mainly used at post (un)install)
*/
#include <rpm/rpmtypes.h>
#include <rpm/rpmutil.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmvf
* Bit(s) for rpmVerifyFile() attributes and result.
*/
enum rpmVerifyAttrs_e {
RPMVERIFY_NONE = 0, /*!< */
RPMVERIFY_MD5 = (1 << 0), /*!< from %verify(md5) - obsolete */
RPMVERIFY_FILEDIGEST= (1 << 0), /*!< from %verify(filedigest) */
RPMVERIFY_FILESIZE = (1 << 1), /*!< from %verify(size) */
RPMVERIFY_LINKTO = (1 << 2), /*!< from %verify(link) */
RPMVERIFY_USER = (1 << 3), /*!< from %verify(user) */
RPMVERIFY_GROUP = (1 << 4), /*!< from %verify(group) */
RPMVERIFY_MTIME = (1 << 5), /*!< from %verify(mtime) */
RPMVERIFY_MODE = (1 << 6), /*!< from %verify(mode) */
RPMVERIFY_RDEV = (1 << 7), /*!< from %verify(rdev) */
RPMVERIFY_CAPS = (1 << 8), /*!< from %verify(caps) */
/* bits 9-14 unused, reserved for rpmVerifyAttrs */
RPMVERIFY_CONTEXTS = (1 << 15), /*!< verify: from --nocontexts */
/* bits 16-22 used in rpmVerifyFlags */
/* bits 23-27 used in rpmQueryFlags */
RPMVERIFY_READLINKFAIL= (1 << 28), /*!< readlink failed */
RPMVERIFY_READFAIL = (1 << 29), /*!< file read failed */
RPMVERIFY_LSTATFAIL = (1 << 30), /*!< lstat failed */
RPMVERIFY_LGETFILECONFAIL = (1 << 31) /*!< lgetfilecon failed */
};
typedef rpmFlags rpmVerifyAttrs;
#define RPMVERIFY_ALL ~(RPMVERIFY_NONE)
#define RPMVERIFY_FAILURES \
(RPMVERIFY_LSTATFAIL|RPMVERIFY_READFAIL|RPMVERIFY_READLINKFAIL|RPMVERIFY_LGETFILECONFAIL)
/** \ingroup rpmvf
* Bit(s) to control rpmVerify() operation
*/
enum rpmVerifyFlags_e {
VERIFY_DEFAULT = 0, /*!< */
VERIFY_MD5 = (1 << 0), /*!< from --nomd5 - obsolete */
VERIFY_FILEDIGEST = (1 << 0), /*!< from --nofiledigest */
VERIFY_SIZE = (1 << 1), /*!< from --nosize */
VERIFY_LINKTO = (1 << 2), /*!< from --nolinkto */
VERIFY_USER = (1 << 3), /*!< from --nouser */
VERIFY_GROUP = (1 << 4), /*!< from --nogroup */
VERIFY_MTIME = (1 << 5), /*!< from --nomtime */
VERIFY_MODE = (1 << 6), /*!< from --nomode */
VERIFY_RDEV = (1 << 7), /*!< from --nodev */
VERIFY_CAPS = (1 << 8), /*!< from --nocaps */
/* bits 9-14 unused, reserved for rpmVerifyAttrs */
VERIFY_CONTEXTS = (1 << 15), /*!< verify: from --nocontexts */
VERIFY_FILES = (1 << 16), /*!< verify: from --nofiles */
VERIFY_DEPS = (1 << 17), /*!< verify: from --nodeps */
VERIFY_SCRIPT = (1 << 18), /*!< verify: from --noscripts */
VERIFY_DIGEST = (1 << 19), /*!< verify: from --nodigest */
VERIFY_SIGNATURE = (1 << 20), /*!< verify: from --nosignature */
VERIFY_PATCHES = (1 << 21), /*!< verify: from --nopatches */
VERIFY_HDRCHK = (1 << 22), /*!< verify: from --nohdrchk */
VERIFY_FOR_LIST = (1 << 23), /*!< query: from --list */
VERIFY_FOR_STATE = (1 << 24), /*!< query: from --state */
VERIFY_FOR_DOCS = (1 << 25), /*!< query: from --docfiles */
VERIFY_FOR_CONFIG = (1 << 26), /*!< query: from --configfiles */
VERIFY_FOR_DUMPFILES= (1 << 27) /*!< query: from --dump */
/* bits 28-31 used in rpmVerifyAttrs */
};
typedef rpmFlags rpmVerifyFlags;
#define VERIFY_ATTRS \
( VERIFY_FILEDIGEST | VERIFY_SIZE | VERIFY_LINKTO | VERIFY_USER | VERIFY_GROUP | \
VERIFY_MTIME | VERIFY_MODE | VERIFY_RDEV | VERIFY_CONTEXTS | VERIFY_CAPS )
#define VERIFY_ALL \
( VERIFY_ATTRS | VERIFY_FILES | VERIFY_DEPS | VERIFY_SCRIPT | VERIFY_DIGEST |\
VERIFY_SIGNATURE | VERIFY_HDRCHK )
/** \ingroup rpmvf
* Verify file attributes (including digest).
* @deprecated use rpmfiVerify() / rpmfilesVerify() instead
* @param ts transaction set
* @param fi file info (with linked header and current file index)
* @retval *res bit(s) returned to indicate failure
* @param omitMask bit(s) to disable verify checks
* @return 0 on success (or not installed), 1 on error
*/
RPM_GNUC_DEPRECATED
int rpmVerifyFile(const rpmts ts, rpmfi fi,
rpmVerifyAttrs * res, rpmVerifyAttrs omitMask);
#ifdef __cplusplus
}
#endif
#endif /* _RPMTYPES_H */
PK vFZ�� i
i
rpmtypes.hnu �[��� #ifndef _RPMTYPES_H
#define _RPMTYPES_H
/** \ingroup rpmtypes
* \file lib/rpmtypes.h
*
* Typedefs for RPM abstract data types.
* @todo The grouping needs love to look sane...
*/
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef const char * errmsg_t;
/** \ingroup rpmtypes
*
* RPM header and data retrieval types.
* @{
*/
typedef struct headerToken_s * Header;
typedef struct headerIterator_s * HeaderIterator;
typedef int32_t rpm_tag_t;
typedef uint32_t rpm_tagtype_t;
typedef uint32_t rpm_count_t;
typedef rpm_tag_t rpmTagVal;
typedef rpm_tag_t rpmDbiTagVal;
typedef void * rpm_data_t;
typedef const void * rpm_constdata_t;
typedef struct rpmtd_s * rpmtd;
typedef uint32_t rpm_color_t;
typedef uint32_t rpm_flag_t;
typedef uint32_t rpm_tid_t;
typedef uint32_t rpmFlags;
/** @} */
/** \ingroup rpmtypes
*
* In-header hardcoded sizes for various POSIXy types
* @{
*/
typedef uint32_t rpm_off_t;
typedef uint64_t rpm_loff_t;
typedef uint32_t rpm_time_t;
typedef uint16_t rpm_mode_t;
typedef uint16_t rpm_rdev_t;
typedef uint32_t rpm_dev_t;
typedef uint32_t rpm_ino_t;
/** @} */
/** \ingroup rpmtypes
* The main types involved in transaction manipulation
* @{
*/
typedef struct rpmts_s * rpmts;
typedef struct rpmte_s * rpmte;
typedef struct rpmds_s * rpmds;
typedef struct rpmfi_s * rpmfi;
typedef struct rpmfiles_s * rpmfiles;
typedef struct rpmdb_s * rpmdb;
typedef struct rpmdbMatchIterator_s * rpmdbMatchIterator;
typedef struct rpmtsi_s * rpmtsi;
typedef struct rpmps_s * rpmps;
typedef struct rpmtxn_s * rpmtxn;
typedef struct rpmdbIndexIterator_s * rpmdbIndexIterator;
typedef const void * fnpyKey;
typedef void * rpmCallbackData;
/** @} */
typedef struct rpmPubkey_s * rpmPubkey;
typedef struct rpmKeyring_s * rpmKeyring;
typedef uint32_t rpmsid;
typedef struct rpmstrPool_s * rpmstrPool;
typedef struct rpmPlugin_s * rpmPlugin;
typedef struct rpmPlugins_s * rpmPlugins;
typedef struct rpmgi_s * rpmgi;
typedef struct rpmSpec_s * rpmSpec;
typedef struct rpmRelocation_s rpmRelocation;
/** \ingroup rpmtypes
* RPM IO file descriptor type
*/
typedef struct _FD_s * FD_t;
/** \ingroup rpmtypes
* Package read return codes.
*/
typedef enum rpmRC_e {
RPMRC_OK = 0, /*!< Generic success code */
RPMRC_NOTFOUND = 1, /*!< Generic not found code. */
RPMRC_FAIL = 2, /*!< Generic failure code. */
RPMRC_NOTTRUSTED = 3, /*!< Signature is OK, but key is not trusted. */
RPMRC_NOKEY = 4 /*!< Public key is unavailable. */
} rpmRC;
#ifdef __cplusplus
}
#endif
/* XXX included late as rpmtag.h depends on our definitions here... */
#include <rpm/rpmtag.h>
#endif /* _RPMTYPES_H */
PK vFZ_o�nY Y rpmbase64.hnu �[��� /* base64 encoder/decoder based on public domain implementation
* by Chris Venter */
/** \ingroup rpmio
* \file rpmio/rpmbase64.h
*
* Base64 encoding and decoding API
*/
#include <sys/types.h>
#ifdef __cplusplus
extern "C" {
#endif
/* returns malloced base64 encoded string
* lines are split with \n characters to be nearest lower multiple of linelen
* if linelen/4 == 0 lines are not split
* if linelen < 0 default line length (64) is used
* the returned string is empty when len == 0
* returns NULL on failures
*/
char *rpmBase64Encode(const void *data, size_t len, int linelen);
/* decodes from zero terminated base64 encoded string to a newly malloced buffer
* ignores whitespace characters in the input string
* return values:
* 0 - OK
* 1 - input is NULL
* 2 - invalid length
* 3 - invalid characters on input
* 4 - malloc failed
*/
int rpmBase64Decode(const char *in, void **out, size_t *outlen);
/* counts CRC24 and base64 encodes it in a malloced string
* returns NULL on failures
*/
char *rpmBase64CRC(const unsigned char *data, size_t len);
#ifdef __cplusplus
}
#endif
PK vFZ5�)gK K rpmsq.hnu �[��� #ifndef H_RPMSQ
#define H_RPMSQ
/** \ingroup rpmio
* \file rpmio/rpmsq.h
*
* Signal Queue API
*/
#include <rpm/rpmsw.h>
#include <signal.h>
#ifdef __cplusplus
extern "C" {
#endif
/** \ingroup rpmsq
* Default signal handler prototype.
* @param signum signal number
* @param info (siginfo_t) signal info
* @param context signal context
*/
typedef void (*rpmsqAction_t) (int signum, siginfo_t * info, void * context);
/** \ingroup rpmsq
* SIG_DFL, SIG_IGN and SIG_ERR counterparts
*/
#define RPMSQ_DFL ((rpmsqAction_t)0)
#define RPMSQ_IGN ((rpmsqAction_t)1)
#define RPMSQ_ERR ((rpmsqAction_t)-1)
/** \ingroup rpmsq
* Test if given signal has been caught (while signals blocked).
* Similar to sigismember() but operates on internal signal queue.
* @param signum signal to test for
* @return 1 if caught, 0 if not and -1 on error
*/
int rpmsqIsCaught(int signum);
/** \ingroup rpmsq
* Activate (or disable) the signal queue.
* @param state 1 to enable, 0 to disable
* @return 0 on success, negative on error
*/
int rpmsqActivate(int state);
/** \ingroup rpmsq
* Set or delete a signal handler for a signal.
* @param signum signal number
* @param handler signal handler or NULL to delete
* @return previous handler, RPMSQ_ERR on error
*/
rpmsqAction_t rpmsqSetAction(int signum, rpmsqAction_t handler);
/** \ingroup rpmsq
* Block or unblock (almost) all signals.
* The operation is "reference counted" so the calls can be nested,
* and signals are only unblocked when the reference count falls to zero.
* @param op SIG_BLOCK/SIG_UNBLOCK
* @return 0 on success, -1 on error
*/
int rpmsqBlock(int op);
/** \ingroup rpmsq
* Poll for caught signals, executing their handlers.
* @return no. active signals found
*/
int rpmsqPoll(void);
void rpmsqSetInterruptSafety(int on);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMSQ */
PK vFZ+�]�� � rpmutil.hnu �[��� PK vFZk� � � rpmpol.hnu �[��� PK vFZ���� �
� rpmcallback.hnu �[��� PK vFZ<� �� � � rpmlog.hnu �[��� PK vFZ�l#�� � �9 argv.hnu �[��� PK vFZ#d}�\ \ �J rpmio.hnu �[��� PK vFZ`։�0 0 T rpmsign.hnu �[��� PK vFZ�뭘p p �W rpmsw.hnu �[��� PK vFZR �;� � *` rpmarchive.hnu �[��� PK vFZ�2��� � q rpmspec.hnu �[��� PK vFZj���h h { rpmdb.hnu �[��� PK vFZ�o@[� � �� rpmurl.hnu �[��� PK vFZd/,W� � �� rpmfc.hnu �[��� PK vFZw~'�GZ GZ }� rpmtag.hnu �[��� PK vFZ#p�� > >
� rpmfiles.hnu �[��� PK vFZ #=5- 5- SA rpmfi.hnu �[��� PK vFZ��U]�? �? �n rpmds.hnu �[��� PK vFZ � �� rpmkeyring.hnu �[��� PK vFZ�ϖ>� �
� rpmfileutil.hnu �[��� PK vFZ껗�� � �� rpmstring.hnu �[��� PK vFZΤ1�* * �� rpmprob.hnu �[��� PK vFZ8/ �� � � rpmte.hnu �[��� PK vFZ�Ț�3 3 K
rpmtd.hnu �[��� PK vFZs`|�, , �@ header.hnu �[��� PK vFZ"�XSU U �l rpmlib.hnu �[��� PK vFZ���l l
[� rpmmacro.hnu �[��� PK vFZ�$�=M M
� rpmbuild.hnu �[��� PK vFZُ��1� 1� �� rpmpgp.hnu �[��� PK vFZ��2jl3 l3 �b rpmcli.hnu �[��� PK vFZCn�B� � �� rpmstrpool.hnu �[��� PK vFZI�ׁ. . �� rpmps.hnu �[��� PK vFZO
xEK EK �� rpmts.hnu �[��� PK vFZ��z$g g v� rpmvf.hnu �[��� PK vFZ�� i
i
rpmtypes.hnu �[��� PK vFZ_o�nY Y � rpmbase64.hnu �[��� PK vFZ5�)gK K K rpmsq.hnu �[��� PK $ $ :
�"