NFSv4: Fix an oops in nfs4_fill_super
[linux-2.6.git] / fs / nfs / iostat.h
1 /*
2  *  linux/fs/nfs/iostat.h
3  *
4  *  Declarations for NFS client per-mount statistics
5  *
6  *  Copyright (C) 2005, 2006 Chuck Lever <cel@netapp.com>
7  *
8  *  NFS client per-mount statistics provide information about the health of
9  *  the NFS client and the health of each NFS mount point.  Generally these
10  *  are not for detailed problem diagnosis, but simply to indicate that there
11  *  is a problem.
12  *
13  *  These counters are not meant to be human-readable, but are meant to be
14  *  integrated into system monitoring tools such as "sar" and "iostat".  As
15  *  such, the counters are sampled by the tools over time, and are never
16  *  zeroed after a file system is mounted.  Moving averages can be computed
17  *  by the tools by taking the difference between two instantaneous samples
18  *  and dividing that by the time between the samples.
19  */
20
21 #ifndef _NFS_IOSTAT
22 #define _NFS_IOSTAT
23
24 #define NFS_IOSTAT_VERS         "1.0"
25
26 /*
27  * NFS byte counters
28  *
29  * 1.  SERVER - the number of payload bytes read from or written to the
30  *     server by the NFS client via an NFS READ or WRITE request.
31  *
32  * 2.  NORMAL - the number of bytes read or written by applications via
33  *     the read(2) and write(2) system call interfaces.
34  *
35  * 3.  DIRECT - the number of bytes read or written from files opened
36  *     with the O_DIRECT flag.
37  *
38  * These counters give a view of the data throughput into and out of the NFS
39  * client.  Comparing the number of bytes requested by an application with the
40  * number of bytes the client requests from the server can provide an
41  * indication of client efficiency (per-op, cache hits, etc).
42  *
43  * These counters can also help characterize which access methods are in
44  * use.  DIRECT by itself shows whether there is any O_DIRECT traffic.
45  * NORMAL + DIRECT shows how much data is going through the system call
46  * interface.  A large amount of SERVER traffic without much NORMAL or
47  * DIRECT traffic shows that applications are using mapped files.
48  *
49  * NFS page counters
50  *
51  * These count the number of pages read or written via nfs_readpage(),
52  * nfs_readpages(), or their write equivalents.
53  */
54 enum nfs_stat_bytecounters {
55         NFSIOS_NORMALREADBYTES = 0,
56         NFSIOS_NORMALWRITTENBYTES,
57         NFSIOS_DIRECTREADBYTES,
58         NFSIOS_DIRECTWRITTENBYTES,
59         NFSIOS_SERVERREADBYTES,
60         NFSIOS_SERVERWRITTENBYTES,
61         NFSIOS_READPAGES,
62         NFSIOS_WRITEPAGES,
63         __NFSIOS_BYTESMAX,
64 };
65
66 /*
67  * NFS event counters
68  *
69  * These counters provide a low-overhead way of monitoring client activity
70  * without enabling NFS trace debugging.  The counters show the rate at
71  * which VFS requests are made, and how often the client invalidates its
72  * data and attribute caches.  This allows system administrators to monitor
73  * such things as how close-to-open is working, and answer questions such
74  * as "why are there so many GETATTR requests on the wire?"
75  *
76  * They also count anamolous events such as short reads and writes, silly
77  * renames due to close-after-delete, and operations that change the size
78  * of a file (such operations can often be the source of data corruption
79  * if applications aren't using file locking properly).
80  */
81 enum nfs_stat_eventcounters {
82         NFSIOS_INODEREVALIDATE = 0,
83         NFSIOS_DENTRYREVALIDATE,
84         NFSIOS_DATAINVALIDATE,
85         NFSIOS_ATTRINVALIDATE,
86         NFSIOS_VFSOPEN,
87         NFSIOS_VFSLOOKUP,
88         NFSIOS_VFSACCESS,
89         NFSIOS_VFSUPDATEPAGE,
90         NFSIOS_VFSREADPAGE,
91         NFSIOS_VFSREADPAGES,
92         NFSIOS_VFSWRITEPAGE,
93         NFSIOS_VFSWRITEPAGES,
94         NFSIOS_VFSGETDENTS,
95         NFSIOS_VFSSETATTR,
96         NFSIOS_VFSFLUSH,
97         NFSIOS_VFSFSYNC,
98         NFSIOS_VFSLOCK,
99         NFSIOS_VFSRELEASE,
100         NFSIOS_CONGESTIONWAIT,
101         NFSIOS_SETATTRTRUNC,
102         NFSIOS_EXTENDWRITE,
103         NFSIOS_SILLYRENAME,
104         NFSIOS_SHORTREAD,
105         NFSIOS_SHORTWRITE,
106         NFSIOS_DELAY,
107         __NFSIOS_COUNTSMAX,
108 };
109
110 #ifdef __KERNEL__
111
112 #include <linux/percpu.h>
113 #include <linux/cache.h>
114
115 struct nfs_iostats {
116         unsigned long long      bytes[__NFSIOS_BYTESMAX];
117         unsigned long           events[__NFSIOS_COUNTSMAX];
118 } ____cacheline_aligned;
119
120 static inline void nfs_inc_server_stats(struct nfs_server *server, enum nfs_stat_eventcounters stat)
121 {
122         struct nfs_iostats *iostats;
123         int cpu;
124
125         cpu = get_cpu();
126         iostats = per_cpu_ptr(server->io_stats, cpu);
127         iostats->events[stat] ++;
128         put_cpu_no_resched();
129 }
130
131 static inline void nfs_inc_stats(struct inode *inode, enum nfs_stat_eventcounters stat)
132 {
133         nfs_inc_server_stats(NFS_SERVER(inode), stat);
134 }
135
136 static inline void nfs_add_server_stats(struct nfs_server *server, enum nfs_stat_bytecounters stat, unsigned long addend)
137 {
138         struct nfs_iostats *iostats;
139         int cpu;
140
141         cpu = get_cpu();
142         iostats = per_cpu_ptr(server->io_stats, cpu);
143         iostats->bytes[stat] += addend;
144         put_cpu_no_resched();
145 }
146
147 static inline void nfs_add_stats(struct inode *inode, enum nfs_stat_bytecounters stat, unsigned long addend)
148 {
149         nfs_add_server_stats(NFS_SERVER(inode), stat, addend);
150 }
151
152 static inline struct nfs_iostats *nfs_alloc_iostats(void)
153 {
154         return alloc_percpu(struct nfs_iostats);
155 }
156
157 static inline void nfs_free_iostats(struct nfs_iostats *stats)
158 {
159         if (stats != NULL)
160                 free_percpu(stats);
161 }
162
163 #endif
164 #endif