ssl-connection-ssl-ref

ssl-connection-ssl-ref Function

Summary

Returns a foreign pointer corresponding to the implementation object of a SSL connection.

Package

comm

Signature

ssl-connection-ssl-ref ssl-connection => foreign-pointer

Arguments

ssl-connection⇩

A SSL connection (socket-stream or async-io-state).

Values

foreign-pointer⇩

A FLI pointer, either ssl-pointer or ssl-context-ref.

Description

The function ssl-connection-ssl-ref returns a foreign pointer corresponding to the object in the SSL implementation that LispWorks is using for ssl-connection. ssl-connection must be either a socket-stream or an async-io-state and must be associated with SSL using the :ssl-ctx keyword (see 25.8.6 Keyword arguments for use with SSL).

If the implementation of SSL is OpenSSL, then foreign-pointer is an instance of ssl-pointer. If the implementation is Apple Security Framework, then foreign-pointer is an instance of ssl-context-ref.

Both ssl-pointer and ssl-context-ref are Lisp types that can be used in typep, typecase and as method specializers. This is useful for writing code that does different things depending on the implementation that is used in ssl-connection.