Lines Matching +full:data +full:- +full:active

1 .\" SPDX-License-Identifier: CDDL-1.0
9 .\" usr/src/OPENSOLARIS.LICENSE or https://opensource.org/licenses/CDDL-1.0.
27 .Nm zpool-features
31 ZFS pool on-disk format versions are specified via
33 which replace the old on-disk format numbers
34 .Pq the last supported on-disk format number is 28 .
38 .Sy feature Ns @ Ns Ar feature-name
48 Since most features can be enabled independently of each other, the on-disk
50 .Sy active
57 .Ar com.example : Ns Ar feature-name .
71 .Ar com.example : Ns Ar feature-name
73 .Ar feature-name
80 .Bl -tag -width "disabled"
81 .It Sy active
82 This feature's on-disk format changes are in effect on the pool.
83 Support for this feature is required to import the pool in read-write mode.
84 If this feature is not read-only compatible,
85 support is also required to import the pool in read-only mode
86 .Pq see Sx Read-only compatibility .
89 feature's on-disk format changes have not been made yet.
91 but changes may be made to the on-disk format at any time
93 .Sy active
98 .Sy active .
99 See feature-specific documentation for details.
101 This feature's on-disk format changes have not been made and will not be made
109 .Sy feature Ns @ Ns Ar short-name .
111 .Ss Read-only compatibility
112 Some features may make on-disk format changes that do not interfere with other
115 .Dq read-only compatible .
116 If all unsupported features on a pool are read-only compatible,
117 the pool can be imported in read-only mode by setting the
121 .Xr zpool-import 8
128 .Sy unsupported Ns @ Ns Ar feature-name
131 .Bl -tag -width "readonly"
135 state and therefore the pool's on-disk
138 The feature is read-only compatible and the pool has been imported in
139 read-only mode.
148 specific on-disk format, by enabling and disabling particular features.
160 When set to a comma-separated list of filenames
188 .Nm zpool Cm set Sy feature Ns @ Ns Ar feature-name Ns = Ns Sy enabled .
189 This setting also prevents pools from being upgraded to newer on-disk versions.
212 which might not be recognized by the currently-installed binaries.
220 .Bd -literal -compact -offset 4n
246 .No example# Nm cat Pa /usr/share/zfs/compatibility.d/grub2-2.06
253 # This file lists all read-only compatible features except
275 .Xr zpool-create 8
277 .Xr zpool-upgrade 8
282 .Bl -tag -compact -width "READ-ONLY COMPATIBLE"
294 .It READ-ONLY COMPATIBLE
301 .No This feature becomes Sy active No as soon as it is enabled \
321 .Po see Xr zfs-set 8 Pc .
323 .Sy active
337 .Bl -tag -width Ds
342 .Sy active
352 Destroying a file system requires traversing all of its data in order to
363 is enabled, the file system's data will be reclaimed by a background process,
375 .Sy active
378 is non-zero.
385 .checksum-spiel blake3
391 It is much faster than copying the data (as the actual data is neither read nor
401 .Sy active
408 mistakenly stored as arrays of 8 single-byte entries instead of single
409 8-byte entries, making pools non-endian-safe.
413 When active, new BRT entries are stored in the correct endian-safe format.
421 .Sy active
431 .Sy active
444 .Sy active
464 This two-phase approach will take longer than a healing resilver
471 .Sy active
479 command to remove top-level vdevs,
483 .Sy active
487 on a top-level vdev, and will never return to being
494 dRAID is a variant of RAID-Z which provides integrated distributed
495 hot spares that allow faster resilvering while retaining the benefits of RAID-Z.
496 Data, parity, and spare space are organized in redundancy groups
500 .Sy active
514 This feature becomes active when a gang header is written that is larger than
517 .Xr zpool-upgrade 8 .
521 This feature enables the use of the Edon-R hash algorithm for checksum,
524 a block whose checksum matches the data being written will be ignored
526 In an abundance of caution, Edon-R requires verification when used with
529 .Po see Xr zfs-set 8 Pc .
531 Edon-R is a very high-performance hash algorithm that was part
532 of the NIST SHA-3 competition.
534 .Pq over 350% faster than SHA-256 ,
538 in ZFS, which means that the checksum is pre-seeded with a secret
539 256-bit random key
541 before being fed the data block to be checksummed.
545 .checksum-spiel edonr
549 highly-compressible blocks.
553 When this feature is enabled, the contents of highly-compressible blocks are
558 the compressed data, rather than a pointer to its location on disk
562 is saved, and no additional I/O is needed to read and write the data block.
564 \*[instant-never]
576 This feature allows us to create each bpobj on-demand,
580 .Sy active
587 This has no user-visible impact, but other features may depend on this feature.
590 .Sy active
598 .Sy active
608 .Sy active
618 This feature allows more flexible use of internal ZFS data structures,
622 .Sy active
633 .Sy active
639 This feature enables the upgraded version of errlog, which required an on-disk
650 \*[instant-never]
672 The most common case of hole-filled objects is zvols.
703 \*[instant-never]
705 .feature org.open-zfs large_blocks no extensible_dataset
709 .Sy active
720 .Sy active
730 Large dnodes allow more data to be stored in the bonus buffer,
738 .Sy active
757 .Sy active
761 This feature improves performance for heavily-fragmented pools,
762 especially when workloads are heavy in random-writes.
766 \*[instant-never]
779 .Sy active
787 is a high-performance real-time compression algorithm that
794 compression is approximately 50% faster on compressible data and 200% faster
795 on incompressible data than
807 .Xr zfs-set 8
813 \*[instant-never]
834 .Sy active ,
837 .Sy active
850 .Sy active
853 command is used on a top-level vdev, and will never return to being
866 .Sy active
878 The project ID is an object-based attribute.
883 .Pq via Nm chattr Sy [+-]P No or Nm zfs Cm project Fl s Ns | Ns Fl C .
893 .Sy active
896 \*[remount-upgrade]
901 subcommand to attach a new device to a RAID-Z group, expanding the total
904 .Xr zpool-attach 8 .
912 .Xr zfs-send 8 .
921 .Xr zfs-send 8 .
927 .Sy active
933 .Xr zfs-send 8 .
942 .Sy active
948 This feature enables the use of the SHA-512/256 truncated hash algorithm
949 .Pq FIPS 180-4
951 The native 64-bit arithmetic of SHA-512 provides an approximate 50%
952 performance boost over SHA-256 on 64-bit hardware
953 and is thus a good minimum-change replacement candidate
959 .checksum-spiel sha512
963 Skein is a high-performance secure hash algorithm that was a
964 finalist in the NIST SHA-3 competition.
965 It provides a very high security margin and high performance on 64-bit hardware
966 .Pq 80% faster than SHA-256 .
968 functionality in ZFS, which means that the checksum is pre-seeded with a
969 secret 256-bit random key
971 before being fed the data block to be checksummed.
975 .checksum-spiel skein
993 space more efficiently on-disk while also increasing their maximum
997 .Sy active
1007 \*[instant-never]
1008 \*[remount-upgrade]
1013 This feature becomes active after the next
1025 .Sy root-0 .
1039 .Sy active
1051 .Sy active
1061 is a high-performance compression algorithm that features a
1084 .Po see Xr zfs-set 8 Pc .
1086 .Sy active