 @@ -1,14 +1,14 @@
-.\"	$NetBSD: systat.1,v 1.53 2023/03/29 19:40:18 kre Exp $
+.\"	$NetBSD: systat.1,v 1.54 2023/03/29 21:44:35 uwe Exp $
 .\"
 .\" Copyright (c) 1985, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 3. Neither the name of the University nor the names of its contributors
 @@ -19,196 +19,193 @@
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)systat.1	8.2 (Berkeley) 12/30/93
 .\"
-.Dd August 21, 2021
+.Dd March 29, 2023
 .Dt SYSTAT 1
 .Os
 .Sh NAME
 .Nm systat
 .Nd display system statistics in a full-screen view
 .Sh SYNOPSIS
 .Nm
 .Op Fl bnz
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Op Fl t Ar turns
 .Op Fl w Ar wait
 .Op Ar display
-.Op Ar refresh-interval
+.Op Ar wait
 .Sh DESCRIPTION
 .Nm
 displays various system statistics in a screen oriented fashion
-using the curses screen display library,
+using the
-.Xr curses 3 .
+.Xr curses 3
 screen display library.
 .Pp
 While
 .Nm
-is running the screen is usually divided into two windows (an exception
+is running the screen is usually divided into two windows
-is the vmstat display which uses the entire screen).
+.Pq an exception is the vmstat display which uses the entire screen .
 The upper window depicts the current system load average.
 The information displayed in the lower window may vary, depending on
 user commands.
 The last line on the screen is reserved for user input and error messages.
 .Pp
 By default
 .Nm
 displays the processes getting the largest percentage of the processor
 in the lower window.
 Other displays show more detailed process information,
 swap space usage,
-disk usage statistics (a la
+disk usage statistics
-.Xr df 1 ) ,
+.Pq a\~la Xr df 1 ,
-disk I/O statistics (a la
+disk I/O statistics
-.Xr iostat 8 ) ,
+.Pq a\~la Xr iostat 8 ,
-virtual memory statistics (a la
+virtual memory statistics
-.Xr vmstat 1 ) ,
+.Pq a\~la Xr vmstat 1 ,
-network
+network mbuf utilization,
-.Qq Ic mbufs
+network interface traffic,
-utilization, network
+and network connections
-.Qq Ic ifstat
+.Pq a\~la Xr netstat 1 .
 traffic, and network connections (a la
 .Xr netstat 1 ) .
 .Pp
 Input is interpreted at two different levels.
-A ``global'' command interpreter processes all keyboard input.
+A global command interpreter processes all keyboard input.
 If this command interpreter fails to recognize a command, the
 input line is passed to a per-display command interpreter.
 This allows each display to have certain display-specific commands.
 .Pp
 Command line options:
-.Bl -tag -width "refresh_interval"
+.Bl -tag -width Fl
 .It Fl b
 Show the chosen display once and exit.
 .It Fl M Ar core
 Extract values associated with the name list from
 .Ar core
 instead of the default
 .Pa /dev/mem .
 .It Fl N Ar system
 Extract the name list from
 .Ar system
 instead of the default
 .Pa /netbsd .
 .It Fl b
 Show the chosen display once and exit.
 .It Fl n
 Do not resolve IP addresses into string hostnames
-.Pq FQDNs
+.Pf ( Tn FQDN Ns s ) .
 on
 .Ic netstat .
 It has the same effect as
 .Ic numbers
 subcommand in
 .Ic netstat .
 .It Fl w Ar wait
 See
 .Ar refresh-interval .
 .It Fl t Ar turns
-How many refreshes to show each screen in 'all' display mode.
+How many refresh cycles to show each screen in
 .Sq all
 display mode.
 The default is 2.
 .It Fl w Ar wait
 Set the screen refresh interval to
 .Ar wait
 seconds.
 Floating point numbers are accepted.
 The default is 1\~second.
 .It Fl z
 Display 0 instead of space when there is no data.
 .It Ar display
 The
 .Ar display
 argument expects to be one of:
 .Ic all ,
 .Ic bufcache ,
 .Ic df ,
 .Ic ifstat ,
 .Ic inet.icmp ,
 .Ic inet.ip ,
 .Ic inet.tcp ,
 .Ic inet.tcpsyn ,
 .Ic inet6.ip6 ,
 .Ic iostat ,
 .Ic mbufs ,
 .Ic netstat ,
 .Ic pigs ,
 .Ic ps ,
 .Ic swap ,
 .Ic syscall
 or
 .Ic vmstat .
 These displays can also be requested interactively and are described in
 full detail below.
