3Futures Tracing🔗 i

The futures trace module exposes low-level information about the execution of parallel programs written using future .

This program:

(require racket/future

future-visualizer/trace)

(trace-futures

(let ([f(future (lambda ()... ))])

...

(touch f)))

Is equivalent to:

(require racket/future

future-visualizer/trace)

(start-future-tracing! )

(let ([f(future (lambda ()... ))])

...

(touch f))

(stop-future-tracing! )

(timeline-events )

The stop-future-tracing! procedure must be used to indicate the end of code the programmer wishes to trace. Tracing works by simply using a log receiver to record all future-related log events; this procedure logs a special message that is well-known to the log receiver to mean ’stop recording’.

The timeline-events procedure returns the program trace as a list of indexed-future-event structures.