cifsiostat(1)

1CIFSIOSTAT(1)                 Linux User's Manual                CIFSIOSTAT(1)
2
3
4

NAME

6       cifsiostat - Report CIFS statistics.
7

SYNOPSIS

9       cifsiostat  [  -h  ] [ -k | -m ] [ -t ] [ -V ] [ --human ] [ interval [
10       count ] ]
11

DESCRIPTION

13       The cifsiostat command displays statistics about read and write  opera‐
14       tions on CIFS filesystems.
15
16       The  interval parameter specifies the amount of time in seconds between
17       each report. The first report contains statistics for  the  time  since
18       system  startup (boot). Each subsequent report contains statistics col‐
19       lected during the interval since the previous report.   A  report  con‐
20       sists  of  a  CIFS header row followed by a line of statistics for each
21       CIFS filesystem that is mounted.  The count parameter can be  specified
22       in  conjunction  with the interval parameter. If the count parameter is
23       specified, the value of count determines the number of  reports  gener‐
24       ated  at interval seconds apart. If the interval parameter is specified
25       without the count parameter, the cifsiostat command  generates  reports
26       continuously.
27
28

REPORT

30       The  CIFS  report provides statistics for each mounted CIFS filesystem.
31       The report shows the following fields:
32
33       Filesystem:
34              This columns shows the mount point of the CIFS filesystem.
35
36       rB/s (rkB/s, rMB/s)
37              Indicate the average number of bytes (kilobytes, megabytes) read
38              per second.
39
40       wB/s (wkB/s, wMB/s)
41              Indicate  the  average  number  of  bytes (kilobytes, megabytes)
42              written per second.
43
44       rop/s
45              Indicate the number of 'read' operations that were issued to the
46              filesystem per second.
47
48       wop/s
49              Indicate  the  number  of 'write' operations that were issued to
50              the filesystem per second.
51
52       fo/s
53              Indicate the number of open files per second.
54
55       fc/s
56              Indicate the number of closed files per second.
57
58       fd/s
59              Indicate the number of deleted files per second.
60

OPTIONS

62       -h     Make the CIFS report easier to read  by  a  human.   --human  is
63              enabled implicitly with this option.
64
65       --human
66              Print  sizes  in  human  readable format (e.g. 1.0k, 1.2M, etc.)
67              The units displayed with this option supersede any other default
68              units (e.g.  kilobytes, sectors...) associated with the metrics.
69
70       -k     Display statistics in kilobytes per second.
71
72       -m     Display statistics in megabytes per second.
73
74       -t     Print  the  time for each report displayed. The timestamp format
75              may depend on the value of the S_TIME_FORMAT  environment  vari‐
76              able (see below).
77
78       -V     Print version number then exit.
79
80

ENVIRONMENT

82       The  cifsiostat  command  takes  into account the following environment
83       variables:
84
85
86       S_COLORS
87              When this variable is set, display statistics in  color  on  the
88              terminal.   Possible  values for this variable are never, always
89              or auto (the latter is the default).
90
91              Please note that the color (being red,  yellow,  or  some  other
92              color)  used to display a value is not indicative of any kind of
93              issue simply because of the color. It only  indicates  different
94              ranges of values.
95
96
97       S_COLORS_SGR
98              Specify  the colors and other attributes used to display statis‐
99              tics on the terminal.  Its value is a  colon-separated  list  of
100              capabilities that defaults to I=32;22:N=34;1:Z=34;22.  Supported
101              capabilities are:
102
103
104              I=     SGR substring for filesystem names.
105
106
107              N=     SGR substring for non-zero statistics values.
108
109
110              Z=     SGR substring for zero values.
111
112
113       S_TIME_FORMAT
114              If this variable exists and its value is ISO  then  the  current
115              locale  will  be  ignored  when  printing the date in the report
116              header. The cifsiostat command will  use  the  ISO  8601  format
117              (YYYY-MM-DD)  instead.   The  timestamp displayed with option -t
118              will also be compliant with ISO 8601 format.
119
120

BUG

122       /proc filesystem must be mounted for cifsiostat to work.
123
124

FILE

126       /proc/fs/cifs/Stats contains CIFS statistics.
127

AUTHORS

129       Written by Ivana Varekova (varekova <at> redhat.com)
130
131       Maintained by Sebastien Godard (sysstat <at> orange.fr)
132