1gnutls_x509_crt_set_dn(3) gnutls gnutls_x509_crt_set_dn(3)
2
3
4
6 gnutls_x509_crt_set_dn - API function
7
9 #include <gnutls/x509.h>
10
11 int gnutls_x509_crt_set_dn(gnutls_x509_crt_t crt, const char * dn,
12 const char ** err);
13
15 gnutls_x509_crt_t crt
16 a certificate of type gnutls_x509_crt_t
17
18 const char * dn
19 a comma separated DN string (RFC4514)
20
21 const char ** err
22 indicates the error position (if any)
23
25 This function will set the DN on the provided certificate. The input
26 string should be plain ASCII or UTF-8 encoded. On DN parsing error
27 GNUTLS_E_PARSING_ERROR is returned.
28
29 Note that DNs are not expected to hold DNS information, and thus no
30 automatic IDNA conversions are attempted when using this function. If
31 that is required (e.g., store a domain in CN), process the correspond‐
32 ing input with gnutls_idna_map().
33
35 On success, GNUTLS_E_SUCCESS [22m(0) is returned, otherwise a negative
36 error value.
37
39 Report bugs to <bugs@gnutls.org>.
40 Home page: https://www.gnutls.org
41
42
44 Copyright © 2001- Free Software Foundation, Inc., and others.
45 Copying and distribution of this file, with or without modification,
46 are permitted in any medium without royalty provided the copyright
47 notice and this notice are preserved.
48
50 The full documentation for gnutls is maintained as a Texinfo manual.
51 If the /usr/share/doc/gnutls/ directory does not contain the HTML form
52 visit
53
54 https://www.gnutls.org/manual/
55
56gnutls 3.6.15 gnutls_x509_crt_set_dn(3)