Caution: This version of this document is no longer maintained. For the latest documentation, see


Show network status using SNMP


snmpnetstat [-d] [-p port] -v 1 host community
            [-ainrs] [-P protocol] [-I interface]

snmpnetstat [-d] [-p port] [-v 2] host noAuth
            [-ainrs] [-P protocol] [-I interface]

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

Runs on:



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.
Dump input and output packets.
-I interface
Show statistics for this interface.
Show statistics for all interfaces.
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.
-p port
Specify the destination port number.
Show the routing statistics.
Show statistics for all protocols.
-v 1|2
SNMP version (default is 2).
The community name for the transaction with the remote system.
The collection of object resources that can be queried by the dstparty.
The name of the party providing the information.
An Internet address specified in dot notation or a hostname.
The number of seconds between successive updates of the interface statistics.
The name of the party requesting information.


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:

For a description on how to configure the files please see 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.


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.
Address of the outgoing interface if the route is direct.
Interface Network interface used for the route.

Environment variables:

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

See also:

netstat, snmpd, snmpget, snmpgetnext, snmpstatus, snmptest, snmptranslate, snmptrap, snmptrapd, snmpwalk

/etc/acl.conf, /etc/context.conf, /etc/hosts, /etc/mib.txt, /etc/networks, /etc/party.conf, /etc/protocols, /etc/services, /etc/snmpd.conf, /etc/view.conf files

Based on ISO 8824 (ASN.1), RFC 1065, RFC 1066, RFC1067
RFC 1441, RFC 1445, RFC1446
RFC 1448, RFC 1449

Marshall T. Rose, The Simple Book: An Introduction to Internet Management, Revised 2nd ed. (Prentice-Hall, 1996, ISBN 0-13-451659-1)