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/cindy 548K 64.9G 548K /users/home/cindy users/home/mark 1.00G 64.9G 1.00G /users/home/mark users/home/neil 1.00G 64.9G 1.00G /users/home/neil
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/mark NAME USED AVAIL REFER MOUNTPOINT users/home/mark 1.00G 64.9G 1.00G /users/home/mark users/home/mark@yesterday 0 - 1.00G - users/home/mark@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/mark NAME USED AVAIL REFER MOUNTPOINT users/home/mark 1.00G 64.9G 1.00G /users/home/mark
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 zfs(1M).