Blame doc/functions/gnutls_x509_crt_get_issuer_dn

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_x509_crt_get_issuer_dn} (gnutls_x509_crt_t @var{cert}, char * @var{buf}, size_t * @var{buf_size})
Packit Service 4684c1
@var{cert}: should contain a @code{gnutls_x509_crt_t}  type
Packit Service 4684c1
Packit Service 4684c1
@var{buf}: a pointer to a structure to hold the name (may be null)
Packit Service 4684c1
Packit Service 4684c1
@var{buf_size}: initially holds the size of  @code{buf} 
Packit Service 4684c1
Packit Service 4684c1
This function will copy the name of the Certificate issuer in the
Packit Service 4684c1
provided buffer. The name will be in the form
Packit Service 4684c1
"C=xxxx,O=yyyy,CN=zzzz" as described in RFC4514. The output string
Packit Service 4684c1
will be ASCII or UTF-8 encoded, depending on the certificate data.
Packit Service 4684c1
Packit Service 4684c1
If  @code{buf} is null then only the size will be filled.
Packit Service 4684c1
Packit Service 4684c1
This function does not output a fully RFC4514 compliant string, if
Packit Service 4684c1
that is required see @code{gnutls_x509_crt_get_issuer_dn3()} .
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} @code{GNUTLS_E_SHORT_MEMORY_BUFFER}  if the provided buffer is not
Packit Service 4684c1
long enough, and in that case the  @code{buf_size} will be updated
Packit Service 4684c1
with the required size. @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  if
Packit Service 4684c1
the DN does not exist, or another error value on error. On success 0 is returned.
Packit Service 4684c1
@end deftypefun