1 .\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.35)
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
9 .de Vb \" Begin verbatim text
14 .de Ve \" End verbatim text
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
45 .\" Escape single quotes in literal strings from groff's Unicode transform.
49 .\" If the F register is >0, we'll generate index entries on stderr for
50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51 .\" entries marked with X<> in POD. Of course, you'll have to process the
52 .\" output yourself in some meaningful fashion.
54 .\" Avoid warning from groff about undefined register 'F'.
60 . tm Index:\\$1\t\\n%\t"\\$2"
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85 . \" simple accents for nroff and troff
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
129 .\" ========================================================================
131 .IX Title "SSL_CTX_use_serverinfo 3"
132 .TH SSL_CTX_use_serverinfo 3 "2017-12-07" "1.0.2n" "OpenSSL"
133 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
134 .\" way too many mistakes in technical documents.
138 SSL_CTX_use_serverinfo, SSL_CTX_use_serverinfo_file \- use serverinfo extension
140 .IX Header "SYNOPSIS"
142 \& #include <openssl/ssl.h>
144 \& int SSL_CTX_use_serverinfo(SSL_CTX *ctx, const unsigned char *serverinfo,
145 \& size_t serverinfo_length);
147 \& int SSL_CTX_use_serverinfo_file(SSL_CTX *ctx, const char *file);
150 .IX Header "DESCRIPTION"
151 These functions load \*(L"serverinfo\*(R" \s-1TLS\s0 ServerHello Extensions into the \s-1SSL_CTX.
152 A \s0\*(L"serverinfo\*(R" extension is returned in response to an empty ClientHello
155 \&\fISSL_CTX_use_serverinfo()\fR loads one or more serverinfo extensions from
156 a byte array into \fBctx\fR. The extensions must be concatenated into a
157 sequence of bytes. Each extension must consist of a 2\-byte Extension Type,
158 a 2\-byte length, and then length bytes of extension_data.
160 \&\fISSL_CTX_use_serverinfo_file()\fR loads one or more serverinfo extensions from
161 \&\fBfile\fR into \fBctx\fR. The extensions must be in \s-1PEM\s0 format. Each extension
162 must consist of a 2\-byte Extension Type, a 2\-byte length, and then length
163 bytes of extension_data. Each \s-1PEM\s0 extension name must begin with the phrase
164 \&\*(L"\s-1BEGIN SERVERINFO FOR \*(R".\s0
166 If more than one certificate (\s-1RSA/DSA\s0) is installed using
167 \&\fISSL_CTX_use_certificate()\fR, the serverinfo extension will be loaded into the
168 last certificate installed. If e.g. the last item was a \s-1RSA\s0 certificate, the
169 loaded serverinfo extension data will be loaded for that certificate. To
170 use the serverinfo extension for multiple certificates,
171 \&\fISSL_CTX_use_serverinfo()\fR needs to be called multiple times, once \fBafter\fR
172 each time a certificate is loaded.
176 .IX Header "RETURN VALUES"
177 On success, the functions return 1.
178 On failure, the functions return 0. Check out the error stack to find out
181 .IX Header "SEE ALSO"