diff options
Diffstat (limited to 'include/linux/livepatch.h')
-rw-r--r-- | include/linux/livepatch.h | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/include/linux/livepatch.h b/include/linux/livepatch.h new file mode 100644 index 000000000000..95023fd8b00d --- /dev/null +++ b/include/linux/livepatch.h | |||
@@ -0,0 +1,133 @@ | |||
1 | /* | ||
2 | * livepatch.h - 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 | #ifndef _LINUX_LIVEPATCH_H_ | ||
22 | #define _LINUX_LIVEPATCH_H_ | ||
23 | |||
24 | #include <linux/module.h> | ||
25 | #include <linux/ftrace.h> | ||
26 | |||
27 | #if IS_ENABLED(CONFIG_LIVEPATCH) | ||
28 | |||
29 | #include <asm/livepatch.h> | ||
30 | |||
31 | enum klp_state { | ||
32 | KLP_DISABLED, | ||
33 | KLP_ENABLED | ||
34 | }; | ||
35 | |||
36 | /** | ||
37 | * struct klp_func - function structure for live patching | ||
38 | * @old_name: name of the function to be patched | ||
39 | * @new_func: pointer to the patched function code | ||
40 | * @old_addr: a hint conveying at what address the old function | ||
41 | * can be found (optional, vmlinux patches only) | ||
42 | * @kobj: kobject for sysfs resources | ||
43 | * @state: tracks function-level patch application state | ||
44 | * @stack_node: list node for klp_ops func_stack list | ||
45 | */ | ||
46 | struct klp_func { | ||
47 | /* external */ | ||
48 | const char *old_name; | ||
49 | void *new_func; | ||
50 | /* | ||
51 | * The old_addr field is optional and can be used to resolve | ||
52 | * duplicate symbol names in the vmlinux object. If this | ||
53 | * information is not present, the symbol is located by name | ||
54 | * with kallsyms. If the name is not unique and old_addr is | ||
55 | * not provided, the patch application fails as there is no | ||
56 | * way to resolve the ambiguity. | ||
57 | */ | ||
58 | unsigned long old_addr; | ||
59 | |||
60 | /* internal */ | ||
61 | struct kobject kobj; | ||
62 | enum klp_state state; | ||
63 | struct list_head stack_node; | ||
64 | }; | ||
65 | |||
66 | /** | ||
67 | * struct klp_reloc - relocation structure for live patching | ||
68 | * @loc: address where the relocation will be written | ||
69 | * @val: address of the referenced symbol (optional, | ||
70 | * vmlinux patches only) | ||
71 | * @type: ELF relocation type | ||
72 | * @name: name of the referenced symbol (for lookup/verification) | ||
73 | * @addend: offset from the referenced symbol | ||
74 | * @external: symbol is either exported or within the live patch module itself | ||
75 | */ | ||
76 | struct klp_reloc { | ||
77 | unsigned long loc; | ||
78 | unsigned long val; | ||
79 | unsigned long type; | ||
80 | const char *name; | ||
81 | int addend; | ||
82 | int external; | ||
83 | }; | ||
84 | |||
85 | /** | ||
86 | * struct klp_object - kernel object structure for live patching | ||
87 | * @name: module name (or NULL for vmlinux) | ||
88 | * @relocs: relocation entries to be applied at load time | ||
89 | * @funcs: function entries for functions to be patched in the object | ||
90 | * @kobj: kobject for sysfs resources | ||
91 | * @mod: kernel module associated with the patched object | ||
92 | * (NULL for vmlinux) | ||
93 | * @state: tracks object-level patch application state | ||
94 | */ | ||
95 | struct klp_object { | ||
96 | /* external */ | ||
97 | const char *name; | ||
98 | struct klp_reloc *relocs; | ||
99 | struct klp_func *funcs; | ||
100 | |||
101 | /* internal */ | ||
102 | struct kobject *kobj; | ||
103 | struct module *mod; | ||
104 | enum klp_state state; | ||
105 | }; | ||
106 | |||
107 | /** | ||
108 | * struct klp_patch - patch structure for live patching | ||
109 | * @mod: reference to the live patch module | ||
110 | * @objs: object entries for kernel objects to be patched | ||
111 | * @list: list node for global list of registered patches | ||
112 | * @kobj: kobject for sysfs resources | ||
113 | * @state: tracks patch-level application state | ||
114 | */ | ||
115 | struct klp_patch { | ||
116 | /* external */ | ||
117 | struct module *mod; | ||
118 | struct klp_object *objs; | ||
119 | |||
120 | /* internal */ | ||
121 | struct list_head list; | ||
122 | struct kobject kobj; | ||
123 | enum klp_state state; | ||
124 | }; | ||
125 | |||
126 | extern int klp_register_patch(struct klp_patch *); | ||
127 | extern int klp_unregister_patch(struct klp_patch *); | ||
128 | extern int klp_enable_patch(struct klp_patch *); | ||
129 | extern int klp_disable_patch(struct klp_patch *); | ||
130 | |||
131 | #endif /* CONFIG_LIVEPATCH */ | ||
132 | |||
133 | #endif /* _LINUX_LIVEPATCH_H_ */ | ||