.\"	$KAME: rtsold.8,v 1.20 2003/04/11 12:46:12 jinmei Exp $
.\"
.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the project nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	%FreeBSD: src/usr.sbin/rtsold/rtsold.8,v 1.12 2003/08/17 11:11:32 ume Exp %
.\"
.\" $FreeBSD$
.\" WORD: mobility	可搬性 [WIDE IPv6 working group]
.\" WORD:
.Dd May 17, 1998
.Dt RTSOLD 8
.Os
.\"
.Sh 名称
.Nm rtsold , rtsol
.Nd ルータ要請デーモン
.\"
.Sh 書式
.Nm
.Op Fl dDfm1
.Op Fl O Ar script-name
.Ar interface ...
.Nm
.Op Fl dDfm1
.Op Fl O Ar script-name
.Fl a
.Nm rtsol
.Op Fl dD
.Op Fl O Ar script-name
.Ar interface ...
.Nm rtsol
.Op Fl dD
.Op Fl O Ar script-name
.Fl a
.\"
.Sh 解説
.Nm
ユーティリティは、
ICMPv6 ルータ要請メッセージを、指定されたインタフェース上で送信します。
ノードがリンクに (再) 接続された場合、
.Nm
は、リンクローカルスコープの全ルータ宛マルチキャストアドレスへ、
ルータ要請メッセージを送信します。
これは、
新規ルータを発見して非リンクローカルアドレスを取得することを目的としています。
.Pp
.Nm
ユーティリティは、IPv6 ホスト
.Pq 非ルータノード
のみで実行すべきです。
.Pp
本プログラムを
.Nm rtsol
として起動した場合、デーモンにならずに、プローブを指定した
.Ar interface
から送出します。
言い換えるなら、
.Nm rtsol
は
.Do
.Nm
.Fl f1
.Ar interfaces
.Dc
のように動作します。
.Pp
特に
.Nm
は、次のいずれかのイベント後に、
最大 3 個のルータ要請を単一インタフェースから送信します:
.Pp
.Bl -bullet -compact
.It
.Nm
デーモンの起動直後。
.It
一時的なインタフェース障害後のインタフェース立ち上げ。
.Nm
ユーティリティは、定期的にインタフェースの状態が活動中か否かを調べ、
この種の障害を検出します。
ネットワークカードとドライバによっては、
リンク状態を引き出すことを許さないものがあることに注意してください。
このような場合、
.Nm
はインタフェース状態の変化を検出できません。
.It
.Fl m
オプションが指定され、
.Nm
デーモンがインタフェース状態を取得できない場合、60 秒毎。
この機能は IPv6 近隣探索仕様に適合しませんが、
可搬ステーション用に提供されています。
ルータ通知のデフォルトインターバルは 10 分単位ですが、
これは可搬ステーションにとってはやや長いです。
この機能はこのようなステーション用に提供されており、
ステーションが他のリンクに接続された後
すみやかに新しいルータを発見できるようにします。
.El
.Lp
ひとたび
.Nm
がルータ要請を送信して有効なルータ通知を受信すると、
前述のいずれかのイベントが発生するまで、
このインタフェースからはもう要請を送信しなくなります。
.Lp
インタフェース上でルータ要請を送信するとき、
このインタフェースがリンク層アドレスを持つ場合には、
.Nm
は始点リンク層アドレスオプションを含めます。
.Lp
.Nm
はインタフェース毎のパラメータを管理し、
ホストアドレス以外の設定パラメータのために別のプロトコルが必要かどうか
検出します。
起動時には、このフラグは FALSE ですが、
OtherConfig フラグがセットされたルータ通知をデーモンが受け取ると、
このフラグは TRUE になります。
この場合を取り扱うスクリプトを指定可能です
.Pq 後述
。
条件イベントのいずれかにより
.Nm
がルータ要請メッセージを再送開始すると、
デーモンはこのパラメータをリセットします。
これは、当該イベントが接続リンクの変更を意味するかもしれないからです。
.Pp
シグナル
.Dv SIGUSR1
を受信すると、
.Nm
は現在の内部状態を
.Pa /var/run/rtsold.dump
にダンプします。
.\"
オプションは次の通りです:
.Bl -tag -width indent
.It Fl a
出力インタフェースを自動検出します。
.Nm
ユーティリティは、非ループバック、非 point-to-point、
IPv6 可能なインタフェースを見付けようとします。
.Nm
が複数のインタフェースを見付けると、
.Nm
はエラーで終了します。
.\"
.It Fl d
デバッギングを有効にします。
.It Fl D
より多くのデバッギングを有効にし、内部タイマ情報も表示します。
.It Fl f
.Nm
がデーモンになることを妨げます (フォアグラウンドモード)。
.Xr syslog 3
の代りに標準エラー出力に対して、警告メッセージが生成されます。
.It Fl m
可搬サポートを有効にします。
本オプションが指定されると、ノードがインタフェースに (再) 接続された時、
ルータ通知を行っていたデフォルトルータに対して、
.Nm
はプローブパケットを送信します。
更に、本オプションが指定された場合には、
.Dv SIOCGIFMEDIA
ioctl をサポートしないインタフェース上で、
.Nm
は定期的にルータ要請を送信します。
.It Fl 1
1 回だけ調べます。
有効なルータ通知パケットが、各
.Ar interface
上で最低 1 度は到着するまで、ルータ要請パケットを送ってから、終了します。
.It Fl O Ar script-name
ルータ通知の Other Configuration フラグを扱うための、
付属スクリプトを指定します。
フラグが FALSE から TRUE へ変化したとき、
受信インタフェース名という単一の引数と共に、
.Nm
は
.Ar script-name
を起動します。
これにより、スクリプトが他の設定のためのプロトコルを開始することを
期待しています。
.Ar script-name
はルートからスクリプトへの絶対パスであることが必要であり、
通常ファイルであること、所有者が
.Nm
の実行者と同じであることも必要です。
.El
.Sh 診断
.Ex -std rtsold rtsol
.\"
.Sh 関連ファイル
.Bl -tag -width /var/run/rtsold.dump -compact
.It Pa /var/run/rtsold.pid
現在実行中の
.Nm
の PID。
.It Pa /var/run/rtsold.dump
ここに内部状態をダンプします。
.El
.\"
.Sh 関連項目
.Xr rtadvd 8 ,
.Xr sysctl 8
.\"
.Sh 歴史
.Nm
ユーティリティは、WIDE/KAME IPv6 プロトコルスタックキットではじめて登場した
.Nm rtsol
ユーティリティを元にしています。
.Nm rtsol
ユーティリティは現在
.Nm
に組み込まれています。
.\"
.Sh バグ
オペレーティングシステムによっては、
PCMCIA ネットワークカードを取り除いて再挿入したときに、
対応するインデックスが変わってしまうものがあります。
しかしながら、
.Nm
はそのような変更の発生を仮定せず、起動時に得たインデックスを常に使用します。
その結果、ネットワークカードを再挿入したときに
.Nm
が動作しないかもしれません。
そのような場合には、
.Nm
を殺して再起動してください。
.Pp
IPv6 自動設定仕様は、単一インタフェースホストを仮定しています。
複数インタフェースを持つホストを自動設定しようとする場合、
カーネルのエラーメッセージを見ると良いでしょう。
また、
.Nm
が複数の
.Ar interface
を受け付けることは、矛盾して見えます。