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

#729 in Unix APIs

Download history 19/week @ 2024-06-02 14/week @ 2024-06-09 15/week @ 2024-06-16 21/week @ 2024-06-23 4/week @ 2024-06-30 7/week @ 2024-07-07 14/week @ 2024-07-14 19/week @ 2024-07-21 35/week @ 2024-07-28 154/week @ 2024-08-04 42/week @ 2024-08-11 32/week @ 2024-08-18 33/week @ 2024-08-25 113/week @ 2024-09-01 33/week @ 2024-09-08 18/week @ 2024-09-15

201 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–21MB
~259K SLoC