#linux #ptrace #debugging


A friendly wrapper around ptrace(2)

17 releases (11 breaking)

0.12.0 Sep 5, 2023
0.10.0 Apr 20, 2023
0.9.0 Aug 20, 2022
0.8.0 Sep 30, 2021
0.2.1 May 29, 2020

#4 in #ptrace

Download history 239/week @ 2023-08-10 67/week @ 2023-08-17 50/week @ 2023-08-24 123/week @ 2023-08-31 138/week @ 2023-09-07 82/week @ 2023-09-14 31/week @ 2023-09-21 120/week @ 2023-09-28 163/week @ 2023-10-05 199/week @ 2023-10-12 118/week @ 2023-10-19 99/week @ 2023-10-26 61/week @ 2023-11-02 75/week @ 2023-11-09 81/week @ 2023-11-16 63/week @ 2023-11-23

308 downloads per month
Used in 2 crates

ISC license

652 lines


A friendly wrapper around the Linux ptrace(2) syscall.


The current minimum supported OS and compiler versions are:

  • Linux 4.8
  • rustc 1.64

Continuous testing is only run for x86_64-unknown-linux-gnu.

Support for earlier Linux versions is possible, but low priority. Eventually, we would like to support any platform that provides ptrace(2).


The ptrace(2) interface entails interpreting a series of wait(2) statuses. The context used to interpret a status includes the attach options set on each tracee, previously-seen stops, recent ptrace requests, and in some cases, extra event data that must be queried using additional ptrace calls.

Pete is meant to instead permit reasoning directly about ptrace-stops, as described in the manual. We hide the lowest-level contextual bookkeeping required to disambiguate ptrace-stops. Whenever we can, we avoid extraneous ptrace calls, deferring to downstream tracers implemented on top of the library. For example, Pete can distinguish a syscall-enter-stop and syscall-exit-stop, but does not automatically query register state to identify the specific syscall.


Pete is licensed under the ISC License.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in pete by you, shall be licensed as ISC, without any additional terms or conditions.


~52K SLoC