ide-connect-remote-debugging host &key port timeout open-a-listener name log-stream => connection
A string.
An integer.
A non-negative real or nil.
A boolean.
A string.
An output stream or nil.
The function ide-connect-remote-debugging attempts to open a TCP stream to the client machine named by host on port number port. If this is successful within timeout seconds, then create-ide-remote-debugging-connection is called with the new stream, log-stream and a name constructed from name, host and a counter to create and return connection.
port defaults to the value of *default-client-remote-debugging-server-port*, which is 21102 initially.
timeout defaults to nil, which means waiting indefinitely (or until the operating system reports an error).
If open-a-listener is non-nil, ide-open-a-listener is called to open a Remote Listener. open-a-listener defaults to nil.
The client machine (specified by host) must be accepting TCP connections on port number port, which would normally be done by calling start-client-remote-debugging-server. Normally you do not need to supply port because both start-client-remote-debugging-server and ide-connect-remote-debugging default it to the value of *default-client-remote-debugging-server-port*.
The underlying TCP stream functionality must be working between the machines, that is they must be able to connect by TCP.
When using the Remote Debugger, Remote Listener or Inspector, you do not need to access the connection directly because the tools make one for you. In addition, create-ide-remote-debugging-connection remembers the connection, so all the IDE side functions that look for connections will find it.
You could easily implement your own version of ide-connect-remote-debugging if needed using open-tcp-stream and create-ide-remote-debugging-connection.
The editor command Connect Remote Debugging calls ide-connect-remote-debugging.
LispWorks User Guide and Reference Manual - 20 Sep 2017