gnutls_pubkey_get_openpgp_key_id man page

gnutls_pubkey_get_openpgp_key_id — API function

Synopsis

#include <gnutls/abstract.h>

int gnutls_pubkey_get_openpgp_key_id(gnutls_pubkey_t key, unsigned int flags, unsigned char * output_data, size_t * output_data_size, unsigned int * subkey);

Arguments

gnutls_pubkey_t key

Holds the public key

unsigned int flags

should be 0 or GNUTLS_PUBKEY_GET_OPENPGP_FINGERPRINT

unsigned char * output_data

will contain the key ID

size_t * output_data_size

holds the size of output_data (and will be replaced by the actual size of parameters)

unsigned int * subkey

Will be non zero if the key ID corresponds to a subkey

Description

This function returns the OpenPGP key ID of the corresponding key. The key is a unique ID that depends on the public key parameters.

If the flag GNUTLS_PUBKEY_GET_OPENPGP_FINGERPRINT is specified this function returns the fingerprint of the master key.

If the buffer provided is not long enough to hold the output, then *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned.  The output is GNUTLS_OPENPGP_KEYID_SIZE bytes long.

Returns

In case of failure a negative error code will be returned, and 0 on success.

Since

3.0

Reporting Bugs

Report bugs to <bugs@gnutls.org>.
Home page: http://www.gnutls.org

See Also

The full documentation for gnutls is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

http://www.gnutls.org/manual/

Info

3.5.9 gnutls