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

FreeBSD Manual Pages

  
 
  

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

NAME
     zfs-userspace -- Displays space consumed by, and quotas on, each user or
     group in the specified filesystem or snapshot.

SYNOPSIS
     zfs userspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
	 [-t type[,type]...] filesystem|snapshot
     zfs groupspace [-Hinp] [-o	field[,field]...] [-s field]...	[-S field]...
	 [-t type[,type]...] filesystem|snapshot
     zfs projectspace [-Hp] [-o	field[,field]...] [-s field]...	[-S field]...
	 filesystem|snapshot

DESCRIPTION
     zfs userspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
       [-t type[,type]...] filesystem|snapshot
       Displays	space consumed by, and quotas on, each user in the specified
       filesystem or snapshot.	This corresponds to the	userused@user,
       userobjused@user, userquota@user, and userobjquota@user properties.

       -H  Do not print	headers, use tab-delimited output.

       -S field
	   Sort	by this	field in reverse order.	 See -s.

       -i  Translate SID to POSIX ID.  The POSIX ID may	be ephemeral if	no
	   mapping exists.  Normal POSIX interfaces (for example, stat(2), ls
	   -l) perform this translation, so the	-i option allows the output
	   from	zfs userspace to be compared directly with those utilities.
	   However, -i may lead	to confusion if	some files were	created	by an
	   SMB user before a SMB-to-POSIX name mapping was established.	 In
	   such	a case,	some files will	be owned by the	SMB entity and some by
	   the POSIX entity.  However, the -i option will report that the
	   POSIX entity	has the	total usage and	quota for both.

       -n  Print numeric ID instead of user/group name.

       -o field[,field]...
	   Display only	the specified fields from the following	set: type,
	   name, used, quota.  The default is to display all fields.

       -p  Use exact (parsable)	numeric	output.

       -s field
	   Sort	output by this field.  The -s and -S flags may be specified
	   multiple times to sort first	by one field, then by another.	The
	   default is -s type -s name.

       -t type[,type]...
	   Print only the specified types from the following set: all,
	   posixuser, smbuser, posixgroup, smbgroup.  The default is -t
	   posixuser,smbuser.  The default can be changed to include group
	   types.

     zfs groupspace [-Hinp] [-o	field[,field]...] [-s field]...	[-S field]...
       [-t type[,type]...] filesystem|snapshot
       Displays	space consumed by, and quotas on, each group in	the specified
       filesystem or snapshot.	This subcommand	is identical to	userspace, ex-
       cept that the default types to display are -t posixgroup,smbgroup.

     zfs projectspace [-Hp] [-o	field[,field]...] [-s field]...	[-S field]...
       filesystem|snapshot
       Displays	space consumed by, and quotas on, each project in the speci-
       fied filesystem or snapshot. This subcommand is identical to userspace,
       except that the project identifier is numeral, not name.	So need	nei-
       ther the	option -i for SID to POSIX ID nor -n for numeric ID, nor -t
       for types.

SEE ALSO
     zfs-set(8), zfsprops(8)

FreeBSD	13.0			 June 30, 2019			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help