| Message ID | 7104475f60568f6a580b03d84e61abe311d63e46.1745965121.git.skhan@linuxfoundation.org |
|---|---|
| State | New |
| Headers | show |
| Series | Update kunit doc and tool with tips to build errors | expand |
On 4/29/25 16:29, Randy Dunlap wrote: > > > On 4/29/25 3:27 PM, Shuah Khan wrote: >> If kunit run happens in a tree in which a x86_64 kernel was built, >> the source tree could be dirty. >> >> "make ARCH=um mrproper" will not clean the x86_64 build artifacts. >> Running "make ARCH=x86_64 mrproper" is necessary to clean them. >> >> Add this information to the documentation. >> >> Signed-off-by: Shuah Khan <skhan@linuxfoundation.org> >> --- >> Documentation/dev-tools/kunit/start.rst | 12 ++++++++++++ >> 1 file changed, 12 insertions(+) >> >> diff --git a/Documentation/dev-tools/kunit/start.rst b/Documentation/dev-tools/kunit/start.rst >> index a98235326bab..568e29aebd6e 100644 >> --- a/Documentation/dev-tools/kunit/start.rst >> +++ b/Documentation/dev-tools/kunit/start.rst >> @@ -39,6 +39,18 @@ can run kunit_tool: >> ``make ARCH=um mrproper``, just be aware that this will delete the >> current configuration and all generated files. >> >> + You may see the following error if a prior build leaves behind >> + header files which 'make ARCH=um mrproper' fails to clean: >> + >> + "undefined symbol sev_es_trampoline_start referenced ..." >> + >> + This is special case scenario when a prior x86_64 build populates >> + the source tree with arch/x86/realmode/rm/pasyms.h. This header >> + will not be cleaned by 'make ARCH=um mrproper' >> + >> + If you encouter this problem, run 'make ARCH=x86_64 mrproper' to > > encounter Thank you. Will fix it. thanks, -- Shuah
diff --git a/Documentation/dev-tools/kunit/start.rst b/Documentation/dev-tools/kunit/start.rst index a98235326bab..568e29aebd6e 100644 --- a/Documentation/dev-tools/kunit/start.rst +++ b/Documentation/dev-tools/kunit/start.rst @@ -39,6 +39,18 @@ can run kunit_tool: ``make ARCH=um mrproper``, just be aware that this will delete the current configuration and all generated files. + You may see the following error if a prior build leaves behind + header files which 'make ARCH=um mrproper' fails to clean: + + "undefined symbol sev_es_trampoline_start referenced ..." + + This is special case scenario when a prior x86_64 build populates + the source tree with arch/x86/realmode/rm/pasyms.h. This header + will not be cleaned by 'make ARCH=um mrproper' + + If you encouter this problem, run 'make ARCH=x86_64 mrproper' to + remove generated header files. + If everything worked correctly, you should see the following: .. code-block::
If kunit run happens in a tree in which a x86_64 kernel was built, the source tree could be dirty. "make ARCH=um mrproper" will not clean the x86_64 build artifacts. Running "make ARCH=x86_64 mrproper" is necessary to clean them. Add this information to the documentation. Signed-off-by: Shuah Khan <skhan@linuxfoundation.org> --- Documentation/dev-tools/kunit/start.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+)