[linux-block.git] / include / uapi / linux / ptrace.h

/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
#ifndef _UAPI_LINUX_PTRACE_H
#define _UAPI_LINUX_PTRACE_H
/* ptrace.h */
/* structs and defines to help the user use the ptrace system call. */

/* has the defines to get at the registers. */

#include <linux/types.h>

#define PTRACE_TRACEME		   0
#define PTRACE_PEEKTEXT		   1
#define PTRACE_PEEKDATA		   2
#define PTRACE_PEEKUSR		   3
#define PTRACE_POKETEXT		   4
#define PTRACE_POKEDATA		   5
#define PTRACE_POKEUSR		   6
#define PTRACE_CONT		   7
#define PTRACE_KILL		   8
#define PTRACE_SINGLESTEP	   9

#define PTRACE_ATTACH		  16
#define PTRACE_DETACH		  17

#define PTRACE_SYSCALL		  24

/* 0x4200-0x4300 are reserved for architecture-independent additions.  */
#define PTRACE_SETOPTIONS	0x4200
#define PTRACE_GETEVENTMSG	0x4201
#define PTRACE_GETSIGINFO	0x4202
#define PTRACE_SETSIGINFO	0x4203

/*
 * Generic ptrace interface that exports the architecture specific regsets
 * using the corresponding NT_* types (which are also used in the core dump).
 * Please note that the NT_PRSTATUS note type in a core dump contains a full
 * 'struct elf_prstatus'. But the user_regset for NT_PRSTATUS contains just the
 * elf_gregset_t that is the pr_reg field of 'struct elf_prstatus'. For all the
 * other user_regset flavors, the user_regset layout and the ELF core dump note
 * payload are exactly the same layout.
 *
 * This interface usage is as follows:
 *	struct iovec iov = { buf, len};
 *
 *	ret = ptrace(PTRACE_GETREGSET/PTRACE_SETREGSET, pid, NT_XXX_TYPE, &iov);
 *
 * On the successful completion, iov.len will be updated by the kernel,
 * specifying how much the kernel has written/read to/from the user's iov.buf.
 */
#define PTRACE_GETREGSET	0x4204
#define PTRACE_SETREGSET	0x4205

#define PTRACE_SEIZE		0x4206
#define PTRACE_INTERRUPT	0x4207
#define PTRACE_LISTEN		0x4208

#define PTRACE_PEEKSIGINFO	0x4209

struct ptrace_peeksiginfo_args {
	__u64 off;	/* from which siginfo to start */
	__u32 flags;
	__s32 nr;	/* how may siginfos to take */
};

#define PTRACE_GETSIGMASK	0x420a
#define PTRACE_SETSIGMASK	0x420b

#define PTRACE_SECCOMP_GET_FILTER	0x420c
#define PTRACE_SECCOMP_GET_METADATA	0x420d

struct seccomp_metadata {
	__u64 filter_off;	/* Input: which filter */
	__u64 flags;		/* Output: filter's flags */
};

#define PTRACE_GET_SYSCALL_INFO		0x420e
#define PTRACE_SYSCALL_INFO_NONE	0
#define PTRACE_SYSCALL_INFO_ENTRY	1
#define PTRACE_SYSCALL_INFO_EXIT	2
#define PTRACE_SYSCALL_INFO_SECCOMP	3

struct ptrace_syscall_info {
	__u8 op;	/* PTRACE_SYSCALL_INFO_* */
	__u32 arch __attribute__((__aligned__(sizeof(__u32))));
	__u64 instruction_pointer;
	__u64 stack_pointer;
	union {
		struct {
			__u64 nr;
			__u64 args[6];
		} entry;
		struct {
			__s64 rval;
			__u8 is_error;
		} exit;
		struct {
			__u64 nr;
			__u64 args[6];
			__u32 ret_data;
		} seccomp;
	};
};

/*
 * These values are stored in task->ptrace_message
 * by tracehook_report_syscall_* to describe the current syscall-stop.
 */
#define PTRACE_EVENTMSG_SYSCALL_ENTRY	1
#define PTRACE_EVENTMSG_SYSCALL_EXIT	2

/* Read signals from a shared (process wide) queue */
#define PTRACE_PEEKSIGINFO_SHARED	(1 << 0)

/* Wait extended result codes for the above trace options.  */
#define PTRACE_EVENT_FORK	1
#define PTRACE_EVENT_VFORK	2
#define PTRACE_EVENT_CLONE	3
#define PTRACE_EVENT_EXEC	4
#define PTRACE_EVENT_VFORK_DONE	5
#define PTRACE_EVENT_EXIT	6
#define PTRACE_EVENT_SECCOMP	7
/* Extended result codes which enabled by means other than options.  */
#define PTRACE_EVENT_STOP	128

/* Options set using PTRACE_SETOPTIONS or using PTRACE_SEIZE @data param */
#define PTRACE_O_TRACESYSGOOD	1
#define PTRACE_O_TRACEFORK	(1 << PTRACE_EVENT_FORK)
#define PTRACE_O_TRACEVFORK	(1 << PTRACE_EVENT_VFORK)
#define PTRACE_O_TRACECLONE	(1 << PTRACE_EVENT_CLONE)
#define PTRACE_O_TRACEEXEC	(1 << PTRACE_EVENT_EXEC)
#define PTRACE_O_TRACEVFORKDONE	(1 << PTRACE_EVENT_VFORK_DONE)
#define PTRACE_O_TRACEEXIT	(1 << PTRACE_EVENT_EXIT)
#define PTRACE_O_TRACESECCOMP	(1 << PTRACE_EVENT_SECCOMP)

