Blob Blame History Raw




@deftypefun {int} {gnutls_x509_dn_get_str2} (gnutls_x509_dn_t @var{dn}, gnutls_datum_t * @var{str}, unsigned @var{flags})
@var{dn}: a pointer to DN

@var{str}: a datum that will hold the name

@var{flags}: zero or @code{GNUTLS_X509_DN_FLAG_COMPAT} 

This function will allocate buffer and copy the name in the provided DN.
The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as
described in RFC4514. The output string will be ASCII or UTF-8
encoded, depending on the certificate data.

When the flag @code{GNUTLS_X509_DN_FLAG_COMPAT}  is specified, the output
format will match the format output by previous to 3.5.6 versions of GnuTLS
which was not not fully RFC4514-compliant.

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
negative error value.

@strong{Since:} 3.5.7
@end deftypefun