Stack Trace Rt¶

1

import "std/runtime/stack_trace_rt";

StackTraceBuffer struct¶

Fixed-capacity buffer holding one captured stack trace, as raw return addresses (most recent call first). Once the capacity above is hit, the walk stops early - deeper frames are silently dropped rather than overwriting the ones closest to the capture point, which are the most relevant for diagnostics.

Fields¶

Methods¶

capture¶

1

public p StackTraceBuffer.capture(int skipFrames = 0)

Captures the stack trace of the calling function. The first recorded address is the calling function's own current instruction pointer (i.e. the return address capture() will resume at), not one of its parents' - so by default the trace starts exactly at the call site of capture() itself.

The chain's outermost frame is a sentinel, conventionally marked by a zeroed saved-frame-pointer field - but on at least one observed platform (macOS/AArch64) its return-address field reads zero too, one hop before the saved-frame-pointer field does. So termination is checked on the return-address value about to be recorded, not only on the frame pointer itself - a zero return address means this frame is (or already looks like) the sentinel, and the walk stops without recording it, rather than recording a bogus nil entry.

Parameters

dump¶

1

public p StackTraceBuffer.dump(bool includeAddresses = true)

Prints every recorded frame of this trace to stderr, resolving each address to a symbol name via resolveSymbolName() where possible and falling back to a fixed placeholder otherwise (see stack_trace_symbol_rt.spice for why that is common for a Spice program's own frames today). A no-op if nothing was captured.

No offset from the symbol's own start address is printed alongside the name: Spice has no pointer<->integer cast and no pointer-difference operator today (only pointer +/- integer, which computes a new pointer, not a numeric difference), so there is currently no way to compute one in Spice itself.

Parameters

Functions¶

sDumpStacktrace¶

1

public p sDumpStacktrace(bool includeAddresses = true)

Captures and immediately dumps the calling function's stack trace to stderr - the one-call convenience entry point, auto-imported like the other 's'-prefixed runtime functions (see RuntimeModuleManager.h). Skips its own frame, so the first printed frame is the call site of sDumpStacktrace() itself.

Parameters