2012-11-17 03:12:24 +08:00
|
|
|
=pod
|
|
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
|
|
SSL_CONF_CTX_set1_prefix - Set configuration context command prefix
|
|
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
|
|
#include <openssl/ssl.h>
|
|
|
|
|
|
|
|
|
|
unsigned int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *prefix);
|
|
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
|
|
The function SSL_CONF_CTX_set1_prefix() sets the command prefix of B<cctx>
|
|
|
|
|
to B<prefix>. If B<prefix> is B<NULL> it is restored to the default value.
|
|
|
|
|
|
|
|
|
|
=head1 NOTES
|
|
|
|
|
|
2017-03-28 14:30:43 +08:00
|
|
|
Command prefixes alter the commands recognised by subsequent SSL_CONF_cmd()
|
2012-11-17 08:21:34 +08:00
|
|
|
calls. For example for files, if the prefix "SSL" is set then command names
|
|
|
|
|
such as "SSLProtocol", "SSLOptions" etc. are recognised instead of "Protocol"
|
2016-05-20 20:11:46 +08:00
|
|
|
and "Options". Similarly for command lines if the prefix is "--ssl-" then
|
2012-11-17 03:12:24 +08:00
|
|
|
"--ssl-no_tls1_2" is recognised instead of "-no_tls1_2".
|
|
|
|
|
|
|
|
|
|
If the B<SSL_CONF_FLAG_CMDLINE> flag is set then prefix checks are case
|
|
|
|
|
sensitive and "-" is the default. In the unlikely even an application
|
|
|
|
|
explicitly wants to set no prefix it must be explicitly set to "".
|
|
|
|
|
|
|
|
|
|
If the B<SSL_CONF_FLAG_FILE> flag is set then prefix checks are case
|
|
|
|
|
insensitive and no prefix is the default.
|
|
|
|
|
|
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
|
|
|
|
|
|
SSL_CONF_CTX_set1_prefix() returns 1 for success and 0 for failure.
|
|
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
2019-11-02 00:27:29 +08:00
|
|
|
L<ssl(7)>,
|
2015-08-18 03:21:33 +08:00
|
|
|
L<SSL_CONF_CTX_new(3)>,
|
|
|
|
|
L<SSL_CONF_CTX_set_flags(3)>,
|
|
|
|
|
L<SSL_CONF_CTX_set_ssl_ctx(3)>,
|
|
|
|
|
L<SSL_CONF_cmd(3)>,
|
|
|
|
|
L<SSL_CONF_cmd_argv(3)>
|
2012-11-17 03:12:24 +08:00
|
|
|
|
|
|
|
|
=head1 HISTORY
|
|
|
|
|
|
2018-12-09 08:02:36 +08:00
|
|
|
These functions were added in OpenSSL 1.0.2.
|
2012-11-17 03:12:24 +08:00
|
|
|
|
2016-05-18 23:44:05 +08:00
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
|
|
Copyright 2012-2016 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
|
|
2018-12-06 21:04:44 +08:00
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
2016-05-18 23:44:05 +08:00
|
|
|
this file except in compliance with the License. You can obtain a copy
|
|
|
|
|
in the file LICENSE in the source distribution or at
|
|
|
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
|
|
|
|
|
|
=cut
|
