.\"	$KAME: rtsold.8,v 1.14 2000/08/13 18:06:39 itojun 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.1.2.3 2000/12/08 15:28:54 ru Exp %
.\"
.\" $FreeBSD$
.\" WORD: mobility	可搬性 [WIDE IPv6 working group]
.\" WORD:
.Dd May 17, 1998
.Dt RTSOLD 8
.Os KAME
.\"
.Sh 名称
.Nm rtsold
.Nd ルータ要請デーモン
.\"
.Sh 書式
.Nm
.Op Fl dDfm1
.Ar interface ...
.Nm
.Op Fl dDfm1
.Fl a
.Nm rtsol
.Op Fl dD
.Ar interface ...
.Nm rtsol
.Op Fl dD
.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
は始点リンク層アドレスオプションを含めます。
.Pp
シグナル
.Dv SIGUSR1
を受信すると、
.Nm
は現在の内部状態を
.Pa /var/run/rtsold.dump
にダンプします。
.\"
.Sh オプション
.Bl -tag -width indent
.It Fl a
出力インタフェースを自動検出します。
.Nm
は、非ループバック、非 p2p、IPv6 可能なインタフェースを見付けようとします。
.Nm
が複数のインタフェースを見付けると、
.Nm
はエラーで終了します。
.\"
.It Fl d
デバッギングを有効にします。
.It Fl D
より多くのデバッギングを有効にし、内部タイマ情報も表示します。
.It Fl f
.Fl f
は、
.Nm
がデーモンになることを妨げます (フォアグラウンドモード)。
.Xr syslog 3
の代りに標準エラー出力に対して、警告メッセージが生成されます。
.It Fl m
可搬サポートを有効にします。
本オプションが指定されると、ノードがインタフェースに (再) 接続された時、
ルータ通知を行っていたデフォルトルータに対して、
.Nm
はプローブパケットを送信します。
更に、本オプションが指定された場合には、
.Dv SIOCGIFMEDIA
ioctl をサポートしないインタフェース上で、
.Nm
は定期的にルータ要請を送信します。
.It Fl 1
1 回だけ調べます。
有効なルータ通知パケットが全インタフェース上で 1 度以上到着するまで、
ルータ要請パケットを送ってから、終了します。
.El
.Sh 戻り値
成功時には 0 で、失敗時には非 0 で、プログラムは終了します。
.\"
.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
は現在
.Xr rtsold 8
に組み込まれています。
.\"
.Sh バグ
オペレーティングシステムによっては、
PCMCIA ネットワークカードを取り除いて再挿入したときに、
対応するインデックスが変わってしまうものがあります。
しかしながら、
.Nm
はそのような変更を仮定しておらず、起動時に得たインデックスを常に使用します。
その結果、ネットワークカードを再挿入したときに
.Nm
が動作しないかもしれません。
そのような場合には、
.Nm
を殺して再起動してください。
.Pp
IPv6 自動設定仕様は、単一インタフェースホストを仮定しています。
複数インタフェースを持つホストを自動設定しようとする場合、
カーネルのエラーメッセージを見ると良いでしょう。
また、
.Nm
が複数の
.Ar interfaces
を受け付けることは、矛盾して見えます。