PRIMECLUSTER Global File Services Configuration and Administration Guide 4.2 (Solaris(TM) Operating Environment)
Contents Index PreviousNext

Appendix F Reference Manual> F.2 Management Commands Specific to the GFS Shared File System

F.2.28 sfcstat(1M) Reports statistics on the GFS Shared File System

[SYNOPSIS]

sfcstat [ -abcdefghijklmnopqrstA ] [ interval [ count ] ] [ mount_point ... ]

[DESCRIPTION]

The sfcstat command displays statistics about GFS Shared File Systems.

sfcstat first reports statistical information recorded after the file system is mounted. The next time, it reports the information recorded since the last report.

When the parameter interval is specified, sfcstat reports statistical information for the interval that was specified in this parameter (in seconds). When no interval specified, it reports on statistical information only once.

When the parameter count is specified, sfcstat reports statistical information for the interval it takes to count to count. When no count specified, it keeps displaying statistical information.

When the parameter mount_point is specified, sfcstat reports statistical information on the specified file system. When no mount_point specified, sfcstat reports statistical information on all mounted GFS Shared File System.

[OPTIONS]

The following options can be specified:

If the options are omitted, the command reports all information.

-A

Reports all information.

-a

Reports AC information about read/write operations. Reports the number of RPC messages for the following purposes:
- To change file atime or mtime
- To change file attributes
- To access file attributes
- To access file size
- To acquire tokens when changing file size
- To change file size
- To purge tokens when changing file size
- To access information about extent allocations
- To change information about extent allocations

-b

Reports AC information about meta-data management buffers. Reports the number of buffer allocations, the number of dynamic buffer allocations, and the number of sleep occurred during buffer requests.

-c

Reports MDS information about meta-data management buffers. Reports the number of buffer allocations, the number of dynamic buffer allocations, and the number of sleep occurred during buffer requests.

-d

Reports AC information about direct I/O. Reports the following information:
- Number of direct I/O read operations
- Number of direct I/O write operations
- Number of blocks read
- Number of blocks written
- Number of read requests changed to normal I/O
- Number of write requests changed to normal I/O
- Number of page flush after reading
- Number of page flush after writing

-e

Reports MDS information about purging tokens. Reports the following information:
- Number of purging tokens
- Number of AC that purged tokens
- Number of purging tokens (by token type)
- Number of AC that purged tokens (by token type)

-f

Reports AC information about VFS operations. Reports the number of RPC messages for the following purposes:
- To access file handle
- To access file attributes
- To purge tokens

-g

Reports the number of times MDS was received requests for tokens (by token type).

-h

Reports MDS information about the meta-daemon. Reports the number of times the meta-daemon was activated, the number of buffers in the meta-daemon I/O queues, the number of times the meta-daemon was activated because the disk was full, and the number of times the meta-daemon was activated because the meta-cache was full.

-i

Reports AC information about actual I/O. Reports the number of actual I/O reading, the number of actual I/O writing, the number of I/O blocks actually read, and the number of I/O blocks actually written.

-j

Reports MDS information about the log daemon. Reports the following information:
- Number of times log daemon was activated
- Number of sync requests
- Number of fsync requests
- Number of times log buffer full
- Number of requests issued from meta-write daemon
- Number of times sleep occurs because transaction limit exceeded
- Number of times sleep occurs because log disk full
- Number of times sleep occurs because of a preceding large transaction
- Number of times sleep occurs because a preceding transaction enlarged
- Number of requests for I/O operation issued from log daemon
- Time required for writing
- Number of blocks written
- Number of valid blocks
- Number of requests to log transactions
- Number of parallel operation transactions to be logged
- Average number of parallel operation transactions
- Number of times huge buffer was used
- Number of sub-transactions generated

-k

Reports MDS information about operations for free extents. Reports the number of search requests, the number of times blocks acquired, the number of acquired blocks, the number of blocks acquisition failed, the number of times blocks released, the number of released blocks, the number of times released blocks successfully linked, the number of division of free extent management, and the number of joining free extent management.

-l

Reports AC information about file and record locks. Reports the number of RPC messages for the following purposes:
- To open file
- To close file
- To map file to address space
- To read file
- To write file
- To set lock, clear lock, or get lock information
- To set mandatory lock, or clear mandatory lock

