AuxXxilium/linux_dsm_epyc7002
1
0
Fork 0
mirror of https://github.com/AuxXxilium/linux_dsm_epyc7002.git synced 2024-12-12 05:06:39 +07:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: dev-tools: kselftest.rst: Update examples and paths

Browse Source 
Update the installation commands and path details, detail the new
options available in the run_kselftests.sh script.

Signed-off-by: Kees Cook <keescook@chromium.org>
Reviewed-by: Naresh Kamboju <naresh.kamboju@linaro.org>
Signed-off-by: Shuah Khan <skhan@linuxfoundation.org>
This commit is contained in:
Kees Cook 2020-09-28 13:26:50 -07:00 committed by Shuah Khan
parent 5da1918446
commit 4c8511317b
1 changed files with 22 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
Documentation/dev-tools/kselftest.rst
View File

@ -125,32 +125,41 @@ Note that some tests will require root privileges.
Install selftests Install selftests
================= =================
You can use the kselftest_install.sh tool to install selftests in the You can use the "install" target of "make" (which calls the `kselftest_install.sh`
default location, which is tools/testing/selftests/kselftest, or in a tool) to install selftests in the default location (`tools/testing/selftests/kselftest_install`),
user specified location. or in a user specified location via the `INSTALL_PATH` "make" variable.
To install selftests in default location:: To install selftests in default location::
$ cd tools/testing/selftests $ make -C tools/testing/selftests install
$ ./kselftest_install.sh
To install selftests in a user specified location:: To install selftests in a user specified location::
$ cd tools/testing/selftests $ make -C tools/testing/selftests install INSTALL_PATH=/some/other/path
$ ./kselftest_install.sh install_dir
Running installed selftests Running installed selftests
=========================== ===========================
Kselftest install as well as the Kselftest tarball provide a script Found in the install directory, as well as in the Kselftest tarball,
named "run_kselftest.sh" to run the tests. is a script named `run_kselftest.sh` to run the tests.
You can simply do the following to run the installed Kselftests. Please You can simply do the following to run the installed Kselftests. Please
note some tests will require root privileges:: note some tests will require root privileges::
$ cd kselftest $ cd kselftest_install
$ ./run_kselftest.sh $ ./run_kselftest.sh
To see the list of available tests, the `-l` option can be used::
$ ./run_kselftest.sh -l
The `-c` option can be used to run all the tests from a test collection, or
the `-t` option for specific single tests. Either can be used multiple times::
$ ./run_kselftest.sh -c bpf -c seccomp -t timers:posix_timers -t timer:nanosleep
For other features see the script usage output, seen with the `-h` option.
Packaging selftests Packaging selftests
=================== ===================
@ -160,9 +169,9 @@ different system. To package selftests, run::
$ make -C tools/testing/selftests gen_tar $ make -C tools/testing/selftests gen_tar
This generates a tarball in the `INSTALL_PATH/kselftest-packages` directory. By This generates a tarball in the `INSTALL_PATH/kselftest-packages` directory. By
default, `.gz` format is used. The tar format can be overridden by specifying default, `.gz` format is used. The tar compression format can be overridden by
a `FORMAT` make variable. Any value recognized by `tar's auto-compress`_ option specifying a `FORMAT` make variable. Any value recognized by `tar's auto-compress`_
is supported, such as:: option is supported, such as::
$ make -C tools/testing/selftests gen_tar FORMAT=.xz $ make -C tools/testing/selftests gen_tar FORMAT=.xz