[PATCH] kbuild: add documentation of KBUILD_BUILD_VERSION

Nicholas Mc Guire
2015-04-05T06:52:34Z

KBUILD_BUILD_VERSION is currently not documented but it is
needed when rebuilding a kernel that should result in the identical
binary. This is a brief documentation of KBUILD_BUILD_VERSION.

Signed-off-by: Nicholas Mc Guire <hofrat@osadl.org>
---

Patch is against 4.0-rc6 (localversion-next is -next-20150402)

Documentation/kbuild/kbuild.txt | 8 ++++++++
1 file changed, 8 insertions(+)

diff --git a/Documentation/kbuild/kbuild.txt b/Documentation/kbuild/kbuild.txt
index 6466704..7ad01d9 100644
--- a/Documentation/kbuild/kbuild.txt
+++ b/Documentation/kbuild/kbuild.txt
@@ -213,6 +213,14 @@ UTS_VERSION definition (uname -v in the running kernel). The value has to
be a string that can be passed to date -d. The default value
is the output of the date command at one point during build.

+KBUILD_BUILD_VERSION
+--------------------------------------------------
+Setting this to an integer overrides the build version number used in the
+UTS_VERSION definition (uname -v in the running kernel shown as e.g. #1).
+The default value is set to 0 if .version does not yet exist and is
+generated by incrementing the current value in .version by one if it
+already exists.
+
KBUILD_BUILD_USER, KBUILD_BUILD_HOST
--------------------------------------------------
These two variables allow to override the user@host string displayed during
--
1.7.10.4