向linux內核版本號添加字符/爲何有時會自動添加"+"號或者"xxx-dirty"

原文地址:http://blog.csdn.NET/adaptiver/article/details/7225980

轉載說明:你可能想不到,是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版本控制這一塊:
打開Makefile我們可以在文件的最上面可以發現
VERSION = 2
PATCHLEVEL = 6
SUBLEVEL = 35
EXTRAVERSION = .7
NAME = Yokohama
這些就是告訴我們內核版本的版本號,生成出來的版本號理論上不應帶+號,但爲什麼帶+號呢

 include/config/kernel.release文件是生成的帶有版本號的文件,該文件由內核頂層Makefile的如下腳本處理:
# Store (new) KERNELRELASE string in include/config/kernel.release
include/config/kernel.release: include/config/auto.conf FORCE
        $(Q)rm -f $@
        $(Q)echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))" > $@

使用scripts/setlocalversion工具來生成include/config/kernel.release。“+”號就是在調用這個腳本時添加的。

 閱讀scripts/setlocalversion文件,並查閱資料,做如下筆記:

2.   爲何會添加“+”號

在scripts/setlocalversion文件中有這麼一段
# scm version string if not at a tagged commit
if test "$CONFIG_LOCALVERSION_AUTO" = "y"; then
 # full scm version string
 res="$res$(scm_version)"
else
 # apped a plus sign if the repository is not in a clean tagged
 # state and  LOCALVERSION= is not specified
 if test "${LOCALVERSION+set}" != "set"; then
  scm=$(scm_version --short)
  res="$res${scm:++}"
 fi
fi

2.1. 如果定義了CONFIG_LOCALVERSION_AUTO(CONFIG_LOCALVERSION_AUTO=y)

此時會執行第一個if下的腳本。執行res="$res$(scm_version)"
如果代碼屬於git管理:
打了tag,則會添加tag相關字符;
沒有打tag,則會添加log相加字符,例如最新的commit是
commit cdebe039ded3e7fcd00c6e5603a878b14d7e564e
則編譯之後文件include/config/kernel.release的內容爲2.6.35.7-gcdebe03

2.2. 如果沒有定義了CONFIG_LOCALVERSION_AUTO。

此時會執行else下的腳本。
A. 如果沒有定義LOCALVERSION,版本號後面會添加“+”號:執行else裏的if下的腳本scm=$(scm_version --short),在函數scm_version --short裏,如果傳入參數short會添加“+”號,
   if $short; then
    echo "+"
    return
   fi

B. 定義了LOCALVERSION則不會執行else裏if所在的腳本,從而不會在後面添加“+”號。
C. LOCALVERSION變量可在命令行定義:
make LOCALVERSION=.88 include/config/kernel.release
或者添加爲環境變量。
如果既不想添加字符,又不想有“+”號:不定義CONFIG_LOCALVERSION_AUTO,將LOCALVERSION變量定義爲空:LOCALVERSION=

3.   往版本號裏添加字符的方式

在scripts/setlocalversion文件中還有有這麼一段:
# 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)
res="${res}${CONFIG_LOCALVERSION}${LOCALVERSION}"
由此可看出,如果想往版本號裏添加字符,有幾種方式:
1. 使用LOCALVERSION變量(或者在命令行,或者添加爲環境變量)
2. 在linux-2.6.35目錄下添加文件localversion,文件內容會自動添加到版本號裏去。
3. 定義CONFIG_LOCALVERSION變量
4. 如果linux-2.6.35目錄下有文件localversion(其內容爲.33),也使用了LOCALVERSION變量,也定義了CONFIG_LOCALVERSION=".XYZ"。
make LOCALVERSION=.44 include/config/kernel.release
此時對2.6.35.7的內核,include/config/kernel.release的內容爲2.6.35.7.33.XYZ.55。
可看到添加的三種字符的順序:文件localversion內容在前,然後是CONFIG_LOCALVERSION的值,最後是LOCALVERSION的值。

4.   另外,關於scripts/setlocalversion文件:

1. 在scripts/setlocalversion文件中,可用echo "aaa" >&2來輸出顯示相關信息,例如:
echo "LOCALVERSION=${LOCALVERSION}" >&2

2. 這個文件裏很多地方是跟根據一些git命令來進行判斷的,例如

         if head=`git rev-parse --verify --short HEAD 2>/dev/null`; then

                   if [ -z "`git describe --exact-match 2>/dev/null`" ]; then

                   if git config --get svn-remote.svn.url >/dev/null; then

                   [ -w . ] && git update-index --refresh --unmerged > /dev/null

                   if git diff-index --name-only HEAD | grep -v "^scripts/package" \

需要仔細注意:

發佈了121 篇原創文章 · 獲贊 39 · 訪問量 50萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章