2 # SPDX-License-Identifier: GPL-2.0
4 # This scripts adds local version information from the version
5 # control systems git, mercurial (hg) and subversion (svn).
7 # If something goes wrong, send a mail the kernel build mailinglist
8 # (see MAINTAINERS) and CC Nico Schottelius
9 # <nico-linuxsetlocalversion -at- schottelius.org>.
14 echo "Usage: $0 [--no-local] [srctree]" >&2
19 if test "$1" = "--no-local"; then
25 if test $# -gt 0; then
29 if test $# -gt 0 -o ! -d "$srctree"; then
52 if test -n "$(git rev-parse --show-cdup 2>/dev/null)"; then
56 if ! head=$(git rev-parse --verify HEAD 2>/dev/null); then
60 # If a localversion*' file and the corresponding annotated tag exist,
61 # use it. This is the case in linux-next.
62 tag=${file_localversion#-}
63 tag=$(git describe --exact-match --match=$tag $tag 2>/dev/null)
65 # Otherwise, default to the annotated tag derived from KERNELVERSION.
66 # mainline kernel: 6.2.0-rc5 -> v6.2-rc5
67 # stable kernel: 6.1.7 -> v6.1.7
68 if [ -z "${tag}" ]; then
69 tag=v$(echo "${KERNELVERSION}" | sed -E 's/^([0-9]+\.[0-9]+)\.0(.*)$/\1\2/')
72 # If we are at the tagged commit, we ignore it because the version is
74 if [ -z "$(git describe --exact-match --match=$tag 2>/dev/null)" ]; then
76 # If only the short version is requested, don't bother
77 # running further git commands
82 # If we are past the tagged commit, we pretty print it.
83 # (like 6.1.0-14595-g292a089d78d3)
84 if atag="$(git describe --match=$tag 2>/dev/null)"; then
85 echo "$atag" | awk -F- '{printf("-%05d", $(NF-1))}'
88 # Add -g and exactly 12 hex chars.
89 printf '%s%s' -g "$(echo $head | cut -c1-12)"
96 # Check for uncommitted changes.
97 # This script must avoid any write attempt to the source tree, which
99 # You cannot use 'git describe --dirty' because it tries to create
101 # First, with git-status, but --no-optional-locks is only supported in
102 # git >= 2.14, so fall back to git-diff-index if it fails. Note that
103 # git-diff-index does not refresh the index, so it may give misleading
105 # See git-update-index(1), git-diff-index(1), and git-status(1).
107 git --no-optional-locks status -uno --porcelain 2>/dev/null ||
108 git diff-index --name-only HEAD
124 if test -e "$file"; then
125 res="$res$(cat "$file")"
131 if [ -z "${KERNELVERSION}" ]; then
132 echo "KERNELVERSION is not set" >&2
136 # localversion* files in the build and source directory
137 file_localversion="$(collect_files localversion*)"
138 if test ! "$srctree" -ef .; then
139 file_localversion="${file_localversion}$(collect_files "$srctree"/localversion*)"
143 echo "${KERNELVERSION}$(scm_version --no-dirty)"
147 if ! test -e include/config/auto.conf; then
148 echo "Error: kernelrelease not valid - run 'make prepare' to update it" >&2
152 # version string from CONFIG_LOCALVERSION
153 config_localversion=$(sed -n 's/^CONFIG_LOCALVERSION=\(.*\)$/\1/p' include/config/auto.conf)
155 # scm version string if not at the kernel version tag or at the file_localversion
156 if grep -q "^CONFIG_LOCALVERSION_AUTO=y$" include/config/auto.conf; then
157 # full scm version string
158 scm_version="$(scm_version)"
159 elif [ "${LOCALVERSION+set}" != "set" ]; then
160 # If the variable LOCALVERSION is not set, append a plus
161 # sign if the repository is not in a clean annotated or
162 # signed tagged state (as git describe only looks at signed
163 # or annotated tags - git tag -a/-s).
165 # If the variable LOCALVERSION is set (including being set
166 # to an empty string), we don't want to append a plus sign.
167 scm_version="$(scm_version --short)"
170 echo "${KERNELVERSION}${file_localversion}${config_localversion}${LOCALVERSION}${scm_version}"