rstrace

Crates.iorstrace
lib.rsrstrace
version
sourcesrc
created_at2024-09-15 20:05:11.704937+00
updated_at2025-03-02 18:12:56.878181+00
descriptionA Rust implementation of strace to trace system calls and CUDA API calls.
homepagehttps://github.com/thundergolfer/strace-rs
repositoryhttps://github.com/thundergolfer/strace-rs
max_upload_size
id1375755
Cargo.toml error:TOML parse error at line 17, column 1 | 17 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
Jonathon Belotti (thundergolfer)

documentation

README

rstrace

CI status

rstrace is a Rust implementation of strace. It allows the user to trace system calls of a process or command.

Usage

rstrace ls /tmp/

To get a quick overview, use rstrace --help

Usage: rstrace [OPTIONS] [ARGS]...

Arguments:
  [ARGS]...  Arguments for the program to trace. e.g. 'ls /tmp/'

Options:
  -o, --output <OUTPUT>  send trace output to FILE instead of stderr
  -t, --timestamp...     Print absolute timestamp. -tt includes microseconds, -ttt uses UNIX timestamps
  -c, --summary-only     Count time, calls, and errors for each syscall and report summary
  -C, --summary          like -c, but also print the regular output
  -j, --summary-json     Count time, calls, and errors for each syscall and report summary in JSON format
      --tef              Emit Trace Event Format (TEF) trace data as output
      --cuda             Enable CUDA ioctl sniffing. [Requires 'cuda_sniff' feature]
      --cuda-only        Enable CUDA ioctl sniffing and disable all other output. [Requires 'cuda_sniff' feature]
  -p, --attach <PID>     Attach to the process with the process ID pid and begin tracing.
      --color            Enable colored output
  -h, --help             Print help
  -V, --version          Print version

cuda_sniff extension

cuda_sniff is an extension to strace-rs that allows the user to trace CUDA API calls. It is based on https://github.com/geohot/cuda_ioctl_sniffer by George Hotz.

gvisor has an alternative implementation called ioct_sniffer which uses LD_PRELOAD to intercept calls, unlike strace-rs which uses ptrace.

Alternatives

Commit count: 0

cargo fmt