cifsiostat(1)

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

NAME

6       cifsiostat - Report CIFS statistics.
7
8

SYNOPSIS

10       cifsiostat  [  -h ] [ -k | -m ] [ -t ] [ -V ] [ --dec={ 0 | 1 | 2 } ] [
11       --human ] [ --pretty ] [ interval [ count ] ]
12
13

DESCRIPTION

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

REPORT

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

OPTIONS

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

ENVIRONMENT

87       The  cifsiostat  command  takes  into account the following environment
88       variables:
89
90       S_COLORS
91              By default statistics are displayed in color when the output  is
92              connected  to  a terminal.  Use this variable to change the set‐
93              tings. Possible values for this variable are  never,  always  or
94              auto (the latter is equivalent to the default settings).
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       S_COLORS_SGR
101              Specify the colors and other attributes used to display  statis‐
102              tics  on  the  terminal.  Its value is a colon-separated list of
103              capabilities that defaults to I=32;22:N=34;1:Z=34;22.  Supported
104              capabilities are:
105
106              I=     SGR substring for filesystem names.
107
108              N=     SGR substring for non-zero statistics values.
109
110              Z=     SGR substring for zero values.
111
112       S_TIME_FORMAT
113              If  this  variable  exists and its value is ISO then the current
114              locale will be ignored when printing  the  date  in  the  report
115              header.  The  cifsiostat  command  will  use the ISO 8601 format
116              (YYYY-MM-DD) instead.  The timestamp displayed  with  option  -t
117              will also be compliant with ISO 8601 format.
118
119

BUG

121       /proc filesystem must be mounted for cifsiostat to work.
122
123       Although cifsiostat speaks of kilobytes (kB), megabytes (MB)..., it ac‐
124       tually uses kibibytes (kiB), mebibytes (MiB)...  A kibibyte is equal to
125       1024 bytes, and a mebibyte is equal to 1024 kibibytes.
126
127

FILE

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

AUTHORS

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