sysdeps/unix/sysv/linux/sparc/sys/ptrace.h

   1 /* `ptrace' debugger support interface.  Linux/SPARC version.
   2    Copyright (C) 1996-2014 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, see
  17    <http://www.gnu.org/licenses/>.  */
  18
  19 #ifndef _SYS_PTRACE_H
  20 #define _SYS_PTRACE_H   1
  21
  22 #include <features.h>
  23 #include <bits/types.h>
  24 #include <bits/wordsize.h>
  25
  26 /* Linux/SPARC kernels up to 2.3.18 do not care much
  27    about what namespace polution, so use a kludge now.  */
  28 #undef PTRACE_GETREGS
  29 #undef PTRACE_SETREGS
  30 #undef PTRACE_GETFPREGS
  31 #undef PTRACE_SETFPREGS
  32 #undef PTRACE_READDATA
  33 #undef PTRACE_WRITEDATA
  34 #undef PTRACE_READTEXT
  35 #undef PTRACE_WRITETEXT
  36 #undef PTRACE_SUNDETACH
  37
  38 __BEGIN_DECLS
  39
  40 /* Type of the REQUEST argument to `ptrace.'  */
  41 enum __ptrace_request
  42 {
  43   /* Indicate that the process making this request should be traced.
  44      All signals received by this process can be intercepted by its
  45      parent, and its parent can use the other `ptrace' requests.  */
  46   PTRACE_TRACEME = 0,
  47 #define PT_TRACE_ME PTRACE_TRACEME
  48
  49   /* Return the word in the process's text space at address ADDR.  */
  50   PTRACE_PEEKTEXT = 1,
  51 #define PT_READ_I PTRACE_PEEKTEXT
  52
  53   /* Return the word in the process's data space at address ADDR.  */
  54   PTRACE_PEEKDATA = 2,
  55 #define PT_READ_D PTRACE_PEEKDATA
  56
  57   /* Return the word in the process's user area at offset ADDR.  */
  58   PTRACE_PEEKUSER = 3,
  59 #define PT_READ_U PTRACE_PEEKUSER
  60
  61   /* Write the word DATA into the process's text space at address ADDR.  */
  62   PTRACE_POKETEXT = 4,
  63 #define PT_WRITE_I PTRACE_POKETEXT
  64
  65   /* Write the word DATA into the process's data space at address ADDR.  */
  66   PTRACE_POKEDATA = 5,
  67 #define PT_WRITE_D PTRACE_POKEDATA
  68
  69   /* Write the word DATA into the process's user area at offset ADDR.  */
  70   PTRACE_POKEUSER = 6,
  71 #define PT_WRITE_U PTRACE_POKEUSER
  72
  73   /* Continue the process.  */
  74   PTRACE_CONT = 7,
  75 #define PT_CONTINUE PTRACE_CONT
  76
  77   /* Kill the process.  */
  78   PTRACE_KILL = 8,
  79 #define PT_KILL PTRACE_KILL
  80
  81   /* Single step the process.
  82      This is not supported on all machines.  */
  83   PTRACE_SINGLESTEP = 9,
  84 #define PT_STEP PTRACE_SINGLESTEP
  85
  86   /* Detach from a process attached to with PTRACE_ATTACH.  */
  87   PTRACE_DETACH = 11,
  88 #define PT_DETACH PTRACE_DETACH
  89
  90   /* This define is needed for older programs which were
  91      trying to work around sparc-linux ptrace nastiness.  */
  92 #define PTRACE_SUNDETACH PTRACE_DETACH
  93
  94 #if __WORDSIZE == 32
  95
  96   /* Get all general purpose registers used by a processes.
  97      This is not supported on all machines.  */
  98    PTRACE_GETREGS = 12,
  99 #define PT_GETREGS PTRACE_GETREGS
 100
 101   /* Set all general purpose registers used by a processes.
 102      This is not supported on all machines.  */
 103    PTRACE_SETREGS = 13,
 104 #define PT_SETREGS PTRACE_SETREGS
 105
 106   /* Get all floating point registers used by a processes.
 107      This is not supported on all machines.  */
 108    PTRACE_GETFPREGS = 14,
 109 #define PT_GETFPREGS PTRACE_GETFPREGS
 110
 111   /* Set all floating point registers used by a processes.
 112      This is not supported on all machines.  */
 113    PTRACE_SETFPREGS = 15,
 114 #define PT_SETFPREGS PTRACE_SETFPREGS
 115
 116 #endif
 117
 118   /* Attach to a process that is already running. */
 119   PTRACE_ATTACH = 16,
 120 #define PT_ATTACH PTRACE_ATTACH
 121
 122   /* Write several bytes at a time. */
 123   PTRACE_WRITEDATA = 17,
 124 #define PTRACE_WRITEDATA PTRACE_WRITEDATA
 125
 126   /* Read several bytes at a time. */
 127   PTRACE_READTEXT = 18,
 128 #define PTRACE_READTEXT PTRACE_READTEXT
 129 #define PTRACE_READDATA PTRACE_READTEXT
 130
 131   /* Write several bytes at a time. */
 132   PTRACE_WRITETEXT = 19,
 133 #define PTRACE_WRITETEXT PTRACE_WRITETEXT
 134
 135 #if __WORDSIZE == 64
 136
 137   /* Get all general purpose registers used by a processes.
 138      This is not supported on all machines.  */
 139    PTRACE_GETREGS = 22,
 140 #define PT_GETREGS PTRACE_GETREGS
 141
 142   /* Set all general purpose registers used by a processes.
 143      This is not supported on all machines.  */
 144    PTRACE_SETREGS = 23,
 145 #define PT_SETREGS PTRACE_SETREGS
 146
 147 #endif
 148
 149   /* Continue and stop at the next (return from) syscall.  */
 150   PTRACE_SYSCALL = 24,
 151 #define PTRACE_SYSCALL PTRACE_SYSCALL
 152
 153 #if __WORDSIZE == 64
 154
 155   /* Get all floating point registers used by a processes.
 156      This is not supported on all machines.  */
 157    PTRACE_GETFPREGS = 25,
 158 #define PT_GETFPREGS PTRACE_GETFPREGS
 159
 160   /* Set all floating point registers used by a processes.
 161      This is not supported on all machines.  */
 162    PTRACE_SETFPREGS = 26,
 163 #define PT_SETFPREGS PTRACE_SETFPREGS
 164
 165 #endif
 166
 167   /* Set ptrace filter options.  */
 168   PTRACE_SETOPTIONS = 0x4200,
 169 #define PT_SETOPTIONS PTRACE_SETOPTIONS
 170
 171   /* Get last ptrace message.  */
 172   PTRACE_GETEVENTMSG = 0x4201,
 173 #define PT_GETEVENTMSG PTRACE_GETEVENTMSG
 174
 175   /* Get siginfo for process.  */
 176   PTRACE_GETSIGINFO = 0x4202,
 177 #define PT_GETSIGINFO PTRACE_GETSIGINFO
 178
 179   /* Set new siginfo for process.  */
 180   PTRACE_SETSIGINFO = 0x4203,
 181 #define PT_SETSIGINFO PTRACE_SETSIGINFO
 182
 183   /* Get register content.  */
 184   PTRACE_GETREGSET = 0x4204,
 185 #define PTRACE_GETREGSET PTRACE_GETREGSET
 186
 187   /* Set register content.  */
 188   PTRACE_SETREGSET = 0x4205,
 189 #define PTRACE_SETREGSET PTRACE_SETREGSET
 190
 191   /* Like PTRACE_ATTACH, but do not force tracee to trap and do not affect
 192      signal or group stop state.  */
 193   PTRACE_SEIZE = 0x4206,
 194 #define PTRACE_SEIZE PTRACE_SEIZE
 195
 196   /* Trap seized tracee.  */
 197   PTRACE_INTERRUPT = 0x4207,
 198 #define PTRACE_INTERRUPT PTRACE_INTERRUPT
 199
 200   /* Wait for next group event.  */
 201   PTRACE_LISTEN = 0x4208,
 202 #define PTRACE_LISTEN PTRACE_LISTEN
 203
 204   PTRACE_PEEKSIGINFO = 0x4209
 205 #define PTRACE_PEEKSIGINFO PTRACE_PEEKSIGINFO
 206 };
 207
 208
 209 /* Flag for PTRACE_LISTEN.  */
 210 enum __ptrace_flags
 211 {
 212   PTRACE_SEIZE_DEVEL = 0x80000000
 213 };
 214
 215 /* Options set using PTRACE_SETOPTIONS.  */
 216 enum __ptrace_setoptions
 217 {
 218   PTRACE_O_TRACESYSGOOD = 0x00000001,
 219   PTRACE_O_TRACEFORK    = 0x00000002,
 220   PTRACE_O_TRACEVFORK   = 0x00000004,
 221   PTRACE_O_TRACECLONE   = 0x00000008,
 222   PTRACE_O_TRACEEXEC    = 0x00000010,
 223   PTRACE_O_TRACEVFORKDONE = 0x00000020,
 224   PTRACE_O_TRACEEXIT    = 0x00000040,
 225   PTRACE_O_TRACESECCOMP = 0x00000080,
 226   PTRACE_O_EXITKILL     = 0x00100000,
 227   PTRACE_O_MASK         = 0x001000ff
 228 };
 229
 230 /* Wait extended result codes for the above trace options.  */
 231 enum __ptrace_eventcodes
 232 {
 233   PTRACE_EVENT_FORK     = 1,
 234   PTRACE_EVENT_VFORK    = 2,
 235   PTRACE_EVENT_CLONE    = 3,
 236   PTRACE_EVENT_EXEC     = 4,
 237   PTRACE_EVENT_VFORK_DONE = 5,
 238   PTRACE_EVENT_EXIT     = 6,
 239   PTRACE_EVENT_SECCOMP  = 7
 240 };
 241
 242 /* Arguments for PTRACE_PEEKSIGINFO.  */
 243 struct ptrace_peeksiginfo_args
 244 {
 245   __uint64_t off;       /* From which siginfo to start.  */
 246   __uint32_t flags;     /* Flags for peeksiginfo.  */
 247   __int32_t nr;         /* How many siginfos to take.  */
 248 };
 249
 250 enum __ptrace_peeksiginfo_flags
 251 {
 252   /* Read signals from a shared (process wide) queue.  */
 253   PTRACE_PEEKSIGINFO_SHARED = (1 << 0)
 254 };
 255
 256 /* Perform process tracing functions.  REQUEST is one of the values
 257    above, and determines the action to be taken.
 258    For all requests except PTRACE_TRACEME, PID specifies the process to be
 259    traced.
 260
 261    PID and the other arguments described above for the various requests should
 262    appear (those that are used for the particular request) as:
 263      pid_t PID, void *ADDR, int DATA, void *ADDR2
 264    after REQUEST.  */
 265 extern long int ptrace (enum __ptrace_request __request, ...) __THROW;
 266
 267 __END_DECLS
 268
 269 #endif /* _SYS_PTRACE_H */