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
cifsiostat(1) - debian
iostat(8) - opendarwin
auditstat(1m) - sunos
iostat(8) - osx
cifsiostat(1) - minix
Similar Topics in the Unix Linux Community
Need to total numbers at end of script
how to check missing files?
count average
Extract numbers from text file work out average
CPU Usage statistics Dump in a text file over a period of time