A socket or
base-char stream stream opened for
A SSL specification.
An output stream or
create-client-remote-debugging-connection creates a client side remote debugging connection. The function
create-ide-remote-debugging-connection creates an IDE side remote debugging connection.
Normally you would use the higher level interface functions start-client-remote-debugging-server or configure-remote-debugging-spec to open a client side connection, and start-ide-remote-debugging-server or ide-connect-remote-debugging to open an IDE side connection. The higher level functions call these functions to create the connection.
name specifies a name for the connection, but otherwise does not affect its behavior. On the IDE side it is used in the title of Remote Listener and Remote Debugger tools. On both sides it is used in the name of the process that handles communication across the connection.
If socket is non-nil, it must be a socket handle, like the one that start-up-server passes to its function argument or the socket that accept-tcp-connections-creating-async-io-states, when called with
:create-state nil, passes to its connection-function. A socket-stream is created with this socket and used as the stream in the connection. socket defaults to
If stream is non-nil, it must be an
base-char stream opened for
:io and it is used directly in the connection. Typically it will be a socket-stream, but that is not a requirement. stream defaults to
For the connection to work, the other side of the socket or stream must be the opposite kind of connection, that is for a client side connection the other side needs to be an IDE connection and vice versa.
The "ownership" of socket or stream is transferred to the connection by these functions. That means that no further I/O operations are allowed on socket or stream by other code, and they must not be closed. They will be closed when the connection is closed.
The value of client-side-connection that is returned by
create-client-remote-debugging-connection can be used as the connection argument to with-remote-debugging-connection, set-remote-debugging-connection or set-default-remote-debugging-connection, or as the
:connection keyword to start-remote-listener or remote-inspect. It is not remembered by LispWorks anywhere.
The value of ide-side-connection that is returned by
create-ide-remote-debugging-connection is remembered by LispWorks, and is returned by ide-list-remote-debugging-connections or ide-find-remote-debugging-connection when appropriate. As a result, it may be used by any of the IDE side functions. It can also be passed explicitly to any of these functions. It is forgotten when it is closed.
LispWorks User Guide and Reference Manual - 20 Sep 2017