|
|
1.1 root 1: .TH NSTAT 8C "18 November 1984"
2: .UC 4
3: .SH NAME
4: nstat \- show network status
5: .SH SYNOPSIS
6: .B nstat
7: [
8: .B \-Achimnrst
9: .] [
10: .B \-d
11: .I device-name
12: ] [
13: .B \-p
14: .I protocol
15: ] [
16: .B \-a
17: .I interval
18: ] [
19: .I system
20: ] [
21: .I core
22: ]
23: .SH DESCRIPTION
24: .I Nstat
25: displays the snapshot of networking subsystem status. The user can use the
26: statistics collected at the network interfaces, at each
27: protocol layer, and at network memory pool to monitor the workload,
28: reliability and throughput of data communication.
29: .PP
30: Displayed address formats are of the form ``host.port'' or ``network.port''
31: if a socket's address specifies a network but no specific host address.
32: When known the host and network addresses are displayed symbolically
33: according to the data bases
34: .I /etc/hosts
35: and
36: .IR /etc/networks ,
37: respectively. If a symbolic name for an address is unknown, or if
38: the
39: .B \-n
40: option is specified, the address is printed in the Internet ``dot format'';
41: refer to
42: .IR inet (3N)
43: for more information regarding this format.
44: Unspecified,
45: or
46: .I wildcard,
47: addresses and ports appear as ``*''.
48: .PP
49: The user can choose certain status or statistics, or a different display
50: format by specifying a combination of the following options:
51: .TP
52: .B \-A
53: show the address of protocol control blocks of all connections; used mainly
54: for debugging the networking subsystem.
55: .TP
56: .B \-a interval
57: specify
58: .I nstat
59: to continuously display the selected status, pausing for
60: .I interval
61: seconds before between each display.
62: .TP
63: .B \-c
64: show all connections in the system.
65: There are a number of display formats, depending on the information
66: presented. The default display, for active sockets, shows the local
67: and remote addresses, send and receive queue sizes (in bytes), protocol,
68: and, optionally, the internal state of the protocol.
69: .TP
70: .B \-d "device-name"
71: show statistics collected at the network interface device;
72: .I ace
73: is the device name for ACC Ethernet interface.
74: .TP
75: .B \-h
76: show the state of the IMP host table.
77: .TP
78: .B \-i
79: show the state of interfaces which have been auto-configured
80: (interfaces statically configured into a system, but not
81: located at boot time are not shown).
82: The display provides a table of cumulative
83: statistics regarding packets transferred, errors, and collisions.
84: The network address (currently Internet specific) of the interface
85: and the maximum transmission unit (``mtu'') are also displayed.
86: .TP
87: .B \-m
88: show statistics recorded by the
89: .I mbuf
90: memory management routines
91: (the network manages a ``private share'' of memory)
92: .TP
93: .B \-n
94: show network addresses as numbers (normally
95: .I nstat
96: interprets addresses and attempts to display them
97: symbolically)
98: .TP
99: .BI \-p " proto"
100: show only connections or statistics relating to the protocol
101: .IR proto ;
102: the protocol is specified symbolically, and may be any
103: protocol listed in the file
104: .IR /etc/protocols .
105: If this option is not given,
106: .I nstat
107: displays connections or statistics of all protocols.
108: .TP
109: .B \-r
110: show the routing tables.
111: The routing table display indicates the available routes and
112: their status. Each route consists of a destination host or network
113: and a gateway to use in forwarding packets. The flags field shows
114: the state of the route (``U'' if ``up''), and whether the route
115: is to a gateway (``G''). Direct routes are created for each
116: interface attached to the local host. The refcnt field gives the
117: current number of active uses of the route. Connection oriented
118: protocols normally hold on to a single route for the duration of
119: a connection while connectionless protocols obtain a route then
120: discard it. The use field provides a count of the number of packets
121: sent using that route. The interface entry indicates the network
122: interface utilized for the route.
123: .TP
124: .B \-s
125: show statistics of routing and all protocols.
126: .TP
127: .B \-t
128: show the information regarding packet traffic on the configured
129: network interfaces, pausing every 1 second. The user can change the pause
130: interval with the option
131: .I -a.
132: .I Nstat
133: displays a running count of statistics related to
134: network interfaces. This display consists of a column summarizing
135: information for all interfaces, and a column for the interface with
136: the most traffic since the system was last rebooted. The first
137: line of each screen of information contains a summary since the
138: system was last rebooted. Subsequent lines of output show values
139: accumulated over the preceding interval.
140: .PP
141: The arguments
142: .I system,
143: and
144: .I core
145: are
146: .I positional
147: driven.
148: .I System
149: and
150: .I core
151: allow substitutes for the defaults ``/vmunix'' and ``/dev/kmem''.
152: The
153: .I core
154: file must be read with physical addresses rather than virtual addresses.
155: .PP
156: .SH SEE ALSO
157: iostat(1),
158: vmstat(1),
159: hosts(5),
160: networks(5),
161: protocols(5),
162: services(5),
163: trpt(8C)
164: .SH BUGS
165: The notion of errors is ill-defined. Collisions mean
166: something else for the IMP.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.