backtrace.c File Reference

Backtrace stubs for WASM (not available in browser environment) More...

Go to the source code of this file.

Typedefs
typedef bool(*	backtrace_frame_filter_t) (const char *frame)

Functions
void	backtrace_capture (backtrace_t *bt)
	Capture current stack into bt.
void	backtrace_capture_and_symbolize (backtrace_t *bt)
	Capture and symbolize in one call.
void	backtrace_free (backtrace_t *bt)
void	backtrace_t_free (backtrace_t *bt)
	Free backtrace symbols.
void	backtrace_symbolize (backtrace_t *bt)
	Symbolize bt->ptrs into bt->symbols.
void	backtrace_print (const char *label, const backtrace_t *bt, int skip_frames, int max_frames, backtrace_frame_filter_t filter)
	Print backtrace with dual output: colored stderr + plain log file.
void	backtrace_print_simple (int skip_frames)
	Print backtrace of the current call stack.

Detailed Description

Backtrace stubs for WASM (not available in browser environment)

Definition in file platform/wasm/stubs/backtrace.c.

Typedef Documentation

backtrace_frame_filter_t

typedef bool(* backtrace_frame_filter_t) (const char *frame)

Definition at line 42 of file platform/wasm/stubs/backtrace.c.

Function Documentation

backtrace_capture()

void backtrace_capture

(

backtrace_t *

bt

)

Capture current stack into bt.

Calls platform_backtrace() to capture raw return addresses. Does not symbolize (symbols remain NULL).

Parameters

bt	Backtrace structure to fill (must not be NULL)

Definition at line 9 of file platform/wasm/stubs/backtrace.c.

                                        {
  if (bt) {
    bt->count = 0;
    bt->symbols = NULL;
  }
}

References backtrace_t::count, and backtrace_t::symbols.

backtrace_capture_and_symbolize()

void backtrace_capture_and_symbolize

(

backtrace_t *

bt

)

Capture and symbolize in one call.

Convenience function combining backtrace_capture() and backtrace_symbolize().

Parameters

bt	Backtrace structure to fill and symbolize (must not be NULL)

Definition at line 16 of file platform/wasm/stubs/backtrace.c.

                                                      {
  if (bt) {
    bt->count = 0;
    bt->symbols = NULL;
  }
}

References backtrace_t::count, and backtrace_t::symbols.

backtrace_free()

void backtrace_free

(

backtrace_t *

bt

)

Definition at line 23 of file platform/wasm/stubs/backtrace.c.

                                     {
  if (bt) {
    bt->count = 0;
    bt->symbols = NULL;
  }
}

References backtrace_t::count, and backtrace_t::symbols.

backtrace_print()

void backtrace_print	(	const char *	label,
		const backtrace_t *	bt,
		int	skip_frames,
		int	max_frames,
		backtrace_frame_filter_t	filter
	)

Print backtrace with dual output: colored stderr + plain log file.

Intelligently formats and routes backtraces to multiple destinations:

• stderr: Colored output with semantic highlighting (for interactive debugging)
• log file (if logging): Plain ASCII without ANSI codes (for file parsing)

This dual-output design ensures readable terminal output during development while keeping log files clean and searchable in production.

Output Format

Terminal output example:

=== Backtrace: Error ===
[0] 0x7f1234567890 in main() [src/main.c:42]
[1] 0x7f1234567800 in process_request() [src/network.c:128]
[2] 0x7f1234567700 in send_data() [src/io.c:67]

Log file (same content, no colors):

=== Backtrace: Error ===
[0] 0x7f1234567890 in main() [src/main.c:42]
...

Parameters

label	Header label (e.g., "Backtrace", "Leak trace", "Assertion failure")
bt	Backtrace to print (must not be NULL, must be symbolized via backtrace_capture_and_symbolize)
skip_frames	Number of frames to skip from start (0 = include all, 1 = skip first frame, etc.)
max_frames	Maximum frames to print (0 = unlimited, 5 = first 5 frames only)
filter	Optional callback to selectively skip frames (e.g., filter internal frames) Return true to skip frame, false to include. NULL = no filtering.

Note

Backtrace must be symbolized. Unsymbolized (raw hex) traces are less useful.

Frame filtering is useful to focus on application code, excluding:

• lib/platform internal calls
• lib/log infrastructure
• Exception handling wrappers

See also

backtrace_format() for buffer-based output (safe for log system)

Definition at line 44 of file platform/wasm/stubs/backtrace.c.

                                                      {
  (void)label;
  (void)bt;
  (void)skip_frames;
  (void)max_frames;
  (void)filter;
  // No-op for WASM
}

backtrace_symbolize()

void backtrace_symbolize

(

backtrace_t *

bt

)

Symbolize bt->ptrs into bt->symbols.

Calls platform_backtrace_symbols() to convert raw addresses to symbol strings. This is a no-op if symbols are already set (already symbolized).

Parameters

bt	Backtrace structure to symbolize (must not be NULL)

Definition at line 37 of file platform/wasm/stubs/backtrace.c.

                                          {
  (void)bt;
  // No-op for WASM
}

backtrace_t_free()

void backtrace_t_free

(

backtrace_t *

bt

)

Free backtrace symbols.

Calls platform_backtrace_symbols_destroy() to free the symbols array. Nulls the symbols pointer after freeing.

Parameters

bt	Backtrace structure (must not be NULL)

Definition at line 30 of file platform/wasm/stubs/backtrace.c.

                                       {
  if (bt) {
    bt->count = 0;
    bt->symbols = NULL;
  }
}

References backtrace_t::count, and backtrace_t::symbols.