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.
26238405SjkimSSL_library_init() is not reentrant. 
2768651Skris
2868651Skris=head1 WARNING
2968651Skris
30215697SsimonSSL_library_init() adds ciphers and digests used directly and indirectly by
31215697SsimonSSL/TLS.
3268651Skris
3368651Skris=head1 EXAMPLES
3468651Skris
3568651SkrisA typical TLS/SSL application will start with the library initialization,
36215697Ssimonand provide readable error messages.
3768651Skris
3868651Skris SSL_load_error_strings();                /* readable error messages */
3968651Skris SSL_library_init();                      /* initialize library */
4068651Skris
4168651Skris=head1 RETURN VALUES
4268651Skris
4368651SkrisSSL_library_init() always returns "1", so it is safe to discard the return
4468651Skrisvalue.
4568651Skris
46215697Ssimon=head1 NOTES
47215697Ssimon
48215697SsimonOpenSSL 0.9.8o and 1.0.0a and later added SHA2 algorithms to SSL_library_init().
49215697SsimonApplications which need to use SHA2 in earlier versions of OpenSSL should call
50215697SsimonOpenSSL_add_all_algorithms() as well.
51215697Ssimon
5268651Skris=head1 SEE ALSO
5368651Skris
5468651SkrisL<ssl(3)|ssl(3)>, L<SSL_load_error_strings(3)|SSL_load_error_strings(3)>,
5568651SkrisL<RAND_add(3)|RAND_add(3)>
5668651Skris
5768651Skris=cut
58