blob: 864791996b5fa8efaafb777dff7f74cc623c3f47 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#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
Laurent Viviered75e8d2005-09-03 15:57:18 -070023#define PTRACE_SYSEMU 31
Bodo Stroesser1b38f002005-09-03 15:57:20 -070024#define PTRACE_SYSEMU_SINGLESTEP 32
Linus Torvalds1da177e2005-04-16 15:20:36 -070025
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
Christoph Hellwig481bed42005-11-07 00:59:47 -080081
82extern long arch_ptrace(struct task_struct *child, long request, long addr, long data);
Christoph Hellwig6b9c7ed2006-01-08 01:02:33 -080083extern struct task_struct *ptrace_get_task_struct(pid_t pid);
84extern int ptrace_traceme(void);
Linus Torvalds1da177e2005-04-16 15:20:36 -070085extern int ptrace_readdata(struct task_struct *tsk, unsigned long src, char __user *dst, int len);
86extern int ptrace_writedata(struct task_struct *tsk, char __user *src, unsigned long dst, int len);
87extern int ptrace_attach(struct task_struct *tsk);
88extern int ptrace_detach(struct task_struct *, unsigned int);
89extern void ptrace_disable(struct task_struct *);
90extern int ptrace_check_attach(struct task_struct *task, int kill);
91extern int ptrace_request(struct task_struct *child, long request, long addr, long data);
92extern void ptrace_notify(int exit_code);
93extern void __ptrace_link(struct task_struct *child,
94 struct task_struct *new_parent);
95extern void __ptrace_unlink(struct task_struct *child);
96extern void ptrace_untrace(struct task_struct *child);
Miklos Szerediab8d11b2005-09-06 15:18:24 -070097extern int ptrace_may_attach(struct task_struct *task);
Linus Torvalds1da177e2005-04-16 15:20:36 -070098
99static inline void ptrace_link(struct task_struct *child,
100 struct task_struct *new_parent)
101{
102 if (unlikely(child->ptrace))
103 __ptrace_link(child, new_parent);
104}
105static inline void ptrace_unlink(struct task_struct *child)
106{
107 if (unlikely(child->ptrace))
108 __ptrace_unlink(child);
109}
110
111
112#ifndef force_successful_syscall_return
113/*
114 * System call handlers that, upon successful completion, need to return a
115 * negative value should call force_successful_syscall_return() right before
116 * returning. On architectures where the syscall convention provides for a
117 * separate error flag (e.g., alpha, ia64, ppc{,64}, sparc{,64}, possibly
118 * others), this macro can be used to ensure that the error flag will not get
119 * set. On architectures which do not support a separate error flag, the macro
120 * is a no-op and the spurious error condition needs to be filtered out by some
121 * other means (e.g., in user-level, by passing an extra argument to the
122 * syscall handler, or something along those lines).
123 */
124#define force_successful_syscall_return() do { } while (0)
125#endif
126
127#endif
128
129#endif