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

# [NAME](#NAME)

`zfs-userspace` — display space and quotas of ZFS dataset

# [SYNOPSIS](#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](#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@**](#userused@)*user*, [**userobjused@**](#userobjused@)*user*, [**userquota@**](#userquota@)*user*, and [**userobjquota@**](#userobjquota@)*user* properties.

[`-H`](#H)

Do not print headers, use tab-delimited output.

[`-S`](#S) `field`

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

[`-i`](#i)

Translate SID to POSIX ID. The POSIX ID may be ephemeral if no mapping exists. Normal POSIX interfaces (like [stat(2)](/man/os/zfs/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`](#n)

Print numeric ID instead of user/group name.

[`-o`](#o) `field`\[,`field`]…

Display only the specified fields from the following set: **type**, **name**, [**used**](#used), [**quota**](#quota). The default is to display all fields.

[`-p`](#p)

Use exact (parsable) numeric output.

[`-s`](#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`](#t) `type`\[,`type`]…

Print only the specified types from the following set: [**all**](#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](#SEE_ALSO)

[zfsprops(7)](/man/os/zfs/zfsprops.7), [zfs-set(8)](/man/os/zfs/zfs-set.8)

July 11, 2022 OpenZFS

---

Document: zfs-userspace(8) from zfs 2.4.4-r3 (Chainguard OS)
Source: https://github.com/openzfs/zfs