2010.01.08 加入SPEC文件中的宏定義和變量
2010.01.08 關鍵字說明，如何在升級過程中不覆蓋配置文件
上一篇日誌寫到，爲什麼要製作rpm包，以及如何使用.src.rpm文件生成rpm包。最後部分還看到.src.rpm的內容，實際上 就是由.tar.gz源碼、補丁軟件和.spec腳本組成的。由此知道，使用.spec生成rpm包是比較簡單的，因爲.src.rpm通常都是由軟件開 發者或者第三方的專業製作人根據源碼調試好的，所以，只要處理好平臺兼容性和相關的版本，不會遇到太大的問題。
但我覺得單純明白用.spec生成rpm是不夠的。常見有兩個原因值得我們去了解用如何用源碼製作rpm：
但我覺得單純明白用.spec生成rpm是不夠的。常見有兩個原因值得我們去了解用如何用源碼製作rpm：
引用
1、並不是所有的軟件都提供.rpm方式的。
這是最常見的原因。負責任的開發者應提供rpm方式的二進制軟件包，以便用戶選擇使用。但也很常見就是軟件作者只是發佈了源碼，最後一部分的編譯和安裝需要用戶自行解決。我不想深究對錯問題，反正知道有這樣的情況就可以了；
2、自行打包一些文件或自己開發了一套軟件
當 然，使用tar包或cpio等也可以打包文件，甚至比製作rpm要簡單很多。但如果您想在安裝的過程中就把一套額外的軟件部署完畢，那使用rpm方式通常 是是唯一的方法。而且rpm還有數據庫協助軟件升級、文件校驗等，結合yum升級方式，沒有理由不選擇rpm，特別是對於最終用戶，我認爲提供rpm包是 最佳的方法。
這是最常見的原因。負責任的開發者應提供rpm方式的二進制軟件包，以便用戶選擇使用。但也很常見就是軟件作者只是發佈了源碼，最後一部分的編譯和安裝需要用戶自行解決。我不想深究對錯問題，反正知道有這樣的情況就可以了；
2、自行打包一些文件或自己開發了一套軟件
當 然，使用tar包或cpio等也可以打包文件，甚至比製作rpm要簡單很多。但如果您想在安裝的過程中就把一套額外的軟件部署完畢，那使用rpm方式通常 是是唯一的方法。而且rpm還有數據庫協助軟件升級、文件校驗等，結合yum升級方式，沒有理由不選擇rpm，特別是對於最終用戶，我認爲提供rpm包是 最佳的方法。
一、編寫spec腳本
由前面的日誌瞭解到，生成rpm除了源碼外，最重要的就是懂得編寫.spec腳本。rpm建包的原理其實並不複雜，可以理解爲按照標準的格式整理一些信息，包括：軟件基礎信息，以及安裝、卸載前後執行的腳本，對源碼包解壓、打補丁、編譯，安裝路徑和文件等。
實際過程中，最關鍵的地方，是要清楚虛擬路徑的位置，以及宏的定義。
二、關鍵字
spec腳本包括很多關鍵字，主要有：
引用
Name: 軟件包的名稱，後面可使用%{name}的方式引用
Summary: 軟件包的內容概要
Version: 軟件的實際版本號，例如：1.0.1等，後面可使用%{version}引用
Release: 發佈序列號，例如：1linuxing等，標明第幾次打包，後面可使用%{release}引用
Group: 軟件分組，建議使用標準分組
License: 軟件授權方式，通常就是GPL
Source: 源代碼包，可以帶多個用Source1、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: 補丁源碼，可使用Patch1、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 軟件的詳細說明
Summary: 軟件包的內容概要
Version: 軟件的實際版本號，例如：1.0.1等，後面可使用%{version}引用
Release: 發佈序列號，例如：1linuxing等，標明第幾次打包，後面可使用%{release}引用
Group: 軟件分組，建議使用標準分組
License: 軟件授權方式，通常就是GPL
Source: 源代碼包，可以帶多個用Source1、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: 補丁源碼，可使用Patch1、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 軟件的詳細說明
三、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 將所有打補丁時產生的輸出文件刪除。
%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/
cp -a * $RPM_BUILD_ROOT/
%clean 清理臨時文件
通常內容爲：
引用
[ "$RPM_BUILD_ROOT" != "/" ] && rm -rf "$RPM_BUILD_ROOT"
rm -rf $RPM_BUILD_DIR/%{name}-%{version}
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 變更日誌
%files 定義那些文件或目錄會放入rpm中
這裏會在虛擬根目錄下進行，千萬不要寫絕對路徑，而應用宏或變量表示相對路徑。如果描述爲目錄，表示目錄中除%exclude外的所有文件。
%defattr (-,root,root) 指定包裝文件的屬性，分別是(mode,owner,group)，-表示默認值，對文本文件是0644，可執行文件是0755
%exclude 列出不想打包到rpm中的文件
※小心，如果%exclude指定的文件不存在，也會出錯的。
%changelog 變更日誌
四、範例
下面的.spec腳本是一個比較簡單的範例，其作用是把一個目錄中的所有文件都打包爲一個rpm包。
1、前期工作
我們假設需要打包的目錄就是我們的源碼文件。這樣，可以暫時忽略比較麻煩的打補丁、編譯等問題，而且也是一種常見的方式。在編寫.spec腳本前，需要準備好“源碼”，也就是目錄，內容比較簡單：
下面的.spec腳本是一個比較簡單的範例，其作用是把一個目錄中的所有文件都打包爲一個rpm包。
1、前期工作
我們假設需要打包的目錄就是我們的源碼文件。這樣，可以暫時忽略比較麻煩的打補丁、編譯等問題，而且也是一種常見的方式。在編寫.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
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/
demo/p_w_picpaths/
demo/p_w_picpaths/logo.gif/
demo/index.html
[root@mail html]# mv demo.tar.gz /usr/src/asianux/SOURCES/
2、demo.spec的內容
準備工作完成，下面就是範例用的腳本內容：
[root@mail html]# cd /usr/src/asianux/SPECS/
[root@mail SPECS]# cat demo.spec
[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}
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部分使用則是相對路徑，雖然其描述的是同一個地方。千萬不要寫錯。
五、其他
1、擴展
雖然上面的範例很簡陋，而且缺少%build部分，但實際上只要記住兩點：
a）就是%build和%install的過程中，都必須把編譯和安裝的文件定義到“虛擬根目錄” 中。
1、擴展
雖然上面的範例很簡陋，而且缺少%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/
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
%defattr(-,root,root)
%{_bindir}
%{_libdir}
%{_datadir}
%exclude %{_libdir}/debug
如果把
引用
%files
%defattr(-,root,root)
%{_bindir}
%defattr(-,root,root)
%{_bindir}
寫成
引用
%files
%defattr(-,root,root)
/usr/bin
%defattr(-,root,root)
/usr/bin
則打包的會是根目錄下的/usr/bin中所有的文件。
2、一些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
3、製作補丁
詳細看參考：[原]使用diff同patch工具
4、如何編寫%file段
由於必須在%file中包括所有套件中的文件，所以，我們需要清楚編譯完的套件到底包括那些文件？
常見的做法是，人工模擬一次編譯的過程：
./configrue --prefix=/usr/local/xxx
make
make DESTDIR=/usr/local/xxx install
或
make prefix=/usr/local/xxx install
make
make DESTDIR=/usr/local/xxx install
或
make prefix=/usr/local/xxx install
這樣，整個套件的內容就會被放到/usr/local/xxx中，可根據情況編寫%file和%exclude段。
※當然，這個只能對源碼按GNU方式編寫，並使用GNU autotool創建的包有效，若自定義Makefile則不能一概而論。
5、關於rpm中的執行腳本
如果正在製作的rpm包是準備作爲放到系統安裝光盤中的話，則需要考慮rpm中定義的腳本是否有問題。由於系統在安裝的時候只是依賴於一個小環境進行，而該環境與實際安裝完的環境有很大的區別，所以，大部分的腳本在該安裝環境中都是無法生效，甚至會帶來麻煩的。
所以，對於這樣的，需要放到安裝光盤中的套件，不加入執行腳本是較佳的方法。
另外，爲提供操作中可參考的信息，rpm還提供了一種信號機制：不同的操作會返回不同的信息，並放到默認變量$1中。
引用
0代表卸載、1代表安裝、2代表升級
可這樣使用：
引用
%postun
if [ "$1" = "0" ]; then
/sbin/ldconfig
fi
if [ "$1" = "0" ]; then
/sbin/ldconfig
fi
六、參考文獻：
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
轉載：http://hlee.iteye.com/blog/343499