RPM包rpmbuild SPEC文件深度說明(轉)

 update log:

2010.01.08 加入SPEC文件中的宏定義和變量

2010.01.08 關鍵字說明，如何在升級過程當中 不覆蓋配置文件

 

   上一篇日誌寫到，爲何要製做rpm包，以及如何使用.src.rpm文件生成rpm包。最後部分還看到.src.rpm的內容，實際上就是由.tar.gz源碼、補丁軟件和.spec腳本組成的。由此知道，使用.spec生成rpm包是比較簡單的，由於.src.rpm一般都是由軟件開發者或者第三方的專業製做人根據源碼調試好的，因此，只要處理好平臺兼容性和相關的版本，不會遇到太大的問題。
   但我以爲單純明白用.spec生成rpm是不夠的。常見有兩個緣由值得咱們去了解用如何用源碼製做rpm：

引用

一、並非全部的軟件都提供.rpm方式的。
這是最多見的緣由。負責任的開發者應提供rpm方式的二進制軟件包，以便用戶選擇使用。但也很常見就是軟件做者只是發佈了源碼，最後一部分的編譯和安裝須要用戶自行解決。我不想深究對錯問題，反正知道有這樣的狀況就能夠了；
二、自行打包一些文件或本身開發了一套軟件
固然，使用tar包或cpio等也能夠打包文件，甚至比製做rpm要簡單不少。但若是您想在安裝的過程當中就把一套額外的軟件部署完畢，那使用rpm方式一般是是惟一的方法。並且rpm還有數據庫協助軟件升級、文件校驗等，結合yum升級方式，沒有理由不選擇rpm，特別是對於最終用戶，我認爲提供rpm包是最佳的方法。

1、編寫spec腳本
   由前面的日誌瞭解到，生成rpm除了源碼外，最重要的就是懂得編寫.spec腳本。rpm建包的原理其實並不複雜，能夠理解爲按照標準的格式整理一些信息，包括：軟件基礎信息，以及安裝、卸載先後執行的腳本，對源碼包解壓、打補丁、編譯，安裝路徑和文件等。
實際過程當中，最關鍵的地方，是要清楚虛擬路徑的位置，以及宏的定義。
2、關鍵字
spec腳本包括不少關鍵字，主要有：

引用

Name: 軟件包的名稱，後面可以使用%{name}的方式引用

Summary: 軟件包的內容概要

Version: 軟件的實際版本號，例如：1.0.1等，後面可以使用%{version}引用

Release: 發佈序列號，例如：1linuxing等，標明第幾回打包，後面可以使用%{release}引用

Group: 軟件分組，建議使用標準分組

License: 軟件受權方式，一般就是GPL

Source: 源代碼包，能夠帶多個用Source一、Source2等源，後面也能夠用%{source1}、%{source2}引用

BuildRoot: 這個是安裝或編譯時使用的「虛擬目錄」，考慮到多用戶的環境，通常定義爲：
%{_tmppath}/%{name}-%{version}-%{release}-root
或
%{_tmppath}/%{name}-%{version}-%{release}-buildroot-%(%{__id_u} -n}
該參數很是重要，由於在生成rpm的過程當中，執行make install時就會把軟件安裝到上述的路徑中，在打包的時候，一樣依賴「虛擬目錄」爲「根目錄」進行操做。
後面可以使用 $RPM_BUILD_ROOT方式引用。

URL: 軟件的主頁

Vendor: 發行商或打包組織的信息，例如RedFlag Co,Ltd

Disstribution: 發行版標識

Patch: 補丁源碼，可以使用Patch一、Patch2等標識多個補丁，使用%patch0或%{patch0}引用

Prefix: %{_prefix} 這個主要是爲了解決從此安裝rpm包時，並不必定把軟件安裝到rpm中打包的目錄的狀況。這樣，必須在這裏定義該標識，並在編寫%install腳本的時候引用，才能實現rpm安裝時從新指定位置的功能

Prefix: %{_sysconfdir} 這個緣由和上面的同樣，但因爲%{_prefix}指/usr，而對於其餘的文件，例如/etc下的配置文件，則須要用%{_sysconfdir}標識

Build Arch: 指編譯的目標處理器架構，noarch標識不指定，但一般都是以/usr/lib/rpm/marcros中的內容爲默認值

Requires: 該rpm包所依賴的軟件包名稱，能夠用>=或<=表示大於或小於某一特定版本，例如：
libpng-devel >= 1.0.20 zlib
※「>=」號兩邊需用空格隔開，而不一樣軟件名稱也用空格分開
還有例如PreReq、Requires(pre)、Requires(post)、Requires(preun)、Requires(postun)、BuildRequires等都是針對不一樣階段的依賴指定

