update Readme
This commit is contained in:
33
README.md
33
README.md
@@ -1,16 +1,17 @@
|
||||
|
||||
# Kunity test runner module
|
||||
|
||||
Is a runner module for runnig kunity test cases (see xxx). The module search for test function in the symbol table and made the them executionable byy uspase (via proc file)
|
||||
|
||||
The Kunity test runner runs any kunity tests (see [KUnity-Core](https://github.com/stubbfel/KUnity-Core)) by a kernel module.
|
||||
This module search for test function in the symbol table of the kernel space (https://www.linux.com/learn/kernel-newbie-corner-kernel-symbols-whats-available-your-module-what-isnt) and made them runable for the userspace (by proc files).
|
||||
|
||||
## proc file struce
|
||||
|
||||
* /proc/kunity_test
|
||||
* <modulename>-folder
|
||||
* <modulename>-file -> read of this file, will be run all test case of this module
|
||||
* single_tests
|
||||
* test_name-file -> read of this file, will be run the specific test case
|
||||
```plain
|
||||
+ /proc/kunity_test
|
||||
+ <modulename>
|
||||
- <modulename> -> read of this file, will be run all test case of this module
|
||||
+ single_tests
|
||||
- <test_name> -> read of this file, will be run the specific test case
|
||||
```
|
||||
|
||||
## building module
|
||||
|
||||
@@ -20,27 +21,25 @@ Is a runner module for runnig kunity test cases (see xxx). The module search for
|
||||
mkdir build
|
||||
cd build
|
||||
cmake ../
|
||||
# cmake -DKERNEL_DIR=<path/to/kernel/module/build/#!/usr/bin/env ../
|
||||
# cmake -DKERNEL_DIR=<path/to/kernel/module/build> ../
|
||||
make
|
||||
|
||||
#load module by "insmod kunity_test_runner_module/kunity_test_runner_module.ko"
|
||||
```
|
||||
By default "the /lib/modules/${CMAKE_SYSTEM_VERSION}/build" path is use for the kernel build path. This path can be change by using the KERNEL_DIR option
|
||||
By default the `/lib/modules/${CMAKE_SYSTEM_VERSION}/build` path is use for the kernel build path. This path can be change by using the `KERNEL_DIR` option.
|
||||
|
||||
### KBuild
|
||||
|
||||
```bash
|
||||
make -C /lib/modules/<KVerision>/build M=${PWD} modules KBUILD_EXTRA_SYMBOLS=${PWD}/Module.symvers
|
||||
make -C /lib/modules/<KernelVersion>/build M=${PWD} modules KBUILD_EXTRA_SYMBOLS=${PWD}/Module.symvers
|
||||
#load module by "insmod kunity_test_runner_module.ko"
|
||||
```
|
||||
|
||||
## execution
|
||||
|
||||
simple use cat on the proc file :)
|
||||
|
||||
simple use `cat` on the proc file :) like : `cat /proc/kunity_test/my_module/single_tests/my_first_module_test`
|
||||
|
||||
## module parameter
|
||||
|
||||
* proc_test_root_folder_name = The name of the proc folder, which will contains the test proc files. (Default is "kunity_test")
|
||||
* test_function_filter =a filter option for test function names, which the runner is looking for. (Default is "kunity_test_*")
|
||||
* module_filter = a filter option for modules, which the runner is looking for test functions. (Default is * -> search in all modules)
|
||||
* proc_test_root_folder_name - The name of the proc folder, which will contains the test proc files. (Default is "kunity_test")
|
||||
* test_function_filter - a filter option for test function names, which the runner is looking for. (Default is "kunity_test_*")
|
||||
* module_filter - a filter option for modules, which the runner is looking for test functions. (Default is * -> search in all modules)
|
||||
|
||||
Submodule dev-utility/CMake-Module/BuildKernelModule updated: d30bc0c012...70e9c0eb3b
Submodule lib/KUnity updated: 82048f400e...45ba80e18a
Reference in New Issue
Block a user