List ZFS datasets and space usage
Build a paste-ready command, then review its compatibility and effects before running it.
zfs list -o name,used,avail,refer,mountpointread-onlyno known side effects Compatibility
LinuxVerified for Linux using posix, bash, zsh syntax.
Operational knowledgereview due 2027-01-20
Requirementszfszfs must be installed and available on PATH.
Version supportzfs Current supported releasesVerified for linux using posix, bash, zsh syntax; consult compatibility notes for platform-specific differences.
Expected signalsNAME USED AVAIL REFER MOUNTPOINTRepresentative successful output; values vary with the selected target and system state.
Known errorszfs: command not foundzfs is missing or is not available on PATH.
Verifyzfs list -o name,used,avail,refer,mountpointThe output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01zfsCommandRuns the zfs stage of this one-liner.
02listArgumentPasses list to zfs.
03-oOptionSelects an output file or output format for this command.
04name,used,avail,refer,mountpointArgumentPasses name,used,avail,refer,mountpoint to zfs.
Example input
zfs list -o name,used,avail,refer,mountpoint
Example output
NAME USED AVAIL REFER MOUNTPOINT
tank 312G 580G 96K /tank
tank/data 210G 580G 210G /tank/data
Illustrative output — exact values vary by system and data.
Official sources