8980 BIOS clock is sometimes one hour fast
[unleashed.git] / usr / src / man / man1m / arcstat.1m
blobf65095fe57dc52a4f229d5172d15b94d59aa5bd1
1 .\"
2 .\" This file and its contents are supplied under the terms of the
3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 .\" You may only use this file in accordance with the terms of version
5 .\" 1.0 of the CDDL.
6 .\"
7 .\" A full copy of the text of the CDDL should have accompanied this
8 .\" source.  A copy of the CDDL is also available via the Internet at
9 .\" http://www.illumos.org/license/CDDL.
10 .\"
11 .\"
12 .\" Copyright 2014 Adam Stevko.  All rights reserved.
13 .\" Copyright (c) 2015 by Delphix. All rights reserved.
14 .\"
15 .TH ARCSTAT 1M "Feb 4, 2014"
16 .SH NAME
17 arcstat \- report ZFS ARC and L2ARC statistics
18 .SH SYNOPSIS
19 .LP
20 .nf
21 \fBarcstat\fR [\fB-hvxr\fR] [\fB-f field[,field]...\fR] [\fB-o file\fR] [\fB-s string\fR] 
22       [\fBinterval\fR [\fBcount\fR]]
23 .fi
25 .SH DESCRIPTION
26 .LP
27 The \fBarcstat\fR utility print various ZFS ARC and L2ARC statistics in
28 vmstat-like fashion.
29 .sp
31 .sp
32 .LP
33 The \fBarcstat\fR command reports the following information:
34 .sp
35 .ne 2
37 .\"
38 .sp
39 .ne 1 
40 .na
41 \fBc \fR
42 .ad
43 .RS 14n
44 ARC Target Size
45 .RE
47 .sp
48 .ne 2
49 .na
50 \fBdh% \fR
51 .ad
52 .RS 14n
53 Demand Data hit percentage
54 .RE
56 .sp
57 .ne 2
58 .na
59 \fBdm% \fR
60 .ad
61 .RS 14n
62 Demand Data miss percentage
63 .RE
65 .sp
66 .ne 2
67 .na
68 \fBmfu \fR
69 .ad
70 .RS 14n
71 MFU List hits per second
72 .RE
74 .sp
75 .ne 2
76 .na
77 \fBmh% \fR
78 .ad
79 .RS 14n
80 Metadata hit percentage
81 .RE
83 .sp
84 .ne 2
85 .na
86 \fBmm% \fR
87 .ad
88 .RS 14n
89 Metadata miss percentage
90 .RE
92 .sp
93 .ne 2
94 .na
95 \fBmru \fR
96 .ad
97 .RS 14n
98 MRU List hits per second
99 .RE
102 .ne 2
104 \fBph% \fR
106 .RS 14n
107 Prefetch hits percentage
111 .ne 2
113 \fBpm% \fR
115 .RS 14n
116 Prefetch miss percentage
120 .ne 2
122 \fBdhit \fR
124 .RS 14n
125 Demand Data hits per second
129 .ne 2
131 \fBdmis \fR
133 .RS 14n
134 Demand Data misses per second
138 .ne 2
140 \fBhit% \fR
142 .RS 14n
143 ARC Hit percentage
147 .ne 2
149 \fBhits \fR
151 .RS 14n
152 ARC reads per second
156 .ne 2
158 \fBmfug \fR
160 .RS 14n
161 MFU Ghost List hits per second
165 .ne 2
167 \fBmhit \fR
169 .RS 14n
170 Metadata hits per second
174 .ne 2
176 \fBmiss \fR
178 .RS 14n
179 ARC misses per second
183 .ne 2
185 \fBmmis \fR
187 .RS 14n
188 Metadata misses per second
192 .ne 2
194 \fBmrug \fR
196 .RS 14n
197 MRU Ghost List hits per second
201 .ne 2
203 \fBphit \fR
205 .RS 14n
206 Prefetch hits per second
210 .ne 2
212 \fBpmis \fR
214 .RS 14n
215 Prefetch misses per second
219 .ne 2
221 \fBread \fR
223 .RS 14n
224 Total ARC accesses per second
228 .ne 2
230 \fBtime \fR
232 .RS 14n
233 Time
237 .ne 2
239 \fBarcsz \fR
241 .RS 14n
242 ARC Size
246 .ne 2
248 \fBdread \fR
250 .RS 14n
251 Demand data accesses per second
255 .ne 2
257 \fBeskip \fR
259 .RS 14n
260 evict_skip per second
264 .ne 2
266 \fBmiss% \fR
268 .RS 14n
269 ARC miss percentage
273 .ne 2
275 \fBmread \fR
277 .RS 14n
278 Metadata accesses per second
282 .ne 2
284 \fBpread \fR
286 .RS 14n
287 Prefetch accesses per second
291 .ne 2
293 \fBl2hit% \fR
295 .RS 14n
296 L2ARC access hit percentage
300 .ne 2
302 \fBl2hits \fR
304 .RS 14n
305 L2ARC hits per second
309 .ne 2
311 \fBl2miss \fR
313 .RS 14n
314 L2ARC misses per second
318 .ne 2
320 \fBl2read \fR
322 .RS 14n
323 Total L2ARC accesses per second
327 .ne 2
329 \fBl2size \fR
331 .RS 14n
332 Size of the L2ARC
336 .ne 2
338 \fBmtxmis \fR
340 .RS 14n
341 mutex_miss per second
345 .ne 2
347 \fBl2bytes \fR
349 .RS 14n
350 bytes read per second from the L2ARC
354 .ne 2
356 \fBl2miss% \fR
358 .RS 14n
359 L2ARC access miss percentage
363 .ne 2
365 \fBl2asize \fR
367 .RS 14n
368 Actual (compressed) size of the L2ARC
372 .SH OPTIONS
374 The following options are supported:
377 .ne 2
379 \fB\fB-f\fR\fR
381 .RS 12n
382 Display only specific fields. See \fBDESCRIPTION\fR for supported statistics.
386 .ne 2
388 \fB\fB-h\fR\fR
390 .RS 12n
391 Display help message.
395 .ne 2
397 \fB\fB-o\fR\fR
399 .RS 12n
400 Report statistics to a file instead of the standard output.
404 .ne 2
406 \fB\fB-s\fR\fR
408 .RS 12n
409 Display data with a specified separator (default: 2 spaces).
413 .ne 2
415 \fB\fB-x\fR\fR
418 .RS 12n
419 Print extended stats (same as -f time,mfu,mru,mfug,mrug,eskip,mtxmis,dread,pread,read).
423 .ne 2
425 \fB\fB-v\fR\fR
427 .RS 12n
428 Show field headers and definitions
431 .SH OPERANDS
433 The following operands are supported:
435 .ne 2
437 \fB\fIcount\fR\fR
439 .RS 12n
440 Display only \fIcount\fR reports.
444 .ne 2
446 \fB\fIinterval\fR\fR
448 .RS 12n
449 Specify the sampling interval in seconds.
452 .SH AUTHORS
454 arcstat was originally written by Neelakanth Nadgir and supported only ZFS ARC statistics.
455 Mike Harsch updated it to support L2ARC statistics.