granicus.if.org Git - sysstat/blob - man/nfsiostat-sysstat.in

   1 .TH NFSIOSTAT-SYSSTAT 1 "JANUARY 2014" Linux "Linux User's Manual" -*- nroff -*-
   2 .SH NAME
   3 nfsiostat-sysstat (the nfsiostat command from the sysstat package) \- Report input/output statistics for network filesystems (NFS).
   4 .SH SYNOPSIS
   5 .ie 'yes'@WITH_DEBUG@' \{
   6 .B nfsiostat-sysstat [ -h ] [ -k | -m ] [ -t ] [ -V ] [ --debuginfo ] [
   7 .I interval
   8 .B [
   9 .I count
  10 .B ] ]
  11 .\}
  12 .el \{
  13 .B nfsiostat-sysstat [ -h ] [ -k | -m ] [ -t ] [ -V ] [
  14 .I interval
  15 .B [
  16 .I count
  17 .B ] ]
  18 .\}
  19 .SH DESCRIPTION
  20 The
  21 .B nfsiostat-sysstat
  22 command displays statistics about read and write operations
  23 on NFS filesystems.
  24
  25 The
  26 .I interval
  27 parameter specifies the amount of time in seconds between
  28 each report. The first report contains statistics for the time since
  29 system startup (boot). Each subsequent report contains statistics
  30 collected during the interval since the previous report.
  31 A report consists of an NFS header row followed by
  32 a line of statistics for each network filesystem that is mounted.
  33 The
  34 .I count
  35 parameter can be specified in conjunction with the
  36 .I interval
  37 parameter. If the
  38 .I count
  39 parameter is specified, the value of
  40 .I count
  41 determines the number of reports generated at
  42 .I interval
  43 seconds apart. If the
  44 .I interval
  45 parameter is specified without the
  46 .I count
  47 parameter, the
  48 .B nfsiostat-sysstat
  49 command generates reports continuously.
  50
  51 .SH REPORT
  52 The Network Filesystem (NFS) report provides statistics for each mounted network filesystem.
  53 Transfer rates are shown in 1K blocks by default, unless the environment
  54 variable POSIXLY_CORRECT is set, in which case 512-byte blocks are used.
  55 The report shows the following fields:
  56
  57 .B Filesystem:
  58 .RS
  59 This columns shows the hostname of the NFS server followed by a colon and
  60 by the directory name where the network filesystem is mounted.
  61
  62 .RE
  63 .B rBlk_nor/s (rkB_nor/s, rMB_nor)
  64 .RS
  65 Indicate the number of blocks (kilobytes, megabytes) read by applications
  66 via the read(2) system
  67 call interface. A block has a size of 512 bytes.
  68
  69 .RE
  70 .B wBlk_nor/s (wkB_nor/s, wMB_nor/s)
  71 .RS
  72 Indicate the number of blocks (kilobytes, megabytes) written by applications
  73 via the write(2) system
  74 call interface.
  75
  76 .RE
  77 .B rBlk_dir/s (rkB_dir/s, rMB_dir/s)
  78 .RS
  79 Indicate the number of blocks (kilobytes, megabytes) read from files
  80 opened with the O_DIRECT flag.
  81
  82 .RE
  83 .B wBlk_dir/s (wkB_dir/s, wMB_dir/s)
  84 .RS
  85 Indicate the number of blocks (kilobytes, megabytes) written to files
  86 opened with the O_DIRECT flag.
  87
  88 .RE
  89 .B rBlk_svr/s (rkB_svr/s, rMB_svr/s)
  90 .RS
  91 Indicate the number of blocks (kilobytes, megabytes) read from the server
  92 by the NFS client via an NFS READ request.
  93
  94 .RE
  95 .B wBlk_svr/s (wkB_svr/s, wMB_svr/s)
  96 .RS
  97 Indicate the number of blocks (kilobytes, megabytes) written to the server
  98 by the NFS client via an NFS WRITE request.
  99
 100 .RE
 101 .B ops/s
 102 .RS
 103 Indicate the number of operations that were issued to the filesystem per second.
 104
 105 .RE
 106 .B rops/s
 107 .RS
 108 Indicate the number of 'read' operations that were issued to the filesystem
 109 per second.
 110
 111 .RE
 112 .B wops/s
 113 .RS
 114 Indicate the number of 'write' operations that were issued to the filesystem
 115 per second.
 116 .RE
 117 .RE
 118 .SH OPTIONS
 119 .if 'yes'@WITH_DEBUG@' \{
 120 .IP --debuginfo
 121 Print debug output to stderr.
 122 .\}
 123 .IP -h
 124 Make the NFS report easier to read by a human.
 125 .IP -k
 126 Display statistics in kilobytes per second.
 127 .IP -m
 128 Display statistics in megabytes per second.
 129 .IP -t
 130 Print the time for each report displayed. The timestamp format may depend
 131 on the value of the S_TIME_FORMAT environment variable (see below).
 132 .IP -V
 133 Print version number then exit.
 134
 135 .SH ENVIRONMENT
 136 The
 137 .B nfsiostat-sysstat
 138 command takes into account the following environment variables:
 139
 140 .IP S_TIME_FORMAT
 141 If this variable exists and its value is
 142 .BR ISO
 143 then the current locale will be ignored when printing the date in the report
 144 header. The
 145 .B nfsiostat-sysstat
 146 command will use the ISO 8601 format (YYYY-MM-DD) instead.
 147 The timestamp displayed with option -t will also be compliant with ISO 8601
 148 format.
 149
 150 .IP POSIXLY_CORRECT
 151 When this variable is set, transfer rates are shown in 512-byte blocks instead
 152 of the default 1K blocks.
 153
 154 .SH BUG
 155 .I /proc
 156 filesystem must be mounted for
 157 .B nfsiostat-sysstat
 158 to work.
 159
 160 .SH FILE
 161 .I /proc/self/mountstats
 162 contains statistics for network filesystems.
 163
 164 .SH WARNING
 165 The nfsiostat
 166 command from the sysstat package (nfsiostat-sysstat) is now obsolete and is no longer maintained.
 167 It will be removed in a future sysstat version.
 168 Please use now the
 169 .B nfsiostat
 170 command from the
 171 .I nfs-utils
 172 package.
 173
 174 .SH AUTHOR
 175 Written by Ivana Varekova (varekova <at> redhat.com)
 176
 177 .SH SEE ALSO
 178 .BR nfsiostat (8),
 179 .BR sar (1),
 180 .BR pidstat (1),
 181 .BR mpstat (1),
 182 .BR vmstat (8),
 183 .BR iostat (1),
 184 .BR cifsiostat (1)
 185