{
    "mode": "info",
    "parameter": "cifsiostat",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/cifsiostat/json",
    "generated": "2026-07-05T11:52:53Z",
    "synopsis": "cifsiostat  [  -h ] [ -k | -m ] [ -t ] [ -V ] [ --dec={ 0 | 1 | 2 } ] [\n--human ] [ --pretty ] [ interval [ count ] ]",
    "sections": {
        "NAME": {
            "content": "cifsiostat - Report CIFS statistics.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "cifsiostat  [  -h ] [ -k | -m ] [ -t ] [ -V ] [ --dec={ 0 | 1 | 2 } ] [\n--human ] [ --pretty ] [ interval [ count ] ]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The cifsiostat command displays statistics about read and write  opera-\ntions on CIFS filesystems.\n\nThe  interval parameter specifies the amount of time in seconds between\neach report. The first report contains statistics for  the  time  since\nsystem  startup (boot). Each subsequent report contains statistics col-\nlected during the interval since the previous report.   A  report  con-\nsists  of  a  CIFS header row followed by a line of statistics for each\nCIFS filesystem that is mounted.  The count parameter can be  specified\nin  conjunction  with the interval parameter. If the count parameter is\nspecified, the value of count determines the number of  reports  gener-\nated  at interval seconds apart. If the interval parameter is specified\nwithout the count parameter, the cifsiostat command  generates  reports\ncontinuously.\n",
            "subsections": []
        },
        "REPORT": {
            "content": "The  CIFS  report provides statistics for each mounted CIFS filesystem.\nThe report shows the following fields:\n\nFilesystem:\nThis columns shows the mount point of the CIFS filesystem.\n\nrB/s (rkB/s, rMB/s)\nIndicate the average number of bytes (kilobytes, megabytes) read\nper second.\n\nwB/s (wkB/s, wMB/s)\nIndicate  the  average  number  of  bytes (kilobytes, megabytes)\nwritten per second.\n\nrop/s  Indicate the number of 'read' operations that were issued to the\nfilesystem per second.\n\nwop/s  Indicate  the  number  of 'write' operations that were issued to\nthe filesystem per second.\n\nfo/s   Indicate the number of open files per second.\n\nfc/s   Indicate the number of closed files per second.\n\nfd/s   Indicate the number of deleted files per second.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "--dec={ 0 | 1 | 2 }\nSpecify the number of decimal places to use  (0  to  2,  default\nvalue is 2).\n\n-h     This option is equivalent to specifying --human --pretty.\n",
            "subsections": [
                {
                    "name": "--human",
                    "content": "Print  sizes  in  human  readable format (e.g. 1.0k, 1.2M, etc.)\nThe units displayed with this option supersede any other default\nunits (e.g.  kilobytes, sectors...) associated with the metrics.\n\n-k     Display statistics in kilobytes per second.\n\n-m     Display statistics in megabytes per second.\n",
                    "long": "--human"
                },
                {
                    "name": "--pretty",
                    "content": "Make the CIFS report easier to read by a human.\n\n-t     Print  the  time for each report displayed. The timestamp format\nmay depend on the value of the STIMEFORMAT  environment  vari-\nable (see below).\n\n-V     Print version number then exit.\n",
                    "long": "--pretty"
                }
            ]
        },
        "ENVIRONMENT": {
            "content": "The  cifsiostat  command  takes  into account the following environment\nvariables:\n\nSCOLORS\nBy default statistics are displayed in color when the output  is\nconnected  to  a terminal.  Use this variable to change the set-\ntings. Possible values for this variable are  never,  always  or\nauto (the latter is equivalent to the default settings).\nPlease  note  that  the  color (being red, yellow, or some other\ncolor) used to display a value is not indicative of any kind  of\nissue  simply  because of the color. It only indicates different\nranges of values.\n\nSCOLORSSGR\nSpecify the colors and other attributes used to display  statis-\ntics  on  the  terminal.  Its value is a colon-separated list of\ncapabilities that defaults to I=32;22:N=34;1:Z=34;22.  Supported\ncapabilities are:\n\nI=     SGR substring for filesystem names.\n\nN=     SGR substring for non-zero statistics values.\n\nZ=     SGR substring for zero values.\n\nSTIMEFORMAT\nIf  this  variable  exists and its value is ISO then the current\nlocale will be ignored when printing  the  date  in  the  report\nheader.  The  cifsiostat  command  will  use the ISO 8601 format\n(YYYY-MM-DD) instead.  The timestamp displayed  with  option  -t\nwill also be compliant with ISO 8601 format.\n",
            "subsections": []
        },
        "BUG": {
            "content": "/proc filesystem must be mounted for cifsiostat to work.\n\nAlthough cifsiostat speaks of kilobytes (kB), megabytes (MB)..., it ac-\ntually uses kibibytes (kiB), mebibytes (MiB)...  A kibibyte is equal to\n1024 bytes, and a mebibyte is equal to 1024 kibibytes.\n",
            "subsections": []
        },
        "FILE": {
            "content": "/proc/fs/cifs/Stats contains CIFS statistics.\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Written by Ivana Varekova (varekova <at> redhat.com)\nMaintained by Sebastien Godard (sysstat <at> orange.fr)\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "sar(1),  pidstat(1),  mpstat(1), vmstat(8), iostat(1), tapestat(1), nf-\nsiostat(1)\n\nhttps://github.com/sysstat/sysstat\nhttp://pagesperso-orange.fr/sebastien.godard/\n\nLinux                              JULY 2020                     CIFSIOSTAT(1)",
            "subsections": []
        }
    },
    "summary": "cifsiostat - Report CIFS statistics.",
    "flags": [
        {
            "flag": "",
            "long": "--human",
            "arg": null,
            "description": "Print sizes in human readable format (e.g. 1.0k, 1.2M, etc.) The units displayed with this option supersede any other default units (e.g. kilobytes, sectors...) associated with the metrics. -k Display statistics in kilobytes per second. -m Display statistics in megabytes per second."
        },
        {
            "flag": "",
            "long": "--pretty",
            "arg": null,
            "description": "Make the CIFS report easier to read by a human. -t Print the time for each report displayed. The timestamp format may depend on the value of the STIMEFORMAT environment vari- able (see below). -V Print version number then exit."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "sar",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/sar/1/json"
        },
        {
            "name": "pidstat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pidstat/1/json"
        },
        {
            "name": "mpstat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/mpstat/1/json"
        },
        {
            "name": "vmstat",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vmstat/8/json"
        },
        {
            "name": "iostat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/iostat/1/json"
        },
        {
            "name": "tapestat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/tapestat/1/json"
        },
        {
            "name": "siostat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/siostat/1/json"
        }
    ]
}