Return to nstat.8c CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8

Annotation of cci/usr/src/man/man8/nstat.8c, revision 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.

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