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