with-remote-debugging-spec

with-remote-debugging-spec 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 ssl ipv6) &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.
`ssl`⇩	A SSL client context specification.
`ipv6`⇩	`:any` (the default), `t`, or `nil`.
`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, ssl, ipv6) 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.