Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2#ifndef _UAPI_LINUX_PTRACE_H
3#define _UAPI_LINUX_PTRACE_H
4/* ptrace.h */
5/* structs and defines to help the user use the ptrace system call. */
6
7/* has the defines to get at the registers. */
8
9#include <linux/types.h>
10
11#define PTRACE_TRACEME 0
12#define PTRACE_PEEKTEXT 1
13#define PTRACE_PEEKDATA 2
14#define PTRACE_PEEKUSR 3
15#define PTRACE_POKETEXT 4
16#define PTRACE_POKEDATA 5
17#define PTRACE_POKEUSR 6
18#define PTRACE_CONT 7
19#define PTRACE_KILL 8
20#define PTRACE_SINGLESTEP 9
21
22#define PTRACE_ATTACH 16
23#define PTRACE_DETACH 17
24
25#define PTRACE_SYSCALL 24
26
27/* 0x4200-0x4300 are reserved for architecture-independent additions. */
28#define PTRACE_SETOPTIONS 0x4200
29#define PTRACE_GETEVENTMSG 0x4201
30#define PTRACE_GETSIGINFO 0x4202
31#define PTRACE_SETSIGINFO 0x4203
32
33/*
34 * Generic ptrace interface that exports the architecture specific regsets
35 * using the corresponding NT_* types (which are also used in the core dump).
36 * Please note that the NT_PRSTATUS note type in a core dump contains a full
37 * 'struct elf_prstatus'. But the user_regset for NT_PRSTATUS contains just the
38 * elf_gregset_t that is the pr_reg field of 'struct elf_prstatus'. For all the
39 * other user_regset flavors, the user_regset layout and the ELF core dump note
40 * payload are exactly the same layout.
41 *
42 * This interface usage is as follows:
43 * struct iovec iov = { buf, len};
44 *
45 * ret = ptrace(PTRACE_GETREGSET/PTRACE_SETREGSET, pid, NT_XXX_TYPE, &iov);
46 *
47 * On the successful completion, iov.len will be updated by the kernel,
48 * specifying how much the kernel has written/read to/from the user's iov.buf.
49 */
50#define PTRACE_GETREGSET 0x4204
51#define PTRACE_SETREGSET 0x4205
52
53#define PTRACE_SEIZE 0x4206
54#define PTRACE_INTERRUPT 0x4207
55#define PTRACE_LISTEN 0x4208
56
57#define PTRACE_PEEKSIGINFO 0x4209
58
59struct ptrace_peeksiginfo_args {
60 __u64 off; /* from which siginfo to start */
61 __u32 flags;
62 __s32 nr; /* how may siginfos to take */
63};
64
65#define PTRACE_GETSIGMASK 0x420a
66#define PTRACE_SETSIGMASK 0x420b
67
68#define PTRACE_SECCOMP_GET_FILTER 0x420c
69
70/* Read signals from a shared (process wide) queue */
71#define PTRACE_PEEKSIGINFO_SHARED (1 << 0)
72
73/* Wait extended result codes for the above trace options. */
74#define PTRACE_EVENT_FORK 1
75#define PTRACE_EVENT_VFORK 2
76#define PTRACE_EVENT_CLONE 3
77#define PTRACE_EVENT_EXEC 4
78#define PTRACE_EVENT_VFORK_DONE 5
79#define PTRACE_EVENT_EXIT 6
80#define PTRACE_EVENT_SECCOMP 7
81/* Extended result codes which enabled by means other than options. */
82#define PTRACE_EVENT_STOP 128
83
84/* Options set using PTRACE_SETOPTIONS or using PTRACE_SEIZE @data param */
85#define PTRACE_O_TRACESYSGOOD 1
86#define PTRACE_O_TRACEFORK (1 << PTRACE_EVENT_FORK)
87#define PTRACE_O_TRACEVFORK (1 << PTRACE_EVENT_VFORK)
88#define PTRACE_O_TRACECLONE (1 << PTRACE_EVENT_CLONE)
89#define PTRACE_O_TRACEEXEC (1 << PTRACE_EVENT_EXEC)
90#define PTRACE_O_TRACEVFORKDONE (1 << PTRACE_EVENT_VFORK_DONE)
91#define PTRACE_O_TRACEEXIT (1 << PTRACE_EVENT_EXIT)
92#define PTRACE_O_TRACESECCOMP (1 << PTRACE_EVENT_SECCOMP)
93
94/* eventless options */
95#define PTRACE_O_EXITKILL (1 << 20)
96#define PTRACE_O_SUSPEND_SECCOMP (1 << 21)
97
98#define PTRACE_O_MASK (\
99 0x000000ff | PTRACE_O_EXITKILL | PTRACE_O_SUSPEND_SECCOMP)
100
101#include <asm/ptrace.h>
102
103
104#endif /* _UAPI_LINUX_PTRACE_H */