]>
Commit | Line | Data |
---|---|---|
554066b8 | 1 | /* `ptrace' debugger support interface. Linux version. |
b168057a | 2 | Copyright (C) 1996-2015 Free Software Foundation, Inc. |
554066b8 MS |
3 | |
4 | This file is part of the GNU C Library. | |
5 | ||
6 | The GNU C Library is free software; you can redistribute it and/or | |
7 | modify it under the terms of the GNU Lesser General Public | |
8 | License as published by the Free Software Foundation; either | |
9 | version 2.1 of the License, or (at your option) any later version. | |
10 | ||
11 | The GNU C Library is distributed in the hope that it will be useful, | |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
14 | Lesser General Public License for more details. | |
15 | ||
16 | You should have received a copy of the GNU Lesser General Public | |
17 | License along with the GNU C Library; if not, see | |
18 | <http://www.gnu.org/licenses/>. */ | |
19 | ||
20 | #ifndef _SYS_PTRACE_H | |
21 | #define _SYS_PTRACE_H 1 | |
22 | ||
23 | #include <features.h> | |
521c6785 | 24 | #include <bits/types.h> |
554066b8 MS |
25 | |
26 | __BEGIN_DECLS | |
27 | ||
28 | /* Type of the REQUEST argument to `ptrace.' */ | |
29 | enum __ptrace_request | |
30 | { | |
31 | /* Indicate that the process making this request should be traced. | |
32 | All signals received by this process can be intercepted by its | |
33 | parent, and its parent can use the other `ptrace' requests. */ | |
34 | PTRACE_TRACEME = 0, | |
35 | #define PT_TRACE_ME PTRACE_TRACEME | |
36 | ||
37 | /* Return the word in the process's text space at address ADDR. */ | |
38 | PTRACE_PEEKTEXT = 1, | |
39 | #define PT_READ_I PTRACE_PEEKTEXT | |
40 | ||
41 | /* Return the word in the process's data space at address ADDR. */ | |
42 | PTRACE_PEEKDATA = 2, | |
43 | #define PT_READ_D PTRACE_PEEKDATA | |
44 | ||
45 | /* Return the word in the process's user area at offset ADDR. */ | |
46 | PTRACE_PEEKUSER = 3, | |
47 | #define PT_READ_U PTRACE_PEEKUSER | |
48 | ||
49 | /* Write the word DATA into the process's text space at address ADDR. */ | |
50 | PTRACE_POKETEXT = 4, | |
51 | #define PT_WRITE_I PTRACE_POKETEXT | |
52 | ||
53 | /* Write the word DATA into the process's data space at address ADDR. */ | |
54 | PTRACE_POKEDATA = 5, | |
55 | #define PT_WRITE_D PTRACE_POKEDATA | |
56 | ||
57 | /* Write the word DATA into the process's user area at offset ADDR. */ | |
58 | PTRACE_POKEUSER = 6, | |
59 | #define PT_WRITE_U PTRACE_POKEUSER | |
60 | ||
61 | /* Continue the process. */ | |
62 | PTRACE_CONT = 7, | |
63 | #define PT_CONTINUE PTRACE_CONT | |
64 | ||
65 | /* Kill the process. */ | |
66 | PTRACE_KILL = 8, | |
67 | #define PT_KILL PTRACE_KILL | |
68 | ||
69 | /* Single step the process. */ | |
70 | PTRACE_SINGLESTEP = 9, | |
71 | #define PT_STEP PTRACE_SINGLESTEP | |
72 | ||
73 | /* Attach to a process that is already running. */ | |
74 | PTRACE_ATTACH = 16, | |
75 | #define PT_ATTACH PTRACE_ATTACH | |
76 | ||
77 | /* Detach from a process attached to with PTRACE_ATTACH. */ | |
78 | PTRACE_DETACH = 17, | |
79 | #define PT_DETACH PTRACE_DETACH | |
80 | ||
81 | PTRACE_GET_THREAD_AREA = 22, | |
82 | ||
83 | /* Continue and stop at the next (return from) syscall. */ | |
84 | PTRACE_SYSCALL = 24, | |
85 | #define PT_SYSCALL PTRACE_SYSCALL | |
86 | ||
87 | /* Get all hardware breakpoint registers. */ | |
88 | PTRACE_GETHBPREGS = 29, | |
89 | ||
90 | /* Set all hardware breakpoint registers. */ | |
91 | PTRACE_SETHBPREGS = 30, | |
92 | ||
93 | /* Set ptrace filter options. */ | |
94 | PTRACE_SETOPTIONS = 0x4200, | |
95 | #define PT_SETOPTIONS PTRACE_SETOPTIONS | |
96 | ||
97 | /* Get last ptrace message. */ | |
98 | PTRACE_GETEVENTMSG = 0x4201, | |
99 | #define PT_GETEVENTMSG PTRACE_GETEVENTMSG | |
100 | ||
101 | /* Get siginfo for process. */ | |
102 | PTRACE_GETSIGINFO = 0x4202, | |
103 | #define PT_GETSIGINFO PTRACE_GETSIGINFO | |
104 | ||
105 | /* Set new siginfo for process. */ | |
106 | PTRACE_SETSIGINFO = 0x4203, | |
107 | #define PT_SETSIGINFO PTRACE_SETSIGINFO | |
108 | ||
109 | /* Get register content. */ | |
110 | PTRACE_GETREGSET = 0x4204, | |
111 | #define PTRACE_GETREGSET PTRACE_GETREGSET | |
112 | ||
113 | /* Set register content. */ | |
114 | PTRACE_SETREGSET = 0x4205, | |
115 | #define PTRACE_SETREGSET PTRACE_SETREGSET | |
116 | ||
117 | /* Like PTRACE_ATTACH, but do not force tracee to trap and do not affect | |
118 | signal or group stop state. */ | |
119 | PTRACE_SEIZE = 0x4206, | |
120 | #define PTRACE_SEIZE PTRACE_SEIZE | |
121 | ||
122 | /* Trap seized trace. */ | |
123 | PTRACE_INTERRUPT = 0x4207, | |
124 | #define PTRACE_INTERRUPT PTRACE_INTERRUPT | |
125 | ||
126 | /* Wait for next group event. */ | |
521c6785 AJ |
127 | PTRACE_LISTEN = 0x4208, |
128 | #define PTRACE_LISTEN PTRACE_LISTEN | |
129 | ||
130 | PTRACE_PEEKSIGINFO = 0x4209 | |
131 | #define PTRACE_PEEKSIGINFO PTRACE_PEEKSIGINFO | |
554066b8 MS |
132 | }; |
133 | ||
134 | ||
135 | /* Flag for PTRACE_LISTEN. */ | |
136 | enum __ptrace_flags | |
137 | { | |
138 | PTRACE_SEIZE_DEVEL = 0x80000000 | |
139 | }; | |
140 | ||
141 | /* Options set using PTRACE_SETOPTIONS. */ | |
142 | enum __ptrace_setoptions | |
143 | { | |
144 | PTRACE_O_TRACESYSGOOD = 0x00000001, | |
145 | PTRACE_O_TRACEFORK = 0x00000002, | |
146 | PTRACE_O_TRACEVFORK = 0x00000004, | |
147 | PTRACE_O_TRACECLONE = 0x00000008, | |
148 | PTRACE_O_TRACEEXEC = 0x00000010, | |
149 | PTRACE_O_TRACEVFORKDONE = 0x00000020, | |
150 | PTRACE_O_TRACEEXIT = 0x00000040, | |
151 | PTRACE_O_TRACESECCOMP = 0x00000080, | |
152 | PTRACE_O_MASK = 0x000000ff | |
153 | }; | |
154 | ||
155 | /* Wait extended result codes for the above trace options. */ | |
156 | enum __ptrace_eventcodes | |
157 | { | |
158 | PTRACE_EVENT_FORK = 1, | |
159 | PTRACE_EVENT_VFORK = 2, | |
160 | PTRACE_EVENT_CLONE = 3, | |
161 | PTRACE_EVENT_EXEC = 4, | |
162 | PTRACE_EVENT_VFORK_DONE = 5, | |
163 | PTRACE_EVENT_EXIT = 6, | |
164 | PTRACE_EVENT_SECCOMP = 7 | |
165 | }; | |
166 | ||
521c6785 | 167 | /* Arguments for PTRACE_PEEKSIGINFO. */ |
9341dde4 | 168 | struct __ptrace_peeksiginfo_args |
521c6785 AJ |
169 | { |
170 | __uint64_t off; /* From which siginfo to start. */ | |
171 | __uint32_t flags; /* Flags for peeksiginfo. */ | |
172 | __int32_t nr; /* How many siginfos to take. */ | |
173 | }; | |
174 | ||
175 | enum __ptrace_peeksiginfo_flags | |
176 | { | |
177 | /* Read signals from a shared (process wide) queue. */ | |
178 | PTRACE_PEEKSIGINFO_SHARED = (1 << 0) | |
179 | }; | |
180 | ||
554066b8 MS |
181 | /* Perform process tracing functions. REQUEST is one of the values |
182 | above, and determines the action to be taken. | |
183 | For all requests except PTRACE_TRACEME, PID specifies the process to be | |
184 | traced. | |
185 | ||
186 | PID and the other arguments described above for the various requests should | |
187 | appear (those that are used for the particular request) as: | |
188 | pid_t PID, void *ADDR, int DATA, void *ADDR2 | |
189 | after REQUEST. */ | |
190 | extern long int ptrace (enum __ptrace_request __request, ...) __THROW; | |
191 | ||
192 | __END_DECLS | |
193 | ||
194 | #endif /* _SYS_PTRACE_H */ |