All Manuals > LispWorks® User Guide and Reference Manual > 32 The COMM Package

socket-stream-handshake Function

Summary

Perform a SSL handshake on a stream.

Package

comm

Signature

socket-stream-handshake stream &optional timeout => success

Arguments
stream
timeout
nil or a real.
Values
success
A boolean.
Description

The function socket-stream-handshake performs a handshake on stream, which must be attached to SSL.

socket-stream-handshake returns false if the handshake does not finish in timeout seconds or if the SSL connection was cleanly closed by the other side. Other failures cause an error to be signaled.

socket-stream-handshake returns true on success.

Notes

The other socket-stream interface functions signal errors if the handshake fail for any reason, including timeout or clean close.

If SSL was attached with ssl-side :both, then you will need to specify which side to take in the handshake by calling ssl-set-accept-state or ssl-set-connect-state with the ssl-pointer return by socket-stream-ssl.

See also

socket-stream
25.8 Using SSL
25 TCP and UDP socket communication and SSL


LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:30:26