unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



advfsstat(8)							 advfsstat(8)



NAME

  advfsstat - Displays AdvFS performance statistics

SYNOPSIS

  /usr/sbin/advfsstat [options]	[stats-type] domain

  /usr/sbin/advfsstat [options]	-f 0 | 1 | 2 domain fileset

OPTIONS

  -i sec
      Specifies	the time interval (in seconds) between displays. The
      advfsstat	command	collects and reports information only for the speci-
      fied interval. If	sec is omitted,	advfsstat uses a default interval of
      one second.

  -c count
      Specifies	the number of reports. If a count of- 0	is specified then a
      count of 1 is assumed. If	count is omitted, advfsstat returns one
      report.

  -s  Displays raw statistics for the interval.

  -R  Displays the percent ratio of the	returned statistics. (Use only with
      the -b,-p, or -r flags.)

  The following	are the	stats-type flags:

  -b  Displays the buffer cache	statistics for the selected domain.

  -f 0
      Displays all fileset vnop	statistics for the selected fileset.

  -f 1
      Displays all fileset lookup statistics for the selected fileset.

  -f 2
      Displays common fileset vnop statistics.

  -l 0
      Displays basic lock statistics.

  -l 1
      Displays lock statistics.

  -l 2
      Displays detailed	lock statistics.

  -n  Displays namei cache statistics.

  -p  Displays buffer cache pin	statistics.

  -r  Displays buffer cache ref	statistics.

  -S  Displays smoothsync queue	statistics.

  -v 0
      Displays volume read/write statistics.

  -v 1
      Displays detailed	volume statistics.

  -v 2
      Displays volume I/O queue	statistics as a	snapshot of everything that
      is currently on the queue.

  -v 3
      Displays volume I/O queue	statistics for everything that was put onto
      the queue	in the -i option time interval.	This is	the same display as
      for -v 2,	with different data.

  -B r
      Displays BMT Record read statistics.

  -B w
      Displays BMT Record write/update statistics.

OPERANDS

  domain
      Specifies	the name of an existing	domain.

  fileset
      Specifies	the name of an existing	fileset.