-m

Reports MDS information about meta cache (by meta type). Reports the number of accesses, the number of cache hits, the number of updates, the number of read operations, the number of write operations, writing time, and average time.

-n

Reports AC information about RNODE operations. Reports the number of RPC messages for the following purposes:
- To be requested to purge tokens
- To be requested to purge tokens of freed RNODE
- To purge tokens to free RNODE

-o

Reports AC information about VNODE operations. Reports the following information:
- Number of RPC messages to open file
- Number of RPC messages to close file
- Number of access to file attributes
- Number of RPC messages to access file attributes
- Number of re-sent RPC messages to access file attributes
- Number of RPC messages to access the number of blocks of regular file
- Number of access to symbolic link
- Number of RPC messages to access symbolic link
- Number of RPC messages to move modified attributes to storage devices
- Number of access to directory
- Number of RPC messages to access directory
- Number of re-sent RPC messages to access directory

-p

Reports MDS information about file operation. Reports the following information:
- Number of requests to operate files (by operation type)
- Size of RPC messages to operate files (by operation type)
- Number of successful replies (by operation type)
- Size of successful replies (by operation type)
- Number of failed replies (by operation type)
- Time required for operating files (by operation type)

-q

Reports MDS information about operations for allocated extents. Reports the number of search requests, the number of times blocks acquired, the number of acquired blocks, the number of blocks acquisition failed, the number of times blocks released, the number of released blocks, the number of times released blocks successfully linked, the number of division of free extent management, and the number of joining free extent management.

-r

Reports AC information about file operation. Reports the following information:
- Number of sending requests to operate files
- Number of receiving replies
- Number of timeouts while receiving replies
- Number of requests waiting to be sent (by operation type)
- Time for requests to wait to be sent (by operation type)
- Number of sending requests (by operation type)
- Time to wait to receive replies (by operation type)
- Number of successful replies (by operation type)
- Number of replies failed because no file existed (by operation type)
- Number of replies failed because file attributes changed (by operation type)
- Number of replies failed because file existed (by operation type)
- Number of replies failed because of other error (by operation type)
- Number of failure to receive replies (by operation type)

-s

Reports MDS information about operations for reserving extents. Reports the number of requests to reserve extents, the number of reserved extents, the number of reserved blocks, the number of requests to reserve extents contiguously, and the number of extents failed to reserve.

-t

Reports the number of times MDS is request to purging tokens. Reports the following information:
- Number of changing information about extent allocations
- Number of extents whose allocation information were changed
- Number of blocks whose allocation information were changed
- Number of changing information about extent allocations partially
- Number of extents whose allocation information were changed partially
- Number of blocks whose allocation information were changed partially
- Number of purging tokens (by token type)

[OPERAND]

The following operand can be specified:

mount_point

Specifies the path name of the mount point where the file system has been mounted.

interval

Specifies the interval at which sfcstat is executed in units of seconds.

count

Specifies the number of times that sfcatat is executed.

[EXAMPLE]

# sfcstat 5 /mnt
bufalloc dbufalloc dbufsleep
        0         0         0
Filesystem:/mnt                  Thu Mar 13 15:58:09 JST 2003
  eviction   nornode   vacated
         0         0         0
      vget   getattr   vacated
         0         0         0
    open   close   gattr  gattrc  gattrn  gattrv
       0       0       0       0       0       0
   rlink  rlinkc   fsync    rdir   rdirc   rdirn
       0       0       0       0       0       0
    open   close     map    read   write  frlock vacated
       0       0       0       0       0       0       0
   utime   uattr   cattr   csize  truncg  truncs  truncv    extg    extv
       0       0       0       0       0       0       0       0       0
   dirr    dirw dirrblk dirwblk  dirr-n  dirw-n dirrflsh dirwflsh
      0       0       0       0       0       0        0        0
      send      recv   timeout
        11        15         9
                  slist    swait    addsl
                  rwait      rok   rnoent   rbverf   rethis   rerror   rnores
NULL                  0        0        0
                      0        0        0        0        0        0        0
GETATTR               0        0        0
                      0        0        0        0        0        0        0
SETATTR               0        0        0
                      0        0        0        0        0        0        0
LOOKUP                0        0        0
                      0        0        0        0        0        0        0
