add SSL_CONF functions and documentation
[openssl.git] / doc / ssl / SSL_CONF_argv.pod
1 =pod
2
3 =head1 NAME
4
5 SSL_CONF_argv - SSL configuration command line processing.
6
7 =head1 SYNOPSIS
8
9  #include <openssl/ssl.h>
10
11  int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv);
12
13 =head1 DESCRIPTION
14
15 The function SSL_CONF_cmd_argv() processes at most two command line
16 arguments from B<pargv> and B<pargc>. The values of B<pargv> and B<pargc>
17 are updated to reflect the number of command options procesed.
18
19 =head1 RETURN VALUES
20
21 SSL_CONF_cmd_argv() returns the number of command arguments processed: 0, 1
22 or 2 or a negative error code.
23
24 If -2 is returned then an argument for a command is missing.
25
26 If -1 is returned the command is recognised but couldn't be processed due
27 to an error: for example a syntax error in the argument.
28
29 =head1 SEE ALSO
30
31 L<SSL_CONF_CTX_new(3)|SSL_CONF_CTX_new(3)>,
32 L<SSL_CONF_CTX_set_flags(3)|SSL_CONF_CTX_set_flags(3)>,
33 L<SSL_CONF_CTX_set1_prefix(3)|SSL_CONF_CTX_set1_prefix(3)>,
34 L<SSL_CONF_CTX_set_ssl_ctx(3)|SSL_CONF_CTX_set_ssl_ctx(3)>,
35 L<SSL_CONF_cmd(3)|SSL_CONF_cmd(3)>
36
37 =head1 HISTORY
38
39 These functions were first added to OpenSSL 1.1.0
40
41 =cut