]>
Commit | Line | Data |
---|---|---|
58caa3dc | 1 | /* Internal interfaces for the GNU/Linux specific target code for gdbserver. |
32d0add0 | 2 | Copyright (C) 2002-2015 Free Software Foundation, Inc. |
58caa3dc DJ |
3 | |
4 | This file is part of GDB. | |
5 | ||
6 | This program is free software; you can redistribute it and/or modify | |
7 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 8 | the Free Software Foundation; either version 3 of the License, or |
58caa3dc DJ |
9 | (at your option) any later version. |
10 | ||
11 | This program is distributed in the hope that it will be useful, | |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | GNU General Public License for more details. | |
15 | ||
16 | You should have received a copy of the GNU General Public License | |
a9762ec7 | 17 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
58caa3dc | 18 | |
6d4ee8c6 | 19 | #include "nat/linux-nat.h" |
125f8a3d | 20 | #include "nat/gdb_thread_db.h" |
a5362b9a | 21 | #include <signal.h> |
dae5f5cf | 22 | |
623b6bdf | 23 | #include "gdbthread.h" |
95954743 PA |
24 | #include "gdb_proc_service.h" |
25 | ||
96d7229d | 26 | /* Included for ptrace type definitions. */ |
125f8a3d | 27 | #include "nat/linux-ptrace.h" |
15c66dd6 | 28 | #include "target/waitstatus.h" /* For enum target_stop_reason. */ |
96d7229d | 29 | |
f15f9948 TJB |
30 | #define PTRACE_XFER_TYPE long |
31 | ||
58caa3dc | 32 | #ifdef HAVE_LINUX_REGSETS |
442ea881 PA |
33 | typedef void (*regset_fill_func) (struct regcache *, void *); |
34 | typedef void (*regset_store_func) (struct regcache *, const void *); | |
0d62e5e8 DJ |
35 | enum regset_type { |
36 | GENERAL_REGS, | |
37 | FP_REGS, | |
38 | EXTENDED_REGS, | |
39 | }; | |
40 | ||
58caa3dc DJ |
41 | struct regset_info |
42 | { | |
43 | int get_request, set_request; | |
1570b33e L |
44 | /* If NT_TYPE isn't 0, it will be passed to ptrace as the 3rd |
45 | argument and the 4th argument should be "const struct iovec *". */ | |
46 | int nt_type; | |
58caa3dc | 47 | int size; |
0d62e5e8 DJ |
48 | enum regset_type type; |
49 | regset_fill_func fill_function; | |
50 | regset_store_func store_function; | |
58caa3dc | 51 | }; |
3aee8918 PA |
52 | |
53 | /* Aggregation of all the supported regsets of a given | |
54 | architecture/mode. */ | |
55 | ||
56 | struct regsets_info | |
57 | { | |
58 | /* The regsets array. */ | |
59 | struct regset_info *regsets; | |
60 | ||
61 | /* The number of regsets in the REGSETS array. */ | |
62 | int num_regsets; | |
63 | ||
64 | /* If we get EIO on a regset, do not try it again. Note the set of | |
65 | supported regsets may depend on processor mode on biarch | |
030031ee PA |
66 | machines. This is a (lazily allocated) array holding one boolean |
67 | byte (0/1) per regset, with each element corresponding to the | |
68 | regset in the REGSETS array above at the same offset. */ | |
3aee8918 PA |
69 | char *disabled_regsets; |
70 | }; | |
71 | ||
72 | #endif | |
73 | ||
74 | /* Mapping between the general-purpose registers in `struct user' | |
75 | format and GDB's register array layout. */ | |
76 | ||
77 | struct usrregs_info | |
78 | { | |
79 | /* The number of registers accessible. */ | |
80 | int num_regs; | |
81 | ||
82 | /* The registers map. */ | |
83 | int *regmap; | |
84 | }; | |
85 | ||
86 | /* All info needed to access an architecture/mode's registers. */ | |
87 | ||
88 | struct regs_info | |
89 | { | |
90 | /* Regset support bitmap: 1 for registers that are transferred as a part | |
91 | of a regset, 0 for ones that need to be handled individually. This | |
92 | can be NULL if all registers are transferred with regsets or regsets | |
93 | are not supported. */ | |
94 | unsigned char *regset_bitmap; | |
95 | ||
96 | /* Info used when accessing registers with PTRACE_PEEKUSER / | |
97 | PTRACE_POKEUSER. This can be NULL if all registers are | |
98 | transferred with regsets .*/ | |
99 | struct usrregs_info *usrregs; | |
100 | ||
101 | #ifdef HAVE_LINUX_REGSETS | |
102 | /* Info used when accessing registers with regsets. */ | |
103 | struct regsets_info *regsets_info; | |
58caa3dc | 104 | #endif |
3aee8918 | 105 | }; |
2ec06d2e | 106 | |
95954743 PA |
107 | struct process_info_private |
108 | { | |
aa5ca48f DE |
109 | /* Arch-specific additions. */ |
110 | struct arch_process_info *arch_private; | |
cdbfd419 PP |
111 | |
112 | /* libthread_db-specific additions. Not NULL if this process has loaded | |
113 | thread_db, and it is active. */ | |
114 | struct thread_db *thread_db; | |
2268b414 JK |
115 | |
116 | /* &_r_debug. 0 if not yet determined. -1 if no PT_DYNAMIC in Phdrs. */ | |
117 | CORE_ADDR r_debug; | |
3aee8918 PA |
118 | |
119 | /* This flag is true iff we've just created or attached to the first | |
120 | LWP of this process but it has not stopped yet. As soon as it | |
121 | does, we need to call the low target's arch_setup callback. */ | |
122 | int new_inferior; | |
95954743 PA |
123 | }; |
124 | ||
aa5ca48f DE |
125 | struct lwp_info; |
126 | ||
2ec06d2e DJ |
127 | struct linux_target_ops |
128 | { | |
d05b4ac3 UW |
129 | /* Architecture-specific setup. */ |
130 | void (*arch_setup) (void); | |
131 | ||
3aee8918 | 132 | const struct regs_info *(*regs_info) (void); |
2ec06d2e | 133 | int (*cannot_fetch_register) (int); |
bc1e36ca DJ |
134 | |
135 | /* Returns 0 if we can store the register, 1 if we can not | |
136 | store the register, and 2 if failure to store the register | |
137 | is acceptable. */ | |
2ec06d2e | 138 | int (*cannot_store_register) (int); |
c14dfd32 PA |
139 | |
140 | /* Hook to fetch a register in some non-standard way. Used for | |
141 | example by backends that have read-only registers with hardcoded | |
142 | values (e.g., IA64's gr0/fr0/fr1). Returns true if register | |
143 | REGNO was supplied, false if not, and we should fallback to the | |
144 | standard ptrace methods. */ | |
145 | int (*fetch_register) (struct regcache *regcache, int regno); | |
146 | ||
442ea881 PA |
147 | CORE_ADDR (*get_pc) (struct regcache *regcache); |
148 | void (*set_pc) (struct regcache *regcache, CORE_ADDR newpc); | |
f450004a | 149 | const unsigned char *breakpoint; |
611cb4a5 DJ |
150 | int breakpoint_len; |
151 | CORE_ADDR (*breakpoint_reinsert_addr) (void); | |
0d62e5e8 | 152 | |
0d62e5e8 DJ |
153 | int decr_pc_after_break; |
154 | int (*breakpoint_at) (CORE_ADDR pc); | |
e013ee27 | 155 | |
d993e290 PA |
156 | /* Breakpoint and watchpoint related functions. See target.h for |
157 | comments. */ | |
802e8e6d PA |
158 | int (*supports_z_point_type) (char z_type); |
159 | int (*insert_point) (enum raw_bkpt_type type, CORE_ADDR addr, | |
160 | int size, struct raw_breakpoint *bp); | |
161 | int (*remove_point) (enum raw_bkpt_type type, CORE_ADDR addr, | |
162 | int size, struct raw_breakpoint *bp); | |
163 | ||
e013ee27 OF |
164 | int (*stopped_by_watchpoint) (void); |
165 | CORE_ADDR (*stopped_data_address) (void); | |
166 | ||
ee1a7ae4 UW |
167 | /* Hooks to reformat register data for PEEKUSR/POKEUSR (in particular |
168 | for registers smaller than an xfer unit). */ | |
442ea881 PA |
169 | void (*collect_ptrace_register) (struct regcache *regcache, |
170 | int regno, char *buf); | |
171 | void (*supply_ptrace_register) (struct regcache *regcache, | |
172 | int regno, const char *buf); | |
d0722149 DE |
173 | |
174 | /* Hook to convert from target format to ptrace format and back. | |
175 | Returns true if any conversion was done; false otherwise. | |
176 | If DIRECTION is 1, then copy from INF to NATIVE. | |
177 | If DIRECTION is 0, copy from NATIVE to INF. */ | |
a5362b9a | 178 | int (*siginfo_fixup) (siginfo_t *native, void *inf, int direction); |
aa5ca48f DE |
179 | |
180 | /* Hook to call when a new process is created or attached to. | |
181 | If extra per-process architecture-specific data is needed, | |
182 | allocate it here. */ | |
183 | struct arch_process_info * (*new_process) (void); | |
184 | ||
185 | /* Hook to call when a new thread is detected. | |
186 | If extra per-thread architecture-specific data is needed, | |
187 | allocate it here. */ | |
188 | struct arch_lwp_info * (*new_thread) (void); | |
189 | ||
190 | /* Hook to call prior to resuming a thread. */ | |
191 | void (*prepare_to_resume) (struct lwp_info *); | |
1570b33e L |
192 | |
193 | /* Hook to support target specific qSupported. */ | |
194 | void (*process_qsupported) (const char *); | |
219f2f23 PA |
195 | |
196 | /* Returns true if the low target supports tracepoints. */ | |
197 | int (*supports_tracepoints) (void); | |
fa593d66 PA |
198 | |
199 | /* Fill ADDRP with the thread area address of LWPID. Returns 0 on | |
200 | success, -1 on failure. */ | |
201 | int (*get_thread_area) (int lwpid, CORE_ADDR *addrp); | |
202 | ||
203 | /* Install a fast tracepoint jump pad. See target.h for | |
204 | comments. */ | |
205 | int (*install_fast_tracepoint_jump_pad) (CORE_ADDR tpoint, CORE_ADDR tpaddr, | |
206 | CORE_ADDR collector, | |
207 | CORE_ADDR lockaddr, | |
208 | ULONGEST orig_size, | |
209 | CORE_ADDR *jump_entry, | |
405f8e94 SS |
210 | CORE_ADDR *trampoline, |
211 | ULONGEST *trampoline_size, | |
fa593d66 PA |
212 | unsigned char *jjump_pad_insn, |
213 | ULONGEST *jjump_pad_insn_size, | |
214 | CORE_ADDR *adjusted_insn_addr, | |
405f8e94 SS |
215 | CORE_ADDR *adjusted_insn_addr_end, |
216 | char *err); | |
6a271cae PA |
217 | |
218 | /* Return the bytecode operations vector for the current inferior. | |
219 | Returns NULL if bytecode compilation is not supported. */ | |
220 | struct emit_ops *(*emit_ops) (void); | |
405f8e94 SS |
221 | |
222 | /* Return the minimum length of an instruction that can be safely overwritten | |
223 | for use as a fast tracepoint. */ | |
224 | int (*get_min_fast_tracepoint_insn_len) (void); | |
225 | ||
c2d6af84 PA |
226 | /* Returns true if the low target supports range stepping. */ |
227 | int (*supports_range_stepping) (void); | |
2ec06d2e DJ |
228 | }; |
229 | ||
230 | extern struct linux_target_ops the_low_target; | |
0d62e5e8 | 231 | |
d86d4aaf | 232 | #define get_thread_lwp(thr) ((struct lwp_info *) (inferior_target_data (thr))) |
f7667f0d | 233 | #define get_lwp_thread(lwp) ((lwp)->thread) |
0d62e5e8 | 234 | |
d86d4aaf DE |
235 | /* This struct is recorded in the target_data field of struct thread_info. |
236 | ||
237 | On linux ``all_threads'' is keyed by the LWP ID, which we use as the | |
238 | GDB protocol representation of the thread ID. Threads also have | |
239 | a "process ID" (poorly named) which is (presently) the same as the | |
240 | LWP ID. | |
241 | ||
242 | There is also ``all_processes'' is keyed by the "overall process ID", | |
243 | which GNU/Linux calls tgid, "thread group ID". */ | |
244 | ||
54a0b537 | 245 | struct lwp_info |
0d62e5e8 | 246 | { |
d86d4aaf | 247 | /* Backlink to the parent object. */ |
f7667f0d DE |
248 | struct thread_info *thread; |
249 | ||
ae13219e DJ |
250 | /* If this flag is set, the next SIGSTOP will be ignored (the |
251 | process will be immediately resumed). This means that either we | |
252 | sent the SIGSTOP to it ourselves and got some other pending event | |
253 | (so the SIGSTOP is still pending), or that we stopped the | |
254 | inferior implicitly via PTRACE_ATTACH and have not waited for it | |
255 | yet. */ | |
0d62e5e8 DJ |
256 | int stop_expected; |
257 | ||
d50171e4 PA |
258 | /* When this is true, we shall not try to resume this thread, even |
259 | if last_resume_kind isn't resume_stop. */ | |
bd99dc85 PA |
260 | int suspended; |
261 | ||
262 | /* If this flag is set, the lwp is known to be stopped right now (stop | |
0d62e5e8 DJ |
263 | event already received in a wait()). */ |
264 | int stopped; | |
265 | ||
95954743 PA |
266 | /* If this flag is set, the lwp is known to be dead already (exit |
267 | event already received in a wait(), and is cached in | |
268 | status_pending). */ | |
269 | int dead; | |
270 | ||
bd99dc85 | 271 | /* When stopped is set, the last wait status recorded for this lwp. */ |
32ca6d61 DJ |
272 | int last_status; |
273 | ||
582511be PA |
274 | /* When stopped is set, this is where the lwp last stopped, with |
275 | decr_pc_after_break already accounted for. If the LWP is | |
276 | running, this is the address at which the lwp was resumed. */ | |
d50171e4 PA |
277 | CORE_ADDR stop_pc; |
278 | ||
0d62e5e8 DJ |
279 | /* If this flag is set, STATUS_PENDING is a waitstatus that has not yet |
280 | been reported. */ | |
281 | int status_pending_p; | |
282 | int status_pending; | |
283 | ||
582511be PA |
284 | /* The reason the LWP last stopped, if we need to track it |
285 | (breakpoint, watchpoint, etc.) */ | |
15c66dd6 | 286 | enum target_stop_reason stop_reason; |
c3adc08c PA |
287 | |
288 | /* On architectures where it is possible to know the data address of | |
289 | a triggered watchpoint, STOPPED_DATA_ADDRESS is non-zero, and | |
290 | contains such data address. Only valid if STOPPED_BY_WATCHPOINT | |
291 | is true. */ | |
292 | CORE_ADDR stopped_data_address; | |
293 | ||
0d62e5e8 DJ |
294 | /* If this is non-zero, it is a breakpoint to be reinserted at our next |
295 | stop (SIGTRAP stops only). */ | |
296 | CORE_ADDR bp_reinsert; | |
297 | ||
d50171e4 PA |
298 | /* If this flag is set, the last continue operation at the ptrace |
299 | level on this process was a single-step. */ | |
0d62e5e8 DJ |
300 | int stepping; |
301 | ||
c2d6af84 PA |
302 | /* Range to single step within. This is a copy of the step range |
303 | passed along the last resume request. See 'struct | |
304 | thread_resume'. */ | |
305 | CORE_ADDR step_range_start; /* Inclusive */ | |
306 | CORE_ADDR step_range_end; /* Exclusive */ | |
307 | ||
a6dbe5df PA |
308 | /* If this flag is set, we need to set the event request flags the |
309 | next time we see this LWP stop. */ | |
310 | int must_set_ptrace_flags; | |
311 | ||
0d62e5e8 DJ |
312 | /* If this is non-zero, it points to a chain of signals which need to |
313 | be delivered to this process. */ | |
314 | struct pending_signals *pending_signals; | |
5544ad89 DJ |
315 | |
316 | /* A link used when resuming. It is initialized from the resume request, | |
54a0b537 | 317 | and then processed and cleared in linux_resume_one_lwp. */ |
5544ad89 | 318 | struct thread_resume *resume; |
dae5f5cf | 319 | |
fa593d66 PA |
320 | /* True if it is known that this lwp is presently collecting a fast |
321 | tracepoint (it is in the jump pad or in some code that will | |
322 | return to the jump pad. Normally, we won't care about this, but | |
323 | we will if a signal arrives to this lwp while it is | |
324 | collecting. */ | |
325 | int collecting_fast_tracepoint; | |
326 | ||
327 | /* If this is non-zero, it points to a chain of signals which need | |
328 | to be reported to GDB. These were deferred because the thread | |
329 | was doing a fast tracepoint collect when they arrived. */ | |
330 | struct pending_signals *pending_signals_to_report; | |
331 | ||
332 | /* When collecting_fast_tracepoint is first found to be 1, we insert | |
333 | a exit-jump-pad-quickly breakpoint. This is it. */ | |
334 | struct breakpoint *exit_jump_pad_bkpt; | |
335 | ||
d50171e4 PA |
336 | /* True if the LWP was seen stop at an internal breakpoint and needs |
337 | stepping over later when it is resumed. */ | |
338 | int need_step_over; | |
339 | ||
04f5fe89 | 340 | #ifdef USE_THREAD_DB |
d5c93e41 | 341 | int thread_known; |
24a09b5f DJ |
342 | /* The thread handle, used for e.g. TLS access. Only valid if |
343 | THREAD_KNOWN is set. */ | |
dae5f5cf DJ |
344 | td_thrhandle_t th; |
345 | #endif | |
aa5ca48f DE |
346 | |
347 | /* Arch-specific additions. */ | |
348 | struct arch_lwp_info *arch_private; | |
0d62e5e8 | 349 | }; |
5544ad89 | 350 | |
214d508e | 351 | int linux_pid_exe_is_elf_64_file (int pid, unsigned int *machine); |
d0722149 | 352 | |
7ae1a6a6 PA |
353 | /* Attach to PTID. Returns 0 on success, non-zero otherwise (an |
354 | errno). */ | |
355 | int linux_attach_lwp (ptid_t ptid); | |
356 | ||
cdbfd419 | 357 | struct lwp_info *find_lwp_pid (ptid_t ptid); |
964e4306 | 358 | void linux_stop_lwp (struct lwp_info *lwp); |
0d62e5e8 | 359 | |
3aee8918 PA |
360 | #ifdef HAVE_LINUX_REGSETS |
361 | void initialize_regsets_info (struct regsets_info *regsets_info); | |
362 | #endif | |
363 | ||
364 | void initialize_low_arch (void); | |
365 | ||
cdbfd419 | 366 | /* From thread-db.c */ |
24a09b5f | 367 | int thread_db_init (int use_events); |
8336d594 PA |
368 | void thread_db_detach (struct process_info *); |
369 | void thread_db_mourn (struct process_info *); | |
cdbfd419 | 370 | int thread_db_handle_monitor_command (char *); |
dae5f5cf DJ |
371 | int thread_db_get_tls_address (struct thread_info *thread, CORE_ADDR offset, |
372 | CORE_ADDR load_module, CORE_ADDR *address); | |
9836d6ea | 373 | int thread_db_look_up_one_symbol (const char *name, CORE_ADDR *addrp); |