Listing Basic ZFS Information

You can list basic dataset information by using the zfs list command with no options. This command displays the names of all datasets on the system and the values of their used, available, referenced, and mountpoint properties. For more information about these properties, see Introducing ZFS Properties.

For example:

$ zfs list
users                   2.00G  64.9G    32K  /users
users/home              2.00G  64.9G    35K  /users/home
users/home/kaydo         548K  64.9G   548K  /users/home/kaydo
users/home/mork         1.00G  64.9G  1.00G  /users/home/mork
users/home/nneke        1.00G  64.9G  1.00G  /users/home/nneke

You can also use this command to display specific datasets by providing the dataset name on the command line. Additionally, use the -r option to recursively display all descendents of that dataset. For example:

$ zfs list -t all -r users/home/mork
NAME                        USED  AVAIL  REFER  MOUNTPOINT
users/home/mork            1.00G  64.9G  1.00G  /users/home/mork
users/home/mork@yesterday      0      -  1.00G  -
users/home/mork@today          0      -  1.00G  -

You can use the zfs list command with the mount point of a file system. For example:

$ zfs list /user/home/mork
NAME              USED  AVAIL  REFER  MOUNTPOINT
users/home/mork  1.00G  64.9G  1.00G  /users/home/mork

The following example shows how to display basic information about tank/home/gina and all of its descendent file systems:

$ zfs list -r users/home/gina
NAME                           USED  AVAIL  REFER  MOUNTPOINT
users/home/gina               2.00G  62.9G    32K  /users/home/gina
users/home/gina/projects      2.00G  62.9G    33K  /users/home/gina/projects
users/home/gina/projects/fs1  1.00G  62.9G  1.00G  /users/home/gina/projects/fs1
users/home/gina/projects/fs2  1.00G  62.9G  1.00G  /users/home/gina/projects/fs2

For additional information about the zfs list command, see the see zfs(8) man page.