~ubuntu-branches/ubuntu/quantal/sysstat/quantal

« back to all changes in this revision

Viewing changes to man/nfsiostat.1

  • Committer: Bazaar Package Importer
  • Author(s): Dave Walker (Daviey)
  • Date: 2011-02-09 17:10:56 UTC
  • mfrom: (1.1.19 upstream) (2.1.11 sid)
  • Revision ID: james.westby@ubuntu.com-20110209171056-ep8aecyxtppsrbnf
Tags: 9.1.7-2ubuntu1
* debian/patches/cflags-ordering.patch: Re-arrange CFLAGS in 
  ./Makefile.in to resolve FTBFS. (LP: #716043)
* debian/control: Updated maintainer, as per policy.

Show diffs side-by-side

added added

removed removed

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