All Manuals > LispWorks® User Guide and Reference Manual > 34 The DBG Package

ide-open-a-listener Function

Summary

IDE side: Open a Remote Listener tool.

Package

dbg

Signature

ide-open-a-listener &key connection timeout => process-remote-object

Arguments
connection
timeout
A non-negative real or nil.
Values
process-remote-object
A remote object handle or nil.
Description

The function ide-open-a-listener opens a Remote Listener, by calling start-remote-listener on the client side of the connection.

If connection is non-nil, it is used, otherwise ide-open-a-listener calls ide-find-remote-debugging-connection to find a connection. See ide-find-remote-debugging-connection for further details.

timeout specifies the length of time (in seconds) to wait before returning. timeout defaults to 10 and nil means waiting indefinitely.

When successful, ide-open-a-listener returns process-remote-object, which is a remote object (see remote-object-p) corresponding to the client process object that runs the read-eval-print loop. When a timeout occurs, process-remote-object is nil.

Notes

When process-remote-object is nil it does not necessarily means a failure and the Remote Listener may open later anyway. In particular, you can use :timeout 0 to avoid any waiting.

See also

ide-find-remote-debugging-connection
3.7 Remote debugging


LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:30:32