xref: /freebsd/crypto/openssl/doc/man3/SSL_CONF_CTX_set_ssl_ctx.pod (revision ad991e4c142ebabad7aef488ad97b189ecabb270)
1=pod
2
3=head1 NAME
4
5SSL_CONF_CTX_finish,
6SSL_CONF_CTX_set_ssl_ctx, SSL_CONF_CTX_set_ssl - set context to configure
7
8=head1 SYNOPSIS
9
10 #include <openssl/ssl.h>
11
12 void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx);
13 void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl);
14 int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx);
15
16=head1 DESCRIPTION
17
18SSL_CONF_CTX_set_ssl_ctx() sets the context associated with B<cctx> to the
19B<SSL_CTX> structure B<ctx>. Any previous B<SSL> or B<SSL_CTX> associated with
20B<cctx> is cleared. Subsequent calls to SSL_CONF_cmd() will be sent to
21B<ctx>.
22
23SSL_CONF_CTX_set_ssl() sets the context associated with B<cctx> to the
24B<SSL> structure B<ssl>. Any previous B<SSL> or B<SSL_CTX> associated with
25B<cctx> is cleared. Subsequent calls to SSL_CONF_cmd() will be sent to
26B<ssl>.
27
28The function SSL_CONF_CTX_finish() must be called after all configuration
29operations have been completed. It is used to finalise any operations
30or to process defaults.
31
32=head1 NOTES
33
34The context need not be set or it can be set to B<NULL> in which case only
35syntax checking of commands is performed, where possible.
36
37=head1 RETURN VALUES
38
39SSL_CONF_CTX_set_ssl_ctx() and SSL_CTX_set_ssl() do not return a value.
40
41SSL_CONF_CTX_finish() returns 1 for success and 0 for failure.
42
43=head1 SEE ALSO
44
45L<ssl(7)>,
46L<SSL_CONF_CTX_new(3)>,
47L<SSL_CONF_CTX_set_flags(3)>,
48L<SSL_CONF_CTX_set1_prefix(3)>,
49L<SSL_CONF_cmd(3)>,
50L<SSL_CONF_cmd_argv(3)>
51
52=head1 HISTORY
53
54These functions were added in OpenSSL 1.0.2.
55
56=head1 COPYRIGHT
57
58Copyright 2012-2023 The OpenSSL Project Authors. All Rights Reserved.
59
60Licensed under the Apache License 2.0 (the "License").  You may not use
61this file except in compliance with the License.  You can obtain a copy
62in the file LICENSE in the source distribution or at
63L<https://www.openssl.org/source/license.html>.
64
65=cut
66