{ "content": [ { "type": "text", "text": "# nfsiostat (man)\n\n## NAME\n\nnfsiostat - Emulate iostat for NFS mount points using /proc/self/mountstats\n\n## SYNOPSIS\n\nnfsiostat [[] []] [][]\n\n## DESCRIPTION\n\nThe nfsiostat command displays NFS client per-mount statisitics.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (7 subsections)\n- **FILES** (1 subsections)\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "nfsiostat", "section": "", "mode": "man", "summary": "nfsiostat - Emulate iostat for NFS mount points using /proc/self/mountstats", "synopsis": "nfsiostat [[] []] [][]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-a", "long": "--attr", "arg": null, "description": "displays statistics related to the attribute cache" }, { "flag": "-d", "long": "--dir", "arg": null, "description": "displays statistics related to directory operations" }, { "flag": "-h", "long": "--help", "arg": null, "description": "shows help message and exit" }, { "flag": "-l", "long": "--list", "arg": "LIST", "description": "only print stats for first LIST mount points" }, { "flag": "-p", "long": "--page", "arg": null, "description": "displays statistics related to the page cache" }, { "flag": "-s", "long": "--sort", "arg": null, "description": "Sort NFS mount points by ops/second" }, { "flag": "", "long": "--version", "arg": null, "description": "show program's version number and exit" } ], "examples": [], "see_also": [ { "name": "iostat", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/iostat/8/json" }, { "name": "mountstats", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/mountstats/8/json" }, { "name": "nfsstat", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/nfsstat/8/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 49, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-a or --attr", "lines": 2, "flag": "-a", "long": "--attr" }, { "name": "-d or --dir", "lines": 2, "flag": "-d", "long": "--dir" }, { "name": "-h or --help", "lines": 2, "flag": "-h", "long": "--help" }, { "name": "-l LIST or --list=LIST", "lines": 2, "flag": "-l", "long": "--list", "arg": "LIST" }, { "name": "-p or --page", "lines": 2, "flag": "-p", "long": "--page" }, { "name": "-s or --sort", "lines": 2, "flag": "-s", "long": "--sort" }, { "name": "--version", "lines": 2, "long": "--version" } ] }, { "name": "FILES", "lines": 1, "subsections": [ { "name": "/proc/self/mountstats", "lines": 1 } ] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "nfsiostat - Emulate iostat for NFS mount points using /proc/self/mountstats\n", "subsections": [] }, "SYNOPSIS": { "content": "nfsiostat [[] []] [][]\n", "subsections": [] }, "DESCRIPTION": { "content": "The nfsiostat command displays NFS client per-mount statisitics.\n\n\nspecifies the amount of time in seconds between each report. The first report con‐\ntains statistics for the time since each file system was mounted. Each subsequent re‐\nport contains statistics collected during the interval since the previous report.\n\n\nIf the parameter is specified, the value of determines the number of\nreports generated at seconds apart. if the interval parameter is specified\nwithout the parameter, the command generates reports continuously.\n\n\nDefine below\n\n\nIf one or more names are specified, statistics for only these mount\npoints will be displayed. Otherwise, all NFS mount points on the client are listed.\n\nThe meaning of each column of nfsiostat's output is the following:\n- op/s\nThis is the number of operations per second.\n- rpc bklog\nThis is the length of the backlog queue.\n- kB/s\nThis is the number of kB written/read per second.\n- kB/op\nThis is the number of kB written/read per each operation.\n- retrans\nThis is the number of retransmissions.\n- avg RTT (ms)\nThis is the duration from the time that client's kernel sends the RPC request\nuntil the time it receives the reply.\n- avg exe (ms)\nThis is the duration from the time that NFS client does the RPC request to its\nkernel until the RPC request is completed, this includes the RTT time above.\n- avg queue (ms)\nThis is the duration from the time the NFS client created the RPC request task\nto the time the request is transmitted.\n- errors\nThis is the number of operations that completed with an error status (status <\n0). This count is only available on kernels with RPC iostats version 1.1 or\nabove.\n\nNote that if an interval is used as argument to nfsiostat, then the diffrence from previous\ninterval will be displayed, otherwise the results will be from the time that the share was\nmounted.\n\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-a or --attr", "content": "displays statistics related to the attribute cache\n", "flag": "-a", "long": "--attr" }, { "name": "-d or --dir", "content": "displays statistics related to directory operations\n", "flag": "-d", "long": "--dir" }, { "name": "-h or --help", "content": "shows help message and exit\n", "flag": "-h", "long": "--help" }, { "name": "-l LIST or --list=LIST", "content": "only print stats for first LIST mount points\n", "flag": "-l", "long": "--list", "arg": "LIST" }, { "name": "-p or --page", "content": "displays statistics related to the page cache\n", "flag": "-p", "long": "--page" }, { "name": "-s or --sort", "content": "Sort NFS mount points by ops/second\n", "flag": "-s", "long": "--sort" }, { "name": "--version", "content": "show program's version number and exit\n", "long": "--version" } ] }, "FILES": { "content": "", "subsections": [ { "name": "/proc/self/mountstats", "content": "" } ] }, "SEE ALSO": { "content": "iostat(8), mountstats(8), nfsstat(8)\n", "subsections": [] }, "AUTHOR": { "content": "Chuck Lever \n\n\n\n15 Apr 2010 nfsiostat(8)", "subsections": [] } } } }