blob: b06d9ea07c846aa0079d4eb4a9a935075a00d097 [file] [log] [blame]
David Brazdil0f672f62019-12-10 10:32:29 +00001// SPDX-License-Identifier: GPL-2.0-only
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00002/*
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00003 *
4 * Copyright (C) 2009, 2010 ARM Limited
5 *
6 * Author: Will Deacon <will.deacon@arm.com>
7 */
8
9/*
10 * HW_breakpoint: a unified kernel/user-space hardware breakpoint facility,
11 * using the CPU's debug registers.
12 */
13#define pr_fmt(fmt) "hw-breakpoint: " fmt
14
15#include <linux/errno.h>
16#include <linux/hardirq.h>
17#include <linux/perf_event.h>
18#include <linux/hw_breakpoint.h>
19#include <linux/smp.h>
20#include <linux/cpu_pm.h>
21#include <linux/coresight.h>
22
23#include <asm/cacheflush.h>
24#include <asm/cputype.h>
25#include <asm/current.h>
26#include <asm/hw_breakpoint.h>
27#include <asm/traps.h>
28
29/* Breakpoint currently in use for each BRP. */
30static DEFINE_PER_CPU(struct perf_event *, bp_on_reg[ARM_MAX_BRP]);
31
32/* Watchpoint currently in use for each WRP. */
33static DEFINE_PER_CPU(struct perf_event *, wp_on_reg[ARM_MAX_WRP]);
34
35/* Number of BRP/WRP registers on this CPU. */
36static int core_num_brps __ro_after_init;
37static int core_num_wrps __ro_after_init;
38
39/* Debug architecture version. */
40static u8 debug_arch __ro_after_init;
41
42/* Does debug architecture support OS Save and Restore? */
43static bool has_ossr __ro_after_init;
44
45/* Maximum supported watchpoint length. */
46static u8 max_watchpoint_len __ro_after_init;
47
48#define READ_WB_REG_CASE(OP2, M, VAL) \
49 case ((OP2 << 4) + M): \
50 ARM_DBG_READ(c0, c ## M, OP2, VAL); \
51 break
52
53#define WRITE_WB_REG_CASE(OP2, M, VAL) \
54 case ((OP2 << 4) + M): \
55 ARM_DBG_WRITE(c0, c ## M, OP2, VAL); \
56 break
57
58#define GEN_READ_WB_REG_CASES(OP2, VAL) \
59 READ_WB_REG_CASE(OP2, 0, VAL); \
60 READ_WB_REG_CASE(OP2, 1, VAL); \
61 READ_WB_REG_CASE(OP2, 2, VAL); \
62 READ_WB_REG_CASE(OP2, 3, VAL); \
63 READ_WB_REG_CASE(OP2, 4, VAL); \
64 READ_WB_REG_CASE(OP2, 5, VAL); \
65 READ_WB_REG_CASE(OP2, 6, VAL); \
66 READ_WB_REG_CASE(OP2, 7, VAL); \
67 READ_WB_REG_CASE(OP2, 8, VAL); \
68 READ_WB_REG_CASE(OP2, 9, VAL); \
69 READ_WB_REG_CASE(OP2, 10, VAL); \
70 READ_WB_REG_CASE(OP2, 11, VAL); \
71 READ_WB_REG_CASE(OP2, 12, VAL); \
72 READ_WB_REG_CASE(OP2, 13, VAL); \
73 READ_WB_REG_CASE(OP2, 14, VAL); \
74 READ_WB_REG_CASE(OP2, 15, VAL)
75
76#define GEN_WRITE_WB_REG_CASES(OP2, VAL) \
77 WRITE_WB_REG_CASE(OP2, 0, VAL); \
78 WRITE_WB_REG_CASE(OP2, 1, VAL); \
79 WRITE_WB_REG_CASE(OP2, 2, VAL); \
80 WRITE_WB_REG_CASE(OP2, 3, VAL); \
81 WRITE_WB_REG_CASE(OP2, 4, VAL); \
82 WRITE_WB_REG_CASE(OP2, 5, VAL); \
83 WRITE_WB_REG_CASE(OP2, 6, VAL); \
84 WRITE_WB_REG_CASE(OP2, 7, VAL); \
85 WRITE_WB_REG_CASE(OP2, 8, VAL); \
86 WRITE_WB_REG_CASE(OP2, 9, VAL); \
87 WRITE_WB_REG_CASE(OP2, 10, VAL); \
88 WRITE_WB_REG_CASE(OP2, 11, VAL); \
89 WRITE_WB_REG_CASE(OP2, 12, VAL); \
90 WRITE_WB_REG_CASE(OP2, 13, VAL); \
91 WRITE_WB_REG_CASE(OP2, 14, VAL); \
92 WRITE_WB_REG_CASE(OP2, 15, VAL)
93
94static u32 read_wb_reg(int n)
95{
96 u32 val = 0;
97
98 switch (n) {
99 GEN_READ_WB_REG_CASES(ARM_OP2_BVR, val);
100 GEN_READ_WB_REG_CASES(ARM_OP2_BCR, val);
101 GEN_READ_WB_REG_CASES(ARM_OP2_WVR, val);
102 GEN_READ_WB_REG_CASES(ARM_OP2_WCR, val);
103 default:
104 pr_warn("attempt to read from unknown breakpoint register %d\n",
105 n);
106 }
107
108 return val;
109}
110
111static void write_wb_reg(int n, u32 val)
112{
113 switch (n) {
114 GEN_WRITE_WB_REG_CASES(ARM_OP2_BVR, val);
115 GEN_WRITE_WB_REG_CASES(ARM_OP2_BCR, val);
116 GEN_WRITE_WB_REG_CASES(ARM_OP2_WVR, val);
117 GEN_WRITE_WB_REG_CASES(ARM_OP2_WCR, val);
118 default:
119 pr_warn("attempt to write to unknown breakpoint register %d\n",
120 n);
121 }
122 isb();
123}
124
125/* Determine debug architecture. */
126static u8 get_debug_arch(void)
127{
128 u32 didr;
129
130 /* Do we implement the extended CPUID interface? */
131 if (((read_cpuid_id() >> 16) & 0xf) != 0xf) {
132 pr_warn_once("CPUID feature registers not supported. "
133 "Assuming v6 debug is present.\n");
134 return ARM_DEBUG_ARCH_V6;
135 }
136
137 ARM_DBG_READ(c0, c0, 0, didr);
138 return (didr >> 16) & 0xf;
139}
140
141u8 arch_get_debug_arch(void)
142{
143 return debug_arch;
144}
145
146static int debug_arch_supported(void)
147{
148 u8 arch = get_debug_arch();
149
150 /* We don't support the memory-mapped interface. */
151 return (arch >= ARM_DEBUG_ARCH_V6 && arch <= ARM_DEBUG_ARCH_V7_ECP14) ||
152 arch >= ARM_DEBUG_ARCH_V7_1;
153}
154
155/* Can we determine the watchpoint access type from the fsr? */
156static int debug_exception_updates_fsr(void)
157{
158 return get_debug_arch() >= ARM_DEBUG_ARCH_V8;
159}
160
161/* Determine number of WRP registers available. */
162static int get_num_wrp_resources(void)
163{
164 u32 didr;
165 ARM_DBG_READ(c0, c0, 0, didr);
166 return ((didr >> 28) & 0xf) + 1;
167}
168
169/* Determine number of BRP registers available. */
170static int get_num_brp_resources(void)
171{
172 u32 didr;
173 ARM_DBG_READ(c0, c0, 0, didr);
174 return ((didr >> 24) & 0xf) + 1;
175}
176
177/* Does this core support mismatch breakpoints? */
178static int core_has_mismatch_brps(void)
179{
180 return (get_debug_arch() >= ARM_DEBUG_ARCH_V7_ECP14 &&
181 get_num_brp_resources() > 1);
182}
183
184/* Determine number of usable WRPs available. */
185static int get_num_wrps(void)
186{
187 /*
188 * On debug architectures prior to 7.1, when a watchpoint fires, the
189 * only way to work out which watchpoint it was is by disassembling
190 * the faulting instruction and working out the address of the memory
191 * access.
192 *
193 * Furthermore, we can only do this if the watchpoint was precise
194 * since imprecise watchpoints prevent us from calculating register
195 * based addresses.
196 *
197 * Providing we have more than 1 breakpoint register, we only report
198 * a single watchpoint register for the time being. This way, we always
199 * know which watchpoint fired. In the future we can either add a
200 * disassembler and address generation emulator, or we can insert a
201 * check to see if the DFAR is set on watchpoint exception entry
202 * [the ARM ARM states that the DFAR is UNKNOWN, but experience shows
203 * that it is set on some implementations].
204 */
205 if (get_debug_arch() < ARM_DEBUG_ARCH_V7_1)
206 return 1;
207
208 return get_num_wrp_resources();
209}
210
211/* Determine number of usable BRPs available. */
212static int get_num_brps(void)
213{
214 int brps = get_num_brp_resources();
215 return core_has_mismatch_brps() ? brps - 1 : brps;
216}
217
218/*
219 * In order to access the breakpoint/watchpoint control registers,
220 * we must be running in debug monitor mode. Unfortunately, we can
221 * be put into halting debug mode at any time by an external debugger
222 * but there is nothing we can do to prevent that.
223 */
224static int monitor_mode_enabled(void)
225{
226 u32 dscr;
227 ARM_DBG_READ(c0, c1, 0, dscr);
228 return !!(dscr & ARM_DSCR_MDBGEN);
229}
230
231static int enable_monitor_mode(void)
232{
233 u32 dscr;
234 ARM_DBG_READ(c0, c1, 0, dscr);
235
236 /* If monitor mode is already enabled, just return. */
237 if (dscr & ARM_DSCR_MDBGEN)
238 goto out;
239
240 /* Write to the corresponding DSCR. */
241 switch (get_debug_arch()) {
242 case ARM_DEBUG_ARCH_V6:
243 case ARM_DEBUG_ARCH_V6_1:
244 ARM_DBG_WRITE(c0, c1, 0, (dscr | ARM_DSCR_MDBGEN));
245 break;
246 case ARM_DEBUG_ARCH_V7_ECP14:
247 case ARM_DEBUG_ARCH_V7_1:
248 case ARM_DEBUG_ARCH_V8:
249 ARM_DBG_WRITE(c0, c2, 2, (dscr | ARM_DSCR_MDBGEN));
250 isb();
251 break;
252 default:
253 return -ENODEV;
254 }
255
256 /* Check that the write made it through. */
257 ARM_DBG_READ(c0, c1, 0, dscr);
258 if (!(dscr & ARM_DSCR_MDBGEN)) {
259 pr_warn_once("Failed to enable monitor mode on CPU %d.\n",
260 smp_processor_id());
261 return -EPERM;
262 }
263
264out:
265 return 0;
266}
267
268int hw_breakpoint_slots(int type)
269{
270 if (!debug_arch_supported())
271 return 0;
272
273 /*
274 * We can be called early, so don't rely on
275 * our static variables being initialised.
276 */
277 switch (type) {
278 case TYPE_INST:
279 return get_num_brps();
280 case TYPE_DATA:
281 return get_num_wrps();
282 default:
283 pr_warn("unknown slot type: %d\n", type);
284 return 0;
285 }
286}
287
288/*
289 * Check if 8-bit byte-address select is available.
290 * This clobbers WRP 0.
291 */
292static u8 get_max_wp_len(void)
293{
294 u32 ctrl_reg;
295 struct arch_hw_breakpoint_ctrl ctrl;
296 u8 size = 4;
297
298 if (debug_arch < ARM_DEBUG_ARCH_V7_ECP14)
299 goto out;
300
301 memset(&ctrl, 0, sizeof(ctrl));
302 ctrl.len = ARM_BREAKPOINT_LEN_8;
303 ctrl_reg = encode_ctrl_reg(ctrl);
304
305 write_wb_reg(ARM_BASE_WVR, 0);
306 write_wb_reg(ARM_BASE_WCR, ctrl_reg);
307 if ((read_wb_reg(ARM_BASE_WCR) & ctrl_reg) == ctrl_reg)
308 size = 8;
309
310out:
311 return size;
312}
313
314u8 arch_get_max_wp_len(void)
315{
316 return max_watchpoint_len;
317}
318
319/*
320 * Install a perf counter breakpoint.
321 */
322int arch_install_hw_breakpoint(struct perf_event *bp)
323{
324 struct arch_hw_breakpoint *info = counter_arch_bp(bp);
325 struct perf_event **slot, **slots;
326 int i, max_slots, ctrl_base, val_base;
327 u32 addr, ctrl;
328
329 addr = info->address;
330 ctrl = encode_ctrl_reg(info->ctrl) | 0x1;
331
332 if (info->ctrl.type == ARM_BREAKPOINT_EXECUTE) {
333 /* Breakpoint */
334 ctrl_base = ARM_BASE_BCR;
335 val_base = ARM_BASE_BVR;
336 slots = this_cpu_ptr(bp_on_reg);
337 max_slots = core_num_brps;
338 } else {
339 /* Watchpoint */
340 ctrl_base = ARM_BASE_WCR;
341 val_base = ARM_BASE_WVR;
342 slots = this_cpu_ptr(wp_on_reg);
343 max_slots = core_num_wrps;
344 }
345
346 for (i = 0; i < max_slots; ++i) {
347 slot = &slots[i];
348
349 if (!*slot) {
350 *slot = bp;
351 break;
352 }
353 }
354
355 if (i == max_slots) {
356 pr_warn("Can't find any breakpoint slot\n");
357 return -EBUSY;
358 }
359
360 /* Override the breakpoint data with the step data. */
361 if (info->step_ctrl.enabled) {
362 addr = info->trigger & ~0x3;
363 ctrl = encode_ctrl_reg(info->step_ctrl);
364 if (info->ctrl.type != ARM_BREAKPOINT_EXECUTE) {
365 i = 0;
366 ctrl_base = ARM_BASE_BCR + core_num_brps;
367 val_base = ARM_BASE_BVR + core_num_brps;
368 }
369 }
370
371 /* Setup the address register. */
372 write_wb_reg(val_base + i, addr);
373
374 /* Setup the control register. */
375 write_wb_reg(ctrl_base + i, ctrl);
376 return 0;
377}
378
379void arch_uninstall_hw_breakpoint(struct perf_event *bp)
380{
381 struct arch_hw_breakpoint *info = counter_arch_bp(bp);
382 struct perf_event **slot, **slots;
383 int i, max_slots, base;
384
385 if (info->ctrl.type == ARM_BREAKPOINT_EXECUTE) {
386 /* Breakpoint */
387 base = ARM_BASE_BCR;
388 slots = this_cpu_ptr(bp_on_reg);
389 max_slots = core_num_brps;
390 } else {
391 /* Watchpoint */
392 base = ARM_BASE_WCR;
393 slots = this_cpu_ptr(wp_on_reg);
394 max_slots = core_num_wrps;
395 }
396
397 /* Remove the breakpoint. */
398 for (i = 0; i < max_slots; ++i) {
399 slot = &slots[i];
400
401 if (*slot == bp) {
402 *slot = NULL;
403 break;
404 }
405 }
406
407 if (i == max_slots) {
408 pr_warn("Can't find any breakpoint slot\n");
409 return;
410 }
411
412 /* Ensure that we disable the mismatch breakpoint. */
413 if (info->ctrl.type != ARM_BREAKPOINT_EXECUTE &&
414 info->step_ctrl.enabled) {
415 i = 0;
416 base = ARM_BASE_BCR + core_num_brps;
417 }
418
419 /* Reset the control register. */
420 write_wb_reg(base + i, 0);
421}
422
423static int get_hbp_len(u8 hbp_len)
424{
425 unsigned int len_in_bytes = 0;
426
427 switch (hbp_len) {
428 case ARM_BREAKPOINT_LEN_1:
429 len_in_bytes = 1;
430 break;
431 case ARM_BREAKPOINT_LEN_2:
432 len_in_bytes = 2;
433 break;
434 case ARM_BREAKPOINT_LEN_4:
435 len_in_bytes = 4;
436 break;
437 case ARM_BREAKPOINT_LEN_8:
438 len_in_bytes = 8;
439 break;
440 }
441
442 return len_in_bytes;
443}
444
445/*
446 * Check whether bp virtual address is in kernel space.
447 */
448int arch_check_bp_in_kernelspace(struct arch_hw_breakpoint *hw)
449{
450 unsigned int len;
451 unsigned long va;
452
453 va = hw->address;
454 len = get_hbp_len(hw->ctrl.len);
455
456 return (va >= TASK_SIZE) && ((va + len - 1) >= TASK_SIZE);
457}
458
459/*
460 * Extract generic type and length encodings from an arch_hw_breakpoint_ctrl.
461 * Hopefully this will disappear when ptrace can bypass the conversion
462 * to generic breakpoint descriptions.
463 */
464int arch_bp_generic_fields(struct arch_hw_breakpoint_ctrl ctrl,
465 int *gen_len, int *gen_type)
466{
467 /* Type */
468 switch (ctrl.type) {
469 case ARM_BREAKPOINT_EXECUTE:
470 *gen_type = HW_BREAKPOINT_X;
471 break;
472 case ARM_BREAKPOINT_LOAD:
473 *gen_type = HW_BREAKPOINT_R;
474 break;
475 case ARM_BREAKPOINT_STORE:
476 *gen_type = HW_BREAKPOINT_W;
477 break;
478 case ARM_BREAKPOINT_LOAD | ARM_BREAKPOINT_STORE:
479 *gen_type = HW_BREAKPOINT_RW;
480 break;
481 default:
482 return -EINVAL;
483 }
484
485 /* Len */
486 switch (ctrl.len) {
487 case ARM_BREAKPOINT_LEN_1:
488 *gen_len = HW_BREAKPOINT_LEN_1;
489 break;
490 case ARM_BREAKPOINT_LEN_2:
491 *gen_len = HW_BREAKPOINT_LEN_2;
492 break;
493 case ARM_BREAKPOINT_LEN_4:
494 *gen_len = HW_BREAKPOINT_LEN_4;
495 break;
496 case ARM_BREAKPOINT_LEN_8:
497 *gen_len = HW_BREAKPOINT_LEN_8;
498 break;
499 default:
500 return -EINVAL;
501 }
502
503 return 0;
504}
505
506/*
507 * Construct an arch_hw_breakpoint from a perf_event.
508 */
509static int arch_build_bp_info(struct perf_event *bp,
510 const struct perf_event_attr *attr,
511 struct arch_hw_breakpoint *hw)
512{
513 /* Type */
514 switch (attr->bp_type) {
515 case HW_BREAKPOINT_X:
516 hw->ctrl.type = ARM_BREAKPOINT_EXECUTE;
517 break;
518 case HW_BREAKPOINT_R:
519 hw->ctrl.type = ARM_BREAKPOINT_LOAD;
520 break;
521 case HW_BREAKPOINT_W:
522 hw->ctrl.type = ARM_BREAKPOINT_STORE;
523 break;
524 case HW_BREAKPOINT_RW:
525 hw->ctrl.type = ARM_BREAKPOINT_LOAD | ARM_BREAKPOINT_STORE;
526 break;
527 default:
528 return -EINVAL;
529 }
530
531 /* Len */
532 switch (attr->bp_len) {
533 case HW_BREAKPOINT_LEN_1:
534 hw->ctrl.len = ARM_BREAKPOINT_LEN_1;
535 break;
536 case HW_BREAKPOINT_LEN_2:
537 hw->ctrl.len = ARM_BREAKPOINT_LEN_2;
538 break;
539 case HW_BREAKPOINT_LEN_4:
540 hw->ctrl.len = ARM_BREAKPOINT_LEN_4;
541 break;
542 case HW_BREAKPOINT_LEN_8:
543 hw->ctrl.len = ARM_BREAKPOINT_LEN_8;
544 if ((hw->ctrl.type != ARM_BREAKPOINT_EXECUTE)
545 && max_watchpoint_len >= 8)
546 break;
David Brazdil0f672f62019-12-10 10:32:29 +0000547 /* Else, fall through */
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000548 default:
549 return -EINVAL;
550 }
551
552 /*
553 * Breakpoints must be of length 2 (thumb) or 4 (ARM) bytes.
554 * Watchpoints can be of length 1, 2, 4 or 8 bytes if supported
555 * by the hardware and must be aligned to the appropriate number of
556 * bytes.
557 */
558 if (hw->ctrl.type == ARM_BREAKPOINT_EXECUTE &&
559 hw->ctrl.len != ARM_BREAKPOINT_LEN_2 &&
560 hw->ctrl.len != ARM_BREAKPOINT_LEN_4)
561 return -EINVAL;
562
563 /* Address */
564 hw->address = attr->bp_addr;
565
566 /* Privilege */
567 hw->ctrl.privilege = ARM_BREAKPOINT_USER;
568 if (arch_check_bp_in_kernelspace(hw))
569 hw->ctrl.privilege |= ARM_BREAKPOINT_PRIV;
570
571 /* Enabled? */
572 hw->ctrl.enabled = !attr->disabled;
573
574 /* Mismatch */
575 hw->ctrl.mismatch = 0;
576
577 return 0;
578}
579
580/*
581 * Validate the arch-specific HW Breakpoint register settings.
582 */
583int hw_breakpoint_arch_parse(struct perf_event *bp,
584 const struct perf_event_attr *attr,
585 struct arch_hw_breakpoint *hw)
586{
587 int ret = 0;
588 u32 offset, alignment_mask = 0x3;
589
590 /* Ensure that we are in monitor debug mode. */
591 if (!monitor_mode_enabled())
592 return -ENODEV;
593
594 /* Build the arch_hw_breakpoint. */
595 ret = arch_build_bp_info(bp, attr, hw);
596 if (ret)
597 goto out;
598
599 /* Check address alignment. */
600 if (hw->ctrl.len == ARM_BREAKPOINT_LEN_8)
601 alignment_mask = 0x7;
602 offset = hw->address & alignment_mask;
603 switch (offset) {
604 case 0:
605 /* Aligned */
606 break;
607 case 1:
608 case 2:
609 /* Allow halfword watchpoints and breakpoints. */
610 if (hw->ctrl.len == ARM_BREAKPOINT_LEN_2)
611 break;
David Brazdil0f672f62019-12-10 10:32:29 +0000612 /* Else, fall through */
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000613 case 3:
614 /* Allow single byte watchpoint. */
615 if (hw->ctrl.len == ARM_BREAKPOINT_LEN_1)
616 break;
David Brazdil0f672f62019-12-10 10:32:29 +0000617 /* Else, fall through */
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000618 default:
619 ret = -EINVAL;
620 goto out;
621 }
622
623 hw->address &= ~alignment_mask;
624 hw->ctrl.len <<= offset;
625
626 if (is_default_overflow_handler(bp)) {
627 /*
628 * Mismatch breakpoints are required for single-stepping
629 * breakpoints.
630 */
631 if (!core_has_mismatch_brps())
632 return -EINVAL;
633
634 /* We don't allow mismatch breakpoints in kernel space. */
635 if (arch_check_bp_in_kernelspace(hw))
636 return -EPERM;
637
638 /*
639 * Per-cpu breakpoints are not supported by our stepping
640 * mechanism.
641 */
642 if (!bp->hw.target)
643 return -EINVAL;
644
645 /*
646 * We only support specific access types if the fsr
647 * reports them.
648 */
649 if (!debug_exception_updates_fsr() &&
650 (hw->ctrl.type == ARM_BREAKPOINT_LOAD ||
651 hw->ctrl.type == ARM_BREAKPOINT_STORE))
652 return -EINVAL;
653 }
654
655out:
656 return ret;
657}
658
659/*
660 * Enable/disable single-stepping over the breakpoint bp at address addr.
661 */
662static void enable_single_step(struct perf_event *bp, u32 addr)
663{
664 struct arch_hw_breakpoint *info = counter_arch_bp(bp);
665
666 arch_uninstall_hw_breakpoint(bp);
667 info->step_ctrl.mismatch = 1;
668 info->step_ctrl.len = ARM_BREAKPOINT_LEN_4;
669 info->step_ctrl.type = ARM_BREAKPOINT_EXECUTE;
670 info->step_ctrl.privilege = info->ctrl.privilege;
671 info->step_ctrl.enabled = 1;
672 info->trigger = addr;
673 arch_install_hw_breakpoint(bp);
674}
675
676static void disable_single_step(struct perf_event *bp)
677{
678 arch_uninstall_hw_breakpoint(bp);
679 counter_arch_bp(bp)->step_ctrl.enabled = 0;
680 arch_install_hw_breakpoint(bp);
681}
682
Olivier Deprez0e641232021-09-23 10:07:05 +0200683/*
684 * Arm32 hardware does not always report a watchpoint hit address that matches
685 * one of the watchpoints set. It can also report an address "near" the
686 * watchpoint if a single instruction access both watched and unwatched
687 * addresses. There is no straight-forward way, short of disassembling the
688 * offending instruction, to map that address back to the watchpoint. This
689 * function computes the distance of the memory access from the watchpoint as a
690 * heuristic for the likelyhood that a given access triggered the watchpoint.
691 *
692 * See this same function in the arm64 platform code, which has the same
693 * problem.
694 *
695 * The function returns the distance of the address from the bytes watched by
696 * the watchpoint. In case of an exact match, it returns 0.
697 */
698static u32 get_distance_from_watchpoint(unsigned long addr, u32 val,
699 struct arch_hw_breakpoint_ctrl *ctrl)
700{
701 u32 wp_low, wp_high;
702 u32 lens, lene;
703
704 lens = __ffs(ctrl->len);
705 lene = __fls(ctrl->len);
706
707 wp_low = val + lens;
708 wp_high = val + lene;
709 if (addr < wp_low)
710 return wp_low - addr;
711 else if (addr > wp_high)
712 return addr - wp_high;
713 else
714 return 0;
715}
716
717static int watchpoint_fault_on_uaccess(struct pt_regs *regs,
718 struct arch_hw_breakpoint *info)
719{
720 return !user_mode(regs) && info->ctrl.privilege == ARM_BREAKPOINT_USER;
721}
722
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000723static void watchpoint_handler(unsigned long addr, unsigned int fsr,
724 struct pt_regs *regs)
725{
Olivier Deprez0e641232021-09-23 10:07:05 +0200726 int i, access, closest_match = 0;
727 u32 min_dist = -1, dist;
728 u32 val, ctrl_reg;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000729 struct perf_event *wp, **slots;
730 struct arch_hw_breakpoint *info;
731 struct arch_hw_breakpoint_ctrl ctrl;
732
733 slots = this_cpu_ptr(wp_on_reg);
734
Olivier Deprez0e641232021-09-23 10:07:05 +0200735 /*
736 * Find all watchpoints that match the reported address. If no exact
737 * match is found. Attribute the hit to the closest watchpoint.
738 */
739 rcu_read_lock();
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000740 for (i = 0; i < core_num_wrps; ++i) {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000741 wp = slots[i];
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000742 if (wp == NULL)
Olivier Deprez0e641232021-09-23 10:07:05 +0200743 continue;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000744
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000745 /*
746 * The DFAR is an unknown value on debug architectures prior
747 * to 7.1. Since we only allow a single watchpoint on these
748 * older CPUs, we can set the trigger to the lowest possible
749 * faulting address.
750 */
751 if (debug_arch < ARM_DEBUG_ARCH_V7_1) {
752 BUG_ON(i > 0);
Olivier Deprez0e641232021-09-23 10:07:05 +0200753 info = counter_arch_bp(wp);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000754 info->trigger = wp->attr.bp_addr;
755 } else {
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000756 /* Check that the access type matches. */
757 if (debug_exception_updates_fsr()) {
758 access = (fsr & ARM_FSR_ACCESS_MASK) ?
759 HW_BREAKPOINT_W : HW_BREAKPOINT_R;
760 if (!(access & hw_breakpoint_type(wp)))
Olivier Deprez0e641232021-09-23 10:07:05 +0200761 continue;
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000762 }
763
Olivier Deprez0e641232021-09-23 10:07:05 +0200764 val = read_wb_reg(ARM_BASE_WVR + i);
765 ctrl_reg = read_wb_reg(ARM_BASE_WCR + i);
766 decode_ctrl_reg(ctrl_reg, &ctrl);
767 dist = get_distance_from_watchpoint(addr, val, &ctrl);
768 if (dist < min_dist) {
769 min_dist = dist;
770 closest_match = i;
771 }
772 /* Is this an exact match? */
773 if (dist != 0)
774 continue;
775
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000776 /* We have a winner. */
Olivier Deprez0e641232021-09-23 10:07:05 +0200777 info = counter_arch_bp(wp);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000778 info->trigger = addr;
779 }
780
781 pr_debug("watchpoint fired: address = 0x%x\n", info->trigger);
Olivier Deprez0e641232021-09-23 10:07:05 +0200782
783 /*
784 * If we triggered a user watchpoint from a uaccess routine,
785 * then handle the stepping ourselves since userspace really
786 * can't help us with this.
787 */
788 if (watchpoint_fault_on_uaccess(regs, info))
789 goto step;
790
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000791 perf_bp_event(wp, regs);
792
793 /*
Olivier Deprez0e641232021-09-23 10:07:05 +0200794 * Defer stepping to the overflow handler if one is installed.
795 * Otherwise, insert a temporary mismatch breakpoint so that
796 * we can single-step over the watchpoint trigger.
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000797 */
Olivier Deprez0e641232021-09-23 10:07:05 +0200798 if (!is_default_overflow_handler(wp))
799 continue;
800step:
801 enable_single_step(wp, instruction_pointer(regs));
802 }
803
804 if (min_dist > 0 && min_dist != -1) {
805 /* No exact match found. */
806 wp = slots[closest_match];
807 info = counter_arch_bp(wp);
808 info->trigger = addr;
809 pr_debug("watchpoint fired: address = 0x%x\n", info->trigger);
810 perf_bp_event(wp, regs);
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000811 if (is_default_overflow_handler(wp))
812 enable_single_step(wp, instruction_pointer(regs));
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000813 }
Olivier Deprez0e641232021-09-23 10:07:05 +0200814
815 rcu_read_unlock();
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000816}
817
818static void watchpoint_single_step_handler(unsigned long pc)
819{
820 int i;
821 struct perf_event *wp, **slots;
822 struct arch_hw_breakpoint *info;
823
824 slots = this_cpu_ptr(wp_on_reg);
825
826 for (i = 0; i < core_num_wrps; ++i) {
827 rcu_read_lock();
828
829 wp = slots[i];
830
831 if (wp == NULL)
832 goto unlock;
833
834 info = counter_arch_bp(wp);
835 if (!info->step_ctrl.enabled)
836 goto unlock;
837
838 /*
839 * Restore the original watchpoint if we've completed the
840 * single-step.
841 */
842 if (info->trigger != pc)
843 disable_single_step(wp);
844
845unlock:
846 rcu_read_unlock();
847 }
848}
849
850static void breakpoint_handler(unsigned long unknown, struct pt_regs *regs)
851{
852 int i;
853 u32 ctrl_reg, val, addr;
854 struct perf_event *bp, **slots;
855 struct arch_hw_breakpoint *info;
856 struct arch_hw_breakpoint_ctrl ctrl;
857
858 slots = this_cpu_ptr(bp_on_reg);
859
860 /* The exception entry code places the amended lr in the PC. */
861 addr = regs->ARM_pc;
862
863 /* Check the currently installed breakpoints first. */
864 for (i = 0; i < core_num_brps; ++i) {
865 rcu_read_lock();
866
867 bp = slots[i];
868
869 if (bp == NULL)
870 goto unlock;
871
872 info = counter_arch_bp(bp);
873
874 /* Check if the breakpoint value matches. */
875 val = read_wb_reg(ARM_BASE_BVR + i);
876 if (val != (addr & ~0x3))
877 goto mismatch;
878
879 /* Possible match, check the byte address select to confirm. */
880 ctrl_reg = read_wb_reg(ARM_BASE_BCR + i);
881 decode_ctrl_reg(ctrl_reg, &ctrl);
882 if ((1 << (addr & 0x3)) & ctrl.len) {
883 info->trigger = addr;
884 pr_debug("breakpoint fired: address = 0x%x\n", addr);
885 perf_bp_event(bp, regs);
Olivier Deprez0e641232021-09-23 10:07:05 +0200886 if (is_default_overflow_handler(bp))
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000887 enable_single_step(bp, addr);
888 goto unlock;
889 }
890
891mismatch:
892 /* If we're stepping a breakpoint, it can now be restored. */
893 if (info->step_ctrl.enabled)
894 disable_single_step(bp);
895unlock:
896 rcu_read_unlock();
897 }
898
899 /* Handle any pending watchpoint single-step breakpoints. */
900 watchpoint_single_step_handler(addr);
901}
902
903/*
904 * Called from either the Data Abort Handler [watchpoint] or the
905 * Prefetch Abort Handler [breakpoint] with interrupts disabled.
906 */
907static int hw_breakpoint_pending(unsigned long addr, unsigned int fsr,
908 struct pt_regs *regs)
909{
910 int ret = 0;
911 u32 dscr;
912
913 preempt_disable();
914
915 if (interrupts_enabled(regs))
916 local_irq_enable();
917
918 /* We only handle watchpoints and hardware breakpoints. */
919 ARM_DBG_READ(c0, c1, 0, dscr);
920
921 /* Perform perf callbacks. */
922 switch (ARM_DSCR_MOE(dscr)) {
923 case ARM_ENTRY_BREAKPOINT:
924 breakpoint_handler(addr, regs);
925 break;
926 case ARM_ENTRY_ASYNC_WATCHPOINT:
927 WARN(1, "Asynchronous watchpoint exception taken. Debugging results may be unreliable\n");
David Brazdil0f672f62019-12-10 10:32:29 +0000928 /* Fall through */
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000929 case ARM_ENTRY_SYNC_WATCHPOINT:
930 watchpoint_handler(addr, fsr, regs);
931 break;
932 default:
933 ret = 1; /* Unhandled fault. */
934 }
935
936 preempt_enable();
937
938 return ret;
939}
940
941/*
942 * One-time initialisation.
943 */
944static cpumask_t debug_err_mask;
945
946static int debug_reg_trap(struct pt_regs *regs, unsigned int instr)
947{
948 int cpu = smp_processor_id();
949
950 pr_warn("Debug register access (0x%x) caused undefined instruction on CPU %d\n",
951 instr, cpu);
952
953 /* Set the error flag for this CPU and skip the faulting instruction. */
954 cpumask_set_cpu(cpu, &debug_err_mask);
955 instruction_pointer(regs) += 4;
956 return 0;
957}
958
959static struct undef_hook debug_reg_hook = {
960 .instr_mask = 0x0fe80f10,
961 .instr_val = 0x0e000e10,
962 .fn = debug_reg_trap,
963};
964
965/* Does this core support OS Save and Restore? */
966static bool core_has_os_save_restore(void)
967{
968 u32 oslsr;
969
970 switch (get_debug_arch()) {
971 case ARM_DEBUG_ARCH_V7_1:
972 return true;
973 case ARM_DEBUG_ARCH_V7_ECP14:
974 ARM_DBG_READ(c1, c1, 4, oslsr);
975 if (oslsr & ARM_OSLSR_OSLM0)
976 return true;
David Brazdil0f672f62019-12-10 10:32:29 +0000977 /* Else, fall through */
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000978 default:
979 return false;
980 }
981}
982
983static void reset_ctrl_regs(unsigned int cpu)
984{
985 int i, raw_num_brps, err = 0;
986 u32 val;
987
988 /*
989 * v7 debug contains save and restore registers so that debug state
990 * can be maintained across low-power modes without leaving the debug
991 * logic powered up. It is IMPLEMENTATION DEFINED whether we can access
992 * the debug registers out of reset, so we must unlock the OS Lock
993 * Access Register to avoid taking undefined instruction exceptions
994 * later on.
995 */
996 switch (debug_arch) {
997 case ARM_DEBUG_ARCH_V6:
998 case ARM_DEBUG_ARCH_V6_1:
999 /* ARMv6 cores clear the registers out of reset. */
1000 goto out_mdbgen;
1001 case ARM_DEBUG_ARCH_V7_ECP14:
1002 /*
1003 * Ensure sticky power-down is clear (i.e. debug logic is
1004 * powered up).
1005 */
1006 ARM_DBG_READ(c1, c5, 4, val);
1007 if ((val & 0x1) == 0)
1008 err = -EPERM;
1009
1010 if (!has_ossr)
1011 goto clear_vcr;
1012 break;
1013 case ARM_DEBUG_ARCH_V7_1:
1014 /*
1015 * Ensure the OS double lock is clear.
1016 */
1017 ARM_DBG_READ(c1, c3, 4, val);
1018 if ((val & 0x1) == 1)
1019 err = -EPERM;
1020 break;
1021 }
1022
1023 if (err) {
1024 pr_warn_once("CPU %d debug is powered down!\n", cpu);
1025 cpumask_or(&debug_err_mask, &debug_err_mask, cpumask_of(cpu));
1026 return;
1027 }
1028
1029 /*
1030 * Unconditionally clear the OS lock by writing a value
1031 * other than CS_LAR_KEY to the access register.
1032 */
1033 ARM_DBG_WRITE(c1, c0, 4, ~CORESIGHT_UNLOCK);
1034 isb();
1035
1036 /*
1037 * Clear any configured vector-catch events before
1038 * enabling monitor mode.
1039 */
1040clear_vcr:
1041 ARM_DBG_WRITE(c0, c7, 0, 0);
1042 isb();
1043
1044 if (cpumask_intersects(&debug_err_mask, cpumask_of(cpu))) {
1045 pr_warn_once("CPU %d failed to disable vector catch\n", cpu);
1046 return;
1047 }
1048
1049 /*
1050 * The control/value register pairs are UNKNOWN out of reset so
1051 * clear them to avoid spurious debug events.
1052 */
1053 raw_num_brps = get_num_brp_resources();
1054 for (i = 0; i < raw_num_brps; ++i) {
1055 write_wb_reg(ARM_BASE_BCR + i, 0UL);
1056 write_wb_reg(ARM_BASE_BVR + i, 0UL);
1057 }
1058
1059 for (i = 0; i < core_num_wrps; ++i) {
1060 write_wb_reg(ARM_BASE_WCR + i, 0UL);
1061 write_wb_reg(ARM_BASE_WVR + i, 0UL);
1062 }
1063
1064 if (cpumask_intersects(&debug_err_mask, cpumask_of(cpu))) {
1065 pr_warn_once("CPU %d failed to clear debug register pairs\n", cpu);
1066 return;
1067 }
1068
1069 /*
1070 * Have a crack at enabling monitor mode. We don't actually need
1071 * it yet, but reporting an error early is useful if it fails.
1072 */
1073out_mdbgen:
1074 if (enable_monitor_mode())
1075 cpumask_or(&debug_err_mask, &debug_err_mask, cpumask_of(cpu));
1076}
1077
1078static int dbg_reset_online(unsigned int cpu)
1079{
1080 local_irq_disable();
1081 reset_ctrl_regs(cpu);
1082 local_irq_enable();
1083 return 0;
1084}
1085
1086#ifdef CONFIG_CPU_PM
1087static int dbg_cpu_pm_notify(struct notifier_block *self, unsigned long action,
1088 void *v)
1089{
1090 if (action == CPU_PM_EXIT)
1091 reset_ctrl_regs(smp_processor_id());
1092
1093 return NOTIFY_OK;
1094}
1095
1096static struct notifier_block dbg_cpu_pm_nb = {
1097 .notifier_call = dbg_cpu_pm_notify,
1098};
1099
1100static void __init pm_init(void)
1101{
1102 cpu_pm_register_notifier(&dbg_cpu_pm_nb);
1103}
1104#else
1105static inline void pm_init(void)
1106{
1107}
1108#endif
1109
1110static int __init arch_hw_breakpoint_init(void)
1111{
1112 int ret;
1113
1114 debug_arch = get_debug_arch();
1115
1116 if (!debug_arch_supported()) {
1117 pr_info("debug architecture 0x%x unsupported.\n", debug_arch);
1118 return 0;
1119 }
1120
1121 /*
1122 * Scorpion CPUs (at least those in APQ8060) seem to set DBGPRSR.SPD
1123 * whenever a WFI is issued, even if the core is not powered down, in
1124 * violation of the architecture. When DBGPRSR.SPD is set, accesses to
1125 * breakpoint and watchpoint registers are treated as undefined, so
1126 * this results in boot time and runtime failures when these are
1127 * accessed and we unexpectedly take a trap.
1128 *
1129 * It's not clear if/how this can be worked around, so we blacklist
1130 * Scorpion CPUs to avoid these issues.
1131 */
1132 if (read_cpuid_part() == ARM_CPU_PART_SCORPION) {
1133 pr_info("Scorpion CPU detected. Hardware breakpoints and watchpoints disabled\n");
1134 return 0;
1135 }
1136
1137 has_ossr = core_has_os_save_restore();
1138
1139 /* Determine how many BRPs/WRPs are available. */
1140 core_num_brps = get_num_brps();
1141 core_num_wrps = get_num_wrps();
1142
1143 /*
1144 * We need to tread carefully here because DBGSWENABLE may be
1145 * driven low on this core and there isn't an architected way to
1146 * determine that.
1147 */
1148 cpus_read_lock();
1149 register_undef_hook(&debug_reg_hook);
1150
1151 /*
1152 * Register CPU notifier which resets the breakpoint resources. We
1153 * assume that a halting debugger will leave the world in a nice state
1154 * for us.
1155 */
1156 ret = cpuhp_setup_state_cpuslocked(CPUHP_AP_ONLINE_DYN,
1157 "arm/hw_breakpoint:online",
1158 dbg_reset_online, NULL);
1159 unregister_undef_hook(&debug_reg_hook);
1160 if (WARN_ON(ret < 0) || !cpumask_empty(&debug_err_mask)) {
1161 core_num_brps = 0;
1162 core_num_wrps = 0;
1163 if (ret > 0)
1164 cpuhp_remove_state_nocalls_cpuslocked(ret);
1165 cpus_read_unlock();
1166 return 0;
1167 }
1168
1169 pr_info("found %d " "%s" "breakpoint and %d watchpoint registers.\n",
1170 core_num_brps, core_has_mismatch_brps() ? "(+1 reserved) " :
1171 "", core_num_wrps);
1172
1173 /* Work out the maximum supported watchpoint length. */
1174 max_watchpoint_len = get_max_wp_len();
1175 pr_info("maximum watchpoint size is %u bytes.\n",
1176 max_watchpoint_len);
1177
1178 /* Register debug fault handler. */
1179 hook_fault_code(FAULT_CODE_DEBUG, hw_breakpoint_pending, SIGTRAP,
1180 TRAP_HWBKPT, "watchpoint debug exception");
1181 hook_ifault_code(FAULT_CODE_DEBUG, hw_breakpoint_pending, SIGTRAP,
1182 TRAP_HWBKPT, "breakpoint debug exception");
1183 cpus_read_unlock();
1184
1185 /* Register PM notifiers. */
1186 pm_init();
1187 return 0;
1188}
1189arch_initcall(arch_hw_breakpoint_init);
1190
1191void hw_breakpoint_pmu_read(struct perf_event *bp)
1192{
1193}
1194
1195/*
1196 * Dummy function to register with die_notifier.
1197 */
1198int hw_breakpoint_exceptions_notify(struct notifier_block *unused,
1199 unsigned long val, void *data)
1200{
1201 return NOTIFY_DONE;
1202}