Skip to content

Latest commit

 

History

History
60 lines (42 loc) · 1.55 KB

README.md

File metadata and controls

60 lines (42 loc) · 1.55 KB

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.