.\" Copyright (c) 1995 by the University of Southern California
.\" All rights reserved.
.\"
.\" Permission to use, copy, modify, and distribute this software and its
.\" documentation in source and binary forms for non-commercial purposes
.\" and without fee is hereby granted, provided that the above copyright
.\" notice appear in all copies and that both the copyright notice and
.\" this permission notice appear in supporting documentation, and that
.\" any documentation, advertising materials, and other materials related
.\" to such distribution and use acknowledge that the software was
.\" developed by the University of Southern California, Information
.\" Sciences Institute. The name of the University may not be used to
.\" endorse or promote products derived from this software without
.\" specific prior written permission.
.\"
.\" THE UNIVERSITY OF SOUTHERN CALIFORNIA makes no representations about
.\" the suitability of this software for any purpose. THIS SOFTWARE IS
.\" PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
.\" INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\"
.\" Other copyrights might apply to parts of this software and are so
.\" noted when applicable.
.\"
.\" This manual page (but not the software) was derived from the
.\" manual page for the traceroute program which bears the following
.\" copyright notice:
.\"
.\" Copyright (c) 1988 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %FreeBSD: src/usr.sbin/mrouted/mtrace.8,v 1.12.2.4 2001/07/22 12:41:14 dd Exp %
.\"
.\" $FreeBSD: doc/ja_JP.eucJP/man/man8/mtrace.8,v 1.13 2001/05/14 01:09:52 horikawa Exp $
.Dd May 8, 1995
.Dt MTRACE 8
.Os
.Sh 名称
.Nm mtrace
.Nd 発信元から受信側へのマルチキャストの経路を表示する
.Sh 書式
.Nm
.Op Fl e Ar extrahops
.Op Fl g Ar gateway
.Op Fl i Ar if_addr
.Op Fl l
.Op Fl M
.Op Fl m Ar max_hops
.Op Fl n
.Op Fl O
.Op Fl p
.Op Fl P
.Op Fl q Ar nqueries
.Op Fl r Ar resp_dest
.Op Fl s
.Op Fl S Ar stat_int
.Op Fl t Ar ttl
.Op Fl T
.Op Fl U
.Op Fl v
.Op Fl w Ar waittime
.Ar source
.Op Ar receiver
.Op Ar group
.Sh 解説
IP マルチキャストのトラフィックの配送における問題点を突き止めるのは困難な
作業です。
.Nm
は IGMP プロトコルの拡張機能によってアクセスされる、
マルチキャストルータに実装されたトレース機能を利用します。
.Ar receiver
から
.Ar source
への逆経路に沿ったホップごとにトレースの問い合わせを行ない、経路上の
ホップのアドレス、パケット数、ルーティングのエラー状況の情報を収集し、
要求者へ応答を返します。
.Pp
唯一必須である引数は
.Ar source
のホスト名もしくはアドレスです。デフォルトの
.Ar receiver
は mtrace を実行しているホストとなり、デフォルトの
.Ar group
は 0.0.0.0 となります。特定のマルチキャストグループ
でのパケット消失の統計が必要でなければ、これで十分です。以下に解説され
ているいくつかの制約を条件として、特定の group でのいくつかの他の
receiver をテストするために、これらの 2 つのオプションの引数を
指定することができます。
.Ar receiver
はユニキャストアドレスであり、
.Ar group
はマルチキャストアドレスであることより、これらの 2 つの引数を
区別することができます。
.Fl g
フラグが指定されると、source アドレスには
.Nm mtrace
が実行されているホストがデフォルトとして使われ、 receiver には
.Fl g
フラグで指定されるルータがデフォルトとして使われます。この場合、必須の
引数はありません。
.Pp
注: Solaris 2.4/2.5 ではマルチキャストインタフェースがデフォルトの
インタフェースでなければ、
.Fl i
オプションによってローカルアドレスをセットしなければなりません。
.Pp
以下のオプションが使用できます:
.Bl -tag -width indent
.It Fl e Ar extrahops
応答がないルータを越えて、
.Ar extrahops
だけのホップ数のトレースを試みます。
.It Fl g Ar gwy
トレースの問い合わせを、マルチキャストではなく、ユニキャストによって
直接マルチキャストルータ
.Ar gwy
へ送ります。
このマルチキャストルータは意図する
.Ar source
から
.Ar receiver
への経路上の最後のホップのルータでなければなりません。
.Pp
.Em 注意 !!
バージョン 3.3 と 3.5 の
.Nm mrouted
は、トレースの問い合わせがユニキャストパケットによって受信されかつ、
.Nm mrouted
に
.Ar source
への経路がないと、クラッシュします。そのためターゲットの
.Nm mrouted
が 3.4 であるか、3.5 より新しいことが分かっていなければ、
.Fl g
オプションを使わないでください。
.It Fl i Ar addr
.Ar addr
をトレースの問い合わせを送る (マルチホームホスト上の)
ローカルインタフェースアドレス、および
.Ar receiver
と応答先のデフォルトアドレスとして使用します。
.It Fl l
10 秒ごとにマルチキャスト経路のパケットレートと消失の統計を表示して、
無限ループします。
(
.Fl S Ar stat_int
参照)
.It Fl M
試みの後半は、ユニキャストではなく、常にマルチキャストを使って応答を
要求します。
.It Fl m Ar n
.Ar receiver
から
.Ar source
へ遡ってトレースされる最大ホップ数を
.Ar n
にセットします。
デフォルトは 32 ホップ (DVMRP ルーティングプロトコルについては無限)
です。
.It Fl n
ホップアドレスをシンボル名および数字ではなく数字で表示します。
(経路上に発見された各ルータに対する
ネームサーバでのアドレス-名前検索を省くことができます。)
.It Fl q Ar n
すべてのホップに対して試みる問い合わせの最大の回数を
.Ar n
にセットします。デフォルトは 3 です。
.It Fl O
router-alert IP オプションを、これが必要な要求においても使用しません。
Cisco の IOS のいくつかのバージョンでは IP オプションつきのマルチキャスト
トレースルートが扱えないため、最後のホップのルータが Cisco のものである時は、
.Fl O
フラグが必要となることがあります。
.It Fl p
他から起動されたトレースによるマルチキャストの応答を受動的に聴取します。
これはマルチキャストルータ上で動作している場合に最も良く動作します。
.It Fl P
10 秒おきに経路情報を収集しながら無限ループし
(
.Fl S Ar stat_int
参照)、
経路情報が変化するとそれを表示します。統計情報は表示しません。
.It Fl r Ar host
トレースの応答を、
.Nm
が実行されているホストや
この目的で登録されている他のマルチキャストアドレス (224.0.1.32) ではなく、
.Ar host
へ送ります。
.It Fl s
マルチキャスト経路のみを含む短い形式の表示を行ない、パケットレートと
消失統計は表示しません。
.It Fl S Ar n
統計情報を収集する間隔を
.Ar n
秒 (デフォルトは 10 秒) に変更します。
.It Fl t Ar ttl
マルチキャストトレースの問い合わせと応答の
.Ar ttl
(time-to-live もしくはホップ数) をセットします。ttl に 1 を
使用する "全てのルータ" へのローカルな問い合わせの場合を除き、
デフォルトは 127 です。
.It Fl T
"トンネル統計" モードです。全てのトラフィックでのロスレートを表示します。
これらの統計は非常に誤解を招くおそれのあるものです。
.It Fl U
マルチキャストから試みるのではなく、常にユニキャストによる応答を要求します。
.It Fl v
冗長モードです。最初のトレースのホップ時間と統計情報を表示します。最初
のトレースを転送するのに使用した経路も表示します。
.It Fl w Ar n
トレースの応答の待ち時間を
.Ar n
秒 (デフォルトは 3 秒) にセットします。
.El
.Sh 使用法
.Ss "どのように動作するか ?"
.Nm traceroute
ツールでユニキャストのネットワーク経路をトレースするために使用している
技法は IP マルチキャストでは動作しません。それは、ICMP 応答が
マルチキャストトラフィックでは禁止されているためです。そのかわりに、
トレースの機能はマルチキャストルータにおいて実装されています。
この技法は送出するパケット数を最小にしながら、
パケットレートやロスを計測できる点で優れています。
.Pp
マルチキャストでは逆経路転送が使われているため、トレースは
.Ar receiver
から
.Ar source
へ逆方向に実行されます。
トレースの問い合わせパケットは最終ホップのマルチキャストルータ (
.Ar receiver
アドレスでの末端ルータ) へ送られます。最終ホップのルータではトレースの
応答パケットを生成し、それにそのホップでのレポートを詰め込み、
ユニキャストを使って、指定された
.Ar source
から送られてくるパケットにおける、そのルータの前段のホップであると思わ
れるルータへ、生成したパケットを転送します。
経路上の各ルータはそのパケットにレポートを追加して転送します。
トレースの応答パケットが最初のホップのルータ ( source のネットワークに
直結されているルータ) に到達すると、そのルータはトレースの問い合わせに
指定されている応答の送り先アドレスへ最終的な形の応答を送ります。
.Pp
経路上のいくつかのマルチキャストルータにマルチキャストのトレースルート
機能が実装されていなかったり、停止しているものがあると、応答は返されま
せん。この問題を解決するには、応答が返されるまでにトレースされるホップ
数を制限するための最大ホップ数フィールドを、トレースの問い合わせに
含ませます。これによって、部分的な経路のトレースが可能となります。
.Pp
各ルータによって挿入されるレポートには、ホップのアドレスだけでなく、
転送のために必要な ttl とルーティングのエラーを示すいくつかのフラグ、
それに受信と送信インタフェース上および指定された
.Ar group
へ転送されたパケット数の合計が含まれます。時間をあけて 2 回トレースを
行なってこれらのパケット数の差分をとり、あるホップからの送信パケット
数とその次のホップでの受信パケット数を比較することにより、パケットレートと
パケット消失の統計が計算でき、ネットワークへの過負荷による問題を切
り離すことができます。
.Ss 最終ホップルータを見つける
トレースの問い合わせは
.Ar source
から
.Ar receiver
へ到る経路上の最後のホップであるマルチキャストルータへ送られなければな
りません。もし、receiver がローカルサブネット上にあれば (これはサブネットマスク
によって決定されます)、デフォルトの方法ではトレースの問い合わせ
を ttl を 1 にして all-routers.mcast.net (224.0.0.2) へマルチキャスト
します。receiver がサブネット上になければ、
.Ar group
へトレースの問い合わせをマルチキャストします。それは receiver がその
グループのメンバであれば、最後のホップルータもグループのメンバであるため
です。そのため、意図している receiver が属しているグループを指定する
必要があります。このマルチキャストは ttl をデフォルトの 127 にして送られ
ます。この ttl は全ての場合では十分でないかもしれません。(
.Fl t
オプションで変更可能です。) もし最後のホップルータが分かっていれば、
.Fl g
オプションを使用して直接指定することもできます。また、最後のホップのルータが
別のグループのメンバであるということが分かっており、receiver が属
していないグループのトレースを行ないたい場合、
.Fl g
オプションを使用してトレースの問い合わせに別のマルチキャストアドレスを
指定することもできます。
.Pp
マルチホームであるホストやルータからのトレースを行なう場合は、デフォルトの
receiver のアドレスは source からの経路での意図したインタフェース
でないかも知れません。インタフェースを指定したい場合は、
.Ar receiver
によって明示的に指定しなければなりません。
.Ss 応答の誘導
.Fl m
オプションによってトレースするホップ数が明示的に指定されている場合を除
き、
.Nm
はデフォルトではまず逆経路全てに渡ったトレースを試みます。もしタイムアウト
時間である 3 秒 (これは
.Fl w
オプションで変更できます) 以内に応答がなければ、"*" が表示され、プローブ方式を
hop-by-hop モードに切り替えます。
トレースの問い合わせは最大ホップ数を 1 から開始し、応答を受信しなくなる
か全ての経路を網羅するまでホップ数を 1 づつ増やして行きます。
各ホップでは、複数のプローブ (デフォルトでは 3、
.Fl q
オプションで変更可)
が送られます。トレースの試みの前半 (デフォルトでは 2 回) では、応答
アドレスを標準のマルチキャストアドレス mtrace.mcast.net (224.0.1.32) に
セットし、ttl を receiver までの経路上で今までにあった最大のスレッショルド
である 32 にセットして行なわれます。引き続く各々の試みについては
ttl は最大 192 まで 32 づつ増やされます。
目的のルータはマルチキャスト応答を送ることができないかもしれないので、
残りの試みでは
.Nm
が動作しているホストへユニキャストを使って応答することを要求します。
また、マルチキャストの ttl は
.Fl t
オプションを使って明示的に指定することができ、最初のマルチキャストの試みは
.Fl U
オプションを使ってユニキャストに強制的に変更することができ、最後の
マルチキャストの試みは
.Fl M
オプションを使って強制的にマルチキャストにすることができ、また
.Fl UM
を指定することにより、
.Nm
は最初はユニキャストで試み、次にマルチキャストを試みます。各々の試みで
はタイムアウトとなるまで応答が受信できなければ "*" が表示されます。指定された
回数の試みが失敗すると、
.Nm
は次のホップのルータへ (
.Nm mrinfo
プログラムで使われているように) DVMRP_ASK_NEIGHBORS2 要求で問い合わせ
を試み、そのルータの種類を調べます。
.Nm
は応答がないルータを越えて 3 ホップ (これは
.Fl e
オプションで変更可能) へ、応答を返す能力がないとしてもその要求の転送は
できるであろうと想定して、問い合わせを試みます。
.Sh 使用法
.Nm
の出力は 2つのセクションからなります。最初のセクションではホップが問い
合わされた順、すなわち
.Ar source
から
.Ar receiver
への逆順で簡潔にリストされます。各々のホップについて、ホップ番号 (逆経路
であることを示すように負の数でカウントされる)、マルチキャスト
ルーティングプロトコル (DVMRP、MOSPF、PIM など)、データの転送 (上向きの矢印で
示されたリストでの前のホップへの転送) 要求のスレッショルド、問い合わせ
がそのホップへ届くまでの遅れの累積 (クロックが同期している時のみ有効)
が 1 行で表示されます。最初のセクションの最後には、問い合わせが発行さ
れてから応答を受信するまでの間隔をローカルのシステムクロックで計測した
ラウンドトリップ時間と、パケットがこの経路を通って行き来するのに必要な
ttl の合計が表示されます。以下に使い方とその出力の例を示します。
.Pp
.Bd -literal
oak.isi.edu 80# mtrace -l caraway.lcs.mit.edu 224.2.0.3
Mtrace from 18.26.0.170 to 128.9.160.100 via group 224.2.0.3
Querying full reverse path...
0 oak.isi.edu (128.9.160.100)
-1 cub.isi.edu (128.9.160.153) DVMRP thresh^ 1 3 ms
-2 la.dart.net (140.173.128.1) DVMRP thresh^ 1 14 ms
-3 dc.dart.net (140.173.64.1) DVMRP thresh^ 1 50 ms
-4 bbn.dart.net (140.173.32.1) DVMRP thresh^ 1 63 ms
-5 mit.dart.net (140.173.48.2) DVMRP thresh^ 1 71 ms
-6 caraway.lcs.mit.edu (18.26.0.170)
Round trip time 124 ms; total ttl of 6 required.
.Ed
.Pp
あるホップがパケットを転送するのにデフォルトの経路を使っていることを報
告すれば、
.Em [default]
がそのホップの後に表示されます。
.Fl v
フラグが指定されていれば、そのパケットを転送するのに使われた経路が
.Em [18.26.0/24]
の形式で表示されます。
.Pp
2 番目のセクションでは転送の経路が図によって表示されます。データの流れ
は下向きの矢印で表され、問い合わせの経路は上向きの矢印で表されます。各
ホップでは、ルータの入力アドレスと出力アドレスが違っていれば、それらの
アドレスが、そのホップパケットを転送するのに必要な ttl の初期値と、
両端のルータのクロックが同期していると想定した場合のホップにまたがった
伝搬遅れとともに表示されます。このセクションの右半分は 2 組の統計情報か
ら構成されます。最初のカラムには各ホップでの全てのトラフィックについて
の平均のパケットレートが表示されます。残りのカラムでは消失したパケット
の数、送信したパケットの数、消失したパーセンテージ、それに平均パケット
レートが各ホップについて表示されます。これらの統計情報は上で解説したよ
うにトレース間の差とホップ間の差から計算されます。最初のグループでは、
あるホップでのインタフェースにおける全流出トラフィックと次のホップでの全流入
トラフィックの統計情報が表示されます。2 番目のグループでは、指定された
.Ar source
から指定された
.Ar group
への転送トラフィックのみについての統計情報が表示されます。統計の最初の
グループは
.Fl T
オプションを使って消失レートを含ませることもできます。しかし、これらの
数字は大幅な誤差を含む可能性があり、これらを適切に解釈するためには
ルータについての詳細な知識が要求されるでしょう。
.Pp
これらの統計情報は各々のホップにつき 1 行か 2 行で表示されます。
オプションが何も指定されていないと、この出力中の 2 番目のセクションは最初
のトレースからおよそ 10 秒後に 1 度のみ表示されます。各ホップにつき 1
行にその 10 秒間での統計情報を表示します。もし
.Fl l
オプションが指定されていると、2 番目のセクションは 10 秒ごとに繰り返さ
れ、各ホップにつき 2 行が表示されます。最初の行ではそれまでの 10 秒間
における統計が表示され、2 番目の行で最初のトレースからの累積の統計情報
が表示されます。下の例ではこれは 101 秒間での統計となっています。
.Fl s
オプションが指定されるか、マルチキャストグループが指定されていると、こ
の出力での 2 番目のセクションは省略されます。
.Pp
.Bd -literal
Waiting to accumulate statistics... Results after 101 seconds:
Source Response Dest Overall Packet Statistics For Traffic From
18.26.0.170 128.9.160.100 Packet 18.26.0.170 To 224.2.0.3
| __/ rtt 125 ms Rate Lost/Sent = Pct Rate
v / hop 65 ms ------- ---------------------
18.26.0.144
140.173.48.2 mit.dart.net
| ^ ttl 1 0 pps 0/2 = --% 0 pps
v | hop 8 ms 0 pps 0/18 = 0% 0 pps
140.173.48.1
140.173.32.1 bbn.dart.net
| ^ ttl 2 0 pps 0/2 = --% 0 pps
v | hop 12 ms 0 pps 0/18 = 0% 0 pps
140.173.32.2
140.173.64.1 dc.dart.net
| ^ ttl 3 27 pps 0/2 = --% 0 pps
v | hop 34 ms 26 pps 0/18 = 0% 0 pps
140.173.64.2
140.173.128.1 la.dart.net
| ^ ttl 4 83 pps 0/2 = --% 0 pps
v | hop 11 ms 79 pps 0/18 = 0% 0 pps
140.173.128.2
128.9.160.153 cub.isi.edu
| \\__ ttl 5 83 pps ?/2 0 pps
v \\ hop -8 ms 79 pps ?/18 0 pps
128.9.160.100 128.9.160.100
Receiver Query Source
.Ed
.Pp
パケットのカウント数はトレースの問い合わせが伝搬するとともに変化するた
め、統計情報中には小さな誤差 (1 か 2 のずれ) が含まれることがあります。
しかし、これらの誤差は累積されるべきではないため、累積統計行ではあらた
なトレースが 10 秒ごとに実行されるたびに精度が増さなければなりません。
大きな誤差の要因としては 2 つあり、このいずれもマイナスのロスとして現われます。
.Pp
あるノードへの入力カウントが他のノードがアタッチされているマルチアクセス
ネットワークからのものであれば、入力カウントはアタッチされている全てのノード
からの出力カウントの総和となります (もしくは近くなります) が、トレースし
ている経路上のその前のホップからの出力カウントはその単なる一部分となり
ます。そのため、出力カウントから入力カウントを引いたものはマイナスの値
になります。
.Pp
SunOS およびその他のシステムにおける DVMRP マルチキャスト転送ソフトウェアの
リリース 3.3 では、ルータにおいて生成されたマルチキャストパケット
はインタフェースに入力されていない場合においても、入力されたものとし
てカウントされます。これは上の例において見ることのできるマイナスのロス
となります。
.Pp
これらのマイナスのロスはプラスのロスを隠してしまうことが
あることに注意してください。
.Pp
この例ではまた、1 つマイナスのホップの時間が表示されています。これは
単にそのホップ間でのシステムクロックが同期していないことを示しています。
この例ではまた、送られたパケットの数が 10 より少ない時には、パーセンテージの
値は統計的に有効ではないため、ロスのパーセンテージが 2 つのダッシュ
として表示されることも示しています。
.Pp
2 番目の例では ローカルでない receiver へのトレースを示します。問い合
わせは
.Fl g
オプションによって最終ホップのルータに送られます。この例では、全逆経路
のトレースが、マルチキャストトレースルート機能が実装されていない
古いバージョンの
.Nm mrouted
が動作しているノードがあるために応答なしの結果となっており、そのため
.Nm
は hop-by-hop モードに切り替わっています。
.Dq Output pruned
のエラーコードは
グループ 224.2.143.24 へのトラフィックが転送されていないことを示しています。
.Pp
.Bd -literal
oak.isi.edu 108# mtrace -g 140.173.48.2 204.62.246.73 \\
butter.lcs.mit.edu 224.2.143.24
Mtrace from 204.62.246.73 to 18.26.0.151 via group 224.2.143.24
Querying full reverse path... * switching to hop-by-hop:
0 butter.lcs.mit.edu (18.26.0.151)
-1 jam.lcs.mit.edu (18.26.0.144) DVMRP thresh^ 1 33 ms Output pruned
-2 bbn.dart.net (140.173.48.1) DVMRP thresh^ 1 36 ms
-3 dc.dart.net (140.173.32.2) DVMRP thresh^ 1 44 ms
-4 darpa.dart.net (140.173.240.2) DVMRP thresh^ 16 47 ms
-5 * * * noc.hpc.org (192.187.8.2) [mrouted 2.2] didn't respond
Round trip time 95 ms
.Ed
.Sh 作者
.An -nosplit
.An Ajit Thyagarajan
によって書かれた最初のプロトタイプをベースにして、
.An Steve Casner
によって実装されました。マルチキャストトレースルートの
メカニズムは
.An Steve Casner ,
.An Steve Deering ,
.An Dino Farinacci ,
.An Deb Agrawal
の助けを得て、
.An Van Jacobson
によって設計され、
.An Ajit Thyagarajan
と
.An Bill Fenner
によって
.Nm mrouted
に実装されました。オプションの構文と
.Nm
の出力形式は、
.An Van Jacobson
によって書かれたユニキャストの
.Nm traceroute
をモデルにしています。
.Sh 関連項目
.Xr map-mbone 8 ,
.Xr mrinfo 8 ,
.Xr mrouted 8 ,
.Xr traceroute 8
.Sh バグ
受動モードでの統計収集は、能動的にデータを収集しているときと常に同じ
出力とはなりません。
