snmpstat(1M) snmpstat(1M)
NAME
snmpstat - show network status using SNMP
SYNOPSIS
snmpstat [-a | -i | -r | -s | -S | -t] [-n] [-T timeout]
[entity_addr] [community_string]
DESCRIPTION
The snmpstat command displays the contents of various
network-related Simple Network Management Protocol (SNMP) data
structures.
Each of the -airsSt options displays a different structure;
these options cannot be used together. By default, snmpstat
displays address information symbolically. Combine the -n
option with another option to display address information
numerically.
By default, getid waits 20 seconds for a response from the
entity specified by entity_addr. Use the -T timeout option to
specify a different number of seconds for the command to wait
for a response.
The entity_addr can be either an IP address or an entity name
(if name-to-address resolution is enabled). If not supplied,
this defaults to the symbolic name localhost, which refers to
the machine on which the command is executed.
The community_string is a string used to gain access to the
SNMP agent on the given entity_addr. If not supplied, this
defaults to the community string public. On UnixWare,
community strings are kept in /etc/netmgt/snmpd.comm.
If no options are specified on the command line, then the
transport endpoint table is displayed (the -t option), but
with no server endpoints in the displayed table.
The options have the following meanings:
-a show the address translation table
-i show the status of active interfaces
-n display addresses and port numbers numerically instead
of symbolically
Copyright 1994 Novell, Inc. Page 1
snmpstat(1M) snmpstat(1M)
-r show the routing table
-s show the variables comprising the system group of the
MIB
-S show the SNMP status
-t show the complete transport endpoint table
There are a number of display formats, depending on the
information presented.
Address Translation Display (-a)
The address translation display indicates the current
knowledge regarding address translations for remote hosts with
which communication has recently occurred. Entries in the
address translation table consist of a host address, its
physical address (typically an Ethernet address), and the name
of the interface for which this translation is valid.
Using this option to snmpstat displays the same information as
getmany entity_addr community_string atTable
though in a more understandable format.
Interface Display (-i)
The interface display provides a table of cumulative
statistics regarding packets transferred, errors, and queue
lengths. The name address and mtu (maximum transmission unit)
of the interface are also displayed.
Using this option to snmpstat displays the same information as
getmany entity_addr community_string ifTable
though in a more understandable format.
Routing Table Display (-r)
The routing table display indicates the available routes and
their status. Each route consists of a destination host or
network and a gateway to use in forwarding packets. The
metric field shows the metric associated with the route. The
type field displays what kind of route this is, whether for a
directly connected network or a remote network, and so on.
The proto field indicates the mechanism by which the route was
Copyright 1994 Novell, Inc. Page 2
snmpstat(1M) snmpstat(1M)
learned. The interface field shows the name of the interface
with which this route is associated. The type and proto
fields are displayed symbolically.
Using this option to snmpstat displays the same information as
getmany entity_addr community_string ipRouteTable
though in a more understandable format.
System Display (-s)
The system display contains the description of the entity
being managed, the object identifier describing the management
subsystem on the entity, and the duration of time since the
management subsystem was re-initialized, and other system
group statistics.
Using this option to snmpstat displays the same information as
getmany entity_addr community_string system
though in a more understandable format.
SNMP Statistics (-S)
The SNMP display contains a number of statistics for packets
received and sent by the SNMP agent. For incoming packets,
this includes the number of packets, packet errors, commands
received within packets, and traps received. For outgoing
packets, this includes the number of packets sent, packet
errors, commands sent within packets, traps sent, and whether
or not sending SNMP traps is currently enabled.
Using this option to snmpstat displays the same information as
getmany entity_addr community_string snmp
though in a more understandable format.
Transport Endpoint Display (-t)
By default, active transport endpoints are displayed. The -t
flag is used to display all transport endpoints including
servers. Active transport endpoints are those whose local
address portions have been set to a specific address. The
protocol, local and remote address, and the internal state of
the protocol (if applicable) are shown.
Copyright 1994 Novell, Inc. Page 3
snmpstat(1M) snmpstat(1M)
Address formats are of the form host.port or network.port if
an endpoint's address specifies a network but no specific host
address. If the -n flag is not used, the host and network
addresses and port numbers are displayed symbolically
according to the data bases /etc/hosts, /etc/networks, and
/etc/services, respectively. If a symbolic name for an
address is unknown or if the -n flag has been used, the
address is printed in the Internet dot notation. Unspecified
or ``wildcard'' addresses and ports appear as ``*''.
Using this option to snmpstat displays the same information as
getmany entity_addr community_string tcpConnTable
getmany entity_addr community_string udpTable
though in a more understandable format.
REFERENCES
getid(1M), getroute(1M), hosts(4), networks(4), snmpd(1M), RFC
1155, RFC 1157, RFC 1213.
Copyright 1994 Novell, Inc. Page 4