Commit | Line | Data |
---|---|---|
58caa3dc | 1 | /* Internal interfaces for the GNU/Linux specific target code for gdbserver. |
61baf725 | 2 | Copyright (C) 2002-2017 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 | ||
50bc912a PA |
41 | /* The arch's regsets array initializer must be terminated with a NULL |
42 | regset. */ | |
43 | #define NULL_REGSET \ | |
44 | { 0, 0, 0, -1, (enum regset_type) -1, NULL, NULL } | |
45 | ||
58caa3dc DJ |
46 | struct regset_info |
47 | { | |
48 | int get_request, set_request; | |
1570b33e L |
49 | /* If NT_TYPE isn't 0, it will be passed to ptrace as the 3rd |
50 | argument and the 4th argument should be "const struct iovec *". */ | |
51 | int nt_type; | |
58caa3dc | 52 | int size; |
0d62e5e8 DJ |
53 | enum regset_type type; |
54 | regset_fill_func fill_function; | |
55 | regset_store_func store_function; | |
58caa3dc | 56 | }; |
3aee8918 PA |
57 | |
58 | /* Aggregation of all the supported regsets of a given | |
59 | architecture/mode. */ | |
60 | ||
61 | struct regsets_info | |
62 | { | |
63 | /* The regsets array. */ | |
64 | struct regset_info *regsets; | |
65 | ||
66 | /* The number of regsets in the REGSETS array. */ | |
67 | int num_regsets; | |
68 | ||
69 | /* If we get EIO on a regset, do not try it again. Note the set of | |
70 | supported regsets may depend on processor mode on biarch | |
030031ee PA |
71 | machines. This is a (lazily allocated) array holding one boolean |
72 | byte (0/1) per regset, with each element corresponding to the | |
73 | regset in the REGSETS array above at the same offset. */ | |
3aee8918 PA |
74 | char *disabled_regsets; |
75 | }; | |
76 | ||
77 | #endif | |
78 | ||
79 | /* Mapping between the general-purpose registers in `struct user' | |
80 | format and GDB's register array layout. */ | |
81 | ||
82 | struct usrregs_info | |
83 | { | |
84 | /* The number of registers accessible. */ | |
85 | int num_regs; | |
86 | ||
87 | /* The registers map. */ | |
88 | int *regmap; | |
89 | }; | |
90 | ||
91 | /* All info needed to access an architecture/mode's registers. */ | |
92 | ||
93 | struct regs_info | |
94 | { | |
95 | /* Regset support bitmap: 1 for registers that are transferred as a part | |
96 | of a regset, 0 for ones that need to be handled individually. This | |
97 | can be NULL if all registers are transferred with regsets or regsets | |
98 | are not supported. */ | |
99 | unsigned char *regset_bitmap; | |
100 | ||
101 | /* Info used when accessing registers with PTRACE_PEEKUSER / | |
102 | PTRACE_POKEUSER. This can be NULL if all registers are | |
103 | transferred with regsets .*/ | |
104 | struct usrregs_info *usrregs; | |
105 | ||
106 | #ifdef HAVE_LINUX_REGSETS | |
107 | /* Info used when accessing registers with regsets. */ | |
108 | struct regsets_info *regsets_info; | |
58caa3dc | 109 | #endif |
3aee8918 | 110 | }; |
2ec06d2e | 111 | |
95954743 PA |
112 | struct process_info_private |
113 | { | |
aa5ca48f DE |
114 | /* Arch-specific additions. */ |
115 | struct arch_process_info *arch_private; | |
cdbfd419 PP |
116 | |
117 | /* libthread_db-specific additions. Not NULL if this process has loaded | |
118 | thread_db, and it is active. */ | |
119 | struct thread_db *thread_db; | |
2268b414 JK |
120 | |
121 | /* &_r_debug. 0 if not yet determined. -1 if no PT_DYNAMIC in Phdrs. */ | |
122 | CORE_ADDR r_debug; | |
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); | |
dd373349 AT |
149 | |
150 | /* See target.h for details. */ | |
151 | int (*breakpoint_kind_from_pc) (CORE_ADDR *pcptr); | |
152 | ||
153 | /* See target.h for details. */ | |
154 | const gdb_byte *(*sw_breakpoint_from_kind) (int kind, int *size); | |
155 | ||
fa5308bd | 156 | /* Find the next possible PCs after the current instruction executes. */ |
a0ff9e1a | 157 | std::vector<CORE_ADDR> (*get_next_pcs) (struct regcache *regcache); |
0d62e5e8 | 158 | |
0d62e5e8 DJ |
159 | int decr_pc_after_break; |
160 | int (*breakpoint_at) (CORE_ADDR pc); | |
e013ee27 | 161 | |
d993e290 PA |
162 | /* Breakpoint and watchpoint related functions. See target.h for |
163 | comments. */ | |
802e8e6d PA |
164 | int (*supports_z_point_type) (char z_type); |
165 | int (*insert_point) (enum raw_bkpt_type type, CORE_ADDR addr, | |
166 | int size, struct raw_breakpoint *bp); | |
167 | int (*remove_point) (enum raw_bkpt_type type, CORE_ADDR addr, | |
168 | int size, struct raw_breakpoint *bp); | |
169 | ||
e013ee27 OF |
170 | int (*stopped_by_watchpoint) (void); |
171 | CORE_ADDR (*stopped_data_address) (void); | |
172 | ||
ee1a7ae4 UW |
173 | /* Hooks to reformat register data for PEEKUSR/POKEUSR (in particular |
174 | for registers smaller than an xfer unit). */ | |
442ea881 PA |
175 | void (*collect_ptrace_register) (struct regcache *regcache, |
176 | int regno, char *buf); | |
177 | void (*supply_ptrace_register) (struct regcache *regcache, | |
178 | int regno, const char *buf); | |
d0722149 DE |
179 | |
180 | /* Hook to convert from target format to ptrace format and back. | |
181 | Returns true if any conversion was done; false otherwise. | |
182 | If DIRECTION is 1, then copy from INF to NATIVE. | |
183 | If DIRECTION is 0, copy from NATIVE to INF. */ | |
8adce034 | 184 | int (*siginfo_fixup) (siginfo_t *native, gdb_byte *inf, int direction); |
aa5ca48f DE |
185 | |
186 | /* Hook to call when a new process is created or attached to. | |
187 | If extra per-process architecture-specific data is needed, | |
188 | allocate it here. */ | |
189 | struct arch_process_info * (*new_process) (void); | |
190 | ||
191 | /* Hook to call when a new thread is detected. | |
192 | If extra per-thread architecture-specific data is needed, | |
193 | allocate it here. */ | |
34c703da | 194 | void (*new_thread) (struct lwp_info *); |
aa5ca48f | 195 | |
3a8a0396 DB |
196 | /* Hook to call, if any, when a new fork is attached. */ |
197 | void (*new_fork) (struct process_info *parent, struct process_info *child); | |
198 | ||
aa5ca48f DE |
199 | /* Hook to call prior to resuming a thread. */ |
200 | void (*prepare_to_resume) (struct lwp_info *); | |
1570b33e L |
201 | |
202 | /* Hook to support target specific qSupported. */ | |
06e03fff | 203 | void (*process_qsupported) (char **, int count); |
219f2f23 PA |
204 | |
205 | /* Returns true if the low target supports tracepoints. */ | |
206 | int (*supports_tracepoints) (void); | |
fa593d66 PA |
207 | |
208 | /* Fill ADDRP with the thread area address of LWPID. Returns 0 on | |
209 | success, -1 on failure. */ | |
210 | int (*get_thread_area) (int lwpid, CORE_ADDR *addrp); | |
211 | ||
212 | /* Install a fast tracepoint jump pad. See target.h for | |
213 | comments. */ | |
214 | int (*install_fast_tracepoint_jump_pad) (CORE_ADDR tpoint, CORE_ADDR tpaddr, | |
215 | CORE_ADDR collector, | |
216 | CORE_ADDR lockaddr, | |
217 | ULONGEST orig_size, | |
218 | CORE_ADDR *jump_entry, | |
405f8e94 SS |
219 | CORE_ADDR *trampoline, |
220 | ULONGEST *trampoline_size, | |
fa593d66 PA |
221 | unsigned char *jjump_pad_insn, |
222 | ULONGEST *jjump_pad_insn_size, | |
223 | CORE_ADDR *adjusted_insn_addr, | |
405f8e94 SS |
224 | CORE_ADDR *adjusted_insn_addr_end, |
225 | char *err); | |
6a271cae PA |
226 | |
227 | /* Return the bytecode operations vector for the current inferior. | |
228 | Returns NULL if bytecode compilation is not supported. */ | |
229 | struct emit_ops *(*emit_ops) (void); | |
405f8e94 SS |
230 | |
231 | /* Return the minimum length of an instruction that can be safely overwritten | |
232 | for use as a fast tracepoint. */ | |
233 | int (*get_min_fast_tracepoint_insn_len) (void); | |
234 | ||
c2d6af84 PA |
235 | /* Returns true if the low target supports range stepping. */ |
236 | int (*supports_range_stepping) (void); | |
769ef81f AT |
237 | |
238 | /* See target.h. */ | |
239 | int (*breakpoint_kind_from_current_state) (CORE_ADDR *pcptr); | |
7d00775e AT |
240 | |
241 | /* See target.h. */ | |
242 | int (*supports_hardware_single_step) (void); | |
82075af2 | 243 | |
4cc32bec YQ |
244 | /* Fill *SYSNO with the syscall nr trapped. Only to be called when |
245 | inferior is stopped due to SYSCALL_SIGTRAP. */ | |
246 | void (*get_syscall_trapinfo) (struct regcache *regcache, int *sysno); | |
ae91f625 MK |
247 | |
248 | /* See target.h. */ | |
249 | int (*get_ipa_tdesc_idx) (void); | |
2ec06d2e DJ |
250 | }; |
251 | ||
252 | extern struct linux_target_ops the_low_target; | |
0d62e5e8 | 253 | |
d86d4aaf | 254 | #define get_thread_lwp(thr) ((struct lwp_info *) (inferior_target_data (thr))) |
f7667f0d | 255 | #define get_lwp_thread(lwp) ((lwp)->thread) |
0d62e5e8 | 256 | |
d86d4aaf DE |
257 | /* This struct is recorded in the target_data field of struct thread_info. |
258 | ||
259 | On linux ``all_threads'' is keyed by the LWP ID, which we use as the | |
260 | GDB protocol representation of the thread ID. Threads also have | |
261 | a "process ID" (poorly named) which is (presently) the same as the | |
262 | LWP ID. | |
263 | ||
264 | There is also ``all_processes'' is keyed by the "overall process ID", | |
265 | which GNU/Linux calls tgid, "thread group ID". */ | |
266 | ||
54a0b537 | 267 | struct lwp_info |
0d62e5e8 | 268 | { |
d86d4aaf | 269 | /* Backlink to the parent object. */ |
f7667f0d DE |
270 | struct thread_info *thread; |
271 | ||
ae13219e DJ |
272 | /* If this flag is set, the next SIGSTOP will be ignored (the |
273 | process will be immediately resumed). This means that either we | |
274 | sent the SIGSTOP to it ourselves and got some other pending event | |
275 | (so the SIGSTOP is still pending), or that we stopped the | |
276 | inferior implicitly via PTRACE_ATTACH and have not waited for it | |
277 | yet. */ | |
0d62e5e8 DJ |
278 | int stop_expected; |
279 | ||
d50171e4 PA |
280 | /* When this is true, we shall not try to resume this thread, even |
281 | if last_resume_kind isn't resume_stop. */ | |
bd99dc85 PA |
282 | int suspended; |
283 | ||
284 | /* If this flag is set, the lwp is known to be stopped right now (stop | |
0d62e5e8 DJ |
285 | event already received in a wait()). */ |
286 | int stopped; | |
287 | ||
82075af2 JS |
288 | /* Signal whether we are in a SYSCALL_ENTRY or |
289 | in a SYSCALL_RETURN event. | |
290 | Values: | |
291 | - TARGET_WAITKIND_SYSCALL_ENTRY | |
292 | - TARGET_WAITKIND_SYSCALL_RETURN */ | |
293 | enum target_waitkind syscall_state; | |
294 | ||
bd99dc85 | 295 | /* When stopped is set, the last wait status recorded for this lwp. */ |
32ca6d61 DJ |
296 | int last_status; |
297 | ||
00db26fa PA |
298 | /* If WAITSTATUS->KIND != TARGET_WAITKIND_IGNORE, the waitstatus for |
299 | this LWP's last event, to pass to GDB without any further | |
300 | processing. This is used to store extended ptrace event | |
301 | information or exit status until it can be reported to GDB. */ | |
de0d863e DB |
302 | struct target_waitstatus waitstatus; |
303 | ||
5a04c4cf PA |
304 | /* A pointer to the fork child/parent relative. Valid only while |
305 | the parent fork event is not reported to higher layers. Used to | |
306 | avoid wildcard vCont actions resuming a fork child before GDB is | |
307 | notified about the parent's fork event. */ | |
308 | struct lwp_info *fork_relative; | |
309 | ||
582511be PA |
310 | /* When stopped is set, this is where the lwp last stopped, with |
311 | decr_pc_after_break already accounted for. If the LWP is | |
312 | running, this is the address at which the lwp was resumed. */ | |
d50171e4 PA |
313 | CORE_ADDR stop_pc; |
314 | ||
0d62e5e8 DJ |
315 | /* If this flag is set, STATUS_PENDING is a waitstatus that has not yet |
316 | been reported. */ | |
317 | int status_pending_p; | |
318 | int status_pending; | |
319 | ||
582511be PA |
320 | /* The reason the LWP last stopped, if we need to track it |
321 | (breakpoint, watchpoint, etc.) */ | |
15c66dd6 | 322 | enum target_stop_reason stop_reason; |
c3adc08c PA |
323 | |
324 | /* On architectures where it is possible to know the data address of | |
325 | a triggered watchpoint, STOPPED_DATA_ADDRESS is non-zero, and | |
326 | contains such data address. Only valid if STOPPED_BY_WATCHPOINT | |
327 | is true. */ | |
328 | CORE_ADDR stopped_data_address; | |
329 | ||
0d62e5e8 DJ |
330 | /* If this is non-zero, it is a breakpoint to be reinserted at our next |
331 | stop (SIGTRAP stops only). */ | |
332 | CORE_ADDR bp_reinsert; | |
333 | ||
d50171e4 PA |
334 | /* If this flag is set, the last continue operation at the ptrace |
335 | level on this process was a single-step. */ | |
0d62e5e8 DJ |
336 | int stepping; |
337 | ||
c2d6af84 PA |
338 | /* Range to single step within. This is a copy of the step range |
339 | passed along the last resume request. See 'struct | |
340 | thread_resume'. */ | |
341 | CORE_ADDR step_range_start; /* Inclusive */ | |
342 | CORE_ADDR step_range_end; /* Exclusive */ | |
343 | ||
a6dbe5df PA |
344 | /* If this flag is set, we need to set the event request flags the |
345 | next time we see this LWP stop. */ | |
346 | int must_set_ptrace_flags; | |
347 | ||
0d62e5e8 DJ |
348 | /* If this is non-zero, it points to a chain of signals which need to |
349 | be delivered to this process. */ | |
350 | struct pending_signals *pending_signals; | |
5544ad89 DJ |
351 | |
352 | /* A link used when resuming. It is initialized from the resume request, | |
54a0b537 | 353 | and then processed and cleared in linux_resume_one_lwp. */ |
5544ad89 | 354 | struct thread_resume *resume; |
dae5f5cf | 355 | |
fa593d66 PA |
356 | /* True if it is known that this lwp is presently collecting a fast |
357 | tracepoint (it is in the jump pad or in some code that will | |
358 | return to the jump pad. Normally, we won't care about this, but | |
359 | we will if a signal arrives to this lwp while it is | |
360 | collecting. */ | |
361 | int collecting_fast_tracepoint; | |
362 | ||
363 | /* If this is non-zero, it points to a chain of signals which need | |
364 | to be reported to GDB. These were deferred because the thread | |
365 | was doing a fast tracepoint collect when they arrived. */ | |
366 | struct pending_signals *pending_signals_to_report; | |
367 | ||
368 | /* When collecting_fast_tracepoint is first found to be 1, we insert | |
369 | a exit-jump-pad-quickly breakpoint. This is it. */ | |
370 | struct breakpoint *exit_jump_pad_bkpt; | |
371 | ||
04f5fe89 | 372 | #ifdef USE_THREAD_DB |
d5c93e41 | 373 | int thread_known; |
24a09b5f DJ |
374 | /* The thread handle, used for e.g. TLS access. Only valid if |
375 | THREAD_KNOWN is set. */ | |
dae5f5cf DJ |
376 | td_thrhandle_t th; |
377 | #endif | |
aa5ca48f DE |
378 | |
379 | /* Arch-specific additions. */ | |
380 | struct arch_lwp_info *arch_private; | |
0d62e5e8 | 381 | }; |
5544ad89 | 382 | |
214d508e | 383 | int linux_pid_exe_is_elf_64_file (int pid, unsigned int *machine); |
d0722149 | 384 | |
7ae1a6a6 PA |
385 | /* Attach to PTID. Returns 0 on success, non-zero otherwise (an |
386 | errno). */ | |
387 | int linux_attach_lwp (ptid_t ptid); | |
388 | ||
cdbfd419 | 389 | struct lwp_info *find_lwp_pid (ptid_t ptid); |
b2f7c7e8 | 390 | /* For linux_stop_lwp see nat/linux-nat.h. */ |
0d62e5e8 | 391 | |
3aee8918 PA |
392 | #ifdef HAVE_LINUX_REGSETS |
393 | void initialize_regsets_info (struct regsets_info *regsets_info); | |
394 | #endif | |
395 | ||
396 | void initialize_low_arch (void); | |
397 | ||
276d4552 YQ |
398 | void linux_set_pc_32bit (struct regcache *regcache, CORE_ADDR pc); |
399 | CORE_ADDR linux_get_pc_32bit (struct regcache *regcache); | |
400 | ||
6f69e520 YQ |
401 | void linux_set_pc_64bit (struct regcache *regcache, CORE_ADDR pc); |
402 | CORE_ADDR linux_get_pc_64bit (struct regcache *regcache); | |
403 | ||
cdbfd419 | 404 | /* From thread-db.c */ |
9b4c5f87 | 405 | int thread_db_init (void); |
8336d594 PA |
406 | void thread_db_detach (struct process_info *); |
407 | void thread_db_mourn (struct process_info *); | |
cdbfd419 | 408 | int thread_db_handle_monitor_command (char *); |
dae5f5cf DJ |
409 | int thread_db_get_tls_address (struct thread_info *thread, CORE_ADDR offset, |
410 | CORE_ADDR load_module, CORE_ADDR *address); | |
9836d6ea | 411 | int thread_db_look_up_one_symbol (const char *name, CORE_ADDR *addrp); |
ded48a5e YQ |
412 | |
413 | extern int have_ptrace_getregset; |