2 * core.c - Kernel Live Patching Core
5 * Copyright (C) 2014 SUSE
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, see <http://www.gnu.org/licenses/>.
21 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
23 #include <linux/module.h>
24 #include <linux/kernel.h>
25 #include <linux/mutex.h>
26 #include <linux/slab.h>
27 #include <linux/list.h>
28 #include <linux/kallsyms.h>
29 #include <linux/livepatch.h>
30 #include <linux/elf.h>
31 #include <linux/moduleloader.h>
32 #include <linux/completion.h>
33 #include <asm/cacheflush.h>
36 #include "transition.h"
39 * klp_mutex is a coarse lock which serializes access to klp data. All
40 * accesses to klp-related variables and structures must have mutex protection,
41 * except within the following functions which carefully avoid the need for it:
43 * - klp_ftrace_handler()
44 * - klp_update_patch_state()
46 DEFINE_MUTEX(klp_mutex);
48 static LIST_HEAD(klp_patches);
50 static struct kobject *klp_root_kobj;
52 static bool klp_is_module(struct klp_object *obj)
57 /* sets obj->mod if object is not vmlinux and module is found */
58 static void klp_find_object_module(struct klp_object *obj)
62 if (!klp_is_module(obj))
65 mutex_lock(&module_mutex);
67 * We do not want to block removal of patched modules and therefore
68 * we do not take a reference here. The patches are removed by
69 * klp_module_going() instead.
71 mod = find_module(obj->name);
73 * Do not mess work of klp_module_coming() and klp_module_going().
74 * Note that the patch might still be needed before klp_module_going()
75 * is called. Module functions can be called even in the GOING state
76 * until mod->exit() finishes. This is especially important for
77 * patches that modify semantic of the functions.
79 if (mod && mod->klp_alive)
82 mutex_unlock(&module_mutex);
85 static bool klp_is_patch_registered(struct klp_patch *patch)
87 struct klp_patch *mypatch;
89 list_for_each_entry(mypatch, &klp_patches, list)
96 static bool klp_initialized(void)
98 return !!klp_root_kobj;
101 struct klp_find_arg {
109 static int klp_find_callback(void *data, const char *name,
110 struct module *mod, unsigned long addr)
112 struct klp_find_arg *args = data;
114 if ((mod && !args->objname) || (!mod && args->objname))
117 if (strcmp(args->name, name))
120 if (args->objname && strcmp(args->objname, mod->name))
127 * Finish the search when the symbol is found for the desired position
128 * or the position is not defined for a non-unique symbol.
130 if ((args->pos && (args->count == args->pos)) ||
131 (!args->pos && (args->count > 1)))
137 static int klp_find_object_symbol(const char *objname, const char *name,
138 unsigned long sympos, unsigned long *addr)
140 struct klp_find_arg args = {
148 mutex_lock(&module_mutex);
150 module_kallsyms_on_each_symbol(klp_find_callback, &args);
152 kallsyms_on_each_symbol(klp_find_callback, &args);
153 mutex_unlock(&module_mutex);
156 * Ensure an address was found. If sympos is 0, ensure symbol is unique;
157 * otherwise ensure the symbol position count matches sympos.
160 pr_err("symbol '%s' not found in symbol table\n", name);
161 else if (args.count > 1 && sympos == 0) {
162 pr_err("unresolvable ambiguity for symbol '%s' in object '%s'\n",
164 } else if (sympos != args.count && sympos > 0) {
165 pr_err("symbol position %lu for symbol '%s' in object '%s' not found\n",
166 sympos, name, objname ? objname : "vmlinux");
176 static int klp_resolve_symbols(Elf_Shdr *relasec, struct module *pmod)
178 int i, cnt, vmlinux, ret;
179 char objname[MODULE_NAME_LEN];
180 char symname[KSYM_NAME_LEN];
181 char *strtab = pmod->core_kallsyms.strtab;
184 unsigned long sympos, addr;
187 * Since the field widths for objname and symname in the sscanf()
188 * call are hard-coded and correspond to MODULE_NAME_LEN and
189 * KSYM_NAME_LEN respectively, we must make sure that MODULE_NAME_LEN
190 * and KSYM_NAME_LEN have the values we expect them to have.
192 * Because the value of MODULE_NAME_LEN can differ among architectures,
193 * we use the smallest/strictest upper bound possible (56, based on
194 * the current definition of MODULE_NAME_LEN) to prevent overflows.
196 BUILD_BUG_ON(MODULE_NAME_LEN < 56 || KSYM_NAME_LEN != 128);
198 relas = (Elf_Rela *) relasec->sh_addr;
199 /* For each rela in this klp relocation section */
200 for (i = 0; i < relasec->sh_size / sizeof(Elf_Rela); i++) {
201 sym = pmod->core_kallsyms.symtab + ELF_R_SYM(relas[i].r_info);
202 if (sym->st_shndx != SHN_LIVEPATCH) {
203 pr_err("symbol %s is not marked as a livepatch symbol\n",
204 strtab + sym->st_name);
208 /* Format: .klp.sym.objname.symname,sympos */
209 cnt = sscanf(strtab + sym->st_name,
210 ".klp.sym.%55[^.].%127[^,],%lu",
211 objname, symname, &sympos);
213 pr_err("symbol %s has an incorrectly formatted name\n",
214 strtab + sym->st_name);
218 /* klp_find_object_symbol() treats a NULL objname as vmlinux */
219 vmlinux = !strcmp(objname, "vmlinux");
220 ret = klp_find_object_symbol(vmlinux ? NULL : objname,
221 symname, sympos, &addr);
225 sym->st_value = addr;
231 static int klp_write_object_relocations(struct module *pmod,
232 struct klp_object *obj)
235 const char *objname, *secname;
236 char sec_objname[MODULE_NAME_LEN];
239 if (WARN_ON(!klp_is_object_loaded(obj)))
242 objname = klp_is_module(obj) ? obj->name : "vmlinux";
244 /* For each klp relocation section */
245 for (i = 1; i < pmod->klp_info->hdr.e_shnum; i++) {
246 sec = pmod->klp_info->sechdrs + i;
247 secname = pmod->klp_info->secstrings + sec->sh_name;
248 if (!(sec->sh_flags & SHF_RELA_LIVEPATCH))
252 * Format: .klp.rela.sec_objname.section_name
253 * See comment in klp_resolve_symbols() for an explanation
254 * of the selected field width value.
256 cnt = sscanf(secname, ".klp.rela.%55[^.]", sec_objname);
258 pr_err("section %s has an incorrectly formatted name\n",
264 if (strcmp(objname, sec_objname))
267 ret = klp_resolve_symbols(sec, pmod);
271 ret = apply_relocate_add(pmod->klp_info->sechdrs,
272 pmod->core_kallsyms.strtab,
273 pmod->klp_info->symndx, i, pmod);
281 static int __klp_disable_patch(struct klp_patch *patch)
283 struct klp_object *obj;
285 if (WARN_ON(!patch->enabled))
288 if (klp_transition_patch)
291 /* enforce stacking: only the last enabled patch can be disabled */
292 if (!list_is_last(&patch->list, &klp_patches) &&
293 list_next_entry(patch, list)->enabled)
296 klp_init_transition(patch, KLP_UNPATCHED);
298 klp_for_each_object(patch, obj)
300 klp_pre_unpatch_callback(obj);
303 * Enforce the order of the func->transition writes in
304 * klp_init_transition() and the TIF_PATCH_PENDING writes in
305 * klp_start_transition(). In the rare case where klp_ftrace_handler()
306 * is called shortly after klp_update_patch_state() switches the task,
307 * this ensures the handler sees that func->transition is set.
311 klp_start_transition();
312 klp_try_complete_transition();
313 patch->enabled = false;
319 * klp_disable_patch() - disables a registered patch
320 * @patch: The registered, enabled patch to be disabled
322 * Unregisters the patched functions from ftrace.
324 * Return: 0 on success, otherwise error
326 int klp_disable_patch(struct klp_patch *patch)
330 mutex_lock(&klp_mutex);
332 if (!klp_is_patch_registered(patch)) {
337 if (!patch->enabled) {
342 ret = __klp_disable_patch(patch);
345 mutex_unlock(&klp_mutex);
348 EXPORT_SYMBOL_GPL(klp_disable_patch);
350 static int __klp_enable_patch(struct klp_patch *patch)
352 struct klp_object *obj;
355 if (klp_transition_patch)
358 if (WARN_ON(patch->enabled))
361 /* enforce stacking: only the first disabled patch can be enabled */
362 if (patch->list.prev != &klp_patches &&
363 !list_prev_entry(patch, list)->enabled)
367 * A reference is taken on the patch module to prevent it from being
370 if (!try_module_get(patch->mod))
373 pr_notice("enabling patch '%s'\n", patch->mod->name);
375 klp_init_transition(patch, KLP_PATCHED);
378 * Enforce the order of the func->transition writes in
379 * klp_init_transition() and the ops->func_stack writes in
380 * klp_patch_object(), so that klp_ftrace_handler() will see the
381 * func->transition updates before the handler is registered and the
382 * new funcs become visible to the handler.
386 klp_for_each_object(patch, obj) {
387 if (!klp_is_object_loaded(obj))
390 ret = klp_pre_patch_callback(obj);
392 pr_warn("pre-patch callback failed for object '%s'\n",
393 klp_is_module(obj) ? obj->name : "vmlinux");
397 ret = klp_patch_object(obj);
399 pr_warn("failed to patch object '%s'\n",
400 klp_is_module(obj) ? obj->name : "vmlinux");
405 klp_start_transition();
406 klp_try_complete_transition();
407 patch->enabled = true;
411 pr_warn("failed to enable patch '%s'\n", patch->mod->name);
413 klp_cancel_transition();
418 * klp_enable_patch() - enables a registered patch
419 * @patch: The registered, disabled patch to be enabled
421 * Performs the needed symbol lookups and code relocations,
422 * then registers the patched functions with ftrace.
424 * Return: 0 on success, otherwise error
426 int klp_enable_patch(struct klp_patch *patch)
430 mutex_lock(&klp_mutex);
432 if (!klp_is_patch_registered(patch)) {
437 ret = __klp_enable_patch(patch);
440 mutex_unlock(&klp_mutex);
443 EXPORT_SYMBOL_GPL(klp_enable_patch);
448 * /sys/kernel/livepatch
449 * /sys/kernel/livepatch/<patch>
450 * /sys/kernel/livepatch/<patch>/enabled
451 * /sys/kernel/livepatch/<patch>/transition
452 * /sys/kernel/livepatch/<patch>/signal
453 * /sys/kernel/livepatch/<patch>/force
454 * /sys/kernel/livepatch/<patch>/<object>
455 * /sys/kernel/livepatch/<patch>/<object>/<function,sympos>
458 static ssize_t enabled_store(struct kobject *kobj, struct kobj_attribute *attr,
459 const char *buf, size_t count)
461 struct klp_patch *patch;
465 ret = kstrtobool(buf, &enabled);
469 patch = container_of(kobj, struct klp_patch, kobj);
471 mutex_lock(&klp_mutex);
473 if (!klp_is_patch_registered(patch)) {
475 * Module with the patch could either disappear meanwhile or is
476 * not properly initialized yet.
482 if (patch->enabled == enabled) {
483 /* already in requested state */
488 if (patch == klp_transition_patch) {
489 klp_reverse_transition();
490 } else if (enabled) {
491 ret = __klp_enable_patch(patch);
495 ret = __klp_disable_patch(patch);
500 mutex_unlock(&klp_mutex);
505 mutex_unlock(&klp_mutex);
509 static ssize_t enabled_show(struct kobject *kobj,
510 struct kobj_attribute *attr, char *buf)
512 struct klp_patch *patch;
514 patch = container_of(kobj, struct klp_patch, kobj);
515 return snprintf(buf, PAGE_SIZE-1, "%d\n", patch->enabled);
518 static ssize_t transition_show(struct kobject *kobj,
519 struct kobj_attribute *attr, char *buf)
521 struct klp_patch *patch;
523 patch = container_of(kobj, struct klp_patch, kobj);
524 return snprintf(buf, PAGE_SIZE-1, "%d\n",
525 patch == klp_transition_patch);
528 static ssize_t signal_store(struct kobject *kobj, struct kobj_attribute *attr,
529 const char *buf, size_t count)
531 struct klp_patch *patch;
535 ret = kstrtobool(buf, &val);
542 mutex_lock(&klp_mutex);
544 patch = container_of(kobj, struct klp_patch, kobj);
545 if (patch != klp_transition_patch) {
546 mutex_unlock(&klp_mutex);
552 mutex_unlock(&klp_mutex);
557 static ssize_t force_store(struct kobject *kobj, struct kobj_attribute *attr,
558 const char *buf, size_t count)
560 struct klp_patch *patch;
564 ret = kstrtobool(buf, &val);
571 mutex_lock(&klp_mutex);
573 patch = container_of(kobj, struct klp_patch, kobj);
574 if (patch != klp_transition_patch) {
575 mutex_unlock(&klp_mutex);
579 klp_force_transition();
581 mutex_unlock(&klp_mutex);
586 static struct kobj_attribute enabled_kobj_attr = __ATTR_RW(enabled);
587 static struct kobj_attribute transition_kobj_attr = __ATTR_RO(transition);
588 static struct kobj_attribute signal_kobj_attr = __ATTR_WO(signal);
589 static struct kobj_attribute force_kobj_attr = __ATTR_WO(force);
590 static struct attribute *klp_patch_attrs[] = {
591 &enabled_kobj_attr.attr,
592 &transition_kobj_attr.attr,
593 &signal_kobj_attr.attr,
594 &force_kobj_attr.attr,
598 static void klp_kobj_release_patch(struct kobject *kobj)
600 struct klp_patch *patch;
602 patch = container_of(kobj, struct klp_patch, kobj);
603 complete(&patch->finish);
606 static struct kobj_type klp_ktype_patch = {
607 .release = klp_kobj_release_patch,
608 .sysfs_ops = &kobj_sysfs_ops,
609 .default_attrs = klp_patch_attrs,
612 static void klp_kobj_release_object(struct kobject *kobj)
616 static struct kobj_type klp_ktype_object = {
617 .release = klp_kobj_release_object,
618 .sysfs_ops = &kobj_sysfs_ops,
621 static void klp_kobj_release_func(struct kobject *kobj)
625 static struct kobj_type klp_ktype_func = {
626 .release = klp_kobj_release_func,
627 .sysfs_ops = &kobj_sysfs_ops,
631 * Free all functions' kobjects in the array up to some limit. When limit is
632 * NULL, all kobjects are freed.
634 static void klp_free_funcs_limited(struct klp_object *obj,
635 struct klp_func *limit)
637 struct klp_func *func;
639 for (func = obj->funcs; func->old_name && func != limit; func++)
640 kobject_put(&func->kobj);
643 /* Clean up when a patched object is unloaded */
644 static void klp_free_object_loaded(struct klp_object *obj)
646 struct klp_func *func;
650 klp_for_each_func(obj, func)
655 * Free all objects' kobjects in the array up to some limit. When limit is
656 * NULL, all kobjects are freed.
658 static void klp_free_objects_limited(struct klp_patch *patch,
659 struct klp_object *limit)
661 struct klp_object *obj;
663 for (obj = patch->objs; obj->funcs && obj != limit; obj++) {
664 klp_free_funcs_limited(obj, NULL);
665 kobject_put(&obj->kobj);
669 static void klp_free_patch(struct klp_patch *patch)
671 klp_free_objects_limited(patch, NULL);
672 if (!list_empty(&patch->list))
673 list_del(&patch->list);
676 static int klp_init_func(struct klp_object *obj, struct klp_func *func)
678 if (!func->old_name || !func->new_func)
681 if (strlen(func->old_name) >= KSYM_NAME_LEN)
684 INIT_LIST_HEAD(&func->stack_node);
685 func->patched = false;
686 func->transition = false;
688 /* The format for the sysfs directory is <function,sympos> where sympos
689 * is the nth occurrence of this symbol in kallsyms for the patched
690 * object. If the user selects 0 for old_sympos, then 1 will be used
691 * since a unique symbol will be the first occurrence.
693 return kobject_init_and_add(&func->kobj, &klp_ktype_func,
694 &obj->kobj, "%s,%lu", func->old_name,
695 func->old_sympos ? func->old_sympos : 1);
698 /* Arches may override this to finish any remaining arch-specific tasks */
699 void __weak arch_klp_init_object_loaded(struct klp_patch *patch,
700 struct klp_object *obj)
704 /* parts of the initialization that is done only when the object is loaded */
705 static int klp_init_object_loaded(struct klp_patch *patch,
706 struct klp_object *obj)
708 struct klp_func *func;
711 module_disable_ro(patch->mod);
712 ret = klp_write_object_relocations(patch->mod, obj);
714 module_enable_ro(patch->mod, true);
718 arch_klp_init_object_loaded(patch, obj);
719 module_enable_ro(patch->mod, true);
721 klp_for_each_func(obj, func) {
722 ret = klp_find_object_symbol(obj->name, func->old_name,
728 ret = kallsyms_lookup_size_offset(func->old_addr,
729 &func->old_size, NULL);
731 pr_err("kallsyms size lookup failed for '%s'\n",
736 ret = kallsyms_lookup_size_offset((unsigned long)func->new_func,
737 &func->new_size, NULL);
739 pr_err("kallsyms size lookup failed for '%s' replacement\n",
748 static int klp_init_object(struct klp_patch *patch, struct klp_object *obj)
750 struct klp_func *func;
757 if (klp_is_module(obj) && strlen(obj->name) >= MODULE_NAME_LEN)
760 obj->patched = false;
763 klp_find_object_module(obj);
765 name = klp_is_module(obj) ? obj->name : "vmlinux";
766 ret = kobject_init_and_add(&obj->kobj, &klp_ktype_object,
767 &patch->kobj, "%s", name);
771 klp_for_each_func(obj, func) {
772 ret = klp_init_func(obj, func);
777 if (klp_is_object_loaded(obj)) {
778 ret = klp_init_object_loaded(patch, obj);
786 klp_free_funcs_limited(obj, func);
787 kobject_put(&obj->kobj);
791 static int klp_init_patch(struct klp_patch *patch)
793 struct klp_object *obj;
799 mutex_lock(&klp_mutex);
801 patch->enabled = false;
802 init_completion(&patch->finish);
804 ret = kobject_init_and_add(&patch->kobj, &klp_ktype_patch,
805 klp_root_kobj, "%s", patch->mod->name);
807 mutex_unlock(&klp_mutex);
811 klp_for_each_object(patch, obj) {
812 ret = klp_init_object(patch, obj);
817 list_add_tail(&patch->list, &klp_patches);
819 mutex_unlock(&klp_mutex);
824 klp_free_objects_limited(patch, obj);
826 mutex_unlock(&klp_mutex);
828 kobject_put(&patch->kobj);
829 wait_for_completion(&patch->finish);
835 * klp_unregister_patch() - unregisters a patch
836 * @patch: Disabled patch to be unregistered
838 * Frees the data structures and removes the sysfs interface.
840 * Return: 0 on success, otherwise error
842 int klp_unregister_patch(struct klp_patch *patch)
846 mutex_lock(&klp_mutex);
848 if (!klp_is_patch_registered(patch)) {
853 if (patch->enabled) {
858 klp_free_patch(patch);
860 mutex_unlock(&klp_mutex);
862 kobject_put(&patch->kobj);
863 wait_for_completion(&patch->finish);
867 mutex_unlock(&klp_mutex);
870 EXPORT_SYMBOL_GPL(klp_unregister_patch);
873 * klp_register_patch() - registers a patch
874 * @patch: Patch to be registered
876 * Initializes the data structure associated with the patch and
877 * creates the sysfs interface.
879 * There is no need to take the reference on the patch module here. It is done
880 * later when the patch is enabled.
882 * Return: 0 on success, otherwise error
884 int klp_register_patch(struct klp_patch *patch)
886 if (!patch || !patch->mod)
889 if (!is_livepatch_module(patch->mod)) {
890 pr_err("module %s is not marked as a livepatch module\n",
895 if (!klp_initialized())
898 if (!klp_have_reliable_stack()) {
899 pr_err("This architecture doesn't have support for the livepatch consistency model.\n");
903 return klp_init_patch(patch);
905 EXPORT_SYMBOL_GPL(klp_register_patch);
908 * Remove parts of patches that touch a given kernel module. The list of
909 * patches processed might be limited. When limit is NULL, all patches
912 static void klp_cleanup_module_patches_limited(struct module *mod,
913 struct klp_patch *limit)
915 struct klp_patch *patch;
916 struct klp_object *obj;
918 list_for_each_entry(patch, &klp_patches, list) {
922 klp_for_each_object(patch, obj) {
923 if (!klp_is_module(obj) || strcmp(obj->name, mod->name))
927 * Only unpatch the module if the patch is enabled or
930 if (patch->enabled || patch == klp_transition_patch) {
932 if (patch != klp_transition_patch)
933 klp_pre_unpatch_callback(obj);
935 pr_notice("reverting patch '%s' on unloading module '%s'\n",
936 patch->mod->name, obj->mod->name);
937 klp_unpatch_object(obj);
939 klp_post_unpatch_callback(obj);
942 klp_free_object_loaded(obj);
948 int klp_module_coming(struct module *mod)
951 struct klp_patch *patch;
952 struct klp_object *obj;
954 if (WARN_ON(mod->state != MODULE_STATE_COMING))
957 mutex_lock(&klp_mutex);
959 * Each module has to know that klp_module_coming()
960 * has been called. We never know what module will
961 * get patched by a new patch.
963 mod->klp_alive = true;
965 list_for_each_entry(patch, &klp_patches, list) {
966 klp_for_each_object(patch, obj) {
967 if (!klp_is_module(obj) || strcmp(obj->name, mod->name))
972 ret = klp_init_object_loaded(patch, obj);
974 pr_warn("failed to initialize patch '%s' for module '%s' (%d)\n",
975 patch->mod->name, obj->mod->name, ret);
980 * Only patch the module if the patch is enabled or is
983 if (!patch->enabled && patch != klp_transition_patch)
986 pr_notice("applying patch '%s' to loading module '%s'\n",
987 patch->mod->name, obj->mod->name);
989 ret = klp_pre_patch_callback(obj);
991 pr_warn("pre-patch callback failed for object '%s'\n",
996 ret = klp_patch_object(obj);
998 pr_warn("failed to apply patch '%s' to module '%s' (%d)\n",
999 patch->mod->name, obj->mod->name, ret);
1001 klp_post_unpatch_callback(obj);
1005 if (patch != klp_transition_patch)
1006 klp_post_patch_callback(obj);
1012 mutex_unlock(&klp_mutex);
1018 * If a patch is unsuccessfully applied, return
1019 * error to the module loader.
1021 pr_warn("patch '%s' failed for module '%s', refusing to load module '%s'\n",
1022 patch->mod->name, obj->mod->name, obj->mod->name);
1023 mod->klp_alive = false;
1024 klp_cleanup_module_patches_limited(mod, patch);
1025 mutex_unlock(&klp_mutex);
1030 void klp_module_going(struct module *mod)
1032 if (WARN_ON(mod->state != MODULE_STATE_GOING &&
1033 mod->state != MODULE_STATE_COMING))
1036 mutex_lock(&klp_mutex);
1038 * Each module has to know that klp_module_going()
1039 * has been called. We never know what module will
1040 * get patched by a new patch.
1042 mod->klp_alive = false;
1044 klp_cleanup_module_patches_limited(mod, NULL);
1046 mutex_unlock(&klp_mutex);
1049 static int __init klp_init(void)
1053 ret = klp_check_compiler_support();
1055 pr_info("Your compiler is too old; turning off.\n");
1059 klp_root_kobj = kobject_create_and_add("livepatch", kernel_kobj);
1066 module_init(klp_init);