Print this page
5025 import and use mandoc
Reviewed by: Hans Rosenfeld <hans.rosenfeld@nexenta.com>
Reviewed by: Igor Kozhukhov <ikozhukhov@gmail.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Albert Lee <trisk@nexenta.com>
Approved by: TBD
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/arcstat.1m
+++ new/usr/src/man/man1m/arcstat.1m
1 1 .\"
2 2 .\" This file and its contents are supplied under the terms of the
3 3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 4 .\" You may only use this file in accordance with the terms of version
5 5 .\" 1.0 of the CDDL.
6 6 .\"
7 7 .\" A full copy of the text of the CDDL should have accompanied this
8 8 .\" source. A copy of the CDDL is also available via the Internet at
9 9 .\" http://www.illumos.org/license/CDDL.
10 10 .\"
11 11 .\"
12 12 .\" Copyright 2014 Adam Stevko. All rights reserved.
13 13 .\"
14 14 .TH ARCSTAT 1M "Feb 4, 2014"
15 15 .SH NAME
16 16 arcstat \- report ZFS ARC and L2ARC statistics
17 17 .SH SYNOPSIS
18 18 .LP
19 19 .nf
20 20 \fBarcstat\fR [\fB-hvxr\fR] [\fB-f field[,field]...\fR] [\fB-o file\fR] [\fB-s string\fR]
21 21 [\fBinterval\fR [\fBcount\fR]]
22 22 .fi
23 23
24 24 .SH DESCRIPTION
25 25 .sp
26 26 .LP
27 27 The \fBarcstat\fR utility print various ZFS ARC and L2ARC statistics in
28 28 vmstat-like fashion.
29 29 .sp
30 30
31 31 .sp
32 32 .LP
33 33 The \fBarcstat\fR command reports the following information:
34 34 .sp
35 35 .ne 2
36 36
37 37 .\"
38 38 .sp
39 39 .ne 1
40 40 .na
41 41 \fBc \fR
42 42 .ad
43 43 .RS 14n
44 44 ARC Target Size
45 45 .RE
46 46
47 47 .sp
48 48 .ne 2
49 49 .na
50 50 \fBdh% \fR
51 51 .ad
52 52 .RS 14n
53 53 Demand Data hit percentage
54 54 .RE
55 55
56 56 .sp
57 57 .ne 2
58 58 .na
59 59 \fBdm% \fR
60 60 .ad
61 61 .RS 14n
62 62 Demand Data miss percentage
63 63 .RE
64 64
65 65 .sp
66 66 .ne 2
67 67 .na
68 68 \fBmfu \fR
69 69 .ad
70 70 .RS 14n
71 71 MFU List hits per second
72 72 .RE
73 73
74 74 .sp
75 75 .ne 2
76 76 .na
77 77 \fBmh% \fR
78 78 .ad
79 79 .RS 14n
80 80 Metadata hit percentage
81 81 .RE
82 82
83 83 .sp
84 84 .ne 2
85 85 .na
86 86 \fBmm% \fR
87 87 .ad
88 88 .RS 14n
89 89 Metadata miss percentage
90 90 .RE
91 91
92 92 .sp
93 93 .ne 2
94 94 .na
95 95 \fBmru \fR
96 96 .ad
97 97 .RS 14n
98 98 MRU List hits per second
99 99 .RE
100 100
101 101 .sp
102 102 .ne 2
103 103 .na
104 104 \fBph% \fR
105 105 .ad
106 106 .RS 14n
107 107 Prefetch hits percentage
108 108 .RE
109 109
110 110 .sp
111 111 .ne 2
112 112 .na
113 113 \fBpm% \fR
114 114 .ad
115 115 .RS 14n
116 116 Prefetch miss percentage
117 117 .RE
118 118
119 119 .sp
120 120 .ne 2
121 121 .na
122 122 \fBdhit \fR
123 123 .ad
124 124 .RS 14n
125 125 Demand Data hits per second
126 126 .RE
127 127
128 128 .sp
129 129 .ne 2
130 130 .na
131 131 \fBdmis \fR
132 132 .ad
133 133 .RS 14n
134 134 Demand Data misses per second
135 135 .RE
136 136
137 137 .sp
138 138 .ne 2
139 139 .na
140 140 \fBhit% \fR
141 141 .ad
142 142 .RS 14n
143 143 ARC Hit percentage
144 144 .RE
145 145
146 146 .sp
147 147 .ne 2
148 148 .na
149 149 \fBhits \fR
150 150 .ad
151 151 .RS 14n
152 152 ARC reads per second
153 153 .RE
154 154
155 155 .sp
156 156 .ne 2
157 157 .na
158 158 \fBmfug \fR
159 159 .ad
160 160 .RS 14n
161 161 MFU Ghost List hits per second
162 162 .RE
163 163
164 164 .sp
165 165 .ne 2
166 166 .na
167 167 \fBmhit \fR
168 168 .ad
169 169 .RS 14n
170 170 Metadata hits per second
171 171 .RE
172 172
173 173 .sp
174 174 .ne 2
175 175 .na
176 176 \fBmiss \fR
177 177 .ad
178 178 .RS 14n
179 179 ARC misses per second
180 180 .RE
181 181
182 182 .sp
183 183 .ne 2
184 184 .na
185 185 \fBmmis \fR
186 186 .ad
187 187 .RS 14n
188 188 Metadata misses per second
189 189 .RE
190 190
191 191 .sp
192 192 .ne 2
193 193 .na
194 194 \fBmrug \fR
195 195 .ad
196 196 .RS 14n
197 197 MRU Ghost List hits per second
198 198 .RE
199 199
200 200 .sp
201 201 .ne 2
202 202 .na
203 203 \fBphit \fR
204 204 .ad
205 205 .RS 14n
206 206 Prefetch hits per second
207 207 .RE
208 208
209 209 .sp
210 210 .ne 2
211 211 .na
212 212 \fBpmis \fR
213 213 .ad
214 214 .RS 14n
215 215 Prefetch misses per second
216 216 .RE
217 217
218 218 .sp
219 219 .ne 2
220 220 .na
221 221 \fBread \fR
222 222 .ad
223 223 .RS 14n
224 224 Total ARC accesses per second
225 225 .RE
226 226
227 227 .sp
228 228 .ne 2
229 229 .na
230 230 \fBrmis \fR
231 231 .ad
232 232 .RS 14n
233 233 recycle_miss per second
234 234 .RE
235 235
236 236 .sp
237 237 .ne 2
238 238 .na
239 239 \fBtime \fR
240 240 .ad
241 241 .RS 14n
242 242 Time
243 243 .RE
244 244
245 245 .sp
246 246 .ne 2
247 247 .na
248 248 \fBarcsz \fR
249 249 .ad
250 250 .RS 14n
251 251 ARC Size
252 252 .RE
253 253
254 254 .sp
255 255 .ne 2
256 256 .na
257 257 \fBdread \fR
258 258 .ad
259 259 .RS 14n
260 260 Demand data accesses per second
261 261 .RE
262 262
263 263 .sp
264 264 .ne 2
265 265 .na
266 266 \fBeskip \fR
267 267 .ad
268 268 .RS 14n
269 269 evict_skip per second
270 270 .RE
271 271
272 272 .sp
273 273 .ne 2
274 274 .na
275 275 \fBmiss% \fR
276 276 .ad
277 277 .RS 14n
278 278 ARC miss percentage
279 279 .RE
280 280
281 281 .sp
282 282 .ne 2
283 283 .na
284 284 \fBmread \fR
285 285 .ad
286 286 .RS 14n
287 287 Metadata accesses per second
288 288 .RE
289 289
290 290 .sp
291 291 .ne 2
292 292 .na
293 293 \fBpread \fR
294 294 .ad
295 295 .RS 14n
296 296 Prefetch accesses per second
297 297 .RE
298 298
299 299 .sp
300 300 .ne 2
301 301 .na
302 302 \fBl2hit% \fR
303 303 .ad
304 304 .RS 14n
305 305 L2ARC access hit percentage
306 306 .RE
307 307
308 308 .sp
309 309 .ne 2
310 310 .na
311 311 \fBl2hits \fR
312 312 .ad
313 313 .RS 14n
314 314 L2ARC hits per second
315 315 .RE
316 316
317 317 .sp
318 318 .ne 2
319 319 .na
320 320 \fBl2miss \fR
321 321 .ad
322 322 .RS 14n
323 323 L2ARC misses per second
324 324 .RE
325 325
326 326 .sp
327 327 .ne 2
328 328 .na
329 329 \fBl2read \fR
330 330 .ad
331 331 .RS 14n
332 332 Total L2ARC accesses per second
333 333 .RE
334 334
335 335 .sp
336 336 .ne 2
337 337 .na
338 338 \fBl2size \fR
339 339 .ad
340 340 .RS 14n
341 341 Size of the L2ARC
342 342 .RE
343 343
344 344 .sp
345 345 .ne 2
346 346 .na
347 347 \fBmtxmis \fR
348 348 .ad
349 349 .RS 14n
350 350 mutex_miss per second
351 351 .RE
352 352
353 353 .sp
354 354 .ne 2
355 355 .na
356 356 \fBl2bytes \fR
357 357 .ad
358 358 .RS 14n
359 359 bytes read per second from the L2ARC
360 360 .RE
361 361
362 362 .sp
363 363 .ne 2
364 364 .na
365 365 \fBl2miss% \fR
366 366 .ad
367 367 .RS 14n
368 368 L2ARC access miss percentage
369 369 .RE
370 370
371 371 .sp
372 372 .ne 2
373 373 .na
374 374 \fBl2asize \fR
375 375 .ad
376 376 .RS 14n
377 377 Actual (compressed) size of the L2ARC
378 378 .RE
379 379 .\"
380 380
381 381 .SH OPTIONS
382 382 .sp
383 383 .LP
384 384 The following options are supported:
385 385
386 386 .sp
387 387 .ne 2
388 388 .na
389 389 \fB\fB-f\fR\fR
390 390 .ad
391 391 .RS 12n
392 392 Display only specific fields. See \fBDESCRIPTION\fR for supported statistics.
393 393 .RE
394 394
395 395 .sp
396 396 .ne 2
397 397 .na
398 398 \fB\fB-h\fR\fR
399 399 .ad
400 400 .RS 12n
401 401 Display help message.
402 402 .RE
403 403
404 404 .sp
405 405 .ne 2
406 406 .na
407 407 \fB\fB-o\fR\fR
408 408 .ad
409 409 .RS 12n
410 410 Report statistics to a file instead of the standard output.
411 411 .RE
412 412
413 413 .sp
414 414 .ne 2
415 415 .na
416 416 \fB\fB-s\fR\fR
417 417 .ad
418 418 .RS 12n
419 419 Display data with a specified separator (default: 2 spaces).
420 420 .RE
421 421
422 422 .sp
423 423 .ne 2
424 424 .na
425 425 \fB\fB-x\fR\fR
426 426
427 427 .ad
428 428 .RS 12n
429 429 Print extended stats (same as -f time,mfu,mru,mfug,mrug,eskip,mtxmis,rmis,dread,pread,read).
430 430 .RE
431 431
432 432 .sp
433 433 .ne 2
434 434 .na
435 435 \fB\fB-v\fR\fR
436 436 .ad
437 437 .RS 12n
438 438 Show field headers and definitions
439 439 .RE
440 440
441 441 .SH OPERANDS
442 442 .sp
443 443 .LP
444 444 The following operands are supported:
445 445 .sp
446 446 .ne 2
447 447 .na
448 448 \fB\fIcount\fR\fR
449 449 .ad
450 450 .RS 12n
451 451 Display only \fIcount\fR reports.
452 452 .RE
|
↓ open down ↓ |
452 lines elided |
↑ open up ↑ |
453 453
454 454 .sp
455 455 .ne 2
456 456 .na
457 457 \fB\fIinterval\fR\fR
458 458 .ad
459 459 .RS 12n
460 460 Specify the sampling interval in seconds.
461 461 .RE
462 462
463 -.SH AUTHORS
463 +.SH AUTHORS
464 464 .sp
465 465 .LP
466 466 arcstat was originally written by Neelakanth Nadgir and supported only ZFS ARC statistics.
467 467 Mike Harsch updated it to support L2ARC statistics.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX