Source of kselftest.rst - linux-imx - PHYTEC BitBucket (Stash)

 * First use the headers inside the kernel source and/or git repo, and then the

======================

Linux Kernel Selftests

======================

The kernel contains a set of "self tests" under the tools/testing/selftests/

directory. These are intended to be small tests to exercise individual code

paths in the kernel. Tests are intended to be run after building, installing

and booting a kernel.

On some systems, hot-plug tests could hang forever waiting for cpu and

memory to be ready to be offlined. A special hot-plug target is created

to run the full range of hot-plug tests. In default mode, hot-plug tests run

in safe mode with a limited scope. In limited mode, cpu-hotplug test is

run on a single cpu as opposed to all hotplug capable cpus, and memory

hotplug test is run on 2% of hotplug capable memory instead of 10%.

Running the selftests (hotplug tests are run in limited mode)

=============================================================

To build the tests::

  $ make -C tools/testing/selftests

To run the tests::

  $ make -C tools/testing/selftests run_tests

To build and run the tests with a single command, use::

  $ make kselftest

Note that some tests will require root privileges.

Build and run from user specific object directory (make O=dir)::

  $ make O=/tmp/kselftest kselftest

Build and run KBUILD_OUTPUT directory (make KBUILD_OUTPUT=)::

  $ make KBUILD_OUTPUT=/tmp/kselftest kselftest

The above commands run the tests and print pass/fail summary to make it

easier to understand the test results. Please find the detailed individual

test results for each test in /tmp/testname file(s).

Running a subset of selftests

=============================

You can use the "TARGETS" variable on the make command line to specify

single test to run, or a list of tests to run.

To run only tests targeted for a single subsystem::

  $ make -C tools/testing/selftests TARGETS=ptrace run_tests

You can specify multiple tests to build and run::

  $  make TARGETS="size timers" kselftest

Build and run from user specific object directory (make O=dir)::

  $ make O=/tmp/kselftest TARGETS="size timers" kselftest

Build and run KBUILD_OUTPUT directory (make KBUILD_OUTPUT=)::

  $ make KBUILD_OUTPUT=/tmp/kselftest TARGETS="size timers" kselftest

The above commands run the tests and print pass/fail summary to make it

easier to understand the test results. Please find the detailed individual

test results for each test in /tmp/testname file(s).

See the top-level tools/testing/selftests/Makefile for the list of all

possible targets.

Running the full range hotplug selftests

========================================

To build the hotplug tests::

  $ make -C tools/testing/selftests hotplug

To run the hotplug tests::

  $ make -C tools/testing/selftests run_hotplug

Note that some tests will require root privileges.

Install selftests

=================

You can use the kselftest_install.sh tool to install selftests in the