ensure-ssl Function

Summary

Initializes SSL.

Package

comm

Signature

ensure-ssl &key library-path already-done implementation

Arguments

Description

The function ensure-ssl initializes SSL. If it was already called in the image, ensure-ssl does nothing. Otherwise it loads the library, calls SSL_library_init, calls SSL_load_error_strings and performs internal initializations.

If already-done is true, ensure-ssl does only the internal initializations. The default value of already-done is nil.

If library-path is passed, it needs to be either a string, specifying one library, or a list of strings specifying multiple libraries. The default value of library-path is platform-specific. The initial default value is described in 25.9.2.2 How LispWorks locates the OpenSSL libraries. This default may be changed by calling set-ssl-library-path.

If implementation is :openssl, then OpenSSL is initialized. If implementation is :apple then the Apple Security Framework is initialized. If implementation is nil (the default) then the SSL implementation returned by ssl-default-implementation is initialized. implementation is a new argument in LispWorks 8.0.

See also

openssl-version
set-ssl-library-path
ssl-default-implementation
25 TCP and UDP socket communication and SSL