# man > cifsiostat(1)

---
type: CommandReference
command: cifsiostat
mode: man
section: 1
source: man-pages
---

## Quick Reference

- `cifsiostat` — Display CIFS statistics since boot.
- `cifsiostat 2 5` — Display 5 reports every 2 seconds.
- `cifsiostat -h` — Print human-readable sizes.
- `cifsiostat --pretty` — Make report easier to read.
- `cifsiostat -k` — Display in kilobytes.
- `cifsiostat -m` — Display in megabytes.
- `cifsiostat -t` — Print timestamp in report header.
- `cifsiostat --dec=1` — Use 1 decimal place.

## Name

cifsiostat — Report CIFS statistics.

## Synopsis

shell
cifsiostat [ -h ] [ -k | -m ] [ -t ] [ -V ] [ --dec={ 0 | 1 | 2 } ] [ --human ] [ --pretty ] [ interval [ count ] ]
## Options

- `-h` — Print sizes in human-readable format (e.g., 1.0k, 1.2M).
- `-k` — Display statistics in kilobytes (default is bytes).
- `-m` — Display statistics in megabytes.
- `-t` — Print timestamp. Format controlled by the `S_TIME_FORMAT` environment variable.
- `-V` — Print version number and exit.
- `--dec={0|1|2}` — Number of decimal places to use (default 2).
- `--human` — Same as `-h`.
- `--pretty` — Make the CIFS report easier to read by a human.

## Report Fields

Each line shows statistics for a mounted CIFS filesystem:

- `Filesystem` — Mount point.
- `rB/s` (rkB/s, rMB/s) — Average bytes (kilobytes, megabytes) read per second.
- `wB/s` (wkB/s, wMB/s) — Average bytes (kilobytes, megabytes) written per second.
- `rop/s` — Read operations issued per second.
- `wop/s` — Write operations issued per second.
- `fo/s` — Open files per second.
- `fc/s` — Closed files per second.
- `fd/s` — Deleted files per second.

## Environment

- `S_COLORS` — Control color output. Values: `never`, `always`, `auto` (default).
- `S_COLORS_SGR` — Specify colors via a colon-separated list of capabilities. Default: `I=32;22:N=34;1:Z=34;22`. Capabilities:
  - `I=` — SGR substring for filesystem names.
  - `N=` — SGR substring for non-zero statistics values.
  - `Z=` — SGR substring for zero values.
- `S_TIME_FORMAT` — If set to `ISO`, use ISO 8601 date format (YYYY-MM-DD) in the report header and with `-t`.

## Notes

- `/proc` filesystem must be mounted.
- `cifsiostat` uses kibibytes (1024 bytes) despite reporting in kilobytes (kB), megabytes (MB), etc.
- Statistics are read from `/proc/fs/cifs/Stats`.

## See Also

- [sar(1)](https://www.chedong.com/phpMan.php/man/sar/1/markdown)
- [pidstat(1)](https://www.chedong.com/phpMan.php/man/pidstat/1/markdown)
- [mpstat(1)](https://www.chedong.com/phpMan.php/man/mpstat/1/markdown)
- [vmstat(8)](https://www.chedong.com/phpMan.php/man/vmstat/8/markdown)
- [iostat(1)](https://www.chedong.com/phpMan.php/man/iostat/1/markdown)
- [tapestat(1)](https://www.chedong.com/phpMan.php/man/tapestat/1/markdown)
- [nfsiostat(1)](https://www.chedong.com/phpMan.php/man/nfsiostat/1/markdown)

Project home: <https://github.com/sysstat/sysstat>