Linux Audio

Check our new training course

Loading...
Note: File does not exist in v3.1.
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/*
  3 *  Kernel Probes Jump Optimization (Optprobes)
  4 *
  5 * Copyright (C) IBM Corporation, 2002, 2004
  6 * Copyright (C) Hitachi Ltd., 2012
  7 */
  8#include <linux/kprobes.h>
  9#include <linux/perf_event.h>
 10#include <linux/ptrace.h>
 11#include <linux/string.h>
 12#include <linux/slab.h>
 13#include <linux/hardirq.h>
 14#include <linux/preempt.h>
 15#include <linux/extable.h>
 16#include <linux/kdebug.h>
 17#include <linux/kallsyms.h>
 18#include <linux/kgdb.h>
 19#include <linux/ftrace.h>
 20#include <linux/objtool.h>
 21#include <linux/pgtable.h>
 22#include <linux/static_call.h>
 23
 24#include <asm/text-patching.h>
 25#include <asm/cacheflush.h>
 26#include <asm/desc.h>
 27#include <linux/uaccess.h>
 28#include <asm/alternative.h>
 29#include <asm/insn.h>
 30#include <asm/debugreg.h>
 31#include <asm/set_memory.h>
 32#include <asm/sections.h>
 33#include <asm/nospec-branch.h>
 34
 35#include "common.h"
 36
 37unsigned long __recover_optprobed_insn(kprobe_opcode_t *buf, unsigned long addr)
 38{
 39	struct optimized_kprobe *op;
 40	struct kprobe *kp;
 41	long offs;
 42	int i;
 43
 44	for (i = 0; i < JMP32_INSN_SIZE; i++) {
 45		kp = get_kprobe((void *)addr - i);
 46		/* This function only handles jump-optimized kprobe */
 47		if (kp && kprobe_optimized(kp)) {
 48			op = container_of(kp, struct optimized_kprobe, kp);
 49			/* If op is optimized or under unoptimizing */
 50			if (list_empty(&op->list) || optprobe_queued_unopt(op))
 51				goto found;
 52		}
 53	}
 54
 55	return addr;
 56found:
 57	/*
 58	 * If the kprobe can be optimized, original bytes which can be
 59	 * overwritten by jump destination address. In this case, original
 60	 * bytes must be recovered from op->optinsn.copied_insn buffer.
 61	 */
 62	if (copy_from_kernel_nofault(buf, (void *)addr,
 63		MAX_INSN_SIZE * sizeof(kprobe_opcode_t)))
 64		return 0UL;
 65
 66	if (addr == (unsigned long)kp->addr) {
 67		buf[0] = kp->opcode;
 68		memcpy(buf + 1, op->optinsn.copied_insn, DISP32_SIZE);
 69	} else {
 70		offs = addr - (unsigned long)kp->addr - 1;
 71		memcpy(buf, op->optinsn.copied_insn + offs, DISP32_SIZE - offs);
 72	}
 73
 74	return (unsigned long)buf;
 75}
 76
 77static void synthesize_clac(kprobe_opcode_t *addr)
 78{
 79	/*
 80	 * Can't be static_cpu_has() due to how objtool treats this feature bit.
 81	 * This isn't a fast path anyway.
 82	 */
 83	if (!boot_cpu_has(X86_FEATURE_SMAP))
 84		return;
 85
 86	/* Replace the NOP3 with CLAC */
 87	addr[0] = 0x0f;
 88	addr[1] = 0x01;
 89	addr[2] = 0xca;
 90}
 91
 92/* Insert a move instruction which sets a pointer to eax/rdi (1st arg). */
 93static void synthesize_set_arg1(kprobe_opcode_t *addr, unsigned long val)
 94{
 95#ifdef CONFIG_X86_64
 96	*addr++ = 0x48;
 97	*addr++ = 0xbf;
 98#else
 99	*addr++ = 0xb8;
100#endif
101	*(unsigned long *)addr = val;
102}
103
104asm (
105			".pushsection .rodata\n"
106			"optprobe_template_func:\n"
107			".global optprobe_template_entry\n"
108			"optprobe_template_entry:\n"
109#ifdef CONFIG_X86_64
110			"       pushq $" __stringify(__KERNEL_DS) "\n"
111			/* Save the 'sp - 8', this will be fixed later. */
112			"	pushq %rsp\n"
113			"	pushfq\n"
114			".global optprobe_template_clac\n"
115			"optprobe_template_clac:\n"
116			ASM_NOP3
117			SAVE_REGS_STRING
118			"	movq %rsp, %rsi\n"
119			".global optprobe_template_val\n"
120			"optprobe_template_val:\n"
121			ASM_NOP5
122			ASM_NOP5
123			".global optprobe_template_call\n"
124			"optprobe_template_call:\n"
125			ASM_NOP5
126			/* Copy 'regs->flags' into 'regs->ss'. */
127			"	movq 18*8(%rsp), %rdx\n"
128			"	movq %rdx, 20*8(%rsp)\n"
129			RESTORE_REGS_STRING
130			/* Skip 'regs->flags' and 'regs->sp'. */
131			"	addq $16, %rsp\n"
132			/* And pop flags register from 'regs->ss'. */
133			"	popfq\n"
134#else /* CONFIG_X86_32 */
135			"	pushl %ss\n"
136			/* Save the 'sp - 4', this will be fixed later. */
137			"	pushl %esp\n"
138			"	pushfl\n"
139			".global optprobe_template_clac\n"
140			"optprobe_template_clac:\n"
141			ASM_NOP3
142			SAVE_REGS_STRING
143			"	movl %esp, %edx\n"
144			".global optprobe_template_val\n"
145			"optprobe_template_val:\n"
146			ASM_NOP5
147			".global optprobe_template_call\n"
148			"optprobe_template_call:\n"
149			ASM_NOP5
150			/* Copy 'regs->flags' into 'regs->ss'. */
151			"	movl 14*4(%esp), %edx\n"
152			"	movl %edx, 16*4(%esp)\n"
153			RESTORE_REGS_STRING
154			/* Skip 'regs->flags' and 'regs->sp'. */
155			"	addl $8, %esp\n"
156			/* And pop flags register from 'regs->ss'. */
157			"	popfl\n"
158#endif
159			".global optprobe_template_end\n"
160			"optprobe_template_end:\n"
161			".popsection\n");
162
163void optprobe_template_func(void);
164STACK_FRAME_NON_STANDARD(optprobe_template_func);
165
166#define TMPL_CLAC_IDX \
167	((long)optprobe_template_clac - (long)optprobe_template_entry)
168#define TMPL_MOVE_IDX \
169	((long)optprobe_template_val - (long)optprobe_template_entry)
170#define TMPL_CALL_IDX \
171	((long)optprobe_template_call - (long)optprobe_template_entry)
172#define TMPL_END_IDX \
173	((long)optprobe_template_end - (long)optprobe_template_entry)
174
175/* Optimized kprobe call back function: called from optinsn */
176static void
177optimized_callback(struct optimized_kprobe *op, struct pt_regs *regs)
178{
179	/* This is possible if op is under delayed unoptimizing */
180	if (kprobe_disabled(&op->kp))
181		return;
182
183	preempt_disable();
184	if (kprobe_running()) {
185		kprobes_inc_nmissed_count(&op->kp);
186	} else {
187		struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
188		/* Adjust stack pointer */
189		regs->sp += sizeof(long);
190		/* Save skipped registers */
191		regs->cs = __KERNEL_CS;
192#ifdef CONFIG_X86_32
193		regs->gs = 0;
194#endif
195		regs->ip = (unsigned long)op->kp.addr + INT3_INSN_SIZE;
196		regs->orig_ax = ~0UL;
197
198		__this_cpu_write(current_kprobe, &op->kp);
199		kcb->kprobe_status = KPROBE_HIT_ACTIVE;
200		opt_pre_handler(&op->kp, regs);
201		__this_cpu_write(current_kprobe, NULL);
202	}
203	preempt_enable();
204}
205NOKPROBE_SYMBOL(optimized_callback);
206
207static int copy_optimized_instructions(u8 *dest, u8 *src, u8 *real)
208{
209	struct insn insn;
210	int len = 0, ret;
211
212	while (len < JMP32_INSN_SIZE) {
213		ret = __copy_instruction(dest + len, src + len, real + len, &insn);
214		if (!ret || !can_boost(&insn, src + len))
215			return -EINVAL;
216		len += ret;
217	}
218	/* Check whether the address range is reserved */
219	if (ftrace_text_reserved(src, src + len - 1) ||
220	    alternatives_text_reserved(src, src + len - 1) ||
221	    jump_label_text_reserved(src, src + len - 1) ||
222	    static_call_text_reserved(src, src + len - 1))
223		return -EBUSY;
224
225	return len;
226}
227
228/* Check whether insn is indirect jump */
229static int insn_is_indirect_jump(struct insn *insn)
230{
231	return ((insn->opcode.bytes[0] == 0xff &&
232		(X86_MODRM_REG(insn->modrm.value) & 6) == 4) || /* Jump */
233		insn->opcode.bytes[0] == 0xea);	/* Segment based jump */
234}
235
236/* Check whether insn jumps into specified address range */
237static int insn_jump_into_range(struct insn *insn, unsigned long start, int len)
238{
239	unsigned long target = 0;
240
241	switch (insn->opcode.bytes[0]) {
242	case 0xe0:	/* loopne */
243	case 0xe1:	/* loope */
244	case 0xe2:	/* loop */
245	case 0xe3:	/* jcxz */
246	case 0xe9:	/* near relative jump */
247	case 0xeb:	/* short relative jump */
248		break;
249	case 0x0f:
250		if ((insn->opcode.bytes[1] & 0xf0) == 0x80) /* jcc near */
251			break;
252		return 0;
253	default:
254		if ((insn->opcode.bytes[0] & 0xf0) == 0x70) /* jcc short */
255			break;
256		return 0;
257	}
258	target = (unsigned long)insn->next_byte + insn->immediate.value;
259
260	return (start <= target && target <= start + len);
261}
262
263/* Decode whole function to ensure any instructions don't jump into target */
264static int can_optimize(unsigned long paddr)
265{
266	unsigned long addr, size = 0, offset = 0;
267	struct insn insn;
268	kprobe_opcode_t buf[MAX_INSN_SIZE];
269
270	/* Lookup symbol including addr */
271	if (!kallsyms_lookup_size_offset(paddr, &size, &offset))
272		return 0;
273
274	/*
275	 * Do not optimize in the entry code due to the unstable
276	 * stack handling and registers setup.
277	 */
278	if (((paddr >= (unsigned long)__entry_text_start) &&
279	     (paddr <  (unsigned long)__entry_text_end)))
280		return 0;
281
282	/* Check there is enough space for a relative jump. */
283	if (size - offset < JMP32_INSN_SIZE)
284		return 0;
285
286	/* Decode instructions */
287	addr = paddr - offset;
288	while (addr < paddr - offset + size) { /* Decode until function end */
289		unsigned long recovered_insn;
290		int ret;
291
292		if (search_exception_tables(addr))
293			/*
294			 * Since some fixup code will jumps into this function,
295			 * we can't optimize kprobe in this function.
296			 */
297			return 0;
298		recovered_insn = recover_probed_instruction(buf, addr);
299		if (!recovered_insn)
300			return 0;
301
302		ret = insn_decode_kernel(&insn, (void *)recovered_insn);
303		if (ret < 0)
304			return 0;
305#ifdef CONFIG_KGDB
306		/*
307		 * If there is a dynamically installed kgdb sw breakpoint,
308		 * this function should not be probed.
309		 */
310		if (insn.opcode.bytes[0] == INT3_INSN_OPCODE &&
311		    kgdb_has_hit_break(addr))
312			return 0;
313#endif
314		/* Recover address */
315		insn.kaddr = (void *)addr;
316		insn.next_byte = (void *)(addr + insn.length);
317		/*
318		 * Check any instructions don't jump into target, indirectly or
319		 * directly.
320		 *
321		 * The indirect case is present to handle a code with jump
322		 * tables. When the kernel uses retpolines, the check should in
323		 * theory additionally look for jumps to indirect thunks.
324		 * However, the kernel built with retpolines or IBT has jump
325		 * tables disabled so the check can be skipped altogether.
326		 */
327		if (!IS_ENABLED(CONFIG_MITIGATION_RETPOLINE) &&
328		    !IS_ENABLED(CONFIG_X86_KERNEL_IBT) &&
329		    insn_is_indirect_jump(&insn))
330			return 0;
331		if (insn_jump_into_range(&insn, paddr + INT3_INSN_SIZE,
332					 DISP32_SIZE))
333			return 0;
334		addr += insn.length;
335	}
336
337	return 1;
338}
339
340/* Check optimized_kprobe can actually be optimized. */
341int arch_check_optimized_kprobe(struct optimized_kprobe *op)
342{
343	int i;
344	struct kprobe *p;
345
346	for (i = 1; i < op->optinsn.size; i++) {
347		p = get_kprobe(op->kp.addr + i);
348		if (p && !kprobe_disarmed(p))
349			return -EEXIST;
350	}
351
352	return 0;
353}
354
355/* Check the addr is within the optimized instructions. */
356int arch_within_optimized_kprobe(struct optimized_kprobe *op,
357				 kprobe_opcode_t *addr)
358{
359	return (op->kp.addr <= addr &&
360		op->kp.addr + op->optinsn.size > addr);
361}
362
363/* Free optimized instruction slot */
364static
365void __arch_remove_optimized_kprobe(struct optimized_kprobe *op, int dirty)
366{
367	u8 *slot = op->optinsn.insn;
368	if (slot) {
369		int len = TMPL_END_IDX + op->optinsn.size + JMP32_INSN_SIZE;
370
371		/* Record the perf event before freeing the slot */
372		if (dirty)
373			perf_event_text_poke(slot, slot, len, NULL, 0);
374
375		free_optinsn_slot(slot, dirty);
376		op->optinsn.insn = NULL;
377		op->optinsn.size = 0;
378	}
379}
380
381void arch_remove_optimized_kprobe(struct optimized_kprobe *op)
382{
383	__arch_remove_optimized_kprobe(op, 1);
384}
385
386/*
387 * Copy replacing target instructions
388 * Target instructions MUST be relocatable (checked inside)
389 * This is called when new aggr(opt)probe is allocated or reused.
390 */
391int arch_prepare_optimized_kprobe(struct optimized_kprobe *op,
392				  struct kprobe *__unused)
393{
394	u8 *buf = NULL, *slot;
395	int ret, len;
396	long rel;
397
398	if (!can_optimize((unsigned long)op->kp.addr))
399		return -EILSEQ;
400
401	buf = kzalloc(MAX_OPTINSN_SIZE, GFP_KERNEL);
402	if (!buf)
403		return -ENOMEM;
404
405	op->optinsn.insn = slot = get_optinsn_slot();
406	if (!slot) {
407		ret = -ENOMEM;
408		goto out;
409	}
410
411	/*
412	 * Verify if the address gap is in 2GB range, because this uses
413	 * a relative jump.
414	 */
415	rel = (long)slot - (long)op->kp.addr + JMP32_INSN_SIZE;
416	if (abs(rel) > 0x7fffffff) {
417		ret = -ERANGE;
418		goto err;
419	}
420
421	/* Copy arch-dep-instance from template */
422	memcpy(buf, optprobe_template_entry, TMPL_END_IDX);
423
424	/* Copy instructions into the out-of-line buffer */
425	ret = copy_optimized_instructions(buf + TMPL_END_IDX, op->kp.addr,
426					  slot + TMPL_END_IDX);
427	if (ret < 0)
428		goto err;
429	op->optinsn.size = ret;
430	len = TMPL_END_IDX + op->optinsn.size;
431
432	synthesize_clac(buf + TMPL_CLAC_IDX);
433
434	/* Set probe information */
435	synthesize_set_arg1(buf + TMPL_MOVE_IDX, (unsigned long)op);
436
437	/* Set probe function call */
438	synthesize_relcall(buf + TMPL_CALL_IDX,
439			   slot + TMPL_CALL_IDX, optimized_callback);
440
441	/* Set returning jmp instruction at the tail of out-of-line buffer */
442	synthesize_reljump(buf + len, slot + len,
443			   (u8 *)op->kp.addr + op->optinsn.size);
444	len += JMP32_INSN_SIZE;
445
446	/*
447	 * Note	len = TMPL_END_IDX + op->optinsn.size + JMP32_INSN_SIZE is also
448	 * used in __arch_remove_optimized_kprobe().
449	 */
450
451	/* We have to use text_poke() for instruction buffer because it is RO */
452	perf_event_text_poke(slot, NULL, 0, buf, len);
453	text_poke(slot, buf, len);
454
455	ret = 0;
456out:
457	kfree(buf);
458	return ret;
459
460err:
461	__arch_remove_optimized_kprobe(op, 0);
462	goto out;
463}
464
465/*
466 * Replace breakpoints (INT3) with relative jumps (JMP.d32).
467 * Caller must call with locking kprobe_mutex and text_mutex.
468 *
469 * The caller will have installed a regular kprobe and after that issued
470 * syncrhonize_rcu_tasks(), this ensures that the instruction(s) that live in
471 * the 4 bytes after the INT3 are unused and can now be overwritten.
472 */
473void arch_optimize_kprobes(struct list_head *oplist)
474{
475	struct optimized_kprobe *op, *tmp;
476	u8 insn_buff[JMP32_INSN_SIZE];
477
478	list_for_each_entry_safe(op, tmp, oplist, list) {
479		s32 rel = (s32)((long)op->optinsn.insn -
480			((long)op->kp.addr + JMP32_INSN_SIZE));
481
482		WARN_ON(kprobe_disabled(&op->kp));
483
484		/* Backup instructions which will be replaced by jump address */
485		memcpy(op->optinsn.copied_insn, op->kp.addr + INT3_INSN_SIZE,
486		       DISP32_SIZE);
487
488		insn_buff[0] = JMP32_INSN_OPCODE;
489		*(s32 *)(&insn_buff[1]) = rel;
490
491		text_poke_bp(op->kp.addr, insn_buff, JMP32_INSN_SIZE, NULL);
492
493		list_del_init(&op->list);
494	}
495}
496
497/*
498 * Replace a relative jump (JMP.d32) with a breakpoint (INT3).
499 *
500 * After that, we can restore the 4 bytes after the INT3 to undo what
501 * arch_optimize_kprobes() scribbled. This is safe since those bytes will be
502 * unused once the INT3 lands.
503 */
504void arch_unoptimize_kprobe(struct optimized_kprobe *op)
505{
506	u8 new[JMP32_INSN_SIZE] = { INT3_INSN_OPCODE, };
507	u8 old[JMP32_INSN_SIZE];
508	u8 *addr = op->kp.addr;
509
510	memcpy(old, op->kp.addr, JMP32_INSN_SIZE);
511	memcpy(new + INT3_INSN_SIZE,
512	       op->optinsn.copied_insn,
513	       JMP32_INSN_SIZE - INT3_INSN_SIZE);
514
515	text_poke(addr, new, INT3_INSN_SIZE);
516	text_poke_sync();
517	text_poke(addr + INT3_INSN_SIZE,
518		  new + INT3_INSN_SIZE,
519		  JMP32_INSN_SIZE - INT3_INSN_SIZE);
520	text_poke_sync();
521
522	perf_event_text_poke(op->kp.addr, old, JMP32_INSN_SIZE, new, JMP32_INSN_SIZE);
523}
524
525/*
526 * Recover original instructions and breakpoints from relative jumps.
527 * Caller must call with locking kprobe_mutex.
528 */
529extern void arch_unoptimize_kprobes(struct list_head *oplist,
530				    struct list_head *done_list)
531{
532	struct optimized_kprobe *op, *tmp;
533
534	list_for_each_entry_safe(op, tmp, oplist, list) {
535		arch_unoptimize_kprobe(op);
536		list_move(&op->list, done_list);
537	}
538}
539
540int setup_detour_execution(struct kprobe *p, struct pt_regs *regs, int reenter)
541{
542	struct optimized_kprobe *op;
543
544	if (p->flags & KPROBE_FLAG_OPTIMIZED) {
545		/* This kprobe is really able to run optimized path. */
546		op = container_of(p, struct optimized_kprobe, kp);
547		/* Detour through copied instructions */
548		regs->ip = (unsigned long)op->optinsn.insn + TMPL_END_IDX;
549		if (!reenter)
550			reset_current_kprobe();
551		return 1;
552	}
553	return 0;
554}
555NOKPROBE_SYMBOL(setup_detour_execution);