NAME
mstat - show MBone status
SYNOPSIS
mstat [ -CGIPbdgirtvn ] [ -c community ] [ -p port ] [ - x
prefix ] [ host ]
DESCRIPTION
mstat displays the contents of various MBone-related data
structures in various formats, depending on the options you
select.
The default value for the host argument is the localhost.
OPTIONS
-C Show the cached IP multicast route table for
active sources. This works for all types of
routers, not just mrouted . The -x option can
be used to specify a group address. (This is
the default table.)
-G Show the PIM group table.
-I Show the PIM interface table.
-P Show the PIM neighbor table.
-b Show the scoped boundary table. The - x
option can be used to limit the report to a
specific interface number.
-d Show the DVMRP neighbor table. The - x
option can be used to limit the report to a
specific interface number.
-g Show the IGMP group table.
-i Show the DVMRP interface table. This is
similar to a mrinfo report. The -x option
can be used to limit the report to a specific
(virtual) interface number.
-r Show the DVMRP routing table. This is simi-
lar to a portion of the mrouted.dump file
which can be generated by sending a signal to
mrouted . The -x option can be used to limit
the report to a specific subnet address.
-t Show the DVMRP routing next hop table. This
is similar to the second portion of the
mrouted.dump file. The -x option can be used
to limit the report to a specific subnet
address.
-v Show statistics corresponding to the DVMRP
interface table. The -x option can be used
to limit the report to a specific (virtual)
interface number.
-n Show network addresses as numbers. mstat
normally displays addresses as symbols. This
option may be used with any of the display
formats.
-c community Use the specified SNMP community instead of
public .
-p port Use the specified port to contact snmpd on
the remote host. The default is the standard
SNMP port, 161.
-x prefix This use of this option is specific to the
table being displayed. It is used to limit
the range of rows to the subset of the entire
table which corresponds to the given prefix,
which may be an integer or a number IP
address, depending on the table.
DISPLAYS
IP Multicast Route Table
The display for each route table entry shows the multicast
group and source addresses, the (virtual) interface on which
packets arrive, the number of seconds until the entry times
out, the received packet and byte counts, the number of RPF
fails, and the protocol. A sample use and output might be:
% mstat sydney.eecs.umich.edu
IP Multicast Route Table for sydney.eecs.umich.edu
Mcast-group Origin-Subnet InIf UpTime Tmr Pkts Bytes RpF Proto
NTP.MCAST.NET 128.4.1.1/32 1 156 375 1 96 0 dvmrp
NTP.MCAST.NET 128.232.0.56/32 1 466 74 1 96 0 dvmrp
IETF-2-AUDIO. 128.119.40.58/32 1 463 30 1 46 0 dvmrp
224.1.1.94 138.96.24.77/32 1 1665 21 312 38376 0 dvmrp
224.2.0.1 13.2.117.114/32 1 166 180 1 59 0 dvmrp
224.2.0.1 16.1.0.24/32 1 340 210 1 58 0 dvmrp
...
PIM Group Table
The display for each group shows the multicast group
address, the mode (dense or sparse), number of rendezvous
points (RPs), and the number of seconds until this router
will send RP-reachable messages. If the host does not use
PIM, the table will be empty. A sample use and output might
be:
% mstat -G maingate.princeton.edu
PIM Group Table for maingate.Princeton.EDU
Group-Address Mode RPs Tmr
NTP.MCAST.NET dense 0 0
IETF-2-AUDIO.MCAS dense 0 0
SUN-RPC.MCAST.NET dense 0 0
224.1.1.94 dense 0 0
224.2.0.1 dense 0 0
...
PIM Interface Table
The display for each PIM interface shows the interface
number, local IP address, mode (dense or sparse), the desig-
nated router for the interface, and the frequency in seconds
of router-query messages. A sample use and output might be:
% mstat -I maingate.princeton.edu
PIM Interface Table for maingate.Princeton.EDU
If Address Mode DRouter Ttl Int
3 128.112.120/22 dense 128.112.120.1 0 30
4 128.112.224/22 dense 128.112.224.1 0 30
6 128.112.200/22 dense 128.112.200.200 0 30
7 128.112.232/22 dense 128.112.232.1 0 30
9 maingate.Princeton dense 0.0.0.0 64 30
PIM Neighbor Table
The display for each PIM neighbor shows the interface
number, seconds since the router (last) became a neighbor,
seconds until this entry times out, active PIM mode (dense
or sparse) of the neighbor, and the neighbor address. A
sample use and output might be:
% mstat -P maingate.princeton.edu
PIM Neighbor Table for maingate.Princeton.EDU
If UpTime ExpTm Mode Neighbor
6 0 85 dense csgate.Princeton.EDU
Boundary Table
The display for each scoped boundary shows the (virtual)
interface number and administratively scoped boundary
address. A sample use and output might be:
% mstat -b sydney.eecs.umich.edu
Boundary Table for sydney.eecs.umich.edu
Vif Boundary Address
1 239.2/16
DVMRP Neighbor Table
The display shows the (virtual) interface number, seconds
since the router (last) became a neighbor, seconds left
before timing out, the generation ID and version number of
the neighbor, and the neighbor address. A sample use and
output might be:
% mstat -d sydney.eecs.umich.edu
DVMRP Neighbor Table for sydney.eecs.umich.edu
Vif UpTime ExpTm GenId Version Neighbor
1 1637 136 796725035 3.3 videosrv2.engin.umich.edu
IGMP Group Table
The display shows the multicast group address, the interface
number, whether the local system is a member of the group
address on that interface, the number of seconds since this
row was created, the number of seconds left until it
expires, and the last system reporting itself a member. A
sample use and output might be:
% mstat -g sydney.eecs.umich.edu
IGMP Group Table for sydney.eecs.umich.edu
Group-Address Vif Self UpTime Tmr Member
224.2.127.255 0 true 1498 164 sydney.eecs.umich.edu
224.2.212.225 0 false 1503 177 grinch.eecs.umich.edu
DVMRP Virtual Interface Table
The display shows the (virtual) interface number, local and
remote addresses of the interface, the metric and threshold,
and the type and current state. A sample use and output
might be:
% mstat -i sydney.eecs.umich.edu
DVMRP Virtual Interface Table for sydney.eecs.umich.edu
Vif Local-Address Met Thr Type State Remote-Address
0 141.212.99.117 1 1 querier up 141.212.98/23
1 141.212.99.117 1 1 tunnel up videosrv2.engin.umich.edu
2 141.212.99.117 1 1 tunnel down conn1054-classroom1.engin.umich.edu
DVMRP Route Table
The display shows the origin, incoming Vif, distance to ori-
gin, seconds until timeout, and upstream neighbor. A sample
use and output might be:
% mstat -r sydney.eecs.umich.edu
DVMRP Route Table for sydney.eecs.umich.edu
Origin-Subnet IVif Met Tmr UpstreamNeighbor
13.0.32/22 1 11 173 videosrv2.engin.umich.edu
13.1.100/22 1 9 173 videosrv2.engin.umich.edu
13.1.108/22 1 10 173 videosrv2.engin.umich.edu
13.1.136/22 1 10 173 videosrv2.engin.umich.edu
...
DVMRP Route Next Hop Table
The display shows the origin, outgoing (virtual) interface,
and state (leaf or branch). If status is leaf, then a mul-
ticast datagram from that origin will be forwarded on that
outgoing vif only if there are members of the destination
group on that leaf. A sample use and output might be:
% mstat -t sydney.eecs.umich.edu
DVMRP Route Next Hop Table for sydney.eecs.umich.edu
Origin-Subnet OVif State
13.0.32/22 0 leaf
13.0.32/22 2 leaf
13.1.100/22 0 leaf
13.1.100/22 2 leaf
13.1.108/22 0 leaf
13.1.108/22 2 leaf
...
DVMRP Virtual Interface Statistics Table
The display shows the (virtual) interface number, remote
address, incoming and outgoing packet and byte counts, the
rate limit, and the interface type and current state. A
sample use and output might be:
% mstat -v sydney.eecs.umich.edu
DVMRP Virtual Interface Statistics Table for sydney.eecs.umich.edu
Vif InPkts OutPkts InBytes OutBytes Rate Type State Remote-Address
0 64 18335 16165 18441723 0 querier up 141.212.98/23
1 18817 64 18472738 16165 500 tunnel up videosrv2.engin.um
2 0 0 0 0 500 tunnel down conn1054-classroom
SEE ALSO
netstat(8C), mtrace(8), mrouted(8)