Linux 内核编译 LOCALVERSION 配置(分析内核版本号自动添加的“+“号)

已于 2022-11-06 22:33:39 修改
阅读量1.1k 收藏 5
点赞数 4
分类专栏： CentOS Linux 文章标签： linux
于 2022-11-06 22:33:31 首次发布
原文链接：http://news.eeworld.com.cn/mp/ymc/a98850.jspx
版权
Linux 同时被 2 个专栏收录
200 篇文章 26 订阅
订阅专栏
CentOS
23 篇文章 2 订阅
订阅专栏

1 问题发现

编译主线 kernel 版本的时候发现, 的内核版本编译成功后生成的版本号变成了 "x.y.z+", 为什么后面会多一个加号呢?

刚开始考虑是不是 CONFIG_LOCALVERSION 的问题, 配置了 CONFIG_LOCALVERSION, 还是会在内核版本的最后加上一个 "+" 后, 安装完成之后, 每次 uname -a 都会出现 + 后真的感觉很郁闷, 强迫症的我真的受不了.

2 原因分析

问题必然出现在 linux 构建过程中的版本控制这一块, 既然是在构建的过程中添加的, 那我们就可以从 Makefile 中发现一些端倪.

2.1 Makefile 中 LOCALVERSION 信息

VERSION = 2PATCHLEVEL = 6SUBLEVEL = 35EXTRAVERSION = .7NAME = Yokohama

这些是我们内核版本的版本号, 生成出来的版本号理论上不应带 + 号, 但为什么带 + 号呢.

内核中有两个配置宏 CONFIG_LOCALVERSION 和 CONFIG_LOCALVERSION_AUTO 配置了系统内核版本号和后缀的信息.

2.2 Makefile 中读取和设置版本号

