xref: /openbmc/linux/include/linux/ptrace.h (revision d5cb9783536a41df9f9cba5b0a1d78047ed787f7)
1 #ifndef _LINUX_PTRACE_H
2 #define _LINUX_PTRACE_H
3 /* ptrace.h */
4 /* structs and defines to help the user use the ptrace system call. */
5 
6 /* has the defines to get at the registers. */
7 
8 #define PTRACE_TRACEME		   0
9 #define PTRACE_PEEKTEXT		   1
10 #define PTRACE_PEEKDATA		   2
11 #define PTRACE_PEEKUSR		   3
12 #define PTRACE_POKETEXT		   4
13 #define PTRACE_POKEDATA		   5
14 #define PTRACE_POKEUSR		   6
15 #define PTRACE_CONT		   7
16 #define PTRACE_KILL		   8
17 #define PTRACE_SINGLESTEP	   9
18 
19 #define PTRACE_ATTACH		0x10
20 #define PTRACE_DETACH		0x11
21 
22 #define PTRACE_SYSCALL		  24
23 #define PTRACE_SYSEMU		  31
24 #define PTRACE_SYSEMU_SINGLESTEP  32
25 
26 /* 0x4200-0x4300 are reserved for architecture-independent additions.  */
27 #define PTRACE_SETOPTIONS	0x4200
28 #define PTRACE_GETEVENTMSG	0x4201
29 #define PTRACE_GETSIGINFO	0x4202
30 #define PTRACE_SETSIGINFO	0x4203
31 
32 /* options set using PTRACE_SETOPTIONS */
33 #define PTRACE_O_TRACESYSGOOD	0x00000001
34 #define PTRACE_O_TRACEFORK	0x00000002
35 #define PTRACE_O_TRACEVFORK	0x00000004
36 #define PTRACE_O_TRACECLONE	0x00000008
37 #define PTRACE_O_TRACEEXEC	0x00000010
38 #define PTRACE_O_TRACEVFORKDONE	0x00000020
39 #define PTRACE_O_TRACEEXIT	0x00000040
40 
41 #define PTRACE_O_MASK		0x0000007f
42 
43 /* Wait extended result codes for the above trace options.  */
44 #define PTRACE_EVENT_FORK	1
45 #define PTRACE_EVENT_VFORK	2
46 #define PTRACE_EVENT_CLONE	3
47 #define PTRACE_EVENT_EXEC	4
48 #define PTRACE_EVENT_VFORK_DONE	5
49 #define PTRACE_EVENT_EXIT	6
50 
51 #include <asm/ptrace.h>
52 
53 #ifdef __KERNEL__
54 /*
55  * Ptrace flags
56  */
57 
58 #define PT_PTRACED	0x00000001
59 #define PT_DTRACE	0x00000002	/* delayed trace (used on m68k, i386) */
60 #define PT_TRACESYSGOOD	0x00000004
61 #define PT_PTRACE_CAP	0x00000008	/* ptracer can follow suid-exec */
62 #define PT_TRACE_FORK	0x00000010
63 #define PT_TRACE_VFORK	0x00000020
64 #define PT_TRACE_CLONE	0x00000040
65 #define PT_TRACE_EXEC	0x00000080
66 #define PT_TRACE_VFORK_DONE	0x00000100
67 #define PT_TRACE_EXIT	0x00000200
68 #define PT_ATTACHED	0x00000400	/* parent != real_parent */
69 
70 #define PT_TRACE_MASK	0x000003f4
71 
72 /* single stepping state bits (used on ARM and PA-RISC) */
73 #define PT_SINGLESTEP_BIT	31
74 #define PT_SINGLESTEP		(1<<PT_SINGLESTEP_BIT)
75 #define PT_BLOCKSTEP_BIT	30
76 #define PT_BLOCKSTEP		(1<<PT_BLOCKSTEP_BIT)
77 
78 #include <linux/compiler.h>		/* For unlikely.  */
79 #include <linux/sched.h>		/* For struct task_struct.  */
80 
81 extern int ptrace_readdata(struct task_struct *tsk, unsigned long src, char __user *dst, int len);
82 extern int ptrace_writedata(struct task_struct *tsk, char __user *src, unsigned long dst, int len);
83 extern int ptrace_attach(struct task_struct *tsk);
84 extern int ptrace_detach(struct task_struct *, unsigned int);
85 extern void ptrace_disable(struct task_struct *);
86 extern int ptrace_check_attach(struct task_struct *task, int kill);
87 extern int ptrace_request(struct task_struct *child, long request, long addr, long data);
88 extern void ptrace_notify(int exit_code);
89 extern void __ptrace_link(struct task_struct *child,
90 			  struct task_struct *new_parent);
91 extern void __ptrace_unlink(struct task_struct *child);
92 extern void ptrace_untrace(struct task_struct *child);
93 extern int ptrace_may_attach(struct task_struct *task);
94 
95 static inline void ptrace_link(struct task_struct *child,
96 			       struct task_struct *new_parent)
97 {
98 	if (unlikely(child->ptrace))
99 		__ptrace_link(child, new_parent);
100 }
101 static inline void ptrace_unlink(struct task_struct *child)
102 {
103 	if (unlikely(child->ptrace))
104 		__ptrace_unlink(child);
105 }
106 
107 
108 #ifndef force_successful_syscall_return
109 /*
110  * System call handlers that, upon successful completion, need to return a
111  * negative value should call force_successful_syscall_return() right before
112  * returning.  On architectures where the syscall convention provides for a
113  * separate error flag (e.g., alpha, ia64, ppc{,64}, sparc{,64}, possibly
114  * others), this macro can be used to ensure that the error flag will not get
115  * set.  On architectures which do not support a separate error flag, the macro
116  * is a no-op and the spurious error condition needs to be filtered out by some
117  * other means (e.g., in user-level, by passing an extra argument to the
118  * syscall handler, or something along those lines).
119  */
120 #define force_successful_syscall_return() do { } while (0)
121 #endif
122 
123 #endif
124 
125 #endif
126