doc: kselftest: Fix KBUILD_OUTPUT usage instructions
Subsystems (3)
Shuah Khan
maintainerPATCH 1/1 doc: kselftest: Fix KBUILD_OUTPUT usage instructions
Fix KBUILD_OUTPUT usage instructions. The current documentation is incorrect.
--- Documentation/dev-tools/kselftest.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
Documentation/dev-tools/kselftest.rst +4 -4
@@ -39,9 +39,9 @@ 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=):: +Build and run from KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):: - $ make KBUILD_OUTPUT=/tmp/kselftest kselftest + $ export KBUILD_OUTPUT=/tmp/kselftest; make 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
@@ -65,9 +65,9 @@ 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=):: +Build and run from KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):: - $ make KBUILD_OUTPUT=/tmp/kselftest TARGETS="size timers" kselftest + $ export KBUILD_OUTPUT=/tmp/kselftest; make 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
Signature · 1 line
2.17.1
Jonathan Corbet
maintainerQuoted 4 lines · On Tue, 16 Apr 2019 08:26:51 -0600 Shuah Khan <[email protected]> wrote:
Fix
KBUILD_OUTPUTusage instructions. The current documentation is incorrect.Signed-off-by Shuah Khan <shuah at kernel.org>
So I'll confess to being a little confused by this one...
Quoted 8 lines
Documentation/dev-tools/kselftest.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)Documentation/dev-tools/kselftest.rst +0
-0
Documentation/dev-tools/kselftest.rst Build and run from user specific object directory (make O=dir):: · line 44
Quoted 8 lines
Documentation/dev-tools/kselftest.rst +2
-2@@ -39,9 +39,9 @@ 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=):: +Build and run from KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):: - $ make KBUILD_OUTPUT=/tmp/kselftest kselftest + $ export KBUILD_OUTPUT=/tmp/kselftest; make kselftest
Is there a particular reason why this variable needs to be set in the environment rather than just in make? More importantly, though, I don't think this would work if you run it from the KBUILD_OUTPUT directory. What you're really doing is running with a separate output directory, right?
Thanks,
jon
shuah
maintainerQuoted 9 lines · Jonathan Corbet
Quoted 4 lines · On Tue, 16 Apr 2019 08:26:51 -0600 Shuah Khan <shuah at kernel.org> wrote:
Fix
KBUILD_OUTPUTusage instructions. The current documentation is incorrect.Signed-off-by Shuah Khan <shuah at kernel.org>So I'll confess to being a little confused by this one...
I generated the patch on a system with older .gitconfig. :)
Quoted 15 lines
Quoted 15 lines
Documentation/dev-tools/kselftest.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)Documentation/dev-tools/kselftest.rst +1
-1@@ -39,9 +39,9 @@ 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=):: +Build and run from KBUILD_OUTPUT directory (make KBUILD_OUTPUT=)::
Quoted 8 lines
Documentation/dev-tools/kselftest.rst Build and run from user specific object directory (make O=dir):: · line 44
Quoted 2 lines
Documentation/dev-tools/kselftest.rst +1
-1- $ make KBUILD_OUTPUT=/tmp/kselftest kselftest + $ export KBUILD_OUTPUT=/tmp/kselftest; make kselftestIs there a particular reason why this variable needs to be set in the environment rather than just in make? More importantly, though, I don't think this would work if you run it from the
KBUILD_OUTPUTdirectory. What you're really doing is running with a separate output directory, right?
That is correct. I am matching the instructions in the main Makefile:
# kbuild supports saving output files in a separate directory. # 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. # 1) O= # Use "make O=dir/to/store/output/files/" #
# 2) Set KBUILD_OUTPUT
# Set the environment variable KBUILD_OUTPUT to point to the directory
# where the output files shall be placed. # export KBUILD_OUTPUT=dir/to/store/output/files/ # make
kselftest documentation doesn't match the main Makefile. I am fixing that with this patch.
For both cases the working directory is the src dir just like the main Makefile.
I hope this helps.
thanks,
-- Shuah
Jonathan Corbet
maintainerQuoted 11 lines · On Tue, 16 Apr 2019 09:50:16 -0600 shuah <[email protected]> wrote:
Quoted 10 lines
Documentation/dev-tools/kselftest.rst Build and run from user specific object directory (make O=dir):: · line 44
Quoted 4 lines
Documentation/dev-tools/kselftest.rst +2
-1+Build and run from KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):: - $ make KBUILD_OUTPUT=/tmp/kselftest kselftest + $ export KBUILD_OUTPUT=/tmp/kselftest; make kselftestIs there a particular reason why this variable needs to be set in the environment rather than just in make? More importantly, though, I don't think this would work if you run it from the
KBUILD_OUTPUTdirectory. What you're really doing is running with a separate output directory, right?
Quoted 3 lines
That is correct. I am matching the instructions in the main
Makefile:# kbuild supports saving output files in a separate directory.
So my concern was right, then: this is not a way to "run from the KBUILD_OUTPUT" directory; that seems certain to confuse people. I'll apply the patch so that the commands are right, but that could maybe use some tweaking.
Thanks,
jon
shuah
maintainerQuoted 14 lines · Jonathan Corbet
Quoted 11 lines · On Tue, 16 Apr 2019 09:50:16 -0600 shuah <[email protected]> wrote:
Quoted 10 lines
Documentation/dev-tools/kselftest.rst Build and run from user specific object directory (make O=dir):: · line 44
Quoted 4 lines
Documentation/dev-tools/kselftest.rst +2
-1+Build and run from KBUILD_OUTPUT directory (make KBUILD_OUTPUT=):: - $ make KBUILD_OUTPUT=/tmp/kselftest kselftest + $ export KBUILD_OUTPUT=/tmp/kselftest; make kselftestIs there a particular reason why this variable needs to be set in the environment rather than just in make? More importantly, though, I don't think this would work if you run it from the
KBUILD_OUTPUTdirectory. What you're really doing is running with a separate output directory, right?
Quoted 9 lines
Quoted 3 lines
That is correct. I am matching the instructions in the main
Makefile:# kbuild supports saving output files in a separate directory.So my concern was right, then: this is not a way to "run from the
KBUILD_OUTPUT" directory; that seems certain to confuse people. I'll apply the patch so that the commands are right, but that could maybe use some tweaking.
Yes. I can see it could confuse people.
I can tweak the wording to add that the working directory is the kernel source dir, and that the command should be run from root of the kernel source repo and send v2. The same changes probably need to be made for the O= case if that isn't clear.
thanks,
-- Shuah