home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / netstat.z / netstat
Encoding:
Text File  |  2001-04-17  |  15.2 KB  |  331 lines
  1.  
  2.  
  3.  
  4. NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))                                                          NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      netstat - show network status
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      nnnneeeettttssssttttaaaatttt [ ----AAAAaaaannnnuuuuVVVV ] [ ----LLLL laddr ] [ ----FFFF faddr ] \
  13.           [ ----ffff _a_d_d_r_e_s_s__f_a_m_i_l_y ] [ _s_y_s_t_e_m ] [ _c_o_r_e ]
  14.      nnnneeeettttssssttttaaaatttt [ ----iiiimmmmnnnnqqqqrrrrssssttttMMMMNNNN ] [ ----ffff _a_d_d_r_e_s_s__f_a_m_i_l_y ] [ _s_y_s_t_e_m ] [ _c_o_r_e ]
  15.      nnnneeeettttssssttttaaaatttt [ ----nnnn ] [ ----IIII _i_n_t_e_r_f_a_c_e ] _i_n_t_e_r_v_a_l [ _s_y_s_t_e_m ] [ _c_o_r_e ]
  16.      nnnneeeettttssssttttaaaatttt ----CCCC  [ ----nnnn ] [ _i_n_t_e_r_v_a_l ] [ _s_y_s_t_e_m ]
  17.      nnnneeeettttssssttttaaaatttt [ ----pppp _p_r_o_t_o_c_o_l ] [ _s_y_s_t_e_m ] [ _c_o_r_e ]
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The _n_e_t_s_t_a_t command symbolically displays the contents of various
  21.      network-related data structures.  There are a number of output formats,
  22.      depending on the options for the information presented.  The first form
  23.      of the command displays a list of active sockets for each protocol.  The
  24.      second form presents the contents of one of the other network data
  25.      structures according to the option selected.  Using the third form, with
  26.      an _i_n_t_e_r_v_a_l specified, _n_e_t_s_t_a_t will continuously display the information
  27.      regarding packet traffic on the configured network interfaces.  The
  28.      fourth form displays statistics about the named protocol.
  29.  
  30.      The options have the following meaning:
  31.  
  32.      ----AAAA   With the default display, show the address of any protocol control
  33.           blocks associated with sockets; used for debugging.
  34.  
  35.      ----aaaa   With the default display, show the state of all sockets; normally
  36.           sockets used by server processes are not shown.  If ----qqqq is used in
  37.           conjunction with ----aaaa, information about pending connections on
  38.           listening endpoints will be displayed.  This includes the number of
  39.           partially-synchronized connections, the number of fully-synchronized
  40.           connections, and the maximum number of pending connections specified
  41.           in the _l_i_s_t_e_n(2) call.  Note that system provides some scaling on
  42.           the _l_i_s_t_e_n backlog, such that a request for a queue limit of 32 will
  43.           actually result in 49 connections being allowed prior to new
  44.           connection requests being ignored.  This means that it is possible
  45.           for the sum of the two queue lengths to be larger than the limit.
  46.  
  47.      ----FFFF _f_a_d_d_r
  48.           Only TCP protocol control blocks whose foreign address matches the
  49.           pattern _f_a_d_d_r should be displayed.  The format of _f_a_d_d_r is
  50.           [_i_p_a_d_d_r][/_p_o_r_t] where _i_p_a_d_d_r is up to four decimal numbers separated
  51.           by `.' representing the IP address and _p_o_r_t is the port number.  If
  52.           less than four numbers are given for the IP address, trailing
  53.           numbers are assumed to be wildcards.  For example 192.26 represents
  54.           the subnet 192.26.0.0.  Host names may be used instead of dotted IP
  55.           address notation.
  56.  
  57.      ----LLLL _l_a_d_d_r
  58.           Only TCP protocol control blocks whose local address matches the
  59.           pattern _l_a_d_d_r should be displayed.  The format of _l_a_d_d_r is the same
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))                                                          NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))
  71.  
  72.  
  73.  
  74.           as that of _f_a_d_d_r
  75.  
  76.      ----llll   With the default display, on systems supporting IP security options,
  77.           show the mandatory and discretionary access control attributes
  78.           associated with sockets.  These consist of a mandatory access
  79.           control label, printed at the beginning of each line, and a socket
  80.           uid and acl, printed at the end of each line.  (For AAAAFFFF____IIIINNNNEEEETTTT sockets
  81.           only, a second mandatory access control label, _S_n_d_L_a_b_e_l, is also
  82.           shown.  _S_n_d_L_a_b_e_l is a copy of the label in the u_area.)  On systems
  83.           not supporting IP security options, ----llll is silently ignored.
  84.  
  85.      ----CCCC   Display the contents of several of the other formats in dynamic
  86.           "full-screen" forms.  Many of the values can be displayed as simple
  87.           totals (_r or "reset"), changes during the previous interval (_d or
  88.           "delta"), or changes since a fix moment (_z or "zero").  Note that
  89.           turning interfaces off or on or otherwise reseting them can make it
  90.           seem that counters are changing wildly, since that often resets the
  91.           counters to zero.
  92.  
  93.      ----iiii   Show the state of interfaces which have been auto-configured
  94.           (interfaces statically configured into a system, but not located at
  95.           boot time are not shown).  When ----aaaa is also present, show all
  96.           addresses (unicast, multicast and link-level) associated with each
  97.           interface.
  98.  
  99.      ----iiiiqqqq  Show the information for ----iiii with the number of packets currently in
  100.           the output queue, the queue size, and the number of dropped packets
  101.           due to a full queue.
  102.  
  103.      ----IIII _i_n_t_e_r_f_a_c_e
  104.           Show information only about this interface; used with an _i_n_t_e_r_v_a_l as
  105.           described below.
  106.  
  107.      ----mmmm   Show statistics recorded by the memory management routines (the
  108.           network manages a private pool of memory buffers).
  109.  
  110.      ----nnnn   Show network addresses as numbers (normally _n_e_t_s_t_a_t interprets
  111.           addresses and attempts to display them symbolically).  This option
  112.           may be used with any of the display formats.
  113.  
  114.      ----pppp _p_r_o_t_o_c_o_l
  115.           Show statistics about _p_r_o_t_o_c_o_l, which is either a well-known name
  116.           for a protocol or an alias for it.  Some protocol names and aliases
  117.           are listed in the file /_e_t_c/_p_r_o_t_o_c_o_l_s.  A null response typically
  118.           means that there are no interesting numbers to report.  The program
  119.           will complain if _p_r_o_t_o_c_o_l is unknown or if there is no statistics
  120.           routine for it.  (This includes counting packets for the HELO
  121.           routing protocol as unknown.)  Note that if the protocols list is
  122.           obtained from a NIS server, it is important for the correct
  123.           operation of netstat that the NIS table contain all protocols that
  124.           the client supports but which the server may not, for example STP.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))                                                          NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))
  137.  
  138.  
  139.  
  140.      ----ssss   Show per-protocol statistics.
  141.  
  142.      ----rrrr   Show the routing tables.  When ----ssss is also present, show routing
  143.           statistics instead.
  144.  
  145.      ----MMMM   Show the kernel multicast routing tables.  When ----ssss is also present,
  146.           show multicast routing statistics instead.
  147.  
  148.      ----NNNN   Show socket addresses of family AF_LINK symbolically or numerically,
  149.           depending on whether the ----nnnn option is used, rather than in the
  150.           default format of lllliiiinnnnkkkk#### where # corresponds to the numerical index
  151.           into the ifnet array in the kernel.  This option is typically only
  152.           useful when displaying the routing tables using the ----rrrr option.
  153.  
  154.      ----ffff _a_d_d_r_e_s_s__f_a_m_i_l_y
  155.           Limit statistics or address control block reports to those of the
  156.           specified _a_d_d_r_e_s_s _f_a_m_i_l_y.  The following address families are
  157.           recognized:  _i_n_e_t, for AAAAFFFF____IIIINNNNEEEETTTT, and _u_n_i_x, for AAAAFFFF____UUUUNNNNIIIIXXXX.  (_n_s, for
  158.           AAAAFFFF____NNNNSSSS is not currently supported.)  Note that sockets created with a
  159.           type of PF_STP are still classified under AF_INET here, since they
  160.           use AF_INET addressing.
  161.  
  162.      ----tttt   If used in conjunction with ----iiii, displays the value of the interface
  163.           watchdog timer.
  164.  
  165.      ----uuuu   A synonym for ----ffff uuuunnnniiiixxxx.
  166.  
  167.      ----TTTT   When used in conjunction with ----VVVV print just the current value used
  168.           to reset the retransmit timers in a TCP protocol control block.
  169.  
  170.      ----VVVV   Specify very-verbose mode.  When used in conjunction with the ----aaaa
  171.           switch, detailed state information is displayed for each TCP
  172.           protocol control block.  It is useful to combine use of this switch
  173.           with ----LLLL and ----FFFF to specify particular PCBs.
  174.  
  175.      The arguments, _s_y_s_t_e_m and _c_o_r_e allow substitutes for the defaults
  176.      ``/unix'' and ``/dev/kmem''.
  177.  
  178.      The default display, for active sockets, shows the local and remote
  179.      addresses, send and receive queue sizes (in bytes), protocol, and the
  180.      internal state of the protocol.  Address formats are of the form
  181.      ``host.port'' or ``network.port'' if a socket's address specifies a
  182.      network but no specific host address.  When known the host and network
  183.      addresses are displayed symbolically according to the data bases
  184.      /_e_t_c/_h_o_s_t_s and /_e_t_c/_n_e_t_w_o_r_k_s, respectively.  If a symbolic name for an
  185.      address is unknown, or if the ----nnnn option is specified, the address is
  186.      printed numerically, according to the address family.  For more
  187.      information regarding the Internet ``dot format,'' refer to _i_n_e_t(3N).
  188.      Unspecified, or ``wildcard'', addresses and ports appear as ``*''.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))                                                          NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))
  203.  
  204.  
  205.  
  206.      The interface display provides a table of cumulative statistics regarding
  207.      packets transferred, errors, and collisions.  The network addresses of
  208.      the interface and the maximum transmission unit (``mtu'') are also
  209.      displayed.
  210.  
  211.      The routing table display indicates the available routes and their
  212.      status.  Each route consists of a destination host or network and a
  213.      gateway to use in forwarding packets.  The flags field shows a collection
  214.      of information about the route stored as binary choices.  The individual
  215.      flags are discussed in more detail in the _r_o_u_t_e(1M) and _r_o_u_t_e(7) manual
  216.      pages.  The mapping between letters and flags is:
  217.  
  218.      1       RTF_PROTO1       Protocol-specific routing flag #1
  219.      2       RTF_PROTO2       Protocol-specific routing flag #2
  220.      B       RTF_BLACKHOLE    Just discard pkts (during updates)
  221.      C       RTF_CLONING      Generate new routes on use
  222.      D       RTF_DYNAMIC      Created dynamically (by redirect)
  223.      G       RTF_GATEWAY      Destination requires forwarding by intermediary
  224.      H       RTF_HOST         Host entry (net otherwise)
  225.      L       RTF_LLINFO       Valid protocol to link address translation.
  226.      M       RTF_MODIFIED     Modified dynamically (by redirect)
  227.      R       RTF_REJECT       Host or net unreachable
  228.      S       RTF_STATIC       Manually added
  229.      U       RTF_UP           Route usable
  230.      X       RTF_XRESOLVE     External daemon translates proto to link address
  231.      c       RTF_CKSUM        TCP/UDP checksumming done on this route
  232.  
  233.      Direct routes are created for each interface attached to the local host;
  234.      the gateway field for such entries shows the address of the outgoing
  235.      interface.  The MTU field shows the MTU value set with the _r_o_u_t_e(1M)
  236.      command for that route.  The RTT and RTTvar fields show the estimated
  237.      round-trip time (RTT) and the variance in RTT for routes with large
  238.      amounts of TCP traffic.  The RTT and RTTvar values are in seconds with a
  239.      resolution of .125 seconds.  The use field provides a count of the number
  240.      of packets sent using that route.  The interface entry indicates the
  241.      network interface utilized for the route.
  242.  
  243.      When _n_e_t_s_t_a_t is invoked with an _i_n_t_e_r_v_a_l argument, it displays a running
  244.      count of statistics related to network interfaces.  This display consists
  245.      of a column for the primary interface (the first interface found during
  246.      autoconfiguration) and a column summarizing information for all
  247.      interfaces.  The primary interface may be replaced with another interface
  248.      with the ----IIII option.  The first line of each screen of information
  249.      contains a summary since the system was last rebooted.  Subsequent lines
  250.      of output show values accumulated over the preceding interval.
  251.  
  252. DDDDEEEETTTTEEEERRRRMMMMIIIINNNNIIIINNNNGGGG SSSSEEEERRRRVVVVIIIICCCCEEEE UUUUSSSSAAAAGGGGEEEE
  253.      To match a socket to a process, the _f_u_s_e_r(1M) command can be used.  For
  254.      example, the command
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))                                                          NNNNEEEETTTTSSSSTTTTAAAATTTT((((1111))))
  269.  
  270.  
  271.  
  272.           fuser 25/tcp
  273.  
  274.  
  275.      will display information about any processes listening on TCP port 25.
  276.      Note that _f_u_s_e_r requires the numeric value for the port, not the name of
  277.      the service.  The ----nnnn option will force _n_e_t_s_t_a_t to display service
  278.      information numerically.
  279.  
  280. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  281.      fuser(1M), nfsstat(1M), route(1M), smtstat(1), hosts(4), networks(4),
  282.      protocols(4), services(4), route(7), stp(7)
  283.  
  284. BBBBUUUUGGGGSSSS
  285.      The notion of errors is ill-defined.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.