inetd

- Solaris 管理工具委托的面向 inet 服务的重启程序

用法概要

inetd  [configuration-file] start |  stop |  refresh

 svc:/network/inetd:default

描述

inetd 是服务管理工具 (Service Management Facility, SMF) 委托的面向 Internet 服务的重启程序。其基本职责是管理服务状态以便响应管理请求、系统故障和服务故障；并在适当时侦听服务的网络请求。

服务不再通过编辑 inetd 配置文件 inetd.conf(4) 进行管理，而应使用 inetconv(1M) 将配置文件内容转换为 SMF 格式服务，然后使用 inetadm(1M) 和 svcadm(1M) 管理这些服务。inetconv 在对服务进行转换之后，对 inetd 配置文件中的旧数据所做的任何更改都不会生效。但是，当 inetd 发现配置文件进行了更改时，会通知管理员。有关详细信息，请参见“inetd 方法”一节下有关 start 方法的说明。

另请注意，当前 inetd 无法在 SMF 外部运行。这表示无法从命令行运行 inetd，而以前的 inetd 支持从命令行运行。如果您尝试执行此操作，则会向标准错误发送一条消息，该消息显示以前的 inetd 所支持的选项到 inetd 的 SMF 版本的映射。

inetd 代表处于 online 或 degraded 状态的所有服务侦听连接。当用户启用服务并且 inetd 尝试代表服务进行侦听时，该服务将进入上述状态之一。如果其他服务器（不管是单独的 Internet 服务还是第三方 Internet 服务）已在侦听同一端口，侦听尝试可能会失败。如果发生此种情况，inetd 会记录此条件，并继续尝试按配置的次数在配置的时间间隔绑定到此端口。有关更多详细信息，请参见下面“服务属性”下的属性 bind_fail_max。

启动 inetd 时，会读取由 inetd 管理的所有 SMF 服务的配置。刷新 inetd 时，会重新读取这些配置，在响应 SMF 请求或当 inetd 收到 SIGHUP 信号时会出现此种情况。有关配置刷新的行为，请参见“inetd 方法”下有关 refresh 方法的说明。

使用 inetadm(1M) 或 svccfg(1M) 实用程序可以对 SMF 系统信息库中的 Internet 服务进行配置更改。相较于 svccfg 而言，inetadm 的优势在于它提供了 Internet/RPC 服务上下文。

服务状态

inetd 为其管理的每个服务实现一台状态机，作为其服务管理职责的一部分。此计算机中的状态由 smf(5) 状态集组成。这些状态的语义如下所示：

uninitialized（未初始化）

inetd 尚未处理此服务。

online（联机）

服务正在处理新的网络请求，并且可能具有活动的现有连接。

degraded（降级）

服务可以侦听和处理为此服务指定的部分（而非所有）协议的请求，耗尽了其侦听重试次数，从而进入此状态。现有网络连接可能处于活动状态。

offline（脱机）

连接可能处于活动状态，但未在处理新请求。这是瞬时状态。服务可能因下列任何原因而处于 offline（脱机）状态：

• 不符合服务的相关性。如果符合服务相关性，将重新评估此服务的状态。

• 服务已超出其配置的连接速率限制 max_con_rate。服务的连接脱机计时器 con_rate_offline 过期时，将重新评估此服务的状态。

• 服务已达到其允许的活动连接数 max_copies。活动连接数降至 max_copies 以下时，将重新评估此服务的状态。

• inetd 无法代表服务侦听其所有协议。如上所述，inetd 最多按配置的最大次数在配置的时间间隔重试。侦听尝试成功或达到重试限制时，将重新评估此服务的状态。

disabled（禁用）

管理员已禁用服务，该服务不接受新连接，并且没有任何连接处于活动状态。需要管理员介入才能退出此状态。

maintenance（维护）

服务处于此状态的原因包括：服务错误运行且需要管理员注意，或者管理员已请求此状态。

导致错误运行的事件包括：inetd 在超出服务的绑定重试限制之前无法代表任何内容侦听服务的任何协议，非启动方法返回非成功返回值，以及服务超出其故障速率。

请求 maintenance 状态的目的是为了对服务执行维护，例如，应用修补级别。在此状态下，不会处理新请求，但现有连接可能处于活动状态。需要管理员介入才能退出此状态。

使用 inetadm(1M) 获取受管服务的当前状态。

服务方法

作为状态转换的一部分，inetd 将执行服务提供的某个方法集（如果提供）。支持的方法集包括：

inetd_start

执行此方法可处理 online 或 degraded 服务的请求。由于没有单独的状态来区分服务和活动连接，因此此方法不会作为状态转换的一部分执行。

