/usr/include/rpm/rpmkeyring.h is in librpm-dev 4.14.1+dfsg1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 | #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 */
|