Editor
241
edits
(→Feature Flags Implementation: Updating OS X) |
Grahamperrin (talk | contribs) (Clarity (recent misunderstanding about version 28); Wayback Machine for a blog post that is no longer served by illumos; a FreeBSD manual page that is not version-specific) |
||
Line 1: | Line 1: | ||
ZFS on-disk formats were originally versioned with a single number, which increased whenever the format changed. The numbered approach was suitable when development of ZFS was driven by Oracle alone. | |||
For distributed development of OpenZFS, version numbering was unsuitable. Any change to the number would have required agreement, across all implementations, of each change to the on-disk format. | |||
OpenZFS feature flags – an alternative to traditional version numbering – allow '''a uniquely named ''pool property'' for each change to the on-disk format'''. This approach supports: | |||
* format changes that are independent | |||
* format changes that depend on each other. | |||
== | == Compatibility == | ||
Where all ''features'' that are used by a pool are supported by multiple implementations of OpenZFS, the on-disk format is portable across those implementations. | |||
Features that are exclusive when enabled should be periodically ported to all distributions. | |||
== Reference materials == | |||
[http://web.archive.org/web/20160419064650/http://blog.delphix.com/csiden/files/2012/01/ZFS_Feature_Flags.pdf ''ZFS Feature Flags''] (Christopher Siden, 2012-01, in the Internet Archive Wayback Machine) in particular: "… Legacy version numbers still exist for pool versions 1-28 …". | |||
[http://illumos.org/man/5/zpool-features <tt>zpool-features</tt>](5) – illumos | |||
[https://www.freebsd.org/cgi/man.cgi?query=zpool-features&sektion=7&manpath=FreeBSD <tt>zpool-features</tt>](7) – FreeBSD | |||
== Feature flags implementation == | |||
{| class="wikitable" | {| class="wikitable" | ||
Line 139: | Line 153: | ||
* yes = implemented | * yes = implemented | ||
Source: [http://blog.vx.sk/archives/44-OpenZFS-Feature-Flags-Compatibility-Matrix.html ''OpenZFS Feature Flags Compatibility Matrix - VX weblog''] |