/* eventless options */
#define PTRACE_O_EXITKILL		(1 << 20)
#define PTRACE_O_SUSPEND_SECCOMP	(1 << 21)

#define PTRACE_O_MASK		(\
	0x000000ff | PTRACE_O_EXITKILL | PTRACE_O_SUSPEND_SECCOMP)

#include <asm/ptrace.h>


#endif /* _UAPI_LINUX_PTRACE_H */
Commit	Line	Data
6f52b16c	1	/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
607ca46e DH	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
84c751bd	9	#include <linux/types.h>
607ca46e DH	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
84c751bd AV	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
29000cae AV	65	#define PTRACE_GETSIGMASK 0x420a
	66	#define PTRACE_SETSIGMASK 0x420b
	67
f8e529ed	68	#define PTRACE_SECCOMP_GET_FILTER 0x420c
26500475 TA	69	#define PTRACE_SECCOMP_GET_METADATA 0x420d
	70
	71	struct seccomp_metadata {
2a040f9f TA	72	__u64 filter_off; /* Input: which filter */
2a040f9f TA	73	__u64 flags; /* Output: filter's flags */
26500475	74	};
f8e529ed	75
201766a2 EK	76	#define PTRACE_GET_SYSCALL_INFO 0x420e
	77	#define PTRACE_SYSCALL_INFO_NONE 0
	78	#define PTRACE_SYSCALL_INFO_ENTRY 1
	79	#define PTRACE_SYSCALL_INFO_EXIT 2
	80	#define PTRACE_SYSCALL_INFO_SECCOMP 3
	81
	82	struct ptrace_syscall_info {
	83	__u8 op; /* PTRACE_SYSCALL_INFO_* */
	84	__u32 arch __attribute__((__aligned__(sizeof(__u32))));
	85	__u64 instruction_pointer;
	86	__u64 stack_pointer;
	87	union {
	88	struct {
	89	__u64 nr;
	90	__u64 args[6];
	91	} entry;
	92	struct {
	93	__s64 rval;
	94	__u8 is_error;
	95	} exit;
	96	struct {
	97	__u64 nr;
	98	__u64 args[6];
	99	__u32 ret_data;
	100	} seccomp;
	101	};
	102	};
	103
	104	/*
	105	* These values are stored in task->ptrace_message
	106	* by tracehook_report_syscall_* to describe the current syscall-stop.
	107	*/
	108	#define PTRACE_EVENTMSG_SYSCALL_ENTRY 1
	109	#define PTRACE_EVENTMSG_SYSCALL_EXIT 2
	110
84c751bd AV	111	/* Read signals from a shared (process wide) queue */
	112	#define PTRACE_PEEKSIGINFO_SHARED (1 << 0)
	113
607ca46e DH	114	/* Wait extended result codes for the above trace options. */
	115	#define PTRACE_EVENT_FORK 1
	116	#define PTRACE_EVENT_VFORK 2
	117	#define PTRACE_EVENT_CLONE 3
	118	#define PTRACE_EVENT_EXEC 4
	119	#define PTRACE_EVENT_VFORK_DONE 5
	120	#define PTRACE_EVENT_EXIT 6
	121	#define PTRACE_EVENT_SECCOMP 7
	122	/* Extended result codes which enabled by means other than options. */
	123	#define PTRACE_EVENT_STOP 128
	124
	125	/* Options set using PTRACE_SETOPTIONS or using PTRACE_SEIZE @data param */
	126	#define PTRACE_O_TRACESYSGOOD 1
	127	#define PTRACE_O_TRACEFORK (1 << PTRACE_EVENT_FORK)
	128	#define PTRACE_O_TRACEVFORK (1 << PTRACE_EVENT_VFORK)
	129	#define PTRACE_O_TRACECLONE (1 << PTRACE_EVENT_CLONE)
	130	#define PTRACE_O_TRACEEXEC (1 << PTRACE_EVENT_EXEC)
	131	#define PTRACE_O_TRACEVFORKDONE (1 << PTRACE_EVENT_VFORK_DONE)
	132	#define PTRACE_O_TRACEEXIT (1 << PTRACE_EVENT_EXIT)
	133	#define PTRACE_O_TRACESECCOMP (1 << PTRACE_EVENT_SECCOMP)
	134
992fb6e1	135	/* eventless options */
13c4a901 TA	136	#define PTRACE_O_EXITKILL (1 << 20)
13c4a901 TA	137	#define PTRACE_O_SUSPEND_SECCOMP (1 << 21)
992fb6e1	138
13c4a901 TA	139	#define PTRACE_O_MASK (\
13c4a901 TA	140	0x000000ff \| PTRACE_O_EXITKILL \| PTRACE_O_SUSPEND_SECCOMP)
607ca46e DH	141
	142	#include <asm/ptrace.h>
	143
	144
	145	#endif /* _UAPI_LINUX_PTRACE_H */