document new flags

[unix-history] / usr / src / usr.bin / netstat / netstat.1

diff --git a/usr/src/usr.bin/netstat/netstat.1 b/usr/src/usr.bin/netstat/netstat.1
index e688aa9..bf4e143 100644 (file)
--- a/usr/src/usr.bin/netstat/netstat.1
+++ b/usr/src/usr.bin/netstat/netstat.1
@@ -1,9 +1,9 @@
-.\" Copyright (c) 1983, 1990 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (c) 1983, 1990, 1992, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\" %sccs.include.redist.roff%
 .\"
 .\"
 .\" %sccs.include.redist.roff%
 .\"

-.\"    @(#)netstat.1   6.14 (Berkeley) %G%
+.\"    @(#)netstat.1   8.5 (Berkeley) %G%

 .\"
 .Dd 
 .Dt NETSTAT 1
 .\"
 .Dd 
 .Dt NETSTAT 1


@@ -15,16 +15,16 @@
 .Nm netstat
 .Op Fl Aan
 .Op Fl f Ar address_family
 .Nm netstat
 .Op Fl Aan
 .Op Fl f Ar address_family

-.Op Ar system
-.Op Ar core
+.Op Fl M Ar core
+.Op Fl N Ar system

 .Nm netstat
 .Nm netstat

-.Op Fl himnrs
+.Op Fl dghimnrs

 .Op Fl f Ar address_family
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Nm netstat
 .Op Fl f Ar address_family
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Nm netstat

-.Op Fl n
-.Op Fl I Op Ar interface
+.Op Fl dn
+.Op Fl I Ar interface

 .Op Fl M Ar core
 .Op Fl N Ar system
 .Op Fl w Ar wait
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Op Fl w Ar wait


@@ -66,17 +66,29 @@ With either interface display (option
 .Fl i
 or an interval, as described below),
 show the number of dropped packets.
 .Fl i
 or an interval, as described below),
 show the number of dropped packets.

+.It Fl g
+Show information related to multicast (group address) routing.
+By default, show the IP Multicast virtual-interface and routing tables.
+If the
+.Fl s
+option is also present, show multicast routing statistics.

 .It Fl h
 Show the state of the
 .Tn IMP
 .It Fl h
 Show the state of the
 .Tn IMP

-host table.
+host table (obsolete).

 .It Fl i
 Show the state of interfaces which have been auto-configured
 (interfaces statically configured into a system, but not
 located at boot time are not shown).
 .It Fl i
 Show the state of interfaces which have been auto-configured
 (interfaces statically configured into a system, but not
 located at boot time are not shown).

+If the
+.Fl a
+options is also present, multicast addresses currently in use are shown
+for each Ethernet interface and for each IP interface address.
+Multicast addresses are shown on separate lines following the interface
+address with which they are associated.

 .It Fl I Ar interface 
 .It Fl I Ar interface 

-Show information only about this interface;
-used with an
+Show information about the specified interface;
+used with a

 .Ar wait
 interval as described below.
 .It Fl M
 .Ar wait
 interval as described below.
 .It Fl M


@@ -108,6 +120,7 @@ The program will complain if
 is unknown or if there is no statistics routine for it.
 .It Fl s
 Show per-protocol statistics.
 is unknown or if there is no statistics routine for it.
 .It Fl s
 Show per-protocol statistics.

+If this option is repeated, counters with a value of zero are suppressed.

 .It Fl r
 Show the routing tables.
 When
 .It Fl r
 Show the routing tables.
 When


@@ -129,6 +142,10 @@ and
 .Ar unix  ,
 for
 .Dv AF_UNIX  .
 .Ar unix  ,
 for
 .Dv AF_UNIX  .

+.It Fl w Ar wait
+Show network interface statistics at intervals of
+.Ar wait
+seconds.

 .El
 .Pp
 The default display, for active sockets, shows the local
 .El
 .Pp
 The default display, for active sockets, shows the local


@@ -178,10 +195,14 @@ interface utilized for the route.
 .Pp
 When
 .Nm netstat
 .Pp
 When
 .Nm netstat

-is invoked with a
+is invoked with the
+.Fl w
+option and a

 .Ar wait
 interval argument, it displays a running count of statistics related to
 network interfaces.
 .Ar wait
 interval argument, it displays a running count of statistics related to
 network interfaces.

+An obsolescent version of this option used a numeric parameter
+with no option, and is currently supported for backward compatibility.

 This display consists of a column for the primary interface (the first
 interface found during autoconfiguration) and a column summarizing
 information for all interfaces.
 This display consists of a column for the primary interface (the first
 interface found during autoconfiguration) and a column summarizing
 information for all interfaces.


@@ -216,6 +237,3 @@ command appeared in
 .\" .El
 .Sh BUGS
 The notion of errors is ill-defined.
 .\" .El
 .Sh BUGS
 The notion of errors is ill-defined.

-.Pp
-Collisions mean something else for the
-.Tn IMP .