Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZFS-LIST(8)		FreeBSD	System Manager's Manual		   ZFS-LIST(8)

NAME
     zfs-list -- list properties of ZFS	datasets

SYNOPSIS
     zfs list [-r|-d depth] [-Hp] [-o property[,property]a|] [-s property]a|
	 [-S property]a| [-t type[,type]a|] [filesystem|volume|snapshot]a|

DESCRIPTION
     If	specified, you can list	property information by	the absolute pathname
     or	the relative pathname.	By default, all	file systems and volumes are
     displayed.	 Snapshots are displayed if the	listsnapshots pool property is
     on	(the default is	off), or if the	-t snapshot or -t all options are
     specified.	 The following fields are displayed: name, used, available,
     referenced, mountpoint.

     -H	 Used for scripting mode.  Do not print	headers	and separate fields by
	 a single tab instead of arbitrary white space.

     -S	property
	 Same as the -s	option,	but sorts by property in descending order.

     -d	depth
	 Recursively display any children of the dataset, limiting the recur-
	 sion to depth.	 A depth of 1 will display only	the dataset and	its
	 direct	children.

     -o	property
	 A comma-separated list	of properties to display.  The property	must
	 be:
	 o   One of the	properties described in	the Native Properties section
	     of	zfsprops(7)
	 o   A user property
	 o   The value name to display the dataset name
	 o   The value space to	display	space usage properties on file systems
	     and volumes.  This	is a shortcut for specifying
	     -o	name,avail,used,usedsnap,usedds,usedrefreserv,usedchild	-t
	     filesystem,volume.

     -p	 Display numbers in parsable (exact) values.

     -r	 Recursively display any children of the dataset on the	command	line.

     -s	property
	 A property for	sorting	the output by column in	ascending order	based
	 on the	value of the property.	The property must be one of the	prop-
	 erties	described in the Properties section of zfsprops(7) or the
	 value name to sort by the dataset name.  Multiple properties can be
	 specified at one time using multiple -s property options.  Multiple
	 -s options are	evaluated from left to right in	decreasing order of
	 importance.  The following is a list of sorting criteria:
	 o   Numeric types sort	in numeric order.
	 o   String types sort in alphabetical order.
	 o   Types inappropriate for a row sort	that row to the	literal	bot-
	     tom, regardless of	the specified ordering.

	 If no sorting options are specified the existing behavior of zfs list
	 is preserved.

     -t	type
	 A comma-separated list	of types to display, where type	is one of
	 filesystem, snapshot, volume, bookmark, or all.  For example, speci-
	 fying -t snapshot displays only snapshots.

SEE ALSO
     zfsprops(7), zfs-get(8)

FreeBSD	13.0			 May 27, 2021			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zfs-list&sektion=8&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help