168651Skris=pod
268651Skris
368651Skris=head1 NAME
468651Skris
568651SkrisSSL_library_init, OpenSSL_add_ssl_algorithms, SSLeay_add_ssl_algorithms
668651Skris- initialize SSL library by registering algorithms
768651Skris
868651Skris=head1 SYNOPSIS
968651Skris
1068651Skris #include <openssl/ssl.h>
1168651Skris
1268651Skris int SSL_library_init(void);
1368651Skris #define OpenSSL_add_ssl_algorithms()    SSL_library_init()
1468651Skris #define SSLeay_add_ssl_algorithms()     SSL_library_init()
1568651Skris
1668651Skris=head1 DESCRIPTION
1768651Skris
18215697SsimonSSL_library_init() registers the available SSL/TLS ciphers and digests.
1968651Skris
2068651SkrisOpenSSL_add_ssl_algorithms() and SSLeay_add_ssl_algorithms() are synonyms
2168651Skrisfor SSL_library_init().
2268651Skris
2368651Skris=head1 NOTES
2468651Skris
2568651SkrisSSL_library_init() must be called before any other action takes place.
2668651Skris
2768651Skris=head1 WARNING
2868651Skris
29215697SsimonSSL_library_init() adds ciphers and digests used directly and indirectly by
30215697SsimonSSL/TLS.
3168651Skris
3268651Skris=head1 EXAMPLES
3368651Skris
3468651SkrisA typical TLS/SSL application will start with the library initialization,
35215697Ssimonand provide readable error messages.
3668651Skris
3768651Skris SSL_load_error_strings();                /* readable error messages */
3868651Skris SSL_library_init();                      /* initialize library */
3968651Skris
4068651Skris=head1 RETURN VALUES
4168651Skris
4268651SkrisSSL_library_init() always returns "1", so it is safe to discard the return
4368651Skrisvalue.
4468651Skris
45215697Ssimon=head1 NOTES
46215697Ssimon
47215697SsimonOpenSSL 0.9.8o and 1.0.0a and later added SHA2 algorithms to SSL_library_init().
48215697SsimonApplications which need to use SHA2 in earlier versions of OpenSSL should call
49215697SsimonOpenSSL_add_all_algorithms() as well.
50215697Ssimon
5168651Skris=head1 SEE ALSO
5268651Skris
5368651SkrisL<ssl(3)|ssl(3)>, L<SSL_load_error_strings(3)|SSL_load_error_strings(3)>,
5468651SkrisL<RAND_add(3)|RAND_add(3)>
5568651Skris
5668651Skris=cut
57