tail head cat sleep
QR code linking to this page

Manual Pages  — ZFS-USERSPACE

NAME

zfs-userspace – display space and quotas of ZFS dataset

CONTENTS

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 (likestat(2), ls) perform this translation, so the -i option allows the output from zfs 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)

ZFS-USERSPACE (8) June 30, 2019

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.