gnutls_x509_crt_get_subject_alt_name2 man page

gnutls_x509_crt_get_subject_alt_name2 — API function


#include <gnutls/x509.h>

int gnutls_x509_crt_get_subject_alt_name2(gnutls_x509_crt_t cert, unsigned int seq, void * san, size_t * san_size, unsigned int * san_type, unsigned int * critical);


gnutls_x509_crt_t cert
should contain a gnutls_x509_crt_t type
unsigned int seq
specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.)
void * san
is the place where the alternative name will be copied to
size_t * san_size
holds the size of ret.
unsigned int * san_type
holds the type of the alternative name (one of gnutls_x509_subject_alt_name_t).
unsigned int * critical
will be non-zero if the extension is marked as critical (may be null)


This function will return the alternative names, contained in the given certificate. It is the same as gnutls_x509_crt_get_subject_alt_name() except for the fact that it will return the type of the alternative name in san_type even if the function fails for some reason (i.e. the buffer provided is not enough).


the alternative subject name type on success, one of the enumerated gnutls_x509_subject_alt_name_t. It will return GNUTLS_E_SHORT_MEMORY_BUFFER if san_size is not large enough to hold the value. In that case san_size will be updated with the required size. If the certificate does not have an Alternative name with the specified sequence number then GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.

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



gnutls 3.5.4