Linux x86 low-level debug register comment synchronization
[deliverable/binutils-gdb.git] / gdb / x86-linux-nat.c
1 /* Native-dependent code for GNU/Linux x86 (i386 and x86-64).
2
3 Copyright (C) 1999-2015 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 #include "defs.h"
21 #include "inferior.h"
22 #include "elf/common.h"
23 #include "gdb_proc_service.h"
24 #include <sys/ptrace.h>
25 #include <sys/user.h>
26 #include <sys/procfs.h>
27 #include <sys/uio.h>
28
29 #include "x86-nat.h"
30 #include "linux-nat.h"
31 #ifndef __x86_64__
32 #include "i386-linux-nat.h"
33 #endif
34 #include "x86-linux-nat.h"
35 #include "i386-linux-tdep.h"
36 #ifdef __x86_64__
37 #include "amd64-linux-tdep.h"
38 #endif
39 #include "x86-xstate.h"
40 #include "nat/linux-btrace.h"
41 #include "nat/linux-nat.h"
42 #include "nat/x86-linux.h"
43
44 /* Per-thread arch-specific data we want to keep. */
45
46 struct arch_lwp_info
47 {
48 /* Non-zero if our copy differs from what's recorded in the thread. */
49 int debug_registers_changed;
50 };
51
52 /* Does the current host support PTRACE_GETREGSET? */
53 int have_ptrace_getregset = -1;
54 \f
55
56 /* Return the offset of REGNUM in the u_debugreg field of struct
57 user. */
58
59 static int
60 u_debugreg_offset (int regnum)
61 {
62 return (offsetof (struct user, u_debugreg)
63 + sizeof (((struct user *) 0)->u_debugreg[0]) * regnum);
64 }
65
66 /* Support for debug registers. */
67
68 /* Get debug register REGNUM value from the LWP specified by PTID. */
69
70 static unsigned long
71 x86_linux_dr_get (ptid_t ptid, int regnum)
72 {
73 int tid;
74 unsigned long value;
75
76 gdb_assert (ptid_lwp_p (ptid));
77 tid = ptid_get_lwp (ptid);
78
79 errno = 0;
80 value = ptrace (PTRACE_PEEKUSER, tid, u_debugreg_offset (regnum), 0);
81
82 if (errno != 0)
83 perror_with_name (_("Couldn't read debug register"));
84
85 return value;
86 }
87
88 /* Set debug register REGNUM to VALUE in the LWP specified by PTID. */
89
90 static void
91 x86_linux_dr_set (ptid_t ptid, int regnum, unsigned long value)
92 {
93 int tid;
94
95 gdb_assert (ptid_lwp_p (ptid));
96 tid = ptid_get_lwp (ptid);
97
98 errno = 0;
99 ptrace (PTRACE_POKEUSER, tid, u_debugreg_offset (regnum), value);
100 if (errno != 0)
101 perror_with_name (_("Couldn't write debug register"));
102 }
103
104 /* Return the address stored in the current inferior's debug register
105 REGNUM. */
106
107 static CORE_ADDR
108 x86_linux_dr_get_addr (int regnum)
109 {
110 gdb_assert (DR_FIRSTADDR <= regnum && regnum <= DR_LASTADDR);
111
112 return x86_linux_dr_get (current_lwp_ptid (), regnum);
113 }
114
115 /* Return the value stored in the current inferior's debug control
116 register. */
117
118 static unsigned long
119 x86_linux_dr_get_control (void)
120 {
121 return x86_linux_dr_get (current_lwp_ptid (), DR_CONTROL);
122 }
123
124 /* Return the value stored in the current inferior's debug status
125 register. */
126
127 static unsigned long
128 x86_linux_dr_get_status (void)
129 {
130 return x86_linux_dr_get (current_lwp_ptid (), DR_STATUS);
131 }
132
133 /* Callback for iterate_over_lwps. Mark that our local mirror of
134 LWP's debug registers has been changed, and cause LWP to stop if
135 it isn't already. Values are written from our local mirror to
136 the actual debug registers immediately prior to LWP resuming. */
137
138 static int
139 update_debug_registers_callback (struct lwp_info *lwp, void *arg)
140 {
141 lwp_set_debug_registers_changed (lwp, 1);
142
143 if (!lwp_is_stopped (lwp))
144 linux_stop_lwp (lwp);
145
146 /* Continue the iteration. */
147 return 0;
148 }
149
150 /* Store CONTROL in the debug control registers of all LWPs of the
151 current inferior. */
152
153 static void
154 x86_linux_dr_set_control (unsigned long control)
155 {
156 ptid_t pid_ptid = pid_to_ptid (ptid_get_pid (current_lwp_ptid ()));
157
158 iterate_over_lwps (pid_ptid, update_debug_registers_callback, NULL);
159 }
160
161 /* Store ADDR in debug register REGNUM of all LWPs of the current
162 inferior. */
163
164 static void
165 x86_linux_dr_set_addr (int regnum, CORE_ADDR addr)
166 {
167 ptid_t pid_ptid = pid_to_ptid (ptid_get_pid (current_lwp_ptid ()));
168
169 gdb_assert (DR_FIRSTADDR <= regnum && regnum <= DR_LASTADDR);
170
171 iterate_over_lwps (pid_ptid, update_debug_registers_callback, NULL);
172 }
173
174 /* Called prior to resuming a thread. Updates the thread's debug
175 registers if the values in our local mirror have been changed. */
176
177 static void
178 x86_linux_prepare_to_resume (struct lwp_info *lwp)
179 {
180 ptid_t ptid = ptid_of_lwp (lwp);
181 int clear_status = 0;
182
183 if (lwp_debug_registers_changed (lwp))
184 {
185 struct x86_debug_reg_state *state
186 = x86_debug_reg_state (ptid_get_pid (ptid));
187 int i;
188
189 /* Prior to Linux kernel 2.6.33 commit
190 72f674d203cd230426437cdcf7dd6f681dad8b0d, setting DR0-3 to
191 a value that did not match what was enabled in DR_CONTROL
192 resulted in EINVAL. To avoid this we zero DR_CONTROL before
193 writing address registers, only writing DR_CONTROL's actual
194 value once all the addresses are in place. */
195 x86_linux_dr_set (ptid, DR_CONTROL, 0);
196
197 ALL_DEBUG_ADDRESS_REGISTERS (i)
198 if (state->dr_ref_count[i] > 0)
199 {
200 x86_linux_dr_set (ptid, i, state->dr_mirror[i]);
201
202 /* If we're setting a watchpoint, any change the inferior
203 has made to its debug registers needs to be discarded
204 to avoid x86_stopped_data_address getting confused. */
205 clear_status = 1;
206 }
207
208 /* If DR_CONTROL is supposed to be zero then it's already set. */
209 if (state->dr_control_mirror != 0)
210 x86_linux_dr_set (ptid, DR_CONTROL, state->dr_control_mirror);
211
212 lwp_set_debug_registers_changed (lwp, 0);
213 }
214
215 if (clear_status
216 || lwp_stop_reason (lwp) == TARGET_STOPPED_BY_WATCHPOINT)
217 x86_linux_dr_set (ptid, DR_STATUS, 0);
218 }
219
220 /* Called when a new thread is detected. */
221
222 static void
223 x86_linux_new_thread (struct lwp_info *lwp)
224 {
225 lwp_set_debug_registers_changed (lwp, 1);
226 }
227 \f
228
229 /* linux_nat_new_fork hook. */
230
231 static void
232 x86_linux_new_fork (struct lwp_info *parent, pid_t child_pid)
233 {
234 pid_t parent_pid;
235 struct x86_debug_reg_state *parent_state;
236 struct x86_debug_reg_state *child_state;
237
238 /* NULL means no watchpoint has ever been set in the parent. In
239 that case, there's nothing to do. */
240 if (parent->arch_private == NULL)
241 return;
242
243 /* Linux kernel before 2.6.33 commit
244 72f674d203cd230426437cdcf7dd6f681dad8b0d
245 will inherit hardware debug registers from parent
246 on fork/vfork/clone. Newer Linux kernels create such tasks with
247 zeroed debug registers.
248
249 GDB core assumes the child inherits the watchpoints/hw
250 breakpoints of the parent, and will remove them all from the
251 forked off process. Copy the debug registers mirrors into the
252 new process so that all breakpoints and watchpoints can be
253 removed together. The debug registers mirror will become zeroed
254 in the end before detaching the forked off process, thus making
255 this compatible with older Linux kernels too. */
256
257 parent_pid = ptid_get_pid (parent->ptid);
258 parent_state = x86_debug_reg_state (parent_pid);
259 child_state = x86_debug_reg_state (child_pid);
260 *child_state = *parent_state;
261 }
262 \f
263
264 static void (*super_post_startup_inferior) (struct target_ops *self,
265 ptid_t ptid);
266
267 static void
268 x86_linux_child_post_startup_inferior (struct target_ops *self, ptid_t ptid)
269 {
270 x86_cleanup_dregs ();
271 super_post_startup_inferior (self, ptid);
272 }
273
274 #ifdef __x86_64__
275 /* Value of CS segment register:
276 64bit process: 0x33
277 32bit process: 0x23 */
278 #define AMD64_LINUX_USER64_CS 0x33
279
280 /* Value of DS segment register:
281 LP64 process: 0x0
282 X32 process: 0x2b */
283 #define AMD64_LINUX_X32_DS 0x2b
284 #endif
285
286 /* Get Linux/x86 target description from running target. */
287
288 static const struct target_desc *
289 x86_linux_read_description (struct target_ops *ops)
290 {
291 int tid;
292 int is_64bit = 0;
293 #ifdef __x86_64__
294 int is_x32;
295 #endif
296 static uint64_t xcr0;
297 uint64_t xcr0_features_bits;
298
299 /* GNU/Linux LWP ID's are process ID's. */
300 tid = ptid_get_lwp (inferior_ptid);
301 if (tid == 0)
302 tid = ptid_get_pid (inferior_ptid); /* Not a threaded program. */
303
304 #ifdef __x86_64__
305 {
306 unsigned long cs;
307 unsigned long ds;
308
309 /* Get CS register. */
310 errno = 0;
311 cs = ptrace (PTRACE_PEEKUSER, tid,
312 offsetof (struct user_regs_struct, cs), 0);
313 if (errno != 0)
314 perror_with_name (_("Couldn't get CS register"));
315
316 is_64bit = cs == AMD64_LINUX_USER64_CS;
317
318 /* Get DS register. */
319 errno = 0;
320 ds = ptrace (PTRACE_PEEKUSER, tid,
321 offsetof (struct user_regs_struct, ds), 0);
322 if (errno != 0)
323 perror_with_name (_("Couldn't get DS register"));
324
325 is_x32 = ds == AMD64_LINUX_X32_DS;
326
327 if (sizeof (void *) == 4 && is_64bit && !is_x32)
328 error (_("Can't debug 64-bit process with 32-bit GDB"));
329 }
330 #elif HAVE_PTRACE_GETFPXREGS
331 if (have_ptrace_getfpxregs == -1)
332 {
333 elf_fpxregset_t fpxregs;
334
335 if (ptrace (PTRACE_GETFPXREGS, tid, 0, (int) &fpxregs) < 0)
336 {
337 have_ptrace_getfpxregs = 0;
338 have_ptrace_getregset = 0;
339 return tdesc_i386_mmx_linux;
340 }
341 }
342 #endif
343
344 if (have_ptrace_getregset == -1)
345 {
346 uint64_t xstateregs[(X86_XSTATE_SSE_SIZE / sizeof (uint64_t))];
347 struct iovec iov;
348
349 iov.iov_base = xstateregs;
350 iov.iov_len = sizeof (xstateregs);
351
352 /* Check if PTRACE_GETREGSET works. */
353 if (ptrace (PTRACE_GETREGSET, tid,
354 (unsigned int) NT_X86_XSTATE, &iov) < 0)
355 have_ptrace_getregset = 0;
356 else
357 {
358 have_ptrace_getregset = 1;
359
360 /* Get XCR0 from XSAVE extended state. */
361 xcr0 = xstateregs[(I386_LINUX_XSAVE_XCR0_OFFSET
362 / sizeof (uint64_t))];
363 }
364 }
365
366 /* Check the native XCR0 only if PTRACE_GETREGSET is available. If
367 PTRACE_GETREGSET is not available then set xcr0_features_bits to
368 zero so that the "no-features" descriptions are returned by the
369 switches below. */
370 if (have_ptrace_getregset)
371 xcr0_features_bits = xcr0 & X86_XSTATE_ALL_MASK;
372 else
373 xcr0_features_bits = 0;
374
375 if (is_64bit)
376 {
377 #ifdef __x86_64__
378 switch (xcr0_features_bits)
379 {
380 case X86_XSTATE_MPX_AVX512_MASK:
381 case X86_XSTATE_AVX512_MASK:
382 if (is_x32)
383 return tdesc_x32_avx512_linux;
384 else
385 return tdesc_amd64_avx512_linux;
386 case X86_XSTATE_MPX_MASK:
387 if (is_x32)
388 return tdesc_x32_avx_linux; /* No MPX on x32 using AVX. */
389 else
390 return tdesc_amd64_mpx_linux;
391 case X86_XSTATE_AVX_MASK:
392 if (is_x32)
393 return tdesc_x32_avx_linux;
394 else
395 return tdesc_amd64_avx_linux;
396 default:
397 if (is_x32)
398 return tdesc_x32_linux;
399 else
400 return tdesc_amd64_linux;
401 }
402 #endif
403 }
404 else
405 {
406 switch (xcr0_features_bits)
407 {
408 case X86_XSTATE_MPX_AVX512_MASK:
409 case X86_XSTATE_AVX512_MASK:
410 return tdesc_i386_avx512_linux;
411 case X86_XSTATE_MPX_MASK:
412 return tdesc_i386_mpx_linux;
413 case X86_XSTATE_AVX_MASK:
414 return tdesc_i386_avx_linux;
415 default:
416 return tdesc_i386_linux;
417 }
418 }
419
420 gdb_assert_not_reached ("failed to return tdesc");
421 }
422 \f
423
424 /* Enable branch tracing. */
425
426 static struct btrace_target_info *
427 x86_linux_enable_btrace (struct target_ops *self, ptid_t ptid,
428 const struct btrace_config *conf)
429 {
430 struct btrace_target_info *tinfo;
431 struct gdbarch *gdbarch;
432
433 errno = 0;
434 tinfo = linux_enable_btrace (ptid, conf);
435
436 if (tinfo == NULL)
437 error (_("Could not enable branch tracing for %s: %s."),
438 target_pid_to_str (ptid), safe_strerror (errno));
439
440 /* Fill in the size of a pointer in bits. */
441 if (tinfo->ptr_bits == 0)
442 {
443 gdbarch = target_thread_architecture (ptid);
444 tinfo->ptr_bits = gdbarch_ptr_bit (gdbarch);
445 }
446 return tinfo;
447 }
448
449 /* Disable branch tracing. */
450
451 static void
452 x86_linux_disable_btrace (struct target_ops *self,
453 struct btrace_target_info *tinfo)
454 {
455 enum btrace_error errcode = linux_disable_btrace (tinfo);
456
457 if (errcode != BTRACE_ERR_NONE)
458 error (_("Could not disable branch tracing."));
459 }
460
461 /* Teardown branch tracing. */
462
463 static void
464 x86_linux_teardown_btrace (struct target_ops *self,
465 struct btrace_target_info *tinfo)
466 {
467 /* Ignore errors. */
468 linux_disable_btrace (tinfo);
469 }
470
471 static enum btrace_error
472 x86_linux_read_btrace (struct target_ops *self,
473 struct btrace_data *data,
474 struct btrace_target_info *btinfo,
475 enum btrace_read_type type)
476 {
477 return linux_read_btrace (data, btinfo, type);
478 }
479
480 /* See to_btrace_conf in target.h. */
481
482 static const struct btrace_config *
483 x86_linux_btrace_conf (struct target_ops *self,
484 const struct btrace_target_info *btinfo)
485 {
486 return linux_btrace_conf (btinfo);
487 }
488
489 \f
490
491 /* Helper for ps_get_thread_area. Sets BASE_ADDR to a pointer to
492 the thread local storage (or its descriptor) and returns PS_OK
493 on success. Returns PS_ERR on failure. */
494
495 ps_err_e
496 x86_linux_get_thread_area (pid_t pid, void *addr, unsigned int *base_addr)
497 {
498 /* NOTE: cagney/2003-08-26: The definition of this buffer is found
499 in the kernel header <asm-i386/ldt.h>. It, after padding, is 4 x
500 4 byte integers in size: `entry_number', `base_addr', `limit',
501 and a bunch of status bits.
502
503 The values returned by this ptrace call should be part of the
504 regcache buffer, and ps_get_thread_area should channel its
505 request through the regcache. That way remote targets could
506 provide the value using the remote protocol and not this direct
507 call.
508
509 Is this function needed? I'm guessing that the `base' is the
510 address of a descriptor that libthread_db uses to find the
511 thread local address base that GDB needs. Perhaps that
512 descriptor is defined by the ABI. Anyway, given that
513 libthread_db calls this function without prompting (gdb
514 requesting tls base) I guess it needs info in there anyway. */
515 unsigned int desc[4];
516
517 /* This code assumes that "int" is 32 bits and that
518 GET_THREAD_AREA returns no more than 4 int values. */
519 gdb_assert (sizeof (int) == 4);
520
521 #ifndef PTRACE_GET_THREAD_AREA
522 #define PTRACE_GET_THREAD_AREA 25
523 #endif
524
525 if (ptrace (PTRACE_GET_THREAD_AREA, pid, addr, &desc) < 0)
526 return PS_ERR;
527
528 *base_addr = desc[1];
529 return PS_OK;
530 }
531 \f
532
533 /* Create an x86 GNU/Linux target. */
534
535 struct target_ops *
536 x86_linux_create_target (void)
537 {
538 /* Fill in the generic GNU/Linux methods. */
539 struct target_ops *t = linux_target ();
540
541 /* Initialize the debug register function vectors. */
542 x86_use_watchpoints (t);
543 x86_dr_low.set_control = x86_linux_dr_set_control;
544 x86_dr_low.set_addr = x86_linux_dr_set_addr;
545 x86_dr_low.get_addr = x86_linux_dr_get_addr;
546 x86_dr_low.get_status = x86_linux_dr_get_status;
547 x86_dr_low.get_control = x86_linux_dr_get_control;
548 x86_set_debug_register_length (sizeof (void *));
549
550 /* Override the GNU/Linux inferior startup hook. */
551 super_post_startup_inferior = t->to_post_startup_inferior;
552 t->to_post_startup_inferior = x86_linux_child_post_startup_inferior;
553
554 /* Add the description reader. */
555 t->to_read_description = x86_linux_read_description;
556
557 /* Add btrace methods. */
558 t->to_supports_btrace = linux_supports_btrace;
559 t->to_enable_btrace = x86_linux_enable_btrace;
560 t->to_disable_btrace = x86_linux_disable_btrace;
561 t->to_teardown_btrace = x86_linux_teardown_btrace;
562 t->to_read_btrace = x86_linux_read_btrace;
563 t->to_btrace_conf = x86_linux_btrace_conf;
564
565 return t;
566 }
567
568 /* Add an x86 GNU/Linux target. */
569
570 void
571 x86_linux_add_target (struct target_ops *t)
572 {
573 linux_nat_add_target (t);
574 linux_nat_set_new_thread (t, x86_linux_new_thread);
575 linux_nat_set_new_fork (t, x86_linux_new_fork);
576 linux_nat_set_forget_process (t, x86_forget_process);
577 linux_nat_set_prepare_to_resume (t, x86_linux_prepare_to_resume);
578 }
This page took 0.043502 seconds and 5 git commands to generate.