4 releases

0.0.4 Oct 5, 2023
0.0.3 Oct 3, 2023
0.0.2 Mar 10, 2023
0.0.1 Dec 17, 2022

#924 in Unix APIs

Download history 28/week @ 2024-10-14 376/week @ 2024-10-21 47/week @ 2024-10-28 80/week @ 2024-11-04 30/week @ 2024-11-11 71/week @ 2024-11-18 93/week @ 2024-11-25 77/week @ 2024-12-02 96/week @ 2024-12-09 96/week @ 2024-12-16 48/week @ 2024-12-23 26/week @ 2024-12-30 40/week @ 2025-01-06 49/week @ 2025-01-13 40/week @ 2025-01-20 23/week @ 2025-01-27

157 downloads per month
Used in 4 crates (2 directly)

BSD-2-Clause

125KB
3.5K SLoC

btfdump

BTF introspection tool

Compiling

btfdump is written in Rust and relies on standard Cargo package manager.

To compile btfdump:

  1. Get rust toolchain. See https://www.rust-lang.org/tools/install for instructions. a. Using rustup is the simplest option: just run curl https://sh.rustup.rs -sSf | sh. b. If you are behind HTTP/HTTPS proxy, you can specify it using http_proxy and https_proxy envvars:
    $ export http_proxy=http://fwdproxy:8080
    $ export https_proxy=http://fwdproxy:8080
    $ curl https://sh.rustup.rs -sSf | sh
    
  2. Once Cargo and rustc is installed, run cargo build or cargo build --release to compile it. This will build btf binary in target/{debug,release}/ directory.
  3. Alternatively, you can use cargo run -- <args> to compile and run through Cargo.

Supported commands

Dump

  1. Dump BTF types in various formats:
btf dump --format [human|c] <elf-file>
  1. You can filter out which types to print out using --type, --name, and --id options. See btf dump --help for more details.
  2. Check also --dataset option for dumping .BTF.ext data as well.

Stat

Output high-level stats about .BTF and .BTF.ext data.

btf stat <elf-file>

Dependencies

~8–18MB
~258K SLoC