|
|
|
GnuTLS API Reference Manual | |
|---|---|---|---|---|
| Top | Description | ||||
enum gnutls_openpgp_crt_fmt_t; typedef gnutls_openpgp_keyid_t; int gnutls_openpgp_crt_init (gnutls_openpgp_crt_t *key); void gnutls_openpgp_crt_deinit (gnutls_openpgp_crt_t key); int gnutls_openpgp_crt_import (gnutls_openpgp_crt_t key,const gnutls_datum_t *data,gnutls_openpgp_crt_fmt_t format); int gnutls_openpgp_crt_export (gnutls_openpgp_crt_t key,gnutls_openpgp_crt_fmt_t format,void *output_data,size_t *output_data_size); int gnutls_openpgp_crt_print (gnutls_openpgp_crt_t cert,gnutls_certificate_print_formats_t format,gnutls_datum_t *out); int gnutls_openpgp_crt_get_key_usage (gnutls_openpgp_crt_t key,unsigned int *key_usage); int gnutls_openpgp_crt_get_fingerprint (gnutls_openpgp_crt_t key,void *fpr,size_t *fprlen); int gnutls_openpgp_crt_get_subkey_fingerprint (gnutls_openpgp_crt_t key,unsigned int idx,void *fpr,size_t *fprlen); int gnutls_openpgp_crt_get_name (gnutls_openpgp_crt_t key,int idx,char *buf,size_t *sizeof_buf); gnutls_pk_algorithm_t gnutls_openpgp_crt_get_pk_algorithm (gnutls_openpgp_crt_t key,unsigned int *bits); int gnutls_openpgp_crt_get_version (gnutls_openpgp_crt_t key); time_t gnutls_openpgp_crt_get_creation_time (gnutls_openpgp_crt_t key); time_t gnutls_openpgp_crt_get_expiration_time (gnutls_openpgp_crt_t key); int gnutls_openpgp_crt_get_key_id (gnutls_openpgp_crt_t key,gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_crt_check_hostname (gnutls_openpgp_crt_t key,const char *hostname); int gnutls_openpgp_crt_get_revoked_status (gnutls_openpgp_crt_t key); int gnutls_openpgp_crt_get_subkey_count (gnutls_openpgp_crt_t key); int gnutls_openpgp_crt_get_subkey_idx (gnutls_openpgp_crt_t key,const gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_crt_get_subkey_revoked_status (gnutls_openpgp_crt_t key,unsigned int idx); gnutls_pk_algorithm_t gnutls_openpgp_crt_get_subkey_pk_algorithm (gnutls_openpgp_crt_t key,unsigned int idx,unsigned int *bits); time_t gnutls_openpgp_crt_get_subkey_creation_time (gnutls_openpgp_crt_t key,unsigned int idx); time_t gnutls_openpgp_crt_get_subkey_expiration_time (gnutls_openpgp_crt_t key,unsigned int idx); int gnutls_openpgp_crt_get_subkey_id (gnutls_openpgp_crt_t key,unsigned int idx,gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_crt_get_subkey_usage (gnutls_openpgp_crt_t key,unsigned int idx,unsigned int *key_usage); int gnutls_openpgp_crt_get_subkey_pk_dsa_raw (gnutls_openpgp_crt_t crt,unsigned int idx,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y); int gnutls_openpgp_crt_get_subkey_pk_rsa_raw (gnutls_openpgp_crt_t crt,unsigned int idx,gnutls_datum_t *m,gnutls_datum_t *e); int gnutls_openpgp_crt_get_pk_dsa_raw (gnutls_openpgp_crt_t crt,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y); int gnutls_openpgp_crt_get_pk_rsa_raw (gnutls_openpgp_crt_t crt,gnutls_datum_t *m,gnutls_datum_t *e); int gnutls_openpgp_crt_get_preferred_key_id (gnutls_openpgp_crt_t key,gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_crt_set_preferred_key_id (gnutls_openpgp_crt_t key,const gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_privkey_init (gnutls_openpgp_privkey_t *key); void gnutls_openpgp_privkey_deinit (gnutls_openpgp_privkey_t key); gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_pk_algorithm (gnutls_openpgp_privkey_t key,unsigned int *bits); int gnutls_openpgp_privkey_import (gnutls_openpgp_privkey_t key,const gnutls_datum_t *data,gnutls_openpgp_crt_fmt_t format,const char *password,unsigned int flags); int gnutls_openpgp_privkey_get_fingerprint (gnutls_openpgp_privkey_t key,void *fpr,size_t *fprlen); int gnutls_openpgp_privkey_get_subkey_fingerprint (gnutls_openpgp_privkey_t key,unsigned int idx,void *fpr,size_t *fprlen); int gnutls_openpgp_privkey_get_key_id (gnutls_openpgp_privkey_t key,gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_privkey_get_subkey_count (gnutls_openpgp_privkey_t key); int gnutls_openpgp_privkey_get_subkey_idx (gnutls_openpgp_privkey_t key,const gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_privkey_get_subkey_revoked_status (gnutls_openpgp_privkey_t key,unsigned int idx); int gnutls_openpgp_privkey_get_revoked_status (gnutls_openpgp_privkey_t key); gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_subkey_pk_algorithm (gnutls_openpgp_privkey_t key,unsigned int idx,unsigned int *bits); time_t gnutls_openpgp_privkey_get_subkey_expiration_time (gnutls_openpgp_privkey_t key,unsigned int idx); int gnutls_openpgp_privkey_get_subkey_id (gnutls_openpgp_privkey_t key,unsigned int idx,gnutls_openpgp_keyid_t keyid); time_t gnutls_openpgp_privkey_get_subkey_creation_time (gnutls_openpgp_privkey_t key,unsigned int idx); int gnutls_openpgp_privkey_export_subkey_dsa_raw (gnutls_openpgp_privkey_t pkey,unsigned int idx,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y,gnutls_datum_t *x); int gnutls_openpgp_privkey_export_subkey_rsa_raw (gnutls_openpgp_privkey_t pkey,unsigned int idx,gnutls_datum_t *m,gnutls_datum_t *e,gnutls_datum_t *d,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *u); int gnutls_openpgp_privkey_export_dsa_raw (gnutls_openpgp_privkey_t pkey,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y,gnutls_datum_t *x); int gnutls_openpgp_privkey_export_rsa_raw (gnutls_openpgp_privkey_t pkey,gnutls_datum_t *m,gnutls_datum_t *e,gnutls_datum_t *d,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *u); int gnutls_openpgp_privkey_export (gnutls_openpgp_privkey_t key,gnutls_openpgp_crt_fmt_t format,const char *password,unsigned int flags,void *output_data,size_t *output_data_size); int gnutls_openpgp_privkey_set_preferred_key_id (gnutls_openpgp_privkey_t key,const gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_privkey_get_preferred_key_id (gnutls_openpgp_privkey_t key,gnutls_openpgp_keyid_t keyid); int gnutls_openpgp_crt_get_auth_subkey (gnutls_openpgp_crt_t crt,gnutls_openpgp_keyid_t keyid,unsigned int flag); int gnutls_openpgp_keyring_init (gnutls_openpgp_keyring_t *keyring); void gnutls_openpgp_keyring_deinit (gnutls_openpgp_keyring_t keyring); int gnutls_openpgp_keyring_import (gnutls_openpgp_keyring_t keyring,const gnutls_datum_t *data,gnutls_openpgp_crt_fmt_t format); int gnutls_openpgp_keyring_check_id (gnutls_openpgp_keyring_t ring,const gnutls_openpgp_keyid_t keyid,unsigned int flags); int gnutls_openpgp_crt_verify_ring (gnutls_openpgp_crt_t key,gnutls_openpgp_keyring_t keyring,unsigned int flags,unsigned int *verify); int gnutls_openpgp_crt_verify_self (gnutls_openpgp_crt_t key,unsigned int flags,unsigned int *verify); int gnutls_openpgp_keyring_get_crt (gnutls_openpgp_keyring_t ring,unsigned int idx,gnutls_openpgp_crt_t *cert); int gnutls_openpgp_keyring_get_crt_count (gnutls_openpgp_keyring_t ring); int (*gnutls_openpgp_recv_key_func) (gnutls_session_t session,const unsigned char *keyfpr,unsigned int keyfpr_length,gnutls_datum_t *key); void gnutls_openpgp_set_recv_key_function (gnutls_session_t session,gnutls_openpgp_recv_key_func func); int gnutls_certificate_set_openpgp_key (gnutls_certificate_credentials_t res,gnutls_openpgp_crt_t crt,gnutls_openpgp_privkey_t pkey); int gnutls_certificate_set_openpgp_key_file (gnutls_certificate_credentials_t res,const char *certfile,const char *keyfile,gnutls_openpgp_crt_fmt_t format); int gnutls_certificate_set_openpgp_key_mem (gnutls_certificate_credentials_t res,const gnutls_datum_t *cert,const gnutls_datum_t *key,gnutls_openpgp_crt_fmt_t format); int gnutls_certificate_set_openpgp_key_file2 (gnutls_certificate_credentials_t res,const char *certfile,const char *keyfile,const char *subkey_id,gnutls_openpgp_crt_fmt_t format); int gnutls_certificate_set_openpgp_key_mem2 (gnutls_certificate_credentials_t res,const gnutls_datum_t *cert,const gnutls_datum_t *key,const char *subkey_id,gnutls_openpgp_crt_fmt_t format); int gnutls_certificate_set_openpgp_keyring_mem (gnutls_certificate_credentials_t c,const unsigned char *data,size_t dlen,gnutls_openpgp_crt_fmt_t format); int gnutls_certificate_set_openpgp_keyring_file (gnutls_certificate_credentials_t c,const char *file,gnutls_openpgp_crt_fmt_t format);
typedef enum {
GNUTLS_OPENPGP_FMT_RAW,
GNUTLS_OPENPGP_FMT_BASE64
} gnutls_openpgp_crt_fmt_t;
Enumeration of different OpenPGP key formats.
int gnutls_openpgp_crt_init (gnutls_openpgp_crt_t *key);
This function will initialize an OpenPGP key structure.
|
The structure to be initialized |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
void gnutls_openpgp_crt_deinit (gnutls_openpgp_crt_t key);
This function will deinitialize a key structure.
|
The structure to be initialized |
int gnutls_openpgp_crt_import (gnutls_openpgp_crt_t key,const gnutls_datum_t *data,gnutls_openpgp_crt_fmt_t format);
This function will convert the given RAW or Base64 encoded key to the native gnutls_openpgp_crt_t format. The output will be stored in 'key'.
|
The structure to store the parsed key. |
|
The RAW or BASE64 encoded key. |
|
One of gnutls_openpgp_crt_fmt_t elements. |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_crt_export (gnutls_openpgp_crt_t key,gnutls_openpgp_crt_fmt_t format,void *output_data,size_t *output_data_size);
This function will convert the given key to RAW or Base64 format.
If the buffer provided is not long enough to hold the output, then
GNUTLS_E_SHORT_MEMORY_BUFFER will be returned.
|
Holds the key. |
|
One of gnutls_openpgp_crt_fmt_t elements. |
|
will contain the raw or base64 encoded key |
|
holds the size of output_data (and will be replaced by the actual size of parameters) |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_crt_print (gnutls_openpgp_crt_t cert,gnutls_certificate_print_formats_t format,gnutls_datum_t *out);
This function will pretty print an OpenPGP certificate, suitable for display to a human.
The format should be (0) for future compatibility.
The output out needs to be deallocate using gnutls_free().
|
The structure to be printed |
|
Indicate the format to use |
|
Newly allocated datum with (0) terminated string. |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_crt_get_key_usage (gnutls_openpgp_crt_t key,unsigned int *key_usage);
This function will return certificate's key usage, by checking the
key algorithm. The key usage value will ORed values of the:
GNUTLS_KEY_DIGITAL_SIGNATURE, GNUTLS_KEY_KEY_ENCIPHERMENT.
|
should contain a gnutls_openpgp_crt_t structure |
|
where the key usage bits will be stored |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_crt_get_fingerprint (gnutls_openpgp_crt_t key,void *fpr,size_t *fprlen);
Get key fingerprint. Depending on the algorithm, the fingerprint can be 16 or 20 bytes.
|
the raw data that contains the OpenPGP public key. |
|
the buffer to save the fingerprint, must hold at least 20 bytes. |
|
the integer to save the length of the fingerprint. |
Returns : |
On success, 0 is returned. Otherwise, an error code. |
int gnutls_openpgp_crt_get_subkey_fingerprint (gnutls_openpgp_crt_t key,unsigned int idx,void *fpr,size_t *fprlen);
Get key fingerprint of a subkey. Depending on the algorithm, the fingerprint can be 16 or 20 bytes.
|
the raw data that contains the OpenPGP public key. |
|
the subkey index |
|
the buffer to save the fingerprint, must hold at least 20 bytes. |
|
the integer to save the length of the fingerprint. |
Returns : |
On success, 0 is returned. Otherwise, an error code. |
Since 2.4.0
int gnutls_openpgp_crt_get_name (gnutls_openpgp_crt_t key,int idx,char *buf,size_t *sizeof_buf);
Extracts the userID from the parsed OpenPGP key.
|
the structure that contains the OpenPGP public key. |
|
the index of the ID to extract |
|
a pointer to a structure to hold the name, may be NULL
to only get the sizeof_buf. |
|
holds the maximum size of buf, on return hold the
actual/required size of buf. |
Returns : |
GNUTLS_E_SUCCESS on success, and if the index of the ID
does not exist GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE, or an
error code. |
gnutls_pk_algorithm_t gnutls_openpgp_crt_get_pk_algorithm (gnutls_openpgp_crt_t key,unsigned int *bits);
This function will return the public key algorithm of an OpenPGP certificate.
If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent.
|
is an OpenPGP key |
|
if bits is non null it will hold the size of the parameters' in bits |
Returns : |
a member of the gnutls_pk_algorithm_t enumeration on success, or GNUTLS_PK_UNKNOWN on error. |
int gnutls_openpgp_crt_get_version (gnutls_openpgp_crt_t key);
Extract the version of the OpenPGP key.
|
the structure that contains the OpenPGP public key. |
Returns : |
the version number is returned, or a negative error code on errors. |
time_t gnutls_openpgp_crt_get_creation_time
(gnutls_openpgp_crt_t key);
Get key creation time.
|
the structure that contains the OpenPGP public key. |
Returns : |
the timestamp when the OpenPGP key was created. |
time_t gnutls_openpgp_crt_get_expiration_time
(gnutls_openpgp_crt_t key);
Get key expiration time. A value of '0' means that the key doesn't expire at all.
|
the structure that contains the OpenPGP public key. |
Returns : |
the time when the OpenPGP key expires. |
int gnutls_openpgp_crt_get_key_id (gnutls_openpgp_crt_t key,gnutls_openpgp_keyid_t keyid);
Get key id string.
|
the structure that contains the OpenPGP public key. |
|
the buffer to save the keyid. |
Returns : |
the 64-bit keyID of the OpenPGP key. |
Since 2.4.0
int gnutls_openpgp_crt_check_hostname (gnutls_openpgp_crt_t key,const char *hostname);
This function will check if the given key's owner matches the given hostname. This is a basic implementation of the matching described in RFC2818 (HTTPS), which takes into account wildcards.
|
should contain a gnutls_openpgp_crt_t structure |
|
A null terminated string that contains a DNS name |
Returns : |
non-zero for a successful match, and zero on failure. |
int gnutls_openpgp_crt_get_revoked_status
(gnutls_openpgp_crt_t key);
Get revocation status of key.
|
the structure that contains the OpenPGP public key. |
Returns : |
true (1) if the key has been revoked, or false (0) if it has not. |
Since 2.4.0
int gnutls_openpgp_crt_get_subkey_count (gnutls_openpgp_crt_t key);
This function will return the number of subkeys present in the given OpenPGP certificate.
|
is an OpenPGP key |
Returns : |
the number of subkeys, or a negative error code on error. |
Since 2.4.0
int gnutls_openpgp_crt_get_subkey_idx (gnutls_openpgp_crt_t key,const gnutls_openpgp_keyid_t keyid);
Get subkey's index.
|
the structure that contains the OpenPGP public key. |
|
the keyid. |
Returns : |
the index of the subkey or a negative error value. |
Since 2.4.0
int gnutls_openpgp_crt_get_subkey_revoked_status (gnutls_openpgp_crt_t key,unsigned int idx);
Get subkey revocation status. A negative error code indicates an error.
|
the structure that contains the OpenPGP public key. |
|
is the subkey index |
Returns : |
true (1) if the key has been revoked, or false (0) if it has not. |
Since 2.4.0
gnutls_pk_algorithm_t gnutls_openpgp_crt_get_subkey_pk_algorithm (gnutls_openpgp_crt_t key,unsigned int idx,unsigned int *bits);
This function will return the public key algorithm of a subkey of an OpenPGP certificate.
If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent.
|
is an OpenPGP key |
|
is the subkey index |
|
if bits is non null it will hold the size of the parameters' in bits |
Returns : |
a member of the gnutls_pk_algorithm_t enumeration on success, or GNUTLS_PK_UNKNOWN on error. |
Since 2.4.0
time_t gnutls_openpgp_crt_get_subkey_creation_time (gnutls_openpgp_crt_t key,unsigned int idx);
Get subkey creation time.
|
the structure that contains the OpenPGP public key. |
|
the subkey index |
Returns : |
the timestamp when the OpenPGP sub-key was created. |
Since 2.4.0
time_t gnutls_openpgp_crt_get_subkey_expiration_time (gnutls_openpgp_crt_t key,unsigned int idx);
Get subkey expiration time. A value of '0' means that the key doesn't expire at all.
|
the structure that contains the OpenPGP public key. |
|
the subkey index |
Returns : |
the time when the OpenPGP key expires. |
Since 2.4.0
int gnutls_openpgp_crt_get_subkey_id (gnutls_openpgp_crt_t key,unsigned int idx,gnutls_openpgp_keyid_t keyid);
Get the subkey's key-id.
|
the structure that contains the OpenPGP public key. |
|
the subkey index |
|
the buffer to save the keyid. |
Returns : |
the 64-bit keyID of the OpenPGP key. |
int gnutls_openpgp_crt_get_subkey_usage (gnutls_openpgp_crt_t key,unsigned int idx,unsigned int *key_usage);
This function will return certificate's key usage, by checking the
key algorithm. The key usage value will ORed values of
GNUTLS_KEY_DIGITAL_SIGNATURE or GNUTLS_KEY_KEY_ENCIPHERMENT.
A negative error code may be returned in case of parsing error.
|
should contain a gnutls_openpgp_crt_t structure |
|
the subkey index |
|
where the key usage bits will be stored |
Returns : |
key usage value. |
Since 2.4.0
int gnutls_openpgp_crt_get_subkey_pk_dsa_raw (gnutls_openpgp_crt_t crt,unsigned int idx,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y);
This function will export the DSA public key's parameters found in
the given certificate. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
Is the subkey index |
|
will hold the p |
|
will hold the q |
|
will hold the g |
|
will hold the y |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_crt_get_subkey_pk_rsa_raw (gnutls_openpgp_crt_t crt,unsigned int idx,gnutls_datum_t *m,gnutls_datum_t *e);
This function will export the RSA public key's parameters found in
the given structure. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
Is the subkey index |
|
will hold the modulus |
|
will hold the public exponent |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_crt_get_pk_dsa_raw (gnutls_openpgp_crt_t crt,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y);
This function will export the DSA public key's parameters found in
the given certificate. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
will hold the p |
|
will hold the q |
|
will hold the g |
|
will hold the y |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_crt_get_pk_rsa_raw (gnutls_openpgp_crt_t crt,gnutls_datum_t *m,gnutls_datum_t *e);
This function will export the RSA public key's parameters found in
the given structure. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
will hold the modulus |
|
will hold the public exponent |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_crt_get_preferred_key_id (gnutls_openpgp_crt_t key,gnutls_openpgp_keyid_t keyid);
Get preferred key id. If it hasn't been set it returns
GNUTLS_E_INVALID_REQUEST.
|
the structure that contains the OpenPGP public key. |
|
the struct to save the keyid. |
Returns : |
the 64-bit preferred keyID of the OpenPGP key. |
int gnutls_openpgp_crt_set_preferred_key_id (gnutls_openpgp_crt_t key,const gnutls_openpgp_keyid_t keyid);
This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling.
If the provided keyid is NULL then the master key is
set as preferred.
|
the structure that contains the OpenPGP public key. |
|
the selected keyid |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned,
otherwise a negative error code is returned. |
int gnutls_openpgp_privkey_init (gnutls_openpgp_privkey_t *key);
This function will initialize an OpenPGP key structure.
|
The structure to be initialized |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
void gnutls_openpgp_privkey_deinit (gnutls_openpgp_privkey_t key);
This function will deinitialize a key structure.
|
The structure to be initialized |
gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_pk_algorithm (gnutls_openpgp_privkey_t key,unsigned int *bits);
This function will return the public key algorithm of an OpenPGP certificate.
If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent.
|
is an OpenPGP key |
|
if bits is non null it will hold the size of the parameters' in bits |
Returns : |
a member of the gnutls_pk_algorithm_t enumeration on success, or a negative error code on error. |
Since 2.4.0
int gnutls_openpgp_privkey_import (gnutls_openpgp_privkey_t key,const gnutls_datum_t *data,gnutls_openpgp_crt_fmt_t format,const char *password,unsigned int flags);
This function will convert the given RAW or Base64 encoded key to the native gnutls_openpgp_privkey_t format. The output will be stored in 'key'.
|
The structure to store the parsed key. |
|
The RAW or BASE64 encoded key. |
|
One of gnutls_openpgp_crt_fmt_t elements. |
|
not used for now |
|
should be (0) |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_privkey_get_fingerprint (gnutls_openpgp_privkey_t key,void *fpr,size_t *fprlen);
Get the fingerprint of the OpenPGP key. Depends on the algorithm, the fingerprint can be 16 or 20 bytes.
|
the raw data that contains the OpenPGP secret key. |
|
the buffer to save the fingerprint, must hold at least 20 bytes. |
|
the integer to save the length of the fingerprint. |
Returns : |
On success, 0 is returned, or an error code. |
Since 2.4.0
int gnutls_openpgp_privkey_get_subkey_fingerprint (gnutls_openpgp_privkey_t key,unsigned int idx,void *fpr,size_t *fprlen);
Get the fingerprint of an OpenPGP subkey. Depends on the algorithm, the fingerprint can be 16 or 20 bytes.
|
the raw data that contains the OpenPGP secret key. |
|
the subkey index |
|
the buffer to save the fingerprint, must hold at least 20 bytes. |
|
the integer to save the length of the fingerprint. |
Returns : |
On success, 0 is returned, or an error code. |
Since 2.4.0
int gnutls_openpgp_privkey_get_key_id (gnutls_openpgp_privkey_t key,gnutls_openpgp_keyid_t keyid);
Get key-id.
|
the structure that contains the OpenPGP secret key. |
|
the buffer to save the keyid. |
Returns : |
the 64-bit keyID of the OpenPGP key. |
Since 2.4.0
int gnutls_openpgp_privkey_get_subkey_count
(gnutls_openpgp_privkey_t key);
This function will return the number of subkeys present in the given OpenPGP certificate.
|
is an OpenPGP key |
Returns : |
the number of subkeys, or a negative error code on error. |
Since 2.4.0
int gnutls_openpgp_privkey_get_subkey_idx (gnutls_openpgp_privkey_t key,const gnutls_openpgp_keyid_t keyid);
Get index of subkey.
|
the structure that contains the OpenPGP private key. |
|
the keyid. |
Returns : |
the index of the subkey or a negative error value. |
Since 2.4.0
int gnutls_openpgp_privkey_get_subkey_revoked_status (gnutls_openpgp_privkey_t key,unsigned int idx);
Get revocation status of key.
|
the structure that contains the OpenPGP private key. |
|
is the subkey index |
Returns : |
true (1) if the key has been revoked, or false (0) if it has not, or a negative error code indicates an error. |
Since 2.4.0
int gnutls_openpgp_privkey_get_revoked_status
(gnutls_openpgp_privkey_t key);
Get revocation status of key.
|
the structure that contains the OpenPGP private key. |
Returns : |
true (1) if the key has been revoked, or false (0) if it has not, or a negative error code indicates an error. |
Since 2.4.0
gnutls_pk_algorithm_t gnutls_openpgp_privkey_get_subkey_pk_algorithm (gnutls_openpgp_privkey_t key,unsigned int idx,unsigned int *bits);
This function will return the public key algorithm of a subkey of an OpenPGP certificate.
If bits is non null, it should have enough size to hold the parameters size in bits. For RSA the bits returned is the modulus. For DSA the bits returned are of the public exponent.
|
is an OpenPGP key |
|
is the subkey index |
|
if bits is non null it will hold the size of the parameters' in bits |
Returns : |
a member of the gnutls_pk_algorithm_t enumeration on success, or a negative error code on error. |
Since 2.4.0
time_t gnutls_openpgp_privkey_get_subkey_expiration_time (gnutls_openpgp_privkey_t key,unsigned int idx);
Get subkey expiration time. A value of '0' means that the key doesn't expire at all.
|
the structure that contains the OpenPGP private key. |
|
the subkey index |
Returns : |
the time when the OpenPGP key expires. |
Since 2.4.0
int gnutls_openpgp_privkey_get_subkey_id (gnutls_openpgp_privkey_t key,unsigned int idx,gnutls_openpgp_keyid_t keyid);
Get the key-id for the subkey.
|
the structure that contains the OpenPGP secret key. |
|
the subkey index |
|
the buffer to save the keyid. |
Returns : |
the 64-bit keyID of the OpenPGP key. |
Since 2.4.0
time_t gnutls_openpgp_privkey_get_subkey_creation_time (gnutls_openpgp_privkey_t key,unsigned int idx);
Get subkey creation time.
|
the structure that contains the OpenPGP private key. |
|
the subkey index |
Returns : |
the timestamp when the OpenPGP key was created. |
Since 2.4.0
int gnutls_openpgp_privkey_export_subkey_dsa_raw (gnutls_openpgp_privkey_t pkey,unsigned int idx,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y,gnutls_datum_t *x);
This function will export the DSA private key's parameters found
in the given certificate. The new parameters will be allocated
using gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
Is the subkey index |
|
will hold the p |
|
will hold the q |
|
will hold the g |
|
will hold the y |
|
will hold the x |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_privkey_export_subkey_rsa_raw (gnutls_openpgp_privkey_t pkey,unsigned int idx,gnutls_datum_t *m,gnutls_datum_t *e,gnutls_datum_t *d,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *u);
This function will export the RSA private key's parameters found in
the given structure. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
Is the subkey index |
|
will hold the modulus |
|
will hold the public exponent |
|
will hold the private exponent |
|
will hold the first prime (p) |
|
will hold the second prime (q) |
|
will hold the coefficient |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_privkey_export_dsa_raw (gnutls_openpgp_privkey_t pkey,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *g,gnutls_datum_t *y,gnutls_datum_t *x);
This function will export the DSA private key's parameters found in
the given certificate. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
will hold the p |
|
will hold the q |
|
will hold the g |
|
will hold the y |
|
will hold the x |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_privkey_export_rsa_raw (gnutls_openpgp_privkey_t pkey,gnutls_datum_t *m,gnutls_datum_t *e,gnutls_datum_t *d,gnutls_datum_t *p,gnutls_datum_t *q,gnutls_datum_t *u);
This function will export the RSA private key's parameters found in
the given structure. The new parameters will be allocated using
gnutls_malloc() and will be stored in the appropriate datum.
|
Holds the certificate |
|
will hold the modulus |
|
will hold the public exponent |
|
will hold the private exponent |
|
will hold the first prime (p) |
|
will hold the second prime (q) |
|
will hold the coefficient |
Returns : |
GNUTLS_E_SUCCESS on success, otherwise a negative error code. |
Since 2.4.0
int gnutls_openpgp_privkey_export (gnutls_openpgp_privkey_t key,gnutls_openpgp_crt_fmt_t format,const char *password,unsigned int flags,void *output_data,size_t *output_data_size);
This function will convert the given key to RAW or Base64 format. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUFFER will be returned.
|
Holds the key. |
|
One of gnutls_openpgp_crt_fmt_t elements. |
|
the password that will be used to encrypt the key. (unused for now) |
|
(0) for future compatibility |
|
will contain the key base64 encoded or raw |
|
holds the size of output_data (and will be replaced by the actual size of parameters) |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
Since 2.4.0
int gnutls_openpgp_privkey_set_preferred_key_id (gnutls_openpgp_privkey_t key,const gnutls_openpgp_keyid_t keyid);
This allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling.
If the provided keyid is NULL then the master key is
set as preferred.
|
the structure that contains the OpenPGP public key. |
|
the selected keyid |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned,
otherwise a negative error code is returned. |
int gnutls_openpgp_privkey_get_preferred_key_id (gnutls_openpgp_privkey_t key,gnutls_openpgp_keyid_t keyid);
Get the preferred key-id for the key.
|
the structure that contains the OpenPGP public key. |
|
the struct to save the keyid. |
Returns : |
the 64-bit preferred keyID of the OpenPGP key, or if it
hasn't been set it returns GNUTLS_E_INVALID_REQUEST. |
int gnutls_openpgp_crt_get_auth_subkey (gnutls_openpgp_crt_t crt,gnutls_openpgp_keyid_t keyid,unsigned int flag);
Returns the 64-bit keyID of the first valid OpenPGP subkey marked for authentication. If flag is non-zero and no authentication subkey exists, then a valid subkey will be returned even if it is not marked for authentication.
|
the structure that contains the OpenPGP public key. |
|
the struct to save the keyid. |
|
Non-zero indicates that a valid subkey is always returned. |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_keyring_init (gnutls_openpgp_keyring_t *keyring);
This function will initialize an keyring structure.
|
The structure to be initialized |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
void gnutls_openpgp_keyring_deinit (gnutls_openpgp_keyring_t keyring);
This function will deinitialize a keyring structure.
|
The structure to be initialized |
int gnutls_openpgp_keyring_import (gnutls_openpgp_keyring_t keyring,const gnutls_datum_t *data,gnutls_openpgp_crt_fmt_t format);
This function will convert the given RAW or Base64 encoded keyring to the native gnutls_openpgp_keyring_t format. The output will be stored in 'keyring'.
|
The structure to store the parsed key. |
|
The RAW or BASE64 encoded keyring. |
|
One of gnutls_openpgp_keyring_fmt elements. |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_keyring_check_id (gnutls_openpgp_keyring_t ring,const gnutls_openpgp_keyid_t keyid,unsigned int flags);
Check if a given key ID exists in the keyring.
|
holds the keyring to check against |
|
will hold the keyid to check for. |
|
unused (should be 0) |
Returns : |
GNUTLS_E_SUCCESS on success (if keyid exists) and a
negative error code on failure. |
int gnutls_openpgp_crt_verify_ring (gnutls_openpgp_crt_t key,gnutls_openpgp_keyring_t keyring,unsigned int flags,unsigned int *verify);
Verify all signatures in the key, using the given set of keys (keyring).
The key verification output will be put in verify and will be one
or more of the gnutls_certificate_status_t enumerated elements
bitwise or'd.
Note that this function does not verify using any "web of trust". You may use GnuPG for that purpose, or any other external PGP application.
|
the structure that holds the key. |
|
holds the keyring to check against |
|
unused (should be 0) |
|
will hold the certificate verification output. |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_crt_verify_self (gnutls_openpgp_crt_t key,unsigned int flags,unsigned int *verify);
Verifies the self signature in the key. The key verification
output will be put in verify and will be one or more of the
gnutls_certificate_status_t enumerated elements bitwise or'd.
|
the structure that holds the key. |
|
unused (should be 0) |
|
will hold the key verification output. |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_keyring_get_crt (gnutls_openpgp_keyring_t ring,unsigned int idx,gnutls_openpgp_crt_t *cert);
This function will extract an OpenPGP certificate from the given
keyring. If the index given is out of range
GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned. The
returned structure needs to be deinited.
|
Holds the keyring. |
|
the index of the certificate to export |
|
An uninitialized gnutls_openpgp_crt_t structure |
Returns : |
GNUTLS_E_SUCCESS on success, or an error code. |
int gnutls_openpgp_keyring_get_crt_count
(gnutls_openpgp_keyring_t ring);
This function will return the number of OpenPGP certificates present in the given keyring.
|
is an OpenPGP key ring |
Returns : |
the number of subkeys, or a negative error code on error. |
int (*gnutls_openpgp_recv_key_func) (gnutls_session_t session,const unsigned char *keyfpr,unsigned int keyfpr_length,gnutls_datum_t *key);
A callback of this type is used to retrieve OpenPGP keys. Only
useful on the server, and will only be used if the peer send a key
fingerprint instead of a full key. See also
gnutls_openpgp_set_recv_key_function().
|
a TLS session |
|
key fingerprint |
|
length of key fingerprint |
|
output key. |
Returns : |
On success, GNUTLS_E_SUCCESS (zero) is returned,
otherwise an error code is returned. |
void gnutls_openpgp_set_recv_key_function (gnutls_session_t session,gnutls_openpgp_recv_key_func func);
This funtion will set a key retrieval function for OpenPGP keys. This callback is only useful in server side, and will be used if the peer sent a key fingerprint instead of a full key.
|
a TLS session |
|
the callback |
int gnutls_certificate_set_openpgp_key (gnutls_certificate_credentials_t res,gnutls_openpgp_crt_t crt,gnutls_openpgp_privkey_t pkey);
This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates exist for the server).
Note that this function requires that the preferred key ids have
been set and be used. See gnutls_openpgp_crt_set_preferred_key_id().
Otherwise the master key will be used.
|
is a gnutls_certificate_credentials_t structure. |
|
contains an openpgp public key |
|
is an openpgp private key |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned,
otherwise a negative error code is returned. |
int gnutls_certificate_set_openpgp_key_file (gnutls_certificate_credentials_t res,const char *certfile,const char *keyfile,gnutls_openpgp_crt_fmt_t format);
This funtion is used to load OpenPGP keys into the GnuTLS credentials structure. The file should contain at least one valid non encrypted subkey.
|
the destination context to save the data. |
|
the file that contains the public key. |
|
the file that contains the secret key. |
|
the format of the keys |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value. |
int gnutls_certificate_set_openpgp_key_mem (gnutls_certificate_credentials_t res,const gnutls_datum_t *cert,const gnutls_datum_t *key,gnutls_openpgp_crt_fmt_t format);
This funtion is used to load OpenPGP keys into the GnuTLS credential structure. The datum should contain at least one valid non encrypted subkey.
|
the destination context to save the data. |
|
the datum that contains the public key. |
|
the datum that contains the secret key. |
|
the format of the keys |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value. |
int gnutls_certificate_set_openpgp_key_file2 (gnutls_certificate_credentials_t res,const char *certfile,const char *keyfile,const char *subkey_id,gnutls_openpgp_crt_fmt_t format);
This funtion is used to load OpenPGP keys into the GnuTLS credential structure. The file should contain at least one valid non encrypted subkey.
The special keyword "auto" is also accepted as subkey_id. In that
case the gnutls_openpgp_crt_get_auth_subkey() will be used to
retrieve the subkey.
|
the destination context to save the data. |
|
the file that contains the public key. |
|
the file that contains the secret key. |
|
a hex encoded subkey id |
|
the format of the keys |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value. |
Since 2.4.0
int gnutls_certificate_set_openpgp_key_mem2 (gnutls_certificate_credentials_t res,const gnutls_datum_t *cert,const gnutls_datum_t *key,const char *subkey_id,gnutls_openpgp_crt_fmt_t format);
This funtion is used to load OpenPGP keys into the GnuTLS credentials structure. The datum should contain at least one valid non encrypted subkey.
The special keyword "auto" is also accepted as subkey_id. In that
case the gnutls_openpgp_crt_get_auth_subkey() will be used to
retrieve the subkey.
|
the destination context to save the data. |
|
the datum that contains the public key. |
|
the datum that contains the secret key. |
|
a hex encoded subkey id |
|
the format of the keys |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value. |
Since 2.4.0
int gnutls_certificate_set_openpgp_keyring_mem (gnutls_certificate_credentials_t c,const unsigned char *data,size_t dlen,gnutls_openpgp_crt_fmt_t format);
The function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key when it is needed for an operations. The keyring will also be used at the verification functions.
|
A certificate credentials structure |
|
buffer with keyring data. |
|
length of data buffer. |
|
the format of the keyring |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value. |
int gnutls_certificate_set_openpgp_keyring_file (gnutls_certificate_credentials_t c,const char *file,gnutls_openpgp_crt_fmt_t format);
The function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key when it is needed for an operations. The keyring will also be used at the verification functions.
|
A certificate credentials structure |
|
filename of the keyring. |
|
format of keyring. |
Returns : |
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value. |