Linux Audio

Check our new training course

Loading...
v5.4
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 *  Kernel Probes (KProbes)
   4 *
   5 * Copyright (C) IBM Corporation, 2002, 2004
   6 *
   7 * 2002-Oct	Created by Vamsi Krishna S <vamsi_krishna@in.ibm.com> Kernel
   8 *		Probes initial implementation ( includes contributions from
   9 *		Rusty Russell).
  10 * 2004-July	Suparna Bhattacharya <suparna@in.ibm.com> added jumper probes
  11 *		interface to access function arguments.
  12 * 2004-Oct	Jim Keniston <jkenisto@us.ibm.com> and Prasanna S Panchamukhi
  13 *		<prasanna@in.ibm.com> adapted for x86_64 from i386.
  14 * 2005-Mar	Roland McGrath <roland@redhat.com>
  15 *		Fixed to handle %rip-relative addressing mode correctly.
  16 * 2005-May	Hien Nguyen <hien@us.ibm.com>, Jim Keniston
  17 *		<jkenisto@us.ibm.com> and Prasanna S Panchamukhi
  18 *		<prasanna@in.ibm.com> added function-return probes.
  19 * 2005-May	Rusty Lynch <rusty.lynch@intel.com>
  20 *		Added function return probes functionality
  21 * 2006-Feb	Masami Hiramatsu <hiramatu@sdl.hitachi.co.jp> added
  22 *		kprobe-booster and kretprobe-booster for i386.
  23 * 2007-Dec	Masami Hiramatsu <mhiramat@redhat.com> added kprobe-booster
  24 *		and kretprobe-booster for x86-64
  25 * 2007-Dec	Masami Hiramatsu <mhiramat@redhat.com>, Arjan van de Ven
  26 *		<arjan@infradead.org> and Jim Keniston <jkenisto@us.ibm.com>
  27 *		unified x86 kprobes code.
  28 */
  29#include <linux/kprobes.h>
  30#include <linux/ptrace.h>
  31#include <linux/string.h>
  32#include <linux/slab.h>
  33#include <linux/hardirq.h>
  34#include <linux/preempt.h>
  35#include <linux/sched/debug.h>
 
  36#include <linux/extable.h>
  37#include <linux/kdebug.h>
  38#include <linux/kallsyms.h>
 
  39#include <linux/ftrace.h>
  40#include <linux/frame.h>
  41#include <linux/kasan.h>
  42#include <linux/moduleloader.h>
 
 
 
 
 
  43
  44#include <asm/text-patching.h>
  45#include <asm/cacheflush.h>
  46#include <asm/desc.h>
  47#include <asm/pgtable.h>
  48#include <linux/uaccess.h>
  49#include <asm/alternative.h>
  50#include <asm/insn.h>
  51#include <asm/debugreg.h>
  52#include <asm/set_memory.h>
  53
  54#include "common.h"
  55
  56DEFINE_PER_CPU(struct kprobe *, current_kprobe) = NULL;
  57DEFINE_PER_CPU(struct kprobe_ctlblk, kprobe_ctlblk);
  58
  59#define stack_addr(regs) ((unsigned long *)regs->sp)
  60
  61#define W(row, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf)\
  62	(((b0##UL << 0x0)|(b1##UL << 0x1)|(b2##UL << 0x2)|(b3##UL << 0x3) |   \
  63	  (b4##UL << 0x4)|(b5##UL << 0x5)|(b6##UL << 0x6)|(b7##UL << 0x7) |   \
  64	  (b8##UL << 0x8)|(b9##UL << 0x9)|(ba##UL << 0xa)|(bb##UL << 0xb) |   \
  65	  (bc##UL << 0xc)|(bd##UL << 0xd)|(be##UL << 0xe)|(bf##UL << 0xf))    \
  66	 << (row % 32))
  67	/*
  68	 * Undefined/reserved opcodes, conditional jump, Opcode Extension
  69	 * Groups, and some special opcodes can not boost.
  70	 * This is non-const and volatile to keep gcc from statically
  71	 * optimizing it out, as variable_test_bit makes gcc think only
  72	 * *(unsigned long*) is used.
  73	 */
  74static volatile u32 twobyte_is_boostable[256 / 32] = {
  75	/*      0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f          */
  76	/*      ----------------------------------------------          */
  77	W(0x00, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0) | /* 00 */
  78	W(0x10, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1) , /* 10 */
  79	W(0x20, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) | /* 20 */
  80	W(0x30, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) , /* 30 */
  81	W(0x40, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1) | /* 40 */
  82	W(0x50, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) , /* 50 */
  83	W(0x60, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 1, 1) | /* 60 */
  84	W(0x70, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1) , /* 70 */
  85	W(0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) | /* 80 */
  86	W(0x90, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1) , /* 90 */
  87	W(0xa0, 1, 1, 0, 1, 1, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1) | /* a0 */
  88	W(0xb0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 1, 1, 1, 1) , /* b0 */
  89	W(0xc0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1) | /* c0 */
  90	W(0xd0, 0, 1, 1, 1, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1) , /* d0 */
  91	W(0xe0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1) | /* e0 */
  92	W(0xf0, 0, 1, 1, 1, 0, 1, 0, 0, 1, 1, 1, 0, 1, 1, 1, 0)   /* f0 */
  93	/*      -----------------------------------------------         */
  94	/*      0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f          */
  95};
  96#undef W
  97
  98struct kretprobe_blackpoint kretprobe_blacklist[] = {
  99	{"__switch_to", }, /* This function switches only current task, but
 100			      doesn't switch kernel stack.*/
 101	{NULL, NULL}	/* Terminator */
 102};
 103
 104const int kretprobe_blacklist_size = ARRAY_SIZE(kretprobe_blacklist);
 105
 106static nokprobe_inline void
 107__synthesize_relative_insn(void *dest, void *from, void *to, u8 op)
 108{
 109	struct __arch_relative_insn {
 110		u8 op;
 111		s32 raddr;
 112	} __packed *insn;
 113
 114	insn = (struct __arch_relative_insn *)dest;
 115	insn->raddr = (s32)((long)(to) - ((long)(from) + 5));
 116	insn->op = op;
 117}
 118
 119/* Insert a jump instruction at address 'from', which jumps to address 'to'.*/
 120void synthesize_reljump(void *dest, void *from, void *to)
 121{
 122	__synthesize_relative_insn(dest, from, to, RELATIVEJUMP_OPCODE);
 123}
 124NOKPROBE_SYMBOL(synthesize_reljump);
 125
 126/* Insert a call instruction at address 'from', which calls address 'to'.*/
 127void synthesize_relcall(void *dest, void *from, void *to)
 128{
 129	__synthesize_relative_insn(dest, from, to, RELATIVECALL_OPCODE);
 130}
 131NOKPROBE_SYMBOL(synthesize_relcall);
 132
 133/*
 134 * Skip the prefixes of the instruction.
 135 */
 136static kprobe_opcode_t *skip_prefixes(kprobe_opcode_t *insn)
 137{
 138	insn_attr_t attr;
 139
 140	attr = inat_get_opcode_attribute((insn_byte_t)*insn);
 141	while (inat_is_legacy_prefix(attr)) {
 142		insn++;
 143		attr = inat_get_opcode_attribute((insn_byte_t)*insn);
 144	}
 145#ifdef CONFIG_X86_64
 146	if (inat_is_rex_prefix(attr))
 147		insn++;
 148#endif
 149	return insn;
 150}
 151NOKPROBE_SYMBOL(skip_prefixes);
 152
 153/*
 154 * Returns non-zero if INSN is boostable.
 155 * RIP relative instructions are adjusted at copying time in 64 bits mode
 156 */
 157int can_boost(struct insn *insn, void *addr)
 158{
 159	kprobe_opcode_t opcode;
 
 
 160
 161	if (search_exception_tables((unsigned long)addr))
 162		return 0;	/* Page fault may occur on this address. */
 163
 164	/* 2nd-byte opcode */
 165	if (insn->opcode.nbytes == 2)
 166		return test_bit(insn->opcode.bytes[1],
 167				(unsigned long *)twobyte_is_boostable);
 168
 169	if (insn->opcode.nbytes != 1)
 170		return 0;
 171
 172	/* Can't boost Address-size override prefix */
 173	if (unlikely(inat_is_address_size_prefix(insn->attr)))
 174		return 0;
 
 
 
 
 
 175
 176	opcode = insn->opcode.bytes[0];
 177
 178	switch (opcode & 0xf0) {
 179	case 0x60:
 180		/* can't boost "bound" */
 181		return (opcode != 0x62);
 182	case 0x70:
 183		return 0; /* can't boost conditional jump */
 184	case 0x90:
 185		return opcode != 0x9a;	/* can't boost call far */
 186	case 0xc0:
 187		/* can't boost software-interruptions */
 188		return (0xc1 < opcode && opcode < 0xcc) || opcode == 0xcf;
 189	case 0xd0:
 190		/* can boost AA* and XLAT */
 191		return (opcode == 0xd4 || opcode == 0xd5 || opcode == 0xd7);
 192	case 0xe0:
 193		/* can boost in/out and absolute jmps */
 194		return ((opcode & 0x04) || opcode == 0xea);
 195	case 0xf0:
 196		/* clear and set flags are boostable */
 197		return (opcode == 0xf5 || (0xf7 < opcode && opcode < 0xfe));
 
 
 
 
 
 
 
 
 
 
 
 198	default:
 199		/* CS override prefix and call are not boostable */
 200		return (opcode != 0x2e && opcode != 0x9a);
 201	}
 202}
 203
 204static unsigned long
 205__recover_probed_insn(kprobe_opcode_t *buf, unsigned long addr)
 206{
 207	struct kprobe *kp;
 208	unsigned long faddr;
 209
 210	kp = get_kprobe((void *)addr);
 211	faddr = ftrace_location(addr);
 212	/*
 213	 * Addresses inside the ftrace location are refused by
 214	 * arch_check_ftrace_location(). Something went terribly wrong
 215	 * if such an address is checked here.
 216	 */
 217	if (WARN_ON(faddr && faddr != addr))
 218		return 0UL;
 219	/*
 220	 * Use the current code if it is not modified by Kprobe
 221	 * and it cannot be modified by ftrace.
 222	 */
 223	if (!kp && !faddr)
 224		return addr;
 225
 226	/*
 227	 * Basically, kp->ainsn.insn has an original instruction.
 228	 * However, RIP-relative instruction can not do single-stepping
 229	 * at different place, __copy_instruction() tweaks the displacement of
 230	 * that instruction. In that case, we can't recover the instruction
 231	 * from the kp->ainsn.insn.
 232	 *
 233	 * On the other hand, in case on normal Kprobe, kp->opcode has a copy
 234	 * of the first byte of the probed instruction, which is overwritten
 235	 * by int3. And the instruction at kp->addr is not modified by kprobes
 236	 * except for the first byte, we can recover the original instruction
 237	 * from it and kp->opcode.
 238	 *
 239	 * In case of Kprobes using ftrace, we do not have a copy of
 240	 * the original instruction. In fact, the ftrace location might
 241	 * be modified at anytime and even could be in an inconsistent state.
 242	 * Fortunately, we know that the original code is the ideal 5-byte
 243	 * long NOP.
 244	 */
 245	if (probe_kernel_read(buf, (void *)addr,
 246		MAX_INSN_SIZE * sizeof(kprobe_opcode_t)))
 247		return 0UL;
 248
 249	if (faddr)
 250		memcpy(buf, ideal_nops[NOP_ATOMIC5], 5);
 251	else
 252		buf[0] = kp->opcode;
 253	return (unsigned long)buf;
 254}
 255
 256/*
 257 * Recover the probed instruction at addr for further analysis.
 258 * Caller must lock kprobes by kprobe_mutex, or disable preemption
 259 * for preventing to release referencing kprobes.
 260 * Returns zero if the instruction can not get recovered (or access failed).
 261 */
 262unsigned long recover_probed_instruction(kprobe_opcode_t *buf, unsigned long addr)
 263{
 264	unsigned long __addr;
 265
 266	__addr = __recover_optprobed_insn(buf, addr);
 267	if (__addr != addr)
 268		return __addr;
 269
 270	return __recover_probed_insn(buf, addr);
 271}
 272
 273/* Check if paddr is at an instruction boundary */
 274static int can_probe(unsigned long paddr)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 275{
 276	unsigned long addr, __addr, offset = 0;
 277	struct insn insn;
 278	kprobe_opcode_t buf[MAX_INSN_SIZE];
 279
 280	if (!kallsyms_lookup_size_offset(paddr, NULL, &offset))
 281		return 0;
 282
 283	/* Decode instructions */
 284	addr = paddr - offset;
 285	while (addr < paddr) {
 286		/*
 287		 * Check if the instruction has been modified by another
 288		 * kprobe, in which case we replace the breakpoint by the
 289		 * original instruction in our buffer.
 290		 * Also, jump optimization will change the breakpoint to
 291		 * relative-jump. Since the relative-jump itself is
 292		 * normally used, we just go through if there is no kprobe.
 293		 */
 294		__addr = recover_probed_instruction(buf, addr);
 295		if (!__addr)
 296			return 0;
 297		kernel_insn_init(&insn, (void *)__addr, MAX_INSN_SIZE);
 298		insn_get_length(&insn);
 299
 
 
 
 
 300		/*
 301		 * Another debugging subsystem might insert this breakpoint.
 302		 * In that case, we can't recover it.
 303		 */
 304		if (insn.opcode.bytes[0] == BREAKPOINT_INSTRUCTION)
 305			return 0;
 
 
 306		addr += insn.length;
 307	}
 308
 309	return (addr == paddr);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 310}
 311
 312/*
 313 * Returns non-zero if opcode modifies the interrupt flag.
 314 */
 315static int is_IF_modifier(kprobe_opcode_t *insn)
 316{
 317	/* Skip prefixes */
 318	insn = skip_prefixes(insn);
 319
 320	switch (*insn) {
 321	case 0xfa:		/* cli */
 322	case 0xfb:		/* sti */
 323	case 0xcf:		/* iret/iretd */
 324	case 0x9d:		/* popf/popfd */
 325		return 1;
 
 
 
 
 
 
 
 
 326	}
 327
 328	return 0;
 329}
 330
 331/*
 332 * Copy an instruction with recovering modified instruction by kprobes
 333 * and adjust the displacement if the instruction uses the %rip-relative
 334 * addressing mode. Note that since @real will be the final place of copied
 335 * instruction, displacement must be adjust by @real, not @dest.
 336 * This returns the length of copied instruction, or 0 if it has an error.
 337 */
 338int __copy_instruction(u8 *dest, u8 *src, u8 *real, struct insn *insn)
 339{
 340	kprobe_opcode_t buf[MAX_INSN_SIZE];
 341	unsigned long recovered_insn =
 342		recover_probed_instruction(buf, (unsigned long)src);
 343
 344	if (!recovered_insn || !insn)
 345		return 0;
 346
 347	/* This can access kernel text if given address is not recovered */
 348	if (probe_kernel_read(dest, (void *)recovered_insn, MAX_INSN_SIZE))
 
 349		return 0;
 350
 351	kernel_insn_init(insn, dest, MAX_INSN_SIZE);
 352	insn_get_length(insn);
 
 
 
 
 
 353
 354	/* Another subsystem puts a breakpoint, failed to recover */
 355	if (insn->opcode.bytes[0] == BREAKPOINT_INSTRUCTION)
 356		return 0;
 357
 358	/* We should not singlestep on the exception masking instructions */
 359	if (insn_masking_exception(insn))
 360		return 0;
 361
 362#ifdef CONFIG_X86_64
 363	/* Only x86_64 has RIP relative instructions */
 364	if (insn_rip_relative(insn)) {
 365		s64 newdisp;
 366		u8 *disp;
 367		/*
 368		 * The copied instruction uses the %rip-relative addressing
 369		 * mode.  Adjust the displacement for the difference between
 370		 * the original location of this instruction and the location
 371		 * of the copy that will actually be run.  The tricky bit here
 372		 * is making sure that the sign extension happens correctly in
 373		 * this calculation, since we need a signed 32-bit result to
 374		 * be sign-extended to 64 bits when it's added to the %rip
 375		 * value and yield the same 64-bit result that the sign-
 376		 * extension of the original signed 32-bit displacement would
 377		 * have given.
 378		 */
 379		newdisp = (u8 *) src + (s64) insn->displacement.value
 380			  - (u8 *) real;
 381		if ((s64) (s32) newdisp != newdisp) {
 382			pr_err("Kprobes error: new displacement does not fit into s32 (%llx)\n", newdisp);
 383			return 0;
 384		}
 385		disp = (u8 *) dest + insn_offset_displacement(insn);
 386		*(s32 *) disp = (s32) newdisp;
 387	}
 388#endif
 389	return insn->length;
 390}
 391
 392/* Prepare reljump right after instruction to boost */
 393static int prepare_boost(kprobe_opcode_t *buf, struct kprobe *p,
 394			  struct insn *insn)
 395{
 396	int len = insn->length;
 397
 398	if (can_boost(insn, p->addr) &&
 399	    MAX_INSN_SIZE - len >= RELATIVEJUMP_SIZE) {
 
 400		/*
 401		 * These instructions can be executed directly if it
 402		 * jumps back to correct address.
 403		 */
 404		synthesize_reljump(buf + len, p->ainsn.insn + len,
 405				   p->addr + insn->length);
 406		len += RELATIVEJUMP_SIZE;
 407		p->ainsn.boostable = true;
 408	} else {
 409		p->ainsn.boostable = false;
 
 
 
 
 
 410	}
 411
 412	return len;
 413}
 414
 415/* Make page to RO mode when allocate it */
 416void *alloc_insn_page(void)
 417{
 418	void *page;
 419
 420	page = module_alloc(PAGE_SIZE);
 421	if (!page)
 422		return NULL;
 423
 424	set_vm_flush_reset_perms(page);
 425	/*
 426	 * First make the page read-only, and only then make it executable to
 427	 * prevent it from being W+X in between.
 428	 */
 429	set_memory_ro((unsigned long)page, 1);
 430
 431	/*
 432	 * TODO: Once additional kernel code protection mechanisms are set, ensure
 433	 * that the page was not maliciously altered and it is still zeroed.
 434	 */
 435	set_memory_x((unsigned long)page, 1);
 436
 437	return page;
 438}
 439
 440/* Recover page to RW mode before releasing it */
 441void free_insn_page(void *page)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 442{
 443	module_memfree(page);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 444}
 445
 446static int arch_copy_kprobe(struct kprobe *p)
 447{
 448	struct insn insn;
 449	kprobe_opcode_t buf[MAX_INSN_SIZE];
 450	int len;
 451
 452	/* Copy an instruction with recovering if other optprobe modifies it.*/
 453	len = __copy_instruction(buf, p->addr, p->ainsn.insn, &insn);
 454	if (!len)
 455		return -EINVAL;
 456
 457	/*
 458	 * __copy_instruction can modify the displacement of the instruction,
 459	 * but it doesn't affect boostable check.
 460	 */
 461	len = prepare_boost(buf, p, &insn);
 462
 463	/* Check whether the instruction modifies Interrupt Flag or not */
 464	p->ainsn.if_modifier = is_IF_modifier(buf);
 
 
 465
 466	/* Also, displacement change doesn't affect the first byte */
 467	p->opcode = buf[0];
 468
 
 
 
 469	/* OK, write back the instruction(s) into ROX insn buffer */
 470	text_poke(p->ainsn.insn, buf, len);
 471
 472	return 0;
 473}
 474
 475int arch_prepare_kprobe(struct kprobe *p)
 476{
 477	int ret;
 478
 479	if (alternatives_text_reserved(p->addr, p->addr))
 480		return -EINVAL;
 481
 482	if (!can_probe((unsigned long)p->addr))
 483		return -EILSEQ;
 
 
 
 484	/* insn: must be on special executable page on x86. */
 485	p->ainsn.insn = get_insn_slot();
 486	if (!p->ainsn.insn)
 487		return -ENOMEM;
 488
 489	ret = arch_copy_kprobe(p);
 490	if (ret) {
 491		free_insn_slot(p->ainsn.insn, 0);
 492		p->ainsn.insn = NULL;
 493	}
 494
 495	return ret;
 496}
 497
 498void arch_arm_kprobe(struct kprobe *p)
 499{
 500	text_poke(p->addr, ((unsigned char []){BREAKPOINT_INSTRUCTION}), 1);
 
 
 
 
 501}
 502
 503void arch_disarm_kprobe(struct kprobe *p)
 504{
 
 
 
 505	text_poke(p->addr, &p->opcode, 1);
 
 506}
 507
 508void arch_remove_kprobe(struct kprobe *p)
 509{
 510	if (p->ainsn.insn) {
 
 
 
 511		free_insn_slot(p->ainsn.insn, p->ainsn.boostable);
 512		p->ainsn.insn = NULL;
 513	}
 514}
 515
 516static nokprobe_inline void
 517save_previous_kprobe(struct kprobe_ctlblk *kcb)
 518{
 519	kcb->prev_kprobe.kp = kprobe_running();
 520	kcb->prev_kprobe.status = kcb->kprobe_status;
 521	kcb->prev_kprobe.old_flags = kcb->kprobe_old_flags;
 522	kcb->prev_kprobe.saved_flags = kcb->kprobe_saved_flags;
 523}
 524
 525static nokprobe_inline void
 526restore_previous_kprobe(struct kprobe_ctlblk *kcb)
 527{
 528	__this_cpu_write(current_kprobe, kcb->prev_kprobe.kp);
 529	kcb->kprobe_status = kcb->prev_kprobe.status;
 530	kcb->kprobe_old_flags = kcb->prev_kprobe.old_flags;
 531	kcb->kprobe_saved_flags = kcb->prev_kprobe.saved_flags;
 532}
 533
 534static nokprobe_inline void
 535set_current_kprobe(struct kprobe *p, struct pt_regs *regs,
 536		   struct kprobe_ctlblk *kcb)
 537{
 538	__this_cpu_write(current_kprobe, p);
 539	kcb->kprobe_saved_flags = kcb->kprobe_old_flags
 540		= (regs->flags & (X86_EFLAGS_TF | X86_EFLAGS_IF));
 541	if (p->ainsn.if_modifier)
 542		kcb->kprobe_saved_flags &= ~X86_EFLAGS_IF;
 543}
 544
 545static nokprobe_inline void clear_btf(void)
 
 546{
 547	if (test_thread_flag(TIF_BLOCKSTEP)) {
 548		unsigned long debugctl = get_debugctlmsr();
 549
 550		debugctl &= ~DEBUGCTLMSR_BTF;
 551		update_debugctlmsr(debugctl);
 552	}
 553}
 554
 555static nokprobe_inline void restore_btf(void)
 556{
 557	if (test_thread_flag(TIF_BLOCKSTEP)) {
 558		unsigned long debugctl = get_debugctlmsr();
 559
 560		debugctl |= DEBUGCTLMSR_BTF;
 561		update_debugctlmsr(debugctl);
 562	}
 563}
 564
 565void arch_prepare_kretprobe(struct kretprobe_instance *ri, struct pt_regs *regs)
 566{
 567	unsigned long *sara = stack_addr(regs);
 568
 569	ri->ret_addr = (kprobe_opcode_t *) *sara;
 570	ri->fp = sara;
 571
 572	/* Replace the return addr with trampoline addr */
 573	*sara = (unsigned long) &kretprobe_trampoline;
 574}
 575NOKPROBE_SYMBOL(arch_prepare_kretprobe);
 576
 577static void setup_singlestep(struct kprobe *p, struct pt_regs *regs,
 578			     struct kprobe_ctlblk *kcb, int reenter)
 579{
 580	if (setup_detour_execution(p, regs, reenter))
 581		return;
 582
 583#if !defined(CONFIG_PREEMPTION)
 584	if (p->ainsn.boostable && !p->post_handler) {
 585		/* Boost up -- we can execute copied instructions directly */
 586		if (!reenter)
 587			reset_current_kprobe();
 588		/*
 589		 * Reentering boosted probe doesn't reset current_kprobe,
 590		 * nor set current_kprobe, because it doesn't use single
 591		 * stepping.
 592		 */
 593		regs->ip = (unsigned long)p->ainsn.insn;
 594		return;
 595	}
 596#endif
 597	if (reenter) {
 598		save_previous_kprobe(kcb);
 599		set_current_kprobe(p, regs, kcb);
 600		kcb->kprobe_status = KPROBE_REENTER;
 601	} else
 602		kcb->kprobe_status = KPROBE_HIT_SS;
 603	/* Prepare real single stepping */
 604	clear_btf();
 605	regs->flags |= X86_EFLAGS_TF;
 
 
 
 
 
 606	regs->flags &= ~X86_EFLAGS_IF;
 607	/* single step inline if the instruction is an int3 */
 608	if (p->opcode == BREAKPOINT_INSTRUCTION)
 609		regs->ip = (unsigned long)p->addr;
 610	else
 611		regs->ip = (unsigned long)p->ainsn.insn;
 612}
 613NOKPROBE_SYMBOL(setup_singlestep);
 614
 615/*
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 616 * We have reentered the kprobe_handler(), since another probe was hit while
 617 * within the handler. We save the original kprobes variables and just single
 618 * step on the instruction of the new probe without calling any user handlers.
 619 */
 620static int reenter_kprobe(struct kprobe *p, struct pt_regs *regs,
 621			  struct kprobe_ctlblk *kcb)
 622{
 623	switch (kcb->kprobe_status) {
 624	case KPROBE_HIT_SSDONE:
 625	case KPROBE_HIT_ACTIVE:
 626	case KPROBE_HIT_SS:
 627		kprobes_inc_nmissed_count(p);
 628		setup_singlestep(p, regs, kcb, 1);
 629		break;
 630	case KPROBE_REENTER:
 631		/* A probe has been hit in the codepath leading up to, or just
 632		 * after, single-stepping of a probed instruction. This entire
 633		 * codepath should strictly reside in .kprobes.text section.
 634		 * Raise a BUG or we'll continue in an endless reentering loop
 635		 * and eventually a stack overflow.
 636		 */
 637		pr_err("Unrecoverable kprobe detected.\n");
 638		dump_kprobe(p);
 639		BUG();
 640	default:
 641		/* impossible cases */
 642		WARN_ON(1);
 643		return 0;
 644	}
 645
 646	return 1;
 647}
 648NOKPROBE_SYMBOL(reenter_kprobe);
 649
 
 
 
 
 
 
 650/*
 651 * Interrupts are disabled on entry as trap3 is an interrupt gate and they
 652 * remain disabled throughout this function.
 653 */
 654int kprobe_int3_handler(struct pt_regs *regs)
 655{
 656	kprobe_opcode_t *addr;
 657	struct kprobe *p;
 658	struct kprobe_ctlblk *kcb;
 659
 660	if (user_mode(regs))
 661		return 0;
 662
 663	addr = (kprobe_opcode_t *)(regs->ip - sizeof(kprobe_opcode_t));
 664	/*
 665	 * We don't want to be preempted for the entire duration of kprobe
 666	 * processing. Since int3 and debug trap disables irqs and we clear
 667	 * IF while singlestepping, it must be no preemptible.
 668	 */
 669
 670	kcb = get_kprobe_ctlblk();
 671	p = get_kprobe(addr);
 672
 673	if (p) {
 674		if (kprobe_running()) {
 675			if (reenter_kprobe(p, regs, kcb))
 676				return 1;
 677		} else {
 678			set_current_kprobe(p, regs, kcb);
 679			kcb->kprobe_status = KPROBE_HIT_ACTIVE;
 680
 681			/*
 682			 * If we have no pre-handler or it returned 0, we
 683			 * continue with normal processing.  If we have a
 684			 * pre-handler and it returned non-zero, that means
 685			 * user handler setup registers to exit to another
 686			 * instruction, we must skip the single stepping.
 687			 */
 688			if (!p->pre_handler || !p->pre_handler(p, regs))
 689				setup_singlestep(p, regs, kcb, 0);
 690			else
 691				reset_current_kprobe();
 692			return 1;
 693		}
 694	} else if (*addr != BREAKPOINT_INSTRUCTION) {
 695		/*
 696		 * The breakpoint instruction was removed right
 697		 * after we hit it.  Another cpu has removed
 698		 * either a probepoint or a debugger breakpoint
 699		 * at this address.  In either case, no further
 700		 * handling of this interrupt is appropriate.
 701		 * Back up over the (now missing) int3 and run
 702		 * the original instruction.
 703		 */
 704		regs->ip = (unsigned long)addr;
 705		return 1;
 706	} /* else: not a kprobe fault; let the kernel handle it */
 707
 708	return 0;
 709}
 710NOKPROBE_SYMBOL(kprobe_int3_handler);
 711
 712/*
 713 * When a retprobed function returns, this code saves registers and
 714 * calls trampoline_handler() runs, which calls the kretprobe's handler.
 715 */
 716asm(
 717	".text\n"
 718	".global kretprobe_trampoline\n"
 719	".type kretprobe_trampoline, @function\n"
 720	"kretprobe_trampoline:\n"
 721	/* We don't bother saving the ss register */
 722#ifdef CONFIG_X86_64
 723	"	pushq %rsp\n"
 724	"	pushfq\n"
 725	SAVE_REGS_STRING
 726	"	movq %rsp, %rdi\n"
 727	"	call trampoline_handler\n"
 728	/* Replace saved sp with true return address. */
 729	"	movq %rax, 19*8(%rsp)\n"
 730	RESTORE_REGS_STRING
 731	"	popfq\n"
 732#else
 733	"	pushl %esp\n"
 734	"	pushfl\n"
 735	SAVE_REGS_STRING
 736	"	movl %esp, %eax\n"
 737	"	call trampoline_handler\n"
 738	/* Replace saved sp with true return address. */
 739	"	movl %eax, 15*4(%esp)\n"
 740	RESTORE_REGS_STRING
 741	"	popfl\n"
 742#endif
 743	"	ret\n"
 744	".size kretprobe_trampoline, .-kretprobe_trampoline\n"
 745);
 746NOKPROBE_SYMBOL(kretprobe_trampoline);
 747STACK_FRAME_NON_STANDARD(kretprobe_trampoline);
 748
 749static struct kprobe kretprobe_kprobe = {
 750	.addr = (void *)kretprobe_trampoline,
 751};
 752
 753/*
 754 * Called from kretprobe_trampoline
 755 */
 756__used __visible void *trampoline_handler(struct pt_regs *regs)
 757{
 758	struct kprobe_ctlblk *kcb;
 759	struct kretprobe_instance *ri = NULL;
 760	struct hlist_head *head, empty_rp;
 761	struct hlist_node *tmp;
 762	unsigned long flags, orig_ret_address = 0;
 763	unsigned long trampoline_address = (unsigned long)&kretprobe_trampoline;
 764	kprobe_opcode_t *correct_ret_addr = NULL;
 765	void *frame_pointer;
 766	bool skipped = false;
 767
 768	preempt_disable();
 769
 770	/*
 771	 * Set a dummy kprobe for avoiding kretprobe recursion.
 772	 * Since kretprobe never run in kprobe handler, kprobe must not
 773	 * be running at this point.
 774	 */
 775	kcb = get_kprobe_ctlblk();
 776	__this_cpu_write(current_kprobe, &kretprobe_kprobe);
 777	kcb->kprobe_status = KPROBE_HIT_ACTIVE;
 778
 779	INIT_HLIST_HEAD(&empty_rp);
 780	kretprobe_hash_lock(current, &head, &flags);
 781	/* fixup registers */
 782	regs->cs = __KERNEL_CS;
 783#ifdef CONFIG_X86_32
 784	regs->cs |= get_kernel_rpl();
 785	regs->gs = 0;
 786#endif
 787	/* We use pt_regs->sp for return address holder. */
 788	frame_pointer = &regs->sp;
 789	regs->ip = trampoline_address;
 790	regs->orig_ax = ~0UL;
 791
 792	/*
 793	 * It is possible to have multiple instances associated with a given
 794	 * task either because multiple functions in the call path have
 795	 * return probes installed on them, and/or more than one
 796	 * return probe was registered for a target function.
 797	 *
 798	 * We can handle this because:
 799	 *     - instances are always pushed into the head of the list
 800	 *     - when multiple return probes are registered for the same
 801	 *	 function, the (chronologically) first instance's ret_addr
 802	 *	 will be the real return address, and all the rest will
 803	 *	 point to kretprobe_trampoline.
 804	 */
 805	hlist_for_each_entry(ri, head, hlist) {
 806		if (ri->task != current)
 807			/* another task is sharing our hash bucket */
 808			continue;
 809		/*
 810		 * Return probes must be pushed on this hash list correct
 811		 * order (same as return order) so that it can be popped
 812		 * correctly. However, if we find it is pushed it incorrect
 813		 * order, this means we find a function which should not be
 814		 * probed, because the wrong order entry is pushed on the
 815		 * path of processing other kretprobe itself.
 816		 */
 817		if (ri->fp != frame_pointer) {
 818			if (!skipped)
 819				pr_warn("kretprobe is stacked incorrectly. Trying to fixup.\n");
 820			skipped = true;
 821			continue;
 822		}
 823
 824		orig_ret_address = (unsigned long)ri->ret_addr;
 825		if (skipped)
 826			pr_warn("%ps must be blacklisted because of incorrect kretprobe order\n",
 827				ri->rp->kp.addr);
 828
 829		if (orig_ret_address != trampoline_address)
 830			/*
 831			 * This is the real return address. Any other
 832			 * instances associated with this task are for
 833			 * other calls deeper on the call stack
 834			 */
 835			break;
 836	}
 837
 838	kretprobe_assert(ri, orig_ret_address, trampoline_address);
 839
 840	correct_ret_addr = ri->ret_addr;
 841	hlist_for_each_entry_safe(ri, tmp, head, hlist) {
 842		if (ri->task != current)
 843			/* another task is sharing our hash bucket */
 844			continue;
 845		if (ri->fp != frame_pointer)
 846			continue;
 847
 848		orig_ret_address = (unsigned long)ri->ret_addr;
 849		if (ri->rp && ri->rp->handler) {
 850			__this_cpu_write(current_kprobe, &ri->rp->kp);
 851			ri->ret_addr = correct_ret_addr;
 852			ri->rp->handler(ri, regs);
 853			__this_cpu_write(current_kprobe, &kretprobe_kprobe);
 854		}
 855
 856		recycle_rp_inst(ri, &empty_rp);
 857
 858		if (orig_ret_address != trampoline_address)
 859			/*
 860			 * This is the real return address. Any other
 861			 * instances associated with this task are for
 862			 * other calls deeper on the call stack
 863			 */
 864			break;
 865	}
 866
 867	kretprobe_hash_unlock(current, &flags);
 868
 869	__this_cpu_write(current_kprobe, NULL);
 870	preempt_enable();
 871
 872	hlist_for_each_entry_safe(ri, tmp, &empty_rp, hlist) {
 873		hlist_del(&ri->hlist);
 874		kfree(ri);
 875	}
 876	return (void *)orig_ret_address;
 877}
 878NOKPROBE_SYMBOL(trampoline_handler);
 879
 880/*
 881 * Called after single-stepping.  p->addr is the address of the
 882 * instruction whose first byte has been replaced by the "int 3"
 883 * instruction.  To avoid the SMP problems that can occur when we
 884 * temporarily put back the original opcode to single-step, we
 885 * single-stepped a copy of the instruction.  The address of this
 886 * copy is p->ainsn.insn.
 887 *
 888 * This function prepares to return from the post-single-step
 889 * interrupt.  We have to fix up the stack as follows:
 890 *
 891 * 0) Except in the case of absolute or indirect jump or call instructions,
 892 * the new ip is relative to the copied instruction.  We need to make
 893 * it relative to the original instruction.
 894 *
 895 * 1) If the single-stepped instruction was pushfl, then the TF and IF
 896 * flags are set in the just-pushed flags, and may need to be cleared.
 897 *
 898 * 2) If the single-stepped instruction was a call, the return address
 899 * that is atop the stack is the address following the copied instruction.
 900 * We need to make it the address following the original instruction.
 901 *
 902 * If this is the first time we've single-stepped the instruction at
 903 * this probepoint, and the instruction is boostable, boost it: add a
 904 * jump instruction after the copied instruction, that jumps to the next
 905 * instruction after the probepoint.
 906 */
 907static void resume_execution(struct kprobe *p, struct pt_regs *regs,
 908			     struct kprobe_ctlblk *kcb)
 909{
 910	unsigned long *tos = stack_addr(regs);
 911	unsigned long copy_ip = (unsigned long)p->ainsn.insn;
 912	unsigned long orig_ip = (unsigned long)p->addr;
 913	kprobe_opcode_t *insn = p->ainsn.insn;
 914
 915	/* Skip prefixes */
 916	insn = skip_prefixes(insn);
 917
 918	regs->flags &= ~X86_EFLAGS_TF;
 919	switch (*insn) {
 920	case 0x9c:	/* pushfl */
 921		*tos &= ~(X86_EFLAGS_TF | X86_EFLAGS_IF);
 922		*tos |= kcb->kprobe_old_flags;
 923		break;
 924	case 0xc2:	/* iret/ret/lret */
 925	case 0xc3:
 926	case 0xca:
 927	case 0xcb:
 928	case 0xcf:
 929	case 0xea:	/* jmp absolute -- ip is correct */
 930		/* ip is already adjusted, no more changes required */
 931		p->ainsn.boostable = true;
 932		goto no_change;
 933	case 0xe8:	/* call relative - Fix return addr */
 934		*tos = orig_ip + (*tos - copy_ip);
 935		break;
 936#ifdef CONFIG_X86_32
 937	case 0x9a:	/* call absolute -- same as call absolute, indirect */
 938		*tos = orig_ip + (*tos - copy_ip);
 939		goto no_change;
 940#endif
 941	case 0xff:
 942		if ((insn[1] & 0x30) == 0x10) {
 943			/*
 944			 * call absolute, indirect
 945			 * Fix return addr; ip is correct.
 946			 * But this is not boostable
 947			 */
 948			*tos = orig_ip + (*tos - copy_ip);
 949			goto no_change;
 950		} else if (((insn[1] & 0x31) == 0x20) ||
 951			   ((insn[1] & 0x31) == 0x21)) {
 952			/*
 953			 * jmp near and far, absolute indirect
 954			 * ip is correct. And this is boostable
 955			 */
 956			p->ainsn.boostable = true;
 957			goto no_change;
 958		}
 959	default:
 960		break;
 961	}
 962
 963	regs->ip += orig_ip - copy_ip;
 964
 965no_change:
 966	restore_btf();
 967}
 968NOKPROBE_SYMBOL(resume_execution);
 969
 970/*
 971 * Interrupts are disabled on entry as trap1 is an interrupt gate and they
 972 * remain disabled throughout this function.
 973 */
 974int kprobe_debug_handler(struct pt_regs *regs)
 975{
 976	struct kprobe *cur = kprobe_running();
 977	struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
 978
 979	if (!cur)
 980		return 0;
 981
 982	resume_execution(cur, regs, kcb);
 983	regs->flags |= kcb->kprobe_saved_flags;
 984
 985	if ((kcb->kprobe_status != KPROBE_REENTER) && cur->post_handler) {
 986		kcb->kprobe_status = KPROBE_HIT_SSDONE;
 987		cur->post_handler(cur, regs, 0);
 988	}
 989
 990	/* Restore back the original saved kprobes variables and continue. */
 991	if (kcb->kprobe_status == KPROBE_REENTER) {
 992		restore_previous_kprobe(kcb);
 993		goto out;
 994	}
 995	reset_current_kprobe();
 996out:
 997	/*
 998	 * if somebody else is singlestepping across a probe point, flags
 999	 * will have TF set, in which case, continue the remaining processing
1000	 * of do_debug, as if this is not a probe hit.
1001	 */
1002	if (regs->flags & X86_EFLAGS_TF)
1003		return 0;
1004
1005	return 1;
1006}
1007NOKPROBE_SYMBOL(kprobe_debug_handler);
1008
1009int kprobe_fault_handler(struct pt_regs *regs, int trapnr)
1010{
1011	struct kprobe *cur = kprobe_running();
1012	struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
1013
1014	if (unlikely(regs->ip == (unsigned long)cur->ainsn.insn)) {
1015		/* This must happen on single-stepping */
1016		WARN_ON(kcb->kprobe_status != KPROBE_HIT_SS &&
1017			kcb->kprobe_status != KPROBE_REENTER);
1018		/*
1019		 * We are here because the instruction being single
1020		 * stepped caused a page fault. We reset the current
1021		 * kprobe and the ip points back to the probe address
1022		 * and allow the page fault handler to continue as a
1023		 * normal page fault.
1024		 */
1025		regs->ip = (unsigned long)cur->addr;
1026		/*
1027		 * Trap flag (TF) has been set here because this fault
1028		 * happened where the single stepping will be done.
1029		 * So clear it by resetting the current kprobe:
1030		 */
1031		regs->flags &= ~X86_EFLAGS_TF;
1032
1033		/*
1034		 * If the TF flag was set before the kprobe hit,
1035		 * don't touch it:
1036		 */
1037		regs->flags |= kcb->kprobe_old_flags;
1038
1039		if (kcb->kprobe_status == KPROBE_REENTER)
1040			restore_previous_kprobe(kcb);
1041		else
1042			reset_current_kprobe();
1043	} else if (kcb->kprobe_status == KPROBE_HIT_ACTIVE ||
1044		   kcb->kprobe_status == KPROBE_HIT_SSDONE) {
1045		/*
1046		 * We increment the nmissed count for accounting,
1047		 * we can also use npre/npostfault count for accounting
1048		 * these specific fault cases.
1049		 */
1050		kprobes_inc_nmissed_count(cur);
1051
1052		/*
1053		 * We come here because instructions in the pre/post
1054		 * handler caused the page_fault, this could happen
1055		 * if handler tries to access user space by
1056		 * copy_from_user(), get_user() etc. Let the
1057		 * user-specified handler try to fix it first.
1058		 */
1059		if (cur->fault_handler && cur->fault_handler(cur, regs, trapnr))
1060			return 1;
1061	}
1062
1063	return 0;
1064}
1065NOKPROBE_SYMBOL(kprobe_fault_handler);
1066
1067int __init arch_populate_kprobe_blacklist(void)
1068{
1069	int ret;
1070
1071	ret = kprobe_add_area_blacklist((unsigned long)__irqentry_text_start,
1072					 (unsigned long)__irqentry_text_end);
1073	if (ret)
1074		return ret;
1075
1076	return kprobe_add_area_blacklist((unsigned long)__entry_text_start,
1077					 (unsigned long)__entry_text_end);
1078}
1079
1080int __init arch_init_kprobes(void)
1081{
1082	return 0;
1083}
1084
1085int arch_trampoline_kprobe(struct kprobe *p)
1086{
1087	return 0;
1088}
v6.13.7
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 *  Kernel Probes (KProbes)
   4 *
   5 * Copyright (C) IBM Corporation, 2002, 2004
   6 *
   7 * 2002-Oct	Created by Vamsi Krishna S <vamsi_krishna@in.ibm.com> Kernel
   8 *		Probes initial implementation ( includes contributions from
   9 *		Rusty Russell).
  10 * 2004-July	Suparna Bhattacharya <suparna@in.ibm.com> added jumper probes
  11 *		interface to access function arguments.
  12 * 2004-Oct	Jim Keniston <jkenisto@us.ibm.com> and Prasanna S Panchamukhi
  13 *		<prasanna@in.ibm.com> adapted for x86_64 from i386.
  14 * 2005-Mar	Roland McGrath <roland@redhat.com>
  15 *		Fixed to handle %rip-relative addressing mode correctly.
  16 * 2005-May	Hien Nguyen <hien@us.ibm.com>, Jim Keniston
  17 *		<jkenisto@us.ibm.com> and Prasanna S Panchamukhi
  18 *		<prasanna@in.ibm.com> added function-return probes.
  19 * 2005-May	Rusty Lynch <rusty.lynch@intel.com>
  20 *		Added function return probes functionality
  21 * 2006-Feb	Masami Hiramatsu <hiramatu@sdl.hitachi.co.jp> added
  22 *		kprobe-booster and kretprobe-booster for i386.
  23 * 2007-Dec	Masami Hiramatsu <mhiramat@redhat.com> added kprobe-booster
  24 *		and kretprobe-booster for x86-64
  25 * 2007-Dec	Masami Hiramatsu <mhiramat@redhat.com>, Arjan van de Ven
  26 *		<arjan@infradead.org> and Jim Keniston <jkenisto@us.ibm.com>
  27 *		unified x86 kprobes code.
  28 */
  29#include <linux/kprobes.h>
  30#include <linux/ptrace.h>
  31#include <linux/string.h>
  32#include <linux/slab.h>
  33#include <linux/hardirq.h>
  34#include <linux/preempt.h>
  35#include <linux/sched/debug.h>
  36#include <linux/perf_event.h>
  37#include <linux/extable.h>
  38#include <linux/kdebug.h>
  39#include <linux/kallsyms.h>
  40#include <linux/kgdb.h>
  41#include <linux/ftrace.h>
 
  42#include <linux/kasan.h>
  43#include <linux/objtool.h>
  44#include <linux/vmalloc.h>
  45#include <linux/pgtable.h>
  46#include <linux/set_memory.h>
  47#include <linux/cfi.h>
  48#include <linux/execmem.h>
  49
  50#include <asm/text-patching.h>
  51#include <asm/cacheflush.h>
  52#include <asm/desc.h>
 
  53#include <linux/uaccess.h>
  54#include <asm/alternative.h>
  55#include <asm/insn.h>
  56#include <asm/debugreg.h>
  57#include <asm/ibt.h>
  58
  59#include "common.h"
  60
  61DEFINE_PER_CPU(struct kprobe *, current_kprobe) = NULL;
  62DEFINE_PER_CPU(struct kprobe_ctlblk, kprobe_ctlblk);
  63
 
 
  64#define W(row, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf)\
  65	(((b0##UL << 0x0)|(b1##UL << 0x1)|(b2##UL << 0x2)|(b3##UL << 0x3) |   \
  66	  (b4##UL << 0x4)|(b5##UL << 0x5)|(b6##UL << 0x6)|(b7##UL << 0x7) |   \
  67	  (b8##UL << 0x8)|(b9##UL << 0x9)|(ba##UL << 0xa)|(bb##UL << 0xb) |   \
  68	  (bc##UL << 0xc)|(bd##UL << 0xd)|(be##UL << 0xe)|(bf##UL << 0xf))    \
  69	 << (row % 32))
  70	/*
  71	 * Undefined/reserved opcodes, conditional jump, Opcode Extension
  72	 * Groups, and some special opcodes can not boost.
  73	 * This is non-const and volatile to keep gcc from statically
  74	 * optimizing it out, as variable_test_bit makes gcc think only
  75	 * *(unsigned long*) is used.
  76	 */
  77static volatile u32 twobyte_is_boostable[256 / 32] = {
  78	/*      0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f          */
  79	/*      ----------------------------------------------          */
  80	W(0x00, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0) | /* 00 */
  81	W(0x10, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1) , /* 10 */
  82	W(0x20, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) | /* 20 */
  83	W(0x30, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) , /* 30 */
  84	W(0x40, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1) | /* 40 */
  85	W(0x50, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) , /* 50 */
  86	W(0x60, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 1, 1) | /* 60 */
  87	W(0x70, 0, 0, 0, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1) , /* 70 */
  88	W(0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) | /* 80 */
  89	W(0x90, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1) , /* 90 */
  90	W(0xa0, 1, 1, 0, 1, 1, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1) | /* a0 */
  91	W(0xb0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 1, 1, 1, 1) , /* b0 */
  92	W(0xc0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1) | /* c0 */
  93	W(0xd0, 0, 1, 1, 1, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1) , /* d0 */
  94	W(0xe0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1, 0, 1) | /* e0 */
  95	W(0xf0, 0, 1, 1, 1, 0, 1, 0, 0, 1, 1, 1, 0, 1, 1, 1, 0)   /* f0 */
  96	/*      -----------------------------------------------         */
  97	/*      0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f          */
  98};
  99#undef W
 100
 101struct kretprobe_blackpoint kretprobe_blacklist[] = {
 102	{"__switch_to", }, /* This function switches only current task, but
 103			      doesn't switch kernel stack.*/
 104	{NULL, NULL}	/* Terminator */
 105};
 106
 107const int kretprobe_blacklist_size = ARRAY_SIZE(kretprobe_blacklist);
 108
 109static nokprobe_inline void
 110__synthesize_relative_insn(void *dest, void *from, void *to, u8 op)
 111{
 112	struct __arch_relative_insn {
 113		u8 op;
 114		s32 raddr;
 115	} __packed *insn;
 116
 117	insn = (struct __arch_relative_insn *)dest;
 118	insn->raddr = (s32)((long)(to) - ((long)(from) + 5));
 119	insn->op = op;
 120}
 121
 122/* Insert a jump instruction at address 'from', which jumps to address 'to'.*/
 123void synthesize_reljump(void *dest, void *from, void *to)
 124{
 125	__synthesize_relative_insn(dest, from, to, JMP32_INSN_OPCODE);
 126}
 127NOKPROBE_SYMBOL(synthesize_reljump);
 128
 129/* Insert a call instruction at address 'from', which calls address 'to'.*/
 130void synthesize_relcall(void *dest, void *from, void *to)
 131{
 132	__synthesize_relative_insn(dest, from, to, CALL_INSN_OPCODE);
 133}
 134NOKPROBE_SYMBOL(synthesize_relcall);
 135
 136/*
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 137 * Returns non-zero if INSN is boostable.
 138 * RIP relative instructions are adjusted at copying time in 64 bits mode
 139 */
 140bool can_boost(struct insn *insn, void *addr)
 141{
 142	kprobe_opcode_t opcode;
 143	insn_byte_t prefix;
 144	int i;
 145
 146	if (search_exception_tables((unsigned long)addr))
 147		return false;	/* Page fault may occur on this address. */
 148
 149	/* 2nd-byte opcode */
 150	if (insn->opcode.nbytes == 2)
 151		return test_bit(insn->opcode.bytes[1],
 152				(unsigned long *)twobyte_is_boostable);
 153
 154	if (insn->opcode.nbytes != 1)
 155		return false;
 156
 157	for_each_insn_prefix(insn, i, prefix) {
 158		insn_attr_t attr;
 159
 160		attr = inat_get_opcode_attribute(prefix);
 161		/* Can't boost Address-size override prefix and CS override prefix */
 162		if (prefix == 0x2e || inat_is_address_size_prefix(attr))
 163			return false;
 164	}
 165
 166	opcode = insn->opcode.bytes[0];
 167
 168	switch (opcode) {
 169	case 0x62:		/* bound */
 170	case 0x70 ... 0x7f:	/* Conditional jumps */
 171	case 0x9a:		/* Call far */
 172	case 0xcc ... 0xce:	/* software exceptions */
 173	case 0xd6:		/* (UD) */
 174	case 0xd8 ... 0xdf:	/* ESC */
 175	case 0xe0 ... 0xe3:	/* LOOP*, JCXZ */
 176	case 0xe8 ... 0xe9:	/* near Call, JMP */
 177	case 0xeb:		/* Short JMP */
 178	case 0xf0 ... 0xf4:	/* LOCK/REP, HLT */
 179		/* ... are not boostable */
 180		return false;
 181	case 0xc0 ... 0xc1:	/* Grp2 */
 182	case 0xd0 ... 0xd3:	/* Grp2 */
 183		/*
 184		 * AMD uses nnn == 110 as SHL/SAL, but Intel makes it reserved.
 185		 */
 186		return X86_MODRM_REG(insn->modrm.bytes[0]) != 0b110;
 187	case 0xf6 ... 0xf7:	/* Grp3 */
 188		/* AMD uses nnn == 001 as TEST, but Intel makes it reserved. */
 189		return X86_MODRM_REG(insn->modrm.bytes[0]) != 0b001;
 190	case 0xfe:		/* Grp4 */
 191		/* Only INC and DEC are boostable */
 192		return X86_MODRM_REG(insn->modrm.bytes[0]) == 0b000 ||
 193		       X86_MODRM_REG(insn->modrm.bytes[0]) == 0b001;
 194	case 0xff:		/* Grp5 */
 195		/* Only INC, DEC, and indirect JMP are boostable */
 196		return X86_MODRM_REG(insn->modrm.bytes[0]) == 0b000 ||
 197		       X86_MODRM_REG(insn->modrm.bytes[0]) == 0b001 ||
 198		       X86_MODRM_REG(insn->modrm.bytes[0]) == 0b100;
 199	default:
 200		return true;
 
 201	}
 202}
 203
 204static unsigned long
 205__recover_probed_insn(kprobe_opcode_t *buf, unsigned long addr)
 206{
 207	struct kprobe *kp;
 208	bool faddr;
 209
 210	kp = get_kprobe((void *)addr);
 211	faddr = ftrace_location(addr) == addr;
 
 
 
 
 
 
 
 212	/*
 213	 * Use the current code if it is not modified by Kprobe
 214	 * and it cannot be modified by ftrace.
 215	 */
 216	if (!kp && !faddr)
 217		return addr;
 218
 219	/*
 220	 * Basically, kp->ainsn.insn has an original instruction.
 221	 * However, RIP-relative instruction can not do single-stepping
 222	 * at different place, __copy_instruction() tweaks the displacement of
 223	 * that instruction. In that case, we can't recover the instruction
 224	 * from the kp->ainsn.insn.
 225	 *
 226	 * On the other hand, in case on normal Kprobe, kp->opcode has a copy
 227	 * of the first byte of the probed instruction, which is overwritten
 228	 * by int3. And the instruction at kp->addr is not modified by kprobes
 229	 * except for the first byte, we can recover the original instruction
 230	 * from it and kp->opcode.
 231	 *
 232	 * In case of Kprobes using ftrace, we do not have a copy of
 233	 * the original instruction. In fact, the ftrace location might
 234	 * be modified at anytime and even could be in an inconsistent state.
 235	 * Fortunately, we know that the original code is the ideal 5-byte
 236	 * long NOP.
 237	 */
 238	if (copy_from_kernel_nofault(buf, (void *)addr,
 239		MAX_INSN_SIZE * sizeof(kprobe_opcode_t)))
 240		return 0UL;
 241
 242	if (faddr)
 243		memcpy(buf, x86_nops[5], 5);
 244	else
 245		buf[0] = kp->opcode;
 246	return (unsigned long)buf;
 247}
 248
 249/*
 250 * Recover the probed instruction at addr for further analysis.
 251 * Caller must lock kprobes by kprobe_mutex, or disable preemption
 252 * for preventing to release referencing kprobes.
 253 * Returns zero if the instruction can not get recovered (or access failed).
 254 */
 255unsigned long recover_probed_instruction(kprobe_opcode_t *buf, unsigned long addr)
 256{
 257	unsigned long __addr;
 258
 259	__addr = __recover_optprobed_insn(buf, addr);
 260	if (__addr != addr)
 261		return __addr;
 262
 263	return __recover_probed_insn(buf, addr);
 264}
 265
 266/* Check if insn is INT or UD */
 267static inline bool is_exception_insn(struct insn *insn)
 268{
 269	/* UD uses 0f escape */
 270	if (insn->opcode.bytes[0] == 0x0f) {
 271		/* UD0 / UD1 / UD2 */
 272		return insn->opcode.bytes[1] == 0xff ||
 273		       insn->opcode.bytes[1] == 0xb9 ||
 274		       insn->opcode.bytes[1] == 0x0b;
 275	}
 276
 277	/* INT3 / INT n / INTO / INT1 */
 278	return insn->opcode.bytes[0] == 0xcc ||
 279	       insn->opcode.bytes[0] == 0xcd ||
 280	       insn->opcode.bytes[0] == 0xce ||
 281	       insn->opcode.bytes[0] == 0xf1;
 282}
 283
 284/*
 285 * Check if paddr is at an instruction boundary and that instruction can
 286 * be probed
 287 */
 288static bool can_probe(unsigned long paddr)
 289{
 290	unsigned long addr, __addr, offset = 0;
 291	struct insn insn;
 292	kprobe_opcode_t buf[MAX_INSN_SIZE];
 293
 294	if (!kallsyms_lookup_size_offset(paddr, NULL, &offset))
 295		return false;
 296
 297	/* Decode instructions */
 298	addr = paddr - offset;
 299	while (addr < paddr) {
 300		/*
 301		 * Check if the instruction has been modified by another
 302		 * kprobe, in which case we replace the breakpoint by the
 303		 * original instruction in our buffer.
 304		 * Also, jump optimization will change the breakpoint to
 305		 * relative-jump. Since the relative-jump itself is
 306		 * normally used, we just go through if there is no kprobe.
 307		 */
 308		__addr = recover_probed_instruction(buf, addr);
 309		if (!__addr)
 310			return false;
 
 
 311
 312		if (insn_decode_kernel(&insn, (void *)__addr) < 0)
 313			return false;
 314
 315#ifdef CONFIG_KGDB
 316		/*
 317		 * If there is a dynamically installed kgdb sw breakpoint,
 318		 * this function should not be probed.
 319		 */
 320		if (insn.opcode.bytes[0] == INT3_INSN_OPCODE &&
 321		    kgdb_has_hit_break(addr))
 322			return false;
 323#endif
 324		addr += insn.length;
 325	}
 326
 327	/* Check if paddr is at an instruction boundary */
 328	if (addr != paddr)
 329		return false;
 330
 331	__addr = recover_probed_instruction(buf, addr);
 332	if (!__addr)
 333		return false;
 334
 335	if (insn_decode_kernel(&insn, (void *)__addr) < 0)
 336		return false;
 337
 338	/* INT and UD are special and should not be kprobed */
 339	if (is_exception_insn(&insn))
 340		return false;
 341
 342	if (IS_ENABLED(CONFIG_CFI_CLANG)) {
 343		/*
 344		 * The compiler generates the following instruction sequence
 345		 * for indirect call checks and cfi.c decodes this;
 346		 *
 347		 *   movl    -<id>, %r10d       ; 6 bytes
 348		 *   addl    -4(%reg), %r10d    ; 4 bytes
 349		 *   je      .Ltmp1             ; 2 bytes
 350		 *   ud2                        ; <- regs->ip
 351		 *   .Ltmp1:
 352		 *
 353		 * Also, these movl and addl are used for showing expected
 354		 * type. So those must not be touched.
 355		 */
 356		if (insn.opcode.value == 0xBA)
 357			offset = 12;
 358		else if (insn.opcode.value == 0x3)
 359			offset = 6;
 360		else
 361			goto out;
 362
 363		/* This movl/addl is used for decoding CFI. */
 364		if (is_cfi_trap(addr + offset))
 365			return false;
 366	}
 367
 368out:
 369	return true;
 370}
 371
 372/* If x86 supports IBT (ENDBR) it must be skipped. */
 373kprobe_opcode_t *arch_adjust_kprobe_addr(unsigned long addr, unsigned long offset,
 374					 bool *on_func_entry)
 
 375{
 376	u32 insn;
 
 377
 378	/*
 379	 * Since 'addr' is not guaranteed to be safe to access, use
 380	 * copy_from_kernel_nofault() to read the instruction:
 381	 */
 382	if (copy_from_kernel_nofault(&insn, (void *)addr, sizeof(u32)))
 383		return NULL;
 384
 385	if (is_endbr(insn)) {
 386		*on_func_entry = !offset || offset == 4;
 387		if (*on_func_entry)
 388			offset = 4;
 389
 390	} else {
 391		*on_func_entry = !offset;
 392	}
 393
 394	return (kprobe_opcode_t *)(addr + offset);
 395}
 396
 397/*
 398 * Copy an instruction with recovering modified instruction by kprobes
 399 * and adjust the displacement if the instruction uses the %rip-relative
 400 * addressing mode. Note that since @real will be the final place of copied
 401 * instruction, displacement must be adjust by @real, not @dest.
 402 * This returns the length of copied instruction, or 0 if it has an error.
 403 */
 404int __copy_instruction(u8 *dest, u8 *src, u8 *real, struct insn *insn)
 405{
 406	kprobe_opcode_t buf[MAX_INSN_SIZE];
 407	unsigned long recovered_insn = recover_probed_instruction(buf, (unsigned long)src);
 408	int ret;
 409
 410	if (!recovered_insn || !insn)
 411		return 0;
 412
 413	/* This can access kernel text if given address is not recovered */
 414	if (copy_from_kernel_nofault(dest, (void *)recovered_insn,
 415			MAX_INSN_SIZE))
 416		return 0;
 417
 418	ret = insn_decode_kernel(insn, dest);
 419	if (ret < 0)
 420		return 0;
 421
 422	/* We can not probe force emulate prefixed instruction */
 423	if (insn_has_emulate_prefix(insn))
 424		return 0;
 425
 426	/* Another subsystem puts a breakpoint, failed to recover */
 427	if (insn->opcode.bytes[0] == INT3_INSN_OPCODE)
 428		return 0;
 429
 430	/* We should not singlestep on the exception masking instructions */
 431	if (insn_masking_exception(insn))
 432		return 0;
 433
 434#ifdef CONFIG_X86_64
 435	/* Only x86_64 has RIP relative instructions */
 436	if (insn_rip_relative(insn)) {
 437		s64 newdisp;
 438		u8 *disp;
 439		/*
 440		 * The copied instruction uses the %rip-relative addressing
 441		 * mode.  Adjust the displacement for the difference between
 442		 * the original location of this instruction and the location
 443		 * of the copy that will actually be run.  The tricky bit here
 444		 * is making sure that the sign extension happens correctly in
 445		 * this calculation, since we need a signed 32-bit result to
 446		 * be sign-extended to 64 bits when it's added to the %rip
 447		 * value and yield the same 64-bit result that the sign-
 448		 * extension of the original signed 32-bit displacement would
 449		 * have given.
 450		 */
 451		newdisp = (u8 *) src + (s64) insn->displacement.value
 452			  - (u8 *) real;
 453		if ((s64) (s32) newdisp != newdisp) {
 454			pr_err("Kprobes error: new displacement does not fit into s32 (%llx)\n", newdisp);
 455			return 0;
 456		}
 457		disp = (u8 *) dest + insn_offset_displacement(insn);
 458		*(s32 *) disp = (s32) newdisp;
 459	}
 460#endif
 461	return insn->length;
 462}
 463
 464/* Prepare reljump or int3 right after instruction */
 465static int prepare_singlestep(kprobe_opcode_t *buf, struct kprobe *p,
 466			      struct insn *insn)
 467{
 468	int len = insn->length;
 469
 470	if (!IS_ENABLED(CONFIG_PREEMPTION) &&
 471	    !p->post_handler && can_boost(insn, p->addr) &&
 472	    MAX_INSN_SIZE - len >= JMP32_INSN_SIZE) {
 473		/*
 474		 * These instructions can be executed directly if it
 475		 * jumps back to correct address.
 476		 */
 477		synthesize_reljump(buf + len, p->ainsn.insn + len,
 478				   p->addr + insn->length);
 479		len += JMP32_INSN_SIZE;
 480		p->ainsn.boostable = 1;
 481	} else {
 482		/* Otherwise, put an int3 for trapping singlestep */
 483		if (MAX_INSN_SIZE - len < INT3_INSN_SIZE)
 484			return -ENOSPC;
 485
 486		buf[len] = INT3_INSN_OPCODE;
 487		len += INT3_INSN_SIZE;
 488	}
 489
 490	return len;
 491}
 492
 493/* Make page to RO mode when allocate it */
 494void *alloc_insn_page(void)
 495{
 496	void *page;
 497
 498	page = execmem_alloc(EXECMEM_KPROBES, PAGE_SIZE);
 499	if (!page)
 500		return NULL;
 501
 
 
 
 
 
 
 
 502	/*
 503	 * TODO: Once additional kernel code protection mechanisms are set, ensure
 504	 * that the page was not maliciously altered and it is still zeroed.
 505	 */
 506	set_memory_rox((unsigned long)page, 1);
 507
 508	return page;
 509}
 510
 511/* Kprobe x86 instruction emulation - only regs->ip or IF flag modifiers */
 512
 513static void kprobe_emulate_ifmodifiers(struct kprobe *p, struct pt_regs *regs)
 514{
 515	switch (p->ainsn.opcode) {
 516	case 0xfa:	/* cli */
 517		regs->flags &= ~(X86_EFLAGS_IF);
 518		break;
 519	case 0xfb:	/* sti */
 520		regs->flags |= X86_EFLAGS_IF;
 521		break;
 522	case 0x9c:	/* pushf */
 523		int3_emulate_push(regs, regs->flags);
 524		break;
 525	case 0x9d:	/* popf */
 526		regs->flags = int3_emulate_pop(regs);
 527		break;
 528	}
 529	regs->ip = regs->ip - INT3_INSN_SIZE + p->ainsn.size;
 530}
 531NOKPROBE_SYMBOL(kprobe_emulate_ifmodifiers);
 532
 533static void kprobe_emulate_ret(struct kprobe *p, struct pt_regs *regs)
 534{
 535	int3_emulate_ret(regs);
 536}
 537NOKPROBE_SYMBOL(kprobe_emulate_ret);
 538
 539static void kprobe_emulate_call(struct kprobe *p, struct pt_regs *regs)
 540{
 541	unsigned long func = regs->ip - INT3_INSN_SIZE + p->ainsn.size;
 542
 543	func += p->ainsn.rel32;
 544	int3_emulate_call(regs, func);
 545}
 546NOKPROBE_SYMBOL(kprobe_emulate_call);
 547
 548static void kprobe_emulate_jmp(struct kprobe *p, struct pt_regs *regs)
 549{
 550	unsigned long ip = regs->ip - INT3_INSN_SIZE + p->ainsn.size;
 551
 552	ip += p->ainsn.rel32;
 553	int3_emulate_jmp(regs, ip);
 554}
 555NOKPROBE_SYMBOL(kprobe_emulate_jmp);
 556
 557static void kprobe_emulate_jcc(struct kprobe *p, struct pt_regs *regs)
 558{
 559	unsigned long ip = regs->ip - INT3_INSN_SIZE + p->ainsn.size;
 560
 561	int3_emulate_jcc(regs, p->ainsn.jcc.type, ip, p->ainsn.rel32);
 562}
 563NOKPROBE_SYMBOL(kprobe_emulate_jcc);
 564
 565static void kprobe_emulate_loop(struct kprobe *p, struct pt_regs *regs)
 566{
 567	unsigned long ip = regs->ip - INT3_INSN_SIZE + p->ainsn.size;
 568	bool match;
 569
 570	if (p->ainsn.loop.type != 3) {	/* LOOP* */
 571		if (p->ainsn.loop.asize == 32)
 572			match = ((*(u32 *)&regs->cx)--) != 0;
 573#ifdef CONFIG_X86_64
 574		else if (p->ainsn.loop.asize == 64)
 575			match = ((*(u64 *)&regs->cx)--) != 0;
 576#endif
 577		else
 578			match = ((*(u16 *)&regs->cx)--) != 0;
 579	} else {			/* JCXZ */
 580		if (p->ainsn.loop.asize == 32)
 581			match = *(u32 *)(&regs->cx) == 0;
 582#ifdef CONFIG_X86_64
 583		else if (p->ainsn.loop.asize == 64)
 584			match = *(u64 *)(&regs->cx) == 0;
 585#endif
 586		else
 587			match = *(u16 *)(&regs->cx) == 0;
 588	}
 589
 590	if (p->ainsn.loop.type == 0)	/* LOOPNE */
 591		match = match && !(regs->flags & X86_EFLAGS_ZF);
 592	else if (p->ainsn.loop.type == 1)	/* LOOPE */
 593		match = match && (regs->flags & X86_EFLAGS_ZF);
 594
 595	if (match)
 596		ip += p->ainsn.rel32;
 597	int3_emulate_jmp(regs, ip);
 598}
 599NOKPROBE_SYMBOL(kprobe_emulate_loop);
 600
 601static const int addrmode_regoffs[] = {
 602	offsetof(struct pt_regs, ax),
 603	offsetof(struct pt_regs, cx),
 604	offsetof(struct pt_regs, dx),
 605	offsetof(struct pt_regs, bx),
 606	offsetof(struct pt_regs, sp),
 607	offsetof(struct pt_regs, bp),
 608	offsetof(struct pt_regs, si),
 609	offsetof(struct pt_regs, di),
 610#ifdef CONFIG_X86_64
 611	offsetof(struct pt_regs, r8),
 612	offsetof(struct pt_regs, r9),
 613	offsetof(struct pt_regs, r10),
 614	offsetof(struct pt_regs, r11),
 615	offsetof(struct pt_regs, r12),
 616	offsetof(struct pt_regs, r13),
 617	offsetof(struct pt_regs, r14),
 618	offsetof(struct pt_regs, r15),
 619#endif
 620};
 621
 622static void kprobe_emulate_call_indirect(struct kprobe *p, struct pt_regs *regs)
 623{
 624	unsigned long offs = addrmode_regoffs[p->ainsn.indirect.reg];
 625
 626	int3_emulate_push(regs, regs->ip - INT3_INSN_SIZE + p->ainsn.size);
 627	int3_emulate_jmp(regs, regs_get_register(regs, offs));
 628}
 629NOKPROBE_SYMBOL(kprobe_emulate_call_indirect);
 630
 631static void kprobe_emulate_jmp_indirect(struct kprobe *p, struct pt_regs *regs)
 632{
 633	unsigned long offs = addrmode_regoffs[p->ainsn.indirect.reg];
 634
 635	int3_emulate_jmp(regs, regs_get_register(regs, offs));
 636}
 637NOKPROBE_SYMBOL(kprobe_emulate_jmp_indirect);
 638
 639static int prepare_emulation(struct kprobe *p, struct insn *insn)
 640{
 641	insn_byte_t opcode = insn->opcode.bytes[0];
 642
 643	switch (opcode) {
 644	case 0xfa:		/* cli */
 645	case 0xfb:		/* sti */
 646	case 0x9c:		/* pushfl */
 647	case 0x9d:		/* popf/popfd */
 648		/*
 649		 * IF modifiers must be emulated since it will enable interrupt while
 650		 * int3 single stepping.
 651		 */
 652		p->ainsn.emulate_op = kprobe_emulate_ifmodifiers;
 653		p->ainsn.opcode = opcode;
 654		break;
 655	case 0xc2:	/* ret/lret */
 656	case 0xc3:
 657	case 0xca:
 658	case 0xcb:
 659		p->ainsn.emulate_op = kprobe_emulate_ret;
 660		break;
 661	case 0x9a:	/* far call absolute -- segment is not supported */
 662	case 0xea:	/* far jmp absolute -- segment is not supported */
 663	case 0xcc:	/* int3 */
 664	case 0xcf:	/* iret -- in-kernel IRET is not supported */
 665		return -EOPNOTSUPP;
 666		break;
 667	case 0xe8:	/* near call relative */
 668		p->ainsn.emulate_op = kprobe_emulate_call;
 669		if (insn->immediate.nbytes == 2)
 670			p->ainsn.rel32 = *(s16 *)&insn->immediate.value;
 671		else
 672			p->ainsn.rel32 = *(s32 *)&insn->immediate.value;
 673		break;
 674	case 0xeb:	/* short jump relative */
 675	case 0xe9:	/* near jump relative */
 676		p->ainsn.emulate_op = kprobe_emulate_jmp;
 677		if (insn->immediate.nbytes == 1)
 678			p->ainsn.rel32 = *(s8 *)&insn->immediate.value;
 679		else if (insn->immediate.nbytes == 2)
 680			p->ainsn.rel32 = *(s16 *)&insn->immediate.value;
 681		else
 682			p->ainsn.rel32 = *(s32 *)&insn->immediate.value;
 683		break;
 684	case 0x70 ... 0x7f:
 685		/* 1 byte conditional jump */
 686		p->ainsn.emulate_op = kprobe_emulate_jcc;
 687		p->ainsn.jcc.type = opcode & 0xf;
 688		p->ainsn.rel32 = insn->immediate.value;
 689		break;
 690	case 0x0f:
 691		opcode = insn->opcode.bytes[1];
 692		if ((opcode & 0xf0) == 0x80) {
 693			/* 2 bytes Conditional Jump */
 694			p->ainsn.emulate_op = kprobe_emulate_jcc;
 695			p->ainsn.jcc.type = opcode & 0xf;
 696			if (insn->immediate.nbytes == 2)
 697				p->ainsn.rel32 = *(s16 *)&insn->immediate.value;
 698			else
 699				p->ainsn.rel32 = *(s32 *)&insn->immediate.value;
 700		} else if (opcode == 0x01 &&
 701			   X86_MODRM_REG(insn->modrm.bytes[0]) == 0 &&
 702			   X86_MODRM_MOD(insn->modrm.bytes[0]) == 3) {
 703			/* VM extensions - not supported */
 704			return -EOPNOTSUPP;
 705		}
 706		break;
 707	case 0xe0:	/* Loop NZ */
 708	case 0xe1:	/* Loop */
 709	case 0xe2:	/* Loop */
 710	case 0xe3:	/* J*CXZ */
 711		p->ainsn.emulate_op = kprobe_emulate_loop;
 712		p->ainsn.loop.type = opcode & 0x3;
 713		p->ainsn.loop.asize = insn->addr_bytes * 8;
 714		p->ainsn.rel32 = *(s8 *)&insn->immediate.value;
 715		break;
 716	case 0xff:
 717		/*
 718		 * Since the 0xff is an extended group opcode, the instruction
 719		 * is determined by the MOD/RM byte.
 720		 */
 721		opcode = insn->modrm.bytes[0];
 722		switch (X86_MODRM_REG(opcode)) {
 723		case 0b010:	/* FF /2, call near, absolute indirect */
 724			p->ainsn.emulate_op = kprobe_emulate_call_indirect;
 725			break;
 726		case 0b100:	/* FF /4, jmp near, absolute indirect */
 727			p->ainsn.emulate_op = kprobe_emulate_jmp_indirect;
 728			break;
 729		case 0b011:	/* FF /3, call far, absolute indirect */
 730		case 0b101:	/* FF /5, jmp far, absolute indirect */
 731			return -EOPNOTSUPP;
 732		}
 733
 734		if (!p->ainsn.emulate_op)
 735			break;
 736
 737		if (insn->addr_bytes != sizeof(unsigned long))
 738			return -EOPNOTSUPP;	/* Don't support different size */
 739		if (X86_MODRM_MOD(opcode) != 3)
 740			return -EOPNOTSUPP;	/* TODO: support memory addressing */
 741
 742		p->ainsn.indirect.reg = X86_MODRM_RM(opcode);
 743#ifdef CONFIG_X86_64
 744		if (X86_REX_B(insn->rex_prefix.value))
 745			p->ainsn.indirect.reg += 8;
 746#endif
 747		break;
 748	default:
 749		break;
 750	}
 751	p->ainsn.size = insn->length;
 752
 753	return 0;
 754}
 755
 756static int arch_copy_kprobe(struct kprobe *p)
 757{
 758	struct insn insn;
 759	kprobe_opcode_t buf[MAX_INSN_SIZE];
 760	int ret, len;
 761
 762	/* Copy an instruction with recovering if other optprobe modifies it.*/
 763	len = __copy_instruction(buf, p->addr, p->ainsn.insn, &insn);
 764	if (!len)
 765		return -EINVAL;
 766
 767	/* Analyze the opcode and setup emulate functions */
 768	ret = prepare_emulation(p, &insn);
 769	if (ret < 0)
 770		return ret;
 
 771
 772	/* Add int3 for single-step or booster jmp */
 773	len = prepare_singlestep(buf, p, &insn);
 774	if (len < 0)
 775		return len;
 776
 777	/* Also, displacement change doesn't affect the first byte */
 778	p->opcode = buf[0];
 779
 780	p->ainsn.tp_len = len;
 781	perf_event_text_poke(p->ainsn.insn, NULL, 0, buf, len);
 782
 783	/* OK, write back the instruction(s) into ROX insn buffer */
 784	text_poke(p->ainsn.insn, buf, len);
 785
 786	return 0;
 787}
 788
 789int arch_prepare_kprobe(struct kprobe *p)
 790{
 791	int ret;
 792
 793	if (alternatives_text_reserved(p->addr, p->addr))
 794		return -EINVAL;
 795
 796	if (!can_probe((unsigned long)p->addr))
 797		return -EILSEQ;
 798
 799	memset(&p->ainsn, 0, sizeof(p->ainsn));
 800
 801	/* insn: must be on special executable page on x86. */
 802	p->ainsn.insn = get_insn_slot();
 803	if (!p->ainsn.insn)
 804		return -ENOMEM;
 805
 806	ret = arch_copy_kprobe(p);
 807	if (ret) {
 808		free_insn_slot(p->ainsn.insn, 0);
 809		p->ainsn.insn = NULL;
 810	}
 811
 812	return ret;
 813}
 814
 815void arch_arm_kprobe(struct kprobe *p)
 816{
 817	u8 int3 = INT3_INSN_OPCODE;
 818
 819	text_poke(p->addr, &int3, 1);
 820	text_poke_sync();
 821	perf_event_text_poke(p->addr, &p->opcode, 1, &int3, 1);
 822}
 823
 824void arch_disarm_kprobe(struct kprobe *p)
 825{
 826	u8 int3 = INT3_INSN_OPCODE;
 827
 828	perf_event_text_poke(p->addr, &int3, 1, &p->opcode, 1);
 829	text_poke(p->addr, &p->opcode, 1);
 830	text_poke_sync();
 831}
 832
 833void arch_remove_kprobe(struct kprobe *p)
 834{
 835	if (p->ainsn.insn) {
 836		/* Record the perf event before freeing the slot */
 837		perf_event_text_poke(p->ainsn.insn, p->ainsn.insn,
 838				     p->ainsn.tp_len, NULL, 0);
 839		free_insn_slot(p->ainsn.insn, p->ainsn.boostable);
 840		p->ainsn.insn = NULL;
 841	}
 842}
 843
 844static nokprobe_inline void
 845save_previous_kprobe(struct kprobe_ctlblk *kcb)
 846{
 847	kcb->prev_kprobe.kp = kprobe_running();
 848	kcb->prev_kprobe.status = kcb->kprobe_status;
 849	kcb->prev_kprobe.old_flags = kcb->kprobe_old_flags;
 850	kcb->prev_kprobe.saved_flags = kcb->kprobe_saved_flags;
 851}
 852
 853static nokprobe_inline void
 854restore_previous_kprobe(struct kprobe_ctlblk *kcb)
 855{
 856	__this_cpu_write(current_kprobe, kcb->prev_kprobe.kp);
 857	kcb->kprobe_status = kcb->prev_kprobe.status;
 858	kcb->kprobe_old_flags = kcb->prev_kprobe.old_flags;
 859	kcb->kprobe_saved_flags = kcb->prev_kprobe.saved_flags;
 860}
 861
 862static nokprobe_inline void
 863set_current_kprobe(struct kprobe *p, struct pt_regs *regs,
 864		   struct kprobe_ctlblk *kcb)
 865{
 866	__this_cpu_write(current_kprobe, p);
 867	kcb->kprobe_saved_flags = kcb->kprobe_old_flags
 868		= (regs->flags & X86_EFLAGS_IF);
 
 
 869}
 870
 871static void kprobe_post_process(struct kprobe *cur, struct pt_regs *regs,
 872			       struct kprobe_ctlblk *kcb)
 873{
 874	/* Restore back the original saved kprobes variables and continue. */
 875	if (kcb->kprobe_status == KPROBE_REENTER) {
 876		/* This will restore both kcb and current_kprobe */
 877		restore_previous_kprobe(kcb);
 878	} else {
 879		/*
 880		 * Always update the kcb status because
 881		 * reset_curent_kprobe() doesn't update kcb.
 882		 */
 883		kcb->kprobe_status = KPROBE_HIT_SSDONE;
 884		if (cur->post_handler)
 885			cur->post_handler(cur, regs, 0);
 886		reset_current_kprobe();
 
 
 887	}
 888}
 889NOKPROBE_SYMBOL(kprobe_post_process);
 
 
 
 
 
 
 
 
 
 
 
 890
 891static void setup_singlestep(struct kprobe *p, struct pt_regs *regs,
 892			     struct kprobe_ctlblk *kcb, int reenter)
 893{
 894	if (setup_detour_execution(p, regs, reenter))
 895		return;
 896
 897#if !defined(CONFIG_PREEMPTION)
 898	if (p->ainsn.boostable) {
 899		/* Boost up -- we can execute copied instructions directly */
 900		if (!reenter)
 901			reset_current_kprobe();
 902		/*
 903		 * Reentering boosted probe doesn't reset current_kprobe,
 904		 * nor set current_kprobe, because it doesn't use single
 905		 * stepping.
 906		 */
 907		regs->ip = (unsigned long)p->ainsn.insn;
 908		return;
 909	}
 910#endif
 911	if (reenter) {
 912		save_previous_kprobe(kcb);
 913		set_current_kprobe(p, regs, kcb);
 914		kcb->kprobe_status = KPROBE_REENTER;
 915	} else
 916		kcb->kprobe_status = KPROBE_HIT_SS;
 917
 918	if (p->ainsn.emulate_op) {
 919		p->ainsn.emulate_op(p, regs);
 920		kprobe_post_process(p, regs, kcb);
 921		return;
 922	}
 923
 924	/* Disable interrupt, and set ip register on trampoline */
 925	regs->flags &= ~X86_EFLAGS_IF;
 926	regs->ip = (unsigned long)p->ainsn.insn;
 
 
 
 
 927}
 928NOKPROBE_SYMBOL(setup_singlestep);
 929
 930/*
 931 * Called after single-stepping.  p->addr is the address of the
 932 * instruction whose first byte has been replaced by the "int3"
 933 * instruction.  To avoid the SMP problems that can occur when we
 934 * temporarily put back the original opcode to single-step, we
 935 * single-stepped a copy of the instruction.  The address of this
 936 * copy is p->ainsn.insn. We also doesn't use trap, but "int3" again
 937 * right after the copied instruction.
 938 * Different from the trap single-step, "int3" single-step can not
 939 * handle the instruction which changes the ip register, e.g. jmp,
 940 * call, conditional jmp, and the instructions which changes the IF
 941 * flags because interrupt must be disabled around the single-stepping.
 942 * Such instructions are software emulated, but others are single-stepped
 943 * using "int3".
 944 *
 945 * When the 2nd "int3" handled, the regs->ip and regs->flags needs to
 946 * be adjusted, so that we can resume execution on correct code.
 947 */
 948static void resume_singlestep(struct kprobe *p, struct pt_regs *regs,
 949			      struct kprobe_ctlblk *kcb)
 950{
 951	unsigned long copy_ip = (unsigned long)p->ainsn.insn;
 952	unsigned long orig_ip = (unsigned long)p->addr;
 953
 954	/* Restore saved interrupt flag and ip register */
 955	regs->flags |= kcb->kprobe_saved_flags;
 956	/* Note that regs->ip is executed int3 so must be a step back */
 957	regs->ip += (orig_ip - copy_ip) - INT3_INSN_SIZE;
 958}
 959NOKPROBE_SYMBOL(resume_singlestep);
 960
 961/*
 962 * We have reentered the kprobe_handler(), since another probe was hit while
 963 * within the handler. We save the original kprobes variables and just single
 964 * step on the instruction of the new probe without calling any user handlers.
 965 */
 966static int reenter_kprobe(struct kprobe *p, struct pt_regs *regs,
 967			  struct kprobe_ctlblk *kcb)
 968{
 969	switch (kcb->kprobe_status) {
 970	case KPROBE_HIT_SSDONE:
 971	case KPROBE_HIT_ACTIVE:
 972	case KPROBE_HIT_SS:
 973		kprobes_inc_nmissed_count(p);
 974		setup_singlestep(p, regs, kcb, 1);
 975		break;
 976	case KPROBE_REENTER:
 977		/* A probe has been hit in the codepath leading up to, or just
 978		 * after, single-stepping of a probed instruction. This entire
 979		 * codepath should strictly reside in .kprobes.text section.
 980		 * Raise a BUG or we'll continue in an endless reentering loop
 981		 * and eventually a stack overflow.
 982		 */
 983		pr_err("Unrecoverable kprobe detected.\n");
 984		dump_kprobe(p);
 985		BUG();
 986	default:
 987		/* impossible cases */
 988		WARN_ON(1);
 989		return 0;
 990	}
 991
 992	return 1;
 993}
 994NOKPROBE_SYMBOL(reenter_kprobe);
 995
 996static nokprobe_inline int kprobe_is_ss(struct kprobe_ctlblk *kcb)
 997{
 998	return (kcb->kprobe_status == KPROBE_HIT_SS ||
 999		kcb->kprobe_status == KPROBE_REENTER);
1000}
1001
1002/*
1003 * Interrupts are disabled on entry as trap3 is an interrupt gate and they
1004 * remain disabled throughout this function.
1005 */
1006int kprobe_int3_handler(struct pt_regs *regs)
1007{
1008	kprobe_opcode_t *addr;
1009	struct kprobe *p;
1010	struct kprobe_ctlblk *kcb;
1011
1012	if (user_mode(regs))
1013		return 0;
1014
1015	addr = (kprobe_opcode_t *)(regs->ip - sizeof(kprobe_opcode_t));
1016	/*
1017	 * We don't want to be preempted for the entire duration of kprobe
1018	 * processing. Since int3 and debug trap disables irqs and we clear
1019	 * IF while singlestepping, it must be no preemptible.
1020	 */
1021
1022	kcb = get_kprobe_ctlblk();
1023	p = get_kprobe(addr);
1024
1025	if (p) {
1026		if (kprobe_running()) {
1027			if (reenter_kprobe(p, regs, kcb))
1028				return 1;
1029		} else {
1030			set_current_kprobe(p, regs, kcb);
1031			kcb->kprobe_status = KPROBE_HIT_ACTIVE;
1032
1033			/*
1034			 * If we have no pre-handler or it returned 0, we
1035			 * continue with normal processing.  If we have a
1036			 * pre-handler and it returned non-zero, that means
1037			 * user handler setup registers to exit to another
1038			 * instruction, we must skip the single stepping.
1039			 */
1040			if (!p->pre_handler || !p->pre_handler(p, regs))
1041				setup_singlestep(p, regs, kcb, 0);
1042			else
1043				reset_current_kprobe();
1044			return 1;
1045		}
1046	} else if (kprobe_is_ss(kcb)) {
1047		p = kprobe_running();
1048		if ((unsigned long)p->ainsn.insn < regs->ip &&
1049		    (unsigned long)p->ainsn.insn + MAX_INSN_SIZE > regs->ip) {
1050			/* Most provably this is the second int3 for singlestep */
1051			resume_singlestep(p, regs, kcb);
1052			kprobe_post_process(p, regs, kcb);
1053			return 1;
1054		}
 
 
 
1055	} /* else: not a kprobe fault; let the kernel handle it */
1056
1057	return 0;
1058}
1059NOKPROBE_SYMBOL(kprobe_int3_handler);
1060
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1061int kprobe_fault_handler(struct pt_regs *regs, int trapnr)
1062{
1063	struct kprobe *cur = kprobe_running();
1064	struct kprobe_ctlblk *kcb = get_kprobe_ctlblk();
1065
1066	if (unlikely(regs->ip == (unsigned long)cur->ainsn.insn)) {
1067		/* This must happen on single-stepping */
1068		WARN_ON(kcb->kprobe_status != KPROBE_HIT_SS &&
1069			kcb->kprobe_status != KPROBE_REENTER);
1070		/*
1071		 * We are here because the instruction being single
1072		 * stepped caused a page fault. We reset the current
1073		 * kprobe and the ip points back to the probe address
1074		 * and allow the page fault handler to continue as a
1075		 * normal page fault.
1076		 */
1077		regs->ip = (unsigned long)cur->addr;
 
 
 
 
 
 
1078
1079		/*
1080		 * If the IF flag was set before the kprobe hit,
1081		 * don't touch it:
1082		 */
1083		regs->flags |= kcb->kprobe_old_flags;
1084
1085		if (kcb->kprobe_status == KPROBE_REENTER)
1086			restore_previous_kprobe(kcb);
1087		else
1088			reset_current_kprobe();
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1089	}
1090
1091	return 0;
1092}
1093NOKPROBE_SYMBOL(kprobe_fault_handler);
1094
1095int __init arch_populate_kprobe_blacklist(void)
1096{
 
 
 
 
 
 
 
1097	return kprobe_add_area_blacklist((unsigned long)__entry_text_start,
1098					 (unsigned long)__entry_text_end);
1099}
1100
1101int __init arch_init_kprobes(void)
1102{
1103	return 0;
1104}
1105
1106int arch_trampoline_kprobe(struct kprobe *p)
1107{
1108	return 0;
1109}