smf_restarter

- 重启程序的服务管理工具约定

描述

服务管理工具中的所有服务实例都必须由重启程序来管理。本手册页介绍该框架中所有重启程序共有的配置、功能和报告特性。特定重启程序独有的特性将在重启程序的手册页中介绍。

对于每个管理服务，重启程序依赖在服务实例上检索属性来确定配置。重启程序管理一组属性组，以此向显示工具（如 svcs(1)）传送服务的当前处置情况。

服务配置

所有服务的常见重启程序配置均在 general 属性组中捕获。此组包含以下必需和可选的属性设置。

enabled

此属性是必需的。如果设置此属性，实例的重启程序会尝试维护服务的可用性。

restarter

此属性是可选的，允许指定备用重启程序管理服务实例。如果 restarter 属性为空或缺失，则重启程序缺省为 svc.startd(1M)。

single_instance

此属性是可选的。如果设置此属性，在任意时间将只允许一个服务实例转换为联机或降级状态。

服务报告

所有重启程序均使用 restarter 属性组报告状态，该属性组包含以下属性：

next_state

存储在这些属性中的实例的当前状态和下一状态（如果当前处于转换中）。有关可能的状态的说明，参见 smf(5)。

auxiliary_state

一个不带空格的 astring，包含描述完整重启程序特定的状态以及重启程序状态属性的准确术语。不能一直设置辅助状态，在从任何状态进行转换期间应始终将其清除。每个重启程序都必须定义它所使用的辅助状态的精确列表。

state_timestamp

访问当前状态的时间。

contract

执行服务实例所依据的主进程合同 ID（如果有）。

另请参见

svcs(1)、svc.startd(1M)、service_bundle(4)、smf(5)、smf_method(5)