-.It Ar refresh-interval
+.It Ar wait
-The
+The same as
-.Ar refresh-interval
+.Fl w Ar wait .
-specifies the screen refresh time interval in seconds.
+This form is provided for backwards compatibility.
 This is provided for backwards compatibility, and overrides the
 .Ar refresh-interval
 specified with the
 .Fl w
 flag.
 .It Fl z
 Display 0 instead of space when there is no data.
 .El
 .Pp
 Certain characters cause immediate action by
 .Nm  .
 These are
-.Bl -tag -width Fl
+.Bl -tag -width Ic
 .It Ic \&^L
 Refresh the screen.
 .It Ic \&^G
-Print the name of the current ``display'' being shown in
+Print the name of the current display being shown in
 the lower window and the refresh interval.
 .It Ic \&^Z
-Stop
+Suspend
 .Nm  .
 .It Ic \&? , Ic h
 Print the names of the available displays on the command line.
 .It Ic \&:
 Move the cursor to the command line and interpret the input
 line typed as a command.
 While entering a command the current character erase, word erase,
 and line kill characters may be used.
 .El
 .Pp
-The following commands are interpreted by the ``global''
+The following commands are interpreted by the global
 command interpreter.
-.Bl -tag -width Fl
+.Bl -tag -width Ic
-.It Ic help Ar key
+.It Ic help Op Ar key
 Print the names of the available displays on the command line.
 It will print long names as
-.Dq Ic inet.* .
+.Ql inet.* .
 To print items under
-.Dq Ic inet ,
+.Ic inet ,
 give
 .Ic inet
 as
 .Ar key .
 .It Ic load
 Print the load average over the past 1, 5, and 15 minutes
 on the command line.
-.It Ic stop
+.It Ic quit
-Stop refreshing the screen.
+Exit
 .Nm  .
 .Pq This may be abbreviated to Ic q .
 .It Oo Ic start Oc Oo Ar number Oc
 Start (continue) refreshing the screen.
 If a second, numeric, argument is provided it is interpreted as a
 refresh interval in seconds.
 Supplying only a number will set the refresh interval to this
 value.
-.It Ic quit
+.It Ic stop
-Exit
+Stop refreshing the screen.
 .Nm  .
 (This may be abbreviated to
 .Ic q  . )
 .El
 .Pp
 The available displays are:
 .Bl -tag -width Ic
 .It Ic all
 Cycle through all displays automatically.
 At each display, wait some
 refresh-turns, then switch to the next display.
 Duration of one refresh-turn is adjustable with the
 .Fl w
 option, number of refresh-turns can be changed with the
 .Fl t
 option.
 @@ -216,97 +213,110 @@ option.
 Display, in the lower window, statistics about the file system buffers.
 Statistics for each file system that has active buffers include the number
 of buffers for that file system, the number of active kilobytes in those
 buffers and the total size of the buffers for that file system.
 .It Ic df
 Lists disk usage statistics for all filesystems,
 including the available free space as well as a bar
 graph indicating the used capacity.
 .Pp
 The following commands are specific to the
 .Ic df
 display:
 .Pp
-.Bl -tag -width Fl -compact
+.Bl -tag -width Fl
 .It Cm all
 Displays information for all filesystems, including
 kernfs, procfs and null-mounts.
 .It Cm some
 Suppress information about procfs, kernfs and null-mounts (default).
 .El
 .It Ic ifstat
 Display the network traffic going through active interfaces on the
 system.
 Idle interfaces will not be displayed until they receive some
 traffic.
 .Pp
 For each interface being displayed, the current, peak and total
 statistics are displayed for incoming and outgoing traffic.
 By default,
 the
 .Ic ifstat
 display will automatically scale the units being used so that they are
 in a human-readable format.
 The scaling units used for the current and
 peak
 traffic columns can be altered by the
 .Ic scale
 command.
-.Bl -tag -width ".Cm scale Op Ar units"
+.Bl -tag -width Cm
 .It Cm scale Op Ar units
 Modify the scale used to display the current and peak traffic over all
 interfaces.
-The following units are recognised: kbit, kbyte, mbit,
+The following units are recognised:
-mbyte, gbit, gbyte and auto.
+.Ic kbit , kbyte , mbit , mbyte , gbit , gbyte
 and
 .Ic auto .
 .It Cm pps
-Show statistics in packets per second instead of bytes/bits per second.
+Show statistics in packets per second instead of bytes or bits per second.
 A subsequent call of
 .Ic pps
 switches this mode off.