我们检索与这两个宏相关的信息, 检查 LOCALVERSION 宏排除 arch/*/configs 和 Documentation 等目录.

scripts/setlocalversion:# CONFIG_LOCALVERSION and LOCALVERSION (if set)scripts/setlocalversion:res="${res}${CONFIG_LOCALVERSION}${LOCALVERSION}"scripts/setlocalversion:if test "$CONFIG_LOCALVERSION_AUTO" = "y"; thenscripts/setlocalversion:  # LOCALVERSION= is not specifiedscripts/setlocalversion:  if test "${LOCALVERSION+set}" != "set"; then

可以看到 scripts/setlocalversion 脚本中读取了相关的信息.

不着急, 我们慢慢分析, 看看 Makefile 是怎么读取和设置这些信息. 继续从 Makefile 中分析 LOVALVERSION 的信息.

define filechk_kernel.release    echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"endef
# Store (new) KERNELRELEASE string in include/config/kernel.releaseinclude/config/kernel.release: include/config/auto.conf FORCE    $(call filechk,kernel.release)

Makefile 使用 scripts/setlocalversion 工具来生成 include/config/kernel.release. “+” 号就是在调用这个脚本时添加的.

那么可以通过执行如下命令生成版本文件

make include/config/kernel.releaseORmake include/generated/utsrelease.h

查看这两个文件的信息就可以看到版本号信息

另外 Makefile 还有如下定义 :

kernelrelease:         @echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"

也可以直接使用如下命令来显示版本号信息

make kernelrelease

2.3 setlocalversion 函数设置版本号信息

阅读 scripts/setlocalversion 文件, 并查阅资料, 做如下笔记 :

# 如果当前内核使用SVN托管, 则只从.scmversion中读取版本号信息if $scm_only; then    if test ! -e .scmversion; then        res=$(scm_version)        echo "$res" >.scmversion    fi    exitfi
# 确认 auto.conf 文件是否存在if test -e include/config/auto.conf; then    . include/config/auto.confelse    echo "Error: kernelrelease not valid - run 'make prepare' to update it" >&2    exit 1fi
# 调用 localversion 从源码根目录下的localversion文件中读取信息# localversion* files in the build and source directoryres="$(collect_files localversion*)"if test ! "$srctree" -ef .; then    res="$res$(collect_files "$srctree"/localversion*)"fi
# 设置 LOCALVERSION 信息# CONFIG_LOCALVERSION and LOCALVERSION (if set)res="${res}${CONFIG_LOCALVERSION}${LOCALVERSION}"
# 调用 scm_version 函数读取后缀信息# scm version string if not at a tagged commitif test "$CONFIG_LOCALVERSION_AUTO" = "y"; then    # full scm version string    res="$res$(scm_version)"else    # 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) and    # LOCALVERSION= is not specified    if test "${LOCALVERSION+set}" != "set"; then        scm=$(scm_version --short)        res="$res${scm:++}"    fifi

2.3.1 LOCALVERSION 的设置

在 scripts/setlocalversion 文件中还有有这么一段 :

# CONFIG_LOCALVERSION and LOCALVERSION (if set)res="${res}${CONFIG_LOCALVERSION}${LOCALVERSION}"

可以发现如果配置了 CONFIG_LOCALVERSION 和 LOCALVERSION 则会在版本号后面意思添加此后缀.

而 res 就是获取到的本地版本号信息, 比如 4.14-rc8

2.3.2 SCM_VERSION 后缀信息的添加

最后根据是否配置了 CONFIG_LOCALVERSION_AUTO 和 CONFIG_LOCALVERSION 宏, 添加版本后缀信息

如果定义了

CONFIG_LOCALVERSION_AUTO=y

此时会执行执行

res="$res$(scm_version)"

其中 res 就是我们的版本号信息, 而 scm_version 函数获取了版本号后缀.

否则如果没有设置 CONFIG_LOCALVERSION_AUTO, 则执行如下片段.

# 调用 scm_version 函数读取后缀信息# scm version string if not at a tagged commitif test "$CONFIG_LOCALVERSION_AUTO" = "y"; then    # full scm version string    res="$res$(scm_version)"else    # 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) and    # LOCALVERSION= is not specified    if test "${LOCALVERSION+set}" != "set"; then        scm=$(scm_version --short)        res="$res${scm:++}"    fifi

对于 setlocalversion 中的一个语法解释一下 :

那么上面的 shell 语句

  1. 如果 CONFIG_LOCALVERSION_AUTO = y 这段程序会通过 scm_version 函数(不加参数)配置本地版本号.

  2. 如果 CONFIG_LOCALVERSION_AUTO 未被设置, 而 LOVALVERSION 为空, 则 "${LOCALVERSION+set}" != "set", 那么调用 scm_version --short 会在最后添加一个 + 号.

原来如此, 加号是这样加上去的. 那么加号具体怎么添加上去的, 然后, scm_version 具体做了什么工作, 这些配置宏是如何影响版本号和后缀信息的, 那只有研究 scm_version 函数了.

2.3.3 版本后缀信息获取

scm_version(){    local short    short=false
    cd "$srctree"
    #  如果存在 .scmversion 文件则直接获取该文件的后缀信息    if test -e .scmversion; then        cat .scmversion        return    fi
    # --short 参数的设置    if test "$1" = "--short"; then        short=true    fi
    # Check for git and a git repo.    # 读取 git 仓库的版本信息    # 如果 --short 被设置则直接打印 + 号    # 否则git读取版本号信息,    #    如果git tag号存在git describe | awk -F- '{printf("-%05d-%s", $(NF-1),$(NF))}'    #    否则直接打印commit号信息    if test -z "$(git rev-parse --show-cdup 2>/dev/null)" &&       head=`git rev-parse --verify --short 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-%s", $(NF-1),$(NF))}'
            # If we don't have a tag at all we print -g{commitish}.            else                printf '%s%s' -g $head            fi        fi
        # Is this git on svn?        if git config --get svn-remote.svn.url >/dev/null; then            printf -- '-svn%s' "`git svn find-rev $head`"        fi
        # Check for uncommitted changes        # 如果有未提交的文件则会添加-dirty后缀        if git diff-index --name-only HEAD | grep -qv "^scripts/package"; then            printf '%s' -dirty        fi
        # All done with git        return    fi
    # Check for mercurial and a mercurial repo.    if test -d .hg && hgid=`hg id 2>/dev/null`; then        # Do we have an tagged version?  If so, latesttagdistance == 1        if [ "`hg log -r . --template '{latesttagdistance}'`" == "1" ]; then            id=`hg log -r . --template '{latesttag}'`            printf '%s%s' -hg "$id"        else            tag=`printf '%s' "$hgid" | cut -d' ' -f2`            if [ -z "$tag" -o "$tag" = tip ]; then                id=`printf '%s' "$hgid" | sed 's/[+ ].*//'`                printf '%s%s' -hg "$id"            fi        fi
        # Are there uncommitted changes?        # These are represented by + after the changeset id.        case "$hgid" in            *+|*+\ *) printf '%s' -dirty ;;        esac
        # All done with mercurial        return    fi
    # Check for svn and a svn repo.    # 获取 svn 仓库的版本号后缀信息    if rev=`LANG= LC_ALL= LC_MESSAGES=C svn info 2>/dev/null | grep '^Last Changed Rev'`; then        rev=`echo $rev | awk '{print $NF}'`        printf -- '-svn%s' "$rev"
        # All done with svn        return    fi}

