编写类操作脚本

定义对象类

对象类允许在安装或删除时对一组软件包对象执行一系列操作。您需要在 prototype 文件中将对象指定给一个类。必须为所有软件包对象指定类，但是缺省情况下将为无需特殊操作的对象指定 none 类。

在 pkginfo 文件中定义的安装参数 CLASSES 是将安装的类的列表（包括 none 类）。

pkgmap 文件中定义的、属于未在 pkginfo 文件的此参数中列出的类的对象将不会被安装。

CLASSES 列表确定安装顺序。类 none 总是首先安装（如果有）而且最后删除。因为目录是所有其他文件系统对象的基础支持结构，因此应将所有目录指定给 none 类。通常使用 none 类是最安全的，虽然也可能有例外情况。此策略可确保在创建目录包含的对象之前创建目录。此外，不会在一个目录清空之前尝试删除该目录。

软件包安装期间如何处理类

下面描述了安装类时发生的系统操作。操作针对软件包的每个卷都会重复执行一次（在该卷进行安装时）。

1. pkgadd 命令创建路径名列表。

   pkgadd 命令创建操作脚本处理的路径名列表。此列表的每一行都包含源路径名和目标路径名，由空格分隔。源路径名指明要安装的对象在安装卷上所处的位置。目标路径名指明应将该对象安装到的目标系统上的位置。列表的内容受以下条件限制：

   • 列表只包含属于关联类的路径名。

   • 如果尝试创建软件包对象失败，那么目录、命名管道、字符设备、块设备和符号链接将会包括在列表中，且源路径名设置为 /dev/null。通常，这些项目由 pkgadd 命令自动创建（如果尚不存在），并根据 pkgmap 文件中的定义被赋予适当的属性（模式、所有者、组）。

   • 文件类型为 l 的链接文件在任何情况下都不会包括在列表中。指定类中的硬链接在项目 4 中创建。

2. 如果没有针对某个特定类的安装提供类操作脚本，则生成的列表中的路径名将会从卷复制到相应的目标位置。

3. 执行类操作脚本（如果存在）。

   将会使用包含项目 1 中生成的列表的标准输入调用类操作脚本。如果该卷是软件包的最后一个卷，或者该类中不再有对象存在，则将使用单个参数 ENDOFCLASS 执行该脚本。

   ---

   注 –

   即使软件包中不存在该类的常规文件，也会使用一个空列表和 ENDOFCLASS 参数至少调用类操作脚本一次。

   ---

4. pkgadd 命令执行内容和属性审计，并创建硬链接。

   成功执行项目 2 或 3 之后，pkgadd 命令将审计路径名列表的内容和属性信息。pkgadd 命令会自动创建与类关联的链接。将为生成的列表中的所有路径名更正检测到的属性不一致性。

软件包删除期间如何处理类

对象是按逐个类删除的。对于软件包存在但未在 CLASSES 参数中列出的类将首先被删除（例如，使用 installf 命令安装的对象）。CLASSES 参数中列出的类按相反顺序删除。none 类总是最后删除。下面描述了删除类时发生的系统操作：

1. pkgrm 命令创建一个路径名列表。

   pkgrm 命令创建属于指定类的已安装路径名的列表。其他软件包引用的路径名将会从列表中排除，除非其文件类型为 e。e 文件类型表示该文件应该在安装或删除时进行编辑。

   如果正被删除的软件包在安装期间修改了任何类型为 e 的文件，该软件包应只删除它添加的行。请勿删除一个非空的可编辑文件。删除软件包添加的行。

2. 如果不存在类操作脚本，将会删除路径名。

   如果您的软件包没有类的删除类操作脚本，将会删除 pkgrm 命令生成的列表中的所有路径名。

   ---

   注 –

   文件类型为 e（可编辑）的文件不会指定给类和关联的类操作脚本。这些文件将在此时被删除，即使路径名与其他软件包共享。

   ---

3. 如果类操作脚本存在，将会执行该脚本。

   pkgrm 命令使用包含项目 1 中生成的列表的脚本标准输入来调用类操作脚本。

