ports/sysdeps/unix/sysv/linux/tile/sys/ptrace.h

   1 /* Copyright (C) 2011 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3    Contributed by Chris Metcalf <cmetcalf@tilera.com>, 2011.
   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
  24 __BEGIN_DECLS
  25
  26 /* Type of the REQUEST argument to `ptrace.'  */
  27 enum __ptrace_request
  28 {
  29   /* Indicate that the process making this request should be traced.
  30      All signals received by this process can be intercepted by its
  31      parent, and its parent can use the other `ptrace' requests.  */
  32   PTRACE_TRACEME = 0,
  33 #define PT_TRACE_ME PTRACE_TRACEME
  34
  35   /* Return the word in the process's text space at address ADDR.  */
  36   PTRACE_PEEKTEXT = 1,
  37 #define PT_READ_I PTRACE_PEEKTEXT
  38
  39   /* Return the word in the process's data space at address ADDR.  */
  40   PTRACE_PEEKDATA = 2,
  41 #define PT_READ_D PTRACE_PEEKDATA
  42
  43   /* Return the word in the process's user area at offset ADDR.  */
  44   PTRACE_PEEKUSER = 3,
  45 #define PT_READ_U PTRACE_PEEKUSER
  46
  47   /* Write the word DATA into the process's text space at address ADDR.  */
  48   PTRACE_POKETEXT = 4,
  49 #define PT_WRITE_I PTRACE_POKETEXT
  50
  51   /* Write the word DATA into the process's data space at address ADDR.  */
  52   PTRACE_POKEDATA = 5,
  53 #define PT_WRITE_D PTRACE_POKEDATA
  54
  55   /* Write the word DATA into the process's user area at offset ADDR.  */
  56   PTRACE_POKEUSER = 6,
  57 #define PT_WRITE_U PTRACE_POKEUSER
  58
  59   /* Continue the process.  */
  60   PTRACE_CONT = 7,
  61 #define PT_CONTINUE PTRACE_CONT
  62
  63   /* Kill the process.  */
  64   PTRACE_KILL = 8,
  65 #define PT_KILL PTRACE_KILL
  66
  67   /* Single step the process. */
  68   PTRACE_SINGLESTEP = 9,
  69 #define PT_STEP PTRACE_SINGLESTEP
  70
  71   /* Get all general purpose registers used by a processes. */
  72    PTRACE_GETREGS = 12,
  73 #define PT_GETREGS PTRACE_GETREGS
  74
  75   /* Set all general purpose registers used by a processes. */
  76    PTRACE_SETREGS = 13,
  77 #define PT_SETREGS PTRACE_SETREGS
  78
  79   /* Attach to a process that is already running. */
  80   PTRACE_ATTACH = 16,
  81 #define PT_ATTACH PTRACE_ATTACH
  82
  83   /* Detach from a process attached to with PTRACE_ATTACH.  */
  84   PTRACE_DETACH = 17,
  85 #define PT_DETACH PTRACE_DETACH
  86
  87   /* Continue and stop at the next (return from) syscall.  */
  88   PTRACE_SYSCALL = 24,
  89 #define PT_SYSCALL PTRACE_SYSCALL
  90
  91   /* Set ptrace filter options.  */
  92   PTRACE_SETOPTIONS = 0x4200,
  93 #define PT_SETOPTIONS PTRACE_SETOPTIONS
  94
  95   /* Get last ptrace message.  */
  96   PTRACE_GETEVENTMSG = 0x4201,
  97 #define PT_GETEVENTMSG PTRACE_GETEVENTMSG
  98
  99   /* Get siginfo for process.  */
 100   PTRACE_GETSIGINFO = 0x4202,
 101 #define PT_GETSIGINFO PTRACE_GETSIGINFO
 102
 103   /* Set new siginfo for process.  */
 104   PTRACE_SETSIGINFO = 0x4203
 105 #define PT_SETSIGINFO PTRACE_SETSIGINFO
 106 };
 107
 108
 109 /* Options set using PTRACE_SETOPTIONS.  */
 110 enum __ptrace_setoptions {
 111   PTRACE_O_TRACESYSGOOD = 0x00000001,
 112   PTRACE_O_TRACEFORK    = 0x00000002,
 113   PTRACE_O_TRACEVFORK   = 0x00000004,
 114   PTRACE_O_TRACECLONE   = 0x00000008,
 115   PTRACE_O_TRACEEXEC    = 0x00000010,
 116   PTRACE_O_TRACEVFORKDONE = 0x00000020,
 117   PTRACE_O_TRACEEXIT    = 0x00000040,
 118   PTRACE_O_MASK         = 0x0000007f
 119 };
 120
 121 /* Wait extended result codes for the above trace options.  */
 122 enum __ptrace_eventcodes {
 123   PTRACE_EVENT_FORK     = 1,
 124   PTRACE_EVENT_VFORK    = 2,
 125   PTRACE_EVENT_CLONE    = 3,
 126   PTRACE_EVENT_EXEC     = 4,
 127   PTRACE_EVENT_VFORK_DONE = 5,
 128   PTRACE_EVENT_EXIT     = 6
 129 };
 130
 131 /* Perform process tracing functions.  REQUEST is one of the values
 132    above, and determines the action to be taken.
 133    For all requests except PTRACE_TRACEME, PID specifies the process to be
 134    traced.
 135
 136    PID and the other arguments described above for the various requests should
 137    appear (those that are used for the particular request) as:
 138      pid_t PID, void *ADDR, int DATA, void *ADDR2
 139    after REQUEST.  */
 140 extern long int ptrace (enum __ptrace_request __request, ...) __THROW;
 141
 142 __END_DECLS
 143
 144 #endif /* _SYS_PTRACE_H */