Provides: 指明本軟件一些特定的功能，以便其餘rpm識別

Packager: 打包者的信息

%description 軟件的詳細說明

3、spec腳本主體
spec腳本的主體中也包括了不少關鍵字和描述，下面會一一列舉。我會把一些特別須要留意的地方標註出來。
%prep 預處理腳本

%setup -n %{name}-%{version} 把源碼包解壓並放好
一般是從/usr/src/asianux/SOURCES裏的包解壓到/usr/src/asianux/BUILD/%{name}-%{version}中。
通常用%setup -c就能夠了，但有兩種狀況：一就是同時編譯多個源碼包，二就是源碼的tar包的名稱與解壓出來的目錄不一致，此時，就須要使用-n參數指定一下了。

%patch 打補丁
一般補丁都會一塊兒在源碼tar.gz包中，或放到SOURCES目錄下。通常參數爲：
%patch -p1 使用前面定義的Patch補丁進行，-p1是忽略patch的第一層目錄
%Patch2 -p1 -b xxx.patch 打上指定的補丁，-b是指生成備份文件

◎補充一下

引用

%setup 不加任何選項，僅將軟件包打開。 
%setup -n newdir 將軟件包解壓在newdir目錄。 
%setup -c 解壓縮以前先產生目錄。 
%setup -b num 將第num個source文件解壓縮。 
%setup -T 不使用default的解壓縮操做。 
%setup -T -b 0 將第0個源代碼文件解壓縮。 
%setup -c -n newdir 指定目錄名稱newdir，並在此目錄產生rpm套件。 
%patch 最簡單的補丁方式，自動指定patch level。 
%patch 0 使用第0個補丁文件，至關於%patch ?p 0。 
%patch -s 不顯示打補丁時的信息。 
%patch -T 將全部打補丁時產生的輸出文件刪除。

%configure 這個不是關鍵字，而是rpm定義的標準宏命令。意思是執行源代碼的configure配置
在/usr/src/asianux/BUILD/%{name}-%{version}目錄中進行，使用標準寫法，會引用/usr/lib/rpm/marcros中定義的參數。
另外一種不標準的寫法是，可參考源碼中的參數自定義，例如：

引用

CFLAGS="$RPM_OPT_FLAGS" CXXFLAGS="$RPM_OPT_FLAGS" ./configure --prefix=%{_prefix}

%build 開始構建包
在/usr/src/asianux/BUILD/%{name}-%{version}目錄中進行make的工做，常見寫法：

引用

make %{?_smp_mflags} OPTIMIZE="%{optflags}"

都是一些優化參數，定義在/usr/lib/rpm/marcros中

%install 開始把軟件安裝到虛擬的根目錄中
在/usr/src/asianux/BUILD/%{name}-%{version}目錄中進行make install的操做。 這個很重要，由於若是這裏的路徑不對的話，則下面%file中尋找文件的時候就會失敗。常見內容有：
%makeinstall 這不是關鍵字，而是rpm定義的標準宏命令。也可使用非標準寫法：

引用

make DESTDIR=$RPM_BUILD_ROOT install

或

引用

make prefix=$RPM_BUILD_ROOT install

須要說明的是，這裏的%install主要就是爲了後面的%file服務的。因此，還可使用常規的系統命令：

引用

install -d $RPM_BUILD_ROOT/
cp -a * $RPM_BUILD_ROOT/

%clean 清理臨時文件
一般內容爲：

引用

[ "$RPM_BUILD_ROOT" != "/" ] && rm -rf "$RPM_BUILD_ROOT"
rm -rf $RPM_BUILD_DIR/%{name}-%{version}

※注意區分$RPM_BUILD_ROOT和$RPM_BUILD_DIR：
$RPM_BUILD_ROOT是指開頭定義的BuildRoot，而$RPM_BUILD_DIR一般就是指/usr/src/asianux/BUILD，其中，前面的纔是%file須要的。

%pre rpm安裝前執行的腳本

%post rpm安裝後執行的腳本

%preun rpm卸載前執行的腳本

%postun rpm卸載後執行的腳本

 

%preun  %postun 的區別是什麼呢？

前者在升級的時候會執行，後者在升級rpm包的時候不會執行

%files 定義那些文件或目錄會放入rpm中
這裏會在虛擬根目錄下進行，千萬不要寫絕對路徑，而應用宏或變量表示相對路徑。若是描述爲目錄，表示目錄中除%exclude外的全部文件。
%defattr (-,root,root) 指定包裝文件的屬性，分別是(mode,owner,group)，-表示默認值，對文本文件是0644，可執行文件是0755

