xref: /linux/Documentation/ABI/testing/sysfs-kernel-livepatch (revision 43347d56c8d9dd732cee2f8efd384ad21dd1f6c4)
1What:		/sys/kernel/livepatch
2Date:		Nov 2014
3KernelVersion:	3.19.0
4Contact:	live-patching@vger.kernel.org
5Description:
6		Interface for kernel live patching
7
8		The /sys/kernel/livepatch directory contains subdirectories for
9		each loaded live patch module.
10
11What:		/sys/kernel/livepatch/<patch>
12Date:		Nov 2014
13KernelVersion:	3.19.0
14Contact:	live-patching@vger.kernel.org
15Description:
16		The patch directory contains subdirectories for each kernel
17		object (vmlinux or a module) in which it patched functions.
18
19What:		/sys/kernel/livepatch/<patch>/enabled
20Date:		Nov 2014
21KernelVersion:	3.19.0
22Contact:	live-patching@vger.kernel.org
23Description:
24		A writable attribute that indicates whether the patched
25		code is currently applied.  Writing 0 will disable the patch
26		while writing 1 will re-enable the patch.
27
28What:		/sys/kernel/livepatch/<patch>/transition
29Date:		Feb 2017
30KernelVersion:	4.12.0
31Contact:	live-patching@vger.kernel.org
32Description:
33		An attribute which indicates whether the patch is currently in
34		transition.
35
36What:		/sys/kernel/livepatch/<patch>/signal
37Date:		Nov 2017
38KernelVersion:	4.15.0
39Contact:	live-patching@vger.kernel.org
40Description:
41		A writable attribute that allows administrator to affect the
42		course of an existing transition. Writing 1 sends a fake
43		signal to all remaining blocking tasks. The fake signal
44		means that no proper signal is delivered (there is no data in
45		signal pending structures). Tasks are interrupted or woken up,
46		and forced to change their patched state.
47
48What:		/sys/kernel/livepatch/<patch>/<object>
49Date:		Nov 2014
50KernelVersion:	3.19.0
51Contact:	live-patching@vger.kernel.org
52Description:
53		The object directory contains subdirectories for each function
54		that is patched within the object.
55
56What:		/sys/kernel/livepatch/<patch>/<object>/<function,sympos>
57Date:		Nov 2014
58KernelVersion:	3.19.0
59Contact:	live-patching@vger.kernel.org
60Description:
61		The function directory contains attributes regarding the
62		properties and state of the patched function.
63
64		The directory name contains the patched function name and a
65		sympos number corresponding to the nth occurrence of the symbol
66		name in kallsyms for the patched object.
67
68		There are currently no such attributes.
69