RPM包rpmbuild SPEC文件說明

原文：http://hlee.iteye.com/blog/343499

略做修改

---------------------

常見有兩個緣由值得咱們去了解用如何用源碼製做rpm：

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

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

主要有：

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 方式引用。

根據Fedora的Wiki提供的信息，您可使用 $RPM_BUILD_ROOT或者 %{buildroot}。二者均可以。

https://fedoraproject.org/wiki/How_to_create_an_RPM_package/zh-cn

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套件。
%setup -q -q 指不顯示輸出（quietly）
%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外的全部文件。

在此階段你須要定義 %config 和 %doc 使後續rpm安裝後，可以經過rpm -qc 和 rpm -qd 查詢到rpm包的配置文件和說明文檔的路徑

%config(noreplace)  /etc/xx.conf 將確保配置文件更新時不會覆蓋原文件

%defattr (-,root,root,-)  指定包裝文件的屬性，分別是(文件權限,屬主,屬組,目錄權限)，- 表示默認值，由umask決定，一般對文本文件是0644，可執行文件是0755

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

好比加入一個新的補丁，修改配置，日誌使用 data +"%a %b %d %Y" ,須要顯示包的日誌改變的信息可使用 rpm -q --changelog packeagename

 

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

 

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