送信先ターゲットの外部システムとの連携

特定の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以上の場合、または読み込みに必要な空きメモリが不足している場合

重複に関する注意

ラベル名が重複した場合、リストの下方に記述された行が優先されます。