Centos RPM Build Shell SPEC FILE INSTRUCTIONS

一、概述

Rpm包制作最重要的就是编写.spec脚本。rpm建包的原理其实并不复杂，可以理解为按照标准的格式整理一些信息，包括：软件基础信息，以及安装、卸载前后执行的脚本，对源码包解压、打补丁、编译，安装路径和文件等。

   实际过程中，最关键的地方，是要清楚虚拟路径的位置，以及宏的定义。

我自己的编写示例，可以单击下载：http://download.csdn.net/detail/skdkjxy/8237031

二、关键字

spec脚本包括很多关键字，主要有：

Name:

 软件包的名称，后面可使用%{name}的方式引用

Summary:

软件包的内容概要

Version:

软件的实际版本号，例如：1.0.1等，后面可使用%{version}引用

Release:

 发布序列号，例如：1 linuxing等，标明第几次打包，后面可使用%{release}引用

Group:

 软件分组，建议使用标准分组

License:

 软件授权方式，通常就是GPL或者MIT

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/share/doc/rpm-4.8.0/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}把源码包解压并放好通常是从/root/SOURCES里的包解压到/root/BUILD/%{name}-%{version}中。一般用%setup-c就可以了，但有两种情况：一就是同时编译多个源码包，二就是源码的tar包的名称与解压出来的目录不一致，此时，就需要使用-n参数指定一下了。

%patch打补丁

通常补丁都会一起在源码tar.gz包中，或放到SOURCES目录下。一般参数为：%patch -p1 使用前面定义的Patch补丁进行，-p1是忽略patch的第一层目录%Patch2 -p1 -bxxx.patch 打上指定的补丁，-b是指生成备份文件。

针对%setup和%patch做如下补充：

%setup不加任何选项，仅将软件包打开。
%setup -n newdir 将软件包解压在newdir目录。
%setup -c 解压缩之前先产生目录。
%setup -q 安静模式进行解压
%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配置在/root/BUILD/%{name}-%{version}目录中进行，使用标准写法，会引用/usr/share/doc/rpm-4.8.0/marcros中定义的参数。另一种不标准的写法是，可参考源码中的参数自定义，例如：

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

%build开始构建包

在/root/BUILD/%{name}-%{version}目录中进行make的工作，常见写法：

make %{?_smp_mflags}OPTIMIZE="%{optflags}"都是一些优化参数，定义在/usr/share/doc/rpm-4.8.0/marcros中

%install开始把软件安装到虚拟的根目录中

在/root/BUILD/%{name}-%{version}目录中进行make install的操作。这个很重要，因为如果这里的路径不对的话，则下面%file中寻找文件的时候就会失败。常见内容有：

%makeinstall这不是关键字，而是rpm定义的标准宏命令。也可以使用非标准写法：

make DESTDIR=$RPM_BUILD_ROOTinstall或makeprefix=$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通常就是指/root/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变更日志

   略

四、范例

 #这个区域定义的Name、Version这些字段对应的值可以在后面

#通过%{name},%{version}这样的方式来引用，类似于C语言中的宏

# Name制定了软件的名称

Name:      nginx

#软件版本

Version:   1.5.2

#释出号，也就是第几次制作rpm

Release:   1%{?dist}

#软件的介绍，必须设置，最好不要超过50个字符

Summary:   Nginx from WangYing

#软件的分组，可以通过/usr/share/doc/rpm-4.8.0/GROUPS文件中选择，也可以

#在相应的分类下，自己创建一个新的类型，例如这里的Server

Group:     Application/Server

#许可证类型

License:   GPL

#软件的源站

URL:       http://nginx.org

#制作rpm包的人员信息

Packager:  WangYing <justlinux2010@gmail.com>

#源码包的名称，在%_topdir/SOURCE下，如果有多个源码包的话，可以通过

# Source1、Source2这样的字段来指定其他的源码包

Source0:   %{name}-%{version}.tar.gz

# BuildRoot指定了make install的测试安装目录，通过这个目录我们可以观察

#生成了哪些文件，方便些files区域。如果在files区域中写的一些文件报

#不存在的错误，可以查看%_topdir/BUILDROOT目录来检查有哪些文件。

BuildRoot: %_topdir/BUILDROOT

#指定安装的路径

Prefix:    /usr/local/nginx-1.5.2

#制作过程需要的工具或软件包

BuildRequires: gcc,make

#安装时依赖的软件包

Requires:pcre,pcre-devel,openssl

#软件的描述，这个可以尽情地写

%description

Nginxis a http server

# %prep指定了在编译软件包之前的准备工作，这里的

# setup宏的作用是静默模式解压并切换到源码目录中，

#当然你也可以使用tar命令来解压

%prep

%setup-q

#编译阶段，和直接编译源代码类似，具体的操作或指定的一些参数由configure文件决定。

%build

CFLAGS="-pipe-O2 -g -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror" ./configure--prefix=%{prefix}

# make后面的意思是：如果是多处理器，则并行编译

make%{?_smp_mflags}

#安装阶段

%install

#先删除原来的测试安装的，只有在制作失败了%{buildroot}目录才会有内容，

#如果成功的话，目录下会被清除。

# %{buildroot}指向的目录不是BuildRoot（%_topdir/BUILDROOT）指定的目录，

#而是该目录下名称与生成的rpm包名称相同的子目录。例如我的是

# /usr/src/redhat/BUILDROOT/nginx-1.5.2-1.el6.x86_64

rm-rf %{buildroot}

#指定安装目录，注意不是真实的安装目录，是在制作rpm包的时候指定的

#安装目录，如果不指定的话，默认就会安装到configure命令中指定的prefix路径，

#所以这里一定要指定DESTDIR

makeinstall DESTDIR=%{buildroot}

#安装前执行的脚本，语法和shell脚本的语法相同

%pre

#安装后执行的脚本

%post

#卸载前执行的脚本，我这里的做的事情是在卸载前将nginx服务器停掉

%preun

   MSG=`ps aux | grep nginx | grep -v"grep"`

   if [ -z "$MSG" ];then

       killall nginx 1>/dev/null2>/dev/null

   fi

#卸载完成后执行的脚本

%postun

   rm -rf %{prefix}

#清理阶段，在制作完成后删除安装的内容

%clean

rm-rf %{buildroot}

#指定要包含的文件

%files

#设置默认权限，如果没有指定，则继承默认的权限

%defattr (-,root,root,0755)

%{prefix}

如果在制作的过程中报类似下面的错误，检查你的files区域，看要包含的文件是否存在。

error: File not found: /usr/src/redhat/BUILDROOT/

五、其他

1、扩展

a）就是%build和%install的过程中，都必须把编译和安装的文件定义到“虚拟根目录”中。

%build

make -f admin/Makefile.commoncvs
./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.8.0/GROUPS
各种宏定义：/usr/share/doc/rpm-4.8.0/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、如何编写%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则不能一概而论。

4、关于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/(具体路径还要看系统版本和rpmbuild版本)

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

七、附录：宏对应路径一览表

可以通过命令rpm --showrc查看实现代码。另外直接通过 rpm --eval"%{macro}"来查看具体对应路径。

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 thanFedora 10 (and EPEL), %{_initddir} does not exist. Instead, youshould 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} doesnot 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