Annotation of cci/usr/src/man/man8/nstat.8c, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.