close-accepting-handle

close-accepting-handle Function

Summary

Closes an accepting handle.

Package

comm

Signature

close-accepting-handle accepting-handle &optional callback

Arguments

`accepting-handle`⇩	An accepting-handle.
`callback`⇩	A function designator or `nil`.

Description

The function close-accepting-handle closes the accepting handle accepting-handle. In particular, it closes the socket which frees up the port that the socket is bound to.

accepting-handle has to be an accepting handle, currently that means the result of accept-tcp-connections-creating-async-io-states.

If callback is non-nil, it must be a function of one argument. callback is called after closing the handle, with the collection which was supplied to accept-tcp-connections-creating-async-io-states which created the handle.

close-accepting-handle is asynchronous. To do something which is guaranteed to happen after the socket is closed, use callback.

Notes

callback is called on the collection process, so it should not do much work.