mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-08-05 16:54:27 +00:00

Add "stack_order" sysfs attribute which holds the order in which a live patch module was loaded into the system. A user can then determine an active live patched version of a function. cat /sys/kernel/livepatch/livepatch_1/stack_order -> 1 means that livepatch_1 is the first live patch applied cat /sys/kernel/livepatch/livepatch_module/stack_order -> N means that livepatch_module is the Nth live patch applied Suggested-by: Petr Mladek <pmladek@suse.com> Suggested-by: Miroslav Benes <mbenes@suse.cz> Suggested-by: Josh Poimboeuf <jpoimboe@kernel.org> Signed-off-by: Wardenjohn <zhangwarden@gmail.com> Acked-by: Josh Poimboeuf <jpoimboe@kernel.org> Reviewed-by: Petr Mladek <pmladek@suse.com> Tested-by: Petr Mladek <pmladek@suse.com> Reviewed-by: Miroslav Benes <mbenes@suse.cz> Link: https://lore.kernel.org/r/20241008014856.3729-2-zhangwarden@gmail.com [pmladek@suse.com: Updated kernel version and date in the ABI documentation.] Signed-off-by: Petr Mladek <pmladek@suse.com>
95 lines
3.1 KiB
Text
95 lines
3.1 KiB
Text
What: /sys/kernel/livepatch
|
|
Date: Nov 2014
|
|
KernelVersion: 3.19.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
Interface for kernel live patching
|
|
|
|
The /sys/kernel/livepatch directory contains subdirectories for
|
|
each loaded live patch module.
|
|
|
|
What: /sys/kernel/livepatch/<patch>
|
|
Date: Nov 2014
|
|
KernelVersion: 3.19.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
The patch directory contains subdirectories for each kernel
|
|
object (vmlinux or a module) in which it patched functions.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/enabled
|
|
Date: Nov 2014
|
|
KernelVersion: 3.19.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
A writable attribute that indicates whether the patched
|
|
code is currently applied. Writing 0 will disable the patch
|
|
while writing 1 will re-enable the patch.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/transition
|
|
Date: Feb 2017
|
|
KernelVersion: 4.12.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
An attribute which indicates whether the patch is currently in
|
|
transition.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/force
|
|
Date: Nov 2017
|
|
KernelVersion: 4.15.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
A writable attribute that allows administrator to affect the
|
|
course of an existing transition. Writing 1 clears
|
|
TIF_PATCH_PENDING flag of all tasks and thus forces the tasks to
|
|
the patched or unpatched state. Administrator should not
|
|
use this feature without a clearance from a patch
|
|
distributor. Removal (rmmod) of patch modules is permanently
|
|
disabled when the feature is used. See
|
|
Documentation/livepatch/livepatch.rst for more information.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/replace
|
|
Date: Jun 2024
|
|
KernelVersion: 6.11.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
An attribute which indicates whether the patch supports
|
|
atomic-replace.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/stack_order
|
|
Date: Jan 2025
|
|
KernelVersion: 6.14.0
|
|
Description:
|
|
This attribute specifies the sequence in which live patch modules
|
|
are applied to the system. If multiple live patches modify the same
|
|
function, the implementation with the biggest 'stack_order' number
|
|
is used, unless a transition is currently in progress.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/<object>
|
|
Date: Nov 2014
|
|
KernelVersion: 3.19.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
The object directory contains subdirectories for each function
|
|
that is patched within the object.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/<object>/patched
|
|
Date: August 2022
|
|
KernelVersion: 6.1.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
An attribute which indicates whether the object is currently
|
|
patched.
|
|
|
|
What: /sys/kernel/livepatch/<patch>/<object>/<function,sympos>
|
|
Date: Nov 2014
|
|
KernelVersion: 3.19.0
|
|
Contact: live-patching@vger.kernel.org
|
|
Description:
|
|
The function directory contains attributes regarding the
|
|
properties and state of the patched function.
|
|
|
|
The directory name contains the patched function name and a
|
|
sympos number corresponding to the nth occurrence of the symbol
|
|
name in kallsyms for the patched object.
|
|
|
|
There are currently no such attributes.
|