Archive-Team
/
zfs
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 103 Wiki Activity

Merge 69b3be36ad into 9e15877dfb

This commit is contained in:
Shawn Bayern 2024-08-21 22:02:06 -04:00 committed by GitHub
parent 9e15877dfb 69b3be36ad
commit d34fd94755
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 27 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
man/man8/zfs-list.8
View File

@ -49,27 +49,25 @@
.Oo Ar filesystem Ns | Ns Ar volume Ns | Ns Ar snapshot Oc Ns …
.
.Sh DESCRIPTION
If specified, you can list property information by the absolute pathname or the
relative pathname.
By default, all file systems and volumes are displayed.
By default, all file systems and volumes are displayed, with the following
fields:
.Sy name , Sy used , Sy available , Sy referenced , Sy mountpoint .
Snapshots are displayed if the
.Sy listsnapshots
pool property is
.Sy on
.Po the default is
.Sy off
.Pc ,
.Pc
or if the
.Fl t Sy snapshot
or
.Fl t Sy all
options are specified.
The following fields are displayed:
.Sy name , Sy used , Sy available , Sy referenced , Sy mountpoint .
.Bl -tag -width "-H"
.It Fl H
Used for scripting mode.
Do not print headers and separate fields by a single tab instead of arbitrary
Do not print headers, and separate fields by a single tab instead of arbitrary
white space.
.It Fl j Op Ar --json-int
Print the output in JSON format.
@ -86,7 +84,7 @@ of
will display only the dataset and its direct children.
.It Fl o Ar property
A comma-separated list of properties to display.
The property must be:
Each property must be:
.Bl -bullet -compact
.It
One of the properties described in the
@ -124,30 +122,41 @@ section of
or the value
.Sy name
to sort by the dataset name.
Multiple properties can be specified at one time using multiple
Multiple properties can be specified to operate together using multiple
.Fl s
property options.
or
.Fl S
options.
Multiple
.Fl s
options are evaluated from left to right in decreasing order of importance.
The following is a list of sorting criteria:
and
.Fl S
options are evaluated from left to right to supply sort keys in
decreasing order of priority.
Property types operate as follows:
.Bl -bullet -compact
.It
Numeric types sort in numeric order.
.It
String types sort in alphabetical order.
.It
Types inappropriate for a row sort that row to the literal bottom, regardless of
the specified ordering.
Types inappropriate for a row sort that row to the literal bottom,
regardless of the specified ordering.
.El
.Pp
If no sorting options are specified the existing behavior of
.Nm zfs Cm list
is preserved.
If no sort columns are specified, or if two lines of output would sort
equally across all specified columns, then datasets and bookmarks are
sorted by name, whereas snapshots are sorted first by the name of their
dataset and then by the time of their creation.
When no sort columns are specified but snapshots are listed, this
default behavior causes snapshots to be grouped under their datasets in
chronological order by creation time.
.It Fl S Ar property
Same as
.Fl s ,
but sorts by property in descending order.
but sorts by
.Ar property
in descending order.
.It Fl t Ar type
A comma-separated list of types to display, where
.Ar type