JS_SET_TRACING_DETAILS

This article covers features introduced in SpiderMonkey 1.8

Set debugging information about the next thing to be traced by a JSTracer.

Syntax

JS_SET_TRACING_DETAILS(trc, printer, arg, index)
Name Type Description
trc JSTracer * The tracer whose debugging hooks are to be set.
printer JSTraceNamePrinter A callback function, described below; or NULL.
arg void * See the description.
index size_t See the description.

Callback syntax

typedef void (*JSTraceNamePrinter)(JSTracer *trc, char *buf, size_t bufsize);
Name Type Description
trc JSTracer * The tracer.
buf char * Out parameter. The callback stores a string describing the reference traced in buf.
bufsize size_t The size of buf, in chars.

Description

Set debugging information about a reference to a traceable thing to prepare for the following call to JS_CallTracer.

When printer is null, arg must be const char * or char * C string naming the reference and index must be either (size_t)-1 indicating that the name alone describes the reference or it must be an index into some array vector that stores the reference.

When printer is not null, the arg and index arguments are available to the callback as the debugPrinterArg and debugPrintIndex fields of trc.

The storage for name or callback's arguments needs to live only until the following call to JS_CallTracer returns.

MXR ID Search for JS_SET_TRACING_DETAILS