为gated提供一个可操作的用户界面。
gdc [ -q ] [ -n ] [ -c 核心大小 ] [ -f 文件大小 ] [ -m 资料大小 ] [ -s 堆栈大小 ] [ -t 秒钟 ] 子命令
gdc 命令为gated 路由守护进程的操作提供了一个面向用户的界面。它为下列提供支持:
gdc 命令可以非常可靠地决定gated的运行状态,并能在错误发生时产生可靠的退出状态。这一点使它在用于操作gated的 shell 脚本中时有利。用 gdc 执行的命令,以及可选地,由这些命令的执行而产生的错误消息将通过同一syslogd设备记录日志,这些设备都是gated自身使用的,用于对在守护进程上执行的操作进行审计跟踪。
下列子命令可以使信号被送至gated,用于各种目的:
COREDUMP | 向gated发送一个异常终止信号,使它终止并产生核心转储。 |
转储 | 向 gated 发信号将其当前状态转储到文件 /var/tmp/gated_dump 中。 |
interface | 向 gated 发信号以重新检查界面配置。gated通常在任何事件中周期性地重复这一工作,但此功能可被用于促使守护进程在发现有变更发生时,立即检查其界面状态。 |
KILL | 使gated不正常地终止。 |
reconfig | 向 gated 发信号使其重新阅读其配置文件,从而按适当的情况重新配置其当前状态。 |
term | 向 gated 发信号使其在正常地关闭所有正在运行的路由协议后终止。即使一些协议还没有完全关闭,执行第二次该命令会使gated终止。 |
toggletrace | 使跟踪处于暂挂状态,而且如果gated目前正在跟踪一个文件的话,关闭跟踪文件。如果gated跟踪目前处于暂挂状态,则该子命令会使跟踪文件重新打开,启动跟踪。这对移动跟踪文件非常有用。 |
下列子命令可以进行与配置文件相关的操作。
checkconf | 检查 /etc/gated.conf 是否有语法错误。在改变配置文件之后和发送一个 reconfig 信号到当前正在运行的 gated 之前这样做会非常有用,能确保配置中没有错误,这些错误可以使运行的 gated 在重新配置时被终止。当使用这一命令时,gdc 发送一个信息消息,来提示是否有分析错误。如果有的话,它会把错误输出保存在文件中以备检查。 |
checknew | 这一任务类似于checkconf,其不同之处在于它检查的是新配置文件 /etc/gated.conf+。 |
newconf | 将 /etc/gated.conf+ 文件作为 /etc/gated.conf 移动到位,如上面描述的那样,保留文件的旧版本。给出此命令时,gdc 将拒绝做任何事情,如果新配置文件不存在或看起来可疑时。 |
backout | 将配置文件向更新的方向旋转,实际上就是将旧的配置文件改名为 /etc/gated.conf。如果 /etc/gated.conf- 不存在或长度为 0,或者此操作将删除长度不为 0 的现有文件 /etc/gated.conf+,此命令将拒绝执行该操作。 |
BACKOUT | 执行逆序恢复操作,即便是 /etc/gated.conf+ 存在且长度不为 0。 |
modeconf | 将所有配置文件方式设置为 664、所有者为 root 用户和组为 system。 |
createconf | 如果 /etc/gated.conf+ 不存在,创建一个长度为 0 的文件。该文件的方式设为 664、所有者 root 用户和组系统。 |
下列子命令为启动和停止gated以及决定其运行状态提供支持:
running | 决定gated目前是否正在运行。这可以通过检查 gated 是否锁定了包含其 pid 的文件,该文件中的 pid 是否是敏感的以及是否有带该 pid 的进程正在运行来完成。如果gated正在运行,退出且退出状态为0,否则退出状态为非0。 |
start | 启动gated。如果gated已经处于运行状态,那么命令则返回一个错误。否则它将执行gated 二进制文件并一直等到延迟间隔时间(缺省设置为 10 秒,否则在 -t 选项中设置),直到新启动的进程在进程标识文件中获取一个锁为止。如果在执行二进制文件时检测到错误,或在指定的等待时间内,在进程标识文件中无法获取锁的话,则返回非零退出状态。 |
stop | 如果可能的话,适当地停止gated;如果不行的话,则非正常地停止。如果gated目前没有处于运行状态,则命令返回一个错误(非零退出状态)。否则,它将向gated发送一个终止信号,并等候最多延迟间隔时间(缺省值为 10 秒,否则在-t 选项中指定)以使进程退出。如果gated无法在延迟间隔时间内退出,则它会再次发送一个终止信号。如果在第二个延迟间隔时期结束后仍无法退出,则会用 kill 信号第三次向其发送信号。这将迫使其立即终止,除非其中什么坏了。当命令检测到gated已经终止时,命令以 0 退出状态终止,否则以非零退出状态终止。 |
restart | 如果gated正在运行,那么可以通过用于上面的stop命令相同的过程将其终止。当前一个gated终止时,或如果它在命令执行前仍未运行, 那么一个新的gated进程将通过使用上面 start命令中所描述的过程执行。如果这个过程中的任何一步失败的话,就会返回一个非零退出状态。 |
对于通过执行上面的一些命令而创建的文件,可以用下列子命令将其除去:
rmcore | 除去任何已有的gated核心转储文件。 |
rmdump | 除去任何已有的gated状态转储文件。 |
rmparse | 当执行一个checkconf或checknew命令,并且在被检查的配置文件中发现语法错误时,除去生成的分析错误文件。 |
下列子命令可以显示gated的版本信息:
version | 显示gated的版本信息。当这一命令被执行时,gated不能已经处于运行状态。没有gdc 选项用于此命令。 |
缺省情况gated从一个通常命名为/etc/gated.conf的文件中获取其配置。gdc 程序也保留配置文件的几个其他版本,尤其是以下列名称命名的版本:
/etc/gated.conf+ | 新配置文件。当要求 gdc 安装一个新配置文件时,该文件被重命名为 /etc/gated.conf。 |
/etc/gated.conf- | 旧的配置文件。当 gdc 被要求安装一个新的配置文件时,原来的 /etc/gated.conf 被重命名为这个名字。 |
/etc/gated.conf-- | 真正的旧配置文件。 gdc 在这一名字下保留原有的旧配置文件。 |
/usr/sbin/gated | gated 二进制文件。 |
/etc/gated.conf | 当前的 gated 配置文件。 |
/etc/gated.conf+ | 更新的配置文件 |
/etc/gated.conf- | 旧一些的配置文件 |
/etc/gated.conf-- | 更旧的配置文件 |
/etc/gated.pid | gated存储其进程标识的地方。 |
/var/tmp/gated_dump | gated的状态转储文件。 |
/var/tmp/gated.log | 配置文件分析错误要去的地方。 |