xref: /linux/Documentation/ABI/testing/sysfs-kernel-livepatch (revision a4eb44a6435d6d8f9e642407a4a06f65eb90ca04)
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>/force
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 clears
43		TIF_PATCH_PENDING flag of all tasks and thus forces the tasks to
44		the patched or unpatched state. Administrator should not
45		use this feature without a clearance from a patch
46		distributor. Removal (rmmod) of patch modules is permanently
47		disabled when the feature is used. See
48		Documentation/livepatch/livepatch.rst for more information.
49
50What:		/sys/kernel/livepatch/<patch>/<object>
51Date:		Nov 2014
52KernelVersion:	3.19.0
53Contact:	live-patching@vger.kernel.org
54Description:
55		The object directory contains subdirectories for each function
56		that is patched within the object.
57
58What:		/sys/kernel/livepatch/<patch>/<object>/<function,sympos>
59Date:		Nov 2014
60KernelVersion:	3.19.0
61Contact:	live-patching@vger.kernel.org
62Description:
63		The function directory contains attributes regarding the
64		properties and state of the patched function.
65
66		The directory name contains the patched function name and a
67		sympos number corresponding to the nth occurrence of the symbol
68		name in kallsyms for the patched object.
69
70		There are currently no such attributes.
71