DESCRIPTION

  The advfsstat	command	displays a wide	selection of AdvFS performance
  statistics. It reports in units of one disk block (512 bytes)	per interval,
  with the default being one second.

  Any number of	options	may be used. The -R option may be specified only with
  the stats-type of -b,	-p, and	-r.  The options -i and	-c require parame-
  ters.

  Only one stats-type may be specified with the	command. The -f, -l, -v, and
  -B stats-type	require	parameters.  For the -f	stats-type, the	fileset
  operand must also be specified.

  The following	tables define the attributes displayed under the given head-
  ing:

  No options specified:

  _____________________________________________________
  Heading	Definition
  _____________________________________________________
  Deref		number of refs
  Unpin		number of unpins
  Lazy		number of unpin	lazys
  Refhit	number of ref hits
  Pinhit	number of pin hits
  Log		number of unpin	logs
  Ubchit	number of Unified Buffer Cache hits
  UnpinMeta	number of unpin	meta hits
  DerefMeta	number of ref meta hits
  Refhitwait	number of ref hit waits
  Pinhitwait	number of pin hit waits
  Blocking	number of unpin	blocking
  Unconsol	number of unconsolidated hits
  UnpinFtx

		number of unpin	flyweight transactions
		hits

  DerefFtx

		number of ref flyweight	transactions
		hits
  R_ahead	number of read-ahead buffers queued
  Pinread	number of pin reads
  Clean		number of unpin	cleans
  ConsolAbort	number of consol aborts
  UnpinData	number of unpin	data hits
  DerefData	number of ref data hits
  Disk		incremental volume count
  Reads		number of reads	on volume
  Writes	number of writes on volume
  Rglobs	number of consolidated reads on	volume
  AveRglob

		average	number of consolidated reads on
		volume
  Wglobs	number of consolidated writes on volume
  AveWgolb

		average	number of consolidated writes
		on volume
  _____________________________________________________

  Buffer cache information (-b flag):

  ________________________________________________
  Heading      Definition
  ________________________________________________
  pin cnt      total number of pins
  pin hit      number of pin hits
  pin hitw     number of pin hit waits
  pin read     number of pin reads
  ref cnt      total number of refs
  ref hit      number of ref hits
  ref hitw     number of ref hit waits
  unpin	lazy   number of unpin lazys
  unpin	blk    number of unpin blocking
  unpin	cln    number of unpin cleans
  unpin	log    number of unpin logs
  ra	       number of read-ahead buffers queued
  ubc	       number of Unified Buffer	Cache hits
  cons un      number of unconsolidated	hits
  cons abrt    number of consol	aborts
  ________________________________________________

  Fileset vnop information (-f 0 flag):

  _____________________________________________
  Heading      Definition
  _____________________________________________
  lookup       number of file lookups
  create       number of file creates
  close	       number of file closes
  getattr      number of get attributes
  setattr      number of set attributes
  read	       number of file reads
  write	       number of file writes
  mmap	       number of mmaps
  fsync	       number of file syncs
  syncdata     number of data syncs
  remove       number of file removes
  rename       number of files renamed
  readdir      number of directory reads
  mkdir	       number of make directories
  rmdir	       number of remove	directories
  symlink      number of symbolic links	created
  readlink     number of links read
  link	       number of links created
  bread	       number of breads
  brelse       number of brelse
  page_write   number of page writes
  page_read    number of page reads
  getpage      number of pages retrieved
  putpage      number of pages returned
  _____________________________________________

  Fileset lookup information (-f 1 flag):

  _________________________________________________
  Heading   Definition
  _________________________________________________
  lookup    total number of file lookups
  hit	    number of file lookup hits
  hit %	    percentage of lookups that were hits
  noent	    number of file lookup noents
  noent	%   percentage of lookups  that	were noents
  miss	    number of file lookup misses
  miss %    percentage of lookups  that	were misses
  _________________________________________________

  Common fileset vnop information (-f 2	flag):

  ______________________________________
  Heading   Definition
  ______________________________________
  lkup	    number of file lookups
  crt	    number of file creates
  geta	    number of get attributes
  read	    number of file reads
  writ	    number of file writes
  fsnc	    number of file syncs
  dsnc	    number of data syncs
  rm	    number of file removes
  mv	    number of file renamed
  rdir	    number of directory	reads
  mkd	    number of make directories
  rmd	    number of remove directories
  link	    number of links created
  ______________________________________

  Basic	lock information (l 0 option):

  ___________________________________
  Heading   Definition
  ___________________________________
  mutex	    number of mutex locks
  wait	    number of wait locks
  sig	    number of signal locks
  bcast	    number of broadcast	locks
  ___________________________________

  Lock information (-l 1 flag):








  ____________________________________
  Field	  Definition
  ____________________________________
  wait	  number of waits on lock
  rwait	  number of re-waits on	lock
  signl	  number of signals on lock
  bcast	  number of broadcasts on lock
  lock	  number of locks
  ____________________________________

  See the NOTES	section	for exceptions to the following	lock information that
  is displayed for the fields above:

  ______________________________________________________
  Heading      Definition
  ______________________________________________________
  mutex	       mutexes
  genLk	       generic locks
  stateLk      state locks
  shrLk	       shared locks
  excLk	       exclusive locks
  bufStateLk   buffer state locks
  pinBlkCv     pin block condition variable
  bfFlushCv    bit file	flush condition	variable
  ftxCv	       flyweight transactions condition	variable
  msgQCv       message queue condition variable
  total	       total number
  ______________________________________________________

  Detailed lock	information (-l	2 flag)	adds the following to the lock
  statistics specified by the -l 1 flag:

  ____________________________________________________________
  Heading	       Definition
  ____________________________________________________________
  LOG_DESC	       log descriptors locks
  LOG_READ_STREAM      log read	stream locks
  BF_STATE	       bitfile state locks
  BF_XTNT_MAP	       bitfile extents locks
  BF_COW	       bitfile copy on write locks
  BF_MCELL_LIST	       bitfile metadata	cell list locks
  BF_FLUSH	       bitfile flush locks
  BUFFER	       buffer locks
  BF_SET_TBL	       set table locks
  BF_SET_TAG_DIR       set tag directory locks
  VD_STG_MAP	       virtual disk storage map	locks
  VD_MCELLS	       virtual disk metadata cell locks
  VD_PAGE0_MCELLS

		       virtual disk page zero metadata cell
		       locks
  VD_MIG_MCELLS

		       virtual disk migrate metadata cell
		       locks
  VD_DEV_BUSY	       virtual disk device busy	locks
  VD_ACTIVE	       virtual disk active locks
  VD_LAZY_BLOCK	       virtual disk lazy blocking locks
  WIRED_FREE	       wired free locks
  RAW_BUF_FREE	       raw buffer free locks
  INIT		       initialization locks
  FS_BF_GET	       fileset bitfile get locks
  unused22	       not used
  unused23	       not used
  unused24	       not used
  FS_CONTEXT_SEM       fileset context SEM locks
  DQ_LOCK	       disk quota locks
  FILE_SET_LK	       fileset locks
  DOMAIN_TBL	       domain table locks
  BF_SET_STATE	       bitfile set state locks
  SERVICE_CLASS_TBL    service class table locks
  BF_SHLV	       bitfile shelving	locks
  FS_FILE	       fileset file locks
  ZAP_MCELLS	       delete metadata cell locks
  MOVE_METADATA	       move metadata locks
  MIG_TRUNC	       migrate truncation locks
  DDL_ACTIVE	       deferred	delete list active locks
  DDL_ACTIVE_WAIT      deferred	delete list active wait	locks
  QUOTA_FILE_LOCK      quota file locks
  FRAG_BF	       fragment	bitfile	locks
  BF_SET_SHLV	       bitfile set shelving locks
  LKU_MSS_PQD	       HSM shelving pseudo queuer device locks
  LKU_MSS_PQD_LOWPRI

		       HSM shelving pseudo queuer device low
		       priority	locks
  ____________________________________________________________

  Namei	information (-n	flag):

  ____________________________________________________
  Heading   Definition
  ____________________________________________________
  goodh	    good hits, hits that can be	used
  negh	    negative hits, hits	that are still useable
  badh	    bad	hits, hits that	must be	dropped
  falsh	    false hits,	hits with id mismatch
  miss	    misses
  ____________________________________________________

  Buffer cache pin information (-p flag):

  _______________________________________________________________
  Heading      Definition
  _______________________________________________________________
  pin cnt      total number of pins
  pin hit      number of pin hits
  pin hitw     number of pin hit waits
  pin read     number of pin reads
  pin lazy     number of unpin lazys
  pin blk      number of unpin blocking
  pin cln      number of unpin cleans
  pin log      number of unpin logs
  data bsFtx

	       number of bitfile access	subsystem flyweight tran-
	       sactions
  data fsFtx

	       number of file access subsystem flyweight transac-
	       tions
  data other   number of other flyweight transactions
  _______________________________________________________________

  Buffer cache ref information (-r flag):

  _______________________________________________________________
  Heading      Definition
  _______________________________________________________________
  ref cnt      total number of refs
  ref hit      number of ref hits
  ref hitw     number of ref hit waits
  data bsFtx

	       number of bitfile access	subsystem flyweight tran-
	       sactions
  data fsFtx

	       number of file access subsystem flyweight transac-
	       tions
  data other   number of other flyweight transactions
  _______________________________________________________________

  Volume read/write information	(-v 0 flag):








  ____________________________________
  Heading   Definition
  ____________________________________
  rd	    number of reads on volume
  wr	    number of writes on	volume
  ____________________________________

  Detailed volume information (-v 1 flag):

  ________________________________________________________________
  Heading   Definition
  ________________________________________________________________
  rd	    number of reads on volume
  wr	    number of writes on	volume
  rg	    number of consolidated reads on volume
  arg

	    average number of blocks per consolidated read on
	    volume
  wg	    number of consolidated writes on volume
  awg

	    average number of blocks per consolidated write on
	    volume
  ________________________________________________________________

  Volume I/O queue information (-v 2 and -v 3 flags):

  ________________________________________________________________
  Heading   Definition
  ________________________________________________________________
  rd	    number of reads on volume
  wr	    number of writes on	volume
  rg	    number of consolidated reads on volume
  arg

	    average number of blocks per consolidated read on
	    volume
  wg	    number of consolidated writes on volume
  awg

	    average number of blocks per consolidated write on
	    volume
  blk	    blocking queue requests on volume
  flsh	    flush queue	requests on volume
  wlz	    wait lazy queue requests on	volume
  sms	    smooth sync	queue requests
  rlz	    ready lazy queue requests on volume
  con	    consol queue requests on volume
  dev	    device queue requests on volume
  ________________________________________________________________

