NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #3486 most downloaded on crates.io
blazesym is a library for address symbolization and related tasks.
Latest stable
0.2.7
Last release 25 days ago
28 Oct 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 8 of 8 stable releases
1 version withdrawn
withdrawn after publishing
4 years old
28 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Added support for .gnu_debugaltlink and .debug_sup section handling to discover DWARF supplementary files
.gnu_debugaltlink and .debug_sup section handling to discover DWARF supplementary filescache_perf_map attribute to symbolize::cache::Processzstd compressed kernel modules (expecting extension .zst instead of .zstd)Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.6...v0.2.7
Adjusted ELF symbolization to report sizeless .dynsym entries only on exact address matches
.dynsym entries only on exact address matchessymbolize::Symbolizer::evict method for evicting cached dataFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.5...v0.2.6
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Improved DWARF symbolization performance for some debug info variants
zlib implementation from miniz_oxide to zlib-rs for improved decoding performance_stext symbol based KASLR offset inference fallback for kernel address symbolizationFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.4...v0.2.5
Added support for relocatable ELF and DWARF
/proc/kcore is inaccessible but kallsyms is available1.88Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.3...v0.2.4
Added support for /usr/lib/debug/.build-id debug link target directory
/usr/lib/debug/.build-id debug link target directory.gnu_debugdata ELF sections (MiniDebugInfo)Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.2...v0.2.3
Improved data caching for debug link targets and DWP files
Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.1...v0.2.2
Adjusted symbolize::Symbolizer::symbolize behavior to stop being short-circuiting
symbolize::Symbolizer::symbolize behavior to stop being short-circuiting
Reason::IgnoredError variantFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0...v0.2.1
Adjusted symbolize::{Resolved,}Sym::code_info to be heap allocated
symbolize::{Resolved,}Sym::code_info to be heap allocatedsymbolize::ResolvedSym non-exhaustiveFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-rc.5...v0.2.0
Added support for discovering and using DWARF packages (*.dwp)
*.dwp)Symbolizer::register_elf_resolver methodSTT_NOTYPE symbols in symbolizationFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-rc.4...v0.2.0-rc.5
Added support for symbolizing addresses in a vDSO
vdso attribute to symbolize::Process typenormalize::UserMeta::Sym variantsymbolize::Sym::module when using process symbolization on APKs with map_files set to truebpf_prog_ prefix and program taginspect::SymInfo type non-exhaustivenormalize::Reason and symbolize::ReasonCodeInfo::to_owned to into_owned1.75Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-rc.3...v0.2.0-rc.4
Added support for 32 bit ELF binaries
symbolize::Symbolizer::cache method for caching process VMA as well as ELF metadatanormalize::NormalizeOpts::apk_to_elf attribute for normalizing addresses mapping to APKs to the contained ELF filesymbolize::Sym::module attributesymbolize::Source::kernel_image to vmlinuxinspect::SymInfo::obj_file_name to modulevmlinux file, if presentsymbolize::Kernel::{kallsyms,kernel_image} to support disabling of the sourcevmlinux based kernel address symbolization logic to take into account system KASLR state
kaslr_offset member to symbolize::Kernelsource sub-modulenormalize::Apk behind existing apk featureinspect::SymInfo::size to be an OptionInsertMap type1.70Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-rc.2...v0.2.0-rc.3
Added support for symbolizing BPF kernel program addresses including source code information
bpf (default disabled) featureinspect::InspectorNormalizeOpts::map_files equal to falseinspect::Inspector::for_each to accept callback returning std::ops::ControlFlow to facilitate early terminationkallsyms parsing performance to speed up overall kernel address symbolization1.69Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-rc.1...v0.2.0-rc.2
Added support for using PROCMAP_QUERY ioctl during address normalization
PROCMAP_QUERY ioctl during address normalization
enable_procmap_query to normalize::Normalizeris_procmap_query_supported function to helper modulemap_files is in use.gnu_debuglink section is unalignedenable_maps_caching method of normalize::Normalizer to enable_vma_cachingUserMeta::{apk,elf,unknown} methods by prefixing them with as_Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-rc.0...v0.2.0-rc.1
Added support for transparently following debug links in ELF binaries
symbolize::Builder::set_debug_dirs for configuring directories searched for targetsnormalize::NormalizeOpts type for configurable address normalization
normalize::Normalizer::normalize_user_addrs_sorted in favor of normalize::Normalizer::normalize_user_addrs_optsFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.12...v0.2.0-rc.0
Added support for advanced symbolization workflows involving containers (process or APKs) via configurable dispatch functions
cache_maps and cache_build_ids properties to normalize::Normalizer type
cache_build_ids is truezlib (default enabled) and zstd (default disabled) featuresInspector::for_each signature to no longer carry explicit state aroundnormalize::Reason enum to provide best guess at why normalization was not successful as part of the normalize::UserMeta::Unknown variantFrom<Box<dyn std::error::Error>> conversion to ErrorDisplay impl to ErrorKindread_elf_build_id_from_mmap function to helper moduleClone impl of symbolize::Builder typeFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.11...v0.2.0-alpha.12
Added support for Breakpad format behind breakpad feature (disabled by default)
breakpad feature (disabled by default)perf_map attribute to symbolize::Process typemap_files attribute to symbolize::Process typeinspect APIsSymType enum:
inspect moduleUnknown variant to UndefinedFull Changelog: https://github.com/libbpf/blazesym/compare/cli-v0.1.2...v0.2.0-alpha.11
Introduced symbolize::Reason enum to provide best guess at why symbolization was not successful as part of the symbolize::Symbolized::Unknown variant
symbolize::Reason enum to provide best guess at why symbolization was not successful as part of the symbolize::Symbolized::Unknown variantapk and gsym compile-time features (disabled by default)pid argument to normalization functions before addressessrc argument to inspection functions before namesFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.9...v0.2.0-alpha.10
Added caching logic for Gsym resolvers to symbolize::Symbolizer
symbolize::SymbolizerCow objects to facilitate hand out of memory mapped data without unnecessary allocations
debug_syms to be a symbolization source property instead of a symbolize::Symbolizer attributeinspect::Elf::debug_info to debug_symsblazesym-c crateFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.8...v0.2.0-alpha.9
Fixed build failure when dwarf feature is not enabled
dwarf feature is not enabledAddr to map to 64 bit integersymbolize::Input enum and made it part of symbolization APIs to distinguish between and support different input types
symbolize::Source::Apk variantinspect::Inspectorinspect::SymInfo type to optionally just reference cached data as opposed to having to heap-allocate copies of itinspect::Inspectorinspect::SymInfo::file_offset member optionalError objectsblazecli1.65Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.7...v0.2.0-alpha.8
"Flattened" return type of symbolize::Symbolizer::symbolize method from nested Vec to a single level Vec of newly introduced symbolize::Symbolized enu
symbolize::Symbolizer::symbolize method from nested Vec to a single level Vec of newly introduced symbolize::Symbolized enumsymbolize::Sym:
size member and to_path helper methodCodeInfo type capturing all source code location informationinlined attributesymbolize::Symbolizer::symbolize_single for more convenient symbolization of a single addressnormalize::Builder type for customization of a normalize::Normalizer instance and made reading of build IDs configurablesymbolize::Builder::enable_src_location to enable_code_info1.64Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.6...v0.2.0-alpha.7
Fixed potential panic when normalizing an APK ELF file using the C APIs
Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.5...v0.2.0-alpha.6
Fixed potentially incorrect reporting of symbols from ELF source
Full Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.4...v0.2.0-alpha.5
Added support for automatic demangling of symbols, controlled by demangle feature (at compile time) and corresponding flag in symbolize::Builder (at r
demangle feature (at compile time) and corresponding flag in symbolize::Builder (at runtime)symbolize::SymbolizedResult to Sym and reworked it
symbol member to nameoffset memberline member to be of type u32 and column to u16path member into dir and fileblazecli command line interface for the libraryhelper module exposing read_elf_build_id functionFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.3...v0.2.0-alpha.4
Introduced custom Error type instead of relying solely on std::Error
Error type instead of relying solely on std::io::Errorgimli for DWARF support
dwarf feature to make dependency optionallog to using tracing as the logging backend
symbolize::Source::Gsym variant to support symbolizing Gsym from user provided "raw" datanormalize::UserAddrMeta::Binary variant to Elfblaze_user_addr_meta_unknown::__unused member to _unusedFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.2...v0.2.0-alpha.3
Added extern "C" guards in blazesym.h header for easy of use from C++ code
extern "C" guards in blazesym.h header for easy of use from C++ codeblaze_user_addr_meta_unknown type for compliance with C standard, stating undefined behavior for empty structsblaze_inspect_elf_src::path type to *const _NULL checks when working with blaze_symbolize_src_kernel objectsgenerate-bench-files featureFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.1...v0.2.0-alpha.2
Removed no longer necessary base_address member from various types
base_address member from various typesSymInfo::address member to addrFull Changelog: https://github.com/libbpf/blazesym/compare/v0.2.0-alpha.0...v0.2.0-alpha.1
First alpha release of v0.2.0. Vast rework with overhauled APIs and dozens of bug fixes over v0.1.0.
First alpha release of v0.2.0. Vast rework with overhauled APIs and dozens of bug fixes over v0.1.0.
BlazeSym is a library that symbolizes addresses where symbol names, source file names, and line numbers can be acquired. It can translate stack traces
BlazeSym is a library that symbolizes addresses where symbol names, source file names, and line numbers can be acquired. It can translate stack traces to function names and their locations in the source code.
BlazeSym v0.1.0 provides a simple symbolization API (Rust & C) to developers.
Rust API provides functions to
C API provides functions to
BlazeSym read symbols and debug information from various types of sources, including
Please check README.md for details.
One column per quarter.