freebsd-dev/man/man8
Colm 658fb8020f
Add "compatibility" property for zpool feature sets
Property to allow sets of features to be specified; for compatibility
with specific versions / releases / external systems. Influences
the behavior of 'zpool upgrade' and 'zpool create'. Initial man
page changes and test cases included.

Brief synopsis:

zpool create -o compatibility=off|legacy|file[,file...] pool vdev...

compatibility = off : disable compatibility mode (enable all features)
compatibility = legacy : request that no features be enabled
compatibility = file[,file...] : read features from specified files.
Only features present in *all* files will be enabled on the
resulting pool. Filenames may be absolute, or relative to
/etc/zfs/compatibility.d or /usr/share/zfs/compatibility.d (/etc
checked first).

Only affects zpool create, zpool upgrade and zpool status.

ABI changes in libzfs:

* New function "zpool_load_compat" to load and parse compat sets.
* Add "zpool_compat_status_t" typedef for compatibility parse status.
* Add ZPOOL_PROP_COMPATIBILITY to the pool properties enum
* Add ZPOOL_STATUS_COMPATIBILITY_ERR to the pool status enum

An initial set of base compatibility sets are included in
cmd/zpool/compatibility.d, and the Makefile for cmd/zpool is
modified to install these in $pkgdatadir/compatibility.d and to
create symbolic links to a reasonable set of aliases.

Reviewed-by: ericloewe
Reviewed-by: Matthew Ahrens <mahrens@delphix.com>
Reviewed-by: Richard Laager <rlaager@wiktel.com>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Colm Buckley <colm@tuatha.org>
Closes #11468
2021-02-17 21:30:45 -08:00
..
.gitignore Ignore *.o.ur-safe build artifacts 2018-05-13 18:59:02 -07:00
fsck.zfs.8 man: Canonicalize .TH usage 2020-08-24 21:25:28 -07:00
Makefile.am Add zpool_influxdb command 2020-10-09 09:29:21 -07:00
mount.zfs.8 man: Canonicalize .TH usage 2020-08-24 21:25:28 -07:00
vdev_id.8 man: Canonicalize .TH usage 2020-08-24 21:25:28 -07:00
zdb.8 Add zdb -r <dataset> <object-id | file> <output> 2021-01-27 21:36:01 -08:00
zed.8.in Replace ZFS on Linux references with OpenZFS 2020-10-08 20:10:13 -07:00
zfs_ids_to_path.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-allow.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-bookmark.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-change-key.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-clone.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-create.8 Add -u option to 'zfs create' 2020-12-04 14:01:42 -08:00
zfs-destroy.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-diff.8 Fix trivial typo in zfs-diff.8 2020-12-03 10:18:26 -08: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 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-inherit.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-jail.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-list.8 zfs-list.8: clarify listing snapshots 2021-02-04 09:56:28 -08:00
zfs-load-key.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-mount-generator.8.in man: Canonicalize .TH usage 2020-08-24 21:25:28 -07:00
zfs-mount.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-program.8 Fix a man page link in zfs-program.8 2021-01-26 16:17:11 -08:00
zfs-project.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-projectspace.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-promote.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-receive.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -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 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-rollback.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-send.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-set.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-share.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-snapshot.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -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-upgrade.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-userspace.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs-wait.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zfs.8 Add the Xr's to the SEE ALSO as well 2020-08-26 22:29:00 -07:00
zfsconcepts.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfsprops.8 zfsprops.8: fix mispluralisation in "Default values is" 2021-01-24 15:57:51 -08:00
zgenhostid.8 zgenhostid: accept hostid arguments equal to zero. 2020-11-14 17:20:54 -08:00
zinject.8 man: Canonicalize .TH usage 2020-08-24 21:25:28 -07:00
zpool_influxdb.8 Add zpool_influxdb command 2020-10-09 09:29:21 -07:00
zpool-add.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-attach.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-checkpoint.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-clear.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-create.8 Add "compatibility" property for zpool feature sets 2021-02-17 21:30:45 -08:00
zpool-destroy.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-detach.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-events.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-export.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-get.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-history.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-import.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-initialize.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-iostat.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-labelclear.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-list.8 zpool(8): fix pool-wi[sd]e typo 2020-11-16 09:26:16 -08:00
zpool-offline.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-online.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-reguid.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-remove.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-reopen.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-replace.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-resilver.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-scrub.8 Distributed Spare (dRAID) Feature 2020-11-13 13:51:51 -08:00
zpool-set.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-split.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-status.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-sync.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-trim.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool-upgrade.8 Add "compatibility" property for zpool feature sets 2021-02-17 21:30:45 -08:00
zpool-wait.8 Properly format NAME subsection of zfs/zpool subcommands 2020-10-22 11:28:10 -07:00
zpool.8 Replace ZFS on Linux references with OpenZFS 2020-10-08 20:10:13 -07:00
zpoolconcepts.8 Distributed Spare (dRAID) Feature 2020-11-13 13:51:51 -08:00
zpoolprops.8 Add "compatibility" property for zpool feature sets 2021-02-17 21:30:45 -08:00
zstream.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zstreamdump.8 man: Canonicalize .TH usage 2020-08-24 21:25:28 -07:00