1gnutls_x509_crt_set_dn(3)           gnutls           gnutls_x509_crt_set_dn(3)
2
3
4

NAME

6       gnutls_x509_crt_set_dn - API function
7

SYNOPSIS

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

ARGUMENTS

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

DESCRIPTION

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 au‐
30       tomatic  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

RETURNS

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

REPORTING BUGS

39       Report bugs to <bugs@gnutls.org>.
40       Home page: https://www.gnutls.org
41
42

44       Copyright © 2001-2023 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 no‐
47       tice and this notice are preserved.
48

SEE ALSO

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.8.2           gnutls_x509_crt_set_dn(3)
Impressum