1 /* GNU/Linux/AArch64 specific low level interface, for the remote server for
4 Copyright (C) 2009-2013 Free Software Foundation, Inc.
5 Contributed by ARM Ltd.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
23 #include "linux-low.h"
24 #include "elf/common.h"
28 #include <sys/ptrace.h>
31 #include "gdb_proc_service.h"
33 /* Defined in auto-generated files. */
34 void init_registers_aarch64 (void);
35 extern const struct target_desc *tdesc_aarch64;
41 #define AARCH64_X_REGS_NUM 31
42 #define AARCH64_V_REGS_NUM 32
43 #define AARCH64_X0_REGNO 0
44 #define AARCH64_SP_REGNO 31
45 #define AARCH64_PC_REGNO 32
46 #define AARCH64_CPSR_REGNO 33
47 #define AARCH64_V0_REGNO 34
49 #define AARCH64_NUM_REGS (AARCH64_V0_REGNO + AARCH64_V_REGS_NUM)
54 /* These offsets correspond to GET/SETREGSET */
56 0*8, 1*8, 2*8, 3*8, 4*8, 5*8, 6*8, 7*8,
57 8*8, 9*8, 10*8, 11*8, 12*8, 13*8, 14*8, 15*8,
58 16*8, 17*8, 18*8, 19*8, 20*8, 21*8, 22*8, 23*8,
59 24*8, 25*8, 26*8, 27*8, 28*8,
64 33*8, /* cpsr 4 bytes!*/
66 /* FP register offsets correspond to GET/SETFPREGSET */
67 0*16, 1*16, 2*16, 3*16, 4*16, 5*16, 6*16, 7*16,
68 8*16, 9*16, 10*16, 11*16, 12*16, 13*16, 14*16, 15*16,
69 16*16, 17*16, 18*16, 19*16, 20*16, 21*16, 22*16, 23*16,
70 24*16, 25*16, 26*16, 27*16, 28*16, 29*16, 30*16, 31*16
73 /* Here starts the macro definitions, data structures, and code for
74 the hardware breakpoint and hardware watchpoint support. The
75 following is the abbreviations that are used frequently in the code
82 /* Maximum number of hardware breakpoint and watchpoint registers.
83 Neither of these values may exceed the width of dr_changed_t
86 #define AARCH64_HBP_MAX_NUM 16
87 #define AARCH64_HWP_MAX_NUM 16
89 /* Alignment requirement in bytes of hardware breakpoint and
90 watchpoint address. This is the requirement for the addresses that
91 can be written to the hardware breakpoint/watchpoint value
92 registers. The kernel currently does not do any alignment on
93 addresses when receiving a writing request (via ptrace call) to
94 these debug registers, and it will reject any address that is
96 Some limited support has been provided in this gdbserver port for
97 unaligned watchpoints, so that from a gdb user point of view, an
98 unaligned watchpoint can still be set. This is achieved by
99 minimally enlarging the watched area to meet the alignment
100 requirement, and if necessary, splitting the watchpoint over
101 several hardware watchpoint registers. */
103 #define AARCH64_HBP_ALIGNMENT 4
104 #define AARCH64_HWP_ALIGNMENT 8
106 /* The maximum length of a memory region that can be watched by one
107 hardware watchpoint register. */
109 #define AARCH64_HWP_MAX_LEN_PER_REG 8
111 /* Each bit of a variable of this type is used to indicate whether a
112 hardware breakpoint or watchpoint setting has been changed since
113 the last updating. Bit N corresponds to the Nth hardware
114 breakpoint or watchpoint setting which is managed in
115 aarch64_debug_reg_state. Where N is valid between 0 and the total
116 number of the hardware breakpoint or watchpoint debug registers
117 minus 1. When the bit N is 1, it indicates the corresponding
118 breakpoint or watchpoint setting is changed, and thus the
119 corresponding hardware debug register needs to be updated via the
122 In the per-thread arch-specific data area, we define two such
123 variables for per-thread hardware breakpoint and watchpoint
124 settings respectively.
126 This type is part of the mechanism which helps reduce the number of
127 ptrace calls to the kernel, i.e. avoid asking the kernel to write
128 to the debug registers with unchanged values. */
130 typedef unsigned long long dr_changed_t;
132 /* Set each of the lower M bits of X to 1; assert X is wide enough. */
134 #define DR_MARK_ALL_CHANGED(x, m) \
137 gdb_assert (sizeof ((x)) * 8 >= (m)); \
138 (x) = (((dr_changed_t)1 << (m)) - 1); \
141 #define DR_MARK_N_CHANGED(x, n) \
144 (x) |= ((dr_changed_t)1 << (n)); \
147 #define DR_CLEAR_CHANGED(x) \
153 #define DR_HAS_CHANGED(x) ((x) != 0)
154 #define DR_N_HAS_CHANGED(x, n) ((x) & ((dr_changed_t)1 << (n)))
156 /* Structure for managing the hardware breakpoint/watchpoint resources.
157 DR_ADDR_* stores the address, DR_CTRL_* stores the control register
158 content, and DR_REF_COUNT_* counts the numbers of references to the
159 corresponding bp/wp, by which way the limited hardware resources
160 are not wasted on duplicated bp/wp settings (though so far gdb has
161 done a good job by not sending duplicated bp/wp requests). */
163 struct aarch64_debug_reg_state
165 /* hardware breakpoint */
166 CORE_ADDR dr_addr_bp[AARCH64_HBP_MAX_NUM];
167 unsigned int dr_ctrl_bp[AARCH64_HBP_MAX_NUM];
168 unsigned int dr_ref_count_bp[AARCH64_HBP_MAX_NUM];
170 /* hardware watchpoint */
171 CORE_ADDR dr_addr_wp[AARCH64_HWP_MAX_NUM];
172 unsigned int dr_ctrl_wp[AARCH64_HWP_MAX_NUM];
173 unsigned int dr_ref_count_wp[AARCH64_HWP_MAX_NUM];
176 /* Per-process arch-specific data we want to keep. */
178 struct arch_process_info
180 /* Hardware breakpoint/watchpoint data.
181 The reason for them to be per-process rather than per-thread is
182 due to the lack of information in the gdbserver environment;
183 gdbserver is not told that whether a requested hardware
184 breakpoint/watchpoint is thread specific or not, so it has to set
185 each hw bp/wp for every thread in the current process. The
186 higher level bp/wp management in gdb will resume a thread if a hw
187 bp/wp trap is not expected for it. Since the hw bp/wp setting is
188 same for each thread, it is reasonable for the data to live here.
190 struct aarch64_debug_reg_state debug_reg_state;
193 /* Per-thread arch-specific data we want to keep. */
197 /* When bit N is 1, it indicates the Nth hardware breakpoint or
198 watchpoint register pair needs to be updated when the thread is
199 resumed; see aarch64_linux_prepare_to_resume. */
200 dr_changed_t dr_changed_bp;
201 dr_changed_t dr_changed_wp;
204 /* Number of hardware breakpoints/watchpoints the target supports.
205 They are initialized with values obtained via the ptrace calls
206 with NT_ARM_HW_BREAK and NT_ARM_HW_WATCH respectively. */
208 static int aarch64_num_bp_regs;
209 static int aarch64_num_wp_regs;
211 /* Hardware breakpoint/watchpoint types.
212 The values map to their encodings in the bit 4 and bit 3 of the
213 hardware breakpoint/watchpoint control registers. */
215 enum target_point_type
217 hw_execute = 0, /* Execute HW breakpoint */
218 hw_read = 1, /* Read HW watchpoint */
219 hw_write = 2, /* Common HW watchpoint */
220 hw_access = 3, /* Access HW watchpoint */
221 point_type_unsupported
224 #define Z_PACKET_SW_BP '0'
225 #define Z_PACKET_HW_BP '1'
226 #define Z_PACKET_WRITE_WP '2'
227 #define Z_PACKET_READ_WP '3'
228 #define Z_PACKET_ACCESS_WP '4'
230 /* Map the protocol breakpoint/watchpoint type TYPE to
231 enum target_point_type. */
233 static enum target_point_type
234 Z_packet_to_point_type (char type)
239 /* Leave the handling of the sw breakpoint with the gdb client. */
240 return point_type_unsupported;
243 case Z_PACKET_WRITE_WP:
245 case Z_PACKET_READ_WP:
247 case Z_PACKET_ACCESS_WP:
250 return point_type_unsupported;
255 aarch64_cannot_store_register (int regno)
257 return regno >= AARCH64_NUM_REGS;
261 aarch64_cannot_fetch_register (int regno)
263 return regno >= AARCH64_NUM_REGS;
267 aarch64_fill_gregset (struct regcache *regcache, void *buf)
269 struct user_pt_regs *regset = buf;
272 for (i = 0; i < AARCH64_X_REGS_NUM; i++)
273 collect_register (regcache, AARCH64_X0_REGNO + i, ®set->regs[i]);
274 collect_register (regcache, AARCH64_SP_REGNO, ®set->sp);
275 collect_register (regcache, AARCH64_PC_REGNO, ®set->pc);
276 collect_register (regcache, AARCH64_CPSR_REGNO, ®set->pstate);
280 aarch64_store_gregset (struct regcache *regcache, const void *buf)
282 const struct user_pt_regs *regset = buf;
285 for (i = 0; i < AARCH64_X_REGS_NUM; i++)
286 supply_register (regcache, AARCH64_X0_REGNO + i, ®set->regs[i]);
287 supply_register (regcache, AARCH64_SP_REGNO, ®set->sp);
288 supply_register (regcache, AARCH64_PC_REGNO, ®set->pc);
289 supply_register (regcache, AARCH64_CPSR_REGNO, ®set->pstate);
293 aarch64_fill_fpregset (struct regcache *regcache, void *buf)
295 struct user_fpsimd_state *regset = buf;
298 for (i = 0; i < AARCH64_V_REGS_NUM; i++)
299 collect_register (regcache, AARCH64_V0_REGNO + i, ®set->vregs[i]);
303 aarch64_store_fpregset (struct regcache *regcache, const void *buf)
305 const struct user_fpsimd_state *regset = buf;
308 for (i = 0; i < AARCH64_V_REGS_NUM; i++)
309 supply_register (regcache, AARCH64_V0_REGNO + i, ®set->vregs[i]);
312 /* Debugging of hardware breakpoint/watchpoint support. */
313 extern int debug_hw_points;
315 /* Enable miscellaneous debugging output. The name is historical - it
316 was originally used to debug LinuxThreads support. */
317 extern int debug_threads;
320 aarch64_get_pc (struct regcache *regcache)
324 collect_register_by_name (regcache, "pc", &pc);
326 fprintf (stderr, "stop pc is %08lx\n", pc);
331 aarch64_set_pc (struct regcache *regcache, CORE_ADDR pc)
333 unsigned long newpc = pc;
334 supply_register_by_name (regcache, "pc", &newpc);
337 /* Correct in either endianness. */
339 #define aarch64_breakpoint_len 4
341 static const unsigned long aarch64_breakpoint = 0x00800011;
344 aarch64_breakpoint_at (CORE_ADDR where)
348 (*the_target->read_memory) (where, (unsigned char *) &insn, 4);
349 if (insn == aarch64_breakpoint)
355 /* Print the values of the cached breakpoint/watchpoint registers.
356 This is enabled via the "set debug-hw-points" monitor command. */
359 aarch64_show_debug_reg_state (struct aarch64_debug_reg_state *state,
360 const char *func, CORE_ADDR addr,
361 int len, enum target_point_type type)
365 fprintf (stderr, "%s", func);
367 fprintf (stderr, " (addr=0x%08lx, len=%d, type=%s)",
368 (unsigned long) addr, len,
369 type == hw_write ? "hw-write-watchpoint"
370 : (type == hw_read ? "hw-read-watchpoint"
371 : (type == hw_access ? "hw-access-watchpoint"
372 : (type == hw_execute ? "hw-breakpoint"
374 fprintf (stderr, ":\n");
376 fprintf (stderr, "\tBREAKPOINTs:\n");
377 for (i = 0; i < aarch64_num_bp_regs; i++)
378 fprintf (stderr, "\tBP%d: addr=0x%s, ctrl=0x%08x, ref.count=%d\n",
379 i, paddress (state->dr_addr_bp[i]),
380 state->dr_ctrl_bp[i], state->dr_ref_count_bp[i]);
382 fprintf (stderr, "\tWATCHPOINTs:\n");
383 for (i = 0; i < aarch64_num_wp_regs; i++)
384 fprintf (stderr, "\tWP%d: addr=0x%s, ctrl=0x%08x, ref.count=%d\n",
385 i, paddress (state->dr_addr_wp[i]),
386 state->dr_ctrl_wp[i], state->dr_ref_count_wp[i]);
390 aarch64_init_debug_reg_state (struct aarch64_debug_reg_state *state)
394 for (i = 0; i < AARCH64_HBP_MAX_NUM; ++i)
396 state->dr_addr_bp[i] = 0;
397 state->dr_ctrl_bp[i] = 0;
398 state->dr_ref_count_bp[i] = 0;
401 for (i = 0; i < AARCH64_HWP_MAX_NUM; ++i)
403 state->dr_addr_wp[i] = 0;
404 state->dr_ctrl_wp[i] = 0;
405 state->dr_ref_count_wp[i] = 0;
409 /* ptrace expects control registers to be formatted as follows:
412 +--------------------------------+----------+------+------+----+
413 | RESERVED (SBZ) | LENGTH | TYPE | PRIV | EN |
414 +--------------------------------+----------+------+------+----+
416 The TYPE field is ignored for breakpoints. */
418 #define DR_CONTROL_ENABLED(ctrl) (((ctrl) & 0x1) == 1)
419 #define DR_CONTROL_LENGTH(ctrl) (((ctrl) >> 5) & 0xff)
421 /* Utility function that returns the length in bytes of a watchpoint
422 according to the content of a hardware debug control register CTRL.
423 Note that the kernel currently only supports the following Byte
424 Address Select (BAS) values: 0x1, 0x3, 0xf and 0xff, which means
425 that for a hardware watchpoint, its valid length can only be 1
426 byte, 2 bytes, 4 bytes or 8 bytes. */
428 static inline unsigned int
429 aarch64_watchpoint_length (unsigned int ctrl)
431 switch (DR_CONTROL_LENGTH (ctrl))
446 /* Given the hardware breakpoint or watchpoint type TYPE and its
447 length LEN, return the expected encoding for a hardware
448 breakpoint/watchpoint control register. */
451 aarch64_point_encode_ctrl_reg (enum target_point_type type, int len)
458 ctrl |= ((1 << len) - 1) << 5;
460 ctrl |= (2 << 1) | 1;
465 /* Addresses to be written to the hardware breakpoint and watchpoint
466 value registers need to be aligned; the alignment is 4-byte and
467 8-type respectively. Linux kernel rejects any non-aligned address
468 it receives from the related ptrace call. Furthermore, the kernel
469 currently only supports the following Byte Address Select (BAS)
470 values: 0x1, 0x3, 0xf and 0xff, which means that for a hardware
471 watchpoint to be accepted by the kernel (via ptrace call), its
472 valid length can only be 1 byte, 2 bytes, 4 bytes or 8 bytes.
473 Despite these limitations, the unaligned watchpoint is supported in
476 Return 0 for any non-compliant ADDR and/or LEN; return 1 otherwise. */
479 aarch64_point_is_aligned (int is_watchpoint, CORE_ADDR addr, int len)
481 unsigned int alignment = is_watchpoint ? AARCH64_HWP_ALIGNMENT
482 : AARCH64_HBP_ALIGNMENT;
484 if (addr & (alignment - 1))
487 if (len != 8 && len != 4 && len != 2 && len != 1)
493 /* Given the (potentially unaligned) watchpoint address in ADDR and
494 length in LEN, return the aligned address and aligned length in
495 *ALIGNED_ADDR_P and *ALIGNED_LEN_P, respectively. The returned
496 aligned address and length will be valid to be written to the
497 hardware watchpoint value and control registers. See the comment
498 above aarch64_point_is_aligned for the information about the
499 alignment requirement. The given watchpoint may get truncated if
500 more than one hardware register is needed to cover the watched
501 region. *NEXT_ADDR_P and *NEXT_LEN_P, if non-NULL, will return the
502 address and length of the remaining part of the watchpoint (which
503 can be processed by calling this routine again to generate another
504 aligned address and length pair.
506 Essentially, unaligned watchpoint is achieved by minimally
507 enlarging the watched area to meet the alignment requirement, and
508 if necessary, splitting the watchpoint over several hardware
509 watchpoint registers. The trade-off is that there will be
510 false-positive hits for the read-type or the access-type hardware
511 watchpoints; for the write type, which is more commonly used, there
512 will be no such issues, as the higher-level breakpoint management
513 in gdb always examines the exact watched region for any content
514 change, and transparently resumes a thread from a watchpoint trap
515 if there is no change to the watched region.
517 Another limitation is that because the watched region is enlarged,
518 the watchpoint fault address returned by
519 aarch64_stopped_data_address may be outside of the original watched
520 region, especially when the triggering instruction is accessing a
521 larger region. When the fault address is not within any known
522 range, watchpoints_triggered in gdb will get confused, as the
523 higher-level watchpoint management is only aware of original
524 watched regions, and will think that some unknown watchpoint has
525 been triggered. In such a case, gdb may stop without displaying
526 any detailed information.
528 Once the kernel provides the full support for Byte Address Select
529 (BAS) in the hardware watchpoint control register, these
530 limitations can be largely relaxed with some further work. */
533 aarch64_align_watchpoint (CORE_ADDR addr, int len, CORE_ADDR *aligned_addr_p,
534 int *aligned_len_p, CORE_ADDR *next_addr_p,
539 CORE_ADDR aligned_addr;
540 const unsigned int alignment = AARCH64_HWP_ALIGNMENT;
541 const unsigned int max_wp_len = AARCH64_HWP_MAX_LEN_PER_REG;
543 /* As assumed by the algorithm. */
544 gdb_assert (alignment == max_wp_len);
549 /* Address to be put into the hardware watchpoint value register
551 offset = addr & (alignment - 1);
552 aligned_addr = addr - offset;
554 gdb_assert (offset >= 0 && offset < alignment);
555 gdb_assert (aligned_addr >= 0 && aligned_addr <= addr);
556 gdb_assert ((offset + len) > 0);
558 if (offset + len >= max_wp_len)
560 /* Need more than one watchpoint registers; truncate it at the
561 alignment boundary. */
562 aligned_len = max_wp_len;
563 len -= (max_wp_len - offset);
564 addr += (max_wp_len - offset);
565 gdb_assert ((addr & (alignment - 1)) == 0);
569 /* Find the smallest valid length that is large enough to
570 accommodate this watchpoint. */
571 static const unsigned char
572 aligned_len_array[AARCH64_HWP_MAX_LEN_PER_REG] =
573 { 1, 2, 4, 4, 8, 8, 8, 8 };
575 aligned_len = aligned_len_array[offset + len - 1];
580 if (aligned_addr_p != NULL)
581 *aligned_addr_p = aligned_addr;
582 if (aligned_len_p != NULL)
583 *aligned_len_p = aligned_len;
584 if (next_addr_p != NULL)
586 if (next_len_p != NULL)
590 /* Call ptrace to set the thread TID's hardware breakpoint/watchpoint
591 registers with data from *STATE. */
594 aarch64_linux_set_debug_regs (const struct aarch64_debug_reg_state *state,
595 int tid, int watchpoint)
599 struct user_hwdebug_state regs;
600 const CORE_ADDR *addr;
601 const unsigned int *ctrl;
603 iov.iov_base = ®s;
604 iov.iov_len = sizeof (regs);
605 count = watchpoint ? aarch64_num_wp_regs : aarch64_num_bp_regs;
606 addr = watchpoint ? state->dr_addr_wp : state->dr_addr_bp;
607 ctrl = watchpoint ? state->dr_ctrl_wp : state->dr_ctrl_bp;
609 for (i = 0; i < count; i++)
611 regs.dbg_regs[i].addr = addr[i];
612 regs.dbg_regs[i].ctrl = ctrl[i];
615 if (ptrace (PTRACE_SETREGSET, tid,
616 watchpoint ? NT_ARM_HW_WATCH : NT_ARM_HW_BREAK,
618 error (_("Unexpected error setting hardware debug registers"));
621 struct aarch64_dr_update_callback_param
628 /* Callback function which records the information about the change of
629 one hardware breakpoint/watchpoint setting for the thread ENTRY.
630 The information is passed in via PTR.
631 N.B. The actual updating of hardware debug registers is not
632 carried out until the moment the thread is resumed. */
635 debug_reg_change_callback (struct inferior_list_entry *entry, void *ptr)
637 struct lwp_info *lwp = (struct lwp_info *) entry;
638 struct aarch64_dr_update_callback_param *param_p
639 = (struct aarch64_dr_update_callback_param *) ptr;
640 int pid = param_p->pid;
641 int idx = param_p->idx;
642 int is_watchpoint = param_p->is_watchpoint;
643 struct arch_lwp_info *info = lwp->arch_private;
644 dr_changed_t *dr_changed_ptr;
645 dr_changed_t dr_changed;
649 fprintf (stderr, "debug_reg_change_callback: \n\tOn entry:\n");
650 fprintf (stderr, "\tpid%d, tid: %ld, dr_changed_bp=0x%llx, "
651 "dr_changed_wp=0x%llx\n",
652 pid, lwpid_of (lwp), info->dr_changed_bp,
653 info->dr_changed_wp);
656 dr_changed_ptr = is_watchpoint ? &info->dr_changed_wp
657 : &info->dr_changed_bp;
658 dr_changed = *dr_changed_ptr;
660 /* Only update the threads of this process. */
661 if (pid_of (lwp) == pid)
664 && (idx <= (is_watchpoint ? aarch64_num_wp_regs
665 : aarch64_num_bp_regs)));
667 /* The following assertion is not right, as there can be changes
668 that have not been made to the hardware debug registers
669 before new changes overwrite the old ones. This can happen,
670 for instance, when the breakpoint/watchpoint hit one of the
671 threads and the user enters continue; then what happens is:
672 1) all breakpoints/watchpoints are removed for all threads;
673 2) a single step is carried out for the thread that was hit;
674 3) all of the points are inserted again for all threads;
675 4) all threads are resumed.
676 The 2nd step will only affect the one thread in which the
677 bp/wp was hit, which means only that one thread is resumed;
678 remember that the actual updating only happen in
679 aarch64_linux_prepare_to_resume, so other threads remain
680 stopped during the removal and insertion of bp/wp. Therefore
681 for those threads, the change of insertion of the bp/wp
682 overwrites that of the earlier removals. (The situation may
683 be different when bp/wp is steppable, or in the non-stop
685 /* gdb_assert (DR_N_HAS_CHANGED (dr_changed, idx) == 0); */
687 /* The actual update is done later just before resuming the lwp,
688 we just mark that one register pair needs updating. */
689 DR_MARK_N_CHANGED (dr_changed, idx);
690 *dr_changed_ptr = dr_changed;
692 /* If the lwp isn't stopped, force it to momentarily pause, so
693 we can update its debug registers. */
695 linux_stop_lwp (lwp);
700 fprintf (stderr, "\tOn exit:\n\tpid%d, tid: %ld, dr_changed_bp=0x%llx, "
701 "dr_changed_wp=0x%llx\n",
702 pid, lwpid_of (lwp), info->dr_changed_bp, info->dr_changed_wp);
708 /* Notify each thread that their IDXth breakpoint/watchpoint register
709 pair needs to be updated. The message will be recorded in each
710 thread's arch-specific data area, the actual updating will be done
711 when the thread is resumed. */
714 aarch64_notify_debug_reg_change (const struct aarch64_debug_reg_state *state,
715 int is_watchpoint, unsigned int idx)
717 struct aarch64_dr_update_callback_param param;
719 /* Only update the threads of this process. */
720 param.pid = pid_of (get_thread_lwp (current_inferior));
722 param.is_watchpoint = is_watchpoint;
725 find_inferior (&all_lwps, debug_reg_change_callback, (void *) ¶m);
729 /* Return the pointer to the debug register state structure in the
730 current process' arch-specific data area. */
732 static struct aarch64_debug_reg_state *
733 aarch64_get_debug_reg_state ()
735 struct process_info *proc;
737 proc = current_process ();
738 return &proc->private->arch_private->debug_reg_state;
741 /* Record the insertion of one breakpoint/watchpoint, as represented
742 by ADDR and CTRL, in the process' arch-specific data area *STATE. */
745 aarch64_dr_state_insert_one_point (struct aarch64_debug_reg_state *state,
746 enum target_point_type type,
747 CORE_ADDR addr, int len)
749 int i, idx, num_regs, is_watchpoint;
750 unsigned int ctrl, *dr_ctrl_p, *dr_ref_count;
751 CORE_ADDR *dr_addr_p;
753 /* Set up state pointers. */
754 is_watchpoint = (type != hw_execute);
755 gdb_assert (aarch64_point_is_aligned (is_watchpoint, addr, len));
758 num_regs = aarch64_num_wp_regs;
759 dr_addr_p = state->dr_addr_wp;
760 dr_ctrl_p = state->dr_ctrl_wp;
761 dr_ref_count = state->dr_ref_count_wp;
765 num_regs = aarch64_num_bp_regs;
766 dr_addr_p = state->dr_addr_bp;
767 dr_ctrl_p = state->dr_ctrl_bp;
768 dr_ref_count = state->dr_ref_count_bp;
771 ctrl = aarch64_point_encode_ctrl_reg (type, len);
773 /* Find an existing or free register in our cache. */
775 for (i = 0; i < num_regs; ++i)
777 if ((dr_ctrl_p[i] & 1) == 0)
779 gdb_assert (dr_ref_count[i] == 0);
781 /* no break; continue hunting for an exising one. */
783 else if (dr_addr_p[i] == addr && dr_ctrl_p[i] == ctrl)
785 gdb_assert (dr_ref_count[i] != 0);
795 /* Update our cache. */
796 if ((dr_ctrl_p[idx] & 1) == 0)
799 dr_addr_p[idx] = addr;
800 dr_ctrl_p[idx] = ctrl;
801 dr_ref_count[idx] = 1;
802 /* Notify the change. */
803 aarch64_notify_debug_reg_change (state, is_watchpoint, idx);
814 /* Record the removal of one breakpoint/watchpoint, as represented by
815 ADDR and CTRL, in the process' arch-specific data area *STATE. */
818 aarch64_dr_state_remove_one_point (struct aarch64_debug_reg_state *state,
819 enum target_point_type type,
820 CORE_ADDR addr, int len)
822 int i, num_regs, is_watchpoint;
823 unsigned int ctrl, *dr_ctrl_p, *dr_ref_count;
824 CORE_ADDR *dr_addr_p;
826 /* Set up state pointers. */
827 is_watchpoint = (type != hw_execute);
828 gdb_assert (aarch64_point_is_aligned (is_watchpoint, addr, len));
831 num_regs = aarch64_num_wp_regs;
832 dr_addr_p = state->dr_addr_wp;
833 dr_ctrl_p = state->dr_ctrl_wp;
834 dr_ref_count = state->dr_ref_count_wp;
838 num_regs = aarch64_num_bp_regs;
839 dr_addr_p = state->dr_addr_bp;
840 dr_ctrl_p = state->dr_ctrl_bp;
841 dr_ref_count = state->dr_ref_count_bp;
844 ctrl = aarch64_point_encode_ctrl_reg (type, len);
846 /* Find the entry that matches the ADDR and CTRL. */
847 for (i = 0; i < num_regs; ++i)
848 if (dr_addr_p[i] == addr && dr_ctrl_p[i] == ctrl)
850 gdb_assert (dr_ref_count[i] != 0);
858 /* Clear our cache. */
859 if (--dr_ref_count[i] == 0)
861 /* Clear the enable bit. */
865 /* Notify the change. */
866 aarch64_notify_debug_reg_change (state, is_watchpoint, i);
873 aarch64_handle_breakpoint (enum target_point_type type, CORE_ADDR addr,
874 int len, int is_insert)
876 struct aarch64_debug_reg_state *state;
878 /* The hardware breakpoint on AArch64 should always be 4-byte
880 if (!aarch64_point_is_aligned (0 /* is_watchpoint */ , addr, len))
883 state = aarch64_get_debug_reg_state ();
886 return aarch64_dr_state_insert_one_point (state, type, addr, len);
888 return aarch64_dr_state_remove_one_point (state, type, addr, len);
891 /* This is essentially the same as aarch64_handle_breakpoint, apart
892 from that it is an aligned watchpoint to be handled. */
895 aarch64_handle_aligned_watchpoint (enum target_point_type type,
896 CORE_ADDR addr, int len, int is_insert)
898 struct aarch64_debug_reg_state *state;
900 state = aarch64_get_debug_reg_state ();
903 return aarch64_dr_state_insert_one_point (state, type, addr, len);
905 return aarch64_dr_state_remove_one_point (state, type, addr, len);
908 /* Insert/remove unaligned watchpoint by calling
909 aarch64_align_watchpoint repeatedly until the whole watched region,
910 as represented by ADDR and LEN, has been properly aligned and ready
911 to be written to one or more hardware watchpoint registers.
912 IS_INSERT indicates whether this is an insertion or a deletion.
913 Return 0 if succeed. */
916 aarch64_handle_unaligned_watchpoint (enum target_point_type type,
917 CORE_ADDR addr, int len, int is_insert)
919 struct aarch64_debug_reg_state *state
920 = aarch64_get_debug_reg_state ();
924 CORE_ADDR aligned_addr;
925 int aligned_len, ret;
927 aarch64_align_watchpoint (addr, len, &aligned_addr, &aligned_len,
931 ret = aarch64_dr_state_insert_one_point (state, type, aligned_addr,
934 ret = aarch64_dr_state_remove_one_point (state, type, aligned_addr,
939 "handle_unaligned_watchpoint: is_insert: %d\n"
940 " aligned_addr: 0x%s, aligned_len: %d\n"
941 " next_addr: 0x%s, next_len: %d\n",
942 is_insert, paddress (aligned_addr), aligned_len,
943 paddress (addr), len);
953 aarch64_handle_watchpoint (enum target_point_type type, CORE_ADDR addr,
954 int len, int is_insert)
956 if (aarch64_point_is_aligned (1 /* is_watchpoint */ , addr, len))
957 return aarch64_handle_aligned_watchpoint (type, addr, len, is_insert);
959 return aarch64_handle_unaligned_watchpoint (type, addr, len, is_insert);
962 /* Insert a hardware breakpoint/watchpoint.
963 It actually only records the info of the to-be-inserted bp/wp;
964 the actual insertion will happen when threads are resumed.
967 Return 1 if TYPE is unsupported type;
968 Return -1 if an error occurs. */
971 aarch64_insert_point (char type, CORE_ADDR addr, int len)
974 enum target_point_type targ_type;
977 fprintf (stderr, "insert_point on entry (addr=0x%08lx, len=%d)\n",
978 (unsigned long) addr, len);
980 /* Determine the type from the packet. */
981 targ_type = Z_packet_to_point_type (type);
982 if (targ_type == point_type_unsupported)
985 if (targ_type != hw_execute)
987 aarch64_handle_watchpoint (targ_type, addr, len, 1 /* is_insert */);
990 aarch64_handle_breakpoint (targ_type, addr, len, 1 /* is_insert */);
992 if (debug_hw_points > 1)
993 aarch64_show_debug_reg_state (aarch64_get_debug_reg_state (),
994 "insert_point", addr, len, targ_type);
999 /* Remove a hardware breakpoint/watchpoint.
1000 It actually only records the info of the to-be-removed bp/wp,
1001 the actual removal will be done when threads are resumed.
1003 Return 0 if succeed;
1004 Return 1 if TYPE is an unsupported type;
1005 Return -1 if an error occurs. */
1008 aarch64_remove_point (char type, CORE_ADDR addr, int len)
1011 enum target_point_type targ_type;
1013 if (debug_hw_points)
1014 fprintf (stderr, "remove_point on entry (addr=0x%08lx, len=%d)\n",
1015 (unsigned long) addr, len);
1017 /* Determine the type from the packet. */
1018 targ_type = Z_packet_to_point_type (type);
1019 if (targ_type == point_type_unsupported)
1022 /* Set up state pointers. */
1023 if (targ_type != hw_execute)
1025 aarch64_handle_watchpoint (targ_type, addr, len, 0 /* is_insert */);
1028 aarch64_handle_breakpoint (targ_type, addr, len, 0 /* is_insert */);
1030 if (debug_hw_points > 1)
1031 aarch64_show_debug_reg_state (aarch64_get_debug_reg_state (),
1032 "remove_point", addr, len, targ_type);
1037 /* Returns the address associated with the watchpoint that hit, if
1038 any; returns 0 otherwise. */
1041 aarch64_stopped_data_address (void)
1045 struct aarch64_debug_reg_state *state;
1047 pid = lwpid_of (get_thread_lwp (current_inferior));
1049 /* Get the siginfo. */
1050 if (ptrace (PTRACE_GETSIGINFO, pid, NULL, &siginfo) != 0)
1051 return (CORE_ADDR) 0;
1053 /* Need to be a hardware breakpoint/watchpoint trap. */
1054 if (siginfo.si_signo != SIGTRAP
1055 || (siginfo.si_code & 0xffff) != 0x0004 /* TRAP_HWBKPT */)
1056 return (CORE_ADDR) 0;
1058 /* Check if the address matches any watched address. */
1059 state = aarch64_get_debug_reg_state ();
1060 for (i = aarch64_num_wp_regs - 1; i >= 0; --i)
1062 const unsigned int len = aarch64_watchpoint_length (state->dr_ctrl_wp[i]);
1063 const CORE_ADDR addr_trap = (CORE_ADDR) siginfo.si_addr;
1064 const CORE_ADDR addr_watch = state->dr_addr_wp[i];
1065 if (state->dr_ref_count_wp[i]
1066 && DR_CONTROL_ENABLED (state->dr_ctrl_wp[i])
1067 && addr_trap >= addr_watch
1068 && addr_trap < addr_watch + len)
1072 return (CORE_ADDR) 0;
1075 /* Returns 1 if target was stopped due to a watchpoint hit, 0
1079 aarch64_stopped_by_watchpoint (void)
1081 if (aarch64_stopped_data_address () != 0)
1087 /* Fetch the thread-local storage pointer for libthread_db. */
1090 ps_get_thread_area (const struct ps_prochandle *ph,
1091 lwpid_t lwpid, int idx, void **base)
1096 iovec.iov_base = ®
1097 iovec.iov_len = sizeof (reg);
1099 if (ptrace (PTRACE_GETREGSET, lwpid, NT_ARM_TLS, &iovec) != 0)
1102 /* IDX is the bias from the thread pointer to the beginning of the
1103 thread descriptor. It has to be subtracted due to implementation
1104 quirks in libthread_db. */
1105 *base = (void *) (reg - idx);
1110 /* Called when a new process is created. */
1112 static struct arch_process_info *
1113 aarch64_linux_new_process (void)
1115 struct arch_process_info *info = xcalloc (1, sizeof (*info));
1117 aarch64_init_debug_reg_state (&info->debug_reg_state);
1122 /* Called when a new thread is detected. */
1124 static struct arch_lwp_info *
1125 aarch64_linux_new_thread (void)
1127 struct arch_lwp_info *info = xcalloc (1, sizeof (*info));
1129 /* Mark that all the hardware breakpoint/watchpoint register pairs
1130 for this thread need to be initialized (with data from
1131 aarch_process_info.debug_reg_state). */
1132 DR_MARK_ALL_CHANGED (info->dr_changed_bp, aarch64_num_bp_regs);
1133 DR_MARK_ALL_CHANGED (info->dr_changed_wp, aarch64_num_wp_regs);
1138 /* Called when resuming a thread.
1139 If the debug regs have changed, update the thread's copies. */
1142 aarch64_linux_prepare_to_resume (struct lwp_info *lwp)
1144 ptid_t ptid = ptid_of (lwp);
1145 struct arch_lwp_info *info = lwp->arch_private;
1147 if (DR_HAS_CHANGED (info->dr_changed_bp)
1148 || DR_HAS_CHANGED (info->dr_changed_wp))
1150 int tid = ptid_get_lwp (ptid);
1151 struct process_info *proc = find_process_pid (ptid_get_pid (ptid));
1152 struct aarch64_debug_reg_state *state
1153 = &proc->private->arch_private->debug_reg_state;
1155 if (debug_hw_points)
1156 fprintf (stderr, "prepare_to_resume thread %ld\n", lwpid_of (lwp));
1159 if (DR_HAS_CHANGED (info->dr_changed_wp))
1161 aarch64_linux_set_debug_regs (state, tid, 1);
1162 DR_CLEAR_CHANGED (info->dr_changed_wp);
1166 if (DR_HAS_CHANGED (info->dr_changed_bp))
1168 aarch64_linux_set_debug_regs (state, tid, 0);
1169 DR_CLEAR_CHANGED (info->dr_changed_bp);
1174 /* ptrace hardware breakpoint resource info is formatted as follows:
1177 +---------------+--------------+---------------+---------------+
1178 | RESERVED | RESERVED | DEBUG_ARCH | NUM_SLOTS |
1179 +---------------+--------------+---------------+---------------+ */
1181 #define AARCH64_DEBUG_NUM_SLOTS(x) ((x) & 0xff)
1182 #define AARCH64_DEBUG_ARCH(x) (((x) >> 8) & 0xff)
1183 #define AARCH64_DEBUG_ARCH_V8 0x6
1186 aarch64_arch_setup (void)
1190 struct user_hwdebug_state dreg_state;
1192 current_process ()->tdesc = tdesc_aarch64;
1194 pid = lwpid_of (get_thread_lwp (current_inferior));
1195 iov.iov_base = &dreg_state;
1196 iov.iov_len = sizeof (dreg_state);
1198 /* Get hardware watchpoint register info. */
1199 if (ptrace (PTRACE_GETREGSET, pid, NT_ARM_HW_WATCH, &iov) == 0
1200 && AARCH64_DEBUG_ARCH (dreg_state.dbg_info) == AARCH64_DEBUG_ARCH_V8)
1202 aarch64_num_wp_regs = AARCH64_DEBUG_NUM_SLOTS (dreg_state.dbg_info);
1203 if (aarch64_num_wp_regs > AARCH64_HWP_MAX_NUM)
1205 warning ("Unexpected number of hardware watchpoint registers reported"
1206 " by ptrace, got %d, expected %d.",
1207 aarch64_num_wp_regs, AARCH64_HWP_MAX_NUM);
1208 aarch64_num_wp_regs = AARCH64_HWP_MAX_NUM;
1213 warning ("Unable to determine the number of hardware watchpoints"
1215 aarch64_num_wp_regs = 0;
1218 /* Get hardware breakpoint register info. */
1219 if (ptrace (PTRACE_GETREGSET, pid, NT_ARM_HW_BREAK, &iov) == 0
1220 && AARCH64_DEBUG_ARCH (dreg_state.dbg_info) == AARCH64_DEBUG_ARCH_V8)
1222 aarch64_num_bp_regs = AARCH64_DEBUG_NUM_SLOTS (dreg_state.dbg_info);
1223 if (aarch64_num_bp_regs > AARCH64_HBP_MAX_NUM)
1225 warning ("Unexpected number of hardware breakpoint registers reported"
1226 " by ptrace, got %d, expected %d.",
1227 aarch64_num_bp_regs, AARCH64_HBP_MAX_NUM);
1228 aarch64_num_bp_regs = AARCH64_HBP_MAX_NUM;
1233 warning ("Unable to determine the number of hardware breakpoints"
1235 aarch64_num_bp_regs = 0;
1239 static struct regset_info aarch64_regsets[] =
1241 { PTRACE_GETREGSET, PTRACE_SETREGSET, NT_PRSTATUS,
1242 sizeof (struct user_pt_regs), GENERAL_REGS,
1243 aarch64_fill_gregset, aarch64_store_gregset },
1244 { PTRACE_GETREGSET, PTRACE_SETREGSET, NT_FPREGSET,
1245 sizeof (struct user_fpsimd_state), FP_REGS,
1246 aarch64_fill_fpregset, aarch64_store_fpregset
1248 { 0, 0, 0, -1, -1, NULL, NULL }
1251 static struct regsets_info aarch64_regsets_info =
1253 aarch64_regsets, /* regsets */
1254 0, /* num_regsets */
1255 NULL, /* disabled_regsets */
1258 static struct usrregs_info aarch64_usrregs_info =
1264 static struct regs_info regs_info =
1266 NULL, /* regset_bitmap */
1267 &aarch64_usrregs_info,
1268 &aarch64_regsets_info,
1271 static const struct regs_info *
1272 aarch64_regs_info (void)
1277 struct linux_target_ops the_low_target =
1281 aarch64_cannot_fetch_register,
1282 aarch64_cannot_store_register,
1286 (const unsigned char *) &aarch64_breakpoint,
1287 aarch64_breakpoint_len,
1290 aarch64_breakpoint_at,
1291 aarch64_insert_point,
1292 aarch64_remove_point,
1293 aarch64_stopped_by_watchpoint,
1294 aarch64_stopped_data_address,
1298 aarch64_linux_new_process,
1299 aarch64_linux_new_thread,
1300 aarch64_linux_prepare_to_resume,
1304 initialize_low_arch (void)
1306 init_registers_aarch64 ();
1308 initialize_regsets_info (&aarch64_regsets_info);