"Fossies" - the Fresh Open Source Software Archive

Member "rpm-4.15.0/doc/librpm/html/group__rpmkeyring.html" (30 Aug 2019, 29441 Bytes) of package /linux/misc/rpm-4.15.0.tar.bz2:


Caution: In this restricted "Fossies" environment the current HTML page may not be correctly presentated and may have some non-functional links. You can here alternatively try to browse the pure source code or just view or download the uninterpreted raw source code. If the rendering is insufficient you may try to find and view the page on the rpm-4.15.0.tar.bz2 project site itself.

rpm  4.15.0-beta
Files | Functions
RPM keyring API.

RPM keyring API. More...

Files

file  rpmkeyring.h
 RPM keyring API.
 

Functions

rpmKeyring rpmKeyringNew (void)
 Create a new, empty keyring. More...
 
rpmKeyring rpmKeyringFree (rpmKeyring keyring)
 Free keyring and the keys within it. More...
 
int rpmKeyringAddKey (rpmKeyring keyring, rpmPubkey key)
 Add a public key to keyring. More...
 
rpmRC rpmKeyringLookup (rpmKeyring keyring, pgpDig sig)
 Perform keyring lookup for a key matching a signature. More...
 
rpmRC rpmKeyringVerifySig (rpmKeyring keyring, pgpDigParams sig, DIGEST_CTX ctx)
 Perform combined keyring lookup and signature verification. More...
 
rpmKeyring rpmKeyringLink (rpmKeyring keyring)
 Reference a keyring. More...
 
rpmPubkey rpmPubkeyNew (const uint8_t *pkt, size_t pktlen)
 Create a new rpmPubkey from OpenPGP packet. More...
 
rpmPubkeyrpmGetSubkeys (rpmPubkey mainkey, int *count)
 Return array of subkeys belonging to maikey param mainkey main rpmPubkey param count count of returned subkeys. More...
 
rpmPubkey rpmPubkeyRead (const char *filename)
 Create a new rpmPubkey from ASCII-armored pubkey file. More...
 
rpmPubkey rpmPubkeyFree (rpmPubkey key)
 Free a pubkey. More...
 
rpmPubkey rpmPubkeyLink (rpmPubkey key)
 Reference a pubkey. More...
 
pgpDig rpmPubkeyDig (rpmPubkey key)
 Parse OpenPGP pubkey parameters. More...
 
char * rpmPubkeyBase64 (rpmPubkey key)
 Return base64 encoding of pubkey. More...
 
pgpDigParams rpmPubkeyPgpDigParams (rpmPubkey key)
 Return pgp params of key. More...
 

Detailed Description

RPM keyring API.

Function Documentation

◆ rpmGetSubkeys()

rpmPubkey* rpmGetSubkeys ( rpmPubkey  mainkey,
int *  count 
)

Return array of subkeys belonging to maikey param mainkey main rpmPubkey param count count of returned subkeys.

Returns
an array of subkey's handles

◆ rpmKeyringAddKey()

int rpmKeyringAddKey ( rpmKeyring  keyring,
rpmPubkey  key 
)

Add a public key to keyring.

Parameters
keyringkeyring handle
keypubkey handle
Returns
0 on success, -1 on error, 1 if key already present

◆ rpmKeyringFree()

rpmKeyring rpmKeyringFree ( rpmKeyring  keyring)

Free keyring and the keys within it.

Returns
NULL always

◆ rpmKeyringLink()

rpmKeyring rpmKeyringLink ( rpmKeyring  keyring)

Reference a keyring.

Parameters
keyringkeyring handle
Returns
new keyring reference

◆ rpmKeyringLookup()

rpmRC rpmKeyringLookup ( rpmKeyring  keyring,
pgpDig  sig 
)

Perform keyring lookup for a key matching a signature.

Parameters
keyringkeyring handle
sigOpenPGP packet container of signature
Returns
RPMRC_OK if found, RPMRC_NOKEY otherwise

◆ rpmKeyringNew()

rpmKeyring rpmKeyringNew ( void  )

Create a new, empty keyring.

Returns
new keyring handle

◆ rpmKeyringVerifySig()

rpmRC rpmKeyringVerifySig ( rpmKeyring  keyring,
pgpDigParams  sig,
DIGEST_CTX  ctx 
)

Perform combined keyring lookup and signature verification.

Parameters
keyringkeyring handle
sigOpenPGP signature parameters
ctxsignature hash context
Returns
RPMRC_OK / RPMRC_FAIL / RPMRC_NOKEY

◆ rpmPubkeyBase64()

char* rpmPubkeyBase64 ( rpmPubkey  key)

Return base64 encoding of pubkey.

Parameters
keyPubkey
Returns
base64 encoded pubkey (malloced), NULL on error

◆ rpmPubkeyDig()

pgpDig rpmPubkeyDig ( rpmPubkey  key)

Parse OpenPGP pubkey parameters.

Parameters
keyPubkey
Returns
parsed output of pubkey packet parameters

◆ rpmPubkeyFree()

rpmPubkey rpmPubkeyFree ( rpmPubkey  key)

Free a pubkey.

Parameters
keyPubkey to free
Returns
NULL always

◆ rpmPubkeyLink()

rpmPubkey rpmPubkeyLink ( rpmPubkey  key)

Reference a pubkey.

Parameters
keyPubkey
Returns
new pubkey reference

◆ rpmPubkeyNew()

rpmPubkey rpmPubkeyNew ( const uint8_t *  pkt,
size_t  pktlen 
)

Create a new rpmPubkey from OpenPGP packet.

Parameters
pktOpenPGP packet data
pktlenData length
Returns
new pubkey handle

◆ rpmPubkeyPgpDigParams()

pgpDigParams rpmPubkeyPgpDigParams ( rpmPubkey  key)

Return pgp params of key.

Parameters
keyPubkey
Returns
pgp params, NULL on error

◆ rpmPubkeyRead()

rpmPubkey rpmPubkeyRead ( const char *  filename)

Create a new rpmPubkey from ASCII-armored pubkey file.

Parameters
filenamePath to pubkey file
Returns
new pubkey handle