4. pkgrm 命令执行审计。

   成功执行类操作脚本之后，pkgrm 命令会从软件包数据库删除对路径名的引用，除非路径名由其他软件包引用。

类操作脚本

类操作脚本定义一组将在安装或删除软件包期间执行的操作。将会根据其类定义对一组路径名执行这些操作。有关类操作脚本的示例，请参见第 5 章。

类操作脚本根据它将处理的类以及这些操作是在软件包安装还是删除期间发生来命名。下表中显示了两种名称格式：

例如，名为 manpage 的类的安装脚本名称将是 i.manpage，删除脚本名称将是 r.manpage。

这种文件名格式不适用于属于 sed、awk 或 build 系统类的文件。有关这些特殊类的更多信息，请参见特殊系统类。

类操作脚本行为

• 类操作脚本以 uid=root 和 gid=other 执行。

• 将会为当前卷上指定类的所有文件执行脚本。

• pkgadd 和 pkgrm 命令创建 pkgmap 文件中列出的属于该类的所有对象的列表。因此，类操作脚本只能处理在 pkgmap 中定义的属于特定类的路径名。

• 当最后一次执行类操作脚本时（即不再有属于该类的文件），将会使用关键字参数 ENDOFCLASS 执行类操作脚本一次。

• 在类操作脚本执行期间不允许与管理员交互。

类操作脚本的设计规则

• 如果一个软件包分布在多个卷上，则类操作脚本将针对至少包含属于类的一个文件的每个卷执行一次。因此，每个脚本必须能够多次执行。这意味着使用同一输入执行脚本任意次数时，必须产生与只执行脚本一次相同的结果。

• 当文件属于具有类操作脚本的类时，脚本必须安装该文件。pkgadd 命令不安装有类操作脚本的文件，虽然它确实执行安装验证。

• 类操作脚本绝不应添加、删除或修改不出现在 pkgadd 命令生成的列表中的路径名或系统属性。有关此列表的更多信息，请参见软件包安装期间如何处理类中的项目 1。

• 当脚本发现 ENDOFCLASS 参数时，会将后续处理操作（例如清除）放到脚本中。

• 所有管理员交互仅限于 request 脚本。请勿尝试使用类操作脚本从管理员获取信息。

特殊系统类

系统提供四个特殊类：

• sed 类

  提供一种使用 sed 指令在安装和删除软件包时编辑文件的方法。

• awk 类

  提供一种使用 awk 指令在安装和删除软件包时编辑文件的方法。

• build 类

  提供一种使用 Bourne shell 命令动态构建或修改文件的方法。

• preserve 类

  提供一种保留不应被将来的软件包安装覆写的文件的方法。

• manifest 类

  提供与清单相关联的服务管理工具 (Service Management Facility, SMF) 服务的自动安装和卸载。manifest 类应用于软件包中的所有 SMF 清单。

如果一个软件包中的多个文件需要的特殊处理可完全通过 sed、awk 或 sh 命令定义，则使用系统类安装的速度比使用多个类及其对应类操作脚本更快。

sed 类脚本

sed 类提供了一种修改目标系统上现有对象的方法。如果存在属于 sed 类的文件，sed 类操作脚本将在安装时自动执行。sed 类操作脚本的名称应该与对其执行指令的文件的名称相同。

sed 类操作脚本按以下格式提供 sed 指令：

两个命令指定应执行指令的时间。位于 !install 命令之后的 sed 指令在软件包安装期间执行。位于 !remove 命令之后的 sed 指令在软件包删除期间执行。这些命令在文件中的使用顺序无关紧要。

有关 sed 指令的更多信息，请参见 sed(1) 手册页。有关 sed 类操作脚本的示例，请参见第 5 章。

awk 类脚本

awk 类提供了一种修改目标系统上现有对象的方法。这些修改将以 awk 类操作脚本中的 awk 指令实现。

如果存在属于 awk 类的文件，awk 类操作脚本将在安装时自动执行。这类文件包含如下格式的 awk 类脚本指令：

