Crate symbolic_cfi 

Handling of Call Frame Information (stack frame info).

The root type exposed by this crate is CfiCache, which offers a high-level API to extract CFI from object files and serialize a format that the Breakpad processor can understand.

Background

Call Frame Information (CFI) is used by the processor to improve the quality of stacktraces during stackwalking. When the executable was compiled with frame pointer omission, the call stack does not contain sufficient information to resolve frames on its own. CFI contains programs that can calculate the base address of a frame based on register values of the current frame.

Without CFI, the stackwalker needs to scan the stack memory for values that look like valid base addresses. This frequently yields false-positives.

Structs

AsciiCfiWriter

A service that converts call frame information (CFI) from an object file to Breakpad ASCII format and writes it to the given writer.

CfiCache

A cache file for call frame information (CFI).

CfiError

An error returned by AsciiCfiWriter.

Enums

CfiErrorKind

The error type for CfiError.

Constants

CFICACHE_LATEST_VERSION

The latest version of the file format.

CFICACHE_MAGIC

The magic file preamble to identify cficache files.