Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GSTAT(8)		     System Manager's Manual			GSTAT(8)

NAME
     gstat -- print statistics about GEOM disks

SYNOPSIS
     gstat [-abBcCdops] [-f filter] [-I interval]

DESCRIPTION
     The  gstat  utility  can be used to monitor I/O transactions of geom(4) de-
     vices.

     The options are as follows:

     -a      Only display providers that are at least 0.1% busy.

     -b      Batch mode.  Collect numbers, print and exit.  Default if stdout is
	     not a tty.

     -B      Endless batch mode.  Same as batch mode, but does	not  exit  after
	     collecting the first set of data.

     -c      Enable  display  of  geom(4) consumers too.  The default is to show
	     statistics only for geom(4) producers.

     -C      CSV output mode.  Implies endless batch mode, but output is in  the
	     form of comma-separated values, with ISO 8601-like timestamps.

     -d      Enable display of statistics for delete (BIO_DELETE) operations.

     -f filter
	     A	regular  expression that can be used to only show statistics for
	     some devices.  Only devices with the names matching filter will  be
	     displayed.   The  format  of the regular expression is described in
	     re_format(7).

     -I interval
	     Refresh the gstat display every interval  microseconds.   Adding  a
	     suffix  of s, ms, or us (the default) indicates that the update in-
	     terval is specified in seconds, milliseconds, or microseconds,  re-
	     spectively.

     -o      Enable display of statistics for other operations (BIO_FLUSH).

     -p      Only display physical providers (those with rank of 1).

     -s      Enable blocks' size statistics.

INTERACTIVE COMMANDS
     These  commands  are  currently recognized if gstat is not running in batch
     mode:

     <	     Halve the update interval.

     >	     Double the update interval.

     c	     Toggle display of geom(4) consumers.

     f	     Display only devices with the  names  matching  regular  expression
	     filter (prompt for filter).

     F	     Remove device filter.

     q	     Quit gstat.

EXIT STATUS
     The gstat utility exits 0 on success, and >0 if an error occurs.

EXAMPLES
     To filter the output to only physical disks named ada0 through ada4:
	   # gstat -f ada[0-4]$

SEE ALSO
     systat(1), geom(4), iostat(8), vmstat(8)

HISTORY
     A gstat utility appeared in FreeBSD 5.0.

FreeBSD ports 15.quarterly	February 1, 2025			GSTAT(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gstat&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help