GDBserver

gdb_ptrace.h
Go to the documentation of this file.
1 /* Portable <sys/ptrace.h>
2
3 Copyright (C) 2004-2018 Free Software Foundation, Inc.
4
5 This file is part of GDB.
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
19
20 #ifndef GDB_PTRACE_H
21 #define GDB_PTRACE_H
22
23 /* The <sys/ptrace.h> header was introduced with 4.4BSD, and provided
24 the PT_* symbolic constants for the ptrace(2) request numbers. The
25 ptrace(2) prototype was added later to the same header on BSD.
26 SunOS and GNU/Linux have slightly different symbolic names for the
27 constants that start with PTRACE_*. System V still doesn't have
28 (and probably never will have) a <sys/ptrace.h> with symbolic
29 constants; the ptrace(2) prototype can be found in <unistd.h>.
30 Fortunately all systems use the same numerical constants for the
31 common ptrace requests. */
32
33 #ifdef HAVE_PTRACE_H
34 # include <ptrace.h>
35 #elif defined(HAVE_SYS_PTRACE_H)
36 # include <sys/ptrace.h>
37 #endif
38
39 /* No need to include <unistd.h> since it's already included by
40 "defs.h". */
41
42 #ifndef PT_TRACE_ME
43 # define PT_TRACE_ME 0
44 #endif
45
46 #ifndef PT_READ_I
47 # define PT_READ_I 1 /* Read word in child's I space. */
48 #endif
49
50 #ifndef PT_READ_D
51 # define PT_READ_D 2 /* Read word in child's D space. */
52 #endif
53
54 #ifndef PT_READ_U
55 # define PT_READ_U 3 /* Read word in child's U space. */
56 #endif
57
58 #ifndef PT_WRITE_I
59 # define PT_WRITE_I 4 /* Write word in child's I space. */
60 #endif
61
62 #ifndef PT_WRITE_D
63 # define PT_WRITE_D 5 /* Write word in child's D space. */
64 #endif
65
66 #ifndef PT_WRITE_U
67 # define PT_WRITE_U 6 /* Write word in child's U space. */
68 #endif
69
70 /* HP-UX doesn't define PT_CONTINUE and PT_STEP. Instead of those two
71 ptrace requests, it has PT_CONTIN, PT_CONTIN1, PT_SINGLE and
72 PT_SINGLE1. PT_CONTIN1 and PT_SINGLE1 preserve pending signals,
73 which apparently is what is wanted by the HP-UX native code. */
74
75 #ifndef PT_CONTINUE
76 # ifdef PT_CONTIN1
77 # define PT_CONTINUE PT_CONTIN1
78 # else
79 # define PT_CONTINUE 7 /* Continue the child. */
80 # endif
81 #endif
82
83 #ifndef PT_KILL
84 # define PT_KILL 8 /* Kill the child process. */
85 #endif
86
87 #ifndef PT_STEP
88 # ifdef PT_SINGLE1
89 # define PT_STEP PT_SINGLE1
90 # else
91 # define PT_STEP 9 /* Single step the child. */
92 # endif
93 #endif
94
95 /* Not all systems support attaching and detaching. */
96
97 #ifndef PT_ATTACH
98 # ifdef PTRACE_ATTACH
99 # define PT_ATTACH PTRACE_ATTACH
100 # endif
101 #endif
102
103 #ifndef PT_DETACH
104 # ifdef PTRACE_DETACH
105 # define PT_DETACH PTRACE_DETACH
106 # endif
107 #endif
108
109 /* For systems such as HP/UX that do not provide PT_SYSCALL, define it
110 here as an alias for PT_CONTINUE. This is what the PT_SYSCALL
111 request is expected to do, in addition to stopping when entering/
112 exiting a system call. Chances are, if the system supports system
113 call tracing, enabling this feature is probably done separately;
114 and there is probably no special request that we would be required
115 to use when resuming the execution of our program. */
116 #ifndef PT_SYSCALL
117 # ifdef PTRACE_SYSCALL
118 # define PT_SYSCALL PTRACE_SYSCALL
119 #else
120 # define PT_SYSCALL PT_CONTINUE
121 # endif
122 #endif
123
124 /* Some systems, in particular DEC OSF/1, Digital Unix, Compaq Tru64
125 or whatever it's called these days, don't provide a prototype for
126 ptrace. Provide one to silence compiler warnings. */
127
128 #ifndef HAVE_DECL_PTRACE
129 extern PTRACE_TYPE_RET ptrace();
130 #endif
131
132 /* Some systems, at least AIX and HP-UX have a ptrace with five
133 arguments. Since we never use the fifth argument, define a ptrace
134 macro that calls the real ptrace with the last argument set to
135 zero. */
136
137 #ifdef PTRACE_TYPE_ARG5
138 # ifdef HAVE_PTRACE64
139 # define ptrace(request, pid, addr, data) \
140 ptrace64 (request, pid, addr, data, 0)
141 # undef PTRACE_TYPE_ARG3
142 # define PTRACE_TYPE_ARG3 long long
143 # else
144 # define ptrace(request, pid, addr, data) \
145 ptrace (request, pid, addr, data, 0)
146 # endif
147 #else
148 /* Wrapper that avoids adding a pointless cast to all callers. */
149 # define ptrace(request, pid, addr, data) \
150 ptrace ((PTRACE_TYPE_ARG1) request, pid, addr, data)
151 #endif
152
153 #endif /* gdb_ptrace.h */
ptrace
#define ptrace(request, pid, addr, data)
Definition: gdb_ptrace.h:149
PTRACE_TYPE_RET
#define PTRACE_TYPE_RET
Definition: config.h:348