NOTES

  The following	lock information is hardcoded to zero:

  ______________________________________
  Heading      Limitation
  ______________________________________
  shrLk	       bcast is	hard coded to 0.
  bufStateLk   lock is hard coded to 0.
  pinBlkCv     lock is hard coded to 0.
  bfFlushCv    lock is hard coded to 0.
  ftxCv	       lock is hard coded to 0.
  msgQCv       lock is hard coded to 0.
  total	       rwait is	hard coded to 0.
  ______________________________________

  The following	lock information is incomplete:





  _____________________________________
  Heading   Limitation
  _____________________________________
  mutex	    only lock field returned.
  total	    lock field is not returned.
  _____________________________________

EXAMPLES

   1.  The following example specifies no options:
	    # advfsstat	test1_domain

	    Domain -803166491.546298- Stats -

	    Deref  9	Refhit	   9   Refhitwait  0	R_ahead	     0
	    Unpin  0	Pinhit	   0   Pinhitwait  0	Pinreads     0
	    Lazy   0	Log	   0   Blocking	   0	Clean	     0
			Ubchit	   0   Unconsol	   0	ConsolAbort  0
			UnpinMeta  0   UnpinFtx	   0	UnpinData    0
			DerefMeta  9   DerefFtx	   9	DerefData    0

	    Disk  Reads	 Writes	 Rglobs	  AveRglob   Wglobs   AveWglob
	    ----  -----	 ------	 ------	  --------   ------   --------
	       1      0	      0	      0		 0	  0	     0

   2.  The following example displays buffer cache statistics for the
       requested domain	on the system providing	three reports in one second
       intervals:
	    # advfsstat	-c 3 -b	data_domain

	    pin		     ref	   unpin-type	   misc	  cons
	    cnt	hit hitw read cnt hit hitw lazy	 blk cln log ra	ubc un abrt
	      0	  0    0    0  10  10	 0    0	   0   0   0  0	  0  0	  0
	      0	  0    0    0	9   9	 0    0	   0   0   0  0	  0  0	  0
	      0	  0    0    0  11  11	 0    0	   0   0   0  0	  0  0	  0

   3.  The following example displays the raw data for the same	example	as
       above:
	    # advfsstat	-s -c 3	-b data_domain

	    pin		     ref	   unpin-type	    misc      cons
	    cnt	hit hitw read cnt  hit hitw lazy blk cln log  ra  ubc	un abrt
	     2M	 2M  665    0  1M 946K	586   2M 51K  60 87K 37K 128K 2103    0
	     2M	 2M  667    0  1M 946K	589   2M 51K  60 87K 37K 128K 2104    0
	     2M	 2M  671    0  1M 946K	595   2M 51K  60 87K 37K 128K 2105    0

   4.  The following example shows the vnop statistics for the fileset named
       data which is part of the domain	data_domain. The report	is for a one
       minute interval:
	    # advfsstat	-i 60 -f 0 data_domain data

	    lookup  1419    create  1	close 175 getattr 1009	setattr	1
	      read   461     write 15	 mmap	2   fsync    0 syncdata	0
	    remove     2    rename  0 readdir 319   mkdir    0	  rmdir	0
	    ymlink     0  readlink  0	 link	0   bread    0	 brelse	0
	    page_write 0 page_read  0 getpage  35 putpage    0

   5.  The following example displays basic lock statistics for	the domain
       usr_domain:
	    # advfsstat	-l 1 usr_domain

			    type  wait rwait signl bcast  lock
			   mutex			     0
			   genLk     0	   0	 0     0  3316
			 stateLk     0	   0	 0     0   33K
			   shrLk     0	   0	 0     0   202
			   excLk     0	   0	 0     0    73
		      bufStateLk  7319	   0  7271    24     0
			pinBlkCv     0	   0	 0     0     0
		       bfFlushCv    88	   4   279     0     0
			   ftxCv     0	   0	 0     0     0
			  msgQCv   123	   0   127     0     0
			   total  7530	   0  7677    24

   6.  The following example shows a partial display of	I/O queue statistics
       at 1-second intervals during a test that	writes some data and then
       does an fsync:
	    # advfsstat	-i 1 -v	3 data_domain
	    vol	1
	     rd	  wr   rg  arg	wg  awg	 blk ubcr flsh	wiz  sms  rlz  con  dev
	      0	   0	0    0	 0    0	   0	0    0	  0    0    0	 0    0
	      0	   2	0    0	 2  120	  15	0    0	23K  23K    0	 0    0
	      0	  63	0    0	59  233	  15	0    0	 9K   9K  16K  16K  849
	      0	  55	0    0	53  252	   2	0    0	 1K   1K   1K	1K  836
	      0	  52	0    0	51  241	   3	0    0	 1K   1K   1K	1K  768
	      0	  53	0    0	52  242	   3	0    0	 1K   1K   1K	1K  787
	      0	  73	0    0	72  238	   3	0   7K	 1K   1K   1K	1K   1K
	      0	  41	0    0	40  235	   0	0   7K	128  128    4	 0  590
	      0	  51	0    0	51  235	   0	0    0	  0    0    0	 0  750
	      0	  60	0    0	56  232	   0	0    0	  0    0    0	 4  816



SEE ALSO

  Commands:  iostat(1)