1gnutls_x509_crt_get_dn3(3)          gnutls          gnutls_x509_crt_get_dn3(3)
2
3
4

NAME

6       gnutls_x509_crt_get_dn3 - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int  gnutls_x509_crt_get_dn3(gnutls_x509_crt_t  cert,  gnutls_datum_t *
12       dn, unsigned flags);
13

ARGUMENTS

15       gnutls_x509_crt_t cert
16                   should contain a gnutls_x509_crt_t type
17
18       gnutls_datum_t * dn
19                   a pointer to a structure to hold the name;  must  be  freed
20                   using gnutls_free()
21
22       unsigned flags
23                   zero or GNUTLS_X509_DN_FLAG_COMPAT
24

DESCRIPTION

26       This  function  will  allocate buffer and copy the name of the Certifi‐
27       cate.  The name will be in  the  form  "C=xxxx,O=yyyy,CN=zzzz"  as  de‐
28       scribed  in  RFC4514. The output string will be ASCII or UTF-8 encoded,
29       depending on the certificate data.
30
31       When the flag GNUTLS_X509_DN_FLAG_COMPAT is specified, the output  for‐
32       mat  will  match  the  format  output  by previous to 3.5.6 versions of
33       GnuTLS which was not not fully RFC4514-compliant.
34

RETURNS

36       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative  er‐
37       ror value.
38

SINCE

40       3.5.7
41

REPORTING BUGS

43       Report bugs to <bugs@gnutls.org>.
44       Home page: https://www.gnutls.org
45
46

48       Copyright © 2001- Free Software Foundation, Inc., and others.
49       Copying  and  distribution  of this file, with or without modification,
50       are permitted in any medium without royalty provided the copyright  no‐
51       tice and this notice are preserved.
52

SEE ALSO

54       The  full  documentation  for gnutls is maintained as a Texinfo manual.
55       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
56       visit
57
58       https://www.gnutls.org/manual/
59
60gnutls                               3.7.2          gnutls_x509_crt_get_dn3(3)
Impressum