blazecli
| Crates.io | blazecli |
| lib.rs | blazecli |
| version | |
| source | src |
| created_at | 2023-11-20 23:59:25.288607 |
| updated_at | 2024-12-12 00:38:07.760028 |
| description | A command line utility for the blazesym library. |
| homepage | https://github.com/libbpf/blazesym |
| repository | https://github.com/libbpf/blazesym |
| max_upload_size | |
| id | 1043388 |
| Cargo.toml error: | TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
@d-e-s-o @ work (danielocfb)
documentation
README
blazecli
blazecli is a command line interface for the blazesym library. It aims to closely mirror the structure of the library in its command and sub-command structure.
Usage
As mentioned above, the program's sub-command aim to mirror the
library's public API structure. Hence, to symbolize an address in an ELF
file -- which blazesym allows via the
symbolize::Symbolizer type in conjunction with the
Elf source -- is possible via the symbolize elf
sub-command:
# Just an example to illustrate symbolization on live data.
$ readelf --syms /lib64/libc.so.6 --wide | grep readdir64_r
> 2253: 00000000000caee0 228 FUNC WEAK DEFAULT 12 readdir64_r@@GLIBC_2.2.5
$ blazecli symbolize elf --path /lib64/libc.so.6 00000000000caee0
> 0xcaee0: readdir_r@0xcaee0+0 :0
To run the program from within a checkout (without any kind of installation), you would use:
$ cargo run -p blazecli -- symbolize elf --path /lib64/libc.so.6 00000000000caee0
Similarly, to symbolize an address inside a process the symbolize process sub-command can be used. Please refer to the program's help
text for additional details.
Pre-built, statically linked binaries for various target triples are available on-demand here as well as attached to each published release.
Shell Completion
blazecli comes with shell completion support (for various shells). A
completion script can be generated via the shell-complete utility
program and then only needs to be sourced to make the current shell
provide context-sensitive tab completion support. E.g.,
$ cargo run -p blazecli --bin=shell-complete --features="clap_complete" -- bash > blazecli.bash
$ source blazecli.bash
The generated completion script can be installed system-wide and sourced
through initialization files, such as ~/.bashrc.
Completion scripts for other shells work in a similar manner. Please
refer to the help text (--help) of the shell-complete program for
the list of supported shells.