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 ] [ --dec={ 0 | 1 | 2 } ] [
10       --human ] [ interval [ 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       --dec={ 0 | 1 | 2 }
63              Specify the number of decimal places to use  (0  to  2,  default
64              value is 2).
65
66       -h     Make  the  CIFS  report  easier  to read by a human.  --human is
67              enabled implicitly with this option.
68
69       --human
70              Print sizes in human readable format  (e.g.  1.0k,  1.2M,  etc.)
71              The units displayed with this option supersede any other default
72              units (e.g.  kilobytes, sectors...) associated with the metrics.
73
74       -k     Display statistics in kilobytes per second.
75
76       -m     Display statistics in megabytes per second.
77
78       -t     Print the time for each report displayed. The  timestamp  format
79              may  depend  on the value of the S_TIME_FORMAT environment vari‐
80              able (see below).
81
82       -V     Print version number then exit.
83
84

ENVIRONMENT

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

BUG

126       /proc filesystem must be mounted for cifsiostat to work.
127
128

FILE

130       /proc/fs/cifs/Stats contains CIFS statistics.
131

AUTHORS

133       Written by Ivana Varekova (varekova <at> redhat.com)
134
135       Maintained by Sebastien Godard (sysstat <at> orange.fr)
136