# phpman > man > SNMPNETSTAT(1) > **TLDR:** Fetch networking status using SNMP. > - Fetch the networking status: `snmpnetstat -v {{version}} -c {{community}} {{ip_address}}` - Display help: `snmpnetstat {{-h|--help}}` *Source: tldr-pages* --- [SNMPNETSTAT(1)](https://www.chedong.com/phpMan.php/man/SNMPNETSTAT/1/markdown) Net-SNMP [SNMPNETSTAT(1)](https://www.chedong.com/phpMan.php/man/SNMPNETSTAT/1/markdown) ## NAME snmpnetstat - display networking status and configuration information from a network entity via SNMP ## SYNOPSIS **snmpnetstat** [COMMON OPTIONS] [-Ca] [-Cn] [-Cv] [-Cf address_family] AGENT **snmpnetstat** [COMMON OPTIONS] [-Cr] [-Cn] [-Cv] [-Cf address_family] AGENT **snmpnetstat** [COMMON OPTIONS] [-Ci] [-C o | b | d] [-Cn] [-Cv] [-CI interface] [-Cw interval] AGENT **snmpnetstat** [COMMON OPTIONS] [-Cs[s]] [-Cp protocol] AGENT ## DESCRIPTION The **snmpnetstat** command symbolically displays the values of various network-related informa‐ tion retrieved from a remote system using the SNMP protocol. There are a number of output formats, depending on the options for the information presented. The first form of the com‐ mand displays a list of active sockets. The second form presents the values of other net‐ work-related information according to the option selected. Using the third form, with an _in__‐ _terval_ specified, _snmpnetstat_ will continuously display the information regarding packet traffic on the configured network interfaces. The fourth form displays statistics about the named protocol. **snmpnetstat** will issue GETBULK requests to query for information if at least protocol version _v2_ is used. AGENT identifies a target SNMP agent, which is instrumented to monitor the given objects. At its simplest, the AGENT specification will consist of a hostname or an IPv4 address. In this situation, the command will attempt communication with the agent, using UDP/IPv4 to port 161 of the given target host. See [snmpcmd(1)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown) for a full list of the possible formats for AGENT. ## OPTIONS The options have the following meaning: **COMMON** **OPTIONS** Please see [_snmpcmd(1)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown)_ for a list of possible values for common options as well as their de‐ scriptions. ### -CL will automatically fall back to the legacy tables if the modern ones are not available. ### -Ca processes are not shown. ### -Cf ### -Ci of cumulative statistics regarding packets transferred, errors, and collisions. The network addresses of the interface and the maximum transmission unit (``mtu'') are also displayed. ### -Cd ### -Cb ### -Co when enquiring virtual interfaces (such as Frame-Relay circuits) on a router. ### -CI below. ### -Cn to display them symbolically). This option may be used with any of the display formats. ### -Cv with any of the display formats. ### -Cp or an alias for it. Some protocol names and aliases are listed in the file _/etc/protocols_. A null response typically means that there are no interesting numbers to report. The program will complain if _protocol_ is unknown or if there is no statistics routine for it. ### -Cs zero will be suppressed. ### -Cr ### -CR When snmpnetstat is invoked with an interval argument, it displays a running count of statis‐ tics related to network interfaces. _interval_ is the number of seconds between reporting of statistics. _The_ _Active_ _Sockets_ _Display_ _(default)_ The default display, for active sockets, shows the local and remote addresses, protocol, and the internal state of the protocol. Address formats are of the form ``host.port'' or ``net‐ work.port'' if a socket's address specifies a network but no specific host address. When known, the host and network addresses are displayed symbolically according to the databases _/etc/hosts_ _and_ _/etc/networks,_ respectively. If a symbolic name for an address is unknown, or if the **-Cn** option is specified, the address is printed numerically, according to the address family. For more information regarding the Internet ``dot format,'' refer to [_inet(3N)](https://www.chedong.com/phpMan.php/man/inet/3N/markdown)._ Un‐ specified, or ``wildcard'', addresses and ports appear as ``*''. _The_ _Interface_ _Display_ The interface display provides a table of cumulative statistics regarding packets trans‐ ferred, errors, and col- lisions. The network addresses of the interface and the maximum transmission unit (``mtu'') are also displayed. _The_ _Routing_ _Table_ _Display_ The routing table display indicates the available routes and their status. Each route con‐ sists of a destination host or network and a gateway to use in forwarding pack- ets. The flags field shows the state of the route (``U'' if ``up''), whether the route is to a gateway (``G''), whether the route was created dynamically by a redirect (``D''), and whether the route has been modified by a redirect (``M''). Direct routes are created for each interface attached to the local host; the gateway field for such entries shows the address of the out‐ going inter- face. The interface entry indicates the network interface utilized for the route. _The_ _Interface_ _Display_ _with_ _an_ _Interval_ When _snmpnetstat_ is invoked with an _interval_ argument, it displays a running count of statis‐ tics related to network interfaces. This display consists of a column for the primary inter‐ face and a column summarizing information for all interfaces. The primary interface may be replaced with another interface with the **-CI** option. The first line of each screen of infor‐ mation contains a summary since the system was last rebooted. Subsequent lines of output show values accumulated over the preceding interval. _The_ _Active_ _Sockets_ _Display_ _for_ _a_ _Single_ _Protocol_ When a protocol is specified with the **-Cp** option, the information displayed is similar to that in the default display for active sockets, except the display is limited to the given protocol. ## EXAMPLES Example of using snmpnetstat to display active sockets (default): % snmpnetstat -v 2c -c public -Ca testhost Active Internet (tcp) Connections (including servers) Proto Local Address Foreign Address (state) tcp *.echo *.* LISTEN tcp *.discard *.* LISTEN tcp *.daytime *.* LISTEN tcp *.chargen *.* LISTEN tcp *.ftp *.* LISTEN tcp *.telnet *.* LISTEN tcp *.smtp *.* LISTEN ... Active Internet (udp) Connections Proto Local Address udp *.echo udp *.discard udp *.daytime udp *.chargen udp *.time ... % snmpnetstat -v 2c -c public -Ci testhost Name Mtu Network Address Ipkts Ierrs Opkts Oerrs Queue eri0 1500 10.6.9/24 testhost 170548881 245601 687976 0 0 lo0 8232 127 localhost 7530982 0 7530982 0 0 Example of using snmpnetstat to show statistics about a specific protocol: % snmpnetstat -v 2c -c public -Cp tcp testhost Active Internet (tcp) Connections Proto Local Address Foreign Address (state) tcp *.echo *.* LISTEN tcp *.discard *.* LISTEN tcp *.daytime *.* LISTEN tcp *.chargen *.* LISTEN tcp *.ftp *.* LISTEN tcp *.telnet *.* LISTEN tcp *.smtp *.* LISTEN ... ## SEE ALSO [snmpcmd(1)](https://www.chedong.com/phpMan.php/man/snmpcmd/1/markdown), [iostat(1)](https://www.chedong.com/phpMan.php/man/iostat/1/markdown), [vmstat(1)](https://www.chedong.com/phpMan.php/man/vmstat/1/markdown), [hosts(5)](https://www.chedong.com/phpMan.php/man/hosts/5/markdown), [networks(5)](https://www.chedong.com/phpMan.php/man/networks/5/markdown), [protocols(5)](https://www.chedong.com/phpMan.php/man/protocols/5/markdown), [services(5)](https://www.chedong.com/phpMan.php/man/services/5/markdown). ## BUGS The notion of errors is ill-defined. V5.9.1 04 Nov 2013 [SNMPNETSTAT(1)](https://www.chedong.com/phpMan.php/man/SNMPNETSTAT/1/markdown)