ssl-do-handshake

Arguments: stream

This operator was added in an update release in late March, 2007.

This function returns t but is called for its side effect, which is to initiate a handshake between SSL server and client streams.

make-ssl-server-stream and make-ssl-client-stream do not immediately initiate SSL handshake. Instead, handshake is deferred until the first I/O is made on the stream. If there are certificate verification or other errors during SSL handshake, the error will be generated during the I/O request that initiated handshake.

In some circumstances you may want to control when SSL starts. The ssl-do-handshake method initiates SSL handshake. stream must be an SSL client or server stream (such as is created by make-ssl-server-stream and make-ssl-client-stream).

Peer certificate verification (if requested) occurs during SSL handshake. If verification fails, an error will be generated.

See socket.htm.

Copyright (c) 1998-2008, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.0. This page is new in the 8.0 release.
Created 2007.4.30.