2 # SPDX-License-Identifier: GPL-2.0
4 # This scripts adds local version information from the version
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>.
16 echo "Usage: $0 [--no-local] [srctree]" >&2
21 if test "$1" = "--no-local"; then
27 if test $# -gt 0; then
31 if test $# -gt 0 -o ! -d "$srctree"; then
38 # Is $tag an annotated tag?
39 if [ "$(git cat-file -t "$tag" 2> /dev/null)" != tag ]; then
43 # Is it an ancestor of HEAD, and if so, how many commits are in $tag..HEAD?
44 # shellcheck disable=SC2046 # word splitting is the point here
45 set -- $(git rev-list --count --left-right "$tag"...HEAD 2> /dev/null)
47 # $1 is 0 if and only if $tag is an ancestor of HEAD. Use
48 # string comparison, because $1 is empty if the 'git rev-list'
49 # command somehow failed.
50 if [ "$1" != 0 ]; then
54 # $2 is the number of commits in the range $tag..HEAD, possibly 0.
77 if test -n "$(git rev-parse --show-cdup 2>/dev/null)"; then
81 if ! head=$(git rev-parse --verify HEAD 2>/dev/null); then
85 # mainline kernel: 6.2.0-rc5 -> v6.2-rc5
86 # stable kernel: 6.1.7 -> v6.1.7
87 version_tag=v$(echo "${KERNELVERSION}" | sed -E 's/^([0-9]+\.[0-9]+)\.0(.*)$/\1\2/')
89 # try_tag initializes count if the tag is usable.
92 # If a localversion* file exists, and the corresponding
93 # annotated tag exists and is an ancestor of HEAD, use
94 # it. This is the case in linux-next.
95 if [ -n "${file_localversion#-}" ] ; then
96 try_tag "${file_localversion#-}"
99 # Otherwise, if a localversion* file exists, and the tag
100 # obtained by appending it to the tag derived from
101 # KERNELVERSION exists and is an ancestor of HEAD, use
102 # it. This is e.g. the case in linux-rt.
103 if [ -z "${count}" ] && [ -n "${file_localversion}" ]; then
104 try_tag "${version_tag}${file_localversion}"
107 # Otherwise, default to the annotated tag derived from KERNELVERSION.
108 if [ -z "${count}" ]; then
109 try_tag "${version_tag}"
112 # If we are at the tagged commit, we ignore it because the
113 # version is well-defined. If none of the attempted tags exist
114 # or were usable, $count is still empty.
115 if [ -z "${count}" ] || [ "${count}" -gt 0 ]; then
117 # If only the short version is requested, don't bother
118 # running further git commands
124 # If we are past the tagged commit, we pretty print it.
125 # (like 6.1.0-14595-g292a089d78d3)
126 if [ -n "${count}" ]; then
127 printf "%s%05d" "-" "${count}"
130 # Add -g and exactly 12 hex chars.
131 printf '%s%.12s' -g "$head"
138 # Check for uncommitted changes.
139 # This script must avoid any write attempt to the source tree, which
140 # might be read-only.
141 # You cannot use 'git describe --dirty' because it tries to create
143 # First, with git-status, but --no-optional-locks is only supported in
144 # git >= 2.14, so fall back to git-diff-index if it fails. Note that
145 # git-diff-index does not refresh the index, so it may give misleading
147 # See git-update-index(1), git-diff-index(1), and git-status(1).
149 git --no-optional-locks status -uno --porcelain 2>/dev/null ||
150 git diff-index --name-only HEAD
166 if test -e "$file"; then
167 res="$res$(cat "$file")"
173 if [ -z "${KERNELVERSION}" ]; then
174 echo "KERNELVERSION is not set" >&2
178 # localversion* files in the build and source directory
179 file_localversion="$(collect_files localversion*)"
180 if test ! "$srctree" -ef .; then
181 file_localversion="${file_localversion}$(collect_files "$srctree"/localversion*)"
185 echo "${KERNELVERSION}$(scm_version --no-dirty)"
189 if ! test -e include/config/auto.conf; then
190 echo "Error: kernelrelease not valid - run 'make prepare' to update it" >&2
194 # version string from CONFIG_LOCALVERSION
195 config_localversion=$(sed -n 's/^CONFIG_LOCALVERSION=\(.*\)$/\1/p' include/config/auto.conf)
197 # scm version string if not at the kernel version tag or at the file_localversion
198 if grep -q "^CONFIG_LOCALVERSION_AUTO=y$" include/config/auto.conf; then
199 # full scm version string
200 scm_version="$(scm_version)"
201 elif [ "${LOCALVERSION+set}" != "set" ]; then
202 # If the variable LOCALVERSION is not set, append a plus
203 # sign if the repository is not in a clean annotated or
204 # signed tagged state (as git describe only looks at signed
205 # or annotated tags - git tag -a/-s).
207 # If the variable LOCALVERSION is set (including being set
208 # to an empty string), we don't want to append a plus sign.
209 scm_version="$(scm_version --short)"
212 echo "${KERNELVERSION}${file_localversion}${config_localversion}${LOCALVERSION}${scm_version}"