5 SSL_CTX_use_serverinfo, SSL_CTX_use_serverinfo_file - use serverinfo extension
9 #include <openssl/ssl.h>
11 int SSL_CTX_use_serverinfo(SSL_CTX *ctx, const unsigned char *serverinfo,
12 size_t serverinfo_length);
14 int SSL_CTX_use_serverinfo_file(SSL_CTX *ctx, const char *file);
18 These functions load "serverinfo" TLS ServerHello Extensions into the SSL_CTX.
19 A "serverinfo" extension is returned in response to an empty ClientHello
22 SSL_CTX_use_serverinfo() loads one or more serverinfo extensions from
23 a byte array into B<ctx>. The extensions must be concatenated into a
24 sequence of bytes. Each extension must consist of a 2-byte Extension Type,
25 a 2-byte length, and then length bytes of extension_data.
27 SSL_CTX_use_serverinfo_file() loads one or more serverinfo extensions from
28 B<file> into B<ctx>. The extensions must be in PEM format. Each extension
29 must consist of a 2-byte Extension Type, a 2-byte length, and then length
30 bytes of extension_data. Each PEM extension name must begin with the phrase
31 "BEGIN SERVERINFO FOR ".
33 If more than one certificate (RSA/DSA) is installed using
34 SSL_CTX_use_certificate(), the serverinfo extension will be loaded into the
35 last certificate installed. If e.g. the last item was a RSA certificate, the
36 loaded serverinfo extension data will be loaded for that certificate. To
37 use the serverinfo extension for multiple certificates,
38 SSL_CTX_use_serverinfo() needs to be called multiple times, once B<after>
39 each time a certificate is loaded.
45 On success, the functions return 1.
46 On failure, the functions return 0. Check out the error stack to find out