xref: /linux/Documentation/ABI/testing/sysfs-kernel-livepatch (revision f49040c7aaa5532a1f94355ef5073c49e6b32349)
1b700e7f0SSeth JenningsWhat:		/sys/kernel/livepatch
2b700e7f0SSeth JenningsDate:		Nov 2014
3b700e7f0SSeth JenningsKernelVersion:	3.19.0
4b700e7f0SSeth JenningsContact:	live-patching@vger.kernel.org
5b700e7f0SSeth JenningsDescription:
6b700e7f0SSeth Jennings		Interface for kernel live patching
7b700e7f0SSeth Jennings
8b700e7f0SSeth Jennings		The /sys/kernel/livepatch directory contains subdirectories for
9b700e7f0SSeth Jennings		each loaded live patch module.
10b700e7f0SSeth Jennings
11b700e7f0SSeth JenningsWhat:		/sys/kernel/livepatch/<patch>
12b700e7f0SSeth JenningsDate:		Nov 2014
13b700e7f0SSeth JenningsKernelVersion:	3.19.0
14b700e7f0SSeth JenningsContact:	live-patching@vger.kernel.org
15b700e7f0SSeth JenningsDescription:
16b700e7f0SSeth Jennings		The patch directory contains subdirectories for each kernel
17b700e7f0SSeth Jennings		object (vmlinux or a module) in which it patched functions.
18b700e7f0SSeth Jennings
19b700e7f0SSeth JenningsWhat:		/sys/kernel/livepatch/<patch>/enabled
20b700e7f0SSeth JenningsDate:		Nov 2014
21b700e7f0SSeth JenningsKernelVersion:	3.19.0
22b700e7f0SSeth JenningsContact:	live-patching@vger.kernel.org
23b700e7f0SSeth JenningsDescription:
24b700e7f0SSeth Jennings		A writable attribute that indicates whether the patched
25b700e7f0SSeth Jennings		code is currently applied.  Writing 0 will disable the patch
26b700e7f0SSeth Jennings		while writing 1 will re-enable the patch.
27b700e7f0SSeth Jennings
28d83a7cb3SJosh PoimboeufWhat:		/sys/kernel/livepatch/<patch>/transition
29d83a7cb3SJosh PoimboeufDate:		Feb 2017
30d83a7cb3SJosh PoimboeufKernelVersion:	4.12.0
31d83a7cb3SJosh PoimboeufContact:	live-patching@vger.kernel.org
32d83a7cb3SJosh PoimboeufDescription:
33d83a7cb3SJosh Poimboeuf		An attribute which indicates whether the patch is currently in
34d83a7cb3SJosh Poimboeuf		transition.
35d83a7cb3SJosh Poimboeuf
36c99a2be7SMiroslav BenesWhat:		/sys/kernel/livepatch/<patch>/force
37c99a2be7SMiroslav BenesDate:		Nov 2017
38c99a2be7SMiroslav BenesKernelVersion:	4.15.0
39c99a2be7SMiroslav BenesContact:	live-patching@vger.kernel.org
40c99a2be7SMiroslav BenesDescription:
41c99a2be7SMiroslav Benes		A writable attribute that allows administrator to affect the
42c99a2be7SMiroslav Benes		course of an existing transition. Writing 1 clears
43c99a2be7SMiroslav Benes		TIF_PATCH_PENDING flag of all tasks and thus forces the tasks to
44c99a2be7SMiroslav Benes		the patched or unpatched state. Administrator should not
45c99a2be7SMiroslav Benes		use this feature without a clearance from a patch
46c99a2be7SMiroslav Benes		distributor. Removal (rmmod) of patch modules is permanently
47c99a2be7SMiroslav Benes		disabled when the feature is used. See
4889e33ea7SMauro Carvalho Chehab		Documentation/livepatch/livepatch.rst for more information.
49c99a2be7SMiroslav Benes
50adb68ed2SYafang ShaoWhat:		/sys/kernel/livepatch/<patch>/replace
51adb68ed2SYafang ShaoDate:		Jun 2024
52adb68ed2SYafang ShaoKernelVersion:	6.11.0
53adb68ed2SYafang ShaoContact:	live-patching@vger.kernel.org
54adb68ed2SYafang ShaoDescription:
55adb68ed2SYafang Shao		An attribute which indicates whether the patch supports
56adb68ed2SYafang Shao		atomic-replace.
57adb68ed2SYafang Shao
58*3dae09deSWardenjohnWhat:		/sys/kernel/livepatch/<patch>/stack_order
59*3dae09deSWardenjohnDate:		Jan 2025
60*3dae09deSWardenjohnKernelVersion:	6.14.0
61*3dae09deSWardenjohnDescription:
62*3dae09deSWardenjohn		This attribute specifies the sequence in which live patch modules
63*3dae09deSWardenjohn		are applied to the system. If multiple live patches modify the same
64*3dae09deSWardenjohn		function, the implementation with the biggest 'stack_order' number
65*3dae09deSWardenjohn		is used, unless a transition is currently in progress.
66*3dae09deSWardenjohn
67b700e7f0SSeth JenningsWhat:		/sys/kernel/livepatch/<patch>/<object>
68b700e7f0SSeth JenningsDate:		Nov 2014
69b700e7f0SSeth JenningsKernelVersion:	3.19.0
70b700e7f0SSeth JenningsContact:	live-patching@vger.kernel.org
71b700e7f0SSeth JenningsDescription:
72b700e7f0SSeth Jennings		The object directory contains subdirectories for each function
73b700e7f0SSeth Jennings		that is patched within the object.
74b700e7f0SSeth Jennings
75bb26cfd9SSong LiuWhat:		/sys/kernel/livepatch/<patch>/<object>/patched
76bb26cfd9SSong LiuDate:		August 2022
77bb26cfd9SSong LiuKernelVersion:	6.1.0
78bb26cfd9SSong LiuContact:	live-patching@vger.kernel.org
79bb26cfd9SSong LiuDescription:
80bb26cfd9SSong Liu		An attribute which indicates whether the object is currently
81bb26cfd9SSong Liu		patched.
82bb26cfd9SSong Liu
83444f9e99SChris J ArgesWhat:		/sys/kernel/livepatch/<patch>/<object>/<function,sympos>
84b700e7f0SSeth JenningsDate:		Nov 2014
85b700e7f0SSeth JenningsKernelVersion:	3.19.0
86b700e7f0SSeth JenningsContact:	live-patching@vger.kernel.org
87b700e7f0SSeth JenningsDescription:
88b700e7f0SSeth Jennings		The function directory contains attributes regarding the
89b700e7f0SSeth Jennings		properties and state of the patched function.
90b700e7f0SSeth Jennings
91444f9e99SChris J Arges		The directory name contains the patched function name and a
92444f9e99SChris J Arges		sympos number corresponding to the nth occurrence of the symbol
93444f9e99SChris J Arges		name in kallsyms for the patched object.
94444f9e99SChris J Arges
95b700e7f0SSeth Jennings		There are currently no such attributes.
96