b2b3dba1298d1fef7f1b4e4ecfba22fe142c88d2
[linux-2.6.git] / include / linux / ptrace.h
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
82 extern long arch_ptrace(struct task_struct *child, long request, long addr, long data);
83 extern int ptrace_readdata(struct task_struct *tsk, unsigned long src, char __user *dst, int len);
84 extern int ptrace_writedata(struct task_struct *tsk, char __user *src, unsigned long dst, int len);
85 extern int ptrace_attach(struct task_struct *tsk);
86 extern int ptrace_detach(struct task_struct *, unsigned int);
87 extern void ptrace_disable(struct task_struct *);
88 extern int ptrace_check_attach(struct task_struct *task, int kill);
89 extern int ptrace_request(struct task_struct *child, long request, long addr, long data);
90 extern void ptrace_notify(int exit_code);
91 extern void __ptrace_link(struct task_struct *child,
92                           struct task_struct *new_parent);
93 extern void __ptrace_unlink(struct task_struct *child);
94 extern void ptrace_untrace(struct task_struct *child);
95 extern int ptrace_may_attach(struct task_struct *task);
96
97 static inline void ptrace_link(struct task_struct *child,
98                                struct task_struct *new_parent)
99 {
100         if (unlikely(child->ptrace))
101                 __ptrace_link(child, new_parent);
102 }
103 static inline void ptrace_unlink(struct task_struct *child)
104 {
105         if (unlikely(child->ptrace))
106                 __ptrace_unlink(child);
107 }
108
109
110 #ifndef force_successful_syscall_return
111 /*
112  * System call handlers that, upon successful completion, need to return a
113  * negative value should call force_successful_syscall_return() right before
114  * returning.  On architectures where the syscall convention provides for a
115  * separate error flag (e.g., alpha, ia64, ppc{,64}, sparc{,64}, possibly
116  * others), this macro can be used to ensure that the error flag will not get
117  * set.  On architectures which do not support a separate error flag, the macro
118  * is a no-op and the spurious error condition needs to be filtered out by some
119  * other means (e.g., in user-level, by passing an extra argument to the
120  * syscall handler, or something along those lines).
121  */
122 #define force_successful_syscall_return() do { } while (0)
123 #endif
124
125 #endif
126
127 #endif