READLINK              0        0        0
                      0        0        0        0        0        0        0
CREATE                0        0        0
                      0        0        0        0        0        0        0
REMOVE                0        0        0
                      0        0        0        0        0        0        0
RENAME                0        0        0
                      0        0        0        0        0        0        0
LINK                  0        0        0
                      0        0        0        0        0        0        0
SYMLINK               0        0        0
                      0        0        0        0        0        0        0
MKDIR                 0        0        0
                      0        0        0        0        0        0        0
RMDIR                 0        0        0
                      0        0        0        0        0        0        0
READDIR               0        0        0
                      0        0        0        0        0        0        0
STATFS                0        0        0
                      0        0        0        0        0        0        0
GETLEASE              0        0        0
                      0        0        0        0        0        0        0
VACATED               0        0        0
                      0        0        0        0        0        0        0
EVICTION              0        0        0
                      0        0        0        0        0        0        0
FILELOCK              0        0        0
                      0        0        0        0        0        0        0
HEARTBEAT             0        0        0
                      0        0        0        0        0        0        0
KSTAT                 0        0       11
                     20       11        0        0        0        0        0
MOUNT                 0        0        0
                      0        0        0        0        0        0        0
ADDVOL                0        0        0
                      0        0        0        0        0        0        0
RESERVE               0        0        0
                      0        0        0        0        0        0        0
UNMOUNT               0        0        0
                      0        0        0        0        0        0        0
FUNMOUNT              0        0        0
                      0        0        0        0        0        0        0
MNTINFO               0        0        0
                      0        0        0        0        0        0        0
ADDVOLINFO            0        0        0
                      0        0        0        0        0        0        0
BARSYNC               0        0        0
                      0        0        0        0        0        0        0
RECOVER               0        0        0
                      0        0        0        0        0        0        0
RNOTIFY               0        0        0
                      0        0        0        0        0        0        0
FSCTL                 0        0        0
                      0        0        0        0        0        0        0
FSHINT                0        0        0
                      0        0        0        0        0        0        0
QUOTACTL              0        0        0
                      0        0        0        0        0        0        0
QUOTASET              0        0        0
                      0        0        0        0        0        0        0
QUOTAGET              0        0        0
                      0        0        0        0        0        0        0
QUERYBLK              0        0        0
                      0        0        0        0        0        0        0
UPDATEBLK             0        0        0
                      0        0        0        0        0        0        0
EVICTIONBLK           0        0        0
                      0        0        0        0        0        0        0
FREEZE                0        0        0
                      0        0        0        0        0        0        0
SNAPSHOT              0        0        0
                      0        0        0        0        0        0        0
EVICTEDALL            0        0        0
                      0        0        0        0        0        0        0
COPYBLK               0        0        0
                      0        0        0        0        0        0        0
SYNC                  0        0        0
                      0        0        0        0        0        0        0
VGET                  0        0        0
                      0        0        0        0        0        0        0
ITRACECTL             0        0        0
                      0        0        0        0        0        0        0
                  readcnts  readblks writecnts writeblks
data volume[00]:         0         0         0         0
metavolume[0]
metatype access cachehit      mod    R-I/O    W-I/O     W-MS   I/Oave
DBMAP         0        0        0        0        0        0        0
IBMAP         0        0        0        0        0        0        0
NBMAP         0        0        0        0        0        0        0
LBMAP         0        0        0        0        0        0        0
SBMAP         0        0        0        0        0        0        0
IEX           0        0        0        0        0        0        0
DIR           0        0        0        0        0        0        0
SYM           0        0        0        0        0        0        0
NODE          0        0        0        0        0        0        0
LEAF          0        0        0        0        0        0        0
SLIST         0        0        0        0        0        0        0
DINODE        1        1        1        0        1       10       10
SBLOCK        0        0        0        0        0        0        0
VOLINF        0        0        0        0        0        0        0
RTERM         0        0        0        0        0        0        0
ACL           0        0        0        0        0        0        0
QUOTA         0        0        0        0        0        0        0
RLEAF         0        0        0        0        0        0        0
 bufalloc dbufalloc dbufsleep
        1         0         0
fsearch  falloc fnalloc fealloc   ffree  fnfree  ffcomb ftsplit  ftcomb
      0       0       0       0       0       0       0       0       0
