Forrest logo
back to the zfs tool

zfs:tldr:348ef

zfs: List all available zfs filesystems.
$ zfs list
try on your machine

The command "zfs list" is used to display a list of all ZFS datasets on a system. ZFS (Zettabyte File System) is an advanced file system and volume manager originally developed by Sun Microsystems and now owned by Oracle Corporation.

When you run the "zfs list" command, it retrieves information about the existing ZFS datasets, such as their names, sizes, used and available space, mount points, and other properties. The output of the command is typically displayed in a tabular format, making it easier to read and analyze.

Here's a breakdown of the columns commonly seen in the output of "zfs list":

  • NAME: This column shows the name of the ZFS dataset.
  • USED: It represents the amount of space used by the dataset, including all its child datasets and any snapshots.
  • AVAIL: Denotes the amount of space available within the dataset.
  • REFER: This column indicates the amount of space used by the dataset itself, excluding any child datasets or snapshots.
  • MOUNTPOINT: It displays the mount point where the dataset is mounted in the file system hierarchy.
  • TYPE: Specifies the type of the dataset, such as filesystem, volume, or snapshot.

Additional columns may include properties like compression ratios, creation time, and other specific dataset attributes.

By running "zfs list", you can get an overview of the existing ZFS datasets on your system, their sizes, and other relevant information, which can be helpful for management, troubleshooting, and monitoring purposes.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the zfs tool