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

NAME
     zfs-userspace - display space and quotas of ZFS dataset

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

DESCRIPTION
     zfs userspace [-Hinp] [-o field[,field]<?>] [-s field]<?> [-S field]<?>
       [-t type[,type]<?>] filesystem|snapshot|path
       Displays space consumed by, and quotas on, each user in the specified
       filesystem, snapshot, or path.  If a path is given, the filesystem that
       contains that path will be used.  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 (like 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,
       except that the default types to display are -t posixgroup,smbgroup.

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

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

FreeBSD 13.1-RELEASE-p6          June 30, 2019         FreeBSD 13.1-RELEASE-p6