zarcsummary.1

ZARCSUMMARY(1) General Commands Manual ZARCSUMMARY(1)

zarcsummary — print ZFS ARC and subsystem statistics

zarcsummary [-adghr] [-p page] [-s section]

zarcsummary collects statistics from the running kernel and prints a human-readable report on the state of the ZFS Adaptive Replacement Cache (ARC) and several related subsystems. The output is a snapshot; for periodic sampling, use zarcstat(1) instead.

When invoked without arguments, zarcsummary prints all sections in sequence. A single section may be selected with the -s option.

The report is organized into the following sections:

Current and target ARC sizes, the split between the Most Recently Used (MRU) and Most Frequently Used (MFU) lists, overall hit and miss ratios, compression savings, and whether the ARC is experiencing memory pressure.
Breakdown of ARC hits and misses by demand reads versus prefetches and data versus metadata.
Data Management Unit predictive prefetcher statistics, including stream hits, misses, and I/O issued ahead of and behind the current stream.
Level-2 ARC statistics for any cache devices attached to imported pools. This section only appears when an L2ARC device is present and covers bytes read and written, hit rates, and eviction activity.
Solaris Porting Layer memory allocator statistics. This section is only available on Linux.
Current values of kernel tunables that govern ARC behavior, including zfs_arc_max and zfs_arc_min. Combining this section with -d adds a brief explanation of each tunable.
ZFS Intent Log statistics: committed transaction counts, flush requests to stable storage, and the byte-level split between normal vdevs and any separate log (SLOG) device.

, --alternate
Use an alternate layout for the tunables and SPL sections.
, --description
Print a short description next to each tunable and SPL entry.
, --help
Display a help message.
, --graph
Print an ASCII graph of current ARC use and exit.
page, --page page
Print a section by its legacy page number. ; use -s instead.
, --raw
Dump all available data with minimal formatting.
section, --section section
Print only the named section. See DESCRIPTION for the list of valid section names.

Statistics are read from /proc/spl/kstat/zfs/.
FreeBSD
Statistics are read via sysctl(3) from the vfs.zfs and kstat.zfs.misc trees. The py-sysctl package must be installed for zarcsummary to function.

The zarcsummary utility exits 0 on success, and >0 if an error occurs.

Print the full report:

# zarcsummary

Display only ARC size and hit rate information:

# zarcsummary -s arc

Show a visual overview of ARC health:

# zarcsummary -g

Search for all statistics containing “hit”:

# zarcsummary -r | grep hit

Review all tunables with their descriptions:

# zarcsummary -d -s tunables

zarcstat(1), zpool-status(8)

zarcsummary originated as a Perl script called arc_summary, written by Ben Rockwood in 2008 for Solaris. Martin Matuska ported it to FreeBSD in 2010, and Jason J. Hellenthal took over maintenance. Scot W. Stevenson contributed a full rewrite in Python 3 in 2017, introducing the -g, -r, and -s options along with the section-based output layout. The tool was renamed from arc_summary to zarcsummary in 2025 to align with the OpenZFS command naming convention.

This manual page was written by Christos Longros <chris.longros@gmail.com>.

March 14, 2026 Debian