ZARCSTAT(1)
💖 ZARCSTAT(1) 💖
okay so bestie, welcome to zarcstat, a General Commands Manual page, section 1, and honestly? it's giving "I know exactly what my ARC is doing and I'm not afraid to say it". let's get into it 🦋
✨ NAME ✨
zarcstat — report ZFS ARC and L2ARC statistics. that's it, that's the whole job, and she does it flawlessly 💅
🌸 SYNOPSIS 🌸
zarcstat [-havxp] [-f field[,field…]] [-o file] [-s string] [interval]
[count]🎀 DESCRIPTION 🎀
so zarcstat prints a whole buffet of ZFS ARC and L2ARC statistics, and the vibe is very much vmstat-like — same energy, same format, same "I could stare at this scrolling forever" energy. here's the full roster of what she can show you, no skips, no cuts, every single one 🫶
c— ARC target sizedh%— Demand hit percentagedi%— Demand I/O hit percentagedm%— Demand miss percentageddh%— Demand data hit percentageddi%— Demand data I/O hit percentageddm%— Demand data miss percentagedmh%— Demand metadata hit percentagedmi%— Demand metadata I/O hit percentagedmm%— Demand metadata miss percentagemfu— MFU list hits per secondmh%— Metadata hit percentagemi%— Metadata I/O hit percentagemm%— Metadata miss percentagemru— MRU list hits per secondph%— Prefetch hits percentagepi%— Prefetch I/O hits percentagepm%— Prefetch miss percentagepdh%— Prefetch data hits percentagepdi%— Prefetch data I/O hits percentagepdm%— Prefetch data miss percentagepmh%— Prefetch metadata hits percentagepmi%— Prefetch metadata I/O hits percentagepmm%— Prefetch metadata miss percentagedhit— Demand hits per seconddioh— Demand I/O hits per seconddmis— Demand misses per secondddhit— Demand data hits per secondddioh— Demand data I/O hits per secondddmis— Demand data misses per seconddmhit— Demand metadata hits per seconddmioh— Demand metadata I/O hits per seconddmmis— Demand metadata misses per secondhit%— ARC hit percentagehits— ARC hits per secondioh%— ARC I/O hits percentageiohs— ARC I/O hits per secondmfug— MFU ghost list hits per secondmhit— Metadata hits per secondmioh— Metadata I/O hits per secondmiss— ARC misses per secondmmis— Metadata misses per secondmrug— MRU ghost list hits per secondphit— Prefetch hits per secondpioh— Prefetch I/O hits per secondpmis— Prefetch misses per secondpdhit— Prefetch data hits per secondpdioh— Prefetch data I/O hits per secondpdmis— Prefetch data misses per secondpmhit— Prefetch metadata hits per secondpmioh— Prefetch metadata I/O hits per secondpmmis— Prefetch metadata misses per secondread— Total ARC accesses per secondtime— Current timesize— ARC sizearcsz— Alias for sizeunc— Uncached list hits per seconddread— Demand accesses per secondddread— Demand data accesses per seconddmread— Demand metadata accesses per secondeskip—evict_skipper secondmiss%— ARC miss percentagemread— Metadata accesses per secondpread— Prefetch accesses per secondpdread— Prefetch data accesses per secondpmread— Prefetch metadata accesses per secondl2hit%— L2ARC access hit percentagel2hits— L2ARC hits per secondl2miss— L2ARC misses per secondl2read— Total L2ARC accesses per secondl2pref— L2ARC prefetch allocated size per secondl2pref%— L2ARC prefetch allocated size percentagel2mfu— L2ARC MFU allocated size per secondl2mfu%— L2ARC MFU allocated size percentagel2mru— L2ARC MRU allocated size per secondl2mru%— L2ARC MRU allocated size percentagel2data— L2ARC data (buf content) allocated size per secondl2data%— L2ARC data (buf content) allocated size percentagel2meta— L2ARC metadata (buf content) allocated size per secondl2meta%— L2ARC metadata (buf content) allocated size percentagel2size— Size of the L2ARCmtxmis—mutex_missper secondl2bytes— Bytes read per second from the L2ARCl2wbytes— Bytes written per second to the L2ARCl2miss%— L2ARC access miss percentagel2asize— Actual (compressed) size of the L2ARCcmpsz— Compressed sizecmpsz%— Compressed size percentageovhsz— Overhead sizeovhsz%— Overhead size percentagebonsz— Bonus sizebonsz%— Bonus size percentagednosz— Dnode sizednosz%— Dnode size percentagedbusz— Dbuf sizedbusz%— Dbuf size percentagehdrsz— Header sizehdrsz%— Header size percentagel2hsz— L2 header sizel2hsz%— L2 header size percentageabdsz— ABD chunk waste sizeabdsz%— ABD chunk waste size percentagedatatg— ARC data targetdatatg%— ARC data target percentagedatasz— ARC data sizedatasz%— ARC data size percentagemetatg— ARC metadata targetmetatg%— ARC metadata target percentagemetasz— ARC metadata sizemetasz%— ARC metadata size percentageanosz— Anonymous sizeanosz%— Anonymous size percentageanoda— Anonymous data sizeanoda%— Anonymous data size percentageanome— Anonymous metadata sizeanome%— Anonymous metadata size percentageanoed— Anonymous evictable data sizeanoed%— Anonymous evictable data size percentageanoem— Anonymous evictable metadata sizeanoem%— Anonymous evictable metadata size percentagemfutg— MFU targetmfutg%— MFU target percentagemfudt— MFU data targetmfudt%— MFU data target percentagemfumt— MFU metadata targetmfumt%— MFU metadata target percentagemfusz— MFU sizemfusz%— MFU size percentagemfuda— MFU data sizemfuda%— MFU data size percentagemfume— MFU metadata sizemfume%— MFU metadata size percentagemfued— MFU evictable data sizemfued%— MFU evictable data size percentagemfuem— MFU evictable metadata sizemfuem%— MFU evictable metadata size percentagemfugsz— MFU ghost sizemfugd— MFU ghost data sizemfugm— MFU ghost metadata sizemrutg— MRU targetmrutg%— MRU target percentagemrudt— MRU data targetmrudt%— MRU data target percentagemrumt— MRU metadata targetmrumt%— MRU metadata target percentagemrusz— MRU sizemrusz%— MRU size percentagemruda— MRU data sizemruda%— MRU data size percentagemrume— MRU metadata sizemrume%— MRU metadata size percentagemrued— MRU evictable data sizemrued%— MRU evictable data size percentagemruem— MRU evictable metadata sizemruem%— MRU evictable metadata size percentagemrugsz— MRU ghost sizemrugd— MRU ghost data sizemrugm— MRU ghost metadata sizeuncsz— Uncached sizeuncsz%— Uncached size percentageuncda— Uncached data sizeuncda%— Uncached data size percentageuncme— Uncached metadata sizeuncme%— Uncached metadata size percentageunced— Uncached evictable data sizeunced%— Uncached evictable data size percentageuncem— Uncached evictable metadata sizeuncem%— Uncached evictable metadata size percentagegrow— ARC grow disabledneed— ARC reclaim neededfree— The ARC's idea of how much free memory there is, which includes evictable memory in the page cache. Since the ARC tries to keepavailabove zero,availis usually more instructive to observe thanfree.avail— The ARC's idea of how much free memory is available to it, which is a bit less thanfree. May temporarily be negative, in which case the ARC will reduce the target sizec.
ngl the last two are the ones you'll actually be refreshing on repeat like a group chat at 2am. avail? main character. ✨
🔥 OPTIONS 🔥
-a— Print all possible stats. the "give me everything" button, no notes 💅-f— Display only specific fields. See “DESCRIPTION” for supported statistics.-h— Display help message.-o— Report statistics to a file instead of the standard output.-p— Disable auto-scaling of numerical fields (for raw, machine-parsable values).-s— Display data with a specified separator (default: 2 spaces).-x— Print extended stats (same as-f time,mfu,mru,mfug,mrug,eskip,mtxmis,dread,pread,read).-v— Show field headers and definitions
🦋 OPERANDS 🦋
The following operands are supported:
interval— Specify the sampling interval in seconds.count— Display onlycountreports.
🌈 SEE ALSO 🌈
nothing listed here, bestie — this page is a solo act and she's thriving 👑
and that's the whole page, fr fr. stay hydrated, watch your hit percentages, and remember: your ARC is not being dramatic, it's just managing memory 💜
this page comes to you from OpenZFS, dated September 19, 2024 — thanks for reading my little manual, ily, bye 🎀
📦 where this page comes from
- alpine 3.23: zfs-doc 2.4.4-r0 · CDDL-1.0
- alpine 3.24: zfs-doc 2.4.4-r0 · CDDL-1.0
- nixos 26.05: zfs-user 2.4.4
- nixpkgs unstable: zfs-user 2.4.4
- ubuntu resolute: zfsutils-linux 2.4.1-1ubuntu5 · CDDL-1.0
- ubuntu resolute: zfsutils-linux 2.4.1-1ubuntu5.1 · CDDL-1.0
- ubuntu stonking: zfsutils-linux 2.4.4-1ubuntu4 · CDDL-1.0
- 📜 the page's license: CDDL-1.0
- Copyright 2014 Adam Stevko. All rights reserved
- Copyright (c) 2015 by Delphix. All rights reserved
- Copyright (c) 2020 by AJ Jordan. All rights reserved
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms