1 /* `ptrace' debugger support interface. Linux version. 2 Copyright (C) 1996-1999,2000,2006,2007 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, write to the Free 17 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 18 02111-1307 USA. */ 19 20 #ifndef _SYS_PTRACE_H 21 #define _SYS_PTRACE_H 1 22 23 #include <features.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 /* Get all general purpose registers used by a processes. 74 This is not supported on all machines. */ 75 PTRACE_GETREGS = 12, 76 #define PT_GETREGS PTRACE_GETREGS 77 78 /* Set all general purpose registers used by a processes. 79 This is not supported on all machines. */ 80 PTRACE_SETREGS = 13, 81 #define PT_SETREGS PTRACE_SETREGS 82 83 /* Get all floating point registers used by a processes. 84 This is not supported on all machines. */ 85 PTRACE_GETFPREGS = 14, 86 #define PT_GETFPREGS PTRACE_GETFPREGS 87 88 /* Set all floating point registers used by a processes. 89 This is not supported on all machines. */ 90 PTRACE_SETFPREGS = 15, 91 #define PT_SETFPREGS PTRACE_SETFPREGS 92 93 /* Attach to a process that is already running. */ 94 PTRACE_ATTACH = 16, 95 #define PT_ATTACH PTRACE_ATTACH 96 97 /* Detach from a process attached to with PTRACE_ATTACH. */ 98 PTRACE_DETACH = 17, 99 #define PT_DETACH PTRACE_DETACH 100 101 /* Get all extended floating point registers used by a processes. 102 This is not supported on all machines. */ 103 PTRACE_GETFPXREGS = 18, 104 #define PT_GETFPXREGS PTRACE_GETFPXREGS 105 106 /* Set all extended floating point registers used by a processes. 107 This is not supported on all machines. */ 108 PTRACE_SETFPXREGS = 19, 109 #define PT_SETFPXREGS PTRACE_SETFPXREGS 110 111 /* Continue and stop at the next (return from) syscall. */ 112 PTRACE_SYSCALL = 24, 113 #define PT_SYSCALL PTRACE_SYSCALL 114 115 /* Set ptrace filter options. */ 116 PTRACE_SETOPTIONS = 0x4200, 117 #define PT_SETOPTIONS PTRACE_SETOPTIONS 118 119 /* Get last ptrace message. */ 120 PTRACE_GETEVENTMSG = 0x4201, 121 #define PT_GETEVENTMSG PTRACE_GETEVENTMSG 122 123 /* Get siginfo for process. */ 124 PTRACE_GETSIGINFO = 0x4202, 125 #define PT_GETSIGINFO PTRACE_GETSIGINFO 126 127 /* Set new siginfo for process. */ 128 PTRACE_SETSIGINFO = 0x4203 129 #define PT_SETSIGINFO PTRACE_SETSIGINFO 130 }; 131 132 133 /* Options set using PTRACE_SETOPTIONS. */ 134 enum __ptrace_setoptions { 135 PTRACE_O_TRACESYSGOOD = 0x00000001, 136 PTRACE_O_TRACEFORK = 0x00000002, 137 PTRACE_O_TRACEVFORK = 0x00000004, 138 PTRACE_O_TRACECLONE = 0x00000008, 139 PTRACE_O_TRACEEXEC = 0x00000010, 140 PTRACE_O_TRACEVFORKDONE = 0x00000020, 141 PTRACE_O_TRACEEXIT = 0x00000040, 142 PTRACE_O_MASK = 0x0000007f 143 }; 144 145 /* Wait extended result codes for the above trace options. */ 146 enum __ptrace_eventcodes { 147 PTRACE_EVENT_FORK = 1, 148 PTRACE_EVENT_VFORK = 2, 149 PTRACE_EVENT_CLONE = 3, 150 PTRACE_EVENT_EXEC = 4, 151 PTRACE_EVENT_VFORK_DONE = 5, 152 PTRACE_EVENT_EXIT = 6 153 }; 154 155 /* Perform process tracing functions. REQUEST is one of the values 156 above, and determines the action to be taken. 157 For all requests except PTRACE_TRACEME, PID specifies the process to be 158 traced. 159 160 PID and the other arguments described above for the various requests should 161 appear (those that are used for the particular request) as: 162 pid_t PID, void *ADDR, int DATA, void *ADDR2 163 after REQUEST. */ 164 extern long int ptrace (enum __ptrace_request __request, ...) __THROW; 165 166 __END_DECLS 167 168 #endif /* _SYS_PTRACE_H */ 169