Add new stats(7) man page and hook it up to the build.

This man page contains stat utilities that are available in
the base system. This is a better approach than looking them
up via "apropos stat" or similar commands.

Thanks to Daniel Ebdrup Jensen for writing the original page
and incorporating the feedback given.

Submitted by:	Daniel Ebdrup Jensen
Reviewed by:	0mp, allanjude, brueffer, bcr
Approved by:	bcr
MFC after:	3 days
Relnotes:	yes (new stats(7) man page)
Differential Revision:	https://reviews.freebsd.org/D24417
This commit is contained in:
Benedict Reuschling 2020-05-14 09:18:50 +00:00
parent 3347e196e2
commit 9367806da8
2 changed files with 121 additions and 0 deletions

View File

@ -26,6 +26,7 @@ MAN= arch.7 \
sdoc.7 \
security.7 \
sprog.7 \
stats.7 \
stdint.7 \
sticky.7 \
tests.7 \

120
share/man/man7/stats.7 Normal file
View File

@ -0,0 +1,120 @@
.\"
.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD
.\"
.\" Copyright (c) 2020 Daniel Ebdrup Jensen
.\"
.\" 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.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" 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 AUTHOR 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.
.\"
.\" $FreeBSD$
.\"
.Dd May 14, 2020
.Dt STATS 7
.Os
.Sh NAME
.Nm stats
.Nd information about various and sundry statistics utilities
.Sh DESCRIPTION
The
.Fx
userland in part contains a series of utilities which can be used
to ascertain system state at runtime and optionally from core files.
.Sh COMMANDS
The following commands
.Pq sorted alphabetically
are currently included in the base system, with more appearing periodically.
.Bl -tag -width "zpool iostat"
.It Nm btsockstat
Show Bluetooth socket information
.It Nm ctlstat
CAM Target Layer statistics utility
.It Nm fstat
Identify active files
.It Nm gstat
Print statistics about GEOM disks
.It Nm ibstat
Display information from the InfiniBand driver
.It Nm ifmcstat
Dump multicast group management statistics per interface
.It Nm iostat
Report kernel subsystem I/O statistics
.It Nm ipfstat
Display IPF packet filter statistics and filter list
.It Nm kldstat
Display status of dynamic kernel linker
.It Nm lockstat
Report kernel lock and profiling statistics
.It Nm mailstats
Display mail statistics
.It Nm netstat
Show network status and statistics
.It Nm nfsstat
Display NFS statistics
.It Nm plockstat
Trace pthread lock statistics using DTrace
.It Nm pmcstat
Performance measurement with performance monitoring hardware
.It Nm procstat
Get detailed process information
.It Nm pstat
Display system data structures
.It Nm sockstat
List open sockets
.It Nm stat
Display file status
.It Nm systat
Display system statistics
.It Nm vmstat
Report virtual memory statistics
.It Nm zpool iostat
Report ZFS I/O statistics
.Sh SEE ALSO
.Xr intro 1 ,
.Xr intro 7 ,
.Xr intro 8 ,
.Xr btsockstat 1 ,
.Xr ctlstat 8 ,
.Xr fstat 1 ,
.Xr gstat 8 ,
.Xr ibstat 8 ,
.Xr ifmcstat 8 ,
.Xr iostat 8 ,
.Xr ipfstat 8 ,
.Xr kldstat 8 ,
.Xr lockstat 1 ,
.Xr mailstats 8 ,
.Xr netstat 1 ,
.Xr plockstat 1 ,
.Xr pmcstat 8 ,
.Xr procstat 1 ,
.Xr pstat 8 ,
.Xr sockstat 1,
.Xr stat 1 ,
.Xr systat 1 ,
.Xr vmstat 8 ,
.Xr zpool-iostat 8 ,
.Sh HISTORY
The
.Nm
manual page first appeared in
.Fx 13.0 .
.Sh AUTHORS
.An Daniel Ebdrup Jensen Aq Mt debdrup@FreeBSD.org