gnutls_system_key_iter_get_info man page

gnutls_system_key_iter_get_info — API function

Synopsis

#include <gnutls/system-keys.h>

int gnutls_system_key_iter_get_info(gnutls_system_key_iter_t * iter, unsigned cert_type, char ** cert_url, char ** key_url, char ** label, gnutls_datum_t * der, unsigned int flags);

Arguments

gnutls_system_key_iter_t * iter

an iterator of the system keys (must be set to NULL initially)

unsigned cert_type

A value of gnutls_certificate_type_t which indicates the type of certificate to look for

char ** cert_url

The certificate URL of the pair (may be NULL)

char ** key_url

The key URL of the pair (may be NULL)

char ** label

The friendly name (if any) of the pair (may be NULL)

gnutls_datum_t * der

if non-NULL the DER data of the certificate

unsigned int flags

should be zero

Description

This function will return on each call a certificate and key pair URLs, as well as a label associated with them, and the DER-encoded certificate. When the iteration is complete it will return GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE.

Typically  cert_type should be GNUTLS_CRT_X509.

All values set are allocated and must be cleared using gnutls_free(),

Returns

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

Since

3.4.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.6.0 gnutls