Home | History | Annotate | Download | only in 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 
     59 struct 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 */
    105