两个命令指定应执行指令的时间。位于 !install 命令之后的 awk 指令在软件包安装期间执行。位于 !remove 命令之后的指令在软件包删除期间执行。可按照任意顺序使用这些命令。

awk 类操作脚本的名称应该与对其执行指令的文件的名称相同。

待修改的文件用作 awk 命令的输入，该脚本的输出最终将替换原始对象。使用该语法可能不会将环境变量传递给 awk 命令。

有关 awk 指令的更多信息，请参见 awk(1) 手册页。

build 类脚本

build 类可通过执行 Bourne shell 指令创建或修改软件包对象文件。这些指令作为软件包对象提供。如果该软件包对象属于 build 类，这些指令将会在安装时自动运行。

build 类操作脚本的名称应该与对其执行指令的文件的名称相同。该名称还必须可由 sh 命令执行。该脚本的输出将成为生成或修改后的文件新版本。如果脚本未生成任何输出，表明没有创建或修改该文件。因此，该脚本可以修改或创建文件本身。

例如，如果软件包提供了一个缺省文件 /etc/randomtable，并且目标系统上尚不存在该文件，则 prototype 文件条目可能如下所示：

e build /etc/randomtable ? ? ?

软件包对象 /etc/randomtable 可能如下所示：

!install
# randomtable builder
if [ -f $PKG_INSTALL_ROOT/etc/randomtable ]; then
		echo "/etc/randomtable is already in place.";
	    else
		echo "# /etc/randomtable" > $PKG_INSTALL_ROOT/etc/randomtable
		echo "1121554	# first random number" >> $PKG_INSTALL_ROOT/etc/randomtable
fi
 
!remove
# randomtable deconstructor
if [ -f $PKG_INSTALL_ROOT/etc/randomtable ]; then
		# the file can be removed if it's unchanged
		if [ egrep "first random number" $PKG_INSTALL_ROOT/etc/randomtable ]; then
			rm $PKG_INSTALL_ROOT/etc/randomtable;
		fi
fi
 

有关使用 build 类的另一个示例，请参见第 5 章。

preserve 类脚本

preserve 类通过确定在安装软件包时是否要覆写现有文件来保留软件包对象文件。使用 preserve 类脚本时的两种可能情况是：

• 如果将安装的文件在目标目录中尚不存在，通常将安装该文件。

• 如果将安装的文件存在于目标目录中，将显示一条消息指出该文件已存在，此时将不会安装该文件。

preserve 脚本会将上述两种情况的结果都视为成功。只有在第二种情况中当文件无法复制到目标目录时才会失败。

自 Solaris 7 发行版开始，i.preserve 脚本以及该脚本的一个副本 i.CONFIG.prsv 以及其他类操作脚本都可在 /usr/sadm/install/scripts 目录中找到。

可修改该脚本以包括您希望保留的一个或多个文件名。

manifest 类脚本

manifest 类会自动安装或卸载与 SMF 清单相关联的服务管理工具 (Service Management Facility, SMF) 服务。如果您不熟悉 SMF，请参见《系统管理指南：基本管理》中的第 16  章 “管理服务（概述）”，获取有关如何使用 SMF 来管理服务的信息。

软件包中的的所有服务清单都应由类 manifest 来标识。安装和移除服务清单的类操作脚本包含在软件包子系统中。调用 pkgadd(1M) 时，会导入此服务清单。调用 pkgrm(1M) 时，会删除服务清单中禁用的实例。还会删除清单中没有保留实例的所有服务。如果将 -R 选项提供给 pkgadd(1M) 或 pkgrm(1M)，在系统下一次以备用引导路径重新引导时，才会完成这些服务清单操作。

以下软件包信息文件中的部分代码显示了 manifest 类的用法。

# packaging files
i pkginfo
i copyright
i depend
i preinstall
i postinstall
i i.manifest
i r.manifest
#
# source locations relative to the prototype file
#
d none var 0755 root sys
d none var/svc 0755 root sys
d none var/svc/manifest 0755 root sys
d none var/svc/manifest/network 0755 root sys
d none var/svc/manifest/network/rpc 0755 root sys
f manifest var/svc/manifest/network/rpc/smserver.xml 0444 root sys