Skip to content

JoshMcguigan/backlight

Repository files navigation

Backlight

Backlight is a dynamic binary tracing tool.

Install

$ git clone git@github.com:JoshMcguigan/backlight.git

$ cd backlight

$ cargo install-backlight

Usage

# Trace all system calls, shared library function calls, etc
$ backlight /bin/ls
...
[lib] malloc
[sys] sys_brk
[sys] sys_brk
[lib] free
[sys] sys_openat
[sys] sys_newfstatat
[sys] sys_mmap
[sys] sys_close
[lib] malloc
...
--- Child process exited ---

# Trace specific system calls
$ backlight -s sys_openat -s sys_close /bin/ls 

# Trace specific shared library function calls
$ backlight -l malloc -l free /bin/ls

# Add args after `--` and backlight will pass them along to the tracee
$ backlight /bin/ls -- -a

# Trace specific system calls and all shared library function calls
$ backlight -s sys_openat --all-library-functions /bin/ls

# Trace specific shared library function calls and all system calls
$ backlight -l malloc --all-syscalls /bin/ls

I'm looking for feedback on the UX of backlight. Stop by #3 and share your opinions!

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

A dynamic binary tracing tool

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.txt
MIT
LICENSE-MIT.txt

Stars

Watchers

Forks

Languages