shutdown

$Revision: 1.1.2.2 $

Generic Function

Package: ACL-SOCKET

Arguments: (socket &key direction)

socket is an socket currently connected to another socket. Direction is :input or :output

shutdown closes down the specified half of the bidirectional socket connection. It does not force out unflushed buffers first (as the close function does).

This function is useful in many socket applications.

For example:

(setq sock (make-socket :remote-host "foo" :remote-port 1234))
(format sock "are you ok?~%")
(force-output sock)
(shutdown sock :direction :output)

(read sock)

By calling shutdown in the above example it causes the program at the other end of the connection to receive an End of File indication. This is important indication for some program and it then causes them to formulate and send back a reply down the socket. Because we used shutdown rather than close, we can still read from the input side of this socket.

See socket.htm for general information on sockets.

The general documentation description is in introduction.htm. The index in index.htm.