Relocate AArch64 from ports to libc.
[jlayton/glibc.git] / sysdeps / unix / sysv / linux / aarch64 / sys / ptrace.h
1 /* `ptrace' debugger support interface.  Linux version.
2    Copyright (C) 1996-2014 Free Software Foundation, Inc.
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>
24 #include <bits/types.h>
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.  */
127   PTRACE_LISTEN = 0x4208,
128 #define PTRACE_LISTEN PTRACE_LISTEN
129
130   PTRACE_PEEKSIGINFO = 0x4209
131 #define PTRACE_PEEKSIGINFO PTRACE_PEEKSIGINFO
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
167 /* Arguments for PTRACE_PEEKSIGINFO.  */
168 struct __ptrace_peeksiginfo_args
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
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 */