summaryrefslogtreecommitdiffstats
path: root/doc/functions/gnutls_x509_crt_get_dn3
diff options
context:
space:
mode:
Diffstat (limited to 'doc/functions/gnutls_x509_crt_get_dn3')
-rw-r--r--doc/functions/gnutls_x509_crt_get_dn325
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/functions/gnutls_x509_crt_get_dn3 b/doc/functions/gnutls_x509_crt_get_dn3
new file mode 100644
index 0000000..53a736b
--- /dev/null
+++ b/doc/functions/gnutls_x509_crt_get_dn3
@@ -0,0 +1,25 @@
+
+
+
+
+@deftypefun {int} {gnutls_x509_crt_get_dn3} (gnutls_x509_crt_t @var{cert}, gnutls_datum_t * @var{dn}, unsigned @var{flags})
+@var{cert}: should contain a @code{gnutls_x509_crt_t} type
+
+@var{dn}: a pointer to a structure to hold the name; must be freed using @code{gnutls_free()}
+
+@var{flags}: zero or @code{GNUTLS_X509_DN_FLAG_COMPAT}
+
+This function will allocate buffer and copy the name of the Certificate.
+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