用 bash 判断语句来判断

git rev-parse --verify --short

来判断当前是否是 git 版本库管理, 接着输出一个短的版本库HEAD revision 的短编码.

git rev-parse --verify --short HEAD 2>/dev/null

关键在下面这条语句的执行结果

git describe --exact-match

这一句是描述出当前的 tag 标识. 如果没有 tag 就为空, 那么整个 if 语句就为真, 就会执行下去, 下面的 echo "+", 这就会在版本号中输出一个 + 号.

如果我们在版本库中

git tag -a -m "v0.1" v0.1

然后, 我们在执行 git describe --exact-match 这一句, 发现输出的是我们的 tag 标识. 那 if 语句就不成里了, 就不会 echo "+" 了.

继续看上面的代码, 如果有未提交的代码, printf -dirty 的地方进行了 git diff 的检查, 也就是说我有修改过的, 没有上传的文件. 到此基本上原因全部查明, 我把文件进行上传后, 重新 make prepare 后, 生成的 kernel.release 果然正确.

结论, linux 对版本的管理相当严格，这也就让我们在进行代码管理中必须严格要求自己，比如发版本前，先检查是否还有修改为上传的文件，然后要在git版本库中打一个tag。

如果代码属于 git 管理

  • 打了 tag， 则会添加tag相关字符

    • 如果 tag 只是简单的标记, 比如 4.14-rc8 则跳过, 因为这些信息已经从前面 makefile 中获取到了

    • 如果 tag 还有其他后缀标记, 比如 v2.6.30-rc5-302-g72357d5, 则将这些打印出来

  • 没有打 tag, 则会添加 log 字符
    例如最新的 commit 是

  • commit cdebe039ded3e7fcd00c6e5603a878b14d7e564e

            则编译之后文件 include/config/kernel.release 的内容为 4.14.0-rc8-gcdebe03按照从之前传递的参数过来

  • 如果没有定义了 CONFIG_LOCALVERSION_AUTO 和 LOCALVERSION, scm_version 函数会传递过去 --short 参数版本号后面会添加 "+" 号.

  • if $short; thenecho "+"returnfi

2.4 总结

2.4.1 版本号的设置

脚本 script/setlocalversion 中读取了版本号的信息​​​​​​​

# localversion* files in the build and source directoryres="$(collect_files localversion*)"if test ! "$srctree" -ef .; then    res="$res$(collect_files "$srctree"/localversion*)"fi
# CONFIG_LOCALVERSION and LOCALVERSION (if set)res="${res}${CONFIG_LOCALVERSION}${LOCALVERSION}"

