All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] doc: dev-tools: kselftest.rst: update to include make O=dir support
@ 2017-10-02 23:44 Shuah Khan
  2017-10-02 23:44 ` [PATCH] doc: enhance dochelp include default output location for doc build Shuah Khan
                   ` (4 more replies)
  0 siblings, 5 replies; 14+ messages in thread
From: Shuah Khan @ 2017-10-02 23:44 UTC (permalink / raw)
  To: shuah, corbet; +Cc: Shuah Khan, linux-kselftest, linux-doc, linux-kernel

Update to include details on make O=dir support and other changes improve
test results output.

Signed-off-by: Shuah Khan <shuahkh@osg.samsung.com>
---
 Documentation/dev-tools/kselftest.rst | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/Documentation/dev-tools/kselftest.rst b/Documentation/dev-tools/kselftest.rst
index ebd03d11d2c2..0aa6dde835d1 100644
--- a/Documentation/dev-tools/kselftest.rst
+++ b/Documentation/dev-tools/kselftest.rst
@@ -31,6 +31,17 @@ To build and run the tests with a single command, use::
 
 Note that some tests will require root privileges.
 
+Build and run from user specific object directory (make O=dir):
+
+  $ make O=/tmp/kselftest kselftest
+
+Build and run KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):
+
+  $ make KBUILD_OUTPUT=/tmp/kselftest kselftest
+
+The above commands run the tests and print pass/fail summary to make it
+easier to understand the test results. Please find the detailed individual
+test results for each test in /tmp/testname file(s).
 
 Running a subset of selftests
 =============================
@@ -46,10 +57,21 @@ You can specify multiple tests to build and run::
 
   $  make TARGETS="size timers" kselftest
 
+Build and run from user specific object directory (make O=dir):
+
+  $ make O=/tmp/kselftest TARGETS="size timers" kselftest
+
+Build and run KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):
+
+  $ make KBUILD_OUTPUT=/tmp/kselftest TARGETS="size timers" kselftest
+
+The above commands run the tests and print pass/fail summary to make it
+easier to understand the test results. Please find the detailed individual
+test results for each test in /tmp/testname file(s).
+
 See the top-level tools/testing/selftests/Makefile for the list of all
 possible targets.
 
-
 Running the full range hotplug selftests
 ========================================
 
@@ -113,9 +135,17 @@ Contributing new tests (details)
  * Use TEST_GEN_XXX if such binaries or files are generated during
    compiling.
 
-   TEST_PROGS, TEST_GEN_PROGS mean it is the excutable tested by
+   TEST_PROGS, TEST_GEN_PROGS mean it is the executable tested by
    default.
 
+   TEST_CUSTOM_PROGS should be used by tests that require custom build
+   rule 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
-- 
2.11.0

^ permalink raw reply related	[flat|nested] 14+ messages in thread
end of thread, other threads:[~2017-10-17 23:58 UTC | newest]

Thread overview: 14+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-10-02 23:44 [PATCH] doc: dev-tools: kselftest.rst: update to include make O=dir support Shuah Khan
2017-10-02 23:44 ` [PATCH] doc: enhance dochelp include default output location for doc build Shuah Khan
2017-10-02 23:44 ` [PATCH] Makefile: enable dochelp run from main make level Shuah Khan
2017-10-07 11:24   ` Masahiro Yamada
2017-10-10 20:09     ` Shuah Khan
2017-10-11  0:54       ` Masahiro Yamada
2017-10-11  0:58         ` Randy Dunlap
2017-10-11  1:06           ` Shuah Khan
2017-10-12 18:15             ` Randy Dunlap
2017-10-17 23:57             ` Masahiro Yamada
2017-10-02 23:44 ` [PATCH] selftests: mqueue: fix regression in silencing output from RUN_TESTS Shuah Khan
2017-10-02 23:44 ` [PATCH] selftests: x86: sysret_ss_attrs doesn't build on a PIE build Shuah Khan
2017-10-12 17:02 ` [PATCH] doc: dev-tools: kselftest.rst: update to include make O=dir support Jonathan Corbet
2017-10-12 17:07   ` Shuah Khan

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.