zfsa-list(1)

Datasets, volumes, snapshots and bookmarks

ZFS Assistant 0.7.0

NAME

zfsa-list - Datasets, volumes, snapshots and bookmarks

SYNOPSIS

zfsa list [GLOBAL OPTIONS] [-t|--type] [-r|--recursive] [-o|--columns] [-s|--sort] [-S|--sort-descending] [-h|--help] [OBJECT]

DESCRIPTION

Datasets, volumes, snapshots and bookmarks

OPTIONS

-t, --type <TYPES>

What to list (filesystems and volumes by default)

Possible values:

  • filesystem: Filesystems

  • volume: Volumes

  • snapshot: Snapshots

  • bookmark: Bookmarks

  • all: All of them

-r, --recursive

Include what is inside the object

-o, --columns <COLUMNS>

The columns, separated by commas

Possible values:

  • name: The name

  • used: Space used

  • avail: Space available

  • refer: Space referenced

  • mountpoint: Where it is mounted

  • snapshots: How many snapshots it has

  • policy: The snapshot policy

  • encryption: The encryption

  • created: When it was created

  • holds: The hold tags of a snapshot

  • kept-for: What a snapshot is kept for

-s, --sort <SORT>

Sort ascending by a column

Possible values:

  • name: The name

  • used: Space used

  • avail: Space available

  • refer: Space referenced

  • mountpoint: Where it is mounted

  • snapshots: How many snapshots it has

  • policy: The snapshot policy

  • encryption: The encryption

  • created: When it was created

  • holds: The hold tags of a snapshot

  • kept-for: What a snapshot is kept for

-S, --sort-descending <SORT_DESCENDING>

Sort descending by a column

Possible values:

  • name: The name

  • used: Space used

  • avail: Space available

  • refer: Space referenced

  • mountpoint: Where it is mounted

  • snapshots: How many snapshots it has

  • policy: The snapshot policy

  • encryption: The encryption

  • created: When it was created

  • holds: The hold tags of a snapshot

  • kept-for: What a snapshot is kept for

-h, --help

Print help (see a summary with '-h')

[OBJECT]

A pool, dataset, snapshot or bookmark, or everything when left out

EXAMPLES

Every filesystem and volume:

zfsa list

The snapshots below tank/photos, newest first:

zfsa list tank/photos -r -t snapshot -S created

Chosen columns as exact numbers for a script:

zfsa --parsable list tank -r -o name,used,avail

SEE ALSO

zfsa(1) for the global options, authorization, confirmations and exit status.