Backlight

Backlight is a dynamic binary tracing tool.

Install

$ git clone [email protected]: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

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

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.