diff options
Diffstat (limited to 'doc/man3/SSL_CTX_set_cert_cb.pod')
| -rw-r--r-- | doc/man3/SSL_CTX_set_cert_cb.pod | 20 |
1 files changed, 9 insertions, 11 deletions
diff --git a/doc/man3/SSL_CTX_set_cert_cb.pod b/doc/man3/SSL_CTX_set_cert_cb.pod index da084cb1f45c..c3966782c0dc 100644 --- a/doc/man3/SSL_CTX_set_cert_cb.pod +++ b/doc/man3/SSL_CTX_set_cert_cb.pod @@ -12,26 +12,24 @@ SSL_CTX_set_cert_cb, SSL_set_cert_cb - handle certificate callback function void *arg); void SSL_set_cert_cb(SSL *s, int (*cert_cb)(SSL *ssl, void *arg), void *arg); - int (*cert_cb)(SSL *ssl, void *arg); - =head1 DESCRIPTION -SSL_CTX_set_cert_cb() and SSL_set_cert_cb() sets the cert_cb() callback, -B<arg> value is pointer which is passed to the application callback. +SSL_CTX_set_cert_cb() and SSL_set_cert_cb() sets the I<cert_cb> callback, +I<arg> value is pointer which is passed to the application callback. -When cert_cb() is NULL, no callback function is used. +When I<cert_cb> is NULL, no callback function is used. -cert_cb() is the application defined callback. It is called before a +I<cert_cb> is the application defined callback. It is called before a certificate will be used by a client or server. The callback can then inspect -the passed B<ssl> structure and set or clear any appropriate certificates. If +the passed I<ssl> structure and set or clear any appropriate certificates. If the callback is successful it B<MUST> return 1 even if no certificates have been set. A zero is returned on error which will abort the handshake with a fatal internal error alert. A negative return value will suspend the handshake and the handshake function will return immediately. L<SSL_get_error(3)> will return SSL_ERROR_WANT_X509_LOOKUP to indicate, that the handshake was suspended. The next call to the handshake -function will again lead to the call of cert_cb(). It is the job of the -cert_cb() to store information about the state of the last call, +function will again lead to the call of I<cert_cb>. It is the job of the +I<cert_cb> to store information about the state of the last call, if required to continue. =head1 NOTES @@ -72,9 +70,9 @@ L<SSL_clear(3)>, L<SSL_free(3)> =head1 COPYRIGHT -Copyright 2014-2018 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2014-2020 The OpenSSL Project Authors. All Rights Reserved. -Licensed under the OpenSSL license (the "License"). You may not use +Licensed under the Apache License 2.0 (the "License"). You may not use 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>. |