*ssl-library-names*

Initially nil. If set, the value of this variable must be a list of two entries, each a string or a list of strings (on Windows, each should be just a string). The entries are the names of the two OpenSSL shared libraries that must be loaded in order to enable the :ssl module. Each string is a file name with a full type suffix but no pathname.

When the entry is a list, the names in the list are tried in order until one denotes a library that loads without error.

If nil when the :ssl module is loaded and the environment variable ACL_SSL_LIBRARY_NAMES has a value, that value is read and the value of this variable is set to it. If this variable is nil and the ACL_SSL_LIBRARY_NAMES environment variable is unset, the output of the openssl version command on the system where the :ssl module is being loaded is used to set the value of the variable. A particular site may need yet another variant.

When the :ssl module is loaded, the filenames specified by the variable (whether set by the user, set from the ACL_SSL_LIBRARY_NAMES environment variable or set by the system) will be looked for as the names of the OpenSSL libraries. If they are not found (searching directories specified by LD_LIBRARY_PATH on UNIX machines, PATH on Windows, and DYLD_LIBRARY_PATH on Macs) loading of the :ssl module will fail.

If the value is non-nil prior to the :ssl module being loaded (that is, if the value is set by the user or from the ACL_SSL_LIBRARY_NAMES environment variable), the Allegro CL OpenSSL library should also be identified, so either the value of *aclssl-name* must be set to the proper Allegro CL OpenSSL library name or one of the environment variables ACL_ACLSSL_NAME and ACL_SCLISSL_NAME must be set to the correct name (aclssl or aclssl11 for the first, aclissl or aclissl11 for the second, with the trailing 11 meaning OpenSSL 1.1). If *aclssl-name* is nil and the appropriate environment variable is unset, the aclssl or aclissl (depending on the Lisp character size) is loaded. Warning: if you are using OpenSSL 1.1 and either aclssl or aclissl are loaded, there will likely be errors later which are difficult to understand.

If this variable is nil and the ACL_SSL_LIBRARY_NAMES environment variable is unset, the OpenSSL version is determined by other means (see *aclssl-version*) and that information is sufficient to determing the correct Allegro CL library to load (since Lisp konws the OpenSSL version and its own character size).

OpenSSL is described in Secure Socket Layer (SSL) in socket.htm.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.