freebsd man page for ctlstat

Query: ctlstat

OS: freebsd

Section: 8

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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
Related Man Pages
auditstat(1m) - opensolaris
iostat(8) - mojave
auditstat(1m) - sunos
ctlstat(8) - freebsd
cifsiostat(1) - minix
Similar Topics in the Unix Linux Community
Bash: how to do it?
io utilization (average) on AIX
count average
count average
How can I increase a PV?