1/* `ptrace' debugger support interface.  Linux/AArch64 version.
  2   Copyright (C) 1996-2025 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   <https://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/* Avoid collision if the linux ptrace header is already included.  */
 29#undef PTRACE_TRACEME
 30#undef PTRACE_PEEKTEXT
 31#undef PTRACE_PEEKDATA
 32#undef PTRACE_PEEKUSER
 33#undef PTRACE_POKETEXT
 34#undef PTRACE_POKEDATA
 35#undef PTRACE_POKEUSER
 36#undef PTRACE_CONT
 37#undef PTRACE_KILL
 38#undef PTRACE_SINGLESTEP
 39#undef PTRACE_ATTACH
 40#undef PTRACE_DETACH
 41#undef PTRACE_SYSCALL
 42#undef PTRACE_SYSEMU
 43#undef PTRACE_SYSEMU_SINGLESTEP
 44#undef PTRACE_PEEKMTETAGS
 45#undef PTRACE_POKEMTETAGS
 46#undef PTRACE_SETOPTIONS
 47#undef PTRACE_GETEVENTMSG
 48#undef PTRACE_GETSIGINFO
 49#undef PTRACE_SETSIGINFO
 50#undef PTRACE_GETREGSET
 51#undef PTRACE_SETREGSET
 52#undef PTRACE_SEIZE
 53#undef PTRACE_INTERRUPT
 54#undef PTRACE_LISTEN
 55#undef PTRACE_PEEKSIGINFO
 56#undef PTRACE_GETSIGMASK
 57#undef PTRACE_SETSIGMASK
 58#undef PTRACE_SECCOMP_GET_FILTER
 59#undef PTRACE_SECCOMP_GET_METADATA
 60#undef PTRACE_GET_SYSCALL_INFO
 61#undef PTRACE_GET_RSEQ_CONFIGURATION
 62#undef PTRACE_SET_SYSCALL_USER_DISPATCH_CONFIG
 63#undef PTRACE_GET_SYSCALL_USER_DISPATCH_CONFIG
 64
 65/* Type of the REQUEST argument to `ptrace.'  */
 66enum __ptrace_request
 67{
 68  /* Indicate that the process making this request should be traced.
 69     All signals received by this process can be intercepted by its
 70     parent, and its parent can use the other `ptrace' requests.  */
 71  PTRACE_TRACEME = 0,
 72#define PT_TRACE_ME PTRACE_TRACEME
 73
 74  /* Return the word in the process's text space at address ADDR.  */
 75  PTRACE_PEEKTEXT = 1,
 76#define PT_READ_I PTRACE_PEEKTEXT
 77
 78  /* Return the word in the process's data space at address ADDR.  */
 79  PTRACE_PEEKDATA = 2,
 80#define PT_READ_D PTRACE_PEEKDATA
 81
 82  /* Return the word in the process's user area at offset ADDR.  */
 83  PTRACE_PEEKUSER = 3,
 84#define PT_READ_U PTRACE_PEEKUSER
 85
 86  /* Write the word DATA into the process's text space at address ADDR.  */
 87  PTRACE_POKETEXT = 4,
 88#define PT_WRITE_I PTRACE_POKETEXT
 89
 90  /* Write the word DATA into the process's data space at address ADDR.  */
 91  PTRACE_POKEDATA = 5,
 92#define PT_WRITE_D PTRACE_POKEDATA
 93
 94  /* Write the word DATA into the process's user area at offset ADDR.  */
 95  PTRACE_POKEUSER = 6,
 96#define PT_WRITE_U PTRACE_POKEUSER
 97
 98  /* Continue the process.  */
 99  PTRACE_CONT = 7,
100#define PT_CONTINUE PTRACE_CONT
101
102  /* Kill the process.  */
103  PTRACE_KILL = 8,
104#define PT_KILL PTRACE_KILL
105
106  /* Single step the process.  */
107  PTRACE_SINGLESTEP = 9,
108#define PT_STEP PTRACE_SINGLESTEP
109
110  /* Attach to a process that is already running. */
111  PTRACE_ATTACH = 16,
112#define PT_ATTACH PTRACE_ATTACH
113
114  /* Detach from a process attached to with PTRACE_ATTACH.  */
115  PTRACE_DETACH = 17,
116#define PT_DETACH PTRACE_DETACH
117
118  /* Continue and stop at the next entry to or return from syscall.  */
119  PTRACE_SYSCALL = 24,
120#define PT_SYSCALL PTRACE_SYSCALL
121
122  /* Continue and stop at the next syscall, it will not be executed.  */
123  PTRACE_SYSEMU = 31,
124#define PT_SYSEMU PTRACE_SYSEMU
125
126  /* Single step the process, the next syscall will not be executed.  */
127  PTRACE_SYSEMU_SINGLESTEP = 32,
128#define PT_SYSEMU_SINGLESTEP PTRACE_SYSEMU_SINGLESTEP
129
130  /* Read MTE tags.  */
131  PTRACE_PEEKMTETAGS = 33,
132#define PT_PEEKMTETAGS PTRACE_PEEKMTETAGS
133
134  /* Write MTE tags.  */
135  PTRACE_POKEMTETAGS = 34,
136#define PT_POKEMTETAGS PTRACE_POKEMTETAGS
137
138  /* Set ptrace filter options.  */
139  PTRACE_SETOPTIONS = 0x4200,
140#define PT_SETOPTIONS PTRACE_SETOPTIONS
141
142  /* Get last ptrace message.  */
143  PTRACE_GETEVENTMSG = 0x4201,
144#define PT_GETEVENTMSG PTRACE_GETEVENTMSG
145
146  /* Get siginfo for process.  */
147  PTRACE_GETSIGINFO = 0x4202,
148#define PT_GETSIGINFO PTRACE_GETSIGINFO
149
150  /* Set new siginfo for process.  */
151  PTRACE_SETSIGINFO = 0x4203,
152#define PT_SETSIGINFO PTRACE_SETSIGINFO
153
154  /* Get register content.  */
155  PTRACE_GETREGSET = 0x4204,
156#define PTRACE_GETREGSET PTRACE_GETREGSET
157
158  /* Set register content.  */
159  PTRACE_SETREGSET = 0x4205,
160#define PTRACE_SETREGSET PTRACE_SETREGSET
161
162  /* Like PTRACE_ATTACH, but do not force tracee to trap and do not affect
163     signal or group stop state.  */
164  PTRACE_SEIZE = 0x4206,
165#define PTRACE_SEIZE PTRACE_SEIZE
166
167  /* Trap seized tracee.  */
168  PTRACE_INTERRUPT = 0x4207,
169#define PTRACE_INTERRUPT PTRACE_INTERRUPT
170
171  /* Wait for next group event.  */
172  PTRACE_LISTEN = 0x4208,
173#define PTRACE_LISTEN PTRACE_LISTEN
174
175  /* Retrieve siginfo_t structures without removing signals from a queue.  */
176  PTRACE_PEEKSIGINFO = 0x4209,
177#define PTRACE_PEEKSIGINFO PTRACE_PEEKSIGINFO
178
179  /* Get the mask of blocked signals.  */
180  PTRACE_GETSIGMASK = 0x420a,
181#define PTRACE_GETSIGMASK PTRACE_GETSIGMASK
182
183  /* Change the mask of blocked signals.  */
184  PTRACE_SETSIGMASK = 0x420b,
185#define PTRACE_SETSIGMASK PTRACE_SETSIGMASK
186
187  /* Get seccomp BPF filters.  */
188  PTRACE_SECCOMP_GET_FILTER = 0x420c,
189#define PTRACE_SECCOMP_GET_FILTER PTRACE_SECCOMP_GET_FILTER
190
191  /* Get seccomp BPF filter metadata.  */
192  PTRACE_SECCOMP_GET_METADATA = 0x420d,
193#define PTRACE_SECCOMP_GET_METADATA PTRACE_SECCOMP_GET_METADATA
194
195  /* Get information about system call.  */
196  PTRACE_GET_SYSCALL_INFO = 0x420e,
197#define PTRACE_GET_SYSCALL_INFO PTRACE_GET_SYSCALL_INFO
198
199  /* Get rseq configuration information.  */
200  PTRACE_GET_RSEQ_CONFIGURATION = 0x420f,
201#define PTRACE_GET_RSEQ_CONFIGURATION PTRACE_GET_RSEQ_CONFIGURATION
202
203  /* Set configuration for syscall user dispatch.  */
204  PTRACE_SET_SYSCALL_USER_DISPATCH_CONFIG = 0x4210,
205#define PTRACE_SET_SYSCALL_USER_DISPATCH_CONFIG \
206  PTRACE_SET_SYSCALL_USER_DISPATCH_CONFIG
207
208  /* Get configuration for syscall user dispatch.  */
209  PTRACE_GET_SYSCALL_USER_DISPATCH_CONFIG = 0x4211
210#define PTRACE_GET_SYSCALL_USER_DISPATCH_CONFIG \
211  PTRACE_GET_SYSCALL_USER_DISPATCH_CONFIG
212};
213
214
215#include <bits/ptrace-shared.h>
216
217__END_DECLS
218
219#endif /* _SYS_PTRACE_H */