MSTAT(8)

NAME
mstat - show MBone status

SYNOPSIS
mstat [ -CGIPbdirtvnw ] [ -f filename ] [ -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

-f filename
    Use the specified SNMP object definitions filename in place of /usr/etc/mrouted.defs .

-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.

-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.

-i  Show the DVMRP virtual interface table. This is similar to a mrinfo report. The -x option can be used to limit the report to a specific interface number.

-r  Show the DVMRP routing table. This is similar 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 virtual interface table. The -x option can be used to limit the report to a specific 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.

-w  Watch actual SNMP messages. This is only useful for debugging.

DISPLAYS

  IP Multicast Route Table

The display for each route table entry shows the multicast group and source addresses, the 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 ExpTm  Pkts  Bytes RpfFl Proto
NTP.MCAST.NET 128.4.1.1/32      1     156   375     1     96     0 dvmrp(4)
NTP.MCAST.NET 128.232.0.56/32   1     466    74     1     96     0 dvmrp(4)
IETF-2-AUDIO. 128.119.40.58/32  1     463    30     1     46     0 dvmrp(4)
224.1.1.94    138.96.24.77/32   1    1665    21   312  38376     0 dvmrp(4)
224.2.0.1     13.2.117.114/32   1     166   180     1     59     0 dvmrp(4)
224.2.0.1     16.1.0.24/32      1     340   210     1     58     0 dvmrp(4)
 ...

  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(1)    0   0
IETF-2-AUDIO.MC dense(1)    0   0
SUN-RPC.MCAST.N dense(1)    0   0
224.1.1.94      dense(1)    0   0
224.2.0.1       dense(1)    0   0
                 ...

  PIM Interface Table

The display for each PIM interface shows the interface number, local IP address, mode (dense or sparse), the designated 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(1)  128.112.120.1     0  30
 4 128.112.224/22     dense(1)  128.112.224.1     0  30
 6 128.112.200/22     dense(1)  128.112.200.200   0  30
 7 128.112.232/22     dense(1)  128.112.232.1     0  30
 9 maingate.Princeton dense(1)  0.0.0.0          64  30

  PIM Neighbor Table

The display for each PIM neighbor shows the neighbor address, interface number, seconds since the router (last) became a neighbor, seconds until this entry times out, and the active PIM mode (dense or sparse) of the neighbor. A sample use and output might be:

% mstat -P maingate.princeton.edu
PIM Neighbor Table for sydney.eecs.umich.edu
Neighbor        If UpTime ExpTm Mode
csgate.Princeto  6 170853    72 dense(1)

  Boundary Table

The display for each scoped boundary shows the 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 interface number, neighbor address, seconds since the router (last) became a neighbor, seconds left before timing out, and the generation ID and version number of the neighbor. A sample use and output might be:

% mstat -d sydney.eecs.umich.edu
DVMRP Neighbor Table for sydney.eecs.umich.edu
Vif Neighbor        UpTime ExpTm     GenId Version
 1  videosrv2.engin    185   140 796725035 3.3

  DVMRP Virtual Interface Table

The display shows the 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   Remote-Address     Met Thr Type       State
 0  141.212.99.117  141.212.98/23        1   1 querier(3) up(1)
 1  141.212.99.117  videosrv2.engin.um   1   1 tunnel(1)  up(1)

  DVMRP Route Table

The display shows the origin, upstream neighbor, incoming Vif, distance to origin, and seconds until timeout. A sample use and output might be:

% mstat -r sydney.eecs.umich.edu
DVMRP Route Table for sydney.eecs.umich.edu
Origin-Subnet      UpstreamNeighbor IVif Met Tmr
10/8               videosrv2.engin     1  10  10
13.0.32/22         videosrv2.engin     1  14  10
13.1.68/22         videosrv2.engin     1  11  10
13.1.100/22        videosrv2.engin     1  12  10
13.1.108/22        videosrv2.engin     1  13  10
 ...

  DVMRP Route Next Hop Table

The display shows the origin, outgoing interface, and state (leaf or branch). If status is leaf, then a multicast 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
10/8                  0 leaf(1)
13.0.32/22            0 leaf(1)
13.1.68/22            0 leaf(1)
13.1.100/22           0 leaf(1)
13.1.108/22           0 leaf(1)
 ...

  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 Remote-Address  InPkts OutPkts  InBytes OutBytes Rate Type       State
 0  141.212.98/23        0       0        0        0    0 querier(3) up(1)
 1  videosrv2.engin   4048       0   474041        0    0 tunnel(1)  up(1)

SEE ALSO
netstat(8C), mtrace(8), mrouted(8)

BUGS
The -x option doesn't always work correctly, and a different mechanism might be more intuitive.