Macro

Summary

Client side: Tell LispWorks how to open a connection for remote debugging on the client side within a dynamic extent.

Package

dbg

Signature

with-remote-debugging-spec (host &key port log-stream failure-function timeout open-callback) &body body => body-values

Arguments

host

A string specifying the IDE side hostname, or nil.

port

An integer.

log-stream

An output stream or nil.

failure-function

nil or a function of two arguments: Host and Port.

timeout

A non-negative real or nil.

open-callback

nil or a function that takes one argument, a newly opened connection.

body

Lisp forms.

Values

body-values

The values returned by body.

Description

The macro with-remote-debugging-spec establishes a dynamic extent of connection specification, calls configure-remote-debugging-spec passing it host, any supplied keywords (port, log-stream, failure-function, timeout, open-callback) and also :setup-default nil :enable nil. body is evaluated as an implicit progn in this dynamic extent. On exiting with-remote-debugging-spec, the connection specification reverts to what it was on entry.

The effect is to have a configured connection specification in the dynamic extent of body that is different from the global one, without having any effect on the global settings.

with-remote-debugging-spec returns the values returned by body.

See configure-remote-debugging-spec for the meaning of host and the other keywords.

See also

configure-remote-debugging-spec