-.It Cm match Op Ar patterns
+.It Cm match Op Ar pattern ...
-Display only interfaces that match pattern provided as an argument.
+Display only interfaces that match
-Patterns should be in shell syntax separated by whitespaces or commas.
+.Ar pattern\^ Ns s
 provided as an argument.
 Patterns should be in shell
 .Xr glob 7
 syntax separated by whitespaces or commas.
 If this command is called without arguments then all interfaces are displayed.
 For example:
 .Pp
 .Dl match re0, bge1
 .Pp
-This will display re0 and bge1 interfaces.
+This will display
 .Li re0
 and
 .Li bge1
 interfaces.
 .Pp
-.Dl match re*, bge*, lo0
+.Dl match re* bge* lo0
 .Pp
 This will display all
-.Ic re
+.Li re
 interfaces, all
-.Ic bge
+.Li bge
 interfaces and the loopback interface.
 .El
 .It Ic inet.icmp
 Display ICMP statistics.
 .It Ic inet.ip
 Display IPv4 and UDP statistics.
 .It Ic inet.tcp
 Display TCP statistics.
 .It Ic inet.tcpsyn
-Display statistics about the TCP ``syncache''.
+Display statistics about the TCP syncache.
 .It Ic inet6.ip6
 Display IPv6 statistics.
 .It Ic iostat
 Display, in the lower window, statistics about processor use
 and disk throughput.
 Statistics on processor use appear as bar graphs of the amount of
-time executing in user mode (``user''), in user mode running low
+time executing in user mode,
-priority processes (``nice''), in system mode (``system''), and
+in user mode running low priority
-idle (``idle'').
+.Pq Dq nice
 processes,
 in system mode,
 and idle.
 Statistics on disk throughput show, for each drive, kilobytes of
 data transferred, number of disk transactions performed, and time
 spent in disk accesses in milliseconds.
 This information may be displayed as bar graphs or as rows of
 numbers which scroll downward.
 Bar graphs are shown by default;
 .Pp
 The following commands are specific to the
 .Ic iostat
 display; the minimum unambiguous prefix may be supplied.
 .Pp
 .Bl -tag -width Fl -compact
 .It Cm numbers
 @@ -319,109 +329,123 @@ Show the disk I/O statistics in bar grap
 Toggle the display of time in disk activity (the default is to
 not display time).
 .It Cm all
 Show the read and write statistics combined (default).
 .It Cm rw
 Show the read and write statistics separately.
 .El
 .It Ic mbufs
 Display, in the lower window, the number of mbufs allocated
 for particular uses, i.e. data, socket structures, etc.
 .It Ic netstat
 Display, in the lower window, network connections.
 By default, network servers awaiting requests are not displayed.
-Each address is displayed in the format ``host.port'', with each
+Each address is displayed in the format
 .Ar host Ns Li . Ns Ar port ,
 with each
 shown symbolically, when possible.
 It is possible to have addresses displayed numerically,
 limit the display to a set of ports, hosts, and/or protocols
-(the minimum unambiguous prefix may be supplied):
+.Pq the minimum unambiguous prefix may be supplied :
 .Pp
-.Bl -tag -width Ar -compact
+.Bl -tag -width Cm
 .It Cm all
-Toggle the displaying of server processes awaiting requests (this
+Toggle the displaying of server processes awaiting requests
-is the equivalent of the
+.Po
 this is the equivalent of the
 .Fl a
 flag to
-.Ar netstat  1  ) .
+.Xr netstat 1
-.It Cm numbers
+.Pc .
 Display network addresses numerically.
 .It Cm names
 Display network addresses symbolically.
 .It Ar protocol
 Display only network connections using the indicated protocol
 (currently either ``tcp'' or ``udp'').
 .It Cm ignore Op Ar items
 Do not display information about connections associated with
 the specified hosts or ports.
 Hosts and ports may be specified by name (``vangogh'', ``ftp''),
 or numerically.
 Host addresses use the Internet dot notation (``128.32.0.9'').
 Multiple items may be specified with a single command by separating
 them with spaces.
 .It Cm display Op Ar items
 Display information about the connections associated with the
 specified hosts or ports.
 Hosts and ports may be specified by name
 .Pq Ql vangogh , ftp ,
 or numerically.
 Host addresses use the Internet dot notation
 .Pq Ql 128.32.0.9 .
 Multiple items may be specified with a single command by separating
 them with spaces.
 .It Cm ignore Op Ar items
 Do not display information about connections associated with
 the specified hosts or ports.
 As for
-.Ar ignore  ,
+.Ic display ,
-.Op Ar items
+the
 .Ar items
 may be names or numbers.
