fsstat(1M)						  System Administration Commands						fsstat(1M)

NAME

       fsstat - report file system statistics

SYNOPSIS

       fsstat [-a|f|i|n|v] [-T | u|d] {-F | {fstype|path}...}
	    [interval [count]]

DESCRIPTION

       fsstat  reports	kernel	file operation activity by the file system type (fstype) or by the path name, which is converted to a mount point.
       The first set of lines of output reports all activity since:

	   o	  The file system module was loaded (in the case of fstype)

	   o	  The file system was mounted (in the case of mount point)

       Statistics are gathered at the file system independent layer at both the fstype and the mount point levels. However, not  all  file  system
       types are represented in the gathering of statistics. (See the NOTES section of this man page.)

       The  output of fsstat is dependent on the mode (option) requested. All statistic fields are displayed using "smart numbers" which automati-
       cally scale the units in a human readable form that fits in a maximum of 5 characters. For example:

       100	  is displayed as 100

       2048	  is displayed as 2K

       3000000	  is displayed as 2.86M

       The unit modifiers are: K (Kbyte), M (Mbyte), G (Gbyte), T (terabyte), P (petabyte), and E (exabyte).

       During the execution of fsstat, the state of the system can change. If relevant, a state change message is included in the fsstat output in
       one of the following forms:

	 <<mount point no longer available: {path}>>
	 <<file system module no longer loaded: {fstype}>>

       After  the  state  change  messages  are displayed, fsstat continues to display the statistics as directed. If all of the fstypes and mount
       points that fsstat was reporting on are no longer available, then fsstat exits.

       The user is required to specify the -F option (all available file system types) or a list of one or more fstypes and/or mount points.

       The default report shows general file system activity. This display combines similar operations into general categories as follows:

       new file       Number of creation operations for file system objects (for example, files, directories, symlinks, etc.)

       name remov     Number of name removal operations

       name chng      Number of name change operations

       attr get       Number of object attribute retrieval operations

       attr set       Number of object attribute change operations

       lookup ops     Number of object lookup operations

       rddir ops      Number of read directory operations

       read ops       Number of data read operations

       read bytes     Bytes transferred by data read operations

       write ops      Number of data write operations

       write bytes    Bytes transferred by data write operations

       The entity being reported on (fstype or mount point) is displayed in the last column.

OPTIONS

       The following options are supported:

       -a	 Report the activity for kernel attribute operations. The following statistics are reported:

		 getattr    Number of file attribute retrieval calls

		 setattr    Number of file attribute modification calls

		 getsec     Number of file security attribute retrieval calls

		 setsec     Number of file security attribute modification calls

		 The entity being reported on (fstype or mount point) is displayed in the last column.

       -f	 Report the full activity for all kernel file operations. Each file operation is listed in the left column. The following  statis-
		 tics are reported for each operation:

		 #ops	  Number of calls for this operation

		 bytes	  Average transfer size in bytes (only applies to read, write, readdir)

		 The entity being reported on (fstype or mount point) is displayed in the first row.

       -i	 Reports the activity for kernel I/O operations. The following statistics are reported:

		 read ops	Number of data read calls

		 read bytes	Number of bytes read

		 write ops	Number of data write calls

		 write bytes	Number of bytes written

		 rddir ops	Number of read directory calls

		 rddir bytes	Number of bytes read by reading directories

		 rwlock ops	Number of internal file system lock operations

		 rwulock ops	Number of internal file system unlock operations

		 The entity being reported on (fstype or mount point) is displayed in the last column.

       -n	 Reports the activity for kernel naming operations. The following statistics are reported:

		 lookup     Number of file name retrieval calls

		 creat	    Number of file creation calls

		 remov	    Number of file remove calls

		 link	    Number of link calls

		 renam	    Number of file renaming calls

		 mkdir	    Number of directory creation calls

		 rmdir	    Number of directory removal calls

		 rddir	    Number of directory read calls

		 symlink    Number of symlink creation calls

		 rdlink     Number of symlink read calls

		 The entity being reported on (fstype or mount point) is displayed in the last column.

       -v	 Reports the activity for calls to the virtual memory operations. The following statistics are reported.

		 map	   Number of calls mapping a file

		 addmap    Number of calls setting additional mapping to a mapped file

		 delmap    Number of calls deleting mapping to a file

		 getpag    Number of calls retrieving a page of data from a file

		 putpag    Number of calls writing a page of data to a file

		 pagio	   Number of calls to transfer pages in file system swap files

		 The entity being reported on (fstype or mount point) is displayed in the last column.

       -F	 Report on all available file system types.

       -T u|d	 Display a time stamp.

		 Specify  u for a printed representation of the internal representation of time (see time(2)) Specify d for the standard date for-
		 mat. (See date(1)). The time stamp is only used when an interval is set.

OPERANDS

       The following operands are supported:

       count	   Display only count reports.

       fstype	   Explicitly specify the file system type(s) to be reported. The file system module must be loaded.

       interval    Report once each interval seconds.

       path	   Specify the path(s) of the mount point(s) to be reported. If path is not a mount point, the mount point containing path will be
		   determined and displayed in the output.

       If  no interval and no count are specified, a single report is printed and fsstat exits. If an interval is specified but no count is speci-
       fied, fsstat prints reports every interval seconds indefinitely until the command is interrupted.

