| ==================== |
| 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 clear |
| the message buffer between individual tests.) |
| |
| |
| Config |
| ------ |
| |
| Set these config options and their prerequisites: |
| |
| CONFIG_LIVEPATCH=y |
| CONFIG_TEST_LIVEPATCH=m |
| |
| |
| Running the tests |
| ----------------- |
| |
| Test kernel modules are built as part of lib/ (make modules) and need to |
| be installed (make modules_install) as the test scripts will modprobe |
| them. |
| |
| To run the livepatch selftests, from the top of the kernel source tree: |
| |
| % make -C tools/testing/selftests TARGETS=livepatch run_tests |
| |
| |
| Adding tests |
| ------------ |
| |
| See the common functions.sh file for the existing collection of utility |
| functions, most importantly set_dynamic_debug() 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.) |
