Blame doc/functions/gnutls_x509_dn_get_str2

Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
@deftypefun {int} {gnutls_x509_dn_get_str2} (gnutls_x509_dn_t @var{dn}, gnutls_datum_t * @var{str}, unsigned @var{flags})
Packit aea12f
@var{dn}: a pointer to DN
Packit aea12f
Packit aea12f
@var{str}: a datum that will hold the name
Packit aea12f
Packit aea12f
@var{flags}: zero or @code{GNUTLS_X509_DN_FLAG_COMPAT} 
Packit aea12f
Packit aea12f
This function will allocate buffer and copy the name in the provided DN.
Packit aea12f
The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as
Packit aea12f
described in RFC4514. The output string will be ASCII or UTF-8
Packit aea12f
encoded, depending on the certificate data.
Packit aea12f
Packit aea12f
When the flag @code{GNUTLS_X509_DN_FLAG_COMPAT}  is specified, the output
Packit aea12f
format will match the format output by previous to 3.5.6 versions of GnuTLS
Packit aea12f
which was not not fully RFC4514-compliant.
Packit aea12f
Packit aea12f
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit aea12f
negative error value.
Packit aea12f
Packit aea12f
@strong{Since:} 3.5.7
Packit aea12f
@end deftypefun