inetd_offline

在服务从 online 或 degraded 状态转至 offline 状态时执行。对于在执行时执行其自己的侦听的 wait 类型的服务，此方法应当会导致此服务停止侦听。在禁用 online/degraded 服务的情况下，将在 disable 方法之前执行此方法。对于 wait 类型的服务，必须实现此方法。

inetd_online

在服务从 offline 状态切换到 online 状态时执行。此方法允许服务作者在服务开始处理请求之前执行某些准备工作。

inetd_disable

在服务从 offline 状态切换到 disabled 状态时执行。此方法应当会导致服务的任何活动连接终止。

inetd_refresh

在同时满足下列两个条件时执行：

• 通过框架或 SIGHUP 刷新 inetd，或者请求开始刷新服务，并且

• 服务当前处于 online 状态，并且没有需要将服务置于 offline 状态并重新联机的任何配置更改。

唯一强制性方法是 inetd_start 方法。在没有任何其他方法的情况下，inetd 不会运行任何方法，但其行为就像成功运行了某个方法一样。

服务属性

SMF 受管服务的配置存储在 SMF 系统信息库中。此配置包括服务的基本配置，服务的每个方法的配置以及缺省配置适用于所有 inetd 受管服务。

有关查看和修改服务配置及缺省值的详细信息，请参见 inetadm(1M)。

服务的基本配置存储在服务中名为 inetd 的属性组内。构成基本配置的这些属性如下所示：

bind_addr

服务应绑定到的网络接口的地址。导致服务接受任何网络接口上的连接的空字符串值。

bind_fail_interval

失败绑定尝试与重置之间的时间间隔（以秒为单位）。值 0 和 -1 指定是否不会尝试重试，并且处理第一次故障的方式是否与处理超出 bind_fail_max 的方式相同。

bind_fail_max

inetd 在放弃前重试绑定到服务的关联端口的最大次数。值 -1 指定不会强制任何重试限制。如果在达到任何强制限制前未绑定到服务协议，该服务将进入 maintenance 状态；否则，如果未绑定到所有协议，该服务将进入 degraded 状态。

con_rate_offline

服务超出其配置的最大连接速率 max_con_rate 时将保持脱机的时间（以秒为单位）。值 0 和 -1 指定是否禁用连接速率限制。

connection_backlog

后备队列大小。表示可在服务器的侦听端点中排队的传入客户机请求数目的限制。

endpoint_type

服务使用的套接字的类型或表示基于 TLI 的服务的值 tli。有效套接字类型值包括：stream、dgram、raw、seqpacket。

failrate_cnt

服务的故障速率限制的计数部分。故障速率限制适用于 wait 类型的服务，当在给定时间内启动服务的 count 实例时，将达到此限制。超出此速率将导致服务转换到 maintenance 状态。这与前面的 inetd 的行为不同，它会继续无限期地在每 10 分钟重试一次。failrate_cnt 在使用服务请求之前检查错误运行的服务器的计数，这些服务器将继续重新启动，从而耗费系统资源。故障速率等效于以前的 inetd 的 -r 选项。值 0 和 -1 指定是否禁用此功能。

failrate_interval

服务的故障速率的时间部分（以秒为单位）。值 0 和 -1 指定是否禁用此故障速率限制功能。

inherit_env

如果为 true，则将 inetd 的环境传递到服务的启动方法。不管此设置如何，inetd 都会在启动方法环境中设置变量 SMF_FMRI、SMF_METHOD 和 SMF_RESTARTER，以及在方法上下文中设置的任何环境变量。smf_method(5) 中介绍了这些变量。

isrpc

如果为 true，则为 RPC 服务。

max_con_rate

nowait 类型的服务允许的最大连接速率（以每秒连接数为单位）。值 0 和 -1 指定是否禁用连接速率限制。

max_copies

可并行运行的 nowait 服务的最大副本数。值 0 和 -1 指定是否禁用此副本限制。

name

可设置为以下值之一：

• getservbyname(3SOCKET) 已知的服务名称。

• 如果 isrpc 设置为 true，则为 getrpcbyname(3NSL) 已知的服务名称。

• 如果 isrpc 设置为 true，则为有效 RPC 程序编号。

proto

