summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSanto Cariotti <santo@dcariotti.me>2023-10-22 19:40:28 +0200
committerSanto Cariotti <santo@dcariotti.me>2023-10-22 19:40:28 +0200
commitf1e0481db002b5d7d8a7a4afa81bd86693c25833 (patch)
tree29ba5c4f5203590717f1488cc98c612f0588eb51
parent3fbe786ed9c05d35d251bea7a2d18e2168eff553 (diff)
Edit README
-rw-r--r--README.md37
1 files changed, 36 insertions, 1 deletions
diff --git a/README.md b/README.md
index cf270cd..079b5e1 100644
--- a/README.md
+++ b/README.md
@@ -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.
-[![asciicast](https://asciinema.org/a/2QrVmvuzojljd6i2EtPD9TqFx.svg)](https://asciinema.org/a/2QrVmvuzojljd6i2EtPD9TqFx)
+Trace a command
+[![asciicast](https://asciinema.org/a/bvkc2sTphVwm77kB4GRLY5XMQ.svg)](https://asciinema.org/a/bvkc2sTphVwm77kB4GRLY5XMQ)
+
+Attach a PID
+[![asciicast](https://asciinema.org/a/LExqUuW3Y3AUvyI7V67XGrgZX.svg)](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
+```