FreeBSD manual
download PDF document: gnutls_x509_crt_get_subject_unique_id.3.pdf
gnutls_x509_crt_get_subject_unique_id(3) gnutls
NAME
gnutls_x509_crt_get_subject_unique_id - API function
SYNOPSIS
#include <gnutls/x509.h>
int gnutls_x509_crt_get_subject_unique_id(gnutls_x509_crt_t crt, char *
buf, size_t * buf_size);
ARGUMENTS
gnutls_x509_crt_t crt
Holds the certificate
char * buf user allocated memory buffer, will hold the unique id
size_t * buf_size
size of user allocated memory buffer (on input), will hold
actual size of the unique ID on return.
DESCRIPTION
This function will extract the subjectUniqueID value (if present) for
the given certificate.
If the user allocated memory buffer is not large enough to hold the
full subjectUniqueID, then a GNUTLS_E_SHORT_MEMORY_BUFFER error will be
returned, and buf_size will be set to the actual length.
This function had a bug prior to 3.4.8 that prevented the setting of
NULL buf to discover the buf_size . To use this function safely with
the older versions the buf must be a valid buffer that can hold at
least a single byte if buf_size is zero.
RETURNS
GNUTLS_E_SUCCESS on success, otherwise a negative error code.
REPORTING BUGS
Report bugs to <bugs@gnutls.org>.
Home page: https://www.gnutls.org
COPYRIGHT
Copyright (C) 2001- Free Software Foundation, Inc., and others.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
SEE ALSO
The full documentation for gnutls is maintained as a Texinfo manual.
If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
form visit
https://www.gnutls.org/manual/
gnutls 3.7.9
gnutls_x509_crt_get_subject_unique_id(3)