ptrace Linux system call

Observe or control another thread’s execution, as debuggers do.

In Linux 7.3, ptrace is defined in the system call table of 12 of the 12 bundled ABIs.

Number on each ABI Linux 7.3

ptrace in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-641010x65sys_ptracesyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:113Open
i386260x1asys_ptrace compat: compat_sys_ptraceint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:41Open
AArch641170x75sys_ptrace compat: compat_sys_ptracesvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:152Open
ARM EABI260x1asys_ptracesvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:41Open
RISC-V 641170x75sys_ptrace compat: compat_sys_ptraceecalla7a0, a1, a2, a3, a4, a5syscall.tbl:152Open
LoongArch 641170x75sys_ptrace compat: compat_sys_ptracesyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:152Open
PowerPC 64260x1asys_ptrace compat: compat_sys_ptracescr0r3, r4, r5, r6, r7, r8syscall.tbl:44Open
PowerPC 32260x1asys_ptrace compat: compat_sys_ptracescr0r3, r4, r5, r6, r7, r8syscall.tbl:44Open
IBM Z (s390x)260x1asys_ptracesvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:28Open
MIPS o3240260xfbasys_ptrace compat: compat_sys_ptracesyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:37Open
MIPS n3260990x17d3compat_sys_ptracesyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:109Open
MIPS n6450990x13ebsys_ptracesyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:109Open

Argument locations are the ABI’s calling convention for ARG1–ARG6 in order, not an assignment made for this call. On 32-bit ABIs, 64-bit values may occupy multiple registers and require alignment; assembly wrappers may reorder them. See syscall(2). A table entry does not mean the call exists in every kernel: most optional calls return ENOSYS when the matching configuration option or architecture support is not built.

Kernel declaration

asmlinkage long sys_ptrace(long request, long pid, unsigned long addr, unsigned long data);

x86-64, i386, AArch64, ARM EABI, RISC-V 64, LoongArch 64, PowerPC 64, PowerPC 32, IBM Z (s390x), MIPS o32, MIPS n64 · Declaration: include/linux/syscalls.h:648

asmlinkage long compat_sys_ptrace(compat_long_t request, compat_long_t pid, compat_long_t addr, compat_long_t data);

MIPS n32 · Declaration: include/linux/compat.h:696

Signatures are kernel declarations and may differ from the C library wrappers.

Manual page

ptrace(2)

Bundled kernel releases

Bundled releases whose tables define ptrace
ReleaseABIs bundledDefined in the table of
Linux 7.312all 12
Linux 6.1812all 12
Linux 6.1212all 12
Linux 6.612all 12
Linux 5.1912all 12
Linux 4.155all 5
Linux 3.74all 4
Linux 3.03all 3
Linux 2.6.243all 3
Linux 2.6.163all 3
Linux 2.6.122all 2
Linux 1.01all 1

Each release is a separate snapshot, and older releases bundle fewer ABIs. This table does not claim the release in which the call first appeared. Numbers are listed where a release differs from Linux 7.3.