RPM包rpmbuild SPEC文件深度说明

1. http://my.oschina.net/qihh/blog/62184

2. http://hlee.iteye.com/blog/343499

   上一篇日志写到，为什么要制作rpm包，以及如何使用.src.rpm文件生成rpm包。最后部分还看到.src.rpm的内容，实际上 就是由.tar.gz源码、补丁软件和.spec脚本组成的。由此知道，使用.spec生成rpm包是比较简单的，因为.src.rpm通常都是由软件开 发者或者第三方的专业制作人根据源码调试好的，所以，只要处理好平台兼容性和相关的版本，不会遇到太大的问题。

      但我觉得单纯明白用.spec生成rpm是不够的。常见有两个原因值得我们去了解用如何用源码制作rpm： 
   
   引用

   1、并不是所有的软件都提供.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 软件的详细说明

   
   
   三、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 变更日志
   四、范例 
      下面的.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 images 
   -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/images/ 
   demo/images/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
   
   
   引用

   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部分使用则是相对路径，虽然其描述的是同一个地方。千万不要写错。
    
   五、其他 
   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/
   
   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中所有的文件。
   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
   
   这样，整个套件的内容就会被放到/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

   
   六、参考文献： 
   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

   还是推荐看看Maximum RPM中文版（http://www.jsxubar.info/maximum-rpm-introduction.html），由Redhat内部人士编写，相当不错的书籍，适合使用RPM进行开发的人员看。
   其实RPM打包并不难，关键是有的软件的mke install是不一样的，不会按标准来，这就有点麻烦。生成文件列表也有些麻烦。