Penguin
Recent Changes
Blame: snmpnetstat(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of snmpnetstat(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 SNMPNETSTAT
2 !!!SNMPNETSTAT
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 SEE ALSO
7 BUGS
8 ----
9 !!NAME
10
11
12 snmpnetstat - show network status using SNMP
13 !!SYNOPSIS
14
15
16 snmpnetstat [[common arguments] [[-a] [[-n] host
17 snmpnetstat [[common arguments] [[-iors] [[-n] host
18 snmpnetstat [[common arguments] [[-i] [[-n] [[-I interface] host
19 [[interval]
20 snmpnetstat [[common arguments] [[-a] [[-n] [[-P protocol]
21 host
22 !!DESCRIPTION
23
24
25 The ''snmpnetstat'' command symbolically displays the
26 values of various network-related information retrieved from
27 a remote system using the SNMP protocol. There are a number
28 of output formats, depending on the options for the
29 information presented. The first form of the command
30 displays a list of active sockets. The second form presents
31 the values of other network-related information according to
32 the option selected. Using the third form, with an
33 ''interval'' specified, ''snmpnetstat'' will
34 continuously display the information regarding packet
35 traffic on the configured network interfaces. The fourth
36 form displays statistics about the named
37 protocol.
38
39
40 The ''hostname'' specification may be either a host name
41 or an internet address specified in
42 ''
43
44
45 The version 1 and version 2c ''community'' specifies the
46 community name for the transaction with the remote
47 system.
48
49
50 The options have the following meaning:
51
52
53 __-a__
54
55
56 With the default display, show the state of all sockets;
57 normally sockets used by server processes are not
58 shown.
59
60
61 __-i__
62
63
64 Show the state of all of the interfaces.
65
66
67 __-o__
68
69
70 Show an abbreviated interface status, giving octets in place
71 of packets. This is useful when enquiring virtual interfaces
72 (such as Frame-Relay circuits) on a Cisco
73 router.
74
75
76 __-I__ ''interface''
77
78
79 Show information only about this interface; used with an
80 ''interval'' as described below.
81
82
83 __-n__
84
85
86 Show network addresses as numbers (normally
87 ''snmpnetstat'' interprets addresses and attempts to
88 display them symbolically). This option may be used with any
89 of the display formats.
90
91
92 __-P__ ''protocol''
93
94
95 Show statistics about ''protocol'', which is either a
96 well-known name for a protocol or an alias for it. Some
97 protocol names and aliases are listed in the file
98 ''/etc/protocols''. A null response typically means that
99 there are no interesting numbers to report. The program will
100 complain if ''protocol'' is unknown or if there is no
101 statistics routine for it.
102
103
104 __-s__
105
106
107 Show per-protocol statistics.
108
109
110 __-r__
111
112
113 Show the routing tables. When __-s__ is also present,
114 show routing statistics instead.
115
116
117 The default display, for active sockets, shows the local and
118 remote addresses, protocol, and the internal state of the
119 protocol. Address formats are of the form ``host.port'' or
120 ``network.port'' if a socket's address specifies a network
121 but no specific host address. When known the host and
122 network addresses are displayed symbolically according to
123 the data bases ''/etc/hosts'' and ''/etc/networks'',
124 respectively. If a symbolic name for an address is unknown,
125 or if the __-n__ option is specified, the address is
126 printed numerically, according to the address family. For
127 more information regarding the Internet ``dot format,''
128 refer to ''inet''(3N). Unspecified, or ``wildcard'',
129 addresses and ports appear as ``*''.
130
131
132 The interface display provides a table of cumulative
133 statistics regarding packets transferred, errors, and
134 collisions. The network addresses of the interface and the
135 maximum transmission unit (``mtu'') are also
136 displayed.
137
138
139 The routing table display indicates the available routes and
140 their status. Each route consists of a destination host or
141 network and a gateway to use in forwarding packets. The
142 flags field shows the state of the route (``U'' if ``up''),
143 whether the route is to a gateway (``G''), whether the route
144 was created dynamically by a redirect (``D''), and whether
145 the route has been modified by a redirect (``M''). Direct
146 routes are created for each interface attached to the local
147 host; the gateway field for such entries shows the address
148 of the outgoing interface. The interface entry indicates the
149 network interface utilized for the route.
150
151
152 When ''snmpnetstat'' is invoked with an ''interval''
153 argument, it displays a running count of statistics related
154 to network interfaces. This display consists of a column for
155 the primary interface and a column summarizing information
156 for all interfaces. The primary interface may be replaced
157 with another interface with the ''-I'' option. The first
158 line of each screen of information contains a summary since
159 the system was last rebooted. Subsequent lines of output
160 show values accumulated over the preceding
161 interval.
162 !!SEE ALSO
163
164
165 snmpcmd(1), iostat(1), vmstat(1), hosts(5), networks(5),
166 protocols(5), services(5).
167 !!BUGS
168
169
170 The notion of errors is ill-defined.
171 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.