Man page - zfs-userspace(8)
Manual
ZFS-USERSPACE (8) 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) OpenZFS June 30, 2019 ZFS-USERSPACE (8)