1 // SPDX-License-Identifier: GPL-2.0+
3 * Kernel Probes (KProbes)
5 * Copyright IBM Corp. 2002, 2006
10 #define pr_fmt(fmt) "kprobes: " fmt
12 #include <linux/moduleloader.h>
13 #include <linux/kprobes.h>
14 #include <linux/ptrace.h>
15 #include <linux/preempt.h>
16 #include <linux/stop_machine.h>
17 #include <linux/kdebug.h>
18 #include <linux/uaccess.h>
19 #include <linux/extable.h>
20 #include <linux/module.h>
21 #include <linux/slab.h>
22 #include <linux/hardirq.h>
23 #include <linux/ftrace.h>
24 #include <asm/set_memory.h>
25 #include <asm/sections.h>
30 DEFINE_PER_CPU(struct kprobe *, current_kprobe);
31 DEFINE_PER_CPU(struct kprobe_ctlblk, kprobe_ctlblk);
33 struct kretprobe_blackpoint kretprobe_blacklist[] = { };
35 static int insn_page_in_use;
37 void *alloc_insn_page(void)
41 page = module_alloc(PAGE_SIZE);
44 set_memory_rox((unsigned long)page, 1);
48 static void *alloc_s390_insn_page(void)
50 if (xchg(&insn_page_in_use, 1) == 1)
52 return &kprobes_insn_page;
55 static void free_s390_insn_page(void *page)
57 xchg(&insn_page_in_use, 0);
60 struct kprobe_insn_cache kprobe_s390_insn_slots = {
61 .mutex = __MUTEX_INITIALIZER(kprobe_s390_insn_slots.mutex),
62 .alloc = alloc_s390_insn_page,
63 .free = free_s390_insn_page,
64 .pages = LIST_HEAD_INIT(kprobe_s390_insn_slots.pages),
65 .insn_size = MAX_INSN_SIZE,
68 static void copy_instruction(struct kprobe *p)
70 kprobe_opcode_t insn[MAX_INSN_SIZE];
75 len = insn_length(*p->addr >> 8);
76 memcpy(&insn, p->addr, len);
78 if (probe_is_insn_relative_long(&insn[0])) {
80 * For pc-relative instructions in RIL-b or RIL-c format patch
81 * the RI2 displacement field. We have already made sure that
82 * the insn slot for the patched instruction is within the same
83 * 2GB area as the original instruction (either kernel image or
84 * module area). Therefore the new displacement will always fit.
86 disp = *(s32 *)&insn[1];
87 addr = (u64)(unsigned long)p->addr;
88 new_addr = (u64)(unsigned long)p->ainsn.insn;
89 new_disp = ((addr + (disp * 2)) - new_addr) / 2;
90 *(s32 *)&insn[1] = new_disp;
92 s390_kernel_write(p->ainsn.insn, &insn, len);
94 NOKPROBE_SYMBOL(copy_instruction);
96 static int s390_get_insn_slot(struct kprobe *p)
99 * Get an insn slot that is within the same 2GB area like the original
100 * instruction. That way instructions with a 32bit signed displacement
101 * field can be patched and executed within the insn slot.
103 p->ainsn.insn = NULL;
104 if (is_kernel((unsigned long)p->addr))
105 p->ainsn.insn = get_s390_insn_slot();
106 else if (is_module_addr(p->addr))
107 p->ainsn.insn = get_insn_slot();
108 return p->ainsn.insn ? 0 : -ENOMEM;
110 NOKPROBE_SYMBOL(s390_get_insn_slot);
112 static void s390_free_insn_slot(struct kprobe *p)
116 if (is_kernel((unsigned long)p->addr))
117 free_s390_insn_slot(p->ainsn.insn, 0);
119 free_insn_slot(p->ainsn.insn, 0);
120 p->ainsn.insn = NULL;
122 NOKPROBE_SYMBOL(s390_free_insn_slot);
124 /* Check if paddr is at an instruction boundary */
125 static bool can_probe(unsigned long paddr)
127 unsigned long addr, offset = 0;
128 kprobe_opcode_t insn;
134 if (!kallsyms_lookup_size_offset(paddr, NULL, &offset))
137 /* Decode instructions */
138 addr = paddr - offset;
139 while (addr < paddr) {
140 if (copy_from_kernel_nofault(&insn, (void *)addr, sizeof(insn)))
143 if (insn >> 8 == 0) {
144 if (insn != BREAKPOINT_INSTRUCTION) {
146 * Note that QEMU inserts opcode 0x0000 to implement
147 * software breakpoints for guests. Since the size of
148 * the original instruction is unknown, stop following
149 * instructions and prevent setting a kprobe.
154 * Check if the instruction has been modified by another
155 * kprobe, in which case the original instruction is
158 kp = get_kprobe((void *)addr);
165 addr += insn_length(insn >> 8);
167 return addr == paddr;
170 int arch_prepare_kprobe(struct kprobe *p)
172 if (!can_probe((unsigned long)p->addr))
174 /* Make sure the probe isn't going on a difficult instruction */
175 if (probe_is_prohibited_opcode(p->addr))
177 if (s390_get_insn_slot(p))
182 NOKPROBE_SYMBOL(arch_prepare_kprobe);
184 struct swap_insn_args {
186 unsigned int arm_kprobe : 1;
189 static int swap_instruction(void *data)
191 struct swap_insn_args *args = data;
192 struct kprobe *p = args->p;
195 opc = args->arm_kprobe ? BREAKPOINT_INSTRUCTION : p->opcode;
196 s390_kernel_write(p->addr, &opc, sizeof(opc));
199 NOKPROBE_SYMBOL(swap_instruction);
201 void arch_arm_kprobe(struct kprobe *p)
203 struct swap_insn_args args = {.p = p, .arm_kprobe = 1};
205 stop_machine_cpuslocked(swap_instruction, &args, NULL);
207 NOKPROBE_SYMBOL(arch_arm_kprobe);
209 void arch_disarm_kprobe(struct kprobe *p)
211 struct swap_insn_args args = {.p = p, .arm_kprobe = 0};
213 stop_machine_cpuslocked(swap_instruction, &args, NULL);
215 NOKPROBE_SYMBOL(arch_disarm_kprobe);
217 void arch_remove_kprobe(struct kprobe *p)
219 s390_free_insn_slot(p);
221 NOKPROBE_SYMBOL(arch_remove_kprobe);
223 static void enable_singlestep(struct kprobe_ctlblk *kcb,
224 struct pt_regs *regs,
227 struct per_regs per_kprobe;
229 /* Set up the PER control registers %cr9-%cr11 */
230 per_kprobe.control = PER_EVENT_IFETCH;
231 per_kprobe.start = ip;
234 /* Save control regs and psw mask */
235 __ctl_store(kcb->kprobe_saved_ctl, 9, 11);
236 kcb->kprobe_saved_imask = regs->psw.mask &
237 (PSW_MASK_PER | PSW_MASK_IO | PSW_MASK_EXT);
239 /* Set PER control regs, turns on single step for the given address */
240 __ctl_load(per_kprobe, 9, 11);
241 regs->psw.mask |= PSW_MASK_PER;
242 regs->psw.mask &= ~(PSW_MASK_IO | PSW_MASK_EXT);
245 NOKPROBE_SYMBOL(enable_singlestep);
247 static void disable_singlestep(struct kprobe_ctlblk *kcb,
248 struct pt_regs *regs,
251 /* Restore control regs and psw mask, set new psw address */
252 __ctl_load(kcb->kprobe_saved_ctl, 9, 11);
253 regs->psw.mask &= ~PSW_MASK_PER;
254 regs->psw.mask |= kcb->kprobe_saved_imask;
257 NOKPROBE_SYMBOL(disable_singlestep);
260 * Activate a kprobe by storing its pointer to current_kprobe. The
261 * previous kprobe is stored in kcb->prev_kprobe. A stack of up to
262 * two kprobes can be active, see KPROBE_REENTER.
264 static void push_kprobe(struct kprobe_ctlblk *kcb, struct kprobe *p)
266 kcb->prev_kprobe.kp = __this_cpu_read(current_kprobe);
267 kcb->prev_kprobe.status = kcb->kprobe_status;
268 __this_cpu_write(current_kprobe, p);
270 NOKPROBE_SYMBOL(push_kprobe);
273 * Deactivate a kprobe by backing up to the previous state. If the
274 * current state is KPROBE_REENTER prev_kprobe.kp will be non-NULL,
275 * for any other state prev_kprobe.kp will be NULL.
277 static void pop_kprobe(struct kprobe_ctlblk *kcb)
279 __this_cpu_write(current_kprobe, kcb->prev_kprobe.kp);
280 kcb->kprobe_status = kcb->prev_kprobe.status;
281 kcb->prev_kprobe.kp = NULL;
283 NOKPROBE_SYMBOL(pop_kprobe);
285 static void kprobe_reenter_check(struct kprobe_ctlblk *kcb, struct kprobe *p)
287 switch (kcb->kprobe_status) {
288 case KPROBE_HIT_SSDONE:
289 case KPROBE_HIT_ACTIVE:
290 kprobes_inc_nmissed_count(p);
296 * A kprobe on the code path to single step an instruction
297 * is a BUG. The code path resides in the .kprobes.text
298 * section and is executed with interrupts disabled.
300 pr_err("Failed to recover from reentered kprobes.\n");
305 NOKPROBE_SYMBOL(kprobe_reenter_check);
307 static int kprobe_handler(struct pt_regs *regs)
309 struct kprobe_ctlblk *kcb;
313 * We want to disable preemption for the entire duration of kprobe
314 * processing. That includes the calls to the pre/post handlers
315 * and single stepping the kprobe instruction.
318 kcb = get_kprobe_ctlblk();
319 p = get_kprobe((void *)(regs->psw.addr - 2));
322 if (kprobe_running()) {
324 * We have hit a kprobe while another is still
325 * active. This can happen in the pre and post
326 * handler. Single step the instruction of the
327 * new probe but do not call any handler function
328 * of this secondary kprobe.
329 * push_kprobe and pop_kprobe saves and restores
330 * the currently active kprobe.
332 kprobe_reenter_check(kcb, p);
334 kcb->kprobe_status = KPROBE_REENTER;
337 * If we have no pre-handler or it returned 0, we
338 * continue with single stepping. If we have a
339 * pre-handler and it returned non-zero, it prepped
340 * for changing execution path, so get out doing
344 kcb->kprobe_status = KPROBE_HIT_ACTIVE;
345 if (p->pre_handler && p->pre_handler(p, regs)) {
347 preempt_enable_no_resched();
350 kcb->kprobe_status = KPROBE_HIT_SS;
352 enable_singlestep(kcb, regs, (unsigned long) p->ainsn.insn);
355 * No kprobe at this address and no active kprobe. The trap has
356 * not been caused by a kprobe breakpoint. The race of breakpoint
357 * vs. kprobe remove does not exist because on s390 as we use
358 * stop_machine to arm/disarm the breakpoints.
360 preempt_enable_no_resched();
363 NOKPROBE_SYMBOL(kprobe_handler);
366 * Called after single-stepping. p->addr is the address of the
367 * instruction whose first byte has been replaced by the "breakpoint"
368 * instruction. To avoid the SMP problems that can occur when we
369 * temporarily put back the original opcode to single-step, we
370 * single-stepped a copy of the instruction. The address of this
371 * copy is p->ainsn.insn.
373 static void resume_execution(struct kprobe *p, struct pt_regs *regs)
375 struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
376 unsigned long ip = regs->psw.addr;
377 int fixup = probe_get_fixup_type(p->ainsn.insn);
379 if (fixup & FIXUP_PSW_NORMAL)
380 ip += (unsigned long) p->addr - (unsigned long) p->ainsn.insn;
382 if (fixup & FIXUP_BRANCH_NOT_TAKEN) {
383 int ilen = insn_length(p->ainsn.insn[0] >> 8);
384 if (ip - (unsigned long) p->ainsn.insn == ilen)
385 ip = (unsigned long) p->addr + ilen;
388 if (fixup & FIXUP_RETURN_REGISTER) {
389 int reg = (p->ainsn.insn[0] & 0xf0) >> 4;
390 regs->gprs[reg] += (unsigned long) p->addr -
391 (unsigned long) p->ainsn.insn;
394 disable_singlestep(kcb, regs, ip);
396 NOKPROBE_SYMBOL(resume_execution);
398 static int post_kprobe_handler(struct pt_regs *regs)
400 struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
401 struct kprobe *p = kprobe_running();
406 resume_execution(p, regs);
407 if (kcb->kprobe_status != KPROBE_REENTER && p->post_handler) {
408 kcb->kprobe_status = KPROBE_HIT_SSDONE;
409 p->post_handler(p, regs, 0);
412 preempt_enable_no_resched();
415 * if somebody else is singlestepping across a probe point, psw mask
416 * will have PER set, in which case, continue the remaining processing
417 * of do_single_step, as if this is not a probe hit.
419 if (regs->psw.mask & PSW_MASK_PER)
424 NOKPROBE_SYMBOL(post_kprobe_handler);
426 static int kprobe_trap_handler(struct pt_regs *regs, int trapnr)
428 struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
429 struct kprobe *p = kprobe_running();
431 switch(kcb->kprobe_status) {
435 * We are here because the instruction being single
436 * stepped caused a page fault. We reset the current
437 * kprobe and the nip points back to the probe address
438 * and allow the page fault handler to continue as a
441 disable_singlestep(kcb, regs, (unsigned long) p->addr);
443 preempt_enable_no_resched();
445 case KPROBE_HIT_ACTIVE:
446 case KPROBE_HIT_SSDONE:
448 * In case the user-specified fault handler returned
449 * zero, try to fix up.
451 if (fixup_exception(regs))
454 * fixup_exception() could not handle it,
455 * Let do_page_fault() fix it.
463 NOKPROBE_SYMBOL(kprobe_trap_handler);
465 int kprobe_fault_handler(struct pt_regs *regs, int trapnr)
469 if (regs->psw.mask & (PSW_MASK_IO | PSW_MASK_EXT))
471 ret = kprobe_trap_handler(regs, trapnr);
472 if (regs->psw.mask & (PSW_MASK_IO | PSW_MASK_EXT))
473 local_irq_restore(regs->psw.mask & ~PSW_MASK_PER);
476 NOKPROBE_SYMBOL(kprobe_fault_handler);
479 * Wrapper routine to for handling exceptions.
481 int kprobe_exceptions_notify(struct notifier_block *self,
482 unsigned long val, void *data)
484 struct die_args *args = (struct die_args *) data;
485 struct pt_regs *regs = args->regs;
486 int ret = NOTIFY_DONE;
488 if (regs->psw.mask & (PSW_MASK_IO | PSW_MASK_EXT))
493 if (kprobe_handler(regs))
497 if (post_kprobe_handler(regs))
501 if (!preemptible() && kprobe_running() &&
502 kprobe_trap_handler(regs, args->trapnr))
509 if (regs->psw.mask & (PSW_MASK_IO | PSW_MASK_EXT))
510 local_irq_restore(regs->psw.mask & ~PSW_MASK_PER);
514 NOKPROBE_SYMBOL(kprobe_exceptions_notify);
516 int __init arch_init_kprobes(void)
521 int arch_trampoline_kprobe(struct kprobe *p)
525 NOKPROBE_SYMBOL(arch_trampoline_kprobe);