%exclude 列出不想打包到rpm中的文件
※當心，若是%exclude指定的文件不存在，也會出錯的。
%changelog 變動日誌

4、範例
   下面的.spec腳本是一個比較簡單的範例，其做用是把一個目錄中的全部文件都打包爲一個rpm包。
一、前期工做
咱們假設須要打包的目錄就是咱們的源碼文件。 這樣，能夠暫時忽略比較麻煩的打補丁、編譯等問題，並且也是一種常見的方式。在編寫.spec腳本前，須要準備好「源碼」，也就是目錄，內容比較簡單：

引用

[root@mail html]# ll
total 4
drwxr-xr-x  3 root root 4096 Jun  4 14:45 demo
[root@mail html]# ll demo/
total 4
drwxr-xr-x  3 root root 4096 Jun  4 14:45 p_w_picpaths
-rw-r--r--  1 root root    0 Jun  4 14:45 index.html

由於rpm只認tar.gz格式，因此，必須打包好並移動到SOURCES目錄中：

引用

[root@mail html]# tar czvf demo.tar.gz demo/
demo/
demo/p_w_picpaths/
demo/p_w_picpaths/logo.gif/
demo/index.html
[root@mail html]# mv demo.tar.gz /usr/src/asianux/SOURCES/

二、demo.spec的內容
準備工做完成，下面就是範例用的腳本內容：

[root@mail html]# cd /usr/src/asianux/SPECS/
[root@mail SPECS]# cat demo.spec

 

引用

Summary:   Test package for LinuxFly webblog
Name:      suite
Version:   1.0.0
Release:   1
License:   GPL
Group:     System
Source:    demo.tar.gz
BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root
Url:       http://www.linuxfly.org
Packager:  Linuxing
Prefix:    %{_prefix}
Prefix:    %{_sysconfdir}
%define    userpath /var/www/html/demo

%description
Just a test rpm suite.

%prep
%setup -c
%install
install -d $RPM_BUILD_ROOT%{userpath}
cp -a %{name}* $RPM_BUILD_ROOT%{userpath}

%clean
rm -rf $RPM_BUILD_ROOT
rm -rf $RPM_BUILD_DIR/%{name}-%{version}

%files
%defattr(-,root,root)
%{userpath}

下載：

下載文件

點擊這裏下載文件

※特別須要注意的是：%install部分使用的是絕對路徑，而%file部分使用則是相對路徑，雖然其描述的是同一個地方。千萬不要寫錯。

 

5、其餘
一、擴展
雖然上面的範例很簡陋，並且缺乏%build部分，但實際上只要記住兩點：
a）就是%build和%install的過程當中，都必須把編譯和安裝的文件定義到「虛擬根目錄」中。

引用

