Linux 4.19-rc7
[linux-2.6/btrfs-unstable.git] / arch / arm64 / kernel / hw_breakpoint.c
blob8c9644376326fe96f05645d298c1b4fcd383d652
1 /*
2 * HW_breakpoint: a unified kernel/user-space hardware breakpoint facility,
3 * using the CPU's debug registers.
5 * Copyright (C) 2012 ARM Limited
6 * Author: Will Deacon <will.deacon@arm.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
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.
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/>.
21 #define pr_fmt(fmt) "hw-breakpoint: " fmt
23 #include <linux/compat.h>
24 #include <linux/cpu_pm.h>
25 #include <linux/errno.h>
26 #include <linux/hw_breakpoint.h>
27 #include <linux/kprobes.h>
28 #include <linux/perf_event.h>
29 #include <linux/ptrace.h>
30 #include <linux/smp.h>
31 #include <linux/uaccess.h>
33 #include <asm/current.h>
34 #include <asm/debug-monitors.h>
35 #include <asm/hw_breakpoint.h>
36 #include <asm/traps.h>
37 #include <asm/cputype.h>
38 #include <asm/system_misc.h>
40 /* Breakpoint currently in use for each BRP. */
41 static DEFINE_PER_CPU(struct perf_event *, bp_on_reg[ARM_MAX_BRP]);
43 /* Watchpoint currently in use for each WRP. */
44 static DEFINE_PER_CPU(struct perf_event *, wp_on_reg[ARM_MAX_WRP]);
46 /* Currently stepping a per-CPU kernel breakpoint. */
47 static DEFINE_PER_CPU(int, stepping_kernel_bp);
49 /* Number of BRP/WRP registers on this CPU. */
50 static int core_num_brps;
51 static int core_num_wrps;
53 int hw_breakpoint_slots(int type)
56 * We can be called early, so don't rely on
57 * our static variables being initialised.
59 switch (type) {
60 case TYPE_INST:
61 return get_num_brps();
62 case TYPE_DATA:
63 return get_num_wrps();
64 default:
65 pr_warning("unknown slot type: %d\n", type);
66 return 0;
70 #define READ_WB_REG_CASE(OFF, N, REG, VAL) \
71 case (OFF + N): \
72 AARCH64_DBG_READ(N, REG, VAL); \
73 break
75 #define WRITE_WB_REG_CASE(OFF, N, REG, VAL) \
76 case (OFF + N): \
77 AARCH64_DBG_WRITE(N, REG, VAL); \
78 break
80 #define GEN_READ_WB_REG_CASES(OFF, REG, VAL) \
81 READ_WB_REG_CASE(OFF, 0, REG, VAL); \
82 READ_WB_REG_CASE(OFF, 1, REG, VAL); \
83 READ_WB_REG_CASE(OFF, 2, REG, VAL); \
84 READ_WB_REG_CASE(OFF, 3, REG, VAL); \
85 READ_WB_REG_CASE(OFF, 4, REG, VAL); \
86 READ_WB_REG_CASE(OFF, 5, REG, VAL); \
87 READ_WB_REG_CASE(OFF, 6, REG, VAL); \
88 READ_WB_REG_CASE(OFF, 7, REG, VAL); \
89 READ_WB_REG_CASE(OFF, 8, REG, VAL); \
90 READ_WB_REG_CASE(OFF, 9, REG, VAL); \
91 READ_WB_REG_CASE(OFF, 10, REG, VAL); \
92 READ_WB_REG_CASE(OFF, 11, REG, VAL); \
93 READ_WB_REG_CASE(OFF, 12, REG, VAL); \
94 READ_WB_REG_CASE(OFF, 13, REG, VAL); \
95 READ_WB_REG_CASE(OFF, 14, REG, VAL); \
96 READ_WB_REG_CASE(OFF, 15, REG, VAL)
98 #define GEN_WRITE_WB_REG_CASES(OFF, REG, VAL) \
99 WRITE_WB_REG_CASE(OFF, 0, REG, VAL); \
100 WRITE_WB_REG_CASE(OFF, 1, REG, VAL); \
101 WRITE_WB_REG_CASE(OFF, 2, REG, VAL); \
102 WRITE_WB_REG_CASE(OFF, 3, REG, VAL); \
103 WRITE_WB_REG_CASE(OFF, 4, REG, VAL); \
104 WRITE_WB_REG_CASE(OFF, 5, REG, VAL); \
105 WRITE_WB_REG_CASE(OFF, 6, REG, VAL); \
106 WRITE_WB_REG_CASE(OFF, 7, REG, VAL); \
107 WRITE_WB_REG_CASE(OFF, 8, REG, VAL); \
108 WRITE_WB_REG_CASE(OFF, 9, REG, VAL); \
109 WRITE_WB_REG_CASE(OFF, 10, REG, VAL); \
110 WRITE_WB_REG_CASE(OFF, 11, REG, VAL); \
111 WRITE_WB_REG_CASE(OFF, 12, REG, VAL); \
112 WRITE_WB_REG_CASE(OFF, 13, REG, VAL); \
113 WRITE_WB_REG_CASE(OFF, 14, REG, VAL); \
114 WRITE_WB_REG_CASE(OFF, 15, REG, VAL)
116 static u64 read_wb_reg(int reg, int n)
118 u64 val = 0;
120 switch (reg + n) {
121 GEN_READ_WB_REG_CASES(AARCH64_DBG_REG_BVR, AARCH64_DBG_REG_NAME_BVR, val);
122 GEN_READ_WB_REG_CASES(AARCH64_DBG_REG_BCR, AARCH64_DBG_REG_NAME_BCR, val);
123 GEN_READ_WB_REG_CASES(AARCH64_DBG_REG_WVR, AARCH64_DBG_REG_NAME_WVR, val);
124 GEN_READ_WB_REG_CASES(AARCH64_DBG_REG_WCR, AARCH64_DBG_REG_NAME_WCR, val);
125 default:
126 pr_warning("attempt to read from unknown breakpoint register %d\n", n);
129 return val;
131 NOKPROBE_SYMBOL(read_wb_reg);
133 static void write_wb_reg(int reg, int n, u64 val)
135 switch (reg + n) {
136 GEN_WRITE_WB_REG_CASES(AARCH64_DBG_REG_BVR, AARCH64_DBG_REG_NAME_BVR, val);
137 GEN_WRITE_WB_REG_CASES(AARCH64_DBG_REG_BCR, AARCH64_DBG_REG_NAME_BCR, val);
138 GEN_WRITE_WB_REG_CASES(AARCH64_DBG_REG_WVR, AARCH64_DBG_REG_NAME_WVR, val);
139 GEN_WRITE_WB_REG_CASES(AARCH64_DBG_REG_WCR, AARCH64_DBG_REG_NAME_WCR, val);
140 default:
141 pr_warning("attempt to write to unknown breakpoint register %d\n", n);
143 isb();
145 NOKPROBE_SYMBOL(write_wb_reg);
148 * Convert a breakpoint privilege level to the corresponding exception
149 * level.
151 static enum dbg_active_el debug_exception_level(int privilege)
153 switch (privilege) {
154 case AARCH64_BREAKPOINT_EL0:
155 return DBG_ACTIVE_EL0;
156 case AARCH64_BREAKPOINT_EL1:
157 return DBG_ACTIVE_EL1;
158 default:
159 pr_warning("invalid breakpoint privilege level %d\n", privilege);
160 return -EINVAL;
163 NOKPROBE_SYMBOL(debug_exception_level);
165 enum hw_breakpoint_ops {
166 HW_BREAKPOINT_INSTALL,
167 HW_BREAKPOINT_UNINSTALL,
168 HW_BREAKPOINT_RESTORE
171 static int is_compat_bp(struct perf_event *bp)
173 struct task_struct *tsk = bp->hw.target;
176 * tsk can be NULL for per-cpu (non-ptrace) breakpoints.
177 * In this case, use the native interface, since we don't have
178 * the notion of a "compat CPU" and could end up relying on
179 * deprecated behaviour if we use unaligned watchpoints in
180 * AArch64 state.
182 return tsk && is_compat_thread(task_thread_info(tsk));
186 * hw_breakpoint_slot_setup - Find and setup a perf slot according to
187 * operations
189 * @slots: pointer to array of slots
190 * @max_slots: max number of slots
191 * @bp: perf_event to setup
192 * @ops: operation to be carried out on the slot
194 * Return:
195 * slot index on success
196 * -ENOSPC if no slot is available/matches
197 * -EINVAL on wrong operations parameter
199 static int hw_breakpoint_slot_setup(struct perf_event **slots, int max_slots,
200 struct perf_event *bp,
201 enum hw_breakpoint_ops ops)
203 int i;
204 struct perf_event **slot;
206 for (i = 0; i < max_slots; ++i) {
207 slot = &slots[i];
208 switch (ops) {
209 case HW_BREAKPOINT_INSTALL:
210 if (!*slot) {
211 *slot = bp;
212 return i;
214 break;
215 case HW_BREAKPOINT_UNINSTALL:
216 if (*slot == bp) {
217 *slot = NULL;
218 return i;
220 break;
221 case HW_BREAKPOINT_RESTORE:
222 if (*slot == bp)
223 return i;
224 break;
225 default:
226 pr_warn_once("Unhandled hw breakpoint ops %d\n", ops);
227 return -EINVAL;
230 return -ENOSPC;
233 static int hw_breakpoint_control(struct perf_event *bp,
234 enum hw_breakpoint_ops ops)
236 struct arch_hw_breakpoint *info = counter_arch_bp(bp);
237 struct perf_event **slots;
238 struct debug_info *debug_info = &current->thread.debug;
239 int i, max_slots, ctrl_reg, val_reg, reg_enable;
240 enum dbg_active_el dbg_el = debug_exception_level(info->ctrl.privilege);
241 u32 ctrl;
243 if (info->ctrl.type == ARM_BREAKPOINT_EXECUTE) {
244 /* Breakpoint */
245 ctrl_reg = AARCH64_DBG_REG_BCR;
246 val_reg = AARCH64_DBG_REG_BVR;
247 slots = this_cpu_ptr(bp_on_reg);
248 max_slots = core_num_brps;
249 reg_enable = !debug_info->bps_disabled;
250 } else {
251 /* Watchpoint */
252 ctrl_reg = AARCH64_DBG_REG_WCR;
253 val_reg = AARCH64_DBG_REG_WVR;
254 slots = this_cpu_ptr(wp_on_reg);
255 max_slots = core_num_wrps;
256 reg_enable = !debug_info->wps_disabled;
259 i = hw_breakpoint_slot_setup(slots, max_slots, bp, ops);
261 if (WARN_ONCE(i < 0, "Can't find any breakpoint slot"))
262 return i;
264 switch (ops) {
265 case HW_BREAKPOINT_INSTALL:
267 * Ensure debug monitors are enabled at the correct exception
268 * level.
270 enable_debug_monitors(dbg_el);
271 /* Fall through */
272 case HW_BREAKPOINT_RESTORE:
273 /* Setup the address register. */
274 write_wb_reg(val_reg, i, info->address);
276 /* Setup the control register. */
277 ctrl = encode_ctrl_reg(info->ctrl);
278 write_wb_reg(ctrl_reg, i,
279 reg_enable ? ctrl | 0x1 : ctrl & ~0x1);
280 break;
281 case HW_BREAKPOINT_UNINSTALL:
282 /* Reset the control register. */
283 write_wb_reg(ctrl_reg, i, 0);
286 * Release the debug monitors for the correct exception
287 * level.
289 disable_debug_monitors(dbg_el);
290 break;
293 return 0;
297 * Install a perf counter breakpoint.
299 int arch_install_hw_breakpoint(struct perf_event *bp)
301 return hw_breakpoint_control(bp, HW_BREAKPOINT_INSTALL);
304 void arch_uninstall_hw_breakpoint(struct perf_event *bp)
306 hw_breakpoint_control(bp, HW_BREAKPOINT_UNINSTALL);
309 static int get_hbp_len(u8 hbp_len)
311 unsigned int len_in_bytes = 0;
313 switch (hbp_len) {
314 case ARM_BREAKPOINT_LEN_1:
315 len_in_bytes = 1;
316 break;
317 case ARM_BREAKPOINT_LEN_2:
318 len_in_bytes = 2;
319 break;
320 case ARM_BREAKPOINT_LEN_3:
321 len_in_bytes = 3;
322 break;
323 case ARM_BREAKPOINT_LEN_4:
324 len_in_bytes = 4;
325 break;
326 case ARM_BREAKPOINT_LEN_5:
327 len_in_bytes = 5;
328 break;
329 case ARM_BREAKPOINT_LEN_6:
330 len_in_bytes = 6;
331 break;
332 case ARM_BREAKPOINT_LEN_7:
333 len_in_bytes = 7;
334 break;
335 case ARM_BREAKPOINT_LEN_8:
336 len_in_bytes = 8;
337 break;
340 return len_in_bytes;
344 * Check whether bp virtual address is in kernel space.
346 int arch_check_bp_in_kernelspace(struct arch_hw_breakpoint *hw)
348 unsigned int len;
349 unsigned long va;
351 va = hw->address;
352 len = get_hbp_len(hw->ctrl.len);
354 return (va >= TASK_SIZE) && ((va + len - 1) >= TASK_SIZE);
358 * Extract generic type and length encodings from an arch_hw_breakpoint_ctrl.
359 * Hopefully this will disappear when ptrace can bypass the conversion
360 * to generic breakpoint descriptions.
362 int arch_bp_generic_fields(struct arch_hw_breakpoint_ctrl ctrl,
363 int *gen_len, int *gen_type, int *offset)
365 /* Type */
366 switch (ctrl.type) {
367 case ARM_BREAKPOINT_EXECUTE:
368 *gen_type = HW_BREAKPOINT_X;
369 break;
370 case ARM_BREAKPOINT_LOAD:
371 *gen_type = HW_BREAKPOINT_R;
372 break;
373 case ARM_BREAKPOINT_STORE:
374 *gen_type = HW_BREAKPOINT_W;
375 break;
376 case ARM_BREAKPOINT_LOAD | ARM_BREAKPOINT_STORE:
377 *gen_type = HW_BREAKPOINT_RW;
378 break;
379 default:
380 return -EINVAL;
383 if (!ctrl.len)
384 return -EINVAL;
385 *offset = __ffs(ctrl.len);
387 /* Len */
388 switch (ctrl.len >> *offset) {
389 case ARM_BREAKPOINT_LEN_1:
390 *gen_len = HW_BREAKPOINT_LEN_1;
391 break;
392 case ARM_BREAKPOINT_LEN_2:
393 *gen_len = HW_BREAKPOINT_LEN_2;
394 break;
395 case ARM_BREAKPOINT_LEN_3:
396 *gen_len = HW_BREAKPOINT_LEN_3;
397 break;
398 case ARM_BREAKPOINT_LEN_4:
399 *gen_len = HW_BREAKPOINT_LEN_4;
400 break;
401 case ARM_BREAKPOINT_LEN_5:
402 *gen_len = HW_BREAKPOINT_LEN_5;
403 break;
404 case ARM_BREAKPOINT_LEN_6:
405 *gen_len = HW_BREAKPOINT_LEN_6;
406 break;
407 case ARM_BREAKPOINT_LEN_7:
408 *gen_len = HW_BREAKPOINT_LEN_7;
409 break;
410 case ARM_BREAKPOINT_LEN_8:
411 *gen_len = HW_BREAKPOINT_LEN_8;
412 break;
413 default:
414 return -EINVAL;
417 return 0;
421 * Construct an arch_hw_breakpoint from a perf_event.
423 static int arch_build_bp_info(struct perf_event *bp,
424 const struct perf_event_attr *attr,
425 struct arch_hw_breakpoint *hw)
427 /* Type */
428 switch (attr->bp_type) {
429 case HW_BREAKPOINT_X:
430 hw->ctrl.type = ARM_BREAKPOINT_EXECUTE;
431 break;
432 case HW_BREAKPOINT_R:
433 hw->ctrl.type = ARM_BREAKPOINT_LOAD;
434 break;
435 case HW_BREAKPOINT_W:
436 hw->ctrl.type = ARM_BREAKPOINT_STORE;
437 break;
438 case HW_BREAKPOINT_RW:
439 hw->ctrl.type = ARM_BREAKPOINT_LOAD | ARM_BREAKPOINT_STORE;
440 break;
441 default:
442 return -EINVAL;
445 /* Len */
446 switch (attr->bp_len) {
447 case HW_BREAKPOINT_LEN_1:
448 hw->ctrl.len = ARM_BREAKPOINT_LEN_1;
449 break;
450 case HW_BREAKPOINT_LEN_2:
451 hw->ctrl.len = ARM_BREAKPOINT_LEN_2;
452 break;
453 case HW_BREAKPOINT_LEN_3:
454 hw->ctrl.len = ARM_BREAKPOINT_LEN_3;
455 break;
456 case HW_BREAKPOINT_LEN_4:
457 hw->ctrl.len = ARM_BREAKPOINT_LEN_4;
458 break;
459 case HW_BREAKPOINT_LEN_5:
460 hw->ctrl.len = ARM_BREAKPOINT_LEN_5;
461 break;
462 case HW_BREAKPOINT_LEN_6:
463 hw->ctrl.len = ARM_BREAKPOINT_LEN_6;
464 break;
465 case HW_BREAKPOINT_LEN_7:
466 hw->ctrl.len = ARM_BREAKPOINT_LEN_7;
467 break;
468 case HW_BREAKPOINT_LEN_8:
469 hw->ctrl.len = ARM_BREAKPOINT_LEN_8;
470 break;
471 default:
472 return -EINVAL;
476 * On AArch64, we only permit breakpoints of length 4, whereas
477 * AArch32 also requires breakpoints of length 2 for Thumb.
478 * Watchpoints can be of length 1, 2, 4 or 8 bytes.
480 if (hw->ctrl.type == ARM_BREAKPOINT_EXECUTE) {
481 if (is_compat_bp(bp)) {
482 if (hw->ctrl.len != ARM_BREAKPOINT_LEN_2 &&
483 hw->ctrl.len != ARM_BREAKPOINT_LEN_4)
484 return -EINVAL;
485 } else if (hw->ctrl.len != ARM_BREAKPOINT_LEN_4) {
487 * FIXME: Some tools (I'm looking at you perf) assume
488 * that breakpoints should be sizeof(long). This
489 * is nonsense. For now, we fix up the parameter
490 * but we should probably return -EINVAL instead.
492 hw->ctrl.len = ARM_BREAKPOINT_LEN_4;
496 /* Address */
497 hw->address = attr->bp_addr;
500 * Privilege
501 * Note that we disallow combined EL0/EL1 breakpoints because
502 * that would complicate the stepping code.
504 if (arch_check_bp_in_kernelspace(hw))
505 hw->ctrl.privilege = AARCH64_BREAKPOINT_EL1;
506 else
507 hw->ctrl.privilege = AARCH64_BREAKPOINT_EL0;
509 /* Enabled? */
510 hw->ctrl.enabled = !attr->disabled;
512 return 0;
516 * Validate the arch-specific HW Breakpoint register settings.
518 int hw_breakpoint_arch_parse(struct perf_event *bp,
519 const struct perf_event_attr *attr,
520 struct arch_hw_breakpoint *hw)
522 int ret;
523 u64 alignment_mask, offset;
525 /* Build the arch_hw_breakpoint. */
526 ret = arch_build_bp_info(bp, attr, hw);
527 if (ret)
528 return ret;
531 * Check address alignment.
532 * We don't do any clever alignment correction for watchpoints
533 * because using 64-bit unaligned addresses is deprecated for
534 * AArch64.
536 * AArch32 tasks expect some simple alignment fixups, so emulate
537 * that here.
539 if (is_compat_bp(bp)) {
540 if (hw->ctrl.len == ARM_BREAKPOINT_LEN_8)
541 alignment_mask = 0x7;
542 else
543 alignment_mask = 0x3;
544 offset = hw->address & alignment_mask;
545 switch (offset) {
546 case 0:
547 /* Aligned */
548 break;
549 case 1:
550 /* Allow single byte watchpoint. */
551 if (hw->ctrl.len == ARM_BREAKPOINT_LEN_1)
552 break;
553 case 2:
554 /* Allow halfword watchpoints and breakpoints. */
555 if (hw->ctrl.len == ARM_BREAKPOINT_LEN_2)
556 break;
557 default:
558 return -EINVAL;
560 } else {
561 if (hw->ctrl.type == ARM_BREAKPOINT_EXECUTE)
562 alignment_mask = 0x3;
563 else
564 alignment_mask = 0x7;
565 offset = hw->address & alignment_mask;
568 hw->address &= ~alignment_mask;
569 hw->ctrl.len <<= offset;
572 * Disallow per-task kernel breakpoints since these would
573 * complicate the stepping code.
575 if (hw->ctrl.privilege == AARCH64_BREAKPOINT_EL1 && bp->hw.target)
576 return -EINVAL;
578 return 0;
582 * Enable/disable all of the breakpoints active at the specified
583 * exception level at the register level.
584 * This is used when single-stepping after a breakpoint exception.
586 static void toggle_bp_registers(int reg, enum dbg_active_el el, int enable)
588 int i, max_slots, privilege;
589 u32 ctrl;
590 struct perf_event **slots;
592 switch (reg) {
593 case AARCH64_DBG_REG_BCR:
594 slots = this_cpu_ptr(bp_on_reg);
595 max_slots = core_num_brps;
596 break;
597 case AARCH64_DBG_REG_WCR:
598 slots = this_cpu_ptr(wp_on_reg);
599 max_slots = core_num_wrps;
600 break;
601 default:
602 return;
605 for (i = 0; i < max_slots; ++i) {
606 if (!slots[i])
607 continue;
609 privilege = counter_arch_bp(slots[i])->ctrl.privilege;
610 if (debug_exception_level(privilege) != el)
611 continue;
613 ctrl = read_wb_reg(reg, i);
614 if (enable)
615 ctrl |= 0x1;
616 else
617 ctrl &= ~0x1;
618 write_wb_reg(reg, i, ctrl);
621 NOKPROBE_SYMBOL(toggle_bp_registers);
624 * Debug exception handlers.
626 static int breakpoint_handler(unsigned long unused, unsigned int esr,
627 struct pt_regs *regs)
629 int i, step = 0, *kernel_step;
630 u32 ctrl_reg;
631 u64 addr, val;
632 struct perf_event *bp, **slots;
633 struct debug_info *debug_info;
634 struct arch_hw_breakpoint_ctrl ctrl;
636 slots = this_cpu_ptr(bp_on_reg);
637 addr = instruction_pointer(regs);
638 debug_info = &current->thread.debug;
640 for (i = 0; i < core_num_brps; ++i) {
641 rcu_read_lock();
643 bp = slots[i];
645 if (bp == NULL)
646 goto unlock;
648 /* Check if the breakpoint value matches. */
649 val = read_wb_reg(AARCH64_DBG_REG_BVR, i);
650 if (val != (addr & ~0x3))
651 goto unlock;
653 /* Possible match, check the byte address select to confirm. */
654 ctrl_reg = read_wb_reg(AARCH64_DBG_REG_BCR, i);
655 decode_ctrl_reg(ctrl_reg, &ctrl);
656 if (!((1 << (addr & 0x3)) & ctrl.len))
657 goto unlock;
659 counter_arch_bp(bp)->trigger = addr;
660 perf_bp_event(bp, regs);
662 /* Do we need to handle the stepping? */
663 if (is_default_overflow_handler(bp))
664 step = 1;
665 unlock:
666 rcu_read_unlock();
669 if (!step)
670 return 0;
672 if (user_mode(regs)) {
673 debug_info->bps_disabled = 1;
674 toggle_bp_registers(AARCH64_DBG_REG_BCR, DBG_ACTIVE_EL0, 0);
676 /* If we're already stepping a watchpoint, just return. */
677 if (debug_info->wps_disabled)
678 return 0;
680 if (test_thread_flag(TIF_SINGLESTEP))
681 debug_info->suspended_step = 1;
682 else
683 user_enable_single_step(current);
684 } else {
685 toggle_bp_registers(AARCH64_DBG_REG_BCR, DBG_ACTIVE_EL1, 0);
686 kernel_step = this_cpu_ptr(&stepping_kernel_bp);
688 if (*kernel_step != ARM_KERNEL_STEP_NONE)
689 return 0;
691 if (kernel_active_single_step()) {
692 *kernel_step = ARM_KERNEL_STEP_SUSPEND;
693 } else {
694 *kernel_step = ARM_KERNEL_STEP_ACTIVE;
695 kernel_enable_single_step(regs);
699 return 0;
701 NOKPROBE_SYMBOL(breakpoint_handler);
704 * Arm64 hardware does not always report a watchpoint hit address that matches
705 * one of the watchpoints set. It can also report an address "near" the
706 * watchpoint if a single instruction access both watched and unwatched
707 * addresses. There is no straight-forward way, short of disassembling the
708 * offending instruction, to map that address back to the watchpoint. This
709 * function computes the distance of the memory access from the watchpoint as a
710 * heuristic for the likelyhood that a given access triggered the watchpoint.
712 * See Section D2.10.5 "Determining the memory location that caused a Watchpoint
713 * exception" of ARMv8 Architecture Reference Manual for details.
715 * The function returns the distance of the address from the bytes watched by
716 * the watchpoint. In case of an exact match, it returns 0.
718 static u64 get_distance_from_watchpoint(unsigned long addr, u64 val,
719 struct arch_hw_breakpoint_ctrl *ctrl)
721 u64 wp_low, wp_high;
722 u32 lens, lene;
724 addr = untagged_addr(addr);
726 lens = __ffs(ctrl->len);
727 lene = __fls(ctrl->len);
729 wp_low = val + lens;
730 wp_high = val + lene;
731 if (addr < wp_low)
732 return wp_low - addr;
733 else if (addr > wp_high)
734 return addr - wp_high;
735 else
736 return 0;
739 static int watchpoint_handler(unsigned long addr, unsigned int esr,
740 struct pt_regs *regs)
742 int i, step = 0, *kernel_step, access, closest_match = 0;
743 u64 min_dist = -1, dist;
744 u32 ctrl_reg;
745 u64 val;
746 struct perf_event *wp, **slots;
747 struct debug_info *debug_info;
748 struct arch_hw_breakpoint *info;
749 struct arch_hw_breakpoint_ctrl ctrl;
751 slots = this_cpu_ptr(wp_on_reg);
752 debug_info = &current->thread.debug;
755 * Find all watchpoints that match the reported address. If no exact
756 * match is found. Attribute the hit to the closest watchpoint.
758 rcu_read_lock();
759 for (i = 0; i < core_num_wrps; ++i) {
760 wp = slots[i];
761 if (wp == NULL)
762 continue;
765 * Check that the access type matches.
766 * 0 => load, otherwise => store
768 access = (esr & AARCH64_ESR_ACCESS_MASK) ? HW_BREAKPOINT_W :
769 HW_BREAKPOINT_R;
770 if (!(access & hw_breakpoint_type(wp)))
771 continue;
773 /* Check if the watchpoint value and byte select match. */
774 val = read_wb_reg(AARCH64_DBG_REG_WVR, i);
775 ctrl_reg = read_wb_reg(AARCH64_DBG_REG_WCR, i);
776 decode_ctrl_reg(ctrl_reg, &ctrl);
777 dist = get_distance_from_watchpoint(addr, val, &ctrl);
778 if (dist < min_dist) {
779 min_dist = dist;
780 closest_match = i;
782 /* Is this an exact match? */
783 if (dist != 0)
784 continue;
786 info = counter_arch_bp(wp);
787 info->trigger = addr;
788 perf_bp_event(wp, regs);
790 /* Do we need to handle the stepping? */
791 if (is_default_overflow_handler(wp))
792 step = 1;
794 if (min_dist > 0 && min_dist != -1) {
795 /* No exact match found. */
796 wp = slots[closest_match];
797 info = counter_arch_bp(wp);
798 info->trigger = addr;
799 perf_bp_event(wp, regs);
801 /* Do we need to handle the stepping? */
802 if (is_default_overflow_handler(wp))
803 step = 1;
805 rcu_read_unlock();
807 if (!step)
808 return 0;
811 * We always disable EL0 watchpoints because the kernel can
812 * cause these to fire via an unprivileged access.
814 toggle_bp_registers(AARCH64_DBG_REG_WCR, DBG_ACTIVE_EL0, 0);
816 if (user_mode(regs)) {
817 debug_info->wps_disabled = 1;
819 /* If we're already stepping a breakpoint, just return. */
820 if (debug_info->bps_disabled)
821 return 0;
823 if (test_thread_flag(TIF_SINGLESTEP))
824 debug_info->suspended_step = 1;
825 else
826 user_enable_single_step(current);
827 } else {
828 toggle_bp_registers(AARCH64_DBG_REG_WCR, DBG_ACTIVE_EL1, 0);
829 kernel_step = this_cpu_ptr(&stepping_kernel_bp);
831 if (*kernel_step != ARM_KERNEL_STEP_NONE)
832 return 0;
834 if (kernel_active_single_step()) {
835 *kernel_step = ARM_KERNEL_STEP_SUSPEND;
836 } else {
837 *kernel_step = ARM_KERNEL_STEP_ACTIVE;
838 kernel_enable_single_step(regs);
842 return 0;
844 NOKPROBE_SYMBOL(watchpoint_handler);
847 * Handle single-step exception.
849 int reinstall_suspended_bps(struct pt_regs *regs)
851 struct debug_info *debug_info = &current->thread.debug;
852 int handled_exception = 0, *kernel_step;
854 kernel_step = this_cpu_ptr(&stepping_kernel_bp);
857 * Called from single-step exception handler.
858 * Return 0 if execution can resume, 1 if a SIGTRAP should be
859 * reported.
861 if (user_mode(regs)) {
862 if (debug_info->bps_disabled) {
863 debug_info->bps_disabled = 0;
864 toggle_bp_registers(AARCH64_DBG_REG_BCR, DBG_ACTIVE_EL0, 1);
865 handled_exception = 1;
868 if (debug_info->wps_disabled) {
869 debug_info->wps_disabled = 0;
870 toggle_bp_registers(AARCH64_DBG_REG_WCR, DBG_ACTIVE_EL0, 1);
871 handled_exception = 1;
874 if (handled_exception) {
875 if (debug_info->suspended_step) {
876 debug_info->suspended_step = 0;
877 /* Allow exception handling to fall-through. */
878 handled_exception = 0;
879 } else {
880 user_disable_single_step(current);
883 } else if (*kernel_step != ARM_KERNEL_STEP_NONE) {
884 toggle_bp_registers(AARCH64_DBG_REG_BCR, DBG_ACTIVE_EL1, 1);
885 toggle_bp_registers(AARCH64_DBG_REG_WCR, DBG_ACTIVE_EL1, 1);
887 if (!debug_info->wps_disabled)
888 toggle_bp_registers(AARCH64_DBG_REG_WCR, DBG_ACTIVE_EL0, 1);
890 if (*kernel_step != ARM_KERNEL_STEP_SUSPEND) {
891 kernel_disable_single_step();
892 handled_exception = 1;
893 } else {
894 handled_exception = 0;
897 *kernel_step = ARM_KERNEL_STEP_NONE;
900 return !handled_exception;
902 NOKPROBE_SYMBOL(reinstall_suspended_bps);
905 * Context-switcher for restoring suspended breakpoints.
907 void hw_breakpoint_thread_switch(struct task_struct *next)
910 * current next
911 * disabled: 0 0 => The usual case, NOTIFY_DONE
912 * 0 1 => Disable the registers
913 * 1 0 => Enable the registers
914 * 1 1 => NOTIFY_DONE. per-task bps will
915 * get taken care of by perf.
918 struct debug_info *current_debug_info, *next_debug_info;
920 current_debug_info = &current->thread.debug;
921 next_debug_info = &next->thread.debug;
923 /* Update breakpoints. */
924 if (current_debug_info->bps_disabled != next_debug_info->bps_disabled)
925 toggle_bp_registers(AARCH64_DBG_REG_BCR,
926 DBG_ACTIVE_EL0,
927 !next_debug_info->bps_disabled);
929 /* Update watchpoints. */
930 if (current_debug_info->wps_disabled != next_debug_info->wps_disabled)
931 toggle_bp_registers(AARCH64_DBG_REG_WCR,
932 DBG_ACTIVE_EL0,
933 !next_debug_info->wps_disabled);
937 * CPU initialisation.
939 static int hw_breakpoint_reset(unsigned int cpu)
941 int i;
942 struct perf_event **slots;
944 * When a CPU goes through cold-boot, it does not have any installed
945 * slot, so it is safe to share the same function for restoring and
946 * resetting breakpoints; when a CPU is hotplugged in, it goes
947 * through the slots, which are all empty, hence it just resets control
948 * and value for debug registers.
949 * When this function is triggered on warm-boot through a CPU PM
950 * notifier some slots might be initialized; if so they are
951 * reprogrammed according to the debug slots content.
953 for (slots = this_cpu_ptr(bp_on_reg), i = 0; i < core_num_brps; ++i) {
954 if (slots[i]) {
955 hw_breakpoint_control(slots[i], HW_BREAKPOINT_RESTORE);
956 } else {
957 write_wb_reg(AARCH64_DBG_REG_BCR, i, 0UL);
958 write_wb_reg(AARCH64_DBG_REG_BVR, i, 0UL);
962 for (slots = this_cpu_ptr(wp_on_reg), i = 0; i < core_num_wrps; ++i) {
963 if (slots[i]) {
964 hw_breakpoint_control(slots[i], HW_BREAKPOINT_RESTORE);
965 } else {
966 write_wb_reg(AARCH64_DBG_REG_WCR, i, 0UL);
967 write_wb_reg(AARCH64_DBG_REG_WVR, i, 0UL);
971 return 0;
974 #ifdef CONFIG_CPU_PM
975 extern void cpu_suspend_set_dbg_restorer(int (*hw_bp_restore)(unsigned int));
976 #else
977 static inline void cpu_suspend_set_dbg_restorer(int (*hw_bp_restore)(unsigned int))
980 #endif
983 * One-time initialisation.
985 static int __init arch_hw_breakpoint_init(void)
987 int ret;
989 core_num_brps = get_num_brps();
990 core_num_wrps = get_num_wrps();
992 pr_info("found %d breakpoint and %d watchpoint registers.\n",
993 core_num_brps, core_num_wrps);
995 /* Register debug fault handlers. */
996 hook_debug_fault_code(DBG_ESR_EVT_HWBP, breakpoint_handler, SIGTRAP,
997 TRAP_HWBKPT, "hw-breakpoint handler");
998 hook_debug_fault_code(DBG_ESR_EVT_HWWP, watchpoint_handler, SIGTRAP,
999 TRAP_HWBKPT, "hw-watchpoint handler");
1002 * Reset the breakpoint resources. We assume that a halting
1003 * debugger will leave the world in a nice state for us.
1005 ret = cpuhp_setup_state(CPUHP_AP_PERF_ARM_HW_BREAKPOINT_STARTING,
1006 "perf/arm64/hw_breakpoint:starting",
1007 hw_breakpoint_reset, NULL);
1008 if (ret)
1009 pr_err("failed to register CPU hotplug notifier: %d\n", ret);
1011 /* Register cpu_suspend hw breakpoint restore hook */
1012 cpu_suspend_set_dbg_restorer(hw_breakpoint_reset);
1014 return ret;
1016 arch_initcall(arch_hw_breakpoint_init);
1018 void hw_breakpoint_pmu_read(struct perf_event *bp)
1023 * Dummy function to register with die_notifier.
1025 int hw_breakpoint_exceptions_notify(struct notifier_block *unused,
1026 unsigned long val, void *data)
1028 return NOTIFY_DONE;