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 37 unsigned 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; 56 found: 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 77 static 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). */ 93 static 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 104 asm ( 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 163 void optprobe_template_func(void); 164 STACK_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 */ 176 static void 177 optimized_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 } 205 NOKPROBE_SYMBOL(optimized_callback); 206 207 static 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 */ 229 static 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 */ 237 static 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 */ 264 static 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_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. */ 341 int 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. */ 356 int 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 */ 364 static 365 void __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 381 void 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 */ 391 int 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; 456 out: 457 kfree(buf); 458 return ret; 459 460 err: 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 */ 473 void 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 */ 504 void 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 */ 529 extern 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 540 int 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 } 555 NOKPROBE_SYMBOL(setup_detour_execution); 556