asearch  aalloc analloc aealloc   afree  anfree  afcomb atsplit  atcomb
      0       0       0       0       0       0       0       0       0
mwakeup   mnbuf mlogful
      5       1       0
METAFULL  DBMAP   IBMAP   NBMAP   LBMAP   SBMAP     IEX
              0       0       0       0       0       0
            DIR     SYM    NODE    LEAF   SLIST  DINODE
              0       0       0       0       0       0
         SBLOCK  VOLINF   RTERM     ACL   QUOTA   RLEAF
              0       0       0       0       0       0
lwakeup   lsync  lfsync  lbfull   lmeta  ltfull  ldfull  logbig logbigx
     10       0       1       0       0       0       0       0       0
lnwrite     lms  lnblks loccupy lntrans   lpara    lave lbigbuf lsubtrn
      1       0       2       2       1       0       0       0       0
                   recv    recvb  okreply okreplyb  ngreply     r_ms
NULL                  0        0        0        0        0        0
GETATTR               1       96        1      172        0        0
SETATTR               0        0        0        0        0        0
LOOKUP                1      100        1      188        0        0
READLINK              0        0        0        0        0        0
CREATE                0        0        0        0        0        0
REMOVE                0        0        0        0        0        0
RENAME                0        0        0        0        0        0
LINK                  0        0        0        0        0        0
SYMLINK               0        0        0        0        0        0
MKDIR                 0        0        0        0        0        0
RMDIR                 0        0        0        0        0        0
READDIR               0        0        0        0        0        0
STATFS                0        0        0        0        0        0
GETLEASE              1      100        1      108        0        0
VACATED               2      240        2       72        0        0
EVICTION              0        0        0        0        0        0
FILELOCK              0        0        0        0        0        0
HEARTBEAT             0        0        0        0        0        0
KSTAT                11     1044       11     8616        0       10
MOUNT                 0        0        0        0        0        0
ADDVOL                0        0        0        0        0        0
RESERVE               0        0        0        0        0        0
UNMOUNT               0        0        0        0        0        0
FUNMOUNT              0        0        0        0        0        0
MNTINFO               0        0        0        0        0        0
ADDVOLINFO            0        0        0        0        0        0
BARSYNC               0        0        0        0        0        0
RECOVER               0        0        0        0        0        0
RNOTIFY               0        0        0        0        0        0
FSCTL                 0        0        0        0        0        0
FSHINT                0        0        0        0        0        0
QUOTACTL              0        0        0        0        0        0
QUOTASET              0        0        0        0        0        0
QUOTAGET              0        0        0        0        0        0
QUERYBLK              0        0        0        0        0        0
UPDATEBLK             0        0        0        0        0        0
EVICTIONBLK           0        0        0        0        0        0
FREEZE                0        0        0        0        0        0
SNAPSHOT              0        0        0        0        0        0
EVICTEDALL            0        0        0        0        0        0
COPYBLK               0        0        0        0        0        0
SYNC                  0        0        0        0        0        0
VGET                  0        0        0        0        0        0
ITRACECTL             0        0        0        0        0        0
     evict    nevict
         0         0
token    tevict  tnevict
DREAD         0        0
DWRITE        0        0
SREAD         0        0
SWRITE        0        0
TREAD         0        0
TWRITE        0        0
NREAD         0        0
AREAD         0        0
DELETE        0        0
token  getlease
DREAD         1
DWRITE        0
SREAD         1
SWRITE        0
ROPEN         1
WOPEN         0
RMMAP         0
WMMAP         0
TWRITE        1
     ext    next     blk   npext   nrext   nrblk
       0       0       0       0       0       0
token     request
SIZE            0
ATIME           0
MTIME           0
CREAD           1
CWRITE          0
CMREAD          0
CMWRITE         0
CMLOCK          0
CCALL           1
CFONLY          0
ABSATIME        1
ASBMTIME        0
SYNC            0
NEEDNTF         0
    rqst    next    nblk  ncrqst   empty
       0       0       0       0       0

[SEE ALSO]

sar(1) in the "Solaris X Reference Manual Collection."


Contents Index PreviousNext

All Rights Reserved, Copyright(C) FUJITSU LIMITED 2004