1gnutls_x509_crt_set_subject_alt_name(g3n)utglnsutls_x509_crt_set_subject_alt_name(3)
2
3
4
6 gnutls_x509_crt_set_subject_alt_name - API function
7
9 #include <gnutls/x509.h>
10
11 int gnutls_x509_crt_set_subject_alt_name(gnutls_x509_crt_t crt,
12 gnutls_x509_subject_alt_name_t type, const void * data, unsigned int
13 data_size, unsigned int flags);
14
16 gnutls_x509_crt_t crt
17 a certificate of type gnutls_x509_crt_t
18
19 gnutls_x509_subject_alt_name_t type
20 is one of the gnutls_x509_subject_alt_name_t enumerations
21
22 const void * data
23 The data to be set
24
25 unsigned int data_size
26 The size of data to be set
27
28 unsigned int flags
29 GNUTLS_FSAN_SET to clear previous data or GNUTLS_FSAN_AP‐
30 PEND to append.
31
33 This function will set the subject alternative name certificate exten‐
34 sion. It can set the following types: GNUTLS_SAN_DNSNAME as a text
35 string, GNUTLS_SAN_RFC822NAME as a text string, GNUTLS_SAN_URI as a
36 text string, GNUTLS_SAN_IPADDRESS as a binary IP address (4 or 16
37 bytes), GNUTLS_SAN_OTHERNAME_XMPP as a UTF8 string (since 3.5.0).
38
39 Since version 3.5.7 the GNUTLS_SAN_RFC822NAME, GNUTLS_SAN_DNSNAME, and
40 GNUTLS_SAN_OTHERNAME_XMPP are converted to ACE format when necessary.
41
43 On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er‐
44 ror value.
45
47 2.6.0
48
50 Report bugs to <bugs@gnutls.org>.
51 Home page: https://www.gnutls.org
52
53
55 Copyright © 2001-2023 Free Software Foundation, Inc., and others.
56 Copying and distribution of this file, with or without modification,
57 are permitted in any medium without royalty provided the copyright no‐
58 tice and this notice are preserved.
59
61 The full documentation for gnutls is maintained as a Texinfo manual.
62 If the /usr/share/doc/gnutls/ directory does not contain the HTML form
63 visit
64
65 https://www.gnutls.org/manual/
66
67gnutls 3.8g.n2utls_x509_crt_set_subject_alt_name(3)