由此可看出, 如果想往版本号里添加字符, 有几种方式 :

  • 使用 LOCALVERSION 变量(或者在命令行, 或者添加为环境变量)

  • 在内核源代码根目录下添加文件 localversion 文件内容会自动添加到版本号里去. 在本地创建 文件中添加

  • 定义 CONFIG_LOCALVERSION 变量

  • 往版本号里添加字符的方式

LOCALVERSION 变量可在命令行定义 :

make LOCALVERSION=.44 include/config/kernel.release

或者添加为环境变量​​​​​​​

export LOCALVERSION=.44make include/config/kernel.release

当前内核版本为 4.14.0-rc8, 如果源码根目录下有文件 localversion(其内容为 .33), 也使用了 LOCALVERSION变量(make 时指定), 也定义了CONFIG_LOCALVERSION=".XYZ".

make LOCALVERSION=.44 include/config/kernel.release

此时对 4.14-rc8 的内核, include/config/kernel.release 的内容为 4.14-rc8.33.XYZ.55.

可看到添加的三种字符的顺序

文件 localversion 内容在前, 然后是 CONFIG_LOCALVERSION 的值, 最后是 LOCALVERSION 的值

即

2.4.2 后缀信息的获取

  1. 如果 CONFIG_LOCALVERSION_AUTO = y 这段程序会通过 scm_version 函数(不加参数)配置本地版本号后缀信息. 后缀信息一般都是托管仓库的版本号, 比如 git tag/commit 等

  2. 如果 CONFIG_LOCALVERSION_AUTO 未被设置, 而 LOVALVERSION 为空, 则 "${LOCALVERSION+set}" != "set", 那么调用 scm_version --short 会在最后添加一个 + 号.

另外, 关于 scripts/setlocalversion 文件.