%build 
make -f admin/Makefile.common cvs 
./configure --prefix=%{_prefix} --enable-final --disable-debug \ 
--with-extra-includes=%{_includedir}/freetype2 --includedir=%{_includedir} 
make 
%install 
rm -fr $RPM_BUILD_ROOT 
make DESTDIR=$RPM_BUILD_ROOT install 
cp -r $RPM_BUILD_ROOT%{_datadir}/apps/kolourpaint/icons/hicolor/* $RPM_BUILD_ROOT%{_datadir}/icons/crystalsvg/

b）就是%file中必須明白，用的是相對目錄

 

引用

%files 
%defattr(-,root,root) 
%{_bindir} 
%{_libdir} 
%{_datadir} 
%exclude %{_libdir}/debug

若是把

 

引用

%files 
%defattr(-,root,root) 
%{_bindir}

寫成

 

引用

%files 
%defattr(-,root,root) 
/usr/bin

則打包的會是根目錄下的/usr/bin中全部的文件。
二、一些rpm相關信息
rpm軟件包系統的標準分組：/usr/share/doc/rpm-4.3.3/GROUPS
各類宏定義： /usr/lib/rpm/macros
已經安裝的rpm包數據庫： /var/lib/rpm
若是要避免生成debuginfo包：這個是默認會生成的rpm包。則可使用下面的命令：

 

echo '%debug_package %{nil}' >> ~/.rpmmacros

若是rpm包已經作好，但在安裝的時候想修改默認路徑，則能夠：

 

rpm -ivh --prefix=/opt/usr xxx.rpm

又或者同時修改多個路徑：

 

rpm xxx.rpm --relocate=/usr=/opt/usr --relocate=/etc=/usr/etc

三、製做補丁
詳細看參考： [原]使用diff同patch工具 
四、如何編寫%file段
因爲必須在%file中包括全部套件中的文件，因此，咱們須要清楚編譯完的套件到底包括那些文件？
常見的作法是，人工模擬一次編譯的過程：

 

./configrue --prefix=/usr/local/xxx
make
make DESTDIR=/usr/local/xxx install
或
make prefix=/usr/local/xxx install

這樣，整個套件的內容就會被放到/usr/local/xxx中，可根據狀況編寫%file和%exclude段。
※固然，這個只能對源碼按GNU方式編寫，並使用GNU autotool建立的包有效，若自定義Makefile則不能一律而論。
五、關於rpm中的執行腳本
若是正在製做的rpm包是準備做爲放到系統安裝光盤中的話，則須要考慮rpm中定義的腳本是否有問題。因爲系統在安裝的時候只是依賴於一個小環境進行，而該環境與實際安裝完的環境有很大的區別，因此，大部分的腳本在該安裝環境中都是沒法生效，甚至會帶來麻煩的。
因此，對於這樣的，須要放到安裝光盤中的套件，不加入執行腳本是較佳的方法。
另外，爲提供操做中可參考的信息，rpm還提供了一種信號機制：不一樣的操做會返回不一樣的信息，並放到默認變量$1中。

 

引用

0表明卸載、1表明安裝、2表明升級

可這樣使用：

 

引用

%postun 
if [ "$1" = "0" ]; then 
/sbin/ldconfig 
fi

6、參考文獻：
1. http://www-900.ibm.com/developerWorks/cn/linux/management/package/rpm/part1/index.shtml[/url] 
2. http://www-900.ibm.com/developerWorks/cn/linux/management/package/rpm/part2/index.shtml 
3. http://www-900.ibm.com/developerWorks/cn/linux/management/package/rpm/part3/index.shtml 
4. /usr/share/doc/rpm-4.3.2/ 
5. http://www.rpm.org/RPM-HOWTO/build.html#SCRIPTS 
6. http://www.linuxfans.org/nuke/modules.php?name=Forums&file=printview&t=86980&start=0

 

 

最近在些SPEC，發現其中的宏路徑太難記了，GOOGLE一下，發現FERDORA已經有介紹了。

能夠經過命令rpm --showrc查看實現代碼。另外直接經過rpm --eval "%{macro}"來查看具體對應路徑。

好比咱們要查看%{_bindir}的路徑，就可使用命令rpm --eval "%{ _bindir}"來查看。

另外，全部的宏均可以在/usr/lib/rpm/macros裏找到。

下面是宏對應路徑一覽表：

Macros mimicking autoconf variables

%{_sysconfdir}        
/etc%{_prefix}            
/usr%{_exec_prefix}       
%{_prefix}%{_bindir}            
%{_exec_prefix}/bin%{_lib}               
lib (lib64 on 64bit systems)%{_libdir}           
%{_exec_prefix}/%{_lib}%{_libexecdir}        
%{_exec_prefix}/libexec%{_sbindir}           
%{_exec_prefix}/sbin%{_sharedstatedir}    
/var/lib%{_datadir}           
%{_prefix}/share%{_includedir}       
%{_prefix}/include%{_oldincludedir}     
/usr/include%{_infodir}           
/usr/share/info%{_mandir}            
/usr/share/man%{_localstatedir}     
/var%{_initddir}          
%{_sysconfdir}/rc.d/init.d

Note: On releases older than Fedora 10 (and EPEL), %{_initddir} does not exist. Instead, you should use the deprecated%{_initrddir} macro.

 

RPM directory macros

%{_topdir}            
%{getenv:HOME}/rpmbuild%{_builddir}          
%{_topdir}/BUILD%{_rpmdir}            
%{_topdir}/RPMS%{_sourcedir}         
%{_topdir}/SOURCES%{_specdir}           
%{_topdir}/SPECS%{_srcrpmdir}         
%{_topdir}/SRPMS%{_buildrootdir}      
%{_topdir}/BUILDROOT

Note: On releases older than Fedora 10 (and EPEL), %{_buildrootdir} does not exist.

 

Build flags macros

%{_global_cflags}     
-O2 -g -pipe%{_optflags}          
%{__global_cflags} -m32 -march=i386 -mtune=pentium4
# if redhat-rpm-config is installed

 

Other macros

%{_var}               
/var%{_tmppath}           
%{_var}/tmp%{_usr}               
/usr%{_usrsrc}            
%{_usr}/src%{_docdir}            
%{_datadir}/doc

 

Reference：

http://fedoraproject.org/wiki/Packaging/RPMMacros#RPM_directory_macros