Lib.rs

Cargo Features

[dependencies]
blazesym = { version = "0.2.3", default-features = false, features = ["apk", "backtrace", "bpf", "breakpad", "demangle", "dwarf", "gsym", "tracing", "zlib", "zstd", "xz", "test", "nightly"] }

default = backtrace, demangle, dwarf, zlib

These default features are set whenever blazesym is added without default-features = false somewhere in the dependency tree.

apk

Enable this feature to enable APK support (mostly relevant for Android).

Affects normalize::NormalizeOpts.apk_to_elf, symbolizer::ApkMemberInfo, symbolizer::ApkDispatch…

backtrace default

Enable this feature to compile in support for capturing backtraces in errors.
Note that by default backtraces will not be collected unless opted in with environment variables.

bpf

Enable BPF support. Currently that entails kernel symbolization being able to symbolize addresses in BPF programs.

breakpad

Enable this feature to enable Breakpad support.

Enables nom ^7

demangle default

Enable this feature to get transparent symbol demangling.

Enables cpp_demangle and rustc-demangle

dwarf default

Enable this feature to enable DWARF support.

Enables gimli ^0.32

gsym

Enable this feature to enable Gsym support.

tracing

Emit tracing traces and configure spans. User code is responsible for subscribing. Refer to the documentation of the tracing crate.

Enables tracing

zlib default

Enable this feature to enable support for zlib decompression. This is currently only used for handling compressed debug information.

Enables miniz_oxide

zstd

Enable this feature to enable support for zstd decompression. This is currently only used for handling compressed debug information.

Enables zstd

xz

Enable this feature to enable support for xz decompression. This is currently only used for handling .gnu_debugdata section data (MiniDebugInfo)

Enables xz2

test

Below here are dev-mostly features that should not be needed by regular users.

Expose test-only helpers for convenient use in end-to-end tests from crate.

nightly

Enable code paths requiring a nightly toolchain. This feature is only meant to be used for testing and benchmarking purposes, not for the core library, which is expected to work on stable.