`snmpnetstat`

show network status using SNMP

Syntax:

snmpnetstat [-d] [-p port] -v 1 host community [-ainrs]
            [-p proto] [-I interface] [interval]

snmpnetstat [-d] [-p port] [-v 2] host noAuth [-ainrs]
            [-p proto] [-I interface] [interval]

snmpnetstat [-d] [-p port] [-v 2] host srcparty dstparty context
            [-ainrs] [-p proto] [-I interface] [interval]

Options:

-a: Show statistics for all sockets (default is for active sockets only). These statistics consist of the local and remote addresses, protocol, and internal state of the protocol.
-d: Dump input and output packets.
-I interface: Show statistics for this interface.
-i: Show statistics for all interfaces.
-p port: Specify the destination port number.
-n: Show network addresses as numbers. By default, snmpnetstat interprets addresses and attempts to display them symbolically.
-p protocol: Show statistics for this protocol, which is either a protocol's well-known name or its alias. See /etc/protocols for a list of some protocol names and aliases.
-r: Show the routing statistics.
-s: Show statistics for all protocols.
-v 1|2: SNMP version (default is 2).
community: The community name for the transaction with the remote system.
context: The collection of object resources that can be queried by the dstparty.
dstparty: The name of the party providing the information.
host: An Internet address specified in dot notation or a hostname.
interval: The number of seconds between successive updates of the interface statistics.
srcparty: The name of the party requesting information.

Description:

The snmpnetstat utility displays network-related statistics retrieved from a remote system using the SNMP protocol.

If you're using SNMP version 2, the following files must be configured:

/etc/acl.conf
/etc/context.conf
/etc/party.conf
/etc/snmpd.conf (required only if you change the default location of your config files)

For a description on how to configure the files please see the ``Administrative model'' section in the SNMPv2 chapter, and the file page for each of the configuration files listed above. If you wish to change the location of your configuration files, you must include a snmpd.conf file.

Addresses

The snmpnetstat utility tries to match the host, network, and port with entries in the TCP/IP configuration files. If one of these matches, snmpnetstat displays the corresponding symbolic names. If none of these match or if you specify -n, snmpnetstat displays the addresses numerically.

Interface displays

The interface display shows a table of cumulative statistics on packets transferred, errors, and collisions. It also displays the network addresses of the interface and the maximum transmission unit (MTU). If you specify an interval, snmpnetstat shows a continuous display. The first line of the continuous display is a summary of statistics accumulated since the system was last booted; subsequent lines show values accumulated over the preceding interval.

If you specify:	The interface display shows:
`[-n] -i`	Table of cumulative stats for all interfaces.
`[-n] -I` interface	Table of cumulative stats for interface.
`-I` interface interval	Continuous column of stats for interface and continuous table of cumulative stats for all interfaces.
interval	Continuous column of stats for the primary interface and continuous table of cumulative stats for all interfaces.

Routing table display

The routing table display shows the available routes and the status of each. Each route consists of a destination host or network and a gateway to use in forwarding packets. Direct routes are created for each interface attached to the local host.

This field:	Shows:
Destination	Destination host or network.
Flags	State of the route, where: `D` = was created dynamically by a redirect `G` = to a gateway `H` = destination is a host `M` = has been modified by a redirect `U` = up
Gateway	Gateway to use in forwarding packets. Or Address of the outgoing interface if the route is direct.
Interface	Network interface used for the route.

Environment variables:

MIBFILE: Specify the location of the mib.txt file. For example, MIBFILE=path/mib.txt (the default path is /etc).