dirty 태그 제거

테스트 환경

• Ubuntu 22.04
• SK-AM62A-LP
• 09_02_00_05 Processor SDK

SDK 빌드를 진행하다 보면 커널 버전이나 드라이버 모듈 정보에 "dirty" 태그가 붙는 것을 확인할 수 있다.

Git 버전 관리 시스템에서 트래킹하는 커널 소스 파일이 변경되었거나, 새로운 파일이 추가되었지만 아직 커밋되지 않은 경우 "dirty" 태그가 붙게된다.

 

커널 소스를 빌드할 때, 빌드된 커널의 버전 문자열(uname -r로 확인 가능)에 "dirty"라는 태그가 추가되고, 이 태그는 빌드 당시 커널 소스가 수정된 상태였음을 표시한다.

 

아래 BSP 파일안에 setlocaleverion이라는 스크립트 파일이 있는데, 파일 내 scm_version 함수 에서 "dirty" 태그를 붙게 한다. 이 스크립트는 Git 또는 다른 SCM 툴의 상태를 확인하고 적절한 버전 문자열을 생성한다.

#!/bin/sh
# SPDX-License-Identifier: GPL-2.0
#
# This scripts adds local version information from the version
# control systems git, mercurial (hg) and subversion (svn).
#
# If something goes wrong, send a mail the kernel build mailinglist
# (see MAINTAINERS) and CC Nico Schottelius
# <nico-linuxsetlocalversion -at- schottelius.org>.
#
#

usage() {
	echo "Usage: $0 [--save-scmversion] [srctree]" >&2
	exit 1
}

scm_only=false
srctree=.
if test "$1" = "--save-scmversion"; then
	scm_only=true
	shift
fi
if test $# -gt 0; then
	srctree=$1
	shift
fi
if test $# -gt 0 -o ! -d "$srctree"; then
	usage
fi

scm_version()
{
	local short
	short=false

	cd "$srctree"
	if test -e .scmversion; then
		cat .scmversion
		return
	fi
	if test "$1" = "--short"; then
		short=true
	fi

	# Check for git and a git repo.
	if test -z "$(git rev-parse --show-cdup 2>/dev/null)" &&
	   head=$(git rev-parse --verify HEAD 2>/dev/null); then

		# If we are at a tagged commit (like "v2.6.30-rc6"), we ignore
		# it, because this version is defined in the top level Makefile.
		if [ -z "$(git describe --exact-match 2>/dev/null)" ]; then

			# If only the short version is requested, don't bother
			# running further git commands
			if $short; then
				echo "+"
				return
			fi
			# If we are past a tagged commit (like
			# "v2.6.30-rc5-302-g72357d5"), we pretty print it.
			if atag="$(git describe 2>/dev/null)"; then
				echo "$atag" | awk -F- '{printf("-%05d", $(NF-1))}'
			fi

			# Add -g and exactly 12 hex chars.
			printf '%s%s' -g "$(echo $head | cut -c1-12)"
		fi

		# Check for uncommitted changes.
		# This script must avoid any write attempt to the source tree,
		# which might be read-only.
		# You cannot use 'git describe --dirty' because it tries to
		# create .git/index.lock .
		# First, with git-status, but --no-optional-locks is only
		# supported in git >= 2.14, so fall back to git-diff-index if
		# it fails. Note that git-diff-index does not refresh the
		# index, so it may give misleading results. See
		# git-update-index(1), git-diff-index(1), and git-status(1).
		if {
			git --no-optional-locks status -uno --porcelain 2>/dev/null ||
			git diff-index --name-only HEAD
		} | read dummy; then
			printf '%s' -dirty
		fi
	fi
}

collect_files()
{
	local file res=

	for file; do
		case "$file" in
		*\~*)
			continue
			;;
		esac
		if test -e "$file"; then
			res="$res$(cat "$file")"
		fi
	done
	echo "$res"
}

if $scm_only; then
	if test ! -e .scmversion; then
		res=$(scm_version)
		echo "$res" >.scmversion
	fi
	exit
fi

if ! test -e include/config/auto.conf; then
	echo "Error: kernelrelease not valid - run 'make prepare' to update it" >&2
	exit 1
fi

# localversion* files in the build and source directory
res="$(collect_files localversion*)"
if test ! "$srctree" -ef .; then
	res="$res$(collect_files "$srctree"/localversion*)"
fi

# CONFIG_LOCALVERSION and LOCALVERSION (if set)
config_localversion=$(sed -n 's/^CONFIG_LOCALVERSION=\(.*\)$/\1/p' include/config/auto.conf)
res="${res}${config_localversion}${LOCALVERSION}"

# scm version string if not at a tagged commit

if grep -q "^CONFIG_LOCALVERSION_AUTO=y$" include/config/auto.conf; then
	# full scm version string
	res="$res$(scm_version)"
elif [ "${LOCALVERSION+set}" != "set" ]; then
	# If the variable LOCALVERSION is not set, append a plus
	# sign if the repository is not in a clean annotated or
	# signed tagged state (as git describe only looks at signed
	# or annotated tags - git tag -a/-s).
	#
	# If the variable LOCALVERSION is set (including being set
	# to an empty string), we don't want to append a plus sign.
	scm=$(scm_version --short)
	res="$res${scm:++}"
fi

echo "$res"

실제로 커널을 빌드하고 생긴 폴더를 보면 기존 폴더와 달리 아래와 같이 "dirty" 태그가 붙은 폴더가 생성된다. 이로 인해 모듈 등록 시 충돌이 일어나는 경우가 있다.

 

auto.conf 설정 파일 내 CONFIG_LOCALVERSION_AUTO 옵션이 활성화되면, scmversion을 사용해 자동으로 버전을 설정하게 된다.

 

해당 dirty 태그를 없애려면, 상단 스크립트 파일 내 태그 붙이는 부분을 아래와 같이 주석을 건다. 아래 코드는 auto.conf 파일 내 CONFIG_LOCALVERSION_AUTO 항목을 "y" 값으로 변경하는 내용이다. auto.conf 파일 내에서 직접 변경해도 아래 파일에서 다시 재 변경하기 때문에 파일에서 변경해주어야 한다.

: <<'END'
if grep -q "^CONFIG_LOCALVERSION_AUTO=y$" include/config/auto.conf; then
	# full scm version string
	res="$res$(scm_version)"
elif [ "${LOCALVERSION+set}" != "set" ]; then
	# If the variable LOCALVERSION is not set, append a plus
	# sign if the repository is not in a clean annotated or
	# signed tagged state (as git describe only looks at signed
	# or annotated tags - git tag -a/-s).
	#
	# If the variable LOCALVERSION is set (including being set
	# to an empty string), we don't want to append a plus sign.
	scm=$(scm_version --short)
	res="$res${scm:++}"
fi
END

적용 후 모듈 정보를 확인해 보면 dirty 태그가 사라진 것을 확인할 수 있다.