送信先ターゲットの外部システムとの連携
特定のMACアドレスに対するWake on LANパケット送信先ターゲットのリストを外部システムに設置し、読み込むことができます。
ラベル名、MACアドレス、Wake on LANパケットの送信先を記述したテキストファイルを指定URLから定期的に取得し、wol コマンドで取得したラベル名を指定することができます。
リスト取得の動作
- 1回のリスト取得につき、20秒経過時点で取得が完了しない場合は取得失敗とみなします。
- リスト取得に失敗した場合は1分後に再取得を試み、最大10回リトライします。10回のリトライ以降のリスト取得、コンフィグにて設定された定期取得間隔に従います。
- リスト取得に成功するまでは、以前に取得したリストの内容を保持します。
- コマンドラインで設定した送信先ターゲット名と同一のラベル名が外部リストに記載されていた場合、外部リストの設定内容を優先します
送信先ターゲットリストの書式
Wake on LAN ターゲット機能の外部リストで使用するターゲットリストは、CSV(RFC4180)ファイルとして記述します。
PC01,11:22:33:44:55:66,lan0
PC02,22:33:44:55:66:77,192.168.0.101
#comment
PC02,22:33:44:55:66:77,192.168.0.101:8080
- 行頭が"#"である行はコメントとなります
- 空行は無視されます
MACアドレスに対するIPアドレスの払い出しの組み合わせはレコード（行）として記述し、各フィールド（列）の意味は以下の通りです。
| ターゲットリストのフィールド | フィールド名 | 入力形式 |
|---|---|---|
| 第1フィールド | ラベル名 | 1-32 文字，［ ? \ ” ］を除く |
| 第2フィールド | MACアドレス | MACアドレス形式 |
| 第3フィールド | 宛先IPアドレス または インタフェース名 | IPアドレス形式 または インタフェース名(<lan>, <vlan>) |
- 最大レコード数は128です。
- 最大レコード数を超えたレコードは無視されます
- フィールドの組み合わせが正常なレコードのみを有効レコード数としてカウントします。
- 入力するパラメータとして不正な文字列が指定されていた場合はエラーとなり、エラーとなった行をスキップして次の行の読み込みを行います。
- リストファイルのサイズが512KB以上の場合、エラーとなります。
Wake on LANパケット送信先ターゲットリストのエラー
Wake on LANパケット送信先ターゲットリストファイルは以下の条件に当てはまるとエラーとなり、取得失敗とみなされます。- Wake on LANパケット送信先ターゲットリストファイルのファイルサイズが512KB以上の場合、または読み込みに必要な空きメモリが不足している場合