在 `scripts/setlocalversion文件中，可用echo “aaa” >&2来输出显示相关信息，例如：
echo “LOCALVERSION=${LOCALVERSION}” >&2

需要仔细注意

使用 modinfo 可查看编译出来的 ko 文件对应的内核版本号
使用 uname 或者 cat /proc/version 可在目标系统上查看内核版本号.

可查看 kernel 编译过程生成的文件 include/config/kernel.release 或者 include/generated/utsrelease.h, 确定编译出来的内核的版本号.

2.4.3 验证

  • LOCALVERSION 可以在版本号之后追加后缀信息, 如果再定义 CONFIG_LOCALVERSION_AUTO, 将在最后进一步追加 git 版本号为后缀信息

  • 不定义CONFIG_LOCALVERSION_AUTO 将不显示 git 仓库信息, 如果此时 LOCALVERSION 变量定义也未定义, 将追加 “+”.

            此时 scm_version –short 添加了一个 “+” 号

cat .config | grep -E "CONFIG_LOCALVERSION"make kernelrelease

  • 只要定义了 LOCALVERSION 即使定义为 NULL, 也不会追加 “+

make LOCALVERSION= kernelrelease
make LOCALVERSION="" kernelrelease

此时将不会添加 “+” 号

3 解决

  • LOCALVERSION 可以在版本号之后追加后缀信息, 如果再定义 CONFIG_LOCALVERSION_AUTO, 将在最后进一步追加 git 版本号为后缀信息.

  • 不定义CONFIG_LOCALVERSION_AUTO 将不显示 git 仓库信息, 如果此时 LOCALVERSION 变量定义也未定义, 将追加 “+”.

  • 如果既不想添加后缀, 又不想有 "+" 号 : 不定义CONFIG_LOCALVERSION_AUTO, 将 LOCALVERSION 变量定义为空 : LOCALVERSION=.

  • 只要定义了 LOCALVERSION, 则就不会追加 “+” 号了

尚先生的博客
关注
专栏目录
Linux 编译内核 dirty,向linux内核版本号添加字符/为何有时会自动添加"+"号或者"xxx-dirty"【转】...
weixin_39822184的博客
05-02 1126
转载说明：你可能想不到，是git管理的“问题”，看下面的解析，对于u-boot也是有同样的效果。问题解决方案：1.删除.git目录2.去掉CONFIG_LOCALVERSION_AUTO且将LOCALVERSION变量空。1. 引子编译2.6.35.7 kernel版本的时候发现，“2.6.35.7“的内核版本编译成功后生成的版本号变成了“2.6.35.7+”，为什么后面会多一个加号呢？问题出...
linux 内核 config_localversion_auto,关于CONFIG_LOCALVERSION_AUTO设置去掉内核版本号SVN后缀...
weixin_31881651的博客
05-02 679
最近在TI 的DVSDK下写驱动模块时老受linux内核svn版本号问题的困扰，如"2.6.37-svn41"、"2.6.37-svn51"等等，svn版本变一次，从上面取下的代码内核版本就要变一次，这样造成原来驱动模块ko文件必须重新拷贝到新的lib/modules/2.6.37-svn51下，非常麻烦且不利于发版本。按其说法将arch/arm/configs/omap3_evm_defconf...
如何修改内核版本号，使驱动与内核版本匹配
最新发布
weixin_60212151的博客
09-09 1611
在kernel根目录的Makefile中可以查到，内核版本号(KERNELRELEASE)储存在include/config/kernel.release中，会在编译内核时生成。可以通过cat命令查看内核版本号。在Makefile中搜索KERNELVERSION变量，可以发现该变量是在Makefile最开头定义的,因此修改如下变量就可以修改KERNELVERSION。使用modprobe命令加载模块时， 提供了两个选项， 用于在加载模块时忽略vermagic或者CRC检查， 强制加载一个模块。
向linux内核版本号添加字符/为何有时会自动添加“+”号
adaptiver的专栏
02-01 1万+
1.   引子 编译2.6.35.7 kernel版本的时候发现，“2.6.35.7“的内核版本编译成功后生成的版本号变成了“2.6.35.7+”，为什么后面会多一个加号呢？问题出现在linux的版本控制这一块： 打开Makefile我们可以在文件的最上面可以发现 VERSION = 2 PATCHLEVEL = 6 SUBLEVEL = 35 EXTRAVERSION = .7 N
Linux 内核编译 LOCALVERSION 配置(分析内核版本号自动添加的"+"号)
宋宝华
11-07 1160
1 问题发现编译主线kernel版本的时候发现, 的内核版本编译成功后生成的版本号变成了"x.y.z+", 为什么后面会多一个加号呢?刚开始考虑是不是CONFIG...
uboot / linux添加/去除 版本号LOCALVERSION
weixin_41252596的博客
02-21 585
uboot / linux添加/去除 版本号LOCALVERSION
操作系统Linux内核编译实验报告.docx
03-24
操作系统Linux内核编译是一项对Linux系统有深入理解的重要实践，它涉及到系统核心的构建、配置和安装。在这个实验报告中，我们主要关注的是在Ubuntu Kylin 13.04环境下，如何编译和安装一个新的Linux内核，并且如何...
Linux内核编译配置选项简介
04-29
例如，可以设置是否显示内核版本号，是否自动添加版本信息等。此外，还有关于内核编译时是否需要Perl支持和Git仓库。这些设置为内核提供了必要的版本控制信息，使得跟踪内核版本和配置变得更为便捷。 3. 内存分页...
linux下编译linux内核_内核_linux内核_怎样编译内核_
09-30
通常，你会找到一个名为`linux-x.x.x.tar.xz`的压缩文件，其中`x.x.x`代表内核版本号。 2. **解压源码**：使用`tar`命令解压缩源码。例如，`tar -Jxf linux-x.x.x.tar.xz`，这将创建一个名为`linux-x.x.x`的目录。 ...
Linux kernel编译生成的版本多一个加号“+”
weixin_41884251的博客
05-29 585
其实，一直以来，我们编译KVM（Linux kernel）生成的RPM包中的kernel版本总是带有一个“莫名其妙”的加号（+），其实我知道大概是因为我们修改了Linux.git（或kvm.git）中的一些文件。但是我们只是修改了一下Makefile，让我们做RPM包是方便而已，一般我也没有在编译时修改其他的源代码文件，所以我想把这个加号去掉，对其进行了简单的研究，问题已经搞定了，记录如下吧。 kernel版本出现一个加号(plug sign)的原因可能是如下两点，当然前提是使用Linux的GIT repo
编译内核版本号带“+“问题
大吉
08-24 682
编译内核版本号带"+"问题
linux 内核名 加号,Linux kernel编译生成的版本多一个加号“+”
weixin_30646903的博客
05-12 211
其实，一直以来，我们编译KVM(Linuxkernel)生成的RPM包中的kernel版本总是带有一个“莫名其妙”的加号(+)，其实我知道大概是因为我们修改了Linux.git(或kvm.git)中的一些文件。但是我们只是修改了一下Makefile，让我们做RPM包是方便而已，一般我也没有在编译时修改其他的源代码文件，所以我想把这个加号去掉，对其进行了简单的研究，问题已经搞定了，记录如下吧。ker...
linux内核centos6.9,CentOS6.9手动编译并更新Kernel内核版本
weixin_33771582的博客
04-29 557
Kernel是Linux操作系统的核心部分。它由操作系统中用于管理存储器、文件、外设和系统资源的那些部分组成。Kernel是操作系统的核心，掌控着所有硬件设备的控制权。内核就是系统上面的一个文件，这个文件包含了驱动主机各项硬件的检测程序与驱动模块，在系统启动流程中，当系统读完BIOS并加载MBR的Boot Loader之后，就能够加载内核到内存中，然后去检测硬件设备，挂载根目录来获取内核模块来驱...
linux手动编译安装内核,CentOS 7.3 手动编译安装最新版本Linux Kernel
weixin_30959723的博客
04-29 752
本文演示机器系统版本是CENTOS7.3。 查看系统版本信息。[root@localhost ~]# lsb_release -aLSB Version: :core-4.1-amd64:core-4.1-noarch:cxx-4.1-amd64:cxx-4.1-noarch:desktop-4.1-amd64:desktop-4.1-noarch:languages-4.1-amd64:l...
关于CONFIG_LOCALVERSION_AUTO设置去掉内核版本号SVN后缀
what, when, why, how...
04-06 277
关于CONFIG_LOCALVERSION_AUTO设置去掉内核版本号SVN后缀
linux 内核编译——修改内核版本号
热门推荐
c_zyer的博客
03-06 1万+
一、实验前提     下载2.6.19或更新的Linux内核，配置该内核使其支持NTFS，并在新的内核中修改其版本为Linux NameTestKernelx.x.x，其中，Name是你的名字（汉语拼音）；x.x.x是新内核的版本号，最后在你的机器上编译安装这个新内核。（参见《RedHat Enterprise Linux 4入门与提高》第20章。）        注：本机：Windows 1
如何在把主机及版本信息编译进内核中？
程序猿Ricky的日常干货
04-25 736
我们知道当Linux系统或者Android系统运行起来之后，可以通过cat /proc/version来获取对应的版本信息.如下所示： xiehaocheng@xiehaocheng:~$ cat /proc/version Linux version 3.13.0-19-generic (buildd@akateko) (gcc version 4.8.2 (Ubuntu 4.8. 2-1...
Linux内核编译和更换系统内核版本
yangkunhenry的专栏
06-08 3283
夜深人静，更换个系统内核版本吧 1：首先我有了内核代码（直接在内核官网上下载下来就可以） 2：查看当前的内核版本 nasri@ubuntu:/boot$ cat /proc/version Linux version 4.18.0-20-generic (buildd@lcy01-amd64-020) (gcc version 7.3.0 (Ubuntu 7.3.0-16ubuntu3))...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值