[linux.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 */
};

/* 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
84c751bd AV	76	/* Read signals from a shared (process wide) queue */
	77	#define PTRACE_PEEKSIGINFO_SHARED (1 << 0)
	78
607ca46e DH	79	/* Wait extended result codes for the above trace options. */
	80	#define PTRACE_EVENT_FORK 1
	81	#define PTRACE_EVENT_VFORK 2
	82	#define PTRACE_EVENT_CLONE 3
	83	#define PTRACE_EVENT_EXEC 4
	84	#define PTRACE_EVENT_VFORK_DONE 5
	85	#define PTRACE_EVENT_EXIT 6
	86	#define PTRACE_EVENT_SECCOMP 7
	87	/* Extended result codes which enabled by means other than options. */
	88	#define PTRACE_EVENT_STOP 128
	89
	90	/* Options set using PTRACE_SETOPTIONS or using PTRACE_SEIZE @data param */
	91	#define PTRACE_O_TRACESYSGOOD 1
	92	#define PTRACE_O_TRACEFORK (1 << PTRACE_EVENT_FORK)
	93	#define PTRACE_O_TRACEVFORK (1 << PTRACE_EVENT_VFORK)
	94	#define PTRACE_O_TRACECLONE (1 << PTRACE_EVENT_CLONE)
	95	#define PTRACE_O_TRACEEXEC (1 << PTRACE_EVENT_EXEC)
	96	#define PTRACE_O_TRACEVFORKDONE (1 << PTRACE_EVENT_VFORK_DONE)
	97	#define PTRACE_O_TRACEEXIT (1 << PTRACE_EVENT_EXIT)
	98	#define PTRACE_O_TRACESECCOMP (1 << PTRACE_EVENT_SECCOMP)
	99
992fb6e1	100	/* eventless options */
13c4a901 TA	101	#define PTRACE_O_EXITKILL (1 << 20)
13c4a901 TA	102	#define PTRACE_O_SUSPEND_SECCOMP (1 << 21)
992fb6e1	103
13c4a901 TA	104	#define PTRACE_O_MASK (\
13c4a901 TA	105	0x000000ff \| PTRACE_O_EXITKILL \| PTRACE_O_SUSPEND_SECCOMP)
607ca46e DH	106
	107	#include <asm/ptrace.h>
	108
	109
	110	#endif /* _UAPI_LINUX_PTRACE_H */