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

   1 /* `ptrace' debugger support interface.  Linux/ia64 version.
   2    Copyright (C) 2001, 2006, 2007, 2011 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 <sys/ucontext.h>
  24
  25 __BEGIN_DECLS
  26
  27 /* Type of the REQUEST argument to `ptrace.'  */
  28 enum __ptrace_request
  29 {
  30   /* Indicate that the process making this request should be traced.
  31      All signals received by this process can be intercepted by its
  32      parent, and its parent can use the other `ptrace' requests.  */
  33   PTRACE_TRACEME = 0,
  34 #define PT_TRACE_ME PTRACE_TRACEME
  35
  36   /* Return the word in the process's text space at address ADDR.  */
  37   PTRACE_PEEKTEXT = 1,
  38 #define PT_READ_I PTRACE_PEEKTEXT
  39
  40   /* Return the word in the process's data space at address ADDR.  */
  41   PTRACE_PEEKDATA = 2,
  42 #define PT_READ_D PTRACE_PEEKDATA
  43
  44   /* Return the word in the process's user area at offset ADDR.  */
  45   PTRACE_PEEKUSER = 3,
  46 #define PT_READ_U PTRACE_PEEKUSER
  47
  48   /* Write the word DATA into the process's text space at address ADDR.  */
  49   PTRACE_POKETEXT = 4,
  50 #define PT_WRITE_I PTRACE_POKETEXT
  51
  52   /* Write the word DATA into the process's data space at address ADDR.  */
  53   PTRACE_POKEDATA = 5,
  54 #define PT_WRITE_D PTRACE_POKEDATA
  55
  56   /* Write the word DATA into the process's user area at offset ADDR.  */
  57   PTRACE_POKEUSER = 6,
  58 #define PT_WRITE_U PTRACE_POKEUSER
  59
  60   /* Continue the process.  */
  61   PTRACE_CONT = 7,
  62 #define PT_CONTINUE PTRACE_CONT
  63
  64   /* Kill the process.  */
  65   PTRACE_KILL = 8,
  66 #define PT_KILL PTRACE_KILL
  67
  68   /* Single step the process.
  69      This is not supported on all machines.  */
  70   PTRACE_SINGLESTEP = 9,
  71 #define PT_STEP PTRACE_SINGLESTEP
  72
  73   /* Execute process until next taken branch.  */
  74   PTRACE_SINGLEBLOCK = 12,
  75 #define PT_STEPBLOCK PTRACE_SINGLEBLOCK
  76
  77   /* Attach to a process that is already running. */
  78   PTRACE_ATTACH = 16,
  79 #define PT_ATTACH PTRACE_ATTACH
  80
  81   /* Detach from a process attached to with PTRACE_ATTACH.  */
  82   PTRACE_DETACH = 17,
  83 #define PT_DETACH PTRACE_DETACH
  84
  85   /* Get all registers (pt_all_user_regs) in one shot */
  86   PTRACE_GETREGS = 18,
  87 #define PT_GETREGS PTRACE_GETREGS
  88
  89   /* Set all registers (pt_all_user_regs) in one shot */
  90   PTRACE_SETREGS = 19,
  91 #define PT_SETREGS PTRACE_SETREGS
  92
  93   /* Continue and stop at the next (return from) syscall.  */
  94   PTRACE_SYSCALL = 24,
  95 #define PT_SYSCALL PTRACE_SYSCALL
  96
  97   /* Set ptrace filter options.  */
  98   PTRACE_SETOPTIONS = 0x4200,
  99 #define PT_SETOPTIONS PTRACE_SETOPTIONS
 100
 101   /* Get last ptrace message.  */
 102   PTRACE_GETEVENTMSG = 0x4201,
 103 #define PT_GETEVENTMSG PTRACE_GETEVENTMSG
 104
 105   /* Get siginfo for process.  */
 106   PTRACE_GETSIGINFO = 0x4202,
 107 #define PT_GETSIGINFO PTRACE_GETSIGINFO
 108
 109   /* Set new siginfo for process.  */
 110   PTRACE_SETSIGINFO = 0x4203,
 111 #define PT_SETSIGINFO PTRACE_SETSIGINFO
 112
 113   /* Get register content.  */
 114   PTRACE_GETREGSET = 0x4204,
 115 #define PTRACE_GETREGSET PTRACE_GETREGSET
 116
 117   /* Set register content.  */
 118   PTRACE_SETREGSET = 0x4205,
 119 #define PTRACE_SETREGSET PTRACE_SETREGSET
 120
 121   /* Like PTRACE_ATTACH, but do not force tracee to trap and do not affect
 122      signal or group stop state.  */
 123   PTRACE_SEIZE = 0x4206,
 124 #define PTRACE_SEIZE PTRACE_SEIZE
 125
 126   /* Trap seized tracee.  */
 127   PTRACE_INTERRUPT = 0x4207,
 128 #define PTRACE_INTERRUPT PTRACE_INTERRUPT
 129
 130   /* Wait for next group event.  */
 131   PTRACE_LISTEN = 0x4208
 132 };
 133
 134
 135 /* Flag for PTRACE_LISTEN.  */
 136 enum __ptrace_flags
 137 {
 138   PTRACE_SEIZE_DEVEL = 0x80000000
 139 };
 140
 141 /* pt_all_user_regs is used for PTRACE_GETREGS/PTRACE_SETREGS.  */
 142 struct pt_all_user_regs
 143   {
 144     unsigned long nat;
 145     unsigned long cr_iip;
 146     unsigned long cfm;
 147     unsigned long cr_ipsr;
 148     unsigned long pr;
 149
 150     unsigned long gr[32];
 151     unsigned long br[8];
 152     unsigned long ar[128];
 153     struct ia64_fpreg fr[128];
 154   };
 155
 156 /* Options set using PTRACE_SETOPTIONS.  */
 157 enum __ptrace_setoptions {
 158   PTRACE_O_TRACESYSGOOD = 0x00000001,
 159   PTRACE_O_TRACEFORK    = 0x00000002,
 160   PTRACE_O_TRACEVFORK   = 0x00000004,
 161   PTRACE_O_TRACECLONE   = 0x00000008,
 162   PTRACE_O_TRACEEXEC    = 0x00000010,
 163   PTRACE_O_TRACEVFORKDONE = 0x00000020,
 164   PTRACE_O_TRACEEXIT    = 0x00000040,
 165   PTRACE_O_MASK         = 0x0000007f
 166 };
 167
 168 /* Wait extended result codes for the above trace options.  */
 169 enum __ptrace_eventcodes {
 170   PTRACE_EVENT_FORK     = 1,
 171   PTRACE_EVENT_VFORK    = 2,
 172   PTRACE_EVENT_CLONE    = 3,
 173   PTRACE_EVENT_EXEC     = 4,
 174   PTRACE_EVENT_VFORK_DONE = 5,
 175   PTRACE_EVENT_EXIT     = 6
 176 };
 177
 178 /* Perform process tracing functions.  REQUEST is one of the values
 179    above, and determines the action to be taken.
 180    For all requests except PTRACE_TRACEME, PID specifies the process to be
 181    traced.
 182
 183    PID and the other arguments described above for the various requests should
 184    appear (those that are used for the particular request) as:
 185      pid_t PID, void *ADDR, int DATA, void *ADDR2
 186    after REQUEST.  */
 187 extern long int ptrace (enum __ptrace_request __request, ...) __THROW;
 188
 189 __END_DECLS
 190
 191 #endif /* _SYS_PTRACE_H */