对于基于套接字的服务，此属性是服务支持的协议的列表。有效协议包括：tcp、tcp6、tcp6only、udp、udp6 和 udp6only。对于 TLI 服务，这是服务支持的 getnetconfigent(3NSL) 所识别的 netid 的列表以及值 tcp6only 和 udp6only。在此列表中，RPC/TLI 服务还支持 nettype，并且 inetd 首先尝试将列表成员解释为这些服务类型的 nettype。值 tcp6only 和 udp6only 是 inetd 中的新值，这些值请求 inetd 仅侦听并传递真正的 IPv6 请求（而非 IPv4 映射请求）。请参见下面的“为基于套接字的服务配置协议”。

rpc_low_version

支持的最低 RPC 版本。此参数在 isrpc 设置为 true 时是必需的。

rpc_high_version

支持的最高 RPC 版本。此参数在 isrpc 设置为 true 时是必需的。

tcp_keepalive

如果为 true，则允许在连接的套接字上定期传输消息。如果连接方无法响应这些消息，则将连接视为已断开。这仅适用于 endpoint_type 设置为 streams 且 wait 设置为 false 的服务。

tcp_trace

如果为 true，并且是 nowait 类型的服务，inetd 则会使用 syslog(3C) 工具针对每个传入连接记录客户机的 IP 地址和 TCP 端口号以及服务名称。inetd 使用 syslog 工具 code 守护进程以及 notice 优先级级别。有关 syslog 代码和严重级别的说明，请参见 syslog.conf(4)。此日志独立于 TCP 包装器工具执行的记录。

tcp_trace 等效于以前的 inetd 的 -t 选项（以及 /etc/default/inetd 属性 ENABLE_CONNECTION_LOGGING）。

tcp_wrappers

如果为 true，则启用 TCP 包装器访问控件。这仅适用于 endpoint_type 设置为 streams 且 wait 设置为 false 的服务。syslog 工具 code 守护进程用于记录允许的连接（使用 notice 严重级别）和拒绝的通信（使用 warning 严重级别）。有关 syslog 代码和严重级别的说明，请参见 syslog.conf(4)。TCP 包装器工具的接口稳定性及其配置文件容易发生变化。由于 TCP 包装器工具不受 Oracle 控制，因此版本内部经常发生不兼容情况。请参见 attributes(5)。

有关配置 TCP 包装器的更多信息，请参见 tcpd(1M) 和 hosts_access(4) 手册页，这些手册页作为 Solaris 操作系统的一部分在 /usr/sfw/man 中提供。这些手册页不包含在标准 Solaris 手册页中，可在 /usr/man 上获取。

tcp_wrappers 等效于以前的 inetd 的 /etc/default/inetd 属性 ENABLE_TCPWRAPPERS。

wait

如果为 true，则为 wait 类型的服务，否则为 nowait 类型的服务。wait 类型的服务具有下列特征：

• 其 inetd_start 方法将在执行时接管服务的绑定端点上的侦听职责。

• 执行此方法后，inetd 将等待此方法退出，然后才会恢复侦听职责。

数据报服务器必须配置为类型 wait，因为它们始终通过原始数据报端点进行调用，此端点将参与绑定到指定服务的服务的传送。它们没有单独的“侦听”和“接受”套接字。面向连接的服务（如 TCP 流服务）可设计为类型 wait 或 nowait。

服务的许多基本属性都是可选的。如果缺少这些属性，则会从 inetd 服务中的 defaults 属性组内提供的缺省值集获取这些属性的值。下面列出了这些属性及其种子值。请注意，这些值可通过 inetadm(1M) 进行配置。

bind_fail_interval  -1
bind_fail_max       -1
con_rate_offline    -1
connection_backlog  10
failrate_count      40
failrate_time       60
inherit_env         true
max_con_rate        -1
max_copies          -1
tcp_keepalive       false
tcp_trace           false
tcp_wrappers        false

为服务指定的每个方法的配置都存储在 SMF 系统信息库中与相应方法同名的属性组内。这些方法允许的属性集包括为 svc.startd(1M) 管理的服务指定的属性集。（有关更多详细信息，请参见 svc.startd(1M)。）此外，对于 inetd_start 方法，可以设置 arg0 属性。

arg0 属性允许与 inetd 服务一起使用外部包装器程序。具体而言，它允许将服务的启动方法的第一个参数 argv[0] 设置为除服务器程序路径以外的内容。

如果希望使用外部包装器程序，并将参数传递给服务的守护进程，应将这些参数作为包装器程序的参数合并到 exec 属性中。例如：

exec='/path/to/wrapper/prog service_daemon_args'
arg0='/path/to/service/daemon'

除 smf_method(5) 中提到的特殊方法标记以外，inetd 还对 wait 类型的服务支持 :kill_process 标记。这会导致与提供了 :kill 标记的行为相同的行为，但仅向 wait 类型的服务的 start 方法的父进程发送 kill 信号，而不是向其包含的进程合同的所有成员发送此信号（请参见 process(4)）。

