日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
WATCHDOGD(8) FreeBSD システム管理者マニュアル WATCHDOGD(8)
名称
watchdogd -- ウォッチドッグデーモン
書式
watchdogd [-dnSw] [--debug] [--softtimeout] [--softtimeout-action action]
[--pretimeout timeout] [--pretimeout-action action] [-e cmd]
[-I file] [-s sleep] [-t timeout] [-T script_timeout]
[-x exit_timeout]
解説
watchdogd ユーティリティは、システムが動作状態にあることを保証するために
カーネルのウォッチドッグ機能とインタフェースをとります。watchdogd が特定
のタイムアウト上でカーネルとのインタフェースをとることができないなら、
カーネルは、コンピュータをデバッグするか、再スタートすることを助けるため
の処置を取ります。
-e cmd が指定されるなら、watchdogd は、system(3) でこのコマンドを実行する
ことを試み、コマンドが 0 終了コードで返る場合のみウォッチドッグは、リセッ
トされます。-e cmd が指定されないなら、デーモンは、代わりに通常のファイル
システムチェックを実行します。
-n 引数 'dry-run' によって、ウォッチドッグは、システムウォッチドッグを作
動可能にせず、代わりに、ウォッチドッグ機能のみを実行し、失敗時に報告しま
す。これは、スクリプトに問題があるなら、システムがリブートしないように、
新しい watchdogd スクリプトを開発するために役に立ちます。
-s sleep 引数は、チェックの各実行の間でスリープ期間を制御するために使用す
ることができます、デフォルトは、10 秒です。
-t timeout は、秒単位で必要なタイムアウトの期間を指定します。デフォルトの
タイムアウトは、128 秒です。
ウォッチドッグタイムアウトを引き起こす 1 つのあり得る状況は、割り込みス
トーリムです。これが起こるなら、watchdogd は、もはや実行しないで、その結
果カーネルのウォッチドッグルーチンは、設定可能なタイムアウトの後で処置し
ます。
-T script_timeout は、watchdogd が、そのスクリプトがあまりにも長い間実行
したとエラーを出す、しきい値を (秒単位で) 指定します。設定されていないな
ら、script_timeout は、-s sleep オプションによって指定された値をデフォル
トとします。
-x exit_timeout 引数は、プログラムが終了するとき、実際に退去する (秒単位
の) タイムアウト期間です。0 以外の値で -x を使用することは、ソフトウェア
のリブートが与えられたタイムアウトが満了する前に完了しないなら、ハード
ウェアのリセットをトリガすることによってリブートの間に検索に対して保護し
ます。
SIGTERM または SIGINT シグナルを受信すると、watchdogd は、タイムアウトを
無効にするか、または -x exit_timeout によって与えられた値にリセットするか
のいずれかにするようにカーネルを最初に指示した後に、終了します。
watchdogd ユーティリティは、次の実行時オプションを認識します:
-I file 指定されたファイルに watchdogd ユーティリ
ティのプロセス ID を書き込みます。
-d --debug フォーク (fork) しません。このオプション
が指定されるとき、watchdogd は、始動時
に、バックグラウンドにフォークしません。
-S ウォッチドッグコマンドが実行するために予
想されたより長くかかるなら、システムのロ
グ記録プログラム (logger) にメッセージを
送りません。デフォルトの振る舞いは、
LOG_DAEMON 機能があるシステムのログ記録プ
ログラム (logger) を通して警告をログ記録
し、標準エラーに警告を出力することです。
-w ウォッチドッグのスクリプトがあまりにも長
くかかるとき、エラーを出します。このフラ
グによって watchdogd は、ウォッチドッグの
スクリプトを実行する時間が 'sleep' オプ
ションのしきい値を越えるとき、エラーを出
します。
--pretimeout timeout "pretimeout" ウォッチドッグを設定します。
ウォッチドッグがアクションの開始を試みる
前の "タイムアウト" 秒。アクションは、
--pretimeout-action フラグによって設定さ
れます。デフォルトは、log(9) によってメッ
セージ (WD_SOFT_LOG) を単にログ記録するこ
とです。
--pretimeout-action action pretimeout のためのタイムアウトアクション
を設定します。セクション「タイムアウトア
クション」を参照してください。
--softtimeout 様々なハードウェアのウォッチドッグを作動
可能にする代わりに、基本ソフトウェア
ウォッチドッグだけを使用します。デフォル
トのアクションは、メッセージ
(WD_SOFT_LOG) を単に log(9) (ログ記録) す
ることです。
--softtimeout-action action softtimeout のためにタイムアウトアクショ
ンを設定します。セクション「タイムアウト
アクション」を参照してください。
タイムアウトアクション
次のタイムアウトアクションは、--pretimeout-action と --softtimeout-action
フラグによって利用可能です:
panic タイムアウトに到達するとき、panic(9) を呼び出します。
ddb タイムアウトに到達するとき、kdb_enter(9) によってカーネルデバッガ
に入ります。
log タイムアウトに到達するとき、log(9) を使用してメッセージをログ記録
します。
printf コンソールと dmesg(8) バッファへのメッセージを表示するためにカー
ネル printf(9) を呼び出します。
次のようにコンマで区切られたリストでアクションを組み合わせることができま
す: log,printf は、printf(9) と log(9) の両方を実行し、log(9) は、
dmesg(8) と syslogd(8) のためのカーネル log(4) デバイスの両方にメッセージ
を送ります。
関連ファイル
/var/run/watchdogd.pid
使用例
watchdogd および利用者のウォッチドッグスクリプトのデバッグ
これは、watchdogd と利用者のウォッチドッグスクリプトをデバッグするための
役に立つ方策です。
(watchdogd は、system(3) を呼び出し、それで、最初の ^C が "sleep" コマン
ドを終了するので、^C は、奇数で動作することに注意してください。)
オプションの説明は、次を使用します:
1. デバッグをオンに設定します (--debug)
2. ウォッチドッグを 30 秒で外すように設定します。
3. softtimeout の使用:
3.1. (ハードウェアウォッチドッグを装備しない) soft
timeout を使用します。(--softtimeout)
3.2. softtimeout アクションを、それが外れるとき、両方
のカーネル printf(9) と log(9) を行なうように設定
します。(--softtimeout-action log,printf)
4. 事前タイムアウトの使用:
4.1. 15 秒の事前タイムアウトを設定します (これは、後で
パニック/ダンプを引き起こします)。(--pretimeout
15)
4.2. また、アクションを、それが外れるとき、カーネル
printf(9) と log(9) に設定します。(--pretimeout
action log,printf)
5. スクリプトの使用:
5.1. ウォッチドッグ (-e 'sleep 60') として動作するシェ
ルコマンドとして "sleep 60" を実行します
5.2. スクリプトが実行するために (-w) 1 秒より長くかか
るとき、警告します
watchdogd --debug -t 30 \
--softtimeout --softtimeout-action log,printf \
--pretimeout 15 --pretimeout-action log,printf \
-e 'sleep 60' -w
使用例の生産的使用
1. ハードのタイムアウトを 120 秒 (-t 120) に設定します
2. (ダンプ解析のために crash(8) を引き起こすために) 60 秒でパニッ
クを起こるように設定します:
2.1. 事前タイムアウトの使用 (--pretimeout 60)
2.2. 事前タイムアウトのアクションを指定します (--pre
timeout-action log,printf,panic )
3. スクリプトの使用:
3.1. 利用者のスクリプトを実行する (-e
'/path/to/your/script 60')
3.2. 利用者のスクリプトが実行時に 15 秒より長くかかる
ならログを記録します。(-w -T 15)
watchdogd -t 120 \
--pretimeout 60 --pretimeout-action log,printf,panic \
-e '/path/to/your/script 60' -w -T 15
関連項目
watchdog(4), watchdog(8), watchdog(9)
歴史
watchdogd ユーティリティは、FreeBSD 5.1 で登場しました。
作者
watchdogd ユーティリティとマニュアルページは、Sean Kelly
<smkelly@FreeBSD.org> と Poul-Henning Kamp <phk@FreeBSD.org> によって書か
れました。
いくつかの貢献が Jeff Roberson <jeff@FreeBSD.org> によって行われました。
pretimeout と softtimeout アクションシステムは、Alfred Perlstein
<alfred@freebsd.org> によって追加されました。
FreeBSD 12.2 May 11, 2015 FreeBSD 12.2