sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget'/translations/zh_CN/dev-tools/kselftestmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/zh_TW/dev-tools/kselftestmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/it_IT/dev-tools/kselftestmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/ja_JP/dev-tools/kselftestmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/ko_KR/dev-tools/kselftestmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/pt_BR/dev-tools/kselftestmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/sp_SP/dev-tools/kselftestmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hLinux Kernel Selftestsh]hLinux Kernel Selftests}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhA/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest.rsthKubh paragraph)}(hThe 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.h]hThe 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.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXKselftest from mainline can be run on older stable kernels. Running tests from mainline offers the best coverage. Several test rings run mainline kselftest suite on stable releases. The reason is that when a new test gets added to test existing code to regression test a bug, we should be able to run that test on an older kernel. Hence, it is important to keep code that can still test an older kernel and make sure it skips the test gracefully on newer releases.h]hXKselftest from mainline can be run on older stable kernels. Running tests from mainline offers the best coverage. Several test rings run mainline kselftest suite on stable releases. The reason is that when a new test gets added to test existing code to regression test a bug, we should be able to run that test on an older kernel. Hence, it is important to keep code that can still test an older kernel and make sure it skips the test gracefully on newer releases.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hXOn 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%.h]hXOn 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%.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hkselftest runs as a userspace process. Tests that can be written/run in userspace may wish to use the `Test Harness`_. Tests that need to be run in kernel space may wish to use a `Test Module`_.h](hgkselftest runs as a userspace process. Tests that can be written/run in userspace may wish to use the }(hhhhhNhNubh reference)}(h`Test Harness`_h]h Test Harness}(hjhhhNhNubah}(h]h ]h"]h$]h&]name Test Harnessrefid test-harnessuh1hhhresolvedKubh?. Tests that need to be run in kernel space may wish to use a }(hhhhhNhNubj)}(h`Test Module`_h]h Test Module}(hjhhhNhNubah}(h]h ]h"]h$]h&]name Test Modulej test-moduleuh1hhhjKubh.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hDocumentation on the testsh]hDocumentation on the tests}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hhhhhKubh)}(h4For documentation on the kselftests themselves, see:h]h4For documentation on the kselftests themselves, see:}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hj3hhubhcompound)}(hhh]htoctree)}(hhh]h}(h]h ]h"]h$]h&]hdev-tools/kselftestentries]Ndev-tools/testing-devicesa includefiles]jeamaxdepthJcaptionNglobhidden includehiddennumberedK titlesonly rawentries]uh1jWhhhK"hjTubah}(h]h ]toctree-wrapperah"]h$]h&]uh1jRhj3hhhhhK%ubeh}(h]documentation-on-the-testsah ]h"]documentation on the testsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h=Running the selftests (hotplug tests are run in limited mode)h]h=Running the selftests (hotplug tests are run in limited mode)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK'ubh)}(hTo build the tests::h]hTo build the tests:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjhhubh literal_block)}(h0$ make headers $ make -C tools/testing/selftestsh]h0$ make headers $ make -C tools/testing/selftests}hjsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1jhhhK+hjhhubh)}(hTo run the tests::h]hTo run the tests:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjhhubj)}(h+$ make -C tools/testing/selftests run_testsh]h+$ make -C tools/testing/selftests run_tests}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK0hjhhubh)}(h7To build and run the tests with a single command, use::h]h6To build and run the tests with a single command, use:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjhhubj)}(h$ make kselftesth]h$ make kselftest}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK4hjhhubh)}(h2Note that some tests will require root privileges.h]h2Note that some tests will require root privileges.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubh)}(hX.Kselftest supports saving output files in a separate directory and then running tests. To locate output files in a separate directory two syntaxes are supported. In both cases the working directory must be the root of the kernel src. This is applicable to "Running a subset of selftests" section below.h]hX2Kselftest supports saving output files in a separate directory and then running tests. To locate output files in a separate directory two syntaxes are supported. In both cases the working directory must be the root of the kernel src. This is applicable to “Running a subset of selftests” section below.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubh)}(h>To build, save output files in a separate directory with O= ::h]h;To build, save output files in a separate directory with O=}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjhhubj)}(h!$ make O=/tmp/kselftest kselftesth]h!$ make O=/tmp/kselftest kselftest}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK@hjhhubh)}(hITo build, save output files in a separate directory with KBUILD_OUTPUT ::h]hFTo build, save output files in a separate directory with KBUILD_OUTPUT}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjhhubj)}(h5$ export KBUILD_OUTPUT=/tmp/kselftest; make kselftesth]h5$ export KBUILD_OUTPUT=/tmp/kselftest; make kselftest}hj0sbah}(h]h ]h"]h$]h&]jjuh1jhhhKDhjhhubh)}(hOThe O= assignment takes precedence over the KBUILD_OUTPUT environment variable.h]hOThe O= assignment takes precedence over the KBUILD_OUTPUT environment variable.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjhhubh)}(hXaThe above commands by default run the tests and print full pass/fail report. Kselftest supports "summary" option to make it easier to understand the test results. Please find the detailed individual test results for each test in /tmp/testname file(s) when summary option is specified. This is applicable to "Running a subset of selftests" section below.h]hXiThe above commands by default run the tests and print full pass/fail report. Kselftest supports “summary” option to make it easier to understand the test results. Please find the detailed individual test results for each test in /tmp/testname file(s) when summary option is specified. This is applicable to “Running a subset of selftests” section below.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjhhubh)}(h/To run kselftest with summary option enabled ::h]h,To run kselftest with summary option enabled}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjhhubj)}(h$ make summary=1 kselftesth]h$ make summary=1 kselftest}hjhsbah}(h]h ]h"]h$]h&]jjuh1jhhhKQhjhhubeh}(h];running-the-selftests-hotplug-tests-are-run-in-limited-modeah ]h"]=running the selftests (hotplug tests are run in limited mode)ah$]h&]uh1hhhhhhhhK'ubh)}(hhh](h)}(hRunning a subset of selftestsh]hRunning a subset of selftests}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hhhhhKTubh)}(huYou can use the "TARGETS" variable on the make command line to specify single test to run, or a list of tests to run.h]hyYou can use the “TARGETS” variable on the make command line to specify single test to run, or a list of tests to run.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhj~hhubh)}(h3To run only tests targeted for a single subsystem::h]h2To run only tests targeted for a single subsystem:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhj~hhubj)}(h:$ make -C tools/testing/selftests TARGETS=ptrace run_testsh]h:$ make -C tools/testing/selftests TARGETS=ptrace run_tests}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK[hj~hhubh)}(h1You can specify multiple tests to build and run::h]h0You can specify multiple tests to build and run:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hj~hhubj)}(h'$ make TARGETS="size timers" kselftesth]h'$ make TARGETS="size timers" kselftest}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK_hj~hhubh)}(h>To build, save output files in a separate directory with O= ::h]h;To build, save output files in a separate directory with O=}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahj~hhubj)}(h7$ make O=/tmp/kselftest TARGETS="size timers" kselftesth]h7$ make O=/tmp/kselftest TARGETS="size timers" kselftest}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKchj~hhubh)}(hITo build, save output files in a separate directory with KBUILD_OUTPUT ::h]hFTo build, save output files in a separate directory with KBUILD_OUTPUT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehj~hhubj)}(hK$ export KBUILD_OUTPUT=/tmp/kselftest; make TARGETS="size timers" kselftesth]hK$ export KBUILD_OUTPUT=/tmp/kselftest; make TARGETS="size timers" kselftest}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKghj~hhubh)}(hAdditionally you can use the "SKIP_TARGETS" variable on the make command line to specify one or more targets to exclude from the TARGETS list.h]hAdditionally you can use the “SKIP_TARGETS” variable on the make command line to specify one or more targets to exclude from the TARGETS list.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihj~hhubh)}(h)To run all tests but a single subsystem::h]h(To run all tests but a single subsystem:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhj~hhubj)}(h?$ make -C tools/testing/selftests SKIP_TARGETS=ptrace run_testsh]h?$ make -C tools/testing/selftests SKIP_TARGETS=ptrace run_tests}hj)sbah}(h]h ]h"]h$]h&]jjuh1jhhhKnhj~hhubh)}(h(You can specify multiple tests to skip::h]h'You can specify multiple tests to skip:}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphj~hhubj)}(h,$ make SKIP_TARGETS="size timers" kselftesth]h,$ make SKIP_TARGETS="size timers" kselftest}hjEsbah}(h]h ]h"]h$]h&]jjuh1jhhhKrhj~hhubh)}(h[You can also specify a restricted list of tests to run together with a dedicated skiplist::h]hZYou can also specify a restricted list of tests to run together with a dedicated skiplist:}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthj~hhubj)}(hE$ make TARGETS="breakpoints size timers" SKIP_TARGETS=size kselftesth]hE$ make TARGETS="breakpoints size timers" SKIP_TARGETS=size kselftest}hjasbah}(h]h ]h"]h$]h&]jjuh1jhhhKwhj~hhubh)}(hXSee the top-level tools/testing/selftests/Makefile for the list of all possible targets.h]hXSee the top-level tools/testing/selftests/Makefile for the list of all possible targets.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhj~hhubeh}(h]running-a-subset-of-selftestsah ]h"]running a subset of selftestsah$]h&]uh1hhhhhhhhKT referencedKubh)}(hhh](h)}(h+Requiring all targets to build successfullyh]h+Requiring all targets to build successfully}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK}ubh)}(hBy default, the build succeeds as long as at least one target builds without error. Set ``FORCE_TARGETS=1`` to instead require every target to build successfully; make will abort as soon as any target fails::h](hXBy default, the build succeeds as long as at least one target builds without error. Set }(hjhhhNhNubhliteral)}(h``FORCE_TARGETS=1``h]hFORCE_TARGETS=1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhd to instead require every target to build successfully; make will abort as soon as any target fails:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h1$ make -C tools/testing/selftests FORCE_TARGETS=1h]h1$ make -C tools/testing/selftests FORCE_TARGETS=1}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hThis applies to both the ``all`` and ``install`` targets and is useful in CI environments where a silent partial build would be misleading.h](hThis applies to both the }(hjhhhNhNubj)}(h``all``h]hall}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h ``install``h]hinstall}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh[ targets and is useful in CI environments where a silent partial build would be misleading.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]+requiring-all-targets-to-build-successfullyah ]h"]+requiring all targets to build successfullyah$]h&]uh1hhhhhhhhK}ubh)}(hhh](h)}(hRecording suite build resultsh]hRecording suite build results}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXSince the build succeeds as long as one target builds, the exit status of make does not show which targets failed. Set ``KSFT_BUILD_REPORT`` to the absolute path of a file to have the ``all`` and ``install`` targets append a tab-separated record for each target they process::h](hwSince the build succeeds as long as one target builds, the exit status of make does not show which targets failed. Set }(hjhhhNhNubj)}(h``KSFT_BUILD_REPORT``h]hKSFT_BUILD_REPORT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, to the absolute path of a file to have the }(hjhhhNhNubj)}(h``all``h]hall}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h ``install``h]hinstall}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhD targets append a tab-separated record for each target they process:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h$ : > /tmp/ksft-build.tsv $ make -C tools/testing/selftests O=/tmp/kernel-build \ KSFT_BUILD_REPORT=/tmp/ksft-build.tsv installh]h$ : > /tmp/ksft-build.tsv $ make -C tools/testing/selftests O=/tmp/kernel-build \ KSFT_BUILD_REPORT=/tmp/ksft-build.tsv install}hjVsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hXgEach record holds the phase (``all`` or ``install``), a name and the exit status of that step. Recording does not change which targets are built or installed, or the exit status of make, also with ``FORCE_TARGETS=1``. The caller creates or truncates the report before a build; the rules only append to it. Nothing is recorded by ``make -n``, ``-t`` or ``-q``.h](hEach record holds the phase (}(hjdhhhNhNubj)}(h``all``h]hall}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh or }(hjdhhhNhNubj)}(h ``install``h]hinstall}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh), a name and the exit status of that step. Recording does not change which targets are built or installed, or the exit status of make, also with }(hjdhhhNhNubj)}(h``FORCE_TARGETS=1``h]hFORCE_TARGETS=1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubhq. The caller creates or truncates the report before a build; the rules only append to it. Nothing is recorded by }(hjdhhhNhNubj)}(h ``make -n``h]hmake -n}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh, }(hjdhhhNhNubj)}(h``-t``h]h-t}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh or }hjdsbj)}(h``-q``h]h-q}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXZThe same name can appear several times: ``install`` builds the targets again, and generating ``kselftest-list.txt`` is recorded as part of the ``install`` phase. Targets that are added automatically as installation dependencies of other targets, such as ``net/lib``, are recorded too. Suites that are built from several subdirectories may also record each subdirectory under its path, for example ``arm64/tags``; a failure there means that the suite was built or installed only partially. A record belongs to the target with the longest name that is equal to the record name or followed by ``/`` in it.h](h(The same name can appear several times: }(hjhhhNhNubj)}(h ``install``h]hinstall}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh* builds the targets again, and generating }(hjhhhNhNubj)}(h``kselftest-list.txt``h]hkselftest-list.txt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is recorded as part of the }(hjhhhNhNubj)}(h ``install``h]hinstall}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhd phase. Targets that are added automatically as installation dependencies of other targets, such as }(hjhhhNhNubj)}(h ``net/lib``h]hnet/lib}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, are recorded too. Suites that are built from several subdirectories may also record each subdirectory under its path, for example }(hjhhhNhNubj)}(h``arm64/tags``h]h arm64/tags}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh; a failure there means that the suite was built or installed only partially. A record belongs to the target with the longest name that is equal to the record name or followed by }(hjhhhNhNubj)}(h``/``h]h/}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in it.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXA target was built and installed successfully only if all of its records have a zero status. Missing records do not show that a target was built. A successful target that installs no tests has no entries in ``kselftest-list.txt``. Install the kernel headers with ``make headers`` before building: a suite that fails because the headers are missing is recorded as failed even if a later step installs them.h](hA target was built and installed successfully only if all of its records have a zero status. Missing records do not show that a target was built. A successful target that installs no tests has no entries in }(hjXhhhNhNubj)}(h``kselftest-list.txt``h]hkselftest-list.txt}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh". Install the kernel headers with }(hjXhhhNhNubj)}(h``make headers``h]h make headers}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh~ before building: a suite that fails because the headers are missing is recorded as failed even if a later step installs them.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(ht``KSFT_BUILD_REPORT_VERSION`` in tools/testing/selftests/Makefile gives the version of this format, currently ``1``.h](j)}(h``KSFT_BUILD_REPORT_VERSION``h]hKSFT_BUILD_REPORT_VERSION}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ in tools/testing/selftests/Makefile gives the version of this format, currently }(hjhhhNhNubj)}(h``1``h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]recording-suite-build-resultsah ]h"]recording suite build resultsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h(Running the full range hotplug selftestsh]h(Running the full range hotplug selftests}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hTo build the hotplug tests::h]hTo build the hotplug tests:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h)$ make -C tools/testing/selftests hotplugh]h)$ make -C tools/testing/selftests hotplug}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hTo run the hotplug tests::h]hTo run the hotplug tests:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h-$ make -C tools/testing/selftests run_hotplugh]h-$ make -C tools/testing/selftests run_hotplug}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(h2Note that some tests will require root privileges.h]h2Note that some tests will require root privileges.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h](running-the-full-range-hotplug-selftestsah ]h"](running the full range hotplug selftestsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hInstall selftestsh]hInstall selftests}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hYou can use the "install" target of "make" (which calls the `kselftest_install.sh` tool) to install selftests in the default location (`tools/testing/selftests/kselftest_install`), or in a user specified location via the `INSTALL_PATH` "make" variable.h](hDYou can use the “install” target of “make” (which calls the }(hj0hhhNhNubhtitle_reference)}(h`kselftest_install.sh`h]hkselftest_install.sh}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj0ubh5 tool) to install selftests in the default location (}(hj0hhhNhNubj9)}(h+`tools/testing/selftests/kselftest_install`h]h)tools/testing/selftests/kselftest_install}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj0ubh+), or in a user specified location via the }(hj0hhhNhNubj9)}(h`INSTALL_PATH`h]h INSTALL_PATH}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj0ubh “make” variable.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h*To install selftests in default location::h]h)To install selftests in default location:}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h)$ make -C tools/testing/selftests installh]h)$ make -C tools/testing/selftests install}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(h3To install selftests in a user specified location::h]h2To install selftests in a user specified location:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hG$ make -C tools/testing/selftests install INSTALL_PATH=/some/other/pathh]hG$ make -C tools/testing/selftests install INSTALL_PATH=/some/other/path}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubeh}(h]install-selftestsah ]h"]install selftestsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hRunning installed selftestsh]hRunning installed selftests}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(h{Found in the install directory, as well as in the Kselftest tarball, is a script named `run_kselftest.sh` to run the tests.h](hWFound in the install directory, as well as in the Kselftest tarball, is a script named }(hjhhhNhNubj9)}(h`run_kselftest.sh`h]hrun_kselftest.sh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubh to run the tests.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hvYou can simply do the following to run the installed Kselftests. Please note some tests will require root privileges::h]huYou can simply do the following to run the installed Kselftests. Please note some tests will require root privileges:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h+$ cd kselftest_install $ ./run_kselftest.shh]h+$ cd kselftest_install $ ./run_kselftest.sh}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hATo see the list of available tests, the `-l` option can be used::h](h(To see the list of available tests, the }(hjhhhNhNubj9)}(h`-l`h]h-l}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubh option can be used:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h$ ./run_kselftest.sh -lh]h$ ./run_kselftest.sh -l}hj#sbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hThe `-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::h](hThe }(hj1hhhNhNubj9)}(h`-c`h]h-c}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj1ubhH option can be used to run all the tests from a test collection, or the }(hj1hhhNhNubj9)}(h`-t`h]h-t}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj1ubhE option for specific single tests. Either can be used multiple times:}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hQ$ ./run_kselftest.sh -c size -c seccomp -t timers:posix_timers -t timer:nanosleeph]hQ$ ./run_kselftest.sh -c size -c seccomp -t timers:posix_timers -t timer:nanosleep}hjcsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hJFor other features see the script usage output, seen with the `-h` option.h](h>For other features see the script usage output, seen with the }(hjqhhhNhNubj9)}(h`-h`h]h-h}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjqubh option.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]running-installed-selftestsah ]h"]running installed selftestsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hTimeout for selftestsh]hTimeout for selftests}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX:Selftests are designed to be quick and so a default timeout is used of 45 seconds for each test. Tests can override the default timeout by adding a settings file in their directory and set a timeout variable there to the configured a desired upper timeout for the test. Only a few tests override the timeout with a value higher than 45 seconds, selftests strives to keep it that way. Timeouts in selftests are not considered fatal because the system under which a test runs may change and this can also modify the expected time it takes to run a test. If you have control over the systems which will run the tests you can configure a test runner on those systems to use a greater or lower timeout on the command line as with the `-o` or the `--override-timeout` argument. For example to use 165 seconds instead one would use::h](hXSelftests are designed to be quick and so a default timeout is used of 45 seconds for each test. Tests can override the default timeout by adding a settings file in their directory and set a timeout variable there to the configured a desired upper timeout for the test. Only a few tests override the timeout with a value higher than 45 seconds, selftests strives to keep it that way. Timeouts in selftests are not considered fatal because the system under which a test runs may change and this can also modify the expected time it takes to run a test. If you have control over the systems which will run the tests you can configure a test runner on those systems to use a greater or lower timeout on the command line as with the }(hjhhhNhNubj9)}(h`-o`h]h-o}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubh or the }(hjhhhNhNubj9)}(h`--override-timeout`h]h--override-timeout}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubh@ argument. For example to use 165 seconds instead one would use:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h+$ ./run_kselftest.sh --override-timeout 165h]h+$ ./run_kselftest.sh --override-timeout 165}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hYou can look at the TAP output to see if you ran into the timeout. Test runners which know a test must run under a specific time can then optionally treat these timeouts then as fatal.h]hYou can look at the TAP output to see if you ran into the timeout. Test runners which know a test must run under a specific time can then optionally treat these timeouts then as fatal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]timeout-for-selftestsah ]h"]timeout for selftestsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hPackaging selftestsh]hPackaging selftests}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(huIn some cases packaging is desired, such as when tests need to run on a different system. To package selftests, run::h]htIn some cases packaging is desired, such as when tests need to run on a different system. To package selftests, run:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h)$ make -C tools/testing/selftests gen_tarh]h)$ make -C tools/testing/selftests gen_tar}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hXThis generates a tarball in the `INSTALL_PATH/kselftest-packages` directory. By default, `.gz` format is used. The tar compression format can be overridden by specifying a `FORMAT` make variable. Any value recognized by `tar's auto-compress`_ option is supported, such as::h](h This generates a tarball in the }(hj-hhhNhNubj9)}(h!`INSTALL_PATH/kselftest-packages`h]hINSTALL_PATH/kselftest-packages}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj-ubh directory. By default, }(hj-hhhNhNubj9)}(h`.gz`h]h.gz}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj-ubhN format is used. The tar compression format can be overridden by specifying a }(hj-hhhNhNubj9)}(h`FORMAT`h]hFORMAT}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hj-ubh( make variable. Any value recognized by }(hj-hhhNhNubj)}(h`tar's auto-compress`_h]htar’s auto-compress}(hjkhhhNhNubah}(h]h ]h"]h$]h&]nametar's auto-compressrefuriMhttps://www.gnu.org/software/tar/manual/html_node/gzip.html#auto_002dcompressuh1hhj-jKubh option is supported, such as:}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(h4$ make -C tools/testing/selftests gen_tar FORMAT=.xzh]h4$ make -C tools/testing/selftests gen_tar FORMAT=.xz}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhMhjhhubh)}(h`make gen_tar` invokes `make install` so you can use it to package a subset of tests by using variables specified in `Running a subset of selftests`_ section::h](j9)}(h`make gen_tar`h]h make gen_tar}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubh invokes }(hjhhhNhNubj9)}(h`make install`h]h make install}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j8hjubhP so you can use it to package a subset of tests by using variables specified in }(hjhhhNhNubj)}(h `Running a subset of selftests`_h]hRunning a subset of selftests}(hjhhhNhNubah}(h]h ]h"]h$]h&]nameRunning a subset of selftestsjjuh1hhjjKubh section:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(hC$ make -C tools/testing/selftests gen_tar TARGETS="size" FORMAT=.xzh]hC$ make -C tools/testing/selftests gen_tar TARGETS="size" FORMAT=.xz}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhM hjhhubhtarget)}(hf.. _tar's auto-compress: https://www.gnu.org/software/tar/manual/html_node/gzip.html#auto_002dcompressh]h}(h]tar-s-auto-compressah ]h"]tar's auto-compressah$]h&]j{j|uh1jhM hjhhhhjKubeh}(h]packaging-selftestsah ]h"]packaging selftestsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hBuild and test on nommu targeth]hBuild and test on nommu target}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hThe nommu selftests detect NOMMU at runtime by checking for the ``MmapCopy`` entry in ``/proc/meminfo``. Ensure procfs is mounted at ``/proc`` before building and running the tests.h](h@The nommu selftests detect NOMMU at runtime by checking for the }(hj hhhNhNubj)}(h ``MmapCopy``h]hMmapCopy}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh entry in }(hj hhhNhNubj)}(h``/proc/meminfo``h]h /proc/meminfo}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh. Ensure procfs is mounted at }(hj hhhNhNubj)}(h ``/proc``h]h/proc}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh' before building and running the tests.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(h$ make ARCH=um O=build kselftest-all TARGETS=nommu # <= build-only $ make ARCH=um O=build kselftest-install TARGETS=nommu $ ./build/kselftest/kselftest_install/run_kselftest.sh -p -c nommuh]h$ make ARCH=um O=build kselftest-all TARGETS=nommu # <= build-only $ make ARCH=um O=build kselftest-install TARGETS=nommu $ ./build/kselftest/kselftest_install/run_kselftest.sh -p -c nommu}hjP sbah}(h]h ]h"]h$]h&]jjuh1jhhhMhjhhubh)}(hXThe C tests report a skip if ``/proc/meminfo`` is unavailable. On a NOMMU system, the runner needs that file to avoid wrapping the tests in ``timeout`` before they can report a skip. Mounting procfs is therefore a prerequisite for running this target through the kselftest runner.h](hThe C tests report a skip if }(hj^ hhhNhNubj)}(h``/proc/meminfo``h]h /proc/meminfo}(hjf hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ ubh^ is unavailable. On a NOMMU system, the runner needs that file to avoid wrapping the tests in }(hj^ hhhNhNubj)}(h ``timeout``h]htimeout}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ ubh before they can report a skip. Mounting procfs is therefore a prerequisite for running this target through the kselftest runner.}(hj^ hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]build-and-test-on-nommu-targetah ]h"]build and test on nommu targetah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hContributing new testsh]hContributing new tests}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM"ubh)}(h'In general, the rules for selftests areh]h'In general, the rules for selftests are}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM$hj hhubh block_quote)}(hXS* Do as much as you can if you're not root; * Don't take too long; * Don't break the build on any architecture, and * Don't cause the top-level "make run_tests" to fail if your feature is unconfigured. * The output of tests must conform to the TAP standard to ensure high testing quality and to capture failures/errors with specific details. The kselftest.h and kselftest_harness.h headers provide wrappers for outputting test results. These wrappers should be used for pass, fail, exit, and skip messages. CI systems can easily parse TAP output messages to detect test results. h]h bullet_list)}(hhh](h list_item)}(h*Do as much as you can if you're not root; h]h)}(h)Do as much as you can if you're not root;h]h+Do as much as you can if you’re not root;}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM&hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hDon't take too long; h]h)}(hDon't take too long;h]hDon’t take too long;}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM(hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(h/Don't break the build on any architecture, and h]h)}(h.Don't break the build on any architecture, andh]h0Don’t break the build on any architecture, and}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM*hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hTDon't cause the top-level "make run_tests" to fail if your feature is unconfigured. h]h)}(hSDon't cause the top-level "make run_tests" to fail if your feature is unconfigured.h]hYDon’t cause the top-level “make run_tests” to fail if your feature is unconfigured.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM,hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hXwThe output of tests must conform to the TAP standard to ensure high testing quality and to capture failures/errors with specific details. The kselftest.h and kselftest_harness.h headers provide wrappers for outputting test results. These wrappers should be used for pass, fail, exit, and skip messages. CI systems can easily parse TAP output messages to detect test results. h]h)}(hXvThe output of tests must conform to the TAP standard to ensure high testing quality and to capture failures/errors with specific details. The kselftest.h and kselftest_harness.h headers provide wrappers for outputting test results. These wrappers should be used for pass, fail, exit, and skip messages. CI systems can easily parse TAP output messages to detect test results.h]hXvThe output of tests must conform to the TAP standard to ensure high testing quality and to capture failures/errors with specific details. The kselftest.h and kselftest_harness.h headers provide wrappers for outputting test results. These wrappers should be used for pass, fail, exit, and skip messages. CI systems can easily parse TAP output messages to detect test results.}(hj( hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM/hj$ ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]bullet*uh1j hhhM&hj ubah}(h]h ]h"]h$]h&]uh1j hhhM&hj hhubeh}(h]contributing-new-testsah ]h"]contributing new testsah$]h&]uh1hhhhhhhhM"ubh)}(hhh](h)}(h Contributing new tests (details)h]h Contributing new tests (details)}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjR hhhhhM7ubj )}(hX9 * In your Makefile, use facilities from lib.mk by including it instead of reinventing the wheel. Specify flags and binaries generation flags on need basis before including lib.mk. :: CFLAGS = $(KHDR_INCLUDES) TEST_GEN_PROGS := close_range_test include ../lib.mk * Use TEST_GEN_XXX if such binaries or files are generated during compiling. TEST_PROGS, TEST_GEN_PROGS mean it is the executable tested by default. TEST_GEN_MODS_DIR should be used by tests that require modules to be built before the test starts. The variable will contain the name of the directory containing the modules. TEST_CUSTOM_PROGS should be used by tests that require custom build rules and prevent common build rule use. TEST_PROGS are for test shell scripts. Please ensure shell script has its exec bit set. Otherwise, lib.mk run_tests will generate a warning. TEST_CUSTOM_PROGS and TEST_PROGS will be run by common run_tests. TEST_PROGS_EXTENDED, TEST_GEN_PROGS_EXTENDED mean it is the executable which is not tested by default. TEST_FILES, TEST_GEN_FILES mean it is the file which is used by test. TEST_INCLUDES is similar to TEST_FILES, it lists files which should be included when exporting or installing the tests, with the following differences: * symlinks to files in other directories are preserved * the part of paths below tools/testing/selftests/ is preserved when copying the files to the output directory TEST_INCLUDES is meant to list dependencies located in other directories of the selftests hierarchy. * First use the headers inside the kernel source and/or git repo, and then the system headers. Headers for the kernel release as opposed to headers installed by the distro on the system should be the primary focus to be able to find regressions. Use KHDR_INCLUDES in Makefile to include headers from the kernel source. * If a test needs specific kernel config options enabled, add a config file in the test directory to enable them. e.g: tools/testing/selftests/android/config * Create a .gitignore file inside test directory and add all generated objects in it. * Add new test name in TARGETS in selftests/Makefile:: TARGETS += android * All changes should pass:: kselftest-{all,install,clean,gen_tar} kselftest-{all,install,clean,gen_tar} O=abo_path kselftest-{all,install,clean,gen_tar} O=rel_path make -C tools/testing/selftests {all,install,clean,gen_tar} make -C tools/testing/selftests {all,install,clean,gen_tar} O=abs_path make -C tools/testing/selftests {all,install,clean,gen_tar} O=rel_path h]j )}(hhh](j )}(hXIn your Makefile, use facilities from lib.mk by including it instead of reinventing the wheel. Specify flags and binaries generation flags on need basis before including lib.mk. :: CFLAGS = $(KHDR_INCLUDES) TEST_GEN_PROGS := close_range_test include ../lib.mk h](h)}(hIn your Makefile, use facilities from lib.mk by including it instead of reinventing the wheel. Specify flags and binaries generation flags on need basis before including lib.mk. ::h]hIn your Makefile, use facilities from lib.mk by including it instead of reinventing the wheel. Specify flags and binaries generation flags on need basis before including lib.mk.}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM9hjj ubj)}(hNCFLAGS = $(KHDR_INCLUDES) TEST_GEN_PROGS := close_range_test include ../lib.mkh]hNCFLAGS = $(KHDR_INCLUDES) TEST_GEN_PROGS := close_range_test include ../lib.mk}hj| sbah}(h]h ]h"]h$]h&]jjuh1jhhhM=hjj ubeh}(h]h ]h"]h$]h&]uh1j hjg ubj )}(hXUse TEST_GEN_XXX if such binaries or files are generated during compiling. TEST_PROGS, TEST_GEN_PROGS mean it is the executable tested by default. TEST_GEN_MODS_DIR should be used by tests that require modules to be built before the test starts. The variable will contain the name of the directory containing the modules. TEST_CUSTOM_PROGS should be used by tests that require custom build rules and prevent common build rule use. TEST_PROGS are for test shell scripts. Please ensure shell script has its exec bit set. Otherwise, lib.mk run_tests will generate a warning. TEST_CUSTOM_PROGS and TEST_PROGS will be run by common run_tests. TEST_PROGS_EXTENDED, TEST_GEN_PROGS_EXTENDED mean it is the executable which is not tested by default. TEST_FILES, TEST_GEN_FILES mean it is the file which is used by test. TEST_INCLUDES is similar to TEST_FILES, it lists files which should be included when exporting or installing the tests, with the following differences: * symlinks to files in other directories are preserved * the part of paths below tools/testing/selftests/ is preserved when copying the files to the output directory TEST_INCLUDES is meant to list dependencies located in other directories of the selftests hierarchy. h](h)}(hJUse TEST_GEN_XXX if such binaries or files are generated during compiling.h]hJUse TEST_GEN_XXX if such binaries or files are generated during compiling.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMAhj ubh)}(hGTEST_PROGS, TEST_GEN_PROGS mean it is the executable tested by default.h]hGTEST_PROGS, TEST_GEN_PROGS mean it is the executable tested by default.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj ubh)}(hTEST_GEN_MODS_DIR should be used by tests that require modules to be built before the test starts. The variable will contain the name of the directory containing the modules.h]hTEST_GEN_MODS_DIR should be used by tests that require modules to be built before the test starts. The variable will contain the name of the directory containing the modules.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhj ubh)}(hlTEST_CUSTOM_PROGS should be used by tests that require custom build rules and prevent common build rule use.h]hlTEST_CUSTOM_PROGS should be used by tests that require custom build rules and prevent common build rule use.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMKhj ubh)}(hTEST_PROGS are for test shell scripts. Please ensure shell script has its exec bit set. Otherwise, lib.mk run_tests will generate a warning.h]hTEST_PROGS are for test shell scripts. Please ensure shell script has its exec bit set. Otherwise, lib.mk run_tests will generate a warning.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMNhj ubh)}(hATEST_CUSTOM_PROGS and TEST_PROGS will be run by common run_tests.h]hATEST_CUSTOM_PROGS and TEST_PROGS will be run by common run_tests.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMQhj ubh)}(hfTEST_PROGS_EXTENDED, TEST_GEN_PROGS_EXTENDED mean it is the executable which is not tested by default.h]hfTEST_PROGS_EXTENDED, TEST_GEN_PROGS_EXTENDED mean it is the executable which is not tested by default.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMShj ubh)}(hETEST_FILES, TEST_GEN_FILES mean it is the file which is used by test.h]hETEST_FILES, TEST_GEN_FILES mean it is the file which is used by test.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMVhj ubh)}(hTEST_INCLUDES is similar to TEST_FILES, it lists files which should be included when exporting or installing the tests, with the following differences:h]hTEST_INCLUDES is similar to TEST_FILES, it lists files which should be included when exporting or installing the tests, with the following differences:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMYhj ubj )}(h* symlinks to files in other directories are preserved * the part of paths below tools/testing/selftests/ is preserved when copying the files to the output directory h]j )}(hhh](j )}(h4symlinks to files in other directories are preservedh]h)}(hj h]h4symlinks to files in other directories are preserved}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM]hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hmthe part of paths below tools/testing/selftests/ is preserved when copying the files to the output directory h]h)}(hlthe part of paths below tools/testing/selftests/ is preserved when copying the files to the output directoryh]hlthe part of paths below tools/testing/selftests/ is preserved when copying the files to the output directory}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM^hj0 ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]jB jC uh1j hhhM]hj ubah}(h]h ]h"]h$]h&]uh1j hhhM]hj ubh)}(hdTEST_INCLUDES is meant to list dependencies located in other directories of the selftests hierarchy.h]hdTEST_INCLUDES is meant to list dependencies located in other directories of the selftests hierarchy.}(hjT hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMahj ubeh}(h]h ]h"]h$]h&]uh1j hjg ubj )}(hX>First use the headers inside the kernel source and/or git repo, and then the system headers. Headers for the kernel release as opposed to headers installed by the distro on the system should be the primary focus to be able to find regressions. Use KHDR_INCLUDES in Makefile to include headers from the kernel source. h]h)}(hX=First use the headers inside the kernel source and/or git repo, and then the system headers. Headers for the kernel release as opposed to headers installed by the distro on the system should be the primary focus to be able to find regressions. Use KHDR_INCLUDES in Makefile to include headers from the kernel source.h]hX=First use the headers inside the kernel source and/or git repo, and then the system headers. Headers for the kernel release as opposed to headers installed by the distro on the system should be the primary focus to be able to find regressions. Use KHDR_INCLUDES in Makefile to include headers from the kernel source.}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMdhjh ubah}(h]h ]h"]h$]h&]uh1j hjg ubj )}(hIf a test needs specific kernel config options enabled, add a config file in the test directory to enable them. e.g: tools/testing/selftests/android/config h](h)}(hoIf a test needs specific kernel config options enabled, add a config file in the test directory to enable them.h]hoIf a test needs specific kernel config options enabled, add a config file in the test directory to enable them.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMjhj ubh)}(h+e.g: tools/testing/selftests/android/configh]h+e.g: tools/testing/selftests/android/config}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMmhj ubeh}(h]h ]h"]h$]h&]uh1j hjg ubj )}(hTCreate a .gitignore file inside test directory and add all generated objects in it. h]h)}(hSCreate a .gitignore file inside test directory and add all generated objects in it.h]hSCreate a .gitignore file inside test directory and add all generated objects in it.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMohj ubah}(h]h ]h"]h$]h&]uh1j hjg ubj )}(hJAdd new test name in TARGETS in selftests/Makefile:: TARGETS += android h](h)}(h4Add new test name in TARGETS in selftests/Makefile::h]h3Add new test name in TARGETS in selftests/Makefile:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMrhj ubj)}(hTARGETS += androidh]hTARGETS += android}hj sbah}(h]h ]h"]h$]h&]jjuh1jhhhMthj ubeh}(h]h ]h"]h$]h&]uh1j hjg ubj )}(hXsAll changes should pass:: kselftest-{all,install,clean,gen_tar} kselftest-{all,install,clean,gen_tar} O=abo_path kselftest-{all,install,clean,gen_tar} O=rel_path make -C tools/testing/selftests {all,install,clean,gen_tar} make -C tools/testing/selftests {all,install,clean,gen_tar} O=abs_path make -C tools/testing/selftests {all,install,clean,gen_tar} O=rel_path h](h)}(hAll changes should pass::h]hAll changes should pass:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMvhj ubj)}(hXQkselftest-{all,install,clean,gen_tar} kselftest-{all,install,clean,gen_tar} O=abo_path kselftest-{all,install,clean,gen_tar} O=rel_path make -C tools/testing/selftests {all,install,clean,gen_tar} make -C tools/testing/selftests {all,install,clean,gen_tar} O=abs_path make -C tools/testing/selftests {all,install,clean,gen_tar} O=rel_pathh]hXQkselftest-{all,install,clean,gen_tar} kselftest-{all,install,clean,gen_tar} O=abo_path kselftest-{all,install,clean,gen_tar} O=rel_path make -C tools/testing/selftests {all,install,clean,gen_tar} make -C tools/testing/selftests {all,install,clean,gen_tar} O=abs_path make -C tools/testing/selftests {all,install,clean,gen_tar} O=rel_path}hj sbah}(h]h ]h"]h$]h&]jjuh1jhhhMxhj ubeh}(h]h ]h"]h$]h&]uh1j hjg ubeh}(h]h ]h"]h$]h&]jB jC uh1j hhhM9hjc ubah}(h]h ]h"]h$]h&]uh1j hhhM9hjR hhubeh}(h]contributing-new-tests-detailsah ]h"] contributing new tests (details)ah$]h&]uh1hhhhhhhhM7ubh)}(hhh](h)}(h Test Moduleh]h Test Module}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hXKselftest tests the kernel from userspace. Sometimes things need testing from within the kernel, one method of doing this is to create a test module. We can tie the module into the kselftest framework by using a shell script test runner. ``kselftest/module.sh`` is designed to facilitate this process. There is also a header file provided to assist writing kernel modules that are for use with kselftest:h](hKselftest tests the kernel from userspace. Sometimes things need testing from within the kernel, one method of doing this is to create a test module. We can tie the module into the kselftest framework by using a shell script test runner. }(hj/ hhhNhNubj)}(h``kselftest/module.sh``h]hkselftest/module.sh}(hj7 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ ubh is designed to facilitate this process. There is also a header file provided to assist writing kernel modules that are for use with kselftest:}(hj/ hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj )}(hhh](j )}(h.``tools/testing/selftests/kselftest_module.h``h]h)}(hjT h]j)}(hjT h]h*tools/testing/selftests/kselftest_module.h}(hjY hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV ubah}(h]h ]h"]h$]h&]uh1hhhhMhjR ubah}(h]h ]h"]h$]h&]uh1j hjO hhhhhNubj )}(h0``tools/testing/selftests/kselftest/module.sh`` h]h)}(h/``tools/testing/selftests/kselftest/module.sh``h]j)}(hjx h]h+tools/testing/selftests/kselftest/module.sh}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjv ubah}(h]h ]h"]h$]h&]uh1hhhhMhjr ubah}(h]h ]h"]h$]h&]uh1j hjO hhhhhNubeh}(h]h ]h"]h$]h&]jB -uh1j hhhMhj hhubh)}(hXNote that test modules should taint the kernel with TAINT_TEST. This will happen automatically for modules which are in the ``tools/testing/`` directory, or for modules which use the ``kselftest_module.h`` header above. Otherwise, you'll need to add ``MODULE_INFO(test, "Y")`` to your module source. selftests which do not load modules typically should not taint the kernel, but in cases where a non-test module is loaded, TEST_TAINT can be applied from userspace by writing to ``/proc/sys/kernel/tainted``.h](h|Note that test modules should taint the kernel with TAINT_TEST. This will happen automatically for modules which are in the }(hj hhhNhNubj)}(h``tools/testing/``h]htools/testing/}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh) directory, or for modules which use the }(hj hhhNhNubj)}(h``kselftest_module.h``h]hkselftest_module.h}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh/ header above. Otherwise, you’ll need to add }(hj hhhNhNubj)}(h``MODULE_INFO(test, "Y")``h]hMODULE_INFO(test, "Y")}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh to your module source. selftests which do not load modules typically should not taint the kernel, but in cases where a non-test module is loaded, TEST_TAINT can be applied from userspace by writing to }(hj hhhNhNubj)}(h``/proc/sys/kernel/tainted``h]h/proc/sys/kernel/tainted}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hhh](h)}(h How to useh]h How to use}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(h|Here we show the typical steps to create a test module and tie it into kselftest. We use kselftests for lib/ as an example.h]h|Here we show the typical steps to create a test module and tie it into kselftest. We use kselftests for lib/ as an example.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubhenumerated_list)}(hhh](j )}(hCreate the test module h]h)}(hCreate the test moduleh]hCreate the test module}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hmCreate the test script that will run (load/unload) the module e.g. ``tools/testing/selftests/lib/bitmap.sh`` h]h)}(hlCreate the test script that will run (load/unload) the module e.g. ``tools/testing/selftests/lib/bitmap.sh``h](hCCreate the test script that will run (load/unload) the module e.g. }(hj0 hhhNhNubj)}(h)``tools/testing/selftests/lib/bitmap.sh``h]h%tools/testing/selftests/lib/bitmap.sh}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0 ubeh}(h]h ]h"]h$]h&]uh1hhhhMhj, ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hDAdd line to config file e.g. ``tools/testing/selftests/lib/config`` h]h)}(hCAdd line to config file e.g. ``tools/testing/selftests/lib/config``h](hAdd line to config file e.g. }(hjV hhhNhNubj)}(h&``tools/testing/selftests/lib/config``h]h"tools/testing/selftests/lib/config}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV ubeh}(h]h ]h"]h$]h&]uh1hhhhMhjR ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hKAdd test script to makefile e.g. ``tools/testing/selftests/lib/Makefile`` h]h)}(hJAdd test script to makefile e.g. ``tools/testing/selftests/lib/Makefile``h](h"Add test script to makefile e.g. }(hj| hhhNhNubj)}(h(``tools/testing/selftests/lib/Makefile``h]h$tools/testing/selftests/lib/Makefile}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj| ubeh}(h]h ]h"]h$]h&]uh1hhhhMhjx ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj )}(hVerify it works: h]h)}(hVerify it works:h]hVerify it works:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j hj hhhhhMubj)}(h# Assumes you have booted a fresh build of this kernel tree cd /path/to/linux/tree make kselftest-merge make modules sudo make modules_install make TARGETS=lib kselftesth]h# Assumes you have booted a fresh build of this kernel tree cd /path/to/linux/tree make kselftest-merge make modules sudo make modules_install make TARGETS=lib kselftest}hj sbah}(h]h ]h"]h$]h&]jjforcelanguageshhighlight_args}uh1jhhhMhj hhubeh}(h] how-to-useah ]h"] how to useah$]h&]uh1hhj hhhhhMubh)}(hhh](h)}(hExample Moduleh]hExample Module}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(h.A bare bones test module might look like this:h]h.A bare bones test module might look like this:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(hX// SPDX-License-Identifier: GPL-2.0+ #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt #include "../tools/testing/selftests/kselftest_module.h" KSTM_MODULE_GLOBALS(); /* * Kernel module for testing the foobinator */ static int __init test_function() { ... } static void __init selftest(void) { KSTM_CHECK_ZERO(do_test_case("", 0)); } KSTM_MODULE_LOADERS(test_foo); MODULE_AUTHOR("John Developer "); MODULE_LICENSE("GPL"); MODULE_INFO(test, "Y");h]hX// SPDX-License-Identifier: GPL-2.0+ #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt #include "../tools/testing/selftests/kselftest_module.h" KSTM_MODULE_GLOBALS(); /* * Kernel module for testing the foobinator */ static int __init test_function() { ... } static void __init selftest(void) { KSTM_CHECK_ZERO(do_test_case("", 0)); } KSTM_MODULE_LOADERS(test_foo); MODULE_AUTHOR("John Developer "); MODULE_LICENSE("GPL"); MODULE_INFO(test, "Y");}hj sbah}(h]h ]h"]h$]h&]jjj j cj }uh1jhhhMhj hhubeh}(h]example-moduleah ]h"]example moduleah$]h&]uh1hhj hhhhhMubh)}(hhh](h)}(hExample test scripth]hExample test script}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj)}(hc#!/bin/bash # SPDX-License-Identifier: GPL-2.0+ $(dirname $0)/../kselftest/module.sh "foo" test_fooh]hc#!/bin/bash # SPDX-License-Identifier: GPL-2.0+ $(dirname $0)/../kselftest/module.sh "foo" test_foo}hj$sbah}(h]h ]h"]h$]h&]jjj j shj }uh1jhhhMhjhhubeh}(h]example-test-scriptah ]h"]example test scriptah$]h&]uh1hhj hhhhhMubeh}(h]j(ah ]h"] test moduleah$]h&]uh1hhhhhhhhMjKubh)}(hhh](h)}(h Test Harnessh]h Test Harness}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChhhhhMubh)}(hThe kselftest_harness.h file contains useful helpers to build tests. The test harness is for userspace testing, for kernel space testing see `Test Module`_ above.h](hThe kselftest_harness.h file contains useful helpers to build tests. The test harness is for userspace testing, for kernel space testing see }(hjThhhNhNubj)}(h`Test Module`_h]h Test Module}(hj\hhhNhNubah}(h]h ]h"]h$]h&]name Test Modulejj(uh1hhjTjKubh above.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjChhubh)}(hTThe tests from tools/testing/selftests/seccomp/seccomp_bpf.c can be used as example.h]hTThe tests from tools/testing/selftests/seccomp/seccomp_bpf.c can be used as example.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjChhubh)}(hhh](h)}(hExampleh]hExample}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubj)}(hX#include "kselftest_harness.h" TEST(standalone_test) { do_some_stuff; EXPECT_GT(10, stuff) { stuff_state_t state; enumerate_stuff_state(&state); TH_LOG("expectation failed with state: %s", state.msg); } more_stuff; ASSERT_NE(some_stuff, NULL) TH_LOG("how did it happen?!"); last_stuff; EXPECT_EQ(0, last_stuff); } FIXTURE(my_fixture) { mytype_t *data; int awesomeness_level; }; FIXTURE_SETUP(my_fixture) { self->data = mytype_new(); ASSERT_NE(NULL, self->data); } FIXTURE_TEARDOWN(my_fixture) { mytype_free(self->data); } TEST_F(my_fixture, data_is_good) { EXPECT_EQ(1, is_my_data_good(self->data)); } TEST_HARNESS_MAINh]hX#include "kselftest_harness.h" TEST(standalone_test) { do_some_stuff; EXPECT_GT(10, stuff) { stuff_state_t state; enumerate_stuff_state(&state); TH_LOG("expectation failed with state: %s", state.msg); } more_stuff; ASSERT_NE(some_stuff, NULL) TH_LOG("how did it happen?!"); last_stuff; EXPECT_EQ(0, last_stuff); } FIXTURE(my_fixture) { mytype_t *data; int awesomeness_level; }; FIXTURE_SETUP(my_fixture) { self->data = mytype_new(); ASSERT_NE(NULL, self->data); } FIXTURE_TEARDOWN(my_fixture) { mytype_free(self->data); } TEST_F(my_fixture, data_is_good) { EXPECT_EQ(1, is_my_data_good(self->data)); } TEST_HARNESS_MAIN}hjsbah}(h]h ]h"]h$]h&]jjj j j j }uh1jhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:487: ./tools/testing/selftests/kselftest_harness.hhK hjhhubeh}(h]exampleah ]h"]exampleah$]h&]uh1hhjChhhhhMubh)}(hhh](h)}(hHelpersh]hHelpers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singleTH_LOG (C macro)c.TH_LOGhNtauh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhNubhdesc)}(hhh](hdesc_signature)}(hTH_LOGh]hdesc_signature_line)}(hTH_LOGh]h desc_name)}(hTH_LOGh]h desc_sig_name)}(hjh]hTH_LOG}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]jjuh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhK^ubah}(h]h ]h"]h$]h&]jj add_permalinkuh1jsphinx_line_type declaratorhjhhhjhK^ubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhK^hjhhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhK^ubeh}(h]h ](j macroeh"]h$]h&]domainj objtypej"desctypej"noindex noindexentrynocontentsentryuh1jhhhjhjhNubh)}(h``TH_LOG (fmt, ...)``h]j)}(hj.h]hTH_LOG (fmt, ...)}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhK`hjhhubh container)}(hX[**Parameters** ``fmt`` format string ``...`` optional arguments **Description** .. code-block:: c TH_LOG(format, ...) Optional debug logging function available for use in tests. Logging may be enabled or disabled by defining TH_LOG_ENABLED. E.g., #define TH_LOG_ENABLED 1 If no definition is provided, logging is enabled by default.h](h)}(h**Parameters**h]hstrong)}(hjLh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjJubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhKbhjFubhdefinition_list)}(hhh](hdefinition_list_item)}(h``fmt`` format string h](hterm)}(h``fmt``h]j)}(hjsh]hfmt}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhK`hjkubh definition)}(hhh]h)}(h format stringh]h format string}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK`hjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jihjhK`hjfubjj)}(h``...`` optional arguments h](jp)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhKahjubj)}(hhh]h)}(hoptional argumentsh]hoptional arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKahjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhKahjfubeh}(h]h ]h"]h$]h&]uh1jdhjFubh)}(h**Description**h]jO)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhKchjFubj)}(hTH_LOG(format, ...)h]hTH_LOG(format, ...)}hjsbah}(h]h ]h"]h$]h&]jjj j j j }uh1jhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhK_hjFubh)}(hOptional debug logging function available for use in tests. Logging may be enabled or disabled by defining TH_LOG_ENABLED. E.g., #define TH_LOG_ENABLED 1h]hOptional debug logging function available for use in tests. Logging may be enabled or disabled by defining TH_LOG_ENABLED. E.g., #define TH_LOG_ENABLED 1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhKchjFubh)}(hOptionally called once per fixture to declare fixture variant h]h)}(h=Optionally called once per fixture to declare fixture varianth]h=Optionally called once per fixture to declare fixture variant}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMDhjubah}(h]h ]h"]h$]h&]uh1j hjhMDhjhhubjE)}(hXO**Parameters** ``fixture_name`` fixture name **Description** .. code-block:: c FIXTURE_VARIANT(fixture_name) { type property1; ... }; Defines type of constant parameters provided to FIXTURE_SETUP(), TEST_F() and FIXTURE_TEARDOWN as *variant*. Variants allow the same tests to be run with different arguments.h](h)}(h**Parameters**h]jO)}(hjh]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMHhjubje)}(hhh]jj)}(h``fixture_name`` fixture name h](jp)}(h``fixture_name``h]j)}(hj>h]h fixture_name}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMGhj8ubj)}(hhh]h)}(h fixture nameh]h fixture name}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShMGhjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jihjShMGhj5ubah}(h]h ]h"]h$]h&]uh1jdhjubh)}(h**Description**h]jO)}(hjyh]h Description}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjwubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMIhjubj)}(h:FIXTURE_VARIANT(fixture_name) { type property1; ... };h]h:FIXTURE_VARIANT(fixture_name) { type property1; ... };}hjsbah}(h]h ]h"]h$]h&]jjj j j j }uh1jhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMHhjubh)}(hDefines type of constant parameters provided to FIXTURE_SETUP(), TEST_F() and FIXTURE_TEARDOWN as *variant*. Variants allow the same tests to be run with different arguments.h](hbDefines type of constant parameters provided to FIXTURE_SETUP(), TEST_F() and FIXTURE_TEARDOWN as }(hjhhhNhNubj)}(h *variant*h]hvariant}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhC. Variants allow the same tests to be run with different arguments.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMOhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhjhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jFIXTURE_VARIANT_ADD (C macro)c.FIXTURE_VARIANT_ADDhNtauh1jhjhhhjhNubj)}(hhh](j)}(hFIXTURE_VARIANT_ADDh]j)}(hFIXTURE_VARIANT_ADDh]j)}(hFIXTURE_VARIANT_ADDh]j)}(hjh]hFIXTURE_VARIANT_ADD}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMWubah}(h]h ]h"]h$]h&]jjjuh1jjjhjhhhjhMWubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhjhMWhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhMWubeh}(h]h ](j macroeh"]h$]h&]j&j j'jj(jj)j*j+uh1jhhhjhjhNubh)}(h4``FIXTURE_VARIANT_ADD (fixture_name, variant_name)``h]j)}(hjh]h0FIXTURE_VARIANT_ADD (fixture_name, variant_name)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMYhjhhubj )}(h?Called once per fixture variant to setup and register the data h]h)}(h>Called once per fixture variant to setup and register the datah]h>Called once per fixture variant to setup and register the data}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMWhj,ubah}(h]h ]h"]h$]h&]uh1j hj>hMWhjhhubjE)}(hXz**Parameters** ``fixture_name`` fixture name ``variant_name`` name of the parameter set **Description** .. code-block:: c FIXTURE_VARIANT_ADD(fixture_name, variant_name) { .property1 = val1, ... }; Defines a variant of the test fixture, provided to FIXTURE_SETUP() and TEST_F() as *variant*. Tests of each fixture will be run once for each variant.h](h)}(h**Parameters**h]jO)}(hjKh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjIubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM[hjEubje)}(hhh](jj)}(h``fixture_name`` fixture name h](jp)}(h``fixture_name``h]j)}(hjjh]h fixture_name}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMZhjdubj)}(hhh]h)}(h fixture nameh]h fixture name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMZhjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jihjhMZhjaubjj)}(h+``variant_name`` name of the parameter set h](jp)}(h``variant_name``h]j)}(hjh]h variant_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM[hjubj)}(hhh]h)}(hname of the parameter seth]hname of the parameter set}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhM[hjaubeh}(h]h ]h"]h$]h&]uh1jdhjEubh)}(h**Description**h]jO)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM]hjEubj)}(hOFIXTURE_VARIANT_ADD(fixture_name, variant_name) { .property1 = val1, ... };h]hOFIXTURE_VARIANT_ADD(fixture_name, variant_name) { .property1 = val1, ... };}hjsbah}(h]h ]h"]h$]h&]jjj j j j }uh1jhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM\hjEubh)}(hDefines a variant of the test fixture, provided to FIXTURE_SETUP() and TEST_F() as *variant*. Tests of each fixture will be run once for each variant.h](hSDefines a variant of the test fixture, provided to FIXTURE_SETUP() and TEST_F() as }(hjhhhNhNubj)}(h *variant*h]hvariant}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:. Tests of each fixture will be run once for each variant.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMchjEubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhjhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jTEST_F (C macro)c.TEST_FhNtauh1jhjhhhjhNubj)}(hhh](j)}(hTEST_Fh]j)}(hTEST_Fh]j)}(hTEST_Fh]j)}(hj?h]hTEST_F}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubah}(h]h ](jjeh"]h$]h&]jjuh1jhjAhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMyubah}(h]h ]h"]h$]h&]jjjuh1jjjhj=hhhj\hMyubah}(h]j8ah ](j j eh"]h$]h&]jj)jhuh1jhj\hMyhj:hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj:hhhj\hMyubeh}(h]h ](j macroeh"]h$]h&]j&j j'juj(juj)j*j+uh1jhhhjhjhNubh)}(h$``TEST_F (fixture_name, test_name)``h]j)}(hj{h]h TEST_F (fixture_name, test_name)}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM{hjhhubj )}(hAEmits test registration and helpers for fixture-based test cases h]h)}(h@Emits test registration and helpers for fixture-based test casesh]h@Emits test registration and helpers for fixture-based test cases}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMyhjubah}(h]h ]h"]h$]h&]uh1j hjhMyhjhhubjE)}(hXx**Parameters** ``fixture_name`` fixture name ``test_name`` test name **Description** .. code-block:: c TEST_F(fixture, name) { implementation } Defines a test that depends on a fixture (e.g., is part of a test case). Very similar to TEST() except that *self* is the setup instance of fixture's datatype exposed for use by the implementation. The _metadata object is shared (MAP_SHARED) with all the potential forked processes, which enables them to use EXCEPT_*() and ASSERT_*(). The *self* object is only shared with the potential forked processes if FIXTURE_TEARDOWN_PARENT() is used instead of FIXTURE_TEARDOWN().h](h)}(h**Parameters**h]jO)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM}hjubje)}(hhh](jj)}(h``fixture_name`` fixture name h](jp)}(h``fixture_name``h]j)}(hjh]h fixture_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM|hjubj)}(hhh]h)}(h fixture nameh]h fixture name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM|hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhM|hjubjj)}(h``test_name`` test name h](jp)}(h ``test_name``h]j)}(hjh]h test_name}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM}hjubj)}(hhh]h)}(h test nameh]h test name}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM}hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhM}hjubeh}(h]h ]h"]h$]h&]uh1jdhjubh)}(h**Description**h]jO)}(hjCh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjAubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhjubj)}(h(TEST_F(fixture, name) { implementation }h]h(TEST_F(fixture, name) { implementation }}hjYsbah}(h]h ]h"]h$]h&]jjj j j j }uh1jhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhM~hjubh)}(hDefines a test that depends on a fixture (e.g., is part of a test case). Very similar to TEST() except that *self* is the setup instance of fixture's datatype exposed for use by the implementation.h](hlDefines a test that depends on a fixture (e.g., is part of a test case). Very similar to TEST() except that }(hjihhhNhNubj)}(h*self*h]hself}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubhU is the setup instance of fixture’s datatype exposed for use by the implementation.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhjubh)}(hThe _metadata object is shared (MAP_SHARED) with all the potential forked processes, which enables them to use EXCEPT_*() and ASSERT_*().h]hThe _metadata object is shared (MAP_SHARED) with all the potential forked processes, which enables them to use EXCEPT_*() and ASSERT_*().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhjubh)}(hThe *self* object is only shared with the potential forked processes if FIXTURE_TEARDOWN_PARENT() is used instead of FIXTURE_TEARDOWN().h](hThe }(hjhhhNhNubj)}(h*self*h]hself}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh~ object is only shared with the potential forked processes if FIXTURE_TEARDOWN_PARENT() is used instead of FIXTURE_TEARDOWN().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhjhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jTEST_HARNESS_MAIN (C macro)c.TEST_HARNESS_MAINhNtauh1jhjhhhjhNubj)}(hhh](j)}(hTEST_HARNESS_MAINh]j)}(hTEST_HARNESS_MAINh]j)}(hTEST_HARNESS_MAINh]j)}(hjh]hTEST_HARNESS_MAIN}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j j(j j)j*j+uh1jhhhjhjhNubh)}(h``TEST_HARNESS_MAIN``h]j)}(hjh]hTEST_HARNESS_MAIN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhjhhubj )}(h Simple wrapper to run the test harness **Description** .. code-block:: c TEST_HARNESS_MAIN Use once to append a main() to the test file. h](j )}(h'Simple wrapper to run the test harness h]h)}(h&Simple wrapper to run the test harnessh]h&Simple wrapper to run the test harness}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhj*ubah}(h]h ]h"]h$]h&]uh1j hj<hMhj&ubh)}(h**Description**h]jO)}(hjEh]h Description}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjCubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhj&ubj)}(hTEST_HARNESS_MAINh]hTEST_HARNESS_MAIN}hj[sbah}(h]h ]h"]h$]h&]jjj j j j }uh1jhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhj&ubh)}(h-Use once to append a main() to the test file.h]h-Use once to append a main() to the test file.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:494: ./tools/testing/selftests/kselftest_harness.hhMhj&ubeh}(h]h ]h"]h$]h&]uh1j hj<hMhjhhubeh}(h]helpersah ]h"]helpersah$]h&]uh1hhjChhhhhMubh)}(hhh](h)}(h Operatorsh]h Operators}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hOperators for use in TEST() and TEST_F(). ASSERT_* calls will stop test execution immediately. EXPECT_* calls will emit a failure warning, note it, and continue.h]hOperators for use in TEST() and TEST_F(). ASSERT_* calls will stop test execution immediately. EXPECT_* calls will emit a failure warning, note it, and continue.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:502: ./tools/testing/selftests/kselftest_harness.hhMhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_EQ (C macro) c.ASSERT_EQhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_EQh]j)}(h ASSERT_EQh]j)}(h ASSERT_EQh]j)}(hjh]h ASSERT_EQ}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j macroeh"]h$]h&]j&j j'jj(jj)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_EQ (expected, seen)``h]j)}(hjh]hASSERT_EQ (expected, seen)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_EQ(expected, measured): expected == measuredh](h)}(h**Parameters**h]jO)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj2h]hexpected}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMhjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jihjGhMhj)ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hjkh]hseen}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjeubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jihjhMhj)ubeh}(h]h ]h"]h$]h&]uh1jdhj ubh)}(h**Description**h]jO)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj ubh)}(h3ASSERT_EQ(expected, measured): expected == measuredh]h3ASSERT_EQ(expected, measured): expected == measured}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_NE (C macro) c.ASSERT_NEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_NEh]j)}(h ASSERT_NEh]j)}(h ASSERT_NEh]j)}(hjh]h ASSERT_NE}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM ubah}(h]h ]h"]h$]h&]jjjuh1jjjhjhhhjhM ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhjhM hjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhM ubeh}(h]h ](j macroeh"]h$]h&]j&j j'jj(jj)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_NE (expected, seen)``h]j)}(hj!h]hASSERT_NE (expected, seen)}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_NE(expected, measured): expected != measuredh](h)}(h**Parameters**h]jO)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj;ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj7ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj\h]hexpected}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjVubj)}(hhh]h)}(hexpected valueh]hexpected value}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhMhjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jihjqhMhjSubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hjh]hseen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhMhjSubeh}(h]h ]h"]h$]h&]uh1jdhj7ubh)}(h**Description**h]jO)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj7ubh)}(h3ASSERT_NE(expected, measured): expected != measuredh]h3ASSERT_NE(expected, measured): expected != measured}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_LT (C macro) c.ASSERT_LThNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_LTh]j)}(h ASSERT_LTh]j)}(h ASSERT_LTh]j)}(hjh]h ASSERT_LT}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj hhhj,hMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhj,hMhj hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj hhhj,hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'jEj(jEj)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_LT (expected, seen)``h]j)}(hjKh]hASSERT_LT (expected, seen)}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_LT(expected, measured): expected < measuredh](h)}(h**Parameters**h]jO)}(hjgh]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjeubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjaubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hjh]hexpected}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjubj)}(hhh]h)}(hexpected valueh]hexpected value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhMhj}ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hjh]hseen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jihjhMhj}ubeh}(h]h ]h"]h$]h&]uh1jdhjaubh)}(h**Description**h]jO)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjaubh)}(h2ASSERT_LT(expected, measured): expected < measuredh]h2ASSERT_LT(expected, measured): expected < measured}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjaubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_LE (C macro) c.ASSERT_LEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_LEh]j)}(h ASSERT_LEh]j)}(h ASSERT_LEh]j)}(hj9 h]h ASSERT_LE}(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj? ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj; hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM#ubah}(h]h ]h"]h$]h&]jjjuh1jjjhj7 hhhjV hM#ubah}(h]j2 ah ](j j eh"]h$]h&]jj)jhuh1jhjV hM#hj4 hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj4 hhhjV hM#ubeh}(h]h ](j macroeh"]h$]h&]j&j j'jo j(jo j)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_LE (expected, seen)``h]j)}(hju h]hASSERT_LE (expected, seen)}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM%hjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_LE(expected, measured): expected <= measuredh](h)}(h**Parameters**h]jO)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM'hj ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj h]hexpected}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM%hj ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM%hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jihj hM%hj ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj h]hseen}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM&hj ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM&hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jihj hM&hj ubeh}(h]h ]h"]h$]h&]uh1jdhj ubh)}(h**Description**h]jO)}(hj$!h]h Description}(hj&!hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj"!ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM(hj ubh)}(h3ASSERT_LE(expected, measured): expected <= measuredh]h3ASSERT_LE(expected, measured): expected <= measured}(hj:!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM$hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_GT (C macro) c.ASSERT_GThNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_GTh]j)}(h ASSERT_GTh]j)}(h ASSERT_GTh]j)}(hjc!h]h ASSERT_GT}(hjm!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji!ubah}(h]h ](jjeh"]h$]h&]jjuh1jhje!hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM.ubah}(h]h ]h"]h$]h&]jjjuh1jjjhja!hhhj!hM.ubah}(h]j\!ah ](j j eh"]h$]h&]jj)jhuh1jhj!hM.hj^!hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj^!hhhj!hM.ubeh}(h]h ](j macroeh"]h$]h&]j&j j'j!j(j!j)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_GT (expected, seen)``h]j)}(hj!h]hASSERT_GT (expected, seen)}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM0hjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_GT(expected, measured): expected > measuredh](h)}(h**Parameters**h]jO)}(hj!h]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj!ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM2hj!ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj!h]hexpected}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM0hj!ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM0hj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jihj!hM0hj!ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj"h]hseen}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM1hj "ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj,"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj("hM1hj)"ubah}(h]h ]h"]h$]h&]uh1jhj "ubeh}(h]h ]h"]h$]h&]uh1jihj("hM1hj!ubeh}(h]h ]h"]h$]h&]uh1jdhj!ubh)}(h**Description**h]jO)}(hjN"h]h Description}(hjP"hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjL"ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM3hj!ubh)}(h2ASSERT_GT(expected, measured): expected > measuredh]h2ASSERT_GT(expected, measured): expected > measured}(hjd"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM/hj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_GE (C macro) c.ASSERT_GEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_GEh]j)}(h ASSERT_GEh]j)}(h ASSERT_GEh]j)}(hj"h]h ASSERT_GE}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj"hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM9ubah}(h]h ]h"]h$]h&]jjjuh1jjjhj"hhhj"hM9ubah}(h]j"ah ](j j eh"]h$]h&]jj)jhuh1jhj"hM9hj"hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj"hhhj"hM9ubeh}(h]h ](j macroeh"]h$]h&]j&j j'j"j(j"j)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_GE (expected, seen)``h]j)}(hj"h]hASSERT_GE (expected, seen)}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM;hjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_GE(expected, measured): expected >= measuredh](h)}(h**Parameters**h]jO)}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj"ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM=hj"ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj#h]hexpected}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM;hj"ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hM;hj#ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jihj#hM;hj"ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj=#h]hseen}(hj?#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;#ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM<hj7#ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjV#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjR#hM<hjS#ubah}(h]h ]h"]h$]h&]uh1jhj7#ubeh}(h]h ]h"]h$]h&]uh1jihjR#hM<hj"ubeh}(h]h ]h"]h$]h&]uh1jdhj"ubh)}(h**Description**h]jO)}(hjx#h]h Description}(hjz#hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjv#ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM>hj"ubh)}(h3ASSERT_GE(expected, measured): expected >= measuredh]h3ASSERT_GE(expected, measured): expected >= measured}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM:hj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_NULL (C macro) c.ASSERT_NULLhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_NULLh]j)}(h ASSERT_NULLh]j)}(h ASSERT_NULLh]j)}(hj#h]h ASSERT_NULL}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj#hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMDubah}(h]h ]h"]h$]h&]jjjuh1jjjhj#hhhj#hMDubah}(h]j#ah ](j j eh"]h$]h&]jj)jhuh1jhj#hMDhj#hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj#hhhj#hMDubeh}(h]h ](j macroeh"]h$]h&]j&j j'j#j(j#j)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_NULL (seen)``h]j)}(hj#h]hASSERT_NULL (seen)}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMFhjhhubjE)}(hc**Parameters** ``seen`` measured value **Description** ASSERT_NULL(measured): NULL == measuredh](h)}(h**Parameters**h]jO)}(hj$h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj $ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMHhj $ubje)}(hhh]jj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj.$h]hseen}(hj0$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,$ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMFhj($ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjG$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjC$hMFhjD$ubah}(h]h ]h"]h$]h&]uh1jhj($ubeh}(h]h ]h"]h$]h&]uh1jihjC$hMFhj%$ubah}(h]h ]h"]h$]h&]uh1jdhj $ubh)}(h**Description**h]jO)}(hji$h]h Description}(hjk$hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjg$ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMHhj $ubh)}(h'ASSERT_NULL(measured): NULL == measuredh]h'ASSERT_NULL(measured): NULL == measured}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMEhj $ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_TRUE (C macro) c.ASSERT_TRUEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_TRUEh]j)}(h ASSERT_TRUEh]j)}(h ASSERT_TRUEh]j)}(hj$h]h ASSERT_TRUE}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj$hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMNubah}(h]h ]h"]h$]h&]jjjuh1jjjhj$hhhj$hMNubah}(h]j$ah ](j j eh"]h$]h&]jj)jhuh1jhj$hMNhj$hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj$hhhj$hMNubeh}(h]h ](j macroeh"]h$]h&]j&j j'j$j(j$j)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_TRUE (seen)``h]j)}(hj$h]hASSERT_TRUE (seen)}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMPhjhhubjE)}(h`**Parameters** ``seen`` measured value **Description** ASSERT_TRUE(measured): measured != 0h](h)}(h**Parameters**h]jO)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj$ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMRhj$ubje)}(hhh]jj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj%h]hseen}(hj!%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMPhj%ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj8%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4%hMPhj5%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jihj4%hMPhj%ubah}(h]h ]h"]h$]h&]uh1jdhj$ubh)}(h**Description**h]jO)}(hjZ%h]h Description}(hj\%hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjX%ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMRhj$ubh)}(h$ASSERT_TRUE(measured): measured != 0h]h$ASSERT_TRUE(measured): measured != 0}(hjp%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMOhj$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_FALSE (C macro)c.ASSERT_FALSEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_FALSEh]j)}(h ASSERT_FALSEh]j)}(h ASSERT_FALSEh]j)}(hj%h]h ASSERT_FALSE}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj%hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMXubah}(h]h ]h"]h$]h&]jjjuh1jjjhj%hhhj%hMXubah}(h]j%ah ](j j eh"]h$]h&]jj)jhuh1jhj%hMXhj%hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj%hhhj%hMXubeh}(h]h ](j macroeh"]h$]h&]j&j j'j%j(j%j)j*j+uh1jhhhjhNhNubh)}(h``ASSERT_FALSE (seen)``h]j)}(hj%h]hASSERT_FALSE (seen)}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMZhjhhubjE)}(ha**Parameters** ``seen`` measured value **Description** ASSERT_FALSE(measured): measured == 0h](h)}(h**Parameters**h]jO)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj%ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM\hj%ubje)}(hhh]jj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj&h]hseen}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMZhj &ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj)&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%&hMZhj&&ubah}(h]h ]h"]h$]h&]uh1jhj &ubeh}(h]h ]h"]h$]h&]uh1jihj%&hMZhj&ubah}(h]h ]h"]h$]h&]uh1jdhj%ubh)}(h**Description**h]jO)}(hjK&h]h Description}(hjM&hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjI&ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhM\hj%ubh)}(h%ASSERT_FALSE(measured): measured == 0h]h%ASSERT_FALSE(measured): measured == 0}(hja&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMYhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_STREQ (C macro)c.ASSERT_STREQhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_STREQh]j)}(h ASSERT_STREQh]j)}(h ASSERT_STREQh]j)}(hj&h]h ASSERT_STREQ}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj&hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMbubah}(h]h ]h"]h$]h&]jjjuh1jjjhj&hhhj&hMbubah}(h]j&ah ](j j eh"]h$]h&]jj)jhuh1jhj&hMbhj&hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj&hhhj&hMbubeh}(h]h ](j macroeh"]h$]h&]j&j j'j&j(j&j)j*j+uh1jhhhjhNhNubh)}(h!``ASSERT_STREQ (expected, seen)``h]j)}(hj&h]hASSERT_STREQ (expected, seen)}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMdhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_STREQ(expected, measured): !strcmp(expected, measured)h](h)}(h**Parameters**h]jO)}(hj&h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj&ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMfhj&ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj'h]hexpected}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMdhj&ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMdhj'ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jihj'hMdhj&ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj:'h]hseen}(hj<'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8'ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMehj4'ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjS'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjO'hMehjP'ubah}(h]h ]h"]h$]h&]uh1jhj4'ubeh}(h]h ]h"]h$]h&]uh1jihjO'hMehj&ubeh}(h]h ]h"]h$]h&]uh1jdhj&ubh)}(h**Description**h]jO)}(hju'h]h Description}(hjw'hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjs'ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMghj&ubh)}(h=ASSERT_STREQ(expected, measured): !strcmp(expected, measured)h]h=ASSERT_STREQ(expected, measured): !strcmp(expected, measured)}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMchj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jASSERT_STRNE (C macro)c.ASSERT_STRNEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ASSERT_STRNEh]j)}(h ASSERT_STRNEh]j)}(h ASSERT_STRNEh]j)}(hj'h]h ASSERT_STRNE}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj'hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMmubah}(h]h ]h"]h$]h&]jjjuh1jjjhj'hhhj'hMmubah}(h]j'ah ](j j eh"]h$]h&]jj)jhuh1jhj'hMmhj'hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj'hhhj'hMmubeh}(h]h ](j macroeh"]h$]h&]j&j j'j'j(j'j)j*j+uh1jhhhjhNhNubh)}(h!``ASSERT_STRNE (expected, seen)``h]j)}(hj'h]hASSERT_STRNE (expected, seen)}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMohjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** ASSERT_STRNE(expected, measured): strcmp(expected, measured)h](h)}(h**Parameters**h]jO)}(hj (h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj (ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMqhj(ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj+(h]hexpected}(hj-(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)(ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMohj%(ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hjD(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@(hMohjA(ubah}(h]h ]h"]h$]h&]uh1jhj%(ubeh}(h]h ]h"]h$]h&]uh1jihj@(hMohj"(ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hjd(h]hseen}(hjf(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjb(ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMphj^(ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj}(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjy(hMphjz(ubah}(h]h ]h"]h$]h&]uh1jhj^(ubeh}(h]h ]h"]h$]h&]uh1jihjy(hMphj"(ubeh}(h]h ]h"]h$]h&]uh1jdhj(ubh)}(h**Description**h]jO)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj(ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMrhj(ubh)}(h*j(j>*j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_NE (expected, seen)``h]j)}(hjD*h]hEXPECT_NE (expected, seen)}(hjF*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB*ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_NE(expected, measured): expected != measuredh](h)}(h**Parameters**h]jO)}(hj`*h]h Parameters}(hjb*hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj^*ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjZ*ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj*h]hexpected}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}*ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjy*ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj*ubah}(h]h ]h"]h$]h&]uh1jhjy*ubeh}(h]h ]h"]h$]h&]uh1jihj*hMhjv*ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj*h]hseen}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj*ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jihj*hMhjv*ubeh}(h]h ]h"]h$]h&]uh1jdhjZ*ubh)}(h**Description**h]jO)}(hj*h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj*ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjZ*ubh)}(h3EXPECT_NE(expected, measured): expected != measuredh]h3EXPECT_NE(expected, measured): expected != measured}(hj +hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjZ*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_LT (C macro) c.EXPECT_LThNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_LTh]j)}(h EXPECT_LTh]j)}(h EXPECT_LTh]j)}(hj2+h]h EXPECT_LT}(hj<+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8+ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj4+hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj0+hhhjO+hMubah}(h]j++ah ](j j eh"]h$]h&]jj)jhuh1jhjO+hMhj-+hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj-+hhhjO+hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'jh+j(jh+j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_LT (expected, seen)``h]j)}(hjn+h]hEXPECT_LT (expected, seen)}(hjp+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjl+ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_LT(expected, measured): expected < measuredh](h)}(h**Parameters**h]jO)}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj+ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj+ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj+h]hexpected}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj+ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jihj+hMhj+ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj+h]hseen}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj+ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hMhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jihj+hMhj+ubeh}(h]h ]h"]h$]h&]uh1jdhj+ubh)}(h**Description**h]jO)}(hj,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj,ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj+ubh)}(h2EXPECT_LT(expected, measured): expected < measuredh]h2EXPECT_LT(expected, measured): expected < measured}(hj3,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_LE (C macro) c.EXPECT_LEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_LEh]j)}(h EXPECT_LEh]j)}(h EXPECT_LEh]j)}(hj\,h]h EXPECT_LE}(hjf,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjb,ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj^,hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhjZ,hhhjy,hMubah}(h]jU,ah ](j j eh"]h$]h&]jj)jhuh1jhjy,hMhjW,hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjW,hhhjy,hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j,j(j,j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_LE (expected, seen)``h]j)}(hj,h]hEXPECT_LE (expected, seen)}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_LE(expected, measured): expected <= measuredh](h)}(h**Parameters**h]jO)}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj,ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj,h]hexpected}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jihj,hMhj,ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj -h]hseen}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj -ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj-ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj%-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!-hMhj"-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jihj!-hMhj,ubeh}(h]h ]h"]h$]h&]uh1jdhj,ubh)}(h**Description**h]jO)}(hjG-h]h Description}(hjI-hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjE-ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,ubh)}(h3EXPECT_LE(expected, measured): expected <= measuredh]h3EXPECT_LE(expected, measured): expected <= measured}(hj]-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_GT (C macro) c.EXPECT_GThNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_GTh]j)}(h EXPECT_GTh]j)}(h EXPECT_GTh]j)}(hj-h]h EXPECT_GT}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj-hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj-hhhj-hMubah}(h]j-ah ](j j eh"]h$]h&]jj)jhuh1jhj-hMhj-hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj-hhhj-hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j-j(j-j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_GT (expected, seen)``h]j)}(hj-h]hEXPECT_GT (expected, seen)}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_GT(expected, measured): expected > measuredh](h)}(h**Parameters**h]jO)}(hj-h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj-ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj-ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj-h]hexpected}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj-ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jihj.hMhj-ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj6.h]hseen}(hj8.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4.ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj0.ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjO.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjK.hMhjL.ubah}(h]h ]h"]h$]h&]uh1jhj0.ubeh}(h]h ]h"]h$]h&]uh1jihjK.hMhj-ubeh}(h]h ]h"]h$]h&]uh1jdhj-ubh)}(h**Description**h]jO)}(hjq.h]h Description}(hjs.hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjo.ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj-ubh)}(h2EXPECT_GT(expected, measured): expected > measuredh]h2EXPECT_GT(expected, measured): expected > measured}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_GE (C macro) c.EXPECT_GEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_GEh]j)}(h EXPECT_GEh]j)}(h EXPECT_GEh]j)}(hj.h]h EXPECT_GE}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj.hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj.hhhj.hMubah}(h]j.ah ](j j eh"]h$]h&]jj)jhuh1jhj.hMhj.hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj.hhhj.hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j.j(j.j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_GE (expected, seen)``h]j)}(hj.h]hEXPECT_GE (expected, seen)}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_GE(expected, measured): expected >= measuredh](h)}(h**Parameters**h]jO)}(hj/h]h Parameters}(hj /hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj/ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj/ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj'/h]hexpected}(hj)/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%/ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj!/ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj@/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj= measuredh]h3EXPECT_GE(expected, measured): expected >= measured}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_NULL (C macro) c.EXPECT_NULLhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_NULLh]j)}(h EXPECT_NULLh]j)}(h EXPECT_NULLh]j)}(hj/h]h EXPECT_NULL}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj/hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj/hhhj/hMubah}(h]j/ah ](j j eh"]h$]h&]jj)jhuh1jhj/hMhj/hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj/hhhj/hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j0j(j0j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_NULL (seen)``h]j)}(hj0h]hEXPECT_NULL (seen)}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(hc**Parameters** ``seen`` measured value **Description** EXPECT_NULL(measured): NULL == measuredh](h)}(h**Parameters**h]jO)}(hj20h]h Parameters}(hj40hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj00ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,0ubje)}(hhh]jj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hjQ0h]hseen}(hjS0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjO0ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjK0ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjf0hMhjg0ubah}(h]h ]h"]h$]h&]uh1jhjK0ubeh}(h]h ]h"]h$]h&]uh1jihjf0hMhjH0ubah}(h]h ]h"]h$]h&]uh1jdhj,0ubh)}(h**Description**h]jO)}(hj0h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj0ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,0ubh)}(h'EXPECT_NULL(measured): NULL == measuredh]h'EXPECT_NULL(measured): NULL == measured}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj,0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_TRUE (C macro) c.EXPECT_TRUEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_TRUEh]j)}(h EXPECT_TRUEh]j)}(h EXPECT_TRUEh]j)}(hj0h]h EXPECT_TRUE}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj0hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj0hhhj0hMubah}(h]j0ah ](j j eh"]h$]h&]jj)jhuh1jhj0hMhj0hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj0hhhj0hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j1j(j1j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_TRUE (seen)``h]j)}(hj1h]hEXPECT_TRUE (seen)}(hj 1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h`**Parameters** ``seen`` measured value **Description** EXPECT_TRUE(measured): 0 != measuredh](h)}(h**Parameters**h]jO)}(hj#1h]h Parameters}(hj%1hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj!1ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj1ubje)}(hhh]jj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hjB1h]hseen}(hjD1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@1ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj<1ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj[1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjW1hMhjX1ubah}(h]h ]h"]h$]h&]uh1jhj<1ubeh}(h]h ]h"]h$]h&]uh1jihjW1hMhj91ubah}(h]h ]h"]h$]h&]uh1jdhj1ubh)}(h**Description**h]jO)}(hj}1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj{1ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj1ubh)}(h$EXPECT_TRUE(measured): 0 != measuredh]h$EXPECT_TRUE(measured): 0 != measured}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_FALSE (C macro)c.EXPECT_FALSEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_FALSEh]j)}(h EXPECT_FALSEh]j)}(h EXPECT_FALSEh]j)}(hj1h]h EXPECT_FALSE}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj1hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj1hhhj1hMubah}(h]j1ah ](j j eh"]h$]h&]jj)jhuh1jhj1hMhj1hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj1hhhj1hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j1j(j1j)j*j+uh1jhhhjhNhNubh)}(h``EXPECT_FALSE (seen)``h]j)}(hj1h]hEXPECT_FALSE (seen)}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(ha**Parameters** ``seen`` measured value **Description** EXPECT_FALSE(measured): 0 == measuredh](h)}(h**Parameters**h]jO)}(hj2h]h Parameters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj2ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj2ubje)}(hhh]jj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj32h]hseen}(hj52hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj12ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj-2ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjL2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjH2hMhjI2ubah}(h]h ]h"]h$]h&]uh1jhj-2ubeh}(h]h ]h"]h$]h&]uh1jihjH2hMhj*2ubah}(h]h ]h"]h$]h&]uh1jdhj2ubh)}(h**Description**h]jO)}(hjn2h]h Description}(hjp2hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhjl2ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj2ubh)}(h%EXPECT_FALSE(measured): 0 == measuredh]h%EXPECT_FALSE(measured): 0 == measured}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_STREQ (C macro)c.EXPECT_STREQhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_STREQh]j)}(h EXPECT_STREQh]j)}(h EXPECT_STREQh]j)}(hj2h]h EXPECT_STREQ}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj2hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj2hhhj2hMubah}(h]j2ah ](j j eh"]h$]h&]jj)jhuh1jhj2hMhj2hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj2hhhj2hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j2j(j2j)j*j+uh1jhhhjhNhNubh)}(h!``EXPECT_STREQ (expected, seen)``h]j)}(hj2h]hEXPECT_STREQ (expected, seen)}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_STREQ(expected, measured): !strcmp(expected, measured)h](h)}(h**Parameters**h]jO)}(hj3h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj3ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj2ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hj$3h]hexpected}(hj&3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"3ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj3ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hj=3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj93hMhj:3ubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jihj93hMhj3ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj]3h]hseen}(hj_3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[3ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjW3ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hjv3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjr3hMhjs3ubah}(h]h ]h"]h$]h&]uh1jhjW3ubeh}(h]h ]h"]h$]h&]uh1jihjr3hMhj3ubeh}(h]h ]h"]h$]h&]uh1jdhj2ubh)}(h**Description**h]jO)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj3ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj2ubh)}(h=EXPECT_STREQ(expected, measured): !strcmp(expected, measured)h]h=EXPECT_STREQ(expected, measured): !strcmp(expected, measured)}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jDhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jEXPECT_STRNE (C macro)c.EXPECT_STRNEhNtauh1jhjhhhNhNubj)}(hhh](j)}(h EXPECT_STRNEh]j)}(h EXPECT_STRNEh]j)}(h EXPECT_STRNEh]j)}(hj3h]h EXPECT_STRNE}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj3hhhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMubah}(h]h ]h"]h$]h&]jjjuh1jjjhj3hhhj3hMubah}(h]j3ah ](j j eh"]h$]h&]jj)jhuh1jhj3hMhj3hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj3hhhj3hMubeh}(h]h ](j macroeh"]h$]h&]j&j j'j 4j(j 4j)j*j+uh1jhhhjhNhNubh)}(h!``EXPECT_STRNE (expected, seen)``h]j)}(hj4h]hEXPECT_STRNE (expected, seen)}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjhhubjE)}(h**Parameters** ``expected`` expected value ``seen`` measured value **Description** EXPECT_STRNE(expected, measured): strcmp(expected, measured)h](h)}(h**Parameters**h]jO)}(hj/4h]h Parameters}(hj14hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj-4ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj)4ubje)}(hhh](jj)}(h``expected`` expected value h](jp)}(h ``expected``h]j)}(hjN4h]hexpected}(hjP4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL4ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhjH4ubj)}(hhh]h)}(hexpected valueh]hexpected value}(hjg4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjc4hMhjd4ubah}(h]h ]h"]h$]h&]uh1jhjH4ubeh}(h]h ]h"]h$]h&]uh1jihjc4hMhjE4ubjj)}(h``seen`` measured value h](jp)}(h``seen``h]j)}(hj4h]hseen}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1johp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj4ubj)}(hhh]h)}(hmeasured valueh]hmeasured value}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jihj4hMhjE4ubeh}(h]h ]h"]h$]h&]uh1jdhj)4ubh)}(h**Description**h]jO)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jNhj4ubah}(h]h ]h"]h$]h&]uh1hhp/var/lib/git/docbuild/linux/Documentation/dev-tools/kselftest:505: ./tools/testing/selftests/kselftest_harness.hhMhj)4ubh)}(h