nfsiostat-sysstat(1)

1NFSIOSTAT-SYSSTAT(1)          Linux User's Manual         NFSIOSTAT-SYSSTAT(1)
2
3
4

NAME

6       nfsiostat-sysstat  (the  nfsiostat  command from the sysstat package) -
7       Report input/output statistics for network filesystems (NFS).
8

SYNOPSIS

10       nfsiostat-sysstat [ -h ] [ -k | -m ] [ -t ] [ -V ] [ interval [ count ]
11       ]
12

DESCRIPTION

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

REPORT

31       The Network  Filesystem  (NFS)  report  provides  statistics  for  each
32       mounted  network  filesystem.  Transfer rates are shown in 1K blocks by
33       default, unless the environment variable  POSIXLY_CORRECT  is  set,  in
34       which  case  512-byte  blocks are used.  The report shows the following
35       fields:
36
37       Filesystem:
38              This columns shows the hostname of the NFS server followed by  a
39              colon  and by the directory name where the network filesystem is
40              mounted.
41
42       rBlk_nor/s (rkB_nor/s, rMB_nor)
43              Indicate the number of blocks  (kilobytes,  megabytes)  read  by
44              applications  via the read(2) system call interface. A block has
45              a size of 512 bytes.
46
47       wBlk_nor/s (wkB_nor/s, wMB_nor/s)
48              Indicate the number of blocks (kilobytes, megabytes) written  by
49              applications via the write(2) system call interface.
50
51       rBlk_dir/s (rkB_dir/s, rMB_dir/s)
52              Indicate  the  number of blocks (kilobytes, megabytes) read from
53              files opened with the O_DIRECT flag.
54
55       wBlk_dir/s (wkB_dir/s, wMB_dir/s)
56              Indicate the number of blocks (kilobytes, megabytes) written  to
57              files opened with the O_DIRECT flag.
58
59       rBlk_svr/s (rkB_svr/s, rMB_svr/s)
60              Indicate  the  number of blocks (kilobytes, megabytes) read from
61              the server by the NFS client via an NFS READ request.
62
63       wBlk_svr/s (wkB_svr/s, wMB_svr/s)
64              Indicate the number of blocks (kilobytes, megabytes) written  to
65              the server by the NFS client via an NFS WRITE request.
66
67       ops/s
68              Indicate  the  number  of  operations  that  were  issued to the
69              filesystem per second.
70
71       rops/s
72              Indicate the number of 'read' operations that were issued to the
73              filesystem per second.
74
75       wops/s
76              Indicate  the  number  of 'write' operations that were issued to
77              the filesystem per second.
78

OPTIONS

80       -h     Make the NFS report easier to read by a human.
81
82       -k     Display statistics in kilobytes per second.
83
84       -m     Display statistics in megabytes per second.
85
86       -t     Print the time for each report displayed. The  timestamp  format
87              may  depend  on the value of the S_TIME_FORMAT environment vari‐
88              able (see below).
89
90       -V     Print version number then exit.
91
92

ENVIRONMENT

94       The nfsiostat-sysstat command takes into account the following environ‐
95       ment variables:
96
97
98       S_TIME_FORMAT
99              If  this  variable  exists and its value is ISO then the current
100              locale will be ignored when printing  the  date  in  the  report
101              header. The nfsiostat-sysstat command will use the ISO 8601 for‐
102              mat (YYYY-MM-DD) instead.  The timestamp displayed  with  option
103              -t will also be compliant with ISO 8601 format.
104
105
106       POSIXLY_CORRECT
107              When  this variable is set, transfer rates are shown in 512-byte
108              blocks instead of the default 1K blocks.
109
110

BUG

112       /proc filesystem must be mounted for nfsiostat-sysstat to work.
113
114

FILE

116       /proc/self/mountstats contains statistics for network filesystems.
117
118

WARNING

120       The nfsiostat command from the sysstat package  (nfsiostat-sysstat)  is
121       now  obsolete  and  is  no  longer maintained.  It will be removed in a
122       future sysstat version.  Please use now the nfsiostat command from  the
123       nfs-utils package.
124
125

AUTHORS

127       Written by Ivana Varekova (varekova <at> redhat.com)
128
129       Maintained by Sebastien Godard (sysstat <at> orange.fr)
130