linux-next/tools/testing/selftests/livepatch
Michael Vetter 62597edf63 selftests: livepatch: test livepatching a kprobed function
The test proves that a function that is being kprobed and uses a
post_handler cannot be livepatched.

Only one ftrace_ops with FTRACE_OPS_FL_IPMODIFY set may be registered
to any given function at a time.

Note that the conflicting kprobe could not be created using the
tracefs interface, see Documentation/trace/kprobetrace.rst.
This interface uses only the pre_handler(), see alloc_trace_kprobe().
But FTRACE_OPS_FL_IPMODIFY is used only when the kprobe is using a
post_handler, see arm_kprobe_ftrace().

Signed-off-by: Michael Vetter <mvetter@suse.com>
Reviewed-by: Miroslav Benes <mbenes@suse.cz>
Reviewed-by: Joe Lawrence <joe.lawrence@redhat.com>
Tested-by: Marcos Paulo de Souza <mpdesouza@suse.com>
Reviewed-by: Marcos Paulo de Souza <mpdesouza@suse.com>
Reviewed-by: Petr Mladek <pmladek@suse.com>
Tested-by: Petr Mladek <pmladek@suse.com>
Link: https://lore.kernel.org/r/20241017200132.21946-4-mvetter@suse.com
Signed-off-by: Petr Mladek <pmladek@suse.com>
2024-10-22 17:13:11 +02:00
..
test_modules selftests: livepatch: test livepatching a kprobed function 2024-10-22 17:13:11 +02:00
.gitignore selftests: livepatch: Add initial .gitignore 2024-02-27 17:03:28 -07:00
config livepatch: Move tests from lib/livepatch to selftests/livepatch 2024-01-22 10:29:47 -07:00
functions.sh selftests: livepatch: save and restore kprobe state 2024-10-22 17:13:11 +02:00
Makefile selftests: livepatch: test livepatching a kprobed function 2024-10-22 17:13:11 +02:00
README livepatch: Move tests from lib/livepatch to selftests/livepatch 2024-01-22 10:29:47 -07:00
settings selftests/livepatch: Disable the timeout 2019-10-25 19:59:12 +02:00
test_klp-call_getpid.c selftests: livepatch: Test livepatching a heavily called syscall 2024-01-22 10:29:53 -07:00
test-callbacks.sh selftests: livepatch: rename KLP_SYSFS_DIR to SYSFS_KLP_DIR 2024-10-22 17:12:46 +02:00
test-ftrace.sh selftests: livepatch: rename KLP_SYSFS_DIR to SYSFS_KLP_DIR 2024-10-22 17:12:46 +02:00
test-kprobe.sh selftests: livepatch: test livepatching a kprobed function 2024-10-22 17:13:11 +02:00
test-livepatch.sh selftests: livepatch: rename KLP_SYSFS_DIR to SYSFS_KLP_DIR 2024-10-22 17:12:46 +02:00
test-shadow-vars.sh livepatch: Move tests from lib/livepatch to selftests/livepatch 2024-01-22 10:29:47 -07:00
test-state.sh selftests: livepatch: rename KLP_SYSFS_DIR to SYSFS_KLP_DIR 2024-10-22 17:12:46 +02:00
test-syscall.sh selftests: livepatch: save and restore kprobe state 2024-10-22 17:13:11 +02:00
test-sysfs.sh selftests: livepatch: rename KLP_SYSFS_DIR to SYSFS_KLP_DIR 2024-10-22 17:12:46 +02:00

====================
Livepatch Self Tests
====================

This is a small set of sanity tests for the kernel livepatching.

The test suite loads and unloads several test kernel modules to verify
livepatch behavior.  Debug information is logged to the kernel's message
buffer and parsed for expected messages.  (Note: the tests will compare
the message buffer for only the duration of each individual test.)


Config
------

Set CONFIG_LIVEPATCH=y option and it's prerequisites.


Building the tests
------------------

To only build the tests without running them, run:

  % make -C tools/testing/selftests/livepatch

The command above will compile all test modules and test programs, making them
ready to be packaged if so desired.

Running the tests
-----------------

Test kernel modules are built before running the livepatch selftests.  The
modules are located under test_modules directory, and are built as out-of-tree
modules.  This is specially useful since the same sources can be built and
tested on systems with different kABI, ensuring they the tests are backwards
compatible.  The modules will be loaded by the test scripts using insmod.

To run the livepatch selftests, from the top of the kernel source tree:

  % make -C tools/testing/selftests TARGETS=livepatch run_tests

or

  % make kselftest TARGETS=livepatch


Adding tests
------------

See the common functions.sh file for the existing collection of utility
functions, most importantly setup_config(), start_test() and
check_result().  The latter function greps the kernel's ring buffer for
"livepatch:" and "test_klp" strings, so tests be sure to include one of
those strings for result comparison.  Other utility functions include
general module loading and livepatch loading helpers (waiting for patch
transitions, sysfs entries, etc.)