xref: /openbmc/linux/kernel/livepatch/core.c (revision 9fb29c73)
1 /*
2  * core.c - Kernel Live Patching Core
3  *
4  * Copyright (C) 2014 Seth Jennings <sjenning@redhat.com>
5  * Copyright (C) 2014 SUSE
6  *
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.
11  *
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.
16  *
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/>.
19  */
20 
21 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
22 
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>
34 #include "core.h"
35 #include "patch.h"
36 #include "transition.h"
37 
38 /*
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:
42  *
43  * - klp_ftrace_handler()
44  * - klp_update_patch_state()
45  */
46 DEFINE_MUTEX(klp_mutex);
47 
48 static LIST_HEAD(klp_patches);
49 
50 static struct kobject *klp_root_kobj;
51 
52 static bool klp_is_module(struct klp_object *obj)
53 {
54 	return obj->name;
55 }
56 
57 /* sets obj->mod if object is not vmlinux and module is found */
58 static void klp_find_object_module(struct klp_object *obj)
59 {
60 	struct module *mod;
61 
62 	if (!klp_is_module(obj))
63 		return;
64 
65 	mutex_lock(&module_mutex);
66 	/*
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.
70 	 */
71 	mod = find_module(obj->name);
72 	/*
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.
78 	 */
79 	if (mod && mod->klp_alive)
80 		obj->mod = mod;
81 
82 	mutex_unlock(&module_mutex);
83 }
84 
85 static bool klp_is_patch_registered(struct klp_patch *patch)
86 {
87 	struct klp_patch *mypatch;
88 
89 	list_for_each_entry(mypatch, &klp_patches, list)
90 		if (mypatch == patch)
91 			return true;
92 
93 	return false;
94 }
95 
96 static bool klp_initialized(void)
97 {
98 	return !!klp_root_kobj;
99 }
100 
101 struct klp_find_arg {
102 	const char *objname;
103 	const char *name;
104 	unsigned long addr;
105 	unsigned long count;
106 	unsigned long pos;
107 };
108 
109 static int klp_find_callback(void *data, const char *name,
110 			     struct module *mod, unsigned long addr)
111 {
112 	struct klp_find_arg *args = data;
113 
114 	if ((mod && !args->objname) || (!mod && args->objname))
115 		return 0;
116 
117 	if (strcmp(args->name, name))
118 		return 0;
119 
120 	if (args->objname && strcmp(args->objname, mod->name))
121 		return 0;
122 
123 	args->addr = addr;
124 	args->count++;
125 
126 	/*
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.
129 	 */
130 	if ((args->pos && (args->count == args->pos)) ||
131 	    (!args->pos && (args->count > 1)))
132 		return 1;
133 
134 	return 0;
135 }
136 
137 static int klp_find_object_symbol(const char *objname, const char *name,
138 				  unsigned long sympos, unsigned long *addr)
139 {
140 	struct klp_find_arg args = {
141 		.objname = objname,
142 		.name = name,
143 		.addr = 0,
144 		.count = 0,
145 		.pos = sympos,
146 	};
147 
148 	mutex_lock(&module_mutex);
149 	if (objname)
150 		module_kallsyms_on_each_symbol(klp_find_callback, &args);
151 	else
152 		kallsyms_on_each_symbol(klp_find_callback, &args);
153 	mutex_unlock(&module_mutex);
154 
155 	/*
156 	 * Ensure an address was found. If sympos is 0, ensure symbol is unique;
157 	 * otherwise ensure the symbol position count matches sympos.
158 	 */
159 	if (args.addr == 0)
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",
163 		       name, objname);
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");
167 	} else {
168 		*addr = args.addr;
169 		return 0;
170 	}
171 
172 	*addr = 0;
173 	return -EINVAL;
174 }
175 
176 static int klp_resolve_symbols(Elf_Shdr *relasec, struct module *pmod)
177 {
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;
182 	Elf_Rela *relas;
183 	Elf_Sym *sym;
184 	unsigned long sympos, addr;
185 
186 	/*
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.
191 	 *
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.
195 	 */
196 	BUILD_BUG_ON(MODULE_NAME_LEN < 56 || KSYM_NAME_LEN != 128);
197 
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);
205 			return -EINVAL;
206 		}
207 
208 		/* Format: .klp.sym.objname.symname,sympos */
209 		cnt = sscanf(strtab + sym->st_name,
210 			     ".klp.sym.%55[^.].%127[^,],%lu",
211 			     objname, symname, &sympos);
212 		if (cnt != 3) {
213 			pr_err("symbol %s has an incorrectly formatted name\n",
214 			       strtab + sym->st_name);
215 			return -EINVAL;
216 		}
217 
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);
222 		if (ret)
223 			return ret;
224 
225 		sym->st_value = addr;
226 	}
227 
228 	return 0;
229 }
230 
231 static int klp_write_object_relocations(struct module *pmod,
232 					struct klp_object *obj)
233 {
234 	int i, cnt, ret = 0;
235 	const char *objname, *secname;
236 	char sec_objname[MODULE_NAME_LEN];
237 	Elf_Shdr *sec;
238 
239 	if (WARN_ON(!klp_is_object_loaded(obj)))
240 		return -EINVAL;
241 
242 	objname = klp_is_module(obj) ? obj->name : "vmlinux";
243 
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))
249 			continue;
250 
251 		/*
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.
255 		 */
256 		cnt = sscanf(secname, ".klp.rela.%55[^.]", sec_objname);
257 		if (cnt != 1) {
258 			pr_err("section %s has an incorrectly formatted name\n",
259 			       secname);
260 			ret = -EINVAL;
261 			break;
262 		}
263 
264 		if (strcmp(objname, sec_objname))
265 			continue;
266 
267 		ret = klp_resolve_symbols(sec, pmod);
268 		if (ret)
269 			break;
270 
271 		ret = apply_relocate_add(pmod->klp_info->sechdrs,
272 					 pmod->core_kallsyms.strtab,
273 					 pmod->klp_info->symndx, i, pmod);
274 		if (ret)
275 			break;
276 	}
277 
278 	return ret;
279 }
280 
281 static int __klp_disable_patch(struct klp_patch *patch)
282 {
283 	struct klp_object *obj;
284 
285 	if (WARN_ON(!patch->enabled))
286 		return -EINVAL;
287 
288 	if (klp_transition_patch)
289 		return -EBUSY;
290 
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)
294 		return -EBUSY;
295 
296 	klp_init_transition(patch, KLP_UNPATCHED);
297 
298 	klp_for_each_object(patch, obj)
299 		if (obj->patched)
300 			klp_pre_unpatch_callback(obj);
301 
302 	/*
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.
308 	 */
309 	smp_wmb();
310 
311 	klp_start_transition();
312 	klp_try_complete_transition();
313 	patch->enabled = false;
314 
315 	return 0;
316 }
317 
318 /**
319  * klp_disable_patch() - disables a registered patch
320  * @patch:	The registered, enabled patch to be disabled
321  *
322  * Unregisters the patched functions from ftrace.
323  *
324  * Return: 0 on success, otherwise error
325  */
326 int klp_disable_patch(struct klp_patch *patch)
327 {
328 	int ret;
329 
330 	mutex_lock(&klp_mutex);
331 
332 	if (!klp_is_patch_registered(patch)) {
333 		ret = -EINVAL;
334 		goto err;
335 	}
336 
337 	if (!patch->enabled) {
338 		ret = -EINVAL;
339 		goto err;
340 	}
341 
342 	ret = __klp_disable_patch(patch);
343 
344 err:
345 	mutex_unlock(&klp_mutex);
346 	return ret;
347 }
348 EXPORT_SYMBOL_GPL(klp_disable_patch);
349 
350 static int __klp_enable_patch(struct klp_patch *patch)
351 {
352 	struct klp_object *obj;
353 	int ret;
354 
355 	if (klp_transition_patch)
356 		return -EBUSY;
357 
358 	if (WARN_ON(patch->enabled))
359 		return -EINVAL;
360 
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)
364 		return -EBUSY;
365 
366 	/*
367 	 * A reference is taken on the patch module to prevent it from being
368 	 * unloaded.
369 	 */
370 	if (!try_module_get(patch->mod))
371 		return -ENODEV;
372 
373 	pr_notice("enabling patch '%s'\n", patch->mod->name);
374 
375 	klp_init_transition(patch, KLP_PATCHED);
376 
377 	/*
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.
383 	 */
384 	smp_wmb();
385 
386 	klp_for_each_object(patch, obj) {
387 		if (!klp_is_object_loaded(obj))
388 			continue;
389 
390 		ret = klp_pre_patch_callback(obj);
391 		if (ret) {
392 			pr_warn("pre-patch callback failed for object '%s'\n",
393 				klp_is_module(obj) ? obj->name : "vmlinux");
394 			goto err;
395 		}
396 
397 		ret = klp_patch_object(obj);
398 		if (ret) {
399 			pr_warn("failed to patch object '%s'\n",
400 				klp_is_module(obj) ? obj->name : "vmlinux");
401 			goto err;
402 		}
403 	}
404 
405 	klp_start_transition();
406 	klp_try_complete_transition();
407 	patch->enabled = true;
408 
409 	return 0;
410 err:
411 	pr_warn("failed to enable patch '%s'\n", patch->mod->name);
412 
413 	klp_cancel_transition();
414 	return ret;
415 }
416 
417 /**
418  * klp_enable_patch() - enables a registered patch
419  * @patch:	The registered, disabled patch to be enabled
420  *
421  * Performs the needed symbol lookups and code relocations,
422  * then registers the patched functions with ftrace.
423  *
424  * Return: 0 on success, otherwise error
425  */
426 int klp_enable_patch(struct klp_patch *patch)
427 {
428 	int ret;
429 
430 	mutex_lock(&klp_mutex);
431 
432 	if (!klp_is_patch_registered(patch)) {
433 		ret = -EINVAL;
434 		goto err;
435 	}
436 
437 	ret = __klp_enable_patch(patch);
438 
439 err:
440 	mutex_unlock(&klp_mutex);
441 	return ret;
442 }
443 EXPORT_SYMBOL_GPL(klp_enable_patch);
444 
445 /*
446  * Sysfs Interface
447  *
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>
456  */
457 
458 static ssize_t enabled_store(struct kobject *kobj, struct kobj_attribute *attr,
459 			     const char *buf, size_t count)
460 {
461 	struct klp_patch *patch;
462 	int ret;
463 	bool enabled;
464 
465 	ret = kstrtobool(buf, &enabled);
466 	if (ret)
467 		return ret;
468 
469 	patch = container_of(kobj, struct klp_patch, kobj);
470 
471 	mutex_lock(&klp_mutex);
472 
473 	if (!klp_is_patch_registered(patch)) {
474 		/*
475 		 * Module with the patch could either disappear meanwhile or is
476 		 * not properly initialized yet.
477 		 */
478 		ret = -EINVAL;
479 		goto err;
480 	}
481 
482 	if (patch->enabled == enabled) {
483 		/* already in requested state */
484 		ret = -EINVAL;
485 		goto err;
486 	}
487 
488 	if (patch == klp_transition_patch) {
489 		klp_reverse_transition();
490 	} else if (enabled) {
491 		ret = __klp_enable_patch(patch);
492 		if (ret)
493 			goto err;
494 	} else {
495 		ret = __klp_disable_patch(patch);
496 		if (ret)
497 			goto err;
498 	}
499 
500 	mutex_unlock(&klp_mutex);
501 
502 	return count;
503 
504 err:
505 	mutex_unlock(&klp_mutex);
506 	return ret;
507 }
508 
509 static ssize_t enabled_show(struct kobject *kobj,
510 			    struct kobj_attribute *attr, char *buf)
511 {
512 	struct klp_patch *patch;
513 
514 	patch = container_of(kobj, struct klp_patch, kobj);
515 	return snprintf(buf, PAGE_SIZE-1, "%d\n", patch->enabled);
516 }
517 
518 static ssize_t transition_show(struct kobject *kobj,
519 			       struct kobj_attribute *attr, char *buf)
520 {
521 	struct klp_patch *patch;
522 
523 	patch = container_of(kobj, struct klp_patch, kobj);
524 	return snprintf(buf, PAGE_SIZE-1, "%d\n",
525 			patch == klp_transition_patch);
526 }
527 
528 static ssize_t signal_store(struct kobject *kobj, struct kobj_attribute *attr,
529 			    const char *buf, size_t count)
530 {
531 	struct klp_patch *patch;
532 	int ret;
533 	bool val;
534 
535 	ret = kstrtobool(buf, &val);
536 	if (ret)
537 		return ret;
538 
539 	if (!val)
540 		return count;
541 
542 	mutex_lock(&klp_mutex);
543 
544 	patch = container_of(kobj, struct klp_patch, kobj);
545 	if (patch != klp_transition_patch) {
546 		mutex_unlock(&klp_mutex);
547 		return -EINVAL;
548 	}
549 
550 	klp_send_signals();
551 
552 	mutex_unlock(&klp_mutex);
553 
554 	return count;
555 }
556 
557 static ssize_t force_store(struct kobject *kobj, struct kobj_attribute *attr,
558 			   const char *buf, size_t count)
559 {
560 	struct klp_patch *patch;
561 	int ret;
562 	bool val;
563 
564 	ret = kstrtobool(buf, &val);
565 	if (ret)
566 		return ret;
567 
568 	if (!val)
569 		return count;
570 
571 	mutex_lock(&klp_mutex);
572 
573 	patch = container_of(kobj, struct klp_patch, kobj);
574 	if (patch != klp_transition_patch) {
575 		mutex_unlock(&klp_mutex);
576 		return -EINVAL;
577 	}
578 
579 	klp_force_transition();
580 
581 	mutex_unlock(&klp_mutex);
582 
583 	return count;
584 }
585 
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,
595 	NULL
596 };
597 
598 static void klp_kobj_release_patch(struct kobject *kobj)
599 {
600 	struct klp_patch *patch;
601 
602 	patch = container_of(kobj, struct klp_patch, kobj);
603 	complete(&patch->finish);
604 }
605 
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,
610 };
611 
612 static void klp_kobj_release_object(struct kobject *kobj)
613 {
614 }
615 
616 static struct kobj_type klp_ktype_object = {
617 	.release = klp_kobj_release_object,
618 	.sysfs_ops = &kobj_sysfs_ops,
619 };
620 
621 static void klp_kobj_release_func(struct kobject *kobj)
622 {
623 }
624 
625 static struct kobj_type klp_ktype_func = {
626 	.release = klp_kobj_release_func,
627 	.sysfs_ops = &kobj_sysfs_ops,
628 };
629 
630 /*
631  * Free all functions' kobjects in the array up to some limit. When limit is
632  * NULL, all kobjects are freed.
633  */
634 static void klp_free_funcs_limited(struct klp_object *obj,
635 				   struct klp_func *limit)
636 {
637 	struct klp_func *func;
638 
639 	for (func = obj->funcs; func->old_name && func != limit; func++)
640 		kobject_put(&func->kobj);
641 }
642 
643 /* Clean up when a patched object is unloaded */
644 static void klp_free_object_loaded(struct klp_object *obj)
645 {
646 	struct klp_func *func;
647 
648 	obj->mod = NULL;
649 
650 	klp_for_each_func(obj, func)
651 		func->old_addr = 0;
652 }
653 
654 /*
655  * Free all objects' kobjects in the array up to some limit. When limit is
656  * NULL, all kobjects are freed.
657  */
658 static void klp_free_objects_limited(struct klp_patch *patch,
659 				     struct klp_object *limit)
660 {
661 	struct klp_object *obj;
662 
663 	for (obj = patch->objs; obj->funcs && obj != limit; obj++) {
664 		klp_free_funcs_limited(obj, NULL);
665 		kobject_put(&obj->kobj);
666 	}
667 }
668 
669 static void klp_free_patch(struct klp_patch *patch)
670 {
671 	klp_free_objects_limited(patch, NULL);
672 	if (!list_empty(&patch->list))
673 		list_del(&patch->list);
674 }
675 
676 static int klp_init_func(struct klp_object *obj, struct klp_func *func)
677 {
678 	if (!func->old_name || !func->new_func)
679 		return -EINVAL;
680 
681 	if (strlen(func->old_name) >= KSYM_NAME_LEN)
682 		return -EINVAL;
683 
684 	INIT_LIST_HEAD(&func->stack_node);
685 	func->patched = false;
686 	func->transition = false;
687 
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.
692 	 */
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);
696 }
697 
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)
701 {
702 }
703 
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)
707 {
708 	struct klp_func *func;
709 	int ret;
710 
711 	module_disable_ro(patch->mod);
712 	ret = klp_write_object_relocations(patch->mod, obj);
713 	if (ret) {
714 		module_enable_ro(patch->mod, true);
715 		return ret;
716 	}
717 
718 	arch_klp_init_object_loaded(patch, obj);
719 	module_enable_ro(patch->mod, true);
720 
721 	klp_for_each_func(obj, func) {
722 		ret = klp_find_object_symbol(obj->name, func->old_name,
723 					     func->old_sympos,
724 					     &func->old_addr);
725 		if (ret)
726 			return ret;
727 
728 		ret = kallsyms_lookup_size_offset(func->old_addr,
729 						  &func->old_size, NULL);
730 		if (!ret) {
731 			pr_err("kallsyms size lookup failed for '%s'\n",
732 			       func->old_name);
733 			return -ENOENT;
734 		}
735 
736 		ret = kallsyms_lookup_size_offset((unsigned long)func->new_func,
737 						  &func->new_size, NULL);
738 		if (!ret) {
739 			pr_err("kallsyms size lookup failed for '%s' replacement\n",
740 			       func->old_name);
741 			return -ENOENT;
742 		}
743 	}
744 
745 	return 0;
746 }
747 
748 static int klp_init_object(struct klp_patch *patch, struct klp_object *obj)
749 {
750 	struct klp_func *func;
751 	int ret;
752 	const char *name;
753 
754 	if (!obj->funcs)
755 		return -EINVAL;
756 
757 	if (klp_is_module(obj) && strlen(obj->name) >= MODULE_NAME_LEN)
758 		return -EINVAL;
759 
760 	obj->patched = false;
761 	obj->mod = NULL;
762 
763 	klp_find_object_module(obj);
764 
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);
768 	if (ret)
769 		return ret;
770 
771 	klp_for_each_func(obj, func) {
772 		ret = klp_init_func(obj, func);
773 		if (ret)
774 			goto free;
775 	}
776 
777 	if (klp_is_object_loaded(obj)) {
778 		ret = klp_init_object_loaded(patch, obj);
779 		if (ret)
780 			goto free;
781 	}
782 
783 	return 0;
784 
785 free:
786 	klp_free_funcs_limited(obj, func);
787 	kobject_put(&obj->kobj);
788 	return ret;
789 }
790 
791 static int klp_init_patch(struct klp_patch *patch)
792 {
793 	struct klp_object *obj;
794 	int ret;
795 
796 	if (!patch->objs)
797 		return -EINVAL;
798 
799 	mutex_lock(&klp_mutex);
800 
801 	patch->enabled = false;
802 	init_completion(&patch->finish);
803 
804 	ret = kobject_init_and_add(&patch->kobj, &klp_ktype_patch,
805 				   klp_root_kobj, "%s", patch->mod->name);
806 	if (ret) {
807 		mutex_unlock(&klp_mutex);
808 		return ret;
809 	}
810 
811 	klp_for_each_object(patch, obj) {
812 		ret = klp_init_object(patch, obj);
813 		if (ret)
814 			goto free;
815 	}
816 
817 	list_add_tail(&patch->list, &klp_patches);
818 
819 	mutex_unlock(&klp_mutex);
820 
821 	return 0;
822 
823 free:
824 	klp_free_objects_limited(patch, obj);
825 
826 	mutex_unlock(&klp_mutex);
827 
828 	kobject_put(&patch->kobj);
829 	wait_for_completion(&patch->finish);
830 
831 	return ret;
832 }
833 
834 /**
835  * klp_unregister_patch() - unregisters a patch
836  * @patch:	Disabled patch to be unregistered
837  *
838  * Frees the data structures and removes the sysfs interface.
839  *
840  * Return: 0 on success, otherwise error
841  */
842 int klp_unregister_patch(struct klp_patch *patch)
843 {
844 	int ret;
845 
846 	mutex_lock(&klp_mutex);
847 
848 	if (!klp_is_patch_registered(patch)) {
849 		ret = -EINVAL;
850 		goto err;
851 	}
852 
853 	if (patch->enabled) {
854 		ret = -EBUSY;
855 		goto err;
856 	}
857 
858 	klp_free_patch(patch);
859 
860 	mutex_unlock(&klp_mutex);
861 
862 	kobject_put(&patch->kobj);
863 	wait_for_completion(&patch->finish);
864 
865 	return 0;
866 err:
867 	mutex_unlock(&klp_mutex);
868 	return ret;
869 }
870 EXPORT_SYMBOL_GPL(klp_unregister_patch);
871 
872 /**
873  * klp_register_patch() - registers a patch
874  * @patch:	Patch to be registered
875  *
876  * Initializes the data structure associated with the patch and
877  * creates the sysfs interface.
878  *
879  * There is no need to take the reference on the patch module here. It is done
880  * later when the patch is enabled.
881  *
882  * Return: 0 on success, otherwise error
883  */
884 int klp_register_patch(struct klp_patch *patch)
885 {
886 	if (!patch || !patch->mod)
887 		return -EINVAL;
888 
889 	if (!is_livepatch_module(patch->mod)) {
890 		pr_err("module %s is not marked as a livepatch module\n",
891 		       patch->mod->name);
892 		return -EINVAL;
893 	}
894 
895 	if (!klp_initialized())
896 		return -ENODEV;
897 
898 	if (!klp_have_reliable_stack()) {
899 		pr_err("This architecture doesn't have support for the livepatch consistency model.\n");
900 		return -ENOSYS;
901 	}
902 
903 	return klp_init_patch(patch);
904 }
905 EXPORT_SYMBOL_GPL(klp_register_patch);
906 
907 /*
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
910  * will be handled.
911  */
912 static void klp_cleanup_module_patches_limited(struct module *mod,
913 					       struct klp_patch *limit)
914 {
915 	struct klp_patch *patch;
916 	struct klp_object *obj;
917 
918 	list_for_each_entry(patch, &klp_patches, list) {
919 		if (patch == limit)
920 			break;
921 
922 		klp_for_each_object(patch, obj) {
923 			if (!klp_is_module(obj) || strcmp(obj->name, mod->name))
924 				continue;
925 
926 			/*
927 			 * Only unpatch the module if the patch is enabled or
928 			 * is in transition.
929 			 */
930 			if (patch->enabled || patch == klp_transition_patch) {
931 
932 				if (patch != klp_transition_patch)
933 					klp_pre_unpatch_callback(obj);
934 
935 				pr_notice("reverting patch '%s' on unloading module '%s'\n",
936 					  patch->mod->name, obj->mod->name);
937 				klp_unpatch_object(obj);
938 
939 				klp_post_unpatch_callback(obj);
940 			}
941 
942 			klp_free_object_loaded(obj);
943 			break;
944 		}
945 	}
946 }
947 
948 int klp_module_coming(struct module *mod)
949 {
950 	int ret;
951 	struct klp_patch *patch;
952 	struct klp_object *obj;
953 
954 	if (WARN_ON(mod->state != MODULE_STATE_COMING))
955 		return -EINVAL;
956 
957 	mutex_lock(&klp_mutex);
958 	/*
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.
962 	 */
963 	mod->klp_alive = true;
964 
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))
968 				continue;
969 
970 			obj->mod = mod;
971 
972 			ret = klp_init_object_loaded(patch, obj);
973 			if (ret) {
974 				pr_warn("failed to initialize patch '%s' for module '%s' (%d)\n",
975 					patch->mod->name, obj->mod->name, ret);
976 				goto err;
977 			}
978 
979 			/*
980 			 * Only patch the module if the patch is enabled or is
981 			 * in transition.
982 			 */
983 			if (!patch->enabled && patch != klp_transition_patch)
984 				break;
985 
986 			pr_notice("applying patch '%s' to loading module '%s'\n",
987 				  patch->mod->name, obj->mod->name);
988 
989 			ret = klp_pre_patch_callback(obj);
990 			if (ret) {
991 				pr_warn("pre-patch callback failed for object '%s'\n",
992 					obj->name);
993 				goto err;
994 			}
995 
996 			ret = klp_patch_object(obj);
997 			if (ret) {
998 				pr_warn("failed to apply patch '%s' to module '%s' (%d)\n",
999 					patch->mod->name, obj->mod->name, ret);
1000 
1001 				klp_post_unpatch_callback(obj);
1002 				goto err;
1003 			}
1004 
1005 			if (patch != klp_transition_patch)
1006 				klp_post_patch_callback(obj);
1007 
1008 			break;
1009 		}
1010 	}
1011 
1012 	mutex_unlock(&klp_mutex);
1013 
1014 	return 0;
1015 
1016 err:
1017 	/*
1018 	 * If a patch is unsuccessfully applied, return
1019 	 * error to the module loader.
1020 	 */
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);
1026 
1027 	return ret;
1028 }
1029 
1030 void klp_module_going(struct module *mod)
1031 {
1032 	if (WARN_ON(mod->state != MODULE_STATE_GOING &&
1033 		    mod->state != MODULE_STATE_COMING))
1034 		return;
1035 
1036 	mutex_lock(&klp_mutex);
1037 	/*
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.
1041 	 */
1042 	mod->klp_alive = false;
1043 
1044 	klp_cleanup_module_patches_limited(mod, NULL);
1045 
1046 	mutex_unlock(&klp_mutex);
1047 }
1048 
1049 static int __init klp_init(void)
1050 {
1051 	int ret;
1052 
1053 	ret = klp_check_compiler_support();
1054 	if (ret) {
1055 		pr_info("Your compiler is too old; turning off.\n");
1056 		return -EINVAL;
1057 	}
1058 
1059 	klp_root_kobj = kobject_create_and_add("livepatch", kernel_kobj);
1060 	if (!klp_root_kobj)
1061 		return -ENOMEM;
1062 
1063 	return 0;
1064 }
1065 
1066 module_init(klp_init);
1067