CTLSTAT(8) BSD System Manager's Manual CTLSTAT(8)
NAME
ctlstat -- CAM Target Layer statistics utility
SYNOPSIS
ctlstat [-t] [-c count] [-C] [-d] [-D] [-j] [-l lun] [-n numdevs] [-w wait]
DESCRIPTION
The ctlstat utility provides statistics information for the CAM Target Layer. The first display (except for dump and JSON modes) shows aver-
age statistics since system startup. Subsequent displays show average statistics during the measurement interval.
The options are as follows:
-t Total mode. This displays separate columns with the total CTL read and write output, and a combined total column that also
includes non I/O operations.
-c count Display statistics this many times.
-C Disable display of CPU statistics.
-d Display DMA operation time (latency) instead of overall I/O time (latency).
-D Text dump mode. Dump all available statistics every 30 seconds in a text format suitable for parsing. No statistics are com-
puted in this mode, only raw numbers are displayed.
-h Suppress display of the header.
-j JSON dump mode. Dump all available statistics every 30 seconds in JavaScript Object Notation (JSON) format. No statistics are
computed in this mode, only raw numbers are displayed.
-l lun Request statistics for the specified LUN. This option is incompatible with total (-t) mode.
-n numdevs Display statistics for this many devices.
-w wait Wait this many seconds in between displays. If this option is not specified, ctlstat defaults to a 1 second interval.
EXAMPLES
ctlstat -t
Display total statistics for the system with a one second interval.
ctlstat -d -l 5 -C
Display average DMA time for LUN 5 and omit CPU utilization.
ctlstat -n 7 -w 10
Display statistics for the first 7 LUNs, and display average statistics every 10 seconds.
SEE ALSO
cam(3), cam(4), ctl(4), xpt(4), camcontrol(8), ctladm(8), iostat(8)
AUTHORS
Ken Merry <ken@FreeBSD.org>
Will Andrews <will@FreeBSD.org>
BSD
March 6, 2013 BSD
