staging/lustre/ldlm: move namespaces/lru_max_age to sysfs
[cascardo/linux.git] / drivers / staging / lustre / sysfs-fs-lustre
1 What:           /sys/fs/lustre/version
2 Date:           May 2015
3 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
4 Description:
5                 Shows current running lustre version.
6
7 What:           /sys/fs/lustre/pinger
8 Date:           May 2015
9 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
10 Description:
11                 Shows if the lustre module has pinger support.
12                 "on" means yes and "off" means no.
13
14 What:           /sys/fs/lustre/health
15 Date:           May 2015
16 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
17 Description:
18                 Shows whenever current system state believed to be "healthy",
19                 "NOT HEALTHY", or "LBUG" whenever lustre has experienced
20                 an internal assertion failure
21
22 What:           /sys/fs/lustre/jobid_name
23 Date:           May 2015
24 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
25 Description:
26                 Currently running job "name" for this node to be transferred
27                 to Lustre servers for purposes of QoS and statistics gathering.
28                 Writing into this file will change the name, reading outputs
29                 currently set value.
30
31 What:           /sys/fs/lustre/jobid_var
32 Date:           May 2015
33 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
34 Description:
35                 Control file for lustre "jobstats" functionality, write new
36                 value from the list below to change the mode:
37                 disable - disable job name reporting to the servers (default)
38                 procname_uid - form the job name as the current running
39                                command name and pid with a dot in between
40                                e.g. dd.1253
41                 nodelocal - use jobid_name value from above.
42
43 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/blocksize
44 Date:           May 2015
45 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
46 Description:
47                 Biggest blocksize on object storage server for this filesystem.
48
49 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/kbytestotal
50 Date:           May 2015
51 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
52 Description:
53                 Shows total number of kilobytes of space on this filesystem
54
55 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/kbytesfree
56 Date:           May 2015
57 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
58 Description:
59                 Shows total number of free kilobytes of space on this filesystem
60
61 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/kbytesavail
62 Date:           May 2015
63 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
64 Description:
65                 Shows total number of free kilobytes of space on this filesystem
66                 actually available for use (taking into account per-client
67                 grants and filesystem reservations).
68
69 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/filestotal
70 Date:           May 2015
71 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
72 Description:
73                 Shows total number of inodes on the filesystem.
74
75 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/filesfree
76 Date:           May 2015
77 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
78 Description:
79                 Shows estimated number of free inodes on the filesystem
80
81 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/client_type
82 Date:           May 2015
83 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
84 Description:
85                 Shows whenever this filesystem considers this client to be
86                 compute cluster-local or remote. Remote clients have
87                 additional uid/gid convrting logic applied.
88
89 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/fstype
90 Date:           May 2015
91 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
92 Description:
93                 Shows filesystem type of the filesystem
94
95 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/uuid
96 Date:           May 2015
97 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
98 Description:
99                 Shows this filesystem superblock uuid
100
101 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/max_read_ahead_mb
102 Date:           May 2015
103 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
104 Description:
105                 Sets maximum number of megabytes in system memory to be
106                 given to read-ahead cache.
107
108 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/max_read_ahead_per_file_mb
109 Date:           May 2015
110 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
111 Description:
112                 Sets maximum number of megabytes to read-ahead for a single file
113
114 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/max_read_ahead_whole_mb
115 Date:           May 2015
116 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
117 Description:
118                 For small reads, how many megabytes to actually request from
119                 the server as initial read-ahead.
120
121 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/checksum_pages
122 Date:           May 2015
123 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
124 Description:
125                 Enables or disables per-page checksum at llite layer, before
126                 the pages are actually given to lower level for network transfer
127
128 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/stats_track_pid
129 Date:           May 2015
130 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
131 Description:
132                 Limit Lustre vfs operations gathering to just a single pid.
133                 0 to track everything.
134
135 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/stats_track_ppid
136 Date:           May 2015
137 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
138 Description:
139                 Limit Lustre vfs operations gathering to just a single ppid.
140                 0 to track everything.
141
142 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/stats_track_gid
143 Date:           May 2015
144 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
145 Description:
146                 Limit Lustre vfs operations gathering to just a single gid.
147                 0 to track everything.
148
149 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/statahead_max
150 Date:           May 2015
151 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
152 Description:
153                 Controls maximum number of statahead requests to send when
154                 sequential readdir+stat pattern is detected.
155
156 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/statahead_agl
157 Date:           May 2015
158 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
159 Description:
160                 Controls if AGL (async glimpse ahead - obtain object information
161                 from OSTs in parallel with MDS during statahead) should be
162                 enabled or disabled.
163                 0 to disable, 1 to enable.
164
165 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/lazystatfs
166 Date:           May 2015
167 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
168 Description:
169                 Controls statfs(2) behaviour in the face of down servers.
170                 If 0, always wait for all servers to come online,
171                 if 1, ignote inactive servers.
172
173 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/max_easize
174 Date:           May 2015
175 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
176 Description:
177                 Shows maximum number of bytes file striping data could be
178                 in current configuration of storage.
179
180 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/default_easize
181 Date:           May 2015
182 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
183 Description:
184                 Shows maximum observed file striping data seen by this
185                 filesystem client instance.
186
187 What:           /sys/fs/lustre/llite/<fsname>-<uuid>/xattr_cache
188 Date:           May 2015
189 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
190 Description:
191                 Controls extended attributes client-side cache.
192                 1 to enable, 0 to disable.
193
194 What:           /sys/fs/lustre/ldlm/cancel_unused_locks_before_replay
195 Date:           May 2015
196 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
197 Description:
198                 Controls if client should replay unused locks during recovery
199                 If a client tends to have a lot of unused locks in LRU,
200                 recovery times might become prolonged.
201                 1 - just locally cancel unused locks (default)
202                 0 - replay unused locks.
203
204 What:           /sys/fs/lustre/ldlm/namespaces/<name>/resource_count
205 Date:           May 2015
206 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
207 Description:
208                 Displays number of lock resources (objects on which individual
209                 locks are taken) currently allocated in this namespace.
210
211 What:           /sys/fs/lustre/ldlm/namespaces/<name>/lock_count
212 Date:           May 2015
213 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
214 Description:
215                 Displays number or locks allocated in this namespace.
216
217 What:           /sys/fs/lustre/ldlm/namespaces/<name>/lru_size
218 Date:           May 2015
219 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
220 Description:
221                 Controls and displays LRU size limit for unused locks for this
222                 namespace.
223                 0 - LRU size is unlimited, controlled by server resources
224                 positive number - number of locks to allow in lock LRU list
225
226 What:           /sys/fs/lustre/ldlm/namespaces/<name>/lock_unused_count
227 Date:           May 2015
228 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
229 Description:
230                 Display number of locks currently sitting in the LRU list
231                 of this namespace
232
233 What:           /sys/fs/lustre/ldlm/namespaces/<name>/lru_max_age
234 Date:           May 2015
235 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
236 Description:
237                 Maximum number of milliseconds a lock could sit in LRU list
238                 before client would voluntarily cancel it as unused.
239
240 What:           /sys/fs/lustre/ldlm/namespaces/<name>/early_lock_cancel
241 Date:           May 2015
242 Contact:        "Oleg Drokin" <oleg.drokin@intel.com>
243 Description:
244                 Controls "early lock cancellation" feature on this namespace
245                 if supported by the server.
246                 When enabled, tries to preemtively cancel locks that would be
247                 cancelled by verious operations and bundle the cancellation
248                 requests in the same RPC as the main operation, which results
249                 in significant speedups due to reduced lock-pingpong RPCs.
250                 0 - disabled
251                 1 - enabled (default)