Documentation/dev-tools/kselftest.rst

5 The kernel contains a set of "self tests" under the tools/testing/selftests/
26 Running the selftests (hotplug tests are run in limited mode)
31   $ make -C tools/testing/selftests
35   $ make -C tools/testing/selftests run_tests
46 kernel src. This is applicable to "Running a subset of selftests" section
64 to "Running a subset of selftests" section below.
70 Running a subset of selftests
78   $ make -C tools/testing/selftests TARGETS=ptrace run_tests
97   $ make -C tools/testing/selftests SKIP_TARGETS=ptrace run_tests
108 See the top-level tools/testing/selftests/Makefile for the list of all
111 Running the full range hotplug selftests
116   $ make -C tools/testing/selftests hotplug
120   $ make -C tools/testing/selftests run_hotplug
125 Install selftests
129 tool) to install selftests in the default location (`tools/testing/selftests/kselftest_install`),
132 To install selftests in default location::
134    $ make -C tools/testing/selftests install
136 To install selftests in a user specified location::
138    $ make -C tools/testing/selftests install INSTALL_PATH=/some/other/path
140 Running installed selftests
163 Packaging selftests
167 different system. To package selftests, run::
169    $ make -C tools/testing/selftests gen_tar
176     $ make -C tools/testing/selftests gen_tar FORMAT=.xz
179 tests by using variables specified in `Running a subset of selftests`_
182     $ make -C tools/testing/selftests gen_tar TARGETS="bpf" FORMAT=.xz
189 In general, the rules for selftests are
230    e.g: tools/testing/selftests/android/config
254    e.g. ``tools/testing/selftests/lib/printf.sh``
256 3. Add line to config file e.g. ``tools/testing/selftests/lib/config``
258 4. Add test script to makefile  e.g. ``tools/testing/selftests/lib/Makefile``
282    #include "../tools/testing/selftests/kselftest/module.h"
321 The tests from tools/testing/selftests/seccomp/seccomp_bpf.c can be used as
327 .. kernel-doc:: tools/testing/selftests/kselftest_harness.h
334 .. kernel-doc:: tools/testing/selftests/kselftest_harness.h
342 .. kernel-doc:: tools/testing/selftests/kselftest_harness.h
345 .. kernel-doc:: tools/testing/selftests/kselftest_harness.h