EXAMPLES

       Example 1 Displaying General Activity

       The following example shows general activity for all file system types.

	 $ fsstat -F
	  new  name   name  attr   attr lookup rddir  read read  write write
	  file remov  chng   get    set    ops	 ops   ops bytes   ops bytes
	   313K  214K 38.5K 2.16M 56.2K  8.36M 52.8K 19.7M 39.9G 18.8M 39.1G ufs
	      0     0	  0 2.95K     0  3.81K	 282 2.52K  466K     0	   0 proc
	      0     0	  0	0     0      0	   0	 0     0     0	   0 nfs
	     10     8	  2    86     9     98	  15   413  103M 8.43K 1.05G zfs
	     13    14	  4    98    16    125	  10 1.01K  258M 15.9K	127M lofs
	 8.73K 3.29K 5.25K 55.3K    37	1.20M	 44 37.9K 38.3M 47.2K 35.9M tmpfs
	      0     0	  0 4.93K     0      0	   0 1.08K  913K     0	   0 mntfs
	      3     2	  1   503     3    897	  13   122 25.8K   128	272K nfs3
	     10     8	  0   615    10  10.1K	  18	61 45.6K   292 2.26M nfs4

       Example 2 Displaying Naming Activity

       The following example shows the naming activity for ufs, nfs, nfs3, nfs4, and tmpfs:

	 $ fsstat -n ufs nfs nfs3 nfs4 tmpfs
	 lookup creat remov  link renam mkdir rmdir rddir symlnk rdlnk
	 3.57M	3.10K	586	6    24   115	100 30.2K      5  330K ufs
	     0	    0	  0	0     0     0	  0	0      0     0 nfs
	 18.3K	    3	  5	0     0     0	  0 1.03K      2   346 nfs3
	   535	    0	  0	0     0     0	  0    46      0     4 nfs4
	   146	   24	 15	0     0     4	  0	4      0     0 tmpfs

       Example 3 Displaying Attribute Activity

       The following example shows the attribute activity for the FS type ufs and the mounted file systems "/" and "/export/home" every three sec-
       onds for every third iteration:

	 # fsstat -a ufs / /export/home 3 3
	 getattr setattr getsec setsec
	   378K    91.9K  11.8K      0 ufs
	   367K    82.3K  11.6K      0 /
	  11.3K     9.6K    198      0 /export/home
	  4.97K    2.27K    163      0 ufs
	  3.94K    1.36K    162      0 /
	  1.03K      927      1      0 /export/home
	  2.30K    1.06K     73      0 ufs
	  1.95K      766     71      0 /
	    361      317      2      0 /export/home
	  2.33K    1.06K     78      0 ufs
	  1.64K      451     77      0 /
	    711      631      1      0 /export/home

       Example 4 Displaying File Operation Statistics

       The following example shows the statistics for each file operation for "/" (using the -f option):

	 $ fsstat -f /
	 Mountpoint: /
	  operation  #ops  bytes
	       open 8.54K
	      close  9.8K
	       read 43.6K  65.9M
	      write 1.57K  2.99M
	      ioctl 2.06K
	      setfl	4
	    getattr 40.3K
	    setattr    38
	     access 9.19K
	     lookup  203K
	     create   595
	     remove    56
	       link	0
	     rename	9
	      mkdir    19
	      rmdir	0
	    readdir 2.02K  2.27M
	    symlink	4
	   readlink 8.31K
	      fsync   199
	   inactive 2.96K
		fid	0
	     rwlock 47.2K
	   rwunlock 47.2K
	       seek 29.1K
		cmp 42.9K
	     frlock 4.45K
	      space	8
	     realvp 3.25K
	    getpage  104K
	    putpage 2.69K
		map 13.2K
	     addmap 34.4K
	     delmap 33.4K
	       poll   287
	       dump	0
	   pathconf    54
	     pageio	0
	    dumpctl	0
	    dispose 23.8K
	 getsecattr   697
	 setsecattr	0
	    shrlock	0
	    vnevent	0

ENVIRONMENT VARIABLES

       See  environ(5)	for  descriptions  of  the  following  environment  variables that affect the execution of fsstat: LANG, LC_ALL, LC_CTYPE,
       LC_MESSAGES,  LC_TIME, and NLSPATH.

EXIT STATUS

       The following exit values are returned:

       0    Successful completion.

       1    A fatal error occurred. A fatal error could be a failed system call or another internal error.

       2    Invalid command-line options were specified.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |See below.		   |
       +-----------------------------+-----------------------------+

       The command-line options are Unstable. The human-readable output is not considered an interface.

SEE ALSO

       date(1), time(2), attributes(5)

NOTES

       All display options (-a, -f, -i, -n, -v) are mutually exclusive. Entering more than one of these options will result in an error.

       The fstype and path operands must appear after the option, but before the interval or count on the command line. For  example,  "fsstat	-a
       fstype interval". Preference is given to fstype so that if a user wishes to see the statistics for a directory that has the same name as an
       fstype (for example, ufs), then the path must be specified unambiguously (for example, ./ufs). Similarly, in order to define a file with  a
       numeric name (for example, "10") from an interval or count operand, the name should be prefixed accordingly (for example, ./10).

       When an interval is used, headers repeat after more than 12 lines of statistics have been displayed and the set of lines to be displayed in
       the current interval have completed.

       Statistics are not displayed for all pseudo-filesystems. The output displayed with the -F option shows which of the loaded filesystem types
       are supported.

       Unbundled file systems may not be recognized by fsstat.

       The  command-line options are classified as Unstable and could change. The output is not considered to be an interface. The construction of
       higher level software tools depend on either the command-line options or the output of fsstat is not recommended.

SunOS 5.11							    5 Jan 2007								fsstat(1M)