acc9938ba5
directly by SSL/TLS SHA2 certificates are becoming more common and applications that only call SSL_library_init() and not OpenSSL_add_all_alrgorithms() will fail when verifying certificates. Update docs.
58 lines
1.4 KiB
Plaintext
58 lines
1.4 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
SSL_library_init, OpenSSL_add_ssl_algorithms, SSLeay_add_ssl_algorithms
|
|
- initialize SSL library by registering algorithms
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/ssl.h>
|
|
|
|
int SSL_library_init(void);
|
|
#define OpenSSL_add_ssl_algorithms() SSL_library_init()
|
|
#define SSLeay_add_ssl_algorithms() SSL_library_init()
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
SSL_library_init() registers the available SSL/TLS ciphers and digests.
|
|
|
|
OpenSSL_add_ssl_algorithms() and SSLeay_add_ssl_algorithms() are synonyms
|
|
for SSL_library_init().
|
|
|
|
=head1 NOTES
|
|
|
|
SSL_library_init() must be called before any other action takes place.
|
|
SSL_library_init() is not reentrant.
|
|
|
|
=head1 WARNING
|
|
|
|
SSL_library_init() adds ciphers and digests used directly and indirectly by
|
|
SSL/TLS.
|
|
|
|
=head1 EXAMPLES
|
|
|
|
A typical TLS/SSL application will start with the library initialization,
|
|
and provide readable error messages.
|
|
|
|
SSL_load_error_strings(); /* readable error messages */
|
|
SSL_library_init(); /* initialize library */
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
SSL_library_init() always returns "1", so it is safe to discard the return
|
|
value.
|
|
|
|
=head1 NOTES
|
|
|
|
OpenSSL 0.9.8o and 1.0.0a and later added SHA2 algorithms to SSL_library_init().
|
|
Applications which need to use SHA2 in earlier versions of OpenSSL should call
|
|
OpenSSL_add_all_algorithms() as well.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<ssl(3)|ssl(3)>, L<SSL_load_error_strings(3)|SSL_load_error_strings(3)>,
|
|
L<RAND_add(3)|RAND_add(3)>
|
|
|
|
=cut
|