mirror_zfs/man/man8
Shawn Bayern 8604e67dc9 Add description of default sorting behavior to zfs_list.8
The sorting logic is all in cmd/zfs/zfs_iter.c.  I borrowed
where I could from the comments in the source code, but please
note that the comment to zfs_sort() is a little imprecise, or at
least incomplete, because it doesn't give any indication of the
chronological sort that will be used by default for snapshots in
zfs_compare().

While adding this description, I took the liberty to copy-edit
the rest of the file lightly.

In those edits, I've removed "If specified, you can list
property information by the absolute pathname or the relative
pathname" because, in context, it seems more confusing than
helpful.

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: George Melikov <mail@gmelikov.ru>
Reviewed-by: Tony Hutter <hutter2@llnl.gov>
Reviewed-by: Rob Norris <robn@despairlabs.com>
Signed-off-by: Shawn Bayern <sbayern@law.fsu.edu>
Closes #15713
Closes #15869
2025-09-09 17:03:55 -07:00
..
.gitignore Add zfs_prepare_disk script for disk firmware install 2023-09-21 08:36:26 -07:00
fsck.zfs.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
mount.zfs.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
vdev_id.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zdb.8 zdb: better handling for corrupt block pointers 2025-08-12 14:16:37 -07:00
zed.8.in Harmonize on American spelling in several places 2025-03-24 14:36:34 -07:00
zfs_ids_to_path.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs_prepare_disk.8.in SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-allow.8 Correct "umount" to "unmount" in a couple of places 2025-03-24 14:37:36 -07:00
zfs-bookmark.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-change-key.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-clone.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-create.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-destroy.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-diff.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-get.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-groupspace.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-hold.8 Capitalize in various places where appropriate 2025-03-24 14:37:34 -07:00
zfs-inherit.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-jail.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-list.8 Add description of default sorting behavior to zfs_list.8 2025-09-09 17:03:55 -07:00
zfs-load-key.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-mount-generator.8.in SPDX: license tags: MIT 2025-03-13 17:56:54 -07:00
zfs-mount.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-program.8 zfs-program(8): document zfs.sync.clone() 2025-06-10 14:53:18 -07:00
zfs-project.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-projectspace.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-promote.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-receive.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-recv.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-redact.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-release.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-rename.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-rewrite.8 Implement physical rewrites 2025-08-06 10:36:56 -07:00
zfs-rollback.8 zfs-rollback.8: fix typo in example number 2025-04-28 15:38:08 -04:00
zfs-send.8 zfs-send.8: mention combination of -c/-e flags and zstd_compress feature 2025-08-19 10:56:58 -04:00
zfs-set.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-share.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-snapshot.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-unallow.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-unjail.8 Add FreeBSD jail support hooks 2019-12-11 11:58:37 -08:00
zfs-unload-key.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-unmount.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-unzone.8 Add Linux namespace delegation support 2022-06-10 09:51:46 -07:00
zfs-upgrade.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-userspace.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-wait.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-zone.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs.8 Introduce zfs rewrite subcommand (#17246) 2025-05-12 10:22:17 -07:00
zgenhostid.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zinject.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool_influxdb.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-add.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-attach.8 Harmonize on American spelling in several places 2025-03-24 14:36:34 -07:00
zpool-checkpoint.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-clear.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-create.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-ddtprune.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-destroy.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-detach.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-events.8 metaslab: don't pass whole zio to throttle reserve APIs 2025-07-04 23:22:22 -04:00
zpool-export.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-get.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-history.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-import.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-initialize.8 zpool/zfs: Add '-a|--all' option to scrub, trim, initialize 2025-07-29 14:50:44 -07:00
zpool-iostat.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-labelclear.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-list.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-offline.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-online.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-prefetch.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-reguid.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-remove.8 Harmonize on American spelling in several places 2025-03-24 14:36:34 -07:00
zpool-reopen.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-replace.8 Harmonize on American spelling in several places 2025-03-24 14:36:34 -07:00
zpool-resilver.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-scrub.8 Add TXG timestamp database 2025-08-06 10:31:21 -07:00
zpool-set.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-split.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-status.8 Refactor man page and CLI help output per mandoc 2025-05-23 09:10:30 -07:00
zpool-sync.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-trim.8 zpool/zfs: Add '-a|--all' option to scrub, trim, initialize 2025-07-29 14:50:44 -07:00
zpool-upgrade.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-wait.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool.8 Capitalize in various places where appropriate 2025-03-24 14:37:34 -07:00
zstream.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zstreamdump.8 zstreamdump: replace with link to zstream 2021-05-21 10:16:14 -07:00