-.It Cm show Op Ar ports\&|hosts
+.It Cm names
 Display network addresses symbolically.
 .It Cm numbers
 Display network addresses numerically.
 .It Ar protocol
 Display only network connections using the indicated protocol
 .Po
 currently either
 .Ic tcp
 or
 .Ic udp
 .Pc .
 .It Cm show Op Cm hosts No \&| Cm ports
 Show, on the command line, the currently selected protocols,
 hosts, and ports.
-Hosts and ports which are being ignored are prefixed with a `!'.
+Hosts and ports which are being ignored are prefixed with a
 .Ql \&! .
 If
-.Ar ports
+.Cm ports
 or
-.Ar hosts
+.Cm hosts
 is supplied as an argument to
 .Cm show  ,
 then only the requested information will be displayed.
 .It Cm reset
-Reset the port, host, and protocol matching mechanisms to the default
+Reset the port, host, and protocol filters, show everything.
 (any protocol, port, or host).
 .El
 .It Ic pigs
 Display, in the lower window, those processes which are getting the
 largest portion of the processor (the default display).
 When less than 100% of the
 processor is scheduled to user processes, the remaining time
-is accounted to the ``idle'' process.
+is accounted to the idle process.
 .It Ic ps
 Display, in the lower window, the same information provided
 by the command
 .Xr ps 1
 with the flags
 .Fl aux .
 .Pp
 The following command is specific to the
 .Ic ps
 display; the minimum unambiguous prefix may be supplied.
 .Pp
 .Bl -tag -width Fl -compact
 .It Cm user Ar name
 Limit the list of processes displayed to those owned by user
 .Ar name .
 If
 .Ar name
-is specified as `+', processes owned by any user are displayed (default).
+is specified as
 .Ql \&+ ,
 processes owned by any user are displayed (default).
 .El
 .It Ic swap
 Show information about swap space usage on all the
 swap areas configured with
 .Xr swapctl 8 .
 The first column is the device name of the partition.
 The next column is the total space available in the partition.
 The
-.Ar Used
+.Dq Used
 column indicates the total blocks used so far;
 the graph shows the percentage of space in use on each partition.
 If there are more than one swap partition in use,
 a total line is also shown.
 Areas known to the kernel, but not in use are shown as not available.
 .It Ic syscall
 Show per system call statistics.
 The display consists of several columns of system call name and counts.
 .Pp
 In order to stop entries moving around the screen too much, an infinite
 response filter is applied to the values before they are sorted.
 .Pp
 The following commands are specific to the
 @@ -576,27 +600,30 @@ Thus this figure is most interesting whe
 a long time period, such as from boot time
 (see below on getting such a display).
 .Pp
 To the left of the column of paging statistics is a breakdown
 of the interrupts being handled by the system.
 At the top of the list is the total interrupts per second
 over the time interval.
 The rest of the column breaks down the total on a device
 by device basis.
 Only devices that have interrupted at least once since boot time are shown.
 .El
 .Pp
 Commands to switch between displays may be abbreviated to the
-minimum unambiguous prefix; for example, ``io'' for ``iostat''.
+minimum unambiguous prefix; for example,
 .Ic io
 for
 .Ic iostat .
 Certain information may be discarded when the screen size is
 insufficient for display.
 For example, on a machine with 10 drives the
 .Ic iostat
 bar graph displays only 3 drives on a 24 line terminal.
 When a bar graph would overflow the allotted screen space it is
 truncated and the actual value is printed ``over top'' of the bar.
 .Pp
 The following commands are common to each display which shows
 information about disk drives.
 These commands are used to select a set of drives to report on,
 should your system have more drives configured than can normally
 be displayed on the screen.
 @@ -640,31 +667,33 @@ Reset running statistics to zero.
 .Bl -tag -width /etc/networks -compact
 .It Pa /netbsd
 For the namelist.
 .It Pa /dev/kmem
 For information in main memory.
 .It Pa /etc/hosts
 For host names.
 .It Pa /etc/networks
 For network names.
 .It Pa /etc/services
 For port names.
 .El
 .Sh NOTES
-Much of the information that
+Most of the information shown by
 .Nm
 .Ic vmstat
-uses is obtained from
+is obtained from the
-.Cm struct vmmeter cnt .
+.Ql vm.vmmeter
 .Xr sysctl 7
 node.
 .Sh SEE ALSO
 .Xr df 1 ,
 .Xr netstat 1 ,
 .Xr ps 1 ,
 .Xr top 1 ,
 .Xr vmstat 1 ,
 .Xr iostat 8 ,
 .Xr pstat 8
 .Sh HISTORY
 The
 .Nm
 program appeared in
 .Bx 4.3 .