NAME
ctlstat —
CAM Target Layer statistics
utility
SYNOPSIS
ctlstat |
[-t] [-c
count] [-C]
[-d] [-D]
[-j] [-l
lun] [-n
numdevs] [-p
port] [-w
wait] |
DESCRIPTION
Thectlstat utility provides statistics information for
the CAM Target Layer. The first display (except for dump and JSON modes) shows
average 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 read and write output, and a combined total column that also includes non I/O operations.
-ccount- Display statistics this many times.
-C- Disable CPU statistics display.
-d- Display DMA operation time (latency) instead of overall I/O time (latency).
-D- Text dump mode. Dump statistics every 30 seconds in a text format suitable for parsing. No statistics are computed in this mode, only raw numbers are displayed.
-h- Suppress display of the header.
-j- JSON dump mode. Dump statistics every 30 seconds in JavaScript Object Notation (JSON) format. No statistics are computed in this mode, only raw numbers are displayed.
-llun- Request statistics for the specified LUN.
-nnumdevs- Display statistics for this many devices.
-pport- Request statistics for the specified port.
-wwait- Wait this many seconds in between displays. If this option is not
specified,
ctlstatdefaults to a 1 second interval.
EXAMPLES
ctlstat -tDisplay total statistics for the system with a one second interval.
ctlstat -d -l 5 -CDisplay average DMA time for LUN 5 and omit CPU utilization.
ctlstat -n 7 -w 10Display 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), ctld(8), iostat(8)
AUTHORS
Ken Merry
<ken@FreeBSD.org>
Will Andrews
<will@FreeBSD.org>
Alexander Motin
<mav@FreeBSD.org>