为基于套接字的服务配置协议

当为基于套接字的服务配置 inetd 时，根据此服务支持的内容，可以选择在上面的 proto 属性下介绍的备用项。下面是要使用的 proto 值的准则：

• 对于仅支持 IPv4 的服务：则为 tcp 和 udp

• 对于仅支持 IPv6 的服务：则为 tcp6only 和 udp6only

• 对于同时支持 IPv4 和 IPv6 的服务：

  • 已过时且不推荐使用的值：tcp6 和 udp6

  • 建议值：使用两个仅在原始字段存在差异的单独项。其中一个项具有 tcp 值，另一个项具有 tcp6only 值；或者其中一个项具有 udp，另一个项具有 udp6only 值。

有关同时支持 IPv4 和 IPv6 的服务的配置示例，请参见“示例”。

inetd 方法

inetd 提供下面列出的方法，以供主重启程序 svc.startd(1M) 使用。

start

导致 inetd 开始提供服务。这会导致 inetd 开始处理其受管服务的 smf 请求以及处于 online 或 degraded 状态的服务的网络请求。

此外，inetd 还会检查自上次执行 inetconv(1M) 转换以来其监视的 inetd.conf(4) 格式的配置文件是否已发生更改。如果已发生更改，则会在 syslog 中记录一条消息，通知管理员重新运行 inetconv 以便实现所做的更改。

stop

导致 inetd 停止提供服务。此时，inetd 将未处于 maintenance 或 disabled 状态的各个服务转换为 offline 状态，同时在此过程中运行任何适当的方法。

refresh

导致针对每个受管服务执行刷新，并检查 inetd.conf(4) 格式配置文件中的更改（如在 start 方法中一样）。刷新服务时，其行为取决于服务的当前状态：

• 如果服务处于 maintenance 或 disabled 状态，则不会执行任何操作，因为将在此服务退出相应状态时读取和使用配置；

• 如果服务处于 offline 状态，则会读取配置并立即使用任何更改。

• 如果服务处于 online 或 degraded 状态，并且配置已发生更改且必须执行重新绑定才能与配置相符，服务将使用绑定的新配置转换到 offline 状态并重新联机；

• 如果服务处于 online 状态，并且不需要重新绑定，则将运行此服务的 inetd_refresh 方法（如果提供），以便允许 online wait 类型的服务使用任何其他更改。

选项

不支持任何选项。

操作数

configuration-file

为旧服务文件 (inetd.conf(4)) 指定一个备用位置。

start|stop|refresh

指定应当运行的 inetd 方法。

示例

示例 1 配置同时支持 IPv4 和 IPv6 的服务

下面的命令演示同时支持 IPv4 和 IPv6 的现有服务以及如何向这些服务分配 proto 属性。

example# svcs -a | grep mysvc
online         15:48:29 svc:/network/mysvc:dgram4
online         15:48:29 svc:/network/mysvc:dgram6
online         15:51:47 svc:/network/mysvc:stream4  
online         15:52:10 svc:/network/mysvc:stream6  
 
# inetadm -M network/rpc/mysvc:dgram4 proto=udp
# inetadm -M network/rpc/mysvc:dgram6 proto=udp6only
# inetadm -M network/rpc/mysvc:stream4 proto=tcp
# inetadm -M network/rpc/mysvc:stream6 proto=tcp6only

有关这些命令的说明，请参见 svcs(1) 和 inetadm(1M)。

属性

有关以下属性的说明，请参见 attributes(5)：

另请参见

fmd(1M)、inetadm(1M)、inetconv(1M)、svcadm(1M)、svccfg(1M)、svcs(1)、svc.startd(1M)、syslog(3C)、getnetconfigent(3NSL)、getrpcbyname(3NSL)、getservbyname(3SOCKET)、inetd.conf(4)、process(4)、syslog.conf(4)、attributes(5)、smf(5)、smf_method(5)

附注

inetd 守护进程与 Solaris 9 及早期 Solaris 操作系统版本中的同名守护进程执行相同的功能，但两者的实现方式有很大区别。在当前的 Solaris 发行版中，inetd 是 Solaris 管理工具（请参见 smf(5)）的一部分，并且将仅在此工具中运行。

/etc/default/inetd 文件已过时。属性 ENABLE_CONNECTION_LOGGING 和 ENABLE_TCP_WRAPPERS 表示的功能现在分别作为 tcp_trace 和 tcp_wrappers 属性使用。上文中的“服务属性”下介绍了这些属性。