1b2441318SGreg Kroah-Hartman // SPDX-License-Identifier: GPL-2.0 23d083395SSteven Rostedt /* 39d2099abSLi Bin * Dynamic function tracing support. 43d083395SSteven Rostedt * 53d083395SSteven Rostedt * Copyright (C) 2007-2008 Steven Rostedt <srostedt@redhat.com> 63d083395SSteven Rostedt * 73d083395SSteven Rostedt * Thanks goes to Ingo Molnar, for suggesting the idea. 83d083395SSteven Rostedt * Mathieu Desnoyers, for suggesting postponing the modifications. 93d083395SSteven Rostedt * Arjan van de Ven, for keeping me straight, and explaining to me 103d083395SSteven Rostedt * the dangers of modifying code on the run. 113d083395SSteven Rostedt */ 123d083395SSteven Rostedt 133bb258bfSJoe Perches #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt 143bb258bfSJoe Perches 153d083395SSteven Rostedt #include <linux/spinlock.h> 163d083395SSteven Rostedt #include <linux/hardirq.h> 176f93fc07SSteven Rostedt #include <linux/uaccess.h> 183d083395SSteven Rostedt #include <linux/ftrace.h> 193d083395SSteven Rostedt #include <linux/percpu.h> 2019b3e967SIngo Molnar #include <linux/sched.h> 21f3bea491SSteven Rostedt (Red Hat) #include <linux/slab.h> 223d083395SSteven Rostedt #include <linux/init.h> 233d083395SSteven Rostedt #include <linux/list.h> 2484e1c6bbSmatthieu castet #include <linux/module.h> 253d083395SSteven Rostedt 2647788c58SFrederic Weisbecker #include <trace/syscall.h> 2747788c58SFrederic Weisbecker 28d1163651SLaura Abbott #include <asm/set_memory.h> 2959a094c9SSteven Rostedt #include <asm/kprobes.h> 30395a59d0SAbhishek Sagar #include <asm/ftrace.h> 31732f3ca7SSteven Rostedt #include <asm/nops.h> 323d083395SSteven Rostedt 33caf4b323SFrederic Weisbecker #ifdef CONFIG_DYNAMIC_FTRACE 343d083395SSteven Rostedt 3516239630SSteven Rostedt int ftrace_arch_code_modify_prepare(void) 3616239630SSteven Rostedt { 3716239630SSteven Rostedt set_kernel_text_rw(); 3884e1c6bbSmatthieu castet set_all_modules_text_rw(); 3916239630SSteven Rostedt return 0; 4016239630SSteven Rostedt } 4116239630SSteven Rostedt 4216239630SSteven Rostedt int ftrace_arch_code_modify_post_process(void) 4316239630SSteven Rostedt { 4484e1c6bbSmatthieu castet set_all_modules_text_ro(); 4516239630SSteven Rostedt set_kernel_text_ro(); 4616239630SSteven Rostedt return 0; 4716239630SSteven Rostedt } 4816239630SSteven Rostedt 493d083395SSteven Rostedt union ftrace_code_union { 50395a59d0SAbhishek Sagar char code[MCOUNT_INSN_SIZE]; 513d083395SSteven Rostedt struct { 52745cfeaaSSteven Rostedt (VMware) unsigned char op; 533d083395SSteven Rostedt int offset; 543d083395SSteven Rostedt } __attribute__((packed)); 553d083395SSteven Rostedt }; 563d083395SSteven Rostedt 5715adc048SSteven Rostedt static int ftrace_calc_offset(long ip, long addr) 583c1720f0SSteven Rostedt { 593c1720f0SSteven Rostedt return (int)(addr - ip); 603d083395SSteven Rostedt } 613d083395SSteven Rostedt 62745cfeaaSSteven Rostedt (VMware) static unsigned char * 63745cfeaaSSteven Rostedt (VMware) ftrace_text_replace(unsigned char op, unsigned long ip, unsigned long addr) 643c1720f0SSteven Rostedt { 653c1720f0SSteven Rostedt static union ftrace_code_union calc; 663c1720f0SSteven Rostedt 67745cfeaaSSteven Rostedt (VMware) calc.op = op; 68395a59d0SAbhishek Sagar calc.offset = ftrace_calc_offset(ip + MCOUNT_INSN_SIZE, addr); 693c1720f0SSteven Rostedt 703c1720f0SSteven Rostedt return calc.code; 713c1720f0SSteven Rostedt } 723c1720f0SSteven Rostedt 73745cfeaaSSteven Rostedt (VMware) static unsigned char * 74745cfeaaSSteven Rostedt (VMware) ftrace_call_replace(unsigned long ip, unsigned long addr) 75745cfeaaSSteven Rostedt (VMware) { 76745cfeaaSSteven Rostedt (VMware) return ftrace_text_replace(0xe8, ip, addr); 77745cfeaaSSteven Rostedt (VMware) } 78745cfeaaSSteven Rostedt (VMware) 7955ca3cc1SSuresh Siddha static inline int 8055ca3cc1SSuresh Siddha within(unsigned long addr, unsigned long start, unsigned long end) 8155ca3cc1SSuresh Siddha { 8255ca3cc1SSuresh Siddha return addr >= start && addr < end; 8355ca3cc1SSuresh Siddha } 8455ca3cc1SSuresh Siddha 8587fbb2acSSteven Rostedt (Red Hat) static unsigned long text_ip_addr(unsigned long ip) 8617666f02SSteven Rostedt { 8755ca3cc1SSuresh Siddha /* 889ccaf77cSKees Cook * On x86_64, kernel text mappings are mapped read-only, so we use 899ccaf77cSKees Cook * the kernel identity mapping instead of the kernel text mapping 909ccaf77cSKees Cook * to modify the kernel text. 9155ca3cc1SSuresh Siddha * 9255ca3cc1SSuresh Siddha * For 32bit kernels, these mappings are same and we can use 9355ca3cc1SSuresh Siddha * kernel identity mapping to modify code. 9455ca3cc1SSuresh Siddha */ 9555ca3cc1SSuresh Siddha if (within(ip, (unsigned long)_text, (unsigned long)_etext)) 96217f155eSAlexander Duyck ip = (unsigned long)__va(__pa_symbol(ip)); 9755ca3cc1SSuresh Siddha 9887fbb2acSSteven Rostedt (Red Hat) return ip; 9917666f02SSteven Rostedt } 10017666f02SSteven Rostedt 101dc326fcaSH. Peter Anvin static const unsigned char *ftrace_nop_replace(void) 102caf4b323SFrederic Weisbecker { 103dc326fcaSH. Peter Anvin return ideal_nops[NOP_ATOMIC5]; 104caf4b323SFrederic Weisbecker } 105caf4b323SFrederic Weisbecker 10631e88909SSteven Rostedt static int 1078a4d0a68SSteven Rostedt ftrace_modify_code_direct(unsigned long ip, unsigned const char *old_code, 1080d098a7dSRakib Mullick unsigned const char *new_code) 1093d083395SSteven Rostedt { 1106f93fc07SSteven Rostedt unsigned char replaced[MCOUNT_INSN_SIZE]; 1113d083395SSteven Rostedt 112b05086c7SSteven Rostedt (Red Hat) ftrace_expected = old_code; 113b05086c7SSteven Rostedt (Red Hat) 1143d083395SSteven Rostedt /* 115c5d641f9SLi Bin * Note: 116c5d641f9SLi Bin * We are paranoid about modifying text, as if a bug was to happen, it 117c5d641f9SLi Bin * could cause us to read or write to someplace that could cause harm. 118c5d641f9SLi Bin * Carefully read and modify the code with probe_kernel_*(), and make 119c5d641f9SLi Bin * sure what we read is what we expected it to be before modifying it. 1203d083395SSteven Rostedt */ 12176aefee5SSteven Rostedt 12276aefee5SSteven Rostedt /* read the text we want to modify */ 123ab9a0918SSteven Rostedt if (probe_kernel_read(replaced, (void *)ip, MCOUNT_INSN_SIZE)) 124593eb8a2SSteven Rostedt return -EFAULT; 1256f93fc07SSteven Rostedt 12676aefee5SSteven Rostedt /* Make sure it is what we expect it to be */ 1276f93fc07SSteven Rostedt if (memcmp(replaced, old_code, MCOUNT_INSN_SIZE) != 0) 128593eb8a2SSteven Rostedt return -EINVAL; 1296f93fc07SSteven Rostedt 13087fbb2acSSteven Rostedt (Red Hat) ip = text_ip_addr(ip); 13187fbb2acSSteven Rostedt (Red Hat) 13276aefee5SSteven Rostedt /* replace the text with the new text */ 13387fbb2acSSteven Rostedt (Red Hat) if (probe_kernel_write((void *)ip, new_code, MCOUNT_INSN_SIZE)) 134593eb8a2SSteven Rostedt return -EPERM; 1356f93fc07SSteven Rostedt 1363d083395SSteven Rostedt sync_core(); 1373d083395SSteven Rostedt 1386f93fc07SSteven Rostedt return 0; 1393d083395SSteven Rostedt } 1403d083395SSteven Rostedt 14131e88909SSteven Rostedt int ftrace_make_nop(struct module *mod, 14231e88909SSteven Rostedt struct dyn_ftrace *rec, unsigned long addr) 14331e88909SSteven Rostedt { 1440d098a7dSRakib Mullick unsigned const char *new, *old; 14531e88909SSteven Rostedt unsigned long ip = rec->ip; 14631e88909SSteven Rostedt 14731e88909SSteven Rostedt old = ftrace_call_replace(ip, addr); 14831e88909SSteven Rostedt new = ftrace_nop_replace(); 14931e88909SSteven Rostedt 1508a4d0a68SSteven Rostedt /* 1518a4d0a68SSteven Rostedt * On boot up, and when modules are loaded, the MCOUNT_ADDR 1528a4d0a68SSteven Rostedt * is converted to a nop, and will never become MCOUNT_ADDR 1538a4d0a68SSteven Rostedt * again. This code is either running before SMP (on boot up) 1548a4d0a68SSteven Rostedt * or before the code will ever be executed (module load). 1558a4d0a68SSteven Rostedt * We do not want to use the breakpoint version in this case, 1568a4d0a68SSteven Rostedt * just modify the code directly. 1578a4d0a68SSteven Rostedt */ 1588a4d0a68SSteven Rostedt if (addr == MCOUNT_ADDR) 1598a4d0a68SSteven Rostedt return ftrace_modify_code_direct(rec->ip, old, new); 1608a4d0a68SSteven Rostedt 161b05086c7SSteven Rostedt (Red Hat) ftrace_expected = NULL; 162b05086c7SSteven Rostedt (Red Hat) 1638a4d0a68SSteven Rostedt /* Normal cases use add_brk_on_nop */ 1648a4d0a68SSteven Rostedt WARN_ONCE(1, "invalid use of ftrace_make_nop"); 1658a4d0a68SSteven Rostedt return -EINVAL; 16631e88909SSteven Rostedt } 16731e88909SSteven Rostedt 16831e88909SSteven Rostedt int ftrace_make_call(struct dyn_ftrace *rec, unsigned long addr) 16931e88909SSteven Rostedt { 1700d098a7dSRakib Mullick unsigned const char *new, *old; 17131e88909SSteven Rostedt unsigned long ip = rec->ip; 17231e88909SSteven Rostedt 17331e88909SSteven Rostedt old = ftrace_nop_replace(); 17431e88909SSteven Rostedt new = ftrace_call_replace(ip, addr); 17531e88909SSteven Rostedt 1768a4d0a68SSteven Rostedt /* Should only be called when module is loaded */ 1778a4d0a68SSteven Rostedt return ftrace_modify_code_direct(rec->ip, old, new); 178d61f82d0SSteven Rostedt } 179d61f82d0SSteven Rostedt 180a192cd04SSteven Rostedt /* 181a192cd04SSteven Rostedt * The modifying_ftrace_code is used to tell the breakpoint 182a192cd04SSteven Rostedt * handler to call ftrace_int3_handler(). If it fails to 183a192cd04SSteven Rostedt * call this handler for a breakpoint added by ftrace, then 184a192cd04SSteven Rostedt * the kernel may crash. 185a192cd04SSteven Rostedt * 186a192cd04SSteven Rostedt * As atomic_writes on x86 do not need a barrier, we do not 187a192cd04SSteven Rostedt * need to add smp_mb()s for this to work. It is also considered 188a192cd04SSteven Rostedt * that we can not read the modifying_ftrace_code before 189a192cd04SSteven Rostedt * executing the breakpoint. That would be quite remarkable if 190a192cd04SSteven Rostedt * it could do that. Here's the flow that is required: 191a192cd04SSteven Rostedt * 192a192cd04SSteven Rostedt * CPU-0 CPU-1 193a192cd04SSteven Rostedt * 194a192cd04SSteven Rostedt * atomic_inc(mfc); 195a192cd04SSteven Rostedt * write int3s 196a192cd04SSteven Rostedt * <trap-int3> // implicit (r)mb 197a192cd04SSteven Rostedt * if (atomic_read(mfc)) 198a192cd04SSteven Rostedt * call ftrace_int3_handler() 199a192cd04SSteven Rostedt * 200a192cd04SSteven Rostedt * Then when we are finished: 201a192cd04SSteven Rostedt * 202a192cd04SSteven Rostedt * atomic_dec(mfc); 203a192cd04SSteven Rostedt * 204a192cd04SSteven Rostedt * If we hit a breakpoint that was not set by ftrace, it does not 205a192cd04SSteven Rostedt * matter if ftrace_int3_handler() is called or not. It will 206a192cd04SSteven Rostedt * simply be ignored. But it is crucial that a ftrace nop/caller 207a192cd04SSteven Rostedt * breakpoint is handled. No other user should ever place a 208a192cd04SSteven Rostedt * breakpoint on an ftrace nop/caller location. It must only 209a192cd04SSteven Rostedt * be done by this code. 210a192cd04SSteven Rostedt */ 211a192cd04SSteven Rostedt atomic_t modifying_ftrace_code __read_mostly; 21208d636b6SSteven Rostedt 2138a4d0a68SSteven Rostedt static int 2148a4d0a68SSteven Rostedt ftrace_modify_code(unsigned long ip, unsigned const char *old_code, 2158a4d0a68SSteven Rostedt unsigned const char *new_code); 2168a4d0a68SSteven Rostedt 21708f6fba5SSteven Rostedt /* 21808f6fba5SSteven Rostedt * Should never be called: 21908f6fba5SSteven Rostedt * As it is only called by __ftrace_replace_code() which is called by 22008f6fba5SSteven Rostedt * ftrace_replace_code() that x86 overrides, and by ftrace_update_code() 22108f6fba5SSteven Rostedt * which is called to turn mcount into nops or nops into function calls 22208f6fba5SSteven Rostedt * but not to convert a function from not using regs to one that uses 22308f6fba5SSteven Rostedt * regs, which ftrace_modify_call() is for. 22408f6fba5SSteven Rostedt */ 22508f6fba5SSteven Rostedt int ftrace_modify_call(struct dyn_ftrace *rec, unsigned long old_addr, 22608f6fba5SSteven Rostedt unsigned long addr) 22708f6fba5SSteven Rostedt { 22808f6fba5SSteven Rostedt WARN_ON(1); 229b05086c7SSteven Rostedt (Red Hat) ftrace_expected = NULL; 23008f6fba5SSteven Rostedt return -EINVAL; 23108f6fba5SSteven Rostedt } 23208f6fba5SSteven Rostedt 23387fbb2acSSteven Rostedt (Red Hat) static unsigned long ftrace_update_func; 23487fbb2acSSteven Rostedt (Red Hat) 23587fbb2acSSteven Rostedt (Red Hat) static int update_ftrace_func(unsigned long ip, void *new) 2368a4d0a68SSteven Rostedt { 23787fbb2acSSteven Rostedt (Red Hat) unsigned char old[MCOUNT_INSN_SIZE]; 2388a4d0a68SSteven Rostedt int ret; 2398a4d0a68SSteven Rostedt 24087fbb2acSSteven Rostedt (Red Hat) memcpy(old, (void *)ip, MCOUNT_INSN_SIZE); 24187fbb2acSSteven Rostedt (Red Hat) 24287fbb2acSSteven Rostedt (Red Hat) ftrace_update_func = ip; 24387fbb2acSSteven Rostedt (Red Hat) /* Make sure the breakpoints see the ftrace_update_func update */ 24487fbb2acSSteven Rostedt (Red Hat) smp_wmb(); 2458a4d0a68SSteven Rostedt 2468a4d0a68SSteven Rostedt /* See comment above by declaration of modifying_ftrace_code */ 2478a4d0a68SSteven Rostedt atomic_inc(&modifying_ftrace_code); 2488a4d0a68SSteven Rostedt 2498a4d0a68SSteven Rostedt ret = ftrace_modify_code(ip, old, new); 2508a4d0a68SSteven Rostedt 25187fbb2acSSteven Rostedt (Red Hat) atomic_dec(&modifying_ftrace_code); 25287fbb2acSSteven Rostedt (Red Hat) 25387fbb2acSSteven Rostedt (Red Hat) return ret; 25487fbb2acSSteven Rostedt (Red Hat) } 25587fbb2acSSteven Rostedt (Red Hat) 25687fbb2acSSteven Rostedt (Red Hat) int ftrace_update_ftrace_func(ftrace_func_t func) 25787fbb2acSSteven Rostedt (Red Hat) { 25887fbb2acSSteven Rostedt (Red Hat) unsigned long ip = (unsigned long)(&ftrace_call); 25987fbb2acSSteven Rostedt (Red Hat) unsigned char *new; 26087fbb2acSSteven Rostedt (Red Hat) int ret; 26187fbb2acSSteven Rostedt (Red Hat) 26287fbb2acSSteven Rostedt (Red Hat) new = ftrace_call_replace(ip, (unsigned long)func); 26387fbb2acSSteven Rostedt (Red Hat) ret = update_ftrace_func(ip, new); 26487fbb2acSSteven Rostedt (Red Hat) 26508f6fba5SSteven Rostedt /* Also update the regs callback function */ 26608f6fba5SSteven Rostedt if (!ret) { 26708f6fba5SSteven Rostedt ip = (unsigned long)(&ftrace_regs_call); 26808f6fba5SSteven Rostedt new = ftrace_call_replace(ip, (unsigned long)func); 26987fbb2acSSteven Rostedt (Red Hat) ret = update_ftrace_func(ip, new); 27008f6fba5SSteven Rostedt } 27108f6fba5SSteven Rostedt 2728a4d0a68SSteven Rostedt return ret; 2738a4d0a68SSteven Rostedt } 2748a4d0a68SSteven Rostedt 275c13324a5SMasami Hiramatsu static nokprobe_inline int is_ftrace_caller(unsigned long ip) 276ab4ead02SKevin Hao { 27787fbb2acSSteven Rostedt (Red Hat) if (ip == ftrace_update_func) 278ab4ead02SKevin Hao return 1; 279ab4ead02SKevin Hao 280ab4ead02SKevin Hao return 0; 281ab4ead02SKevin Hao } 282ab4ead02SKevin Hao 28308d636b6SSteven Rostedt /* 28408d636b6SSteven Rostedt * A breakpoint was added to the code address we are about to 28508d636b6SSteven Rostedt * modify, and this is the handle that will just skip over it. 28608d636b6SSteven Rostedt * We are either changing a nop into a trace call, or a trace 28708d636b6SSteven Rostedt * call to a nop. While the change is taking place, we treat 28808d636b6SSteven Rostedt * it just like it was a nop. 28908d636b6SSteven Rostedt */ 29008d636b6SSteven Rostedt int ftrace_int3_handler(struct pt_regs *regs) 29108d636b6SSteven Rostedt { 292ab4ead02SKevin Hao unsigned long ip; 293ab4ead02SKevin Hao 29408d636b6SSteven Rostedt if (WARN_ON_ONCE(!regs)) 29508d636b6SSteven Rostedt return 0; 29608d636b6SSteven Rostedt 297ab4ead02SKevin Hao ip = regs->ip - 1; 298ab4ead02SKevin Hao if (!ftrace_location(ip) && !is_ftrace_caller(ip)) 29908d636b6SSteven Rostedt return 0; 30008d636b6SSteven Rostedt 30108d636b6SSteven Rostedt regs->ip += MCOUNT_INSN_SIZE - 1; 30208d636b6SSteven Rostedt 30308d636b6SSteven Rostedt return 1; 30408d636b6SSteven Rostedt } 305c13324a5SMasami Hiramatsu NOKPROBE_SYMBOL(ftrace_int3_handler); 30608d636b6SSteven Rostedt 30708d636b6SSteven Rostedt static int ftrace_write(unsigned long ip, const char *val, int size) 30808d636b6SSteven Rostedt { 309964f7b6bSPetr Mladek ip = text_ip_addr(ip); 31008d636b6SSteven Rostedt 31192550405SSteven Rostedt (Red Hat) if (probe_kernel_write((void *)ip, val, size)) 31292550405SSteven Rostedt (Red Hat) return -EPERM; 31392550405SSteven Rostedt (Red Hat) 31492550405SSteven Rostedt (Red Hat) return 0; 31508d636b6SSteven Rostedt } 31608d636b6SSteven Rostedt 31708d636b6SSteven Rostedt static int add_break(unsigned long ip, const char *old) 31808d636b6SSteven Rostedt { 31908d636b6SSteven Rostedt unsigned char replaced[MCOUNT_INSN_SIZE]; 32008d636b6SSteven Rostedt unsigned char brk = BREAKPOINT_INSTRUCTION; 32108d636b6SSteven Rostedt 32208d636b6SSteven Rostedt if (probe_kernel_read(replaced, (void *)ip, MCOUNT_INSN_SIZE)) 32308d636b6SSteven Rostedt return -EFAULT; 32408d636b6SSteven Rostedt 325b05086c7SSteven Rostedt (Red Hat) ftrace_expected = old; 326b05086c7SSteven Rostedt (Red Hat) 32708d636b6SSteven Rostedt /* Make sure it is what we expect it to be */ 32808d636b6SSteven Rostedt if (memcmp(replaced, old, MCOUNT_INSN_SIZE) != 0) 32908d636b6SSteven Rostedt return -EINVAL; 33008d636b6SSteven Rostedt 33192550405SSteven Rostedt (Red Hat) return ftrace_write(ip, &brk, 1); 33208d636b6SSteven Rostedt } 33308d636b6SSteven Rostedt 33408d636b6SSteven Rostedt static int add_brk_on_call(struct dyn_ftrace *rec, unsigned long addr) 33508d636b6SSteven Rostedt { 33608d636b6SSteven Rostedt unsigned const char *old; 33708d636b6SSteven Rostedt unsigned long ip = rec->ip; 33808d636b6SSteven Rostedt 33908d636b6SSteven Rostedt old = ftrace_call_replace(ip, addr); 34008d636b6SSteven Rostedt 34108d636b6SSteven Rostedt return add_break(rec->ip, old); 34208d636b6SSteven Rostedt } 34308d636b6SSteven Rostedt 34408d636b6SSteven Rostedt 34508d636b6SSteven Rostedt static int add_brk_on_nop(struct dyn_ftrace *rec) 34608d636b6SSteven Rostedt { 34708d636b6SSteven Rostedt unsigned const char *old; 34808d636b6SSteven Rostedt 34908d636b6SSteven Rostedt old = ftrace_nop_replace(); 35008d636b6SSteven Rostedt 35108d636b6SSteven Rostedt return add_break(rec->ip, old); 35208d636b6SSteven Rostedt } 35308d636b6SSteven Rostedt 35408d636b6SSteven Rostedt static int add_breakpoints(struct dyn_ftrace *rec, int enable) 35508d636b6SSteven Rostedt { 35608d636b6SSteven Rostedt unsigned long ftrace_addr; 35708d636b6SSteven Rostedt int ret; 35808d636b6SSteven Rostedt 3597413af1fSSteven Rostedt (Red Hat) ftrace_addr = ftrace_get_addr_curr(rec); 36008d636b6SSteven Rostedt 36194792ea0SSteven Rostedt (Red Hat) ret = ftrace_test_record(rec, enable); 36208d636b6SSteven Rostedt 36308d636b6SSteven Rostedt switch (ret) { 36408d636b6SSteven Rostedt case FTRACE_UPDATE_IGNORE: 36508d636b6SSteven Rostedt return 0; 36608d636b6SSteven Rostedt 36708d636b6SSteven Rostedt case FTRACE_UPDATE_MAKE_CALL: 36808d636b6SSteven Rostedt /* converting nop to call */ 36908d636b6SSteven Rostedt return add_brk_on_nop(rec); 37008d636b6SSteven Rostedt 37108f6fba5SSteven Rostedt case FTRACE_UPDATE_MODIFY_CALL: 37208d636b6SSteven Rostedt case FTRACE_UPDATE_MAKE_NOP: 37308d636b6SSteven Rostedt /* converting a call to a nop */ 37408d636b6SSteven Rostedt return add_brk_on_call(rec, ftrace_addr); 37508d636b6SSteven Rostedt } 37608d636b6SSteven Rostedt return 0; 37708d636b6SSteven Rostedt } 37808d636b6SSteven Rostedt 37908d636b6SSteven Rostedt /* 38008d636b6SSteven Rostedt * On error, we need to remove breakpoints. This needs to 38108d636b6SSteven Rostedt * be done caefully. If the address does not currently have a 38208d636b6SSteven Rostedt * breakpoint, we know we are done. Otherwise, we look at the 38308d636b6SSteven Rostedt * remaining 4 bytes of the instruction. If it matches a nop 38408d636b6SSteven Rostedt * we replace the breakpoint with the nop. Otherwise we replace 38508d636b6SSteven Rostedt * it with the call instruction. 38608d636b6SSteven Rostedt */ 38708d636b6SSteven Rostedt static int remove_breakpoint(struct dyn_ftrace *rec) 38808d636b6SSteven Rostedt { 38908d636b6SSteven Rostedt unsigned char ins[MCOUNT_INSN_SIZE]; 39008d636b6SSteven Rostedt unsigned char brk = BREAKPOINT_INSTRUCTION; 39108d636b6SSteven Rostedt const unsigned char *nop; 39208d636b6SSteven Rostedt unsigned long ftrace_addr; 39308d636b6SSteven Rostedt unsigned long ip = rec->ip; 39408d636b6SSteven Rostedt 39508d636b6SSteven Rostedt /* If we fail the read, just give up */ 39608d636b6SSteven Rostedt if (probe_kernel_read(ins, (void *)ip, MCOUNT_INSN_SIZE)) 39708d636b6SSteven Rostedt return -EFAULT; 39808d636b6SSteven Rostedt 39908d636b6SSteven Rostedt /* If this does not have a breakpoint, we are done */ 40008d636b6SSteven Rostedt if (ins[0] != brk) 4017f11f5ecSPetr Mladek return 0; 40208d636b6SSteven Rostedt 40308d636b6SSteven Rostedt nop = ftrace_nop_replace(); 40408d636b6SSteven Rostedt 40508d636b6SSteven Rostedt /* 40608d636b6SSteven Rostedt * If the last 4 bytes of the instruction do not match 40708d636b6SSteven Rostedt * a nop, then we assume that this is a call to ftrace_addr. 40808d636b6SSteven Rostedt */ 40908d636b6SSteven Rostedt if (memcmp(&ins[1], &nop[1], MCOUNT_INSN_SIZE - 1) != 0) { 41008d636b6SSteven Rostedt /* 41108d636b6SSteven Rostedt * For extra paranoidism, we check if the breakpoint is on 41208d636b6SSteven Rostedt * a call that would actually jump to the ftrace_addr. 41308d636b6SSteven Rostedt * If not, don't touch the breakpoint, we make just create 41408d636b6SSteven Rostedt * a disaster. 41508d636b6SSteven Rostedt */ 4167413af1fSSteven Rostedt (Red Hat) ftrace_addr = ftrace_get_addr_new(rec); 41708f6fba5SSteven Rostedt nop = ftrace_call_replace(ip, ftrace_addr); 41808f6fba5SSteven Rostedt 41908f6fba5SSteven Rostedt if (memcmp(&ins[1], &nop[1], MCOUNT_INSN_SIZE - 1) == 0) 42008f6fba5SSteven Rostedt goto update; 42108f6fba5SSteven Rostedt 42208f6fba5SSteven Rostedt /* Check both ftrace_addr and ftrace_old_addr */ 4237413af1fSSteven Rostedt (Red Hat) ftrace_addr = ftrace_get_addr_curr(rec); 42408d636b6SSteven Rostedt nop = ftrace_call_replace(ip, ftrace_addr); 42508d636b6SSteven Rostedt 426b05086c7SSteven Rostedt (Red Hat) ftrace_expected = nop; 427b05086c7SSteven Rostedt (Red Hat) 42808d636b6SSteven Rostedt if (memcmp(&ins[1], &nop[1], MCOUNT_INSN_SIZE - 1) != 0) 42908d636b6SSteven Rostedt return -EINVAL; 43008d636b6SSteven Rostedt } 43108d636b6SSteven Rostedt 43208f6fba5SSteven Rostedt update: 433c932c6b7SSteven Rostedt (Red Hat) return ftrace_write(ip, nop, 1); 43408d636b6SSteven Rostedt } 43508d636b6SSteven Rostedt 43608d636b6SSteven Rostedt static int add_update_code(unsigned long ip, unsigned const char *new) 43708d636b6SSteven Rostedt { 43808d636b6SSteven Rostedt /* skip breakpoint */ 43908d636b6SSteven Rostedt ip++; 44008d636b6SSteven Rostedt new++; 44192550405SSteven Rostedt (Red Hat) return ftrace_write(ip, new, MCOUNT_INSN_SIZE - 1); 44208d636b6SSteven Rostedt } 44308d636b6SSteven Rostedt 44408d636b6SSteven Rostedt static int add_update_call(struct dyn_ftrace *rec, unsigned long addr) 44508d636b6SSteven Rostedt { 44608d636b6SSteven Rostedt unsigned long ip = rec->ip; 44708d636b6SSteven Rostedt unsigned const char *new; 44808d636b6SSteven Rostedt 44908d636b6SSteven Rostedt new = ftrace_call_replace(ip, addr); 45008d636b6SSteven Rostedt return add_update_code(ip, new); 45108d636b6SSteven Rostedt } 45208d636b6SSteven Rostedt 45308d636b6SSteven Rostedt static int add_update_nop(struct dyn_ftrace *rec) 45408d636b6SSteven Rostedt { 45508d636b6SSteven Rostedt unsigned long ip = rec->ip; 45608d636b6SSteven Rostedt unsigned const char *new; 45708d636b6SSteven Rostedt 45808d636b6SSteven Rostedt new = ftrace_nop_replace(); 45908d636b6SSteven Rostedt return add_update_code(ip, new); 46008d636b6SSteven Rostedt } 46108d636b6SSteven Rostedt 46208d636b6SSteven Rostedt static int add_update(struct dyn_ftrace *rec, int enable) 46308d636b6SSteven Rostedt { 46408d636b6SSteven Rostedt unsigned long ftrace_addr; 46508d636b6SSteven Rostedt int ret; 46608d636b6SSteven Rostedt 46708d636b6SSteven Rostedt ret = ftrace_test_record(rec, enable); 46808d636b6SSteven Rostedt 4697413af1fSSteven Rostedt (Red Hat) ftrace_addr = ftrace_get_addr_new(rec); 47008d636b6SSteven Rostedt 47108d636b6SSteven Rostedt switch (ret) { 47208d636b6SSteven Rostedt case FTRACE_UPDATE_IGNORE: 47308d636b6SSteven Rostedt return 0; 47408d636b6SSteven Rostedt 47508f6fba5SSteven Rostedt case FTRACE_UPDATE_MODIFY_CALL: 47608d636b6SSteven Rostedt case FTRACE_UPDATE_MAKE_CALL: 47708d636b6SSteven Rostedt /* converting nop to call */ 47808d636b6SSteven Rostedt return add_update_call(rec, ftrace_addr); 47908d636b6SSteven Rostedt 48008d636b6SSteven Rostedt case FTRACE_UPDATE_MAKE_NOP: 48108d636b6SSteven Rostedt /* converting a call to a nop */ 48208d636b6SSteven Rostedt return add_update_nop(rec); 48308d636b6SSteven Rostedt } 48408d636b6SSteven Rostedt 48508d636b6SSteven Rostedt return 0; 48608d636b6SSteven Rostedt } 48708d636b6SSteven Rostedt 48808d636b6SSteven Rostedt static int finish_update_call(struct dyn_ftrace *rec, unsigned long addr) 48908d636b6SSteven Rostedt { 49008d636b6SSteven Rostedt unsigned long ip = rec->ip; 49108d636b6SSteven Rostedt unsigned const char *new; 49208d636b6SSteven Rostedt 49308d636b6SSteven Rostedt new = ftrace_call_replace(ip, addr); 49408d636b6SSteven Rostedt 49592550405SSteven Rostedt (Red Hat) return ftrace_write(ip, new, 1); 49608d636b6SSteven Rostedt } 49708d636b6SSteven Rostedt 49808d636b6SSteven Rostedt static int finish_update_nop(struct dyn_ftrace *rec) 49908d636b6SSteven Rostedt { 50008d636b6SSteven Rostedt unsigned long ip = rec->ip; 50108d636b6SSteven Rostedt unsigned const char *new; 50208d636b6SSteven Rostedt 50308d636b6SSteven Rostedt new = ftrace_nop_replace(); 50408d636b6SSteven Rostedt 50592550405SSteven Rostedt (Red Hat) return ftrace_write(ip, new, 1); 50608d636b6SSteven Rostedt } 50708d636b6SSteven Rostedt 50808d636b6SSteven Rostedt static int finish_update(struct dyn_ftrace *rec, int enable) 50908d636b6SSteven Rostedt { 51008d636b6SSteven Rostedt unsigned long ftrace_addr; 51108d636b6SSteven Rostedt int ret; 51208d636b6SSteven Rostedt 51308d636b6SSteven Rostedt ret = ftrace_update_record(rec, enable); 51408d636b6SSteven Rostedt 5157413af1fSSteven Rostedt (Red Hat) ftrace_addr = ftrace_get_addr_new(rec); 51608d636b6SSteven Rostedt 51708d636b6SSteven Rostedt switch (ret) { 51808d636b6SSteven Rostedt case FTRACE_UPDATE_IGNORE: 51908d636b6SSteven Rostedt return 0; 52008d636b6SSteven Rostedt 52108f6fba5SSteven Rostedt case FTRACE_UPDATE_MODIFY_CALL: 52208d636b6SSteven Rostedt case FTRACE_UPDATE_MAKE_CALL: 52308d636b6SSteven Rostedt /* converting nop to call */ 52408d636b6SSteven Rostedt return finish_update_call(rec, ftrace_addr); 52508d636b6SSteven Rostedt 52608d636b6SSteven Rostedt case FTRACE_UPDATE_MAKE_NOP: 52708d636b6SSteven Rostedt /* converting a call to a nop */ 52808d636b6SSteven Rostedt return finish_update_nop(rec); 52908d636b6SSteven Rostedt } 53008d636b6SSteven Rostedt 53108d636b6SSteven Rostedt return 0; 53208d636b6SSteven Rostedt } 53308d636b6SSteven Rostedt 53408d636b6SSteven Rostedt static void do_sync_core(void *data) 53508d636b6SSteven Rostedt { 53608d636b6SSteven Rostedt sync_core(); 53708d636b6SSteven Rostedt } 53808d636b6SSteven Rostedt 53908d636b6SSteven Rostedt static void run_sync(void) 54008d636b6SSteven Rostedt { 5412b87965aSSteven Rostedt (VMware) int enable_irqs; 5422b87965aSSteven Rostedt (VMware) 5432b87965aSSteven Rostedt (VMware) /* No need to sync if there's only one CPU */ 5442b87965aSSteven Rostedt (VMware) if (num_online_cpus() == 1) 5452b87965aSSteven Rostedt (VMware) return; 5462b87965aSSteven Rostedt (VMware) 5472b87965aSSteven Rostedt (VMware) enable_irqs = irqs_disabled(); 54808d636b6SSteven Rostedt 5498a1115ffSMasahiro Yamada /* We may be called with interrupts disabled (on bootup). */ 55008d636b6SSteven Rostedt if (enable_irqs) 55108d636b6SSteven Rostedt local_irq_enable(); 55208d636b6SSteven Rostedt on_each_cpu(do_sync_core, NULL, 1); 55308d636b6SSteven Rostedt if (enable_irqs) 55408d636b6SSteven Rostedt local_irq_disable(); 55508d636b6SSteven Rostedt } 55608d636b6SSteven Rostedt 557e4f5d544SSteven Rostedt void ftrace_replace_code(int enable) 55808d636b6SSteven Rostedt { 55908d636b6SSteven Rostedt struct ftrace_rec_iter *iter; 56008d636b6SSteven Rostedt struct dyn_ftrace *rec; 56108d636b6SSteven Rostedt const char *report = "adding breakpoints"; 56208d636b6SSteven Rostedt int count = 0; 56308d636b6SSteven Rostedt int ret; 56408d636b6SSteven Rostedt 56508d636b6SSteven Rostedt for_ftrace_rec_iter(iter) { 56608d636b6SSteven Rostedt rec = ftrace_rec_iter_record(iter); 56708d636b6SSteven Rostedt 56808d636b6SSteven Rostedt ret = add_breakpoints(rec, enable); 56908d636b6SSteven Rostedt if (ret) 57008d636b6SSteven Rostedt goto remove_breakpoints; 57108d636b6SSteven Rostedt count++; 57208d636b6SSteven Rostedt } 57308d636b6SSteven Rostedt 57408d636b6SSteven Rostedt run_sync(); 57508d636b6SSteven Rostedt 57608d636b6SSteven Rostedt report = "updating code"; 577883a1e86SMinfei Huang count = 0; 57808d636b6SSteven Rostedt 57908d636b6SSteven Rostedt for_ftrace_rec_iter(iter) { 58008d636b6SSteven Rostedt rec = ftrace_rec_iter_record(iter); 58108d636b6SSteven Rostedt 58208d636b6SSteven Rostedt ret = add_update(rec, enable); 58308d636b6SSteven Rostedt if (ret) 58408d636b6SSteven Rostedt goto remove_breakpoints; 585883a1e86SMinfei Huang count++; 58608d636b6SSteven Rostedt } 58708d636b6SSteven Rostedt 58808d636b6SSteven Rostedt run_sync(); 58908d636b6SSteven Rostedt 59008d636b6SSteven Rostedt report = "removing breakpoints"; 591883a1e86SMinfei Huang count = 0; 59208d636b6SSteven Rostedt 59308d636b6SSteven Rostedt for_ftrace_rec_iter(iter) { 59408d636b6SSteven Rostedt rec = ftrace_rec_iter_record(iter); 59508d636b6SSteven Rostedt 59608d636b6SSteven Rostedt ret = finish_update(rec, enable); 59708d636b6SSteven Rostedt if (ret) 59808d636b6SSteven Rostedt goto remove_breakpoints; 599883a1e86SMinfei Huang count++; 60008d636b6SSteven Rostedt } 60108d636b6SSteven Rostedt 60208d636b6SSteven Rostedt run_sync(); 60308d636b6SSteven Rostedt 60408d636b6SSteven Rostedt return; 60508d636b6SSteven Rostedt 60608d636b6SSteven Rostedt remove_breakpoints: 60774bb8c45SPetr Mladek pr_warn("Failed on %s (%d):\n", report, count); 6084fd3279bSSteven Rostedt (Red Hat) ftrace_bug(ret, rec); 60908d636b6SSteven Rostedt for_ftrace_rec_iter(iter) { 61008d636b6SSteven Rostedt rec = ftrace_rec_iter_record(iter); 6117f11f5ecSPetr Mladek /* 6127f11f5ecSPetr Mladek * Breakpoints are handled only when this function is in 6137f11f5ecSPetr Mladek * progress. The system could not work with them. 6147f11f5ecSPetr Mladek */ 6157f11f5ecSPetr Mladek if (remove_breakpoint(rec)) 6167f11f5ecSPetr Mladek BUG(); 61708d636b6SSteven Rostedt } 618c932c6b7SSteven Rostedt (Red Hat) run_sync(); 61908d636b6SSteven Rostedt } 62008d636b6SSteven Rostedt 6218a4d0a68SSteven Rostedt static int 6228a4d0a68SSteven Rostedt ftrace_modify_code(unsigned long ip, unsigned const char *old_code, 6238a4d0a68SSteven Rostedt unsigned const char *new_code) 6248a4d0a68SSteven Rostedt { 6258a4d0a68SSteven Rostedt int ret; 6268a4d0a68SSteven Rostedt 6278a4d0a68SSteven Rostedt ret = add_break(ip, old_code); 6288a4d0a68SSteven Rostedt if (ret) 6298a4d0a68SSteven Rostedt goto out; 6308a4d0a68SSteven Rostedt 6318a4d0a68SSteven Rostedt run_sync(); 6328a4d0a68SSteven Rostedt 6338a4d0a68SSteven Rostedt ret = add_update_code(ip, new_code); 6348a4d0a68SSteven Rostedt if (ret) 6358a4d0a68SSteven Rostedt goto fail_update; 6368a4d0a68SSteven Rostedt 6378a4d0a68SSteven Rostedt run_sync(); 6388a4d0a68SSteven Rostedt 6398a4d0a68SSteven Rostedt ret = ftrace_write(ip, new_code, 1); 6407f11f5ecSPetr Mladek /* 6417f11f5ecSPetr Mladek * The breakpoint is handled only when this function is in progress. 6427f11f5ecSPetr Mladek * The system could not work if we could not remove it. 6437f11f5ecSPetr Mladek */ 6447f11f5ecSPetr Mladek BUG_ON(ret); 6458a4d0a68SSteven Rostedt out: 64612729f14SPetr Mladek run_sync(); 6478a4d0a68SSteven Rostedt return ret; 6488a4d0a68SSteven Rostedt 6498a4d0a68SSteven Rostedt fail_update: 6507f11f5ecSPetr Mladek /* Also here the system could not work with the breakpoint */ 6517f11f5ecSPetr Mladek if (ftrace_write(ip, old_code, 1)) 6527f11f5ecSPetr Mladek BUG(); 6538a4d0a68SSteven Rostedt goto out; 6548a4d0a68SSteven Rostedt } 6558a4d0a68SSteven Rostedt 65608d636b6SSteven Rostedt void arch_ftrace_update_code(int command) 65708d636b6SSteven Rostedt { 658a192cd04SSteven Rostedt /* See comment above by declaration of modifying_ftrace_code */ 659a192cd04SSteven Rostedt atomic_inc(&modifying_ftrace_code); 66008d636b6SSteven Rostedt 661e4f5d544SSteven Rostedt ftrace_modify_all_code(command); 66208d636b6SSteven Rostedt 663a192cd04SSteven Rostedt atomic_dec(&modifying_ftrace_code); 66408d636b6SSteven Rostedt } 66508d636b6SSteven Rostedt 6663a36cb11SJiri Slaby int __init ftrace_dyn_arch_init(void) 6673d083395SSteven Rostedt { 6683d083395SSteven Rostedt return 0; 6693d083395SSteven Rostedt } 670e7d3737eSFrederic Weisbecker 671f3bea491SSteven Rostedt (Red Hat) /* Currently only x86_64 supports dynamic trampolines */ 672f3bea491SSteven Rostedt (Red Hat) #ifdef CONFIG_X86_64 673f3bea491SSteven Rostedt (Red Hat) 674f3bea491SSteven Rostedt (Red Hat) #ifdef CONFIG_MODULES 675f3bea491SSteven Rostedt (Red Hat) #include <linux/moduleloader.h> 676f3bea491SSteven Rostedt (Red Hat) /* Module allocation simplifies allocating memory for code */ 677f3bea491SSteven Rostedt (Red Hat) static inline void *alloc_tramp(unsigned long size) 678f3bea491SSteven Rostedt (Red Hat) { 679f3bea491SSteven Rostedt (Red Hat) return module_alloc(size); 680f3bea491SSteven Rostedt (Red Hat) } 681*7fdfe1e4SRick Edgecombe static inline void tramp_free(void *tramp) 682f3bea491SSteven Rostedt (Red Hat) { 683be1f221cSRusty Russell module_memfree(tramp); 684f3bea491SSteven Rostedt (Red Hat) } 685f3bea491SSteven Rostedt (Red Hat) #else 686f3bea491SSteven Rostedt (Red Hat) /* Trampolines can only be created if modules are supported */ 687f3bea491SSteven Rostedt (Red Hat) static inline void *alloc_tramp(unsigned long size) 688f3bea491SSteven Rostedt (Red Hat) { 689f3bea491SSteven Rostedt (Red Hat) return NULL; 690f3bea491SSteven Rostedt (Red Hat) } 691*7fdfe1e4SRick Edgecombe static inline void tramp_free(void *tramp) { } 692f3bea491SSteven Rostedt (Red Hat) #endif 693f3bea491SSteven Rostedt (Red Hat) 694f3bea491SSteven Rostedt (Red Hat) /* Defined as markers to the end of the ftrace default trampolines */ 695f3bea491SSteven Rostedt (Red Hat) extern void ftrace_regs_caller_end(void); 696f1b92bb6SBorislav Petkov extern void ftrace_epilogue(void); 697f3bea491SSteven Rostedt (Red Hat) extern void ftrace_caller_op_ptr(void); 698f3bea491SSteven Rostedt (Red Hat) extern void ftrace_regs_caller_op_ptr(void); 699f3bea491SSteven Rostedt (Red Hat) 700f3bea491SSteven Rostedt (Red Hat) /* movq function_trace_op(%rip), %rdx */ 701f3bea491SSteven Rostedt (Red Hat) /* 0x48 0x8b 0x15 <offset-to-ftrace_trace_op (4 bytes)> */ 702f3bea491SSteven Rostedt (Red Hat) #define OP_REF_SIZE 7 703f3bea491SSteven Rostedt (Red Hat) 704f3bea491SSteven Rostedt (Red Hat) /* 705f3bea491SSteven Rostedt (Red Hat) * The ftrace_ops is passed to the function callback. Since the 706f3bea491SSteven Rostedt (Red Hat) * trampoline only services a single ftrace_ops, we can pass in 707f3bea491SSteven Rostedt (Red Hat) * that ops directly. 708f3bea491SSteven Rostedt (Red Hat) * 709f3bea491SSteven Rostedt (Red Hat) * The ftrace_op_code_union is used to create a pointer to the 710f3bea491SSteven Rostedt (Red Hat) * ftrace_ops that will be passed to the callback function. 711f3bea491SSteven Rostedt (Red Hat) */ 712f3bea491SSteven Rostedt (Red Hat) union ftrace_op_code_union { 713f3bea491SSteven Rostedt (Red Hat) char code[OP_REF_SIZE]; 714f3bea491SSteven Rostedt (Red Hat) struct { 715f3bea491SSteven Rostedt (Red Hat) char op[3]; 716f3bea491SSteven Rostedt (Red Hat) int offset; 717f3bea491SSteven Rostedt (Red Hat) } __attribute__((packed)); 718f3bea491SSteven Rostedt (Red Hat) }; 719f3bea491SSteven Rostedt (Red Hat) 720d2a68c4eSSteven Rostedt (VMware) #define RET_SIZE 1 721d2a68c4eSSteven Rostedt (VMware) 722aec0be2dSSteven Rostedt (Red Hat) static unsigned long 723aec0be2dSSteven Rostedt (Red Hat) create_trampoline(struct ftrace_ops *ops, unsigned int *tramp_size) 724f3bea491SSteven Rostedt (Red Hat) { 725f3bea491SSteven Rostedt (Red Hat) unsigned long start_offset; 726f3bea491SSteven Rostedt (Red Hat) unsigned long end_offset; 727f3bea491SSteven Rostedt (Red Hat) unsigned long op_offset; 728f3bea491SSteven Rostedt (Red Hat) unsigned long offset; 7293c0dab44SNadav Amit unsigned long npages; 730f3bea491SSteven Rostedt (Red Hat) unsigned long size; 731d2a68c4eSSteven Rostedt (VMware) unsigned long retq; 732f3bea491SSteven Rostedt (Red Hat) unsigned long *ptr; 733f3bea491SSteven Rostedt (Red Hat) void *trampoline; 734d2a68c4eSSteven Rostedt (VMware) void *ip; 735f3bea491SSteven Rostedt (Red Hat) /* 48 8b 15 <offset> is movq <offset>(%rip), %rdx */ 736f3bea491SSteven Rostedt (Red Hat) unsigned const char op_ref[] = { 0x48, 0x8b, 0x15 }; 737f3bea491SSteven Rostedt (Red Hat) union ftrace_op_code_union op_ptr; 738f3bea491SSteven Rostedt (Red Hat) int ret; 739f3bea491SSteven Rostedt (Red Hat) 740f3bea491SSteven Rostedt (Red Hat) if (ops->flags & FTRACE_OPS_FL_SAVE_REGS) { 741f3bea491SSteven Rostedt (Red Hat) start_offset = (unsigned long)ftrace_regs_caller; 742f3bea491SSteven Rostedt (Red Hat) end_offset = (unsigned long)ftrace_regs_caller_end; 743f3bea491SSteven Rostedt (Red Hat) op_offset = (unsigned long)ftrace_regs_caller_op_ptr; 744f3bea491SSteven Rostedt (Red Hat) } else { 745f3bea491SSteven Rostedt (Red Hat) start_offset = (unsigned long)ftrace_caller; 746f1b92bb6SBorislav Petkov end_offset = (unsigned long)ftrace_epilogue; 747f3bea491SSteven Rostedt (Red Hat) op_offset = (unsigned long)ftrace_caller_op_ptr; 748f3bea491SSteven Rostedt (Red Hat) } 749f3bea491SSteven Rostedt (Red Hat) 750f3bea491SSteven Rostedt (Red Hat) size = end_offset - start_offset; 751f3bea491SSteven Rostedt (Red Hat) 752f3bea491SSteven Rostedt (Red Hat) /* 753f3bea491SSteven Rostedt (Red Hat) * Allocate enough size to store the ftrace_caller code, 754d2a68c4eSSteven Rostedt (VMware) * the iret , as well as the address of the ftrace_ops this 755d2a68c4eSSteven Rostedt (VMware) * trampoline is used for. 756f3bea491SSteven Rostedt (Red Hat) */ 757d2a68c4eSSteven Rostedt (VMware) trampoline = alloc_tramp(size + RET_SIZE + sizeof(void *)); 758f3bea491SSteven Rostedt (Red Hat) if (!trampoline) 759f3bea491SSteven Rostedt (Red Hat) return 0; 760f3bea491SSteven Rostedt (Red Hat) 761d2a68c4eSSteven Rostedt (VMware) *tramp_size = size + RET_SIZE + sizeof(void *); 7623c0dab44SNadav Amit npages = DIV_ROUND_UP(*tramp_size, PAGE_SIZE); 763aec0be2dSSteven Rostedt (Red Hat) 764f3bea491SSteven Rostedt (Red Hat) /* Copy ftrace_caller onto the trampoline memory */ 765f3bea491SSteven Rostedt (Red Hat) ret = probe_kernel_read(trampoline, (void *)start_offset, size); 766d2a68c4eSSteven Rostedt (VMware) if (WARN_ON(ret < 0)) 767d2a68c4eSSteven Rostedt (VMware) goto fail; 768f3bea491SSteven Rostedt (Red Hat) 769d2a68c4eSSteven Rostedt (VMware) ip = trampoline + size; 770f3bea491SSteven Rostedt (Red Hat) 771d2a68c4eSSteven Rostedt (VMware) /* The trampoline ends with ret(q) */ 772d2a68c4eSSteven Rostedt (VMware) retq = (unsigned long)ftrace_stub; 773d2a68c4eSSteven Rostedt (VMware) ret = probe_kernel_read(ip, (void *)retq, RET_SIZE); 774d2a68c4eSSteven Rostedt (VMware) if (WARN_ON(ret < 0)) 775d2a68c4eSSteven Rostedt (VMware) goto fail; 776f3bea491SSteven Rostedt (Red Hat) 777f3bea491SSteven Rostedt (Red Hat) /* 778f3bea491SSteven Rostedt (Red Hat) * The address of the ftrace_ops that is used for this trampoline 779f3bea491SSteven Rostedt (Red Hat) * is stored at the end of the trampoline. This will be used to 780f3bea491SSteven Rostedt (Red Hat) * load the third parameter for the callback. Basically, that 781f3bea491SSteven Rostedt (Red Hat) * location at the end of the trampoline takes the place of 782f3bea491SSteven Rostedt (Red Hat) * the global function_trace_op variable. 783f3bea491SSteven Rostedt (Red Hat) */ 784f3bea491SSteven Rostedt (Red Hat) 785d2a68c4eSSteven Rostedt (VMware) ptr = (unsigned long *)(trampoline + size + RET_SIZE); 786f3bea491SSteven Rostedt (Red Hat) *ptr = (unsigned long)ops; 787f3bea491SSteven Rostedt (Red Hat) 788f3bea491SSteven Rostedt (Red Hat) op_offset -= start_offset; 789f3bea491SSteven Rostedt (Red Hat) memcpy(&op_ptr, trampoline + op_offset, OP_REF_SIZE); 790f3bea491SSteven Rostedt (Red Hat) 791f3bea491SSteven Rostedt (Red Hat) /* Are we pointing to the reference? */ 792d2a68c4eSSteven Rostedt (VMware) if (WARN_ON(memcmp(op_ptr.op, op_ref, 3) != 0)) 793d2a68c4eSSteven Rostedt (VMware) goto fail; 794f3bea491SSteven Rostedt (Red Hat) 795f3bea491SSteven Rostedt (Red Hat) /* Load the contents of ptr into the callback parameter */ 796f3bea491SSteven Rostedt (Red Hat) offset = (unsigned long)ptr; 797f3bea491SSteven Rostedt (Red Hat) offset -= (unsigned long)trampoline + op_offset + OP_REF_SIZE; 798f3bea491SSteven Rostedt (Red Hat) 799f3bea491SSteven Rostedt (Red Hat) op_ptr.offset = offset; 800f3bea491SSteven Rostedt (Red Hat) 801f3bea491SSteven Rostedt (Red Hat) /* put in the new offset to the ftrace_ops */ 802f3bea491SSteven Rostedt (Red Hat) memcpy(trampoline + op_offset, &op_ptr, OP_REF_SIZE); 803f3bea491SSteven Rostedt (Red Hat) 804f3bea491SSteven Rostedt (Red Hat) /* ALLOC_TRAMP flags lets us know we created it */ 805f3bea491SSteven Rostedt (Red Hat) ops->flags |= FTRACE_OPS_FL_ALLOC_TRAMP; 806f3bea491SSteven Rostedt (Red Hat) 807*7fdfe1e4SRick Edgecombe set_vm_flush_reset_perms(trampoline); 808*7fdfe1e4SRick Edgecombe 8093c0dab44SNadav Amit /* 8103c0dab44SNadav Amit * Module allocation needs to be completed by making the page 8113c0dab44SNadav Amit * executable. The page is still writable, which is a security hazard, 8123c0dab44SNadav Amit * but anyhow ftrace breaks W^X completely. 8133c0dab44SNadav Amit */ 8143c0dab44SNadav Amit set_memory_x((unsigned long)trampoline, npages); 815f3bea491SSteven Rostedt (Red Hat) return (unsigned long)trampoline; 816d2a68c4eSSteven Rostedt (VMware) fail: 817*7fdfe1e4SRick Edgecombe tramp_free(trampoline); 818d2a68c4eSSteven Rostedt (VMware) return 0; 819f3bea491SSteven Rostedt (Red Hat) } 820f3bea491SSteven Rostedt (Red Hat) 82115d5b02cSSteven Rostedt (Red Hat) static unsigned long calc_trampoline_call_offset(bool save_regs) 82215d5b02cSSteven Rostedt (Red Hat) { 82315d5b02cSSteven Rostedt (Red Hat) unsigned long start_offset; 82415d5b02cSSteven Rostedt (Red Hat) unsigned long call_offset; 82515d5b02cSSteven Rostedt (Red Hat) 82615d5b02cSSteven Rostedt (Red Hat) if (save_regs) { 82715d5b02cSSteven Rostedt (Red Hat) start_offset = (unsigned long)ftrace_regs_caller; 82815d5b02cSSteven Rostedt (Red Hat) call_offset = (unsigned long)ftrace_regs_call; 82915d5b02cSSteven Rostedt (Red Hat) } else { 83015d5b02cSSteven Rostedt (Red Hat) start_offset = (unsigned long)ftrace_caller; 83115d5b02cSSteven Rostedt (Red Hat) call_offset = (unsigned long)ftrace_call; 83215d5b02cSSteven Rostedt (Red Hat) } 83315d5b02cSSteven Rostedt (Red Hat) 83415d5b02cSSteven Rostedt (Red Hat) return call_offset - start_offset; 83515d5b02cSSteven Rostedt (Red Hat) } 83615d5b02cSSteven Rostedt (Red Hat) 837f3bea491SSteven Rostedt (Red Hat) void arch_ftrace_update_trampoline(struct ftrace_ops *ops) 838f3bea491SSteven Rostedt (Red Hat) { 839f3bea491SSteven Rostedt (Red Hat) ftrace_func_t func; 840f3bea491SSteven Rostedt (Red Hat) unsigned char *new; 841f3bea491SSteven Rostedt (Red Hat) unsigned long offset; 842f3bea491SSteven Rostedt (Red Hat) unsigned long ip; 843aec0be2dSSteven Rostedt (Red Hat) unsigned int size; 8446ee98ffeSThomas Gleixner int ret, npages; 845f3bea491SSteven Rostedt (Red Hat) 846f3bea491SSteven Rostedt (Red Hat) if (ops->trampoline) { 847f3bea491SSteven Rostedt (Red Hat) /* 848f3bea491SSteven Rostedt (Red Hat) * The ftrace_ops caller may set up its own trampoline. 849f3bea491SSteven Rostedt (Red Hat) * In such a case, this code must not modify it. 850f3bea491SSteven Rostedt (Red Hat) */ 851f3bea491SSteven Rostedt (Red Hat) if (!(ops->flags & FTRACE_OPS_FL_ALLOC_TRAMP)) 852f3bea491SSteven Rostedt (Red Hat) return; 8536ee98ffeSThomas Gleixner npages = PAGE_ALIGN(ops->trampoline_size) >> PAGE_SHIFT; 8546ee98ffeSThomas Gleixner set_memory_rw(ops->trampoline, npages); 855f3bea491SSteven Rostedt (Red Hat) } else { 856aec0be2dSSteven Rostedt (Red Hat) ops->trampoline = create_trampoline(ops, &size); 857f3bea491SSteven Rostedt (Red Hat) if (!ops->trampoline) 858f3bea491SSteven Rostedt (Red Hat) return; 859aec0be2dSSteven Rostedt (Red Hat) ops->trampoline_size = size; 8606ee98ffeSThomas Gleixner npages = PAGE_ALIGN(size) >> PAGE_SHIFT; 861f3bea491SSteven Rostedt (Red Hat) } 862f3bea491SSteven Rostedt (Red Hat) 86315d5b02cSSteven Rostedt (Red Hat) offset = calc_trampoline_call_offset(ops->flags & FTRACE_OPS_FL_SAVE_REGS); 864f3bea491SSteven Rostedt (Red Hat) ip = ops->trampoline + offset; 865f3bea491SSteven Rostedt (Red Hat) 866f3bea491SSteven Rostedt (Red Hat) func = ftrace_ops_get_func(ops); 867f3bea491SSteven Rostedt (Red Hat) 868f3bea491SSteven Rostedt (Red Hat) /* Do a safe modify in case the trampoline is executing */ 869f3bea491SSteven Rostedt (Red Hat) new = ftrace_call_replace(ip, (unsigned long)func); 870f3bea491SSteven Rostedt (Red Hat) ret = update_ftrace_func(ip, new); 8716ee98ffeSThomas Gleixner set_memory_ro(ops->trampoline, npages); 872f3bea491SSteven Rostedt (Red Hat) 873f3bea491SSteven Rostedt (Red Hat) /* The update should never fail */ 874f3bea491SSteven Rostedt (Red Hat) WARN_ON(ret); 875f3bea491SSteven Rostedt (Red Hat) } 87615d5b02cSSteven Rostedt (Red Hat) 87715d5b02cSSteven Rostedt (Red Hat) /* Return the address of the function the trampoline calls */ 87815d5b02cSSteven Rostedt (Red Hat) static void *addr_from_call(void *ptr) 87915d5b02cSSteven Rostedt (Red Hat) { 88015d5b02cSSteven Rostedt (Red Hat) union ftrace_code_union calc; 88115d5b02cSSteven Rostedt (Red Hat) int ret; 88215d5b02cSSteven Rostedt (Red Hat) 88315d5b02cSSteven Rostedt (Red Hat) ret = probe_kernel_read(&calc, ptr, MCOUNT_INSN_SIZE); 88415d5b02cSSteven Rostedt (Red Hat) if (WARN_ON_ONCE(ret < 0)) 88515d5b02cSSteven Rostedt (Red Hat) return NULL; 88615d5b02cSSteven Rostedt (Red Hat) 88715d5b02cSSteven Rostedt (Red Hat) /* Make sure this is a call */ 888745cfeaaSSteven Rostedt (VMware) if (WARN_ON_ONCE(calc.op != 0xe8)) { 889745cfeaaSSteven Rostedt (VMware) pr_warn("Expected e8, got %x\n", calc.op); 89015d5b02cSSteven Rostedt (Red Hat) return NULL; 89115d5b02cSSteven Rostedt (Red Hat) } 89215d5b02cSSteven Rostedt (Red Hat) 89315d5b02cSSteven Rostedt (Red Hat) return ptr + MCOUNT_INSN_SIZE + calc.offset; 89415d5b02cSSteven Rostedt (Red Hat) } 89515d5b02cSSteven Rostedt (Red Hat) 8966a06bdbfSSteven Rostedt (Red Hat) void prepare_ftrace_return(unsigned long self_addr, unsigned long *parent, 89715d5b02cSSteven Rostedt (Red Hat) unsigned long frame_pointer); 89815d5b02cSSteven Rostedt (Red Hat) 89915d5b02cSSteven Rostedt (Red Hat) /* 90015d5b02cSSteven Rostedt (Red Hat) * If the ops->trampoline was not allocated, then it probably 90115d5b02cSSteven Rostedt (Red Hat) * has a static trampoline func, or is the ftrace caller itself. 90215d5b02cSSteven Rostedt (Red Hat) */ 90315d5b02cSSteven Rostedt (Red Hat) static void *static_tramp_func(struct ftrace_ops *ops, struct dyn_ftrace *rec) 90415d5b02cSSteven Rostedt (Red Hat) { 90515d5b02cSSteven Rostedt (Red Hat) unsigned long offset; 90615d5b02cSSteven Rostedt (Red Hat) bool save_regs = rec->flags & FTRACE_FL_REGS_EN; 90715d5b02cSSteven Rostedt (Red Hat) void *ptr; 90815d5b02cSSteven Rostedt (Red Hat) 90915d5b02cSSteven Rostedt (Red Hat) if (ops && ops->trampoline) { 91015d5b02cSSteven Rostedt (Red Hat) #ifdef CONFIG_FUNCTION_GRAPH_TRACER 91115d5b02cSSteven Rostedt (Red Hat) /* 91215d5b02cSSteven Rostedt (Red Hat) * We only know about function graph tracer setting as static 91315d5b02cSSteven Rostedt (Red Hat) * trampoline. 91415d5b02cSSteven Rostedt (Red Hat) */ 91515d5b02cSSteven Rostedt (Red Hat) if (ops->trampoline == FTRACE_GRAPH_ADDR) 91615d5b02cSSteven Rostedt (Red Hat) return (void *)prepare_ftrace_return; 91715d5b02cSSteven Rostedt (Red Hat) #endif 91815d5b02cSSteven Rostedt (Red Hat) return NULL; 91915d5b02cSSteven Rostedt (Red Hat) } 92015d5b02cSSteven Rostedt (Red Hat) 92115d5b02cSSteven Rostedt (Red Hat) offset = calc_trampoline_call_offset(save_regs); 92215d5b02cSSteven Rostedt (Red Hat) 92315d5b02cSSteven Rostedt (Red Hat) if (save_regs) 92415d5b02cSSteven Rostedt (Red Hat) ptr = (void *)FTRACE_REGS_ADDR + offset; 92515d5b02cSSteven Rostedt (Red Hat) else 92615d5b02cSSteven Rostedt (Red Hat) ptr = (void *)FTRACE_ADDR + offset; 92715d5b02cSSteven Rostedt (Red Hat) 92815d5b02cSSteven Rostedt (Red Hat) return addr_from_call(ptr); 92915d5b02cSSteven Rostedt (Red Hat) } 93015d5b02cSSteven Rostedt (Red Hat) 93115d5b02cSSteven Rostedt (Red Hat) void *arch_ftrace_trampoline_func(struct ftrace_ops *ops, struct dyn_ftrace *rec) 93215d5b02cSSteven Rostedt (Red Hat) { 93315d5b02cSSteven Rostedt (Red Hat) unsigned long offset; 93415d5b02cSSteven Rostedt (Red Hat) 93515d5b02cSSteven Rostedt (Red Hat) /* If we didn't allocate this trampoline, consider it static */ 93615d5b02cSSteven Rostedt (Red Hat) if (!ops || !(ops->flags & FTRACE_OPS_FL_ALLOC_TRAMP)) 93715d5b02cSSteven Rostedt (Red Hat) return static_tramp_func(ops, rec); 93815d5b02cSSteven Rostedt (Red Hat) 93915d5b02cSSteven Rostedt (Red Hat) offset = calc_trampoline_call_offset(ops->flags & FTRACE_OPS_FL_SAVE_REGS); 94015d5b02cSSteven Rostedt (Red Hat) return addr_from_call((void *)ops->trampoline + offset); 94115d5b02cSSteven Rostedt (Red Hat) } 94215d5b02cSSteven Rostedt (Red Hat) 94312cce594SSteven Rostedt (Red Hat) void arch_ftrace_trampoline_free(struct ftrace_ops *ops) 94412cce594SSteven Rostedt (Red Hat) { 94512cce594SSteven Rostedt (Red Hat) if (!ops || !(ops->flags & FTRACE_OPS_FL_ALLOC_TRAMP)) 94612cce594SSteven Rostedt (Red Hat) return; 94712cce594SSteven Rostedt (Red Hat) 948*7fdfe1e4SRick Edgecombe tramp_free((void *)ops->trampoline); 94912cce594SSteven Rostedt (Red Hat) ops->trampoline = 0; 95012cce594SSteven Rostedt (Red Hat) } 95115d5b02cSSteven Rostedt (Red Hat) 952f3bea491SSteven Rostedt (Red Hat) #endif /* CONFIG_X86_64 */ 953f3bea491SSteven Rostedt (Red Hat) #endif /* CONFIG_DYNAMIC_FTRACE */ 954f3bea491SSteven Rostedt (Red Hat) 955f3bea491SSteven Rostedt (Red Hat) #ifdef CONFIG_FUNCTION_GRAPH_TRACER 956f3bea491SSteven Rostedt (Red Hat) 957f3bea491SSteven Rostedt (Red Hat) #ifdef CONFIG_DYNAMIC_FTRACE 958f3bea491SSteven Rostedt (Red Hat) extern void ftrace_graph_call(void); 9595a45cfe1SSteven Rostedt 960745cfeaaSSteven Rostedt (VMware) static unsigned char *ftrace_jmp_replace(unsigned long ip, unsigned long addr) 961745cfeaaSSteven Rostedt (VMware) { 962745cfeaaSSteven Rostedt (VMware) return ftrace_text_replace(0xe9, ip, addr); 963745cfeaaSSteven Rostedt (VMware) } 964745cfeaaSSteven Rostedt (VMware) 96587fbb2acSSteven Rostedt (Red Hat) static int ftrace_mod_jmp(unsigned long ip, void *func) 96687fbb2acSSteven Rostedt (Red Hat) { 96787fbb2acSSteven Rostedt (Red Hat) unsigned char *new; 9685a45cfe1SSteven Rostedt 96987fbb2acSSteven Rostedt (Red Hat) new = ftrace_jmp_replace(ip, (unsigned long)func); 9705a45cfe1SSteven Rostedt 97187fbb2acSSteven Rostedt (Red Hat) return update_ftrace_func(ip, new); 9725a45cfe1SSteven Rostedt } 9735a45cfe1SSteven Rostedt 9745a45cfe1SSteven Rostedt int ftrace_enable_ftrace_graph_caller(void) 9755a45cfe1SSteven Rostedt { 9765a45cfe1SSteven Rostedt unsigned long ip = (unsigned long)(&ftrace_graph_call); 9775a45cfe1SSteven Rostedt 97887fbb2acSSteven Rostedt (Red Hat) return ftrace_mod_jmp(ip, &ftrace_graph_caller); 9795a45cfe1SSteven Rostedt } 9805a45cfe1SSteven Rostedt 9815a45cfe1SSteven Rostedt int ftrace_disable_ftrace_graph_caller(void) 9825a45cfe1SSteven Rostedt { 9835a45cfe1SSteven Rostedt unsigned long ip = (unsigned long)(&ftrace_graph_call); 9845a45cfe1SSteven Rostedt 98587fbb2acSSteven Rostedt (Red Hat) return ftrace_mod_jmp(ip, &ftrace_stub); 9865a45cfe1SSteven Rostedt } 9875a45cfe1SSteven Rostedt 988e7d3737eSFrederic Weisbecker #endif /* !CONFIG_DYNAMIC_FTRACE */ 989e7d3737eSFrederic Weisbecker 990e7d3737eSFrederic Weisbecker /* 991e7d3737eSFrederic Weisbecker * Hook the return address and push it in the stack of return addrs 992e7d3737eSFrederic Weisbecker * in current thread info. 993e7d3737eSFrederic Weisbecker */ 9946a06bdbfSSteven Rostedt (Red Hat) void prepare_ftrace_return(unsigned long self_addr, unsigned long *parent, 99571e308a2SSteven Rostedt unsigned long frame_pointer) 996e7d3737eSFrederic Weisbecker { 997e7d3737eSFrederic Weisbecker unsigned long old; 998e7d3737eSFrederic Weisbecker int faulted; 999e7d3737eSFrederic Weisbecker unsigned long return_hooker = (unsigned long) 1000e7d3737eSFrederic Weisbecker &return_to_handler; 1001e7d3737eSFrederic Weisbecker 100234a477e5SJosh Poimboeuf /* 100334a477e5SJosh Poimboeuf * When resuming from suspend-to-ram, this function can be indirectly 100434a477e5SJosh Poimboeuf * called from early CPU startup code while the CPU is in real mode, 100534a477e5SJosh Poimboeuf * which would fail miserably. Make sure the stack pointer is a 100634a477e5SJosh Poimboeuf * virtual address. 100734a477e5SJosh Poimboeuf * 100834a477e5SJosh Poimboeuf * This check isn't as accurate as virt_addr_valid(), but it should be 100934a477e5SJosh Poimboeuf * good enough for this purpose, and it's fast. 101034a477e5SJosh Poimboeuf */ 101134a477e5SJosh Poimboeuf if (unlikely((long)__builtin_frame_address(0) >= 0)) 101234a477e5SJosh Poimboeuf return; 101334a477e5SJosh Poimboeuf 101484b2bc7fSSteven Rostedt (Red Hat) if (unlikely(ftrace_graph_is_dead())) 101584b2bc7fSSteven Rostedt (Red Hat) return; 101684b2bc7fSSteven Rostedt (Red Hat) 1017380c4b14SFrederic Weisbecker if (unlikely(atomic_read(¤t->tracing_graph_pause))) 1018e7d3737eSFrederic Weisbecker return; 1019e7d3737eSFrederic Weisbecker 1020e7d3737eSFrederic Weisbecker /* 1021e7d3737eSFrederic Weisbecker * Protect against fault, even if it shouldn't 1022e7d3737eSFrederic Weisbecker * happen. This tool is too much intrusive to 1023e7d3737eSFrederic Weisbecker * ignore such a protection. 1024e7d3737eSFrederic Weisbecker */ 1025e7d3737eSFrederic Weisbecker asm volatile( 102696665788SSteven Rostedt "1: " _ASM_MOV " (%[parent]), %[old]\n" 102796665788SSteven Rostedt "2: " _ASM_MOV " %[return_hooker], (%[parent])\n" 1028e7d3737eSFrederic Weisbecker " movl $0, %[faulted]\n" 1029e3944bfaSSteven Rostedt "3:\n" 1030e7d3737eSFrederic Weisbecker 1031e7d3737eSFrederic Weisbecker ".section .fixup, \"ax\"\n" 1032e3944bfaSSteven Rostedt "4: movl $1, %[faulted]\n" 1033e3944bfaSSteven Rostedt " jmp 3b\n" 1034e7d3737eSFrederic Weisbecker ".previous\n" 1035e7d3737eSFrederic Weisbecker 1036e3944bfaSSteven Rostedt _ASM_EXTABLE(1b, 4b) 1037e3944bfaSSteven Rostedt _ASM_EXTABLE(2b, 4b) 1038e7d3737eSFrederic Weisbecker 1039aa512a27SSteven Rostedt : [old] "=&r" (old), [faulted] "=r" (faulted) 104096665788SSteven Rostedt : [parent] "r" (parent), [return_hooker] "r" (return_hooker) 1041e7d3737eSFrederic Weisbecker : "memory" 1042e7d3737eSFrederic Weisbecker ); 1043e7d3737eSFrederic Weisbecker 104414a866c5SSteven Rostedt if (unlikely(faulted)) { 104514a866c5SSteven Rostedt ftrace_graph_stop(); 104614a866c5SSteven Rostedt WARN_ON(1); 1047e7d3737eSFrederic Weisbecker return; 1048e7d3737eSFrederic Weisbecker } 1049e7d3737eSFrederic Weisbecker 105007f7175bSSteven Rostedt (VMware) if (function_graph_enter(old, self_addr, frame_pointer, parent)) 1051e7d3737eSFrederic Weisbecker *parent = old; 1052e7d3737eSFrederic Weisbecker } 1053fb52607aSFrederic Weisbecker #endif /* CONFIG_FUNCTION_GRAPH_TRACER */ 1054