diff options
author | Santo Cariotti <santo@dcariotti.me> | 2023-10-22 19:40:28 +0200 |
---|---|---|
committer | Santo Cariotti <santo@dcariotti.me> | 2023-10-22 19:40:28 +0200 |
commit | f1e0481db002b5d7d8a7a4afa81bd86693c25833 (patch) | |
tree | 29ba5c4f5203590717f1488cc98c612f0588eb51 | |
parent | 3fbe786ed9c05d35d251bea7a2d18e2168eff553 (diff) |
Edit README
-rw-r--r-- | README.md | 37 |
1 files changed, 36 insertions, 1 deletions
@@ -2,4 +2,39 @@ This repo refers to a "more beautiful" version of [`strace(1)`](https://www.man7.org/linux/man-pages/man1/strace.1.html) in Rust. -[](https://asciinema.org/a/2QrVmvuzojljd6i2EtPD9TqFx) +Trace a command +[](https://asciinema.org/a/bvkc2sTphVwm77kB4GRLY5XMQ) + +Attach a PID +[](https://asciinema.org/a/LExqUuW3Y3AUvyI7V67XGrgZX) + +## Install + +From Crates.io +``` +cargo install sigma-trace +``` + +or build source +``` +git clone https://github.com/boozec/sigma +cd sigma +cargo build --release +``` + +## Help + +``` +Monitor Linux executables with an interface easier than strace(1) + +Usage: sigma-trace [OPTIONS] + +Options: + -c, --command <COMMAND> Command to execute from ptrace + -p, --attach <ATTACH> Attach the tracing to an existing process ID. We're using the `-p` short flag because strace uses it + -f, --filter <FILTER> Show only defined sys calls. Multi values separated by comma `,` + --file <FILE_TO_PRINT> Write the output to a file instead of the standard output + --no-tui If defined, it hides the TUI + -h, --help Print help + -V, --version Print version +``` |