Ubuntu 22.04 integration: mancheck
Correct new mandoc errors. ``` STYLE: input text line longer than 80 bytes STYLE: no blank before trailing delimiter ``` Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov> Reviewed-by: Richard Yao <richard.yao@alumni.stonybrook.edu> Reviewed-by: George Melikov <mail@gmelikov.ru> Signed-off-by: szubersk <szuberskidamian@gmail.com> Closes #14148
This commit is contained in:
parent
a5087965fe
commit
b46be903fb
|
@ -134,7 +134,8 @@ ARC grow disabled
|
||||||
.It Sy need
|
.It Sy need
|
||||||
ARC reclaim needed
|
ARC reclaim needed
|
||||||
.It Sy free
|
.It Sy free
|
||||||
The ARC's idea of how much free memory there is, which includes evictable memory in the page cache.
|
The ARC's idea of how much free memory there is, which includes evictable memory
|
||||||
|
in the page cache.
|
||||||
Since the ARC tries to keep
|
Since the ARC tries to keep
|
||||||
.Sy avail
|
.Sy avail
|
||||||
above zero,
|
above zero,
|
||||||
|
@ -142,7 +143,8 @@ above zero,
|
||||||
is usually more instructive to observe than
|
is usually more instructive to observe than
|
||||||
.Sy free .
|
.Sy free .
|
||||||
.It Sy avail
|
.It Sy avail
|
||||||
The ARC's idea of how much free memory is available to it, which is a bit less than
|
The ARC's idea of how much free memory is available to it, which is a bit less
|
||||||
|
than
|
||||||
.Sy free .
|
.Sy free .
|
||||||
May temporarily be negative, in which case the ARC will reduce the target size
|
May temporarily be negative, in which case the ARC will reduce the target size
|
||||||
.Sy c .
|
.Sy c .
|
||||||
|
|
|
@ -99,7 +99,8 @@ one directory.
|
||||||
The options specified on the command line or in a
|
The options specified on the command line or in a
|
||||||
.Ar runfile
|
.Ar runfile
|
||||||
apply to individual tests in the group.
|
apply to individual tests in the group.
|
||||||
The exception is options pertaining to pre and post scripts, which act on all tests as a group.
|
The exception is options pertaining to pre and post scripts, which act on all
|
||||||
|
tests as a group.
|
||||||
Rather than running before and after each test,
|
Rather than running before and after each test,
|
||||||
these scripts are run only once each at the start and end of the test group.
|
these scripts are run only once each at the start and end of the test group.
|
||||||
.Ss Test Execution
|
.Ss Test Execution
|
||||||
|
@ -254,7 +255,7 @@ Execute the post script as
|
||||||
.
|
.
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
.Bl -tag -width "-h"
|
.Bl -tag -width "-h"
|
||||||
.It Sy Example 1 : No Running ad-hoc tests.
|
.It Sy Example 1 : No Running ad-hoc tests .
|
||||||
This example demonstrates the simplest invocation of
|
This example demonstrates the simplest invocation of
|
||||||
.Nm .
|
.Nm .
|
||||||
.Bd -literal
|
.Bd -literal
|
||||||
|
@ -270,7 +271,7 @@ Running Time: 00:00:07
|
||||||
Percent passed: 100.0%
|
Percent passed: 100.0%
|
||||||
Log directory: /var/tmp/test_results/20120923T180654
|
Log directory: /var/tmp/test_results/20120923T180654
|
||||||
.Ed
|
.Ed
|
||||||
.It Sy Example 2 : No Creating a Ar runfile No for future use.
|
.It Sy Example 2 : No Creating a Ar runfile No for future use .
|
||||||
This example demonstrates creating a
|
This example demonstrates creating a
|
||||||
.Ar runfile
|
.Ar runfile
|
||||||
with non-default options.
|
with non-default options.
|
||||||
|
|
|
@ -100,7 +100,8 @@ feature is now required to read the pool MOS.
|
||||||
.Cm label repair
|
.Cm label repair
|
||||||
.Ar device
|
.Ar device
|
||||||
.Xc
|
.Xc
|
||||||
Repair corrupted labels by rewriting the checksum using the presumed valid contents of the label.
|
Repair corrupted labels by rewriting the checksum using the presumed valid
|
||||||
|
contents of the label.
|
||||||
.El
|
.El
|
||||||
.
|
.
|
||||||
.Sh GLOBAL OPTIONS
|
.Sh GLOBAL OPTIONS
|
||||||
|
|
|
@ -114,15 +114,15 @@ Print a help summary.
|
||||||
Number of vdevs.
|
Number of vdevs.
|
||||||
.It Fl s , -vdev-size Ns = (default: Sy 64M )
|
.It Fl s , -vdev-size Ns = (default: Sy 64M )
|
||||||
Size of each vdev.
|
Size of each vdev.
|
||||||
.It Fl a , -alignment-shift Ns = (default: Sy 9 ) No (use Sy 0 No for random)
|
.It Fl a , -alignment-shift Ns = (default: Sy 9 ) No (use Sy 0 No for random )
|
||||||
Alignment shift used in test.
|
Alignment shift used in test.
|
||||||
.It Fl m , -mirror-copies Ns = (default: Sy 2 )
|
.It Fl m , -mirror-copies Ns = (default: Sy 2 )
|
||||||
Number of mirror copies.
|
Number of mirror copies.
|
||||||
.It Fl r , -raid-disks Ns = (default: Sy 4 No for raidz/ Ns Sy 16 No for draid)
|
.It Fl r , -raid-disks Ns = (default: Sy 4 No for raidz/ Ns Sy 16 No for draid )
|
||||||
Number of raidz/draid disks.
|
Number of raidz/draid disks.
|
||||||
.It Fl R , -raid-parity Ns = (default: Sy 1 )
|
.It Fl R , -raid-parity Ns = (default: Sy 1 )
|
||||||
Raid parity (raidz & draid).
|
Raid parity (raidz & draid).
|
||||||
.It Fl K , -raid-kind Ns = Ns Sy raidz Ns | Ns Sy draid Ns | Ns Sy random No (default: Sy random )
|
.It Fl K , -raid-kind Ns = Ns Sy raidz Ns | Ns Sy draid Ns | Ns Sy random No (default : Sy random )
|
||||||
The kind of RAID config to use.
|
The kind of RAID config to use.
|
||||||
With
|
With
|
||||||
.Sy random
|
.Sy random
|
||||||
|
@ -159,7 +159,8 @@ Max loops in
|
||||||
.It Fl B , -alt-ztest Ns =
|
.It Fl B , -alt-ztest Ns =
|
||||||
Path to alternate ("older")
|
Path to alternate ("older")
|
||||||
.Nm ztest
|
.Nm ztest
|
||||||
to drive, which will be used to initialise the pool, and, a stochastic half the time, to run the tests.
|
to drive, which will be used to initialise the pool, and, a stochastic half the
|
||||||
|
time, to run the tests.
|
||||||
The parallel
|
The parallel
|
||||||
.Pa lib
|
.Pa lib
|
||||||
directory is prepended to
|
directory is prepended to
|
||||||
|
@ -168,7 +169,7 @@ i.e. given
|
||||||
.Fl B Pa ./chroots/lenny/usr/bin/ Ns Nm ,
|
.Fl B Pa ./chroots/lenny/usr/bin/ Ns Nm ,
|
||||||
.Pa ./chroots/lenny/usr/lib
|
.Pa ./chroots/lenny/usr/lib
|
||||||
will be loaded.
|
will be loaded.
|
||||||
.It Fl C , -vdev-class-state Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy random No (default: Sy random )
|
.It Fl C , -vdev-class-state Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy random No (default : Sy random )
|
||||||
The vdev allocation class state.
|
The vdev allocation class state.
|
||||||
.It Fl o , -option Ns = Ns Ar variable Ns = Ns Ar value
|
.It Fl o , -option Ns = Ns Ar variable Ns = Ns Ar value
|
||||||
Set global
|
Set global
|
||||||
|
|
|
@ -177,7 +177,8 @@ This is used to control
|
||||||
how quickly taskqs ramp up the number of threads processing the queue.
|
how quickly taskqs ramp up the number of threads processing the queue.
|
||||||
Because Linux thread creation and destruction are relatively inexpensive a
|
Because Linux thread creation and destruction are relatively inexpensive a
|
||||||
small default value has been selected.
|
small default value has been selected.
|
||||||
This means that normally threads will be created aggressively which is desirable.
|
This means that normally threads will be created aggressively which is
|
||||||
|
desirable.
|
||||||
Increasing this value will
|
Increasing this value will
|
||||||
result in a slower thread creation rate which may be preferable for some
|
result in a slower thread creation rate which may be preferable for some
|
||||||
configurations.
|
configurations.
|
||||||
|
|
|
@ -354,7 +354,8 @@ When a vdev is added, target this number of metaslabs per top-level vdev.
|
||||||
Default limit for metaslab size.
|
Default limit for metaslab size.
|
||||||
.
|
.
|
||||||
.It Sy zfs_vdev_max_auto_ashift Ns = Ns Sy 14 Pq uint
|
.It Sy zfs_vdev_max_auto_ashift Ns = Ns Sy 14 Pq uint
|
||||||
Maximum ashift used when optimizing for logical \[->] physical sector size on new
|
Maximum ashift used when optimizing for logical \[->] physical sector size on
|
||||||
|
new
|
||||||
top-level vdevs.
|
top-level vdevs.
|
||||||
May be increased up to
|
May be increased up to
|
||||||
.Sy ASHIFT_MAX Po 16 Pc ,
|
.Sy ASHIFT_MAX Po 16 Pc ,
|
||||||
|
@ -397,7 +398,8 @@ Note, that both this many milliseconds and
|
||||||
TXGs must pass before unloading will occur.
|
TXGs must pass before unloading will occur.
|
||||||
.
|
.
|
||||||
.It Sy reference_history Ns = Ns Sy 3 Pq uint
|
.It Sy reference_history Ns = Ns Sy 3 Pq uint
|
||||||
Maximum reference holders being tracked when reference_tracking_enable is active.
|
Maximum reference holders being tracked when reference_tracking_enable is
|
||||||
|
active.
|
||||||
.
|
.
|
||||||
.It Sy reference_tracking_enable Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
.It Sy reference_tracking_enable Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
||||||
Track reference holders to
|
Track reference holders to
|
||||||
|
@ -425,7 +427,8 @@ may wish to specify a more realistic inflation factor,
|
||||||
particularly if they operate close to quota or capacity limits.
|
particularly if they operate close to quota or capacity limits.
|
||||||
.
|
.
|
||||||
.It Sy spa_load_print_vdev_tree Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
.It Sy spa_load_print_vdev_tree Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
||||||
Whether to print the vdev tree in the debugging message buffer during pool import.
|
Whether to print the vdev tree in the debugging message buffer during pool
|
||||||
|
import.
|
||||||
.
|
.
|
||||||
.It Sy spa_load_verify_data Ns = Ns Sy 1 Ns | Ns 0 Pq int
|
.It Sy spa_load_verify_data Ns = Ns Sy 1 Ns | Ns 0 Pq int
|
||||||
Whether to traverse data blocks during an "extreme rewind"
|
Whether to traverse data blocks during an "extreme rewind"
|
||||||
|
@ -655,7 +658,8 @@ which indicates that a percentage based on
|
||||||
.Sy zfs_arc_meta_limit_percent
|
.Sy zfs_arc_meta_limit_percent
|
||||||
of the ARC may be used for metadata.
|
of the ARC may be used for metadata.
|
||||||
.Pp
|
.Pp
|
||||||
This value my be changed dynamically, except that must be set to an explicit value
|
This value my be changed dynamically, except that must be set to an explicit
|
||||||
|
value
|
||||||
.Pq cannot be set back to Sy 0 .
|
.Pq cannot be set back to Sy 0 .
|
||||||
.
|
.
|
||||||
.It Sy zfs_arc_meta_limit_percent Ns = Ns Sy 75 Ns % Pq u64
|
.It Sy zfs_arc_meta_limit_percent Ns = Ns Sy 75 Ns % Pq u64
|
||||||
|
@ -778,7 +782,7 @@ If nonzero, this will update
|
||||||
with the new value.
|
with the new value.
|
||||||
.Sy arc_p_min_shift No is used as a shift of Sy arc_c
|
.Sy arc_p_min_shift No is used as a shift of Sy arc_c
|
||||||
when calculating the minumum
|
when calculating the minumum
|
||||||
.Sy arc_p No size.
|
.Sy arc_p No size .
|
||||||
.
|
.
|
||||||
.It Sy zfs_arc_p_dampener_disable Ns = Ns Sy 1 Ns | Ns 0 Pq int
|
.It Sy zfs_arc_p_dampener_disable Ns = Ns Sy 1 Ns | Ns 0 Pq int
|
||||||
Disable
|
Disable
|
||||||
|
@ -851,7 +855,8 @@ milliseconds during mapping generation.
|
||||||
Intended for use with the test suite to throttle vdev removal speed.
|
Intended for use with the test suite to throttle vdev removal speed.
|
||||||
.
|
.
|
||||||
.It Sy zfs_condense_indirect_obsolete_pct Ns = Ns Sy 25 Ns % Pq uint
|
.It Sy zfs_condense_indirect_obsolete_pct Ns = Ns Sy 25 Ns % Pq uint
|
||||||
Minimum percent of obsolete bytes in vdev mapping required to attempt to condense
|
Minimum percent of obsolete bytes in vdev mapping required to attempt to
|
||||||
|
condense
|
||||||
.Pq see Sy zfs_condense_indirect_vdevs_enable .
|
.Pq see Sy zfs_condense_indirect_vdevs_enable .
|
||||||
Intended for use with the test suite
|
Intended for use with the test suite
|
||||||
to facilitate triggering condensing as needed.
|
to facilitate triggering condensing as needed.
|
||||||
|
@ -864,7 +869,8 @@ if the mapping uses more than
|
||||||
bytes of memory and if the obsolete space map object uses more than
|
bytes of memory and if the obsolete space map object uses more than
|
||||||
.Sy zfs_condense_max_obsolete_bytes
|
.Sy zfs_condense_max_obsolete_bytes
|
||||||
bytes on-disk.
|
bytes on-disk.
|
||||||
The condensing process is an attempt to save memory by removing obsolete mappings.
|
The condensing process is an attempt to save memory by removing obsolete
|
||||||
|
mappings.
|
||||||
.
|
.
|
||||||
.It Sy zfs_condense_max_obsolete_bytes Ns = Ns Sy 1073741824 Ns B Po 1 GiB Pc Pq u64
|
.It Sy zfs_condense_max_obsolete_bytes Ns = Ns Sy 1073741824 Ns B Po 1 GiB Pc Pq u64
|
||||||
Only attempt to condense indirect vdev mappings if the on-disk size
|
Only attempt to condense indirect vdev mappings if the on-disk size
|
||||||
|
@ -991,7 +997,8 @@ will result in objects waiting when there is not actually contention on the
|
||||||
same object.
|
same object.
|
||||||
.
|
.
|
||||||
.It Sy zfs_slow_io_events_per_second Ns = Ns Sy 20 Ns /s Pq int
|
.It Sy zfs_slow_io_events_per_second Ns = Ns Sy 20 Ns /s Pq int
|
||||||
Rate limit delay and deadman zevents (which report slow I/O operations) to this many per
|
Rate limit delay and deadman zevents (which report slow I/O operations) to this
|
||||||
|
many per
|
||||||
second.
|
second.
|
||||||
.
|
.
|
||||||
.It Sy zfs_unflushed_max_mem_amt Ns = Ns Sy 1073741824 Ns B Po 1 GiB Pc Pq u64
|
.It Sy zfs_unflushed_max_mem_amt Ns = Ns Sy 1073741824 Ns B Po 1 GiB Pc Pq u64
|
||||||
|
@ -1059,7 +1066,8 @@ Files containing more than
|
||||||
will be deleted asynchronously, while smaller files are deleted synchronously.
|
will be deleted asynchronously, while smaller files are deleted synchronously.
|
||||||
Decreasing this value will reduce the time spent in an
|
Decreasing this value will reduce the time spent in an
|
||||||
.Xr unlink 2
|
.Xr unlink 2
|
||||||
system call, at the expense of a longer delay before the freed space is available.
|
system call, at the expense of a longer delay before the freed space is
|
||||||
|
available.
|
||||||
This only applies on Linux.
|
This only applies on Linux.
|
||||||
.
|
.
|
||||||
.It Sy zfs_dirty_data_max Ns = Pq int
|
.It Sy zfs_dirty_data_max Ns = Pq int
|
||||||
|
@ -1123,7 +1131,7 @@ Write operations are throttled when approaching the limit until log data is
|
||||||
cleared out after transaction group sync.
|
cleared out after transaction group sync.
|
||||||
Because of some overhead, it should be set at least 2 times the size of
|
Because of some overhead, it should be set at least 2 times the size of
|
||||||
.Sy zfs_dirty_data_max
|
.Sy zfs_dirty_data_max
|
||||||
.No to prevent harming normal write throughput.
|
.No to prevent harming normal write throughput .
|
||||||
It also should be smaller than the size of the slog device if slog is present.
|
It also should be smaller than the size of the slog device if slog is present.
|
||||||
.Pp
|
.Pp
|
||||||
Defaults to
|
Defaults to
|
||||||
|
@ -1393,7 +1401,7 @@ _
|
||||||
4096 ZFS_DEBUG_LOG_SPACEMAP Verify that the log summary is consistent with the spacemap log
|
4096 ZFS_DEBUG_LOG_SPACEMAP Verify that the log summary is consistent with the spacemap log
|
||||||
and enable \fBzfs_dbgmsgs\fP for metaslab loading and flushing.
|
and enable \fBzfs_dbgmsgs\fP for metaslab loading and flushing.
|
||||||
.TE
|
.TE
|
||||||
.Sy \& * No Requires debug build.
|
.Sy \& * No Requires debug build .
|
||||||
.
|
.
|
||||||
.It Sy zfs_btree_verify_intensity Ns = Ns Sy 0 Pq uint
|
.It Sy zfs_btree_verify_intensity Ns = Ns Sy 0 Pq uint
|
||||||
Enables btree verification.
|
Enables btree verification.
|
||||||
|
@ -1409,7 +1417,7 @@ lbz r l l .
|
||||||
4 Verify element order. (expensive)
|
4 Verify element order. (expensive)
|
||||||
* 5 Verify unused memory is poisoned. (expensive)
|
* 5 Verify unused memory is poisoned. (expensive)
|
||||||
.TE
|
.TE
|
||||||
.Sy \& * No Requires debug build.
|
.Sy \& * No Requires debug build .
|
||||||
.
|
.
|
||||||
.It Sy zfs_free_leak_on_eio Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
.It Sy zfs_free_leak_on_eio Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
||||||
If destroy encounters an
|
If destroy encounters an
|
||||||
|
@ -1583,7 +1591,8 @@ Once all groups have reached the threshold, all groups are allowed to accept
|
||||||
allocations.
|
allocations.
|
||||||
The default value of
|
The default value of
|
||||||
.Sy 0
|
.Sy 0
|
||||||
disables the feature and causes all metaslab groups to be eligible for allocations.
|
disables the feature and causes all metaslab groups to be eligible for
|
||||||
|
allocations.
|
||||||
.Pp
|
.Pp
|
||||||
This parameter allows one to deal with pools having heavily imbalanced
|
This parameter allows one to deal with pools having heavily imbalanced
|
||||||
vdevs such as would be the case when a new vdev has been added.
|
vdevs such as would be the case when a new vdev has been added.
|
||||||
|
@ -1602,7 +1611,8 @@ If enabled, ZFS will place user data indirect blocks
|
||||||
into the special allocation class.
|
into the special allocation class.
|
||||||
.
|
.
|
||||||
.It Sy zfs_multihost_history Ns = Ns Sy 0 Pq uint
|
.It Sy zfs_multihost_history Ns = Ns Sy 0 Pq uint
|
||||||
Historical statistics for this many latest multihost updates will be available in
|
Historical statistics for this many latest multihost updates will be available
|
||||||
|
in
|
||||||
.Pa /proc/spl/kstat/zfs/ Ns Ao Ar pool Ac Ns Pa /multihost .
|
.Pa /proc/spl/kstat/zfs/ Ns Ao Ar pool Ac Ns Pa /multihost .
|
||||||
.
|
.
|
||||||
.It Sy zfs_multihost_interval Ns = Ns Sy 1000 Ns ms Po 1 s Pc Pq u64
|
.It Sy zfs_multihost_interval Ns = Ns Sy 1000 Ns ms Po 1 s Pc Pq u64
|
||||||
|
@ -1701,7 +1711,7 @@ or other data crawling operations.
|
||||||
.It Sy zfs_per_txg_dirty_frees_percent Ns = Ns Sy 30 Ns % Pq u64
|
.It Sy zfs_per_txg_dirty_frees_percent Ns = Ns Sy 30 Ns % Pq u64
|
||||||
Control percentage of dirtied indirect blocks from frees allowed into one TXG.
|
Control percentage of dirtied indirect blocks from frees allowed into one TXG.
|
||||||
After this threshold is crossed, additional frees will wait until the next TXG.
|
After this threshold is crossed, additional frees will wait until the next TXG.
|
||||||
.Sy 0 No disables this throttle.
|
.Sy 0 No disables this throttle .
|
||||||
.
|
.
|
||||||
.It Sy zfs_prefetch_disable Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
.It Sy zfs_prefetch_disable Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
||||||
Disable predictive prefetch.
|
Disable predictive prefetch.
|
||||||
|
@ -1818,7 +1828,8 @@ A higher number indicates that we care more about how filled in a segment is,
|
||||||
while a lower number indicates we care more about the size of the extent without
|
while a lower number indicates we care more about the size of the extent without
|
||||||
considering the gaps within a segment.
|
considering the gaps within a segment.
|
||||||
This value is only tunable upon module insertion.
|
This value is only tunable upon module insertion.
|
||||||
Changing the value afterwards will have no effect on scrub or resilver performance.
|
Changing the value afterwards will have no effect on scrub or resilver
|
||||||
|
performance.
|
||||||
.
|
.
|
||||||
.It Sy zfs_scan_issue_strategy Ns = Ns Sy 0 Pq uint
|
.It Sy zfs_scan_issue_strategy Ns = Ns Sy 0 Pq uint
|
||||||
Determines the order that data will be verified while scrubbing or resilvering:
|
Determines the order that data will be verified while scrubbing or resilvering:
|
||||||
|
@ -1834,7 +1845,7 @@ By deferring scrubbing of small segments, we may later find adjacent data
|
||||||
to coalesce and increase the segment size.
|
to coalesce and increase the segment size.
|
||||||
.It Sy 0
|
.It Sy 0
|
||||||
.No Use strategy Sy 1 No during normal verification
|
.No Use strategy Sy 1 No during normal verification
|
||||||
.No and strategy Sy 2 No while taking a checkpoint.
|
.No and strategy Sy 2 No while taking a checkpoint .
|
||||||
.El
|
.El
|
||||||
.
|
.
|
||||||
.It Sy zfs_scan_legacy Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
.It Sy zfs_scan_legacy Ns = Ns Sy 0 Ns | Ns 1 Pq int
|
||||||
|
@ -1861,7 +1872,8 @@ This is done until we get below the soft limit.
|
||||||
The fraction of the hard limit used to determined the soft limit for I/O sorting
|
The fraction of the hard limit used to determined the soft limit for I/O sorting
|
||||||
by the sequential scan algorithm.
|
by the sequential scan algorithm.
|
||||||
When we cross this limit from below no action is taken.
|
When we cross this limit from below no action is taken.
|
||||||
When we cross this limit from above it is because we are issuing verification I/O.
|
When we cross this limit from above it is because we are issuing verification
|
||||||
|
I/O.
|
||||||
In this case (unless the metadata scan is done) we stop issuing verification I/O
|
In this case (unless the metadata scan is done) we stop issuing verification I/O
|
||||||
and start scanning metadata again until we get to the hard limit.
|
and start scanning metadata again until we get to the hard limit.
|
||||||
.
|
.
|
||||||
|
@ -1960,7 +1972,8 @@ vdev while discarding the checkpoint.
|
||||||
.
|
.
|
||||||
.It Sy zfs_special_class_metadata_reserve_pct Ns = Ns Sy 25 Ns % Pq uint
|
.It Sy zfs_special_class_metadata_reserve_pct Ns = Ns Sy 25 Ns % Pq uint
|
||||||
Only allow small data blocks to be allocated on the special and dedup vdev
|
Only allow small data blocks to be allocated on the special and dedup vdev
|
||||||
types when the available free space percentage on these vdevs exceeds this value.
|
types when the available free space percentage on these vdevs exceeds this
|
||||||
|
value.
|
||||||
This ensures reserved space is available for pool metadata as the
|
This ensures reserved space is available for pool metadata as the
|
||||||
special vdevs approach capacity.
|
special vdevs approach capacity.
|
||||||
.
|
.
|
||||||
|
@ -1982,7 +1995,8 @@ because these will not be compressed.
|
||||||
The
|
The
|
||||||
.Em 128 KiB
|
.Em 128 KiB
|
||||||
allocations are especially detrimental to performance
|
allocations are especially detrimental to performance
|
||||||
on highly fragmented systems, which may have very few free segments of this size,
|
on highly fragmented systems, which may have very few free segments of this
|
||||||
|
size,
|
||||||
and may need to load new metaslabs to satisfy these allocations.
|
and may need to load new metaslabs to satisfy these allocations.
|
||||||
.
|
.
|
||||||
.It Sy zfs_sync_pass_rewrite Ns = Ns Sy 2 Pq uint
|
.It Sy zfs_sync_pass_rewrite Ns = Ns Sy 2 Pq uint
|
||||||
|
@ -1997,7 +2011,8 @@ will create a maximum of one thread per CPU.
|
||||||
.
|
.
|
||||||
.It Sy zfs_trim_extent_bytes_max Ns = Ns Sy 134217728 Ns B Po 128 MiB Pc Pq uint
|
.It Sy zfs_trim_extent_bytes_max Ns = Ns Sy 134217728 Ns B Po 128 MiB Pc Pq uint
|
||||||
Maximum size of TRIM command.
|
Maximum size of TRIM command.
|
||||||
Larger ranges will be split into chunks no larger than this value before issuing.
|
Larger ranges will be split into chunks no larger than this value before
|
||||||
|
issuing.
|
||||||
.
|
.
|
||||||
.It Sy zfs_trim_extent_bytes_min Ns = Ns Sy 32768 Ns B Po 32 KiB Pc Pq uint
|
.It Sy zfs_trim_extent_bytes_min Ns = Ns Sy 32768 Ns B Po 32 KiB Pc Pq uint
|
||||||
Minimum size of TRIM commands.
|
Minimum size of TRIM commands.
|
||||||
|
@ -2008,7 +2023,8 @@ to negatively impact overall performance.
|
||||||
.
|
.
|
||||||
.It Sy zfs_trim_metaslab_skip Ns = Ns Sy 0 Ns | Ns 1 Pq uint
|
.It Sy zfs_trim_metaslab_skip Ns = Ns Sy 0 Ns | Ns 1 Pq uint
|
||||||
Skip uninitialized metaslabs during the TRIM process.
|
Skip uninitialized metaslabs during the TRIM process.
|
||||||
This option is useful for pools constructed from large thinly-provisioned devices
|
This option is useful for pools constructed from large thinly-provisioned
|
||||||
|
devices
|
||||||
where TRIM operations are slow.
|
where TRIM operations are slow.
|
||||||
As a pool ages, an increasing fraction of the pool's metaslabs
|
As a pool ages, an increasing fraction of the pool's metaslabs
|
||||||
will be initialized, progressively degrading the usefulness of this option.
|
will be initialized, progressively degrading the usefulness of this option.
|
||||||
|
@ -2028,7 +2044,8 @@ more efficient TRIM operations and the delay
|
||||||
before the recently trimmed space is available for use by the device.
|
before the recently trimmed space is available for use by the device.
|
||||||
.Pp
|
.Pp
|
||||||
Increasing this value will allow frees to be aggregated for a longer time.
|
Increasing this value will allow frees to be aggregated for a longer time.
|
||||||
This will result is larger TRIM operations and potentially increased memory usage.
|
This will result is larger TRIM operations and potentially increased memory
|
||||||
|
usage.
|
||||||
Decreasing this value will have the opposite effect.
|
Decreasing this value will have the opposite effect.
|
||||||
The default of
|
The default of
|
||||||
.Sy 32
|
.Sy 32
|
||||||
|
@ -2039,7 +2056,8 @@ Historical statistics for this many latest TXGs will be available in
|
||||||
.Pa /proc/spl/kstat/zfs/ Ns Ao Ar pool Ac Ns Pa /TXGs .
|
.Pa /proc/spl/kstat/zfs/ Ns Ao Ar pool Ac Ns Pa /TXGs .
|
||||||
.
|
.
|
||||||
.It Sy zfs_txg_timeout Ns = Ns Sy 5 Ns s Pq uint
|
.It Sy zfs_txg_timeout Ns = Ns Sy 5 Ns s Pq uint
|
||||||
Flush dirty data to disk at least every this many seconds (maximum TXG duration).
|
Flush dirty data to disk at least every this many seconds (maximum TXG
|
||||||
|
duration).
|
||||||
.
|
.
|
||||||
.It Sy zfs_vdev_aggregate_trim Ns = Ns Sy 0 Ns | Ns 1 Pq uint
|
.It Sy zfs_vdev_aggregate_trim Ns = Ns Sy 0 Ns | Ns 1 Pq uint
|
||||||
Allow TRIM I/O operations to be aggregated.
|
Allow TRIM I/O operations to be aggregated.
|
||||||
|
@ -2094,7 +2112,8 @@ when I/O operations do not immediately follow one another.
|
||||||
.
|
.
|
||||||
.It Sy zfs_vdev_mirror_non_rotating_seek_inc Ns = Ns Sy 1 Pq int
|
.It Sy zfs_vdev_mirror_non_rotating_seek_inc Ns = Ns Sy 1 Pq int
|
||||||
A number by which the balancing algorithm increments the load calculation for
|
A number by which the balancing algorithm increments the load calculation for
|
||||||
the purpose of selecting the least busy mirror member when an I/O operation lacks
|
the purpose of selecting the least busy mirror member when an I/O operation
|
||||||
|
lacks
|
||||||
locality as defined by the
|
locality as defined by the
|
||||||
.Sy zfs_vdev_mirror_rotating_seek_offset .
|
.Sy zfs_vdev_mirror_rotating_seek_offset .
|
||||||
Operations within this that are not immediately following the previous operation
|
Operations within this that are not immediately following the previous operation
|
||||||
|
@ -2208,7 +2227,8 @@ the ZIL to log synchronous writes.
|
||||||
However, if there are fewer than
|
However, if there are fewer than
|
||||||
.Sy zfs_embedded_slog_min_ms
|
.Sy zfs_embedded_slog_min_ms
|
||||||
metaslabs in the vdev, this functionality is disabled.
|
metaslabs in the vdev, this functionality is disabled.
|
||||||
This ensures that we don't set aside an unreasonable amount of space for the ZIL.
|
This ensures that we don't set aside an unreasonable amount of space for the
|
||||||
|
ZIL.
|
||||||
.
|
.
|
||||||
.It Sy zstd_earlyabort_pass Ns = Ns Sy 1 Pq uint
|
.It Sy zstd_earlyabort_pass Ns = Ns Sy 1 Pq uint
|
||||||
Whether heuristic for detection of incompressible data with zstd levels >= 3
|
Whether heuristic for detection of incompressible data with zstd levels >= 3
|
||||||
|
@ -2435,7 +2455,8 @@ the scheduler looks for classes whose maximum has not been satisfied.
|
||||||
Iteration through the I/O classes is done in the order specified above.
|
Iteration through the I/O classes is done in the order specified above.
|
||||||
No further operations are issued
|
No further operations are issued
|
||||||
if the aggregate maximum number of concurrent operations has been hit,
|
if the aggregate maximum number of concurrent operations has been hit,
|
||||||
or if there are no operations queued for an I/O class that has not hit its maximum.
|
or if there are no operations queued for an I/O class that has not hit its
|
||||||
|
maximum.
|
||||||
Every time an I/O operation is queued or an operation completes,
|
Every time an I/O operation is queued or an operation completes,
|
||||||
the scheduler looks for new operations to issue.
|
the scheduler looks for new operations to issue.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -2466,10 +2487,10 @@ the I/O scheduler changes the maximum number of active async write operations
|
||||||
according to the amount of dirty data in the pool.
|
according to the amount of dirty data in the pool.
|
||||||
Since both throughput and latency typically increase with the number of
|
Since both throughput and latency typically increase with the number of
|
||||||
concurrent operations issued to physical devices, reducing the
|
concurrent operations issued to physical devices, reducing the
|
||||||
burstiness in the number of concurrent operations also stabilizes the
|
burstiness in the number of simultaneous operations also stabilizes the
|
||||||
response time of operations from other – and in particular synchronous – queues.
|
response time of operations from other queues, in particular synchronous ones.
|
||||||
In broad strokes, the I/O scheduler will issue more concurrent operations
|
In broad strokes, the I/O scheduler will issue more concurrent operations
|
||||||
from the async write queue as there's more dirty data in the pool.
|
from the async write queue as there is more dirty data in the pool.
|
||||||
.
|
.
|
||||||
.Ss Async Writes
|
.Ss Async Writes
|
||||||
The number of concurrent operations issued for the async write I/O class
|
The number of concurrent operations issued for the async write I/O class
|
||||||
|
@ -2534,7 +2555,8 @@ so that we only start to delay after writing at full speed
|
||||||
has failed to keep up with the incoming write rate.
|
has failed to keep up with the incoming write rate.
|
||||||
The scale of the curve is defined by
|
The scale of the curve is defined by
|
||||||
.Sy zfs_delay_scale .
|
.Sy zfs_delay_scale .
|
||||||
Roughly speaking, this variable determines the amount of delay at the midpoint of the curve.
|
Roughly speaking, this variable determines the amount of delay at the midpoint
|
||||||
|
of the curve.
|
||||||
.Bd -literal
|
.Bd -literal
|
||||||
delay
|
delay
|
||||||
10ms +-------------------------------------------------------------*+
|
10ms +-------------------------------------------------------------*+
|
||||||
|
|
|
@ -71,7 +71,8 @@ module.
|
||||||
.Pp
|
.Pp
|
||||||
Booting into a ZFS dataset requires
|
Booting into a ZFS dataset requires
|
||||||
.Sy mountpoint Ns = Ns Pa /
|
.Sy mountpoint Ns = Ns Pa /
|
||||||
to be set on the dataset containing the root filesystem (henceforth "the boot dataset") and at the very least either the
|
to be set on the dataset containing the root filesystem (henceforth "the boot
|
||||||
|
dataset") and at the very least either the
|
||||||
.Sy bootfs
|
.Sy bootfs
|
||||||
property to be set to that dataset, or the
|
property to be set to that dataset, or the
|
||||||
.Sy root=
|
.Sy root=
|
||||||
|
@ -86,7 +87,8 @@ matching
|
||||||
globs are deemed essential and will be mounted as well.
|
globs are deemed essential and will be mounted as well.
|
||||||
.Pp
|
.Pp
|
||||||
.Xr zfs-mount-generator 8
|
.Xr zfs-mount-generator 8
|
||||||
is recommended for proper functioning of the system afterward (correct mount properties, remounting, &c.).
|
is recommended for proper functioning of the system afterward (correct mount
|
||||||
|
properties, remounting, &c.).
|
||||||
.
|
.
|
||||||
.Sh CMDLINE
|
.Sh CMDLINE
|
||||||
.Ss Standard
|
.Ss Standard
|
||||||
|
@ -122,7 +124,8 @@ cf.\&
|
||||||
.Sx Temporary Mount Point Properties
|
.Sx Temporary Mount Point Properties
|
||||||
in
|
in
|
||||||
.Xr zfsprops 7 .
|
.Xr zfsprops 7 .
|
||||||
These properties will not last, since all filesystems will be re-mounted from the real root.
|
These properties will not last, since all filesystems will be re-mounted from
|
||||||
|
the real root.
|
||||||
.
|
.
|
||||||
.It Sy debug
|
.It Sy debug
|
||||||
If specified,
|
If specified,
|
||||||
|
@ -263,7 +266,8 @@ Does nothing on
|
||||||
.Nm systemd
|
.Nm systemd
|
||||||
systems
|
systems
|
||||||
.Pq if Pa dracut-zfs-generator No succeeded .
|
.Pq if Pa dracut-zfs-generator No succeeded .
|
||||||
Otherwise, loads encryption key for the boot dataset from the console or via plymouth.
|
Otherwise, loads encryption key for the boot dataset from the console or via
|
||||||
|
plymouth.
|
||||||
It may not work at all!
|
It may not work at all!
|
||||||
.El
|
.El
|
||||||
.
|
.
|
||||||
|
|
|
@ -81,7 +81,8 @@ Bookmarks can be created extremely quickly, compared to snapshots, and they
|
||||||
consume no additional space within the pool.
|
consume no additional space within the pool.
|
||||||
Bookmarks can also have arbitrary names, much like snapshots.
|
Bookmarks can also have arbitrary names, much like snapshots.
|
||||||
.Pp
|
.Pp
|
||||||
Unlike snapshots, bookmarks can not be accessed through the filesystem in any way.
|
Unlike snapshots, bookmarks can not be accessed through the filesystem in any
|
||||||
|
way.
|
||||||
From a storage standpoint a bookmark just provides a way to reference
|
From a storage standpoint a bookmark just provides a way to reference
|
||||||
when a snapshot was created as a distinct object.
|
when a snapshot was created as a distinct object.
|
||||||
Bookmarks are initially tied to a snapshot, not the filesystem or volume,
|
Bookmarks are initially tied to a snapshot, not the filesystem or volume,
|
||||||
|
|
|
@ -192,7 +192,8 @@ and
|
||||||
.It Sy guid
|
.It Sy guid
|
||||||
The 64 bit GUID of this dataset or bookmark which does not change over its
|
The 64 bit GUID of this dataset or bookmark which does not change over its
|
||||||
entire lifetime.
|
entire lifetime.
|
||||||
When a snapshot is sent to another pool, the received snapshot has the same GUID.
|
When a snapshot is sent to another pool, the received snapshot has the same
|
||||||
|
GUID.
|
||||||
Thus, the
|
Thus, the
|
||||||
.Sy guid
|
.Sy guid
|
||||||
is suitable to identify a snapshot across pools.
|
is suitable to identify a snapshot across pools.
|
||||||
|
@ -259,7 +260,8 @@ this opaque token can be provided to
|
||||||
to resume and complete the
|
to resume and complete the
|
||||||
.Nm zfs Cm receive .
|
.Nm zfs Cm receive .
|
||||||
.It Sy redact_snaps
|
.It Sy redact_snaps
|
||||||
For bookmarks, this is the list of snapshot guids the bookmark contains a redaction
|
For bookmarks, this is the list of snapshot guids the bookmark contains a
|
||||||
|
redaction
|
||||||
list for.
|
list for.
|
||||||
For snapshots, this is the list of snapshot guids the snapshot is redacted with
|
For snapshots, this is the list of snapshot guids the snapshot is redacted with
|
||||||
respect to.
|
respect to.
|
||||||
|
@ -798,7 +800,8 @@ Controls the compression algorithm used for this dataset.
|
||||||
.Pp
|
.Pp
|
||||||
When set to
|
When set to
|
||||||
.Sy on
|
.Sy on
|
||||||
(the default), indicates that the current default compression algorithm should be used.
|
(the default), indicates that the current default compression algorithm should
|
||||||
|
be used.
|
||||||
The default balances compression and decompression speed, with compression ratio
|
The default balances compression and decompression speed, with compression ratio
|
||||||
and is expected to work well on a wide variety of workloads.
|
and is expected to work well on a wide variety of workloads.
|
||||||
Unlike all other settings for this property,
|
Unlike all other settings for this property,
|
||||||
|
@ -861,7 +864,8 @@ is equivalent to
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Sy zstd
|
.Sy zstd
|
||||||
compression algorithm provides both high compression ratios and good performance.
|
compression algorithm provides both high compression ratios and good
|
||||||
|
performance.
|
||||||
You can specify the
|
You can specify the
|
||||||
.Sy zstd
|
.Sy zstd
|
||||||
level by using the value
|
level by using the value
|
||||||
|
@ -916,7 +920,8 @@ after compression, otherwise the compression will not be considered worthwhile
|
||||||
and the block saved uncompressed.
|
and the block saved uncompressed.
|
||||||
Note that when the logical block is less than
|
Note that when the logical block is less than
|
||||||
8 times the disk sector size this effectively reduces the necessary compression
|
8 times the disk sector size this effectively reduces the necessary compression
|
||||||
ratio; for example, 8 KiB blocks on disks with 4 KiB disk sectors must compress to 1/2
|
ratio; for example, 8 KiB blocks on disks with 4 KiB disk sectors must compress
|
||||||
|
to 1/2
|
||||||
or less of their original size.
|
or less of their original size.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Sy context Ns = Ns Sy none Ns | Ns
|
.Sy context Ns = Ns Sy none Ns | Ns
|
||||||
|
@ -1040,7 +1045,7 @@ file system.
|
||||||
The default value is
|
The default value is
|
||||||
.Sy legacy .
|
.Sy legacy .
|
||||||
Setting this property to a value other than
|
Setting this property to a value other than
|
||||||
.Sy legacy No requires the Sy large_dnode No pool feature to be enabled.
|
.Sy legacy No requires the Sy large_dnode No pool feature to be enabled .
|
||||||
.Pp
|
.Pp
|
||||||
Consider setting
|
Consider setting
|
||||||
.Sy dnodesize
|
.Sy dnodesize
|
||||||
|
@ -1063,7 +1068,7 @@ if you need to receive a send stream of this dataset on a pool that doesn't
|
||||||
enable the
|
enable the
|
||||||
.Sy large_dnode
|
.Sy large_dnode
|
||||||
feature, or if you need to import this pool on a system that doesn't support the
|
feature, or if you need to import this pool on a system that doesn't support the
|
||||||
.Sy large_dnode No feature.
|
.Sy large_dnode No feature .
|
||||||
.Pp
|
.Pp
|
||||||
This property can also be referred to by its shortened column name,
|
This property can also be referred to by its shortened column name,
|
||||||
.Sy dnsize .
|
.Sy dnsize .
|
||||||
|
@ -1132,14 +1137,16 @@ is selected ZFS will ask for the key at the command prompt when it is required
|
||||||
to access the encrypted data (see
|
to access the encrypted data (see
|
||||||
.Nm zfs Cm load-key
|
.Nm zfs Cm load-key
|
||||||
for details).
|
for details).
|
||||||
This setting will also allow the key to be passed in via the standard input stream,
|
This setting will also allow the key to be passed in via the standard input
|
||||||
|
stream,
|
||||||
but users should be careful not to place keys which should be kept secret on
|
but users should be careful not to place keys which should be kept secret on
|
||||||
the command line.
|
the command line.
|
||||||
If a file URI is selected, the key will be loaded from the
|
If a file URI is selected, the key will be loaded from the
|
||||||
specified absolute file path.
|
specified absolute file path.
|
||||||
If an HTTPS or HTTP URL is selected, it will be GETted using
|
If an HTTPS or HTTP URL is selected, it will be GETted using
|
||||||
.Xr fetch 3 ,
|
.Xr fetch 3 ,
|
||||||
libcurl, or nothing, depending on compile-time configuration and run-time availability.
|
libcurl, or nothing, depending on compile-time configuration and run-time
|
||||||
|
availability.
|
||||||
The
|
The
|
||||||
.Sy SSL_CA_CERT_FILE
|
.Sy SSL_CA_CERT_FILE
|
||||||
environment variable can be set to set the location
|
environment variable can be set to set the location
|
||||||
|
@ -1499,7 +1506,8 @@ future releases.
|
||||||
When set to
|
When set to
|
||||||
.Sy some ,
|
.Sy some ,
|
||||||
ZFS stores an extra copy of only critical metadata.
|
ZFS stores an extra copy of only critical metadata.
|
||||||
This can improve file create performance since less metadata needs to be written.
|
This can improve file create performance since less metadata
|
||||||
|
needs to be written.
|
||||||
If a single on-disk block is corrupt, at worst a single user file can be lost.
|
If a single on-disk block is corrupt, at worst a single user file can be lost.
|
||||||
.Pp
|
.Pp
|
||||||
When set to
|
When set to
|
||||||
|
@ -1642,7 +1650,8 @@ LDAP- or
|
||||||
.Xr smbpasswd 5 Ns -based )
|
.Xr smbpasswd 5 Ns -based )
|
||||||
by default.
|
by default.
|
||||||
This means that any additional access control
|
This means that any additional access control
|
||||||
(disallow specific user specific access etc) must be done on the underlying file system.
|
(disallow specific user specific access etc) must be done on the underlying file
|
||||||
|
system.
|
||||||
.It Sy sharenfs Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Ar opts
|
.It Sy sharenfs Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Ar opts
|
||||||
Controls whether the file system is shared via NFS, and what options are to be
|
Controls whether the file system is shared via NFS, and what options are to be
|
||||||
used.
|
used.
|
||||||
|
|
|
@ -62,7 +62,8 @@ Refer to the documentation for the ZFS
|
||||||
implementation that created the pool for information about those features.
|
implementation that created the pool for information about those features.
|
||||||
.Pp
|
.Pp
|
||||||
Each supported feature also has a short name.
|
Each supported feature also has a short name.
|
||||||
By convention a feature's short name is the portion of its GUID which follows the
|
By convention a feature's short name is the portion of its GUID which follows
|
||||||
|
the
|
||||||
.Sq \&:
|
.Sq \&:
|
||||||
.Po
|
.Po
|
||||||
i.e.
|
i.e.
|
||||||
|
@ -167,7 +168,8 @@ separated by whitespace and/or commas.
|
||||||
Only features present in all files are enabled.
|
Only features present in all files are enabled.
|
||||||
.Pp
|
.Pp
|
||||||
Simple sanity checks are applied to the files:
|
Simple sanity checks are applied to the files:
|
||||||
they must be between 1 B and 16 KiB in size, and must end with a newline character.
|
they must be between 1 B and 16 KiB in size, and must end with a newline
|
||||||
|
character.
|
||||||
.Pp
|
.Pp
|
||||||
The requested features are applied when a pool is created using
|
The requested features are applied when a pool is created using
|
||||||
.Nm zpool Cm create Fl o Sy compatibility Ns = Ns Ar …
|
.Nm zpool Cm create Fl o Sy compatibility Ns = Ns Ar …
|
||||||
|
@ -268,7 +270,7 @@ or when a new file is created under that filesystem. \
|
||||||
The upgrade can also be triggered on filesystems via \
|
The upgrade can also be triggered on filesystems via \
|
||||||
Nm zfs Cm set Sy version Ns = Ns Sy current Ar fs . \
|
Nm zfs Cm set Sy version Ns = Ns Sy current Ar fs . \
|
||||||
No The upgrade process runs in the background and may take a while to complete \
|
No The upgrade process runs in the background and may take a while to complete \
|
||||||
for filesystems containing large amounts of files.
|
for filesystems containing large amounts of files .
|
||||||
.
|
.
|
||||||
.de checksum-spiel
|
.de checksum-spiel
|
||||||
When the
|
When the
|
||||||
|
@ -339,7 +341,8 @@ while
|
||||||
is non-zero.
|
is non-zero.
|
||||||
.
|
.
|
||||||
.feature org.openzfs blake3 no extensible_dataset
|
.feature org.openzfs blake3 no extensible_dataset
|
||||||
This feature enables the use of the BLAKE3 hash algorithm for checksum and dedup.
|
This feature enables the use of the BLAKE3 hash algorithm for checksum and
|
||||||
|
dedup.
|
||||||
BLAKE3 is a secure hash algorithm focused on high performance.
|
BLAKE3 is a secure hash algorithm focused on high performance.
|
||||||
.Pp
|
.Pp
|
||||||
.checksum-spiel blake3
|
.checksum-spiel blake3
|
||||||
|
|
|
@ -91,7 +91,7 @@ vdev type is an alias for
|
||||||
.Pp
|
.Pp
|
||||||
A raidz group with
|
A raidz group with
|
||||||
.Em N No disks of size Em X No with Em P No parity disks can hold approximately
|
.Em N No disks of size Em X No with Em P No parity disks can hold approximately
|
||||||
.Em (N-P)*X No bytes and can withstand Em P No devices failing without losing data.
|
.Em (N-P)*X No bytes and can withstand Em P No devices failing without losing data .
|
||||||
The minimum number of devices in a raidz group is one more than the number of
|
The minimum number of devices in a raidz group is one more than the number of
|
||||||
parity disks.
|
parity disks.
|
||||||
The recommended number is between 3 and 9 to help increase performance.
|
The recommended number is between 3 and 9 to help increase performance.
|
||||||
|
@ -99,7 +99,7 @@ The recommended number is between 3 and 9 to help increase performance.
|
||||||
A variant of raidz that provides integrated distributed hot spares which
|
A variant of raidz that provides integrated distributed hot spares which
|
||||||
allows for faster resilvering while retaining the benefits of raidz.
|
allows for faster resilvering while retaining the benefits of raidz.
|
||||||
A dRAID vdev is constructed from multiple internal raidz groups, each with
|
A dRAID vdev is constructed from multiple internal raidz groups, each with
|
||||||
.Em D No data devices and Em P No parity devices.
|
.Em D No data devices and Em P No parity devices .
|
||||||
These groups are distributed over all of the children in order to fully
|
These groups are distributed over all of the children in order to fully
|
||||||
utilize the available disk performance.
|
utilize the available disk performance.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -119,7 +119,7 @@ recommended to also add a mirrored
|
||||||
vdev to store those blocks.
|
vdev to store those blocks.
|
||||||
.Pp
|
.Pp
|
||||||
In regards to I/O, performance is similar to raidz since for any read all
|
In regards to I/O, performance is similar to raidz since for any read all
|
||||||
.Em D No data disks must be accessed.
|
.Em D No data disks must be accessed .
|
||||||
Delivered random IOPS can be reasonably approximated as
|
Delivered random IOPS can be reasonably approximated as
|
||||||
.Sy floor((N-S)/(D+P))*single_drive_IOPS .
|
.Sy floor((N-S)/(D+P))*single_drive_IOPS .
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -136,7 +136,7 @@ vdev type is an alias for
|
||||||
.Sy draid1 .
|
.Sy draid1 .
|
||||||
.Pp
|
.Pp
|
||||||
A dRAID with
|
A dRAID with
|
||||||
.Em N No disks of size Em X , D No data disks per redundancy group, Em P
|
.Em N No disks of size Em X , D No data disks per redundancy group , Em P
|
||||||
.No parity level, and Em S No distributed hot spares can hold approximately
|
.No parity level, and Em S No distributed hot spares can hold approximately
|
||||||
.Em (N-S)*(D/(D+P))*X No bytes and can withstand Em P
|
.Em (N-S)*(D/(D+P))*X No bytes and can withstand Em P
|
||||||
devices failing without losing data.
|
devices failing without losing data.
|
||||||
|
@ -151,7 +151,7 @@ The parity level (1-3).
|
||||||
.It Ar data
|
.It Ar data
|
||||||
The number of data devices per redundancy group.
|
The number of data devices per redundancy group.
|
||||||
In general, a smaller value of
|
In general, a smaller value of
|
||||||
.Em D No will increase IOPS, improve the compression ratio,
|
.Em D No will increase IOPS, improve the compression ratio ,
|
||||||
and speed up resilvering at the expense of total usable capacity.
|
and speed up resilvering at the expense of total usable capacity.
|
||||||
Defaults to
|
Defaults to
|
||||||
.Em 8 , No unless Em N-P-S No is less than Em 8 .
|
.Em 8 , No unless Em N-P-S No is less than Em 8 .
|
||||||
|
|
|
@ -82,11 +82,13 @@ By contrast, the
|
||||||
property describes how much new data can be written to ZFS filesystems/volumes.
|
property describes how much new data can be written to ZFS filesystems/volumes.
|
||||||
The zpool
|
The zpool
|
||||||
.Sy free
|
.Sy free
|
||||||
property is not generally useful for this purpose, and can be substantially more than the zfs
|
property is not generally useful for this purpose, and can be substantially more
|
||||||
|
than the zfs
|
||||||
.Sy available
|
.Sy available
|
||||||
space.
|
space.
|
||||||
This discrepancy is due to several factors, including raidz parity;
|
This discrepancy is due to several factors, including raidz parity;
|
||||||
zfs reservation, quota, refreservation, and refquota properties; and space set aside by
|
zfs reservation, quota, refreservation, and refquota properties; and space set
|
||||||
|
aside by
|
||||||
.Sy spa_slop_shift
|
.Sy spa_slop_shift
|
||||||
(see
|
(see
|
||||||
.Xr zfs 4
|
.Xr zfs 4
|
||||||
|
@ -272,7 +274,8 @@ using the
|
||||||
command.
|
command.
|
||||||
.It Sy bootfs Ns = Ns Sy (unset) Ns | Ns Ar pool Ns Op / Ns Ar dataset
|
.It Sy bootfs Ns = Ns Sy (unset) Ns | Ns Ar pool Ns Op / Ns Ar dataset
|
||||||
Identifies the default bootable dataset for the root pool.
|
Identifies the default bootable dataset for the root pool.
|
||||||
This property is expected to be set mainly by the installation and upgrade programs.
|
This property is expected to be set mainly by the installation and upgrade
|
||||||
|
programs.
|
||||||
Not all Linux distribution boot processes use the bootfs property.
|
Not all Linux distribution boot processes use the bootfs property.
|
||||||
.It Sy cachefile Ns = Ns Ar path Ns | Ns Sy none
|
.It Sy cachefile Ns = Ns Ar path Ns | Ns Sy none
|
||||||
Controls the location of where the pool configuration is cached.
|
Controls the location of where the pool configuration is cached.
|
||||||
|
|
|
@ -34,7 +34,8 @@
|
||||||
.
|
.
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
.Nm
|
.Nm
|
||||||
is a thin shell wrapper that at most checks the status of a dataset's container pool.
|
is a thin shell wrapper that at most checks the status of a dataset's container
|
||||||
|
pool.
|
||||||
It is installed by OpenZFS because some Linux
|
It is installed by OpenZFS because some Linux
|
||||||
distributions expect a fsck helper for all filesystems.
|
distributions expect a fsck helper for all filesystems.
|
||||||
.Pp
|
.Pp
|
||||||
|
|
|
@ -30,8 +30,10 @@ is an udev helper which parses
|
||||||
to map a physical path in a storage topology to a channel name.
|
to map a physical path in a storage topology to a channel name.
|
||||||
The channel name is combined with a disk enclosure slot number to create
|
The channel name is combined with a disk enclosure slot number to create
|
||||||
an alias that reflects the physical location of the drive.
|
an alias that reflects the physical location of the drive.
|
||||||
This is particularly helpful when it comes to tasks like replacing failed drives.
|
This is particularly helpful when it comes to tasks like replacing failed
|
||||||
Slot numbers may also be remapped in case the default numbering is unsatisfactory.
|
drives.
|
||||||
|
Slot numbers may also be remapped in case the default numbering is
|
||||||
|
unsatisfactory.
|
||||||
The drive aliases will be created as symbolic links in
|
The drive aliases will be created as symbolic links in
|
||||||
.Pa /dev/disk/by-vdev .
|
.Pa /dev/disk/by-vdev .
|
||||||
.Pp
|
.Pp
|
||||||
|
|
|
@ -174,7 +174,8 @@ negates the effect of the flag that follows it and has no effect unless
|
||||||
preceded by the
|
preceded by the
|
||||||
.Ar A
|
.Ar A
|
||||||
flag.
|
flag.
|
||||||
For example, the range 0:-1:A-d will dump all object types except for directories.
|
For example, the range 0:-1:A-d will dump all object types except for
|
||||||
|
directories.
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -compact -width Ds
|
.Bl -tag -compact -width Ds
|
||||||
.It Sy A
|
.It Sy A
|
||||||
|
@ -274,7 +275,8 @@ the percentage of free space in each space map.
|
||||||
.It Fl mmmm
|
.It Fl mmmm
|
||||||
Display every spacemap record.
|
Display every spacemap record.
|
||||||
.It Fl M , -metaslab-groups
|
.It Fl M , -metaslab-groups
|
||||||
Display all "normal" vdev metaslab group information - per-vdev metaslab count, fragmentation,
|
Display all "normal" vdev metaslab group information - per-vdev metaslab count,
|
||||||
|
fragmentation,
|
||||||
and free space histogram, as well as overall pool fragmentation and histogram.
|
and free space histogram, as well as overall pool fragmentation and histogram.
|
||||||
.It Fl MM
|
.It Fl MM
|
||||||
"Special" vdevs are added to -M's normal output.
|
"Special" vdevs are added to -M's normal output.
|
||||||
|
|
|
@ -61,8 +61,10 @@ Lock all current and future pages in the virtual memory address space.
|
||||||
This may help the daemon remain responsive when the system is under heavy
|
This may help the daemon remain responsive when the system is under heavy
|
||||||
memory pressure.
|
memory pressure.
|
||||||
.It Fl I
|
.It Fl I
|
||||||
Request that the daemon idle rather than exit when the kernel modules are not loaded.
|
Request that the daemon idle rather than exit when the kernel modules are not
|
||||||
Processing of events will start, or resume, when the kernel modules are (re)loaded.
|
loaded.
|
||||||
|
Processing of events will start, or resume, when the kernel modules are
|
||||||
|
(re)loaded.
|
||||||
Under Linux the kernel modules cannot be unloaded while the daemon is running.
|
Under Linux the kernel modules cannot be unloaded while the daemon is running.
|
||||||
.It Fl Z
|
.It Fl Z
|
||||||
Zero the daemon's state, thereby allowing zevents still within the kernel
|
Zero the daemon's state, thereby allowing zevents still within the kernel
|
||||||
|
@ -75,12 +77,14 @@ Write the daemon's process ID to the specified file.
|
||||||
Custom
|
Custom
|
||||||
.Ev $PATH
|
.Ev $PATH
|
||||||
for zedlets to use.
|
for zedlets to use.
|
||||||
Normally zedlets run in a locked-down environment, with hardcoded paths to the ZFS commands
|
Normally zedlets run in a locked-down environment, with hardcoded paths to the
|
||||||
|
ZFS commands
|
||||||
.Pq Ev $ZFS , $ZPOOL , $ZED , … ,
|
.Pq Ev $ZFS , $ZPOOL , $ZED , … ,
|
||||||
and a hard-coded
|
and a hard-coded
|
||||||
.Ev $PATH .
|
.Ev $PATH .
|
||||||
This is done for security reasons.
|
This is done for security reasons.
|
||||||
However, the ZFS test suite uses a custom PATH for its ZFS commands, and passes it to
|
However, the ZFS test suite uses a custom PATH for its ZFS commands, and passes
|
||||||
|
it to
|
||||||
.Nm
|
.Nm
|
||||||
with
|
with
|
||||||
.Fl P .
|
.Fl P .
|
||||||
|
@ -111,7 +115,8 @@ Defaults to
|
||||||
.El
|
.El
|
||||||
.Sh ZEVENTS
|
.Sh ZEVENTS
|
||||||
A zevent is comprised of a list of nvpairs (name/value pairs).
|
A zevent is comprised of a list of nvpairs (name/value pairs).
|
||||||
Each zevent contains an EID (Event IDentifier) that uniquely identifies it throughout
|
Each zevent contains an EID (Event IDentifier) that uniquely identifies it
|
||||||
|
throughout
|
||||||
the lifetime of the loaded ZFS kernel module; this EID is a monotonically
|
the lifetime of the loaded ZFS kernel module; this EID is a monotonically
|
||||||
increasing integer that resets to 1 each time the kernel module is loaded.
|
increasing integer that resets to 1 each time the kernel module is loaded.
|
||||||
Each zevent also contains a class string that identifies the type of event.
|
Each zevent also contains a class string that identifies the type of event.
|
||||||
|
@ -217,7 +222,8 @@ The ZFS release the daemon is part of.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
ZEDLETs may need to call other ZFS commands.
|
ZEDLETs may need to call other ZFS commands.
|
||||||
The installation paths of the following executables are defined as environment variables:
|
The installation paths of the following executables are defined as environment
|
||||||
|
variables:
|
||||||
.Sy ZDB ,
|
.Sy ZDB ,
|
||||||
.Sy ZED ,
|
.Sy ZED ,
|
||||||
.Sy ZFS ,
|
.Sy ZFS ,
|
||||||
|
|
|
@ -411,7 +411,7 @@ mount point permission is set to 755 by default, user
|
||||||
will be unable to mount file systems under
|
will be unable to mount file systems under
|
||||||
.Ar tank/cindys .
|
.Ar tank/cindys .
|
||||||
Add an ACE similar to the following syntax to provide mount point access:
|
Add an ACE similar to the following syntax to provide mount point access:
|
||||||
.Dl # Cm chmod No A+user: Ns Ar cindys Ns :add_subdirectory:allow Ar /tank/cindys
|
.Dl # Cm chmod No A+user : Ns Ar cindys Ns :add_subdirectory:allow Ar /tank/cindys
|
||||||
.
|
.
|
||||||
.Ss Example 2 : No Delegating Create Time Permissions on a ZFS Dataset
|
.Ss Example 2 : No Delegating Create Time Permissions on a ZFS Dataset
|
||||||
The following example shows how to grant anyone in the group
|
The following example shows how to grant anyone in the group
|
||||||
|
|
|
@ -97,7 +97,8 @@ property cannot be changed from within a jail.
|
||||||
After a dataset is attached to a jail and the
|
After a dataset is attached to a jail and the
|
||||||
.Sy jailed
|
.Sy jailed
|
||||||
property is set, a jailed file system cannot be mounted outside the jail,
|
property is set, a jailed file system cannot be mounted outside the jail,
|
||||||
since the jail administrator might have set the mount point to an unacceptable value.
|
since the jail administrator might have set the mount point to an unacceptable
|
||||||
|
value.
|
||||||
.Pp
|
.Pp
|
||||||
See
|
See
|
||||||
.Xr jail 8
|
.Xr jail 8
|
||||||
|
|
|
@ -236,7 +236,8 @@ Key rotation is managed by ZFS.
|
||||||
Changing the user's key (e.g. a passphrase)
|
Changing the user's key (e.g. a passphrase)
|
||||||
does not require re-encrypting the entire dataset.
|
does not require re-encrypting the entire dataset.
|
||||||
Datasets can be scrubbed,
|
Datasets can be scrubbed,
|
||||||
resilvered, renamed, and deleted without the encryption keys being loaded (see the
|
resilvered, renamed, and deleted without the encryption keys being loaded (see
|
||||||
|
the
|
||||||
.Cm load-key
|
.Cm load-key
|
||||||
subcommand for more info on key loading).
|
subcommand for more info on key loading).
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -291,9 +292,11 @@ Encrypted datasets may not have
|
||||||
since the implementation stores some encryption metadata where the third copy
|
since the implementation stores some encryption metadata where the third copy
|
||||||
would normally be.
|
would normally be.
|
||||||
Since compression is applied before encryption, datasets may
|
Since compression is applied before encryption, datasets may
|
||||||
be vulnerable to a CRIME-like attack if applications accessing the data allow for it.
|
be vulnerable to a CRIME-like attack if applications accessing the data allow
|
||||||
|
for it.
|
||||||
Deduplication with encryption will leak information about which blocks
|
Deduplication with encryption will leak information about which blocks
|
||||||
are equivalent in a dataset and will incur an extra CPU cost for each block written.
|
are equivalent in a dataset and will incur an extra CPU cost for each block
|
||||||
|
written.
|
||||||
.
|
.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr zfsprops 7 ,
|
.Xr zfsprops 7 ,
|
||||||
|
|
|
@ -49,7 +49,7 @@ units for configured ZFS datasets.
|
||||||
.No Skipped if Sy off .
|
.No Skipped if Sy off .
|
||||||
.No Skipped if only Sy noauto
|
.No Skipped if only Sy noauto
|
||||||
datasets exist for a given mountpoint and there's more than one.
|
datasets exist for a given mountpoint and there's more than one.
|
||||||
.No Datasets with Sy yes No take precedence over ones with Sy noauto No for the same mountpoint.
|
.No Datasets with Sy yes No take precedence over ones with Sy noauto No for the same mountpoint .
|
||||||
.No Sets logical Em noauto No flag if Sy noauto .
|
.No Sets logical Em noauto No flag if Sy noauto .
|
||||||
Encryption roots always generate
|
Encryption roots always generate
|
||||||
.Sy zfs-load-key@ Ns Ar root Ns Sy .service ,
|
.Sy zfs-load-key@ Ns Ar root Ns Sy .service ,
|
||||||
|
@ -94,14 +94,15 @@ as the mount unit.
|
||||||
.No Sets Sy After Ns = for the mount unit.
|
.No Sets Sy After Ns = for the mount unit.
|
||||||
.
|
.
|
||||||
.It Sy org.openzfs.systemd:wanted-by Ns = Ns Pa unit Ns Oo " " Ns Pa unit Oc Ns …
|
.It Sy org.openzfs.systemd:wanted-by Ns = Ns Pa unit Ns Oo " " Ns Pa unit Oc Ns …
|
||||||
.No Sets logical Em noauto No flag (see below).
|
.No Sets logical Em noauto No flag (see below) .
|
||||||
.No If not Sy none , No sets Sy WantedBy Ns = for the mount unit.
|
.No If not Sy none , No sets Sy WantedBy Ns = for the mount unit.
|
||||||
.It Sy org.openzfs.systemd:required-by Ns = Ns Pa unit Ns Oo " " Ns Pa unit Oc Ns …
|
.It Sy org.openzfs.systemd:required-by Ns = Ns Pa unit Ns Oo " " Ns Pa unit Oc Ns …
|
||||||
.No Sets logical Em noauto No flag (see below).
|
.No Sets logical Em noauto No flag (see below) .
|
||||||
.No If not Sy none , No sets Sy RequiredBy Ns = for the mount unit.
|
.No If not Sy none , No sets Sy RequiredBy Ns = for the mount unit.
|
||||||
.
|
.
|
||||||
.It Sy org.openzfs.systemd:nofail Ns = Ns (unset) Ns | Ns Sy on Ns | Ns Sy off
|
.It Sy org.openzfs.systemd:nofail Ns = Ns (unset) Ns | Ns Sy on Ns | Ns Sy off
|
||||||
Waxes or wanes strength of default reverse dependencies of the mount unit, see below.
|
Waxes or wanes strength of default reverse dependencies of the mount unit, see
|
||||||
|
below.
|
||||||
.
|
.
|
||||||
.It Sy org.openzfs.systemd:ignore Ns = Ns Sy on Ns | Ns Sy off
|
.It Sy org.openzfs.systemd:ignore Ns = Ns Sy on Ns | Ns Sy off
|
||||||
.No Skip if Sy on .
|
.No Skip if Sy on .
|
||||||
|
|
|
@ -104,7 +104,8 @@ this will cause the terminal to interactively block after asking for the key.
|
||||||
.It Fl v
|
.It Fl v
|
||||||
Report mount progress.
|
Report mount progress.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Attempt to force mounting of all filesystems, even those that couldn't normally be mounted (e.g. redacted datasets).
|
Attempt to force mounting of all filesystems, even those that couldn't normally
|
||||||
|
be mounted (e.g. redacted datasets).
|
||||||
.El
|
.El
|
||||||
.It Xo
|
.It Xo
|
||||||
.Nm zfs
|
.Nm zfs
|
||||||
|
|
|
@ -99,7 +99,8 @@ Clear subdirectories' flags recursively.
|
||||||
.Ar file Ns | Ns Ar directory Ns …
|
.Ar file Ns | Ns Ar directory Ns …
|
||||||
.Xc
|
.Xc
|
||||||
Check project ID and inherit flag on the files and directories:
|
Check project ID and inherit flag on the files and directories:
|
||||||
report entries without the project inherit flag, or with project IDs different from the
|
report entries without the project inherit flag, or with project IDs different
|
||||||
|
from the
|
||||||
target directory's project ID or the one specified with
|
target directory's project ID or the one specified with
|
||||||
.Fl p .
|
.Fl p .
|
||||||
.Bl -tag -width "-p id"
|
.Bl -tag -width "-p id"
|
||||||
|
|
|
@ -44,7 +44,8 @@
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm zfs Cm promote
|
.Nm zfs Cm promote
|
||||||
command makes it possible to destroy the dataset that the clone was created from.
|
command makes it possible to destroy the dataset that the clone was created
|
||||||
|
from.
|
||||||
The clone parent-child dependency relationship is reversed, so that the origin
|
The clone parent-child dependency relationship is reversed, so that the origin
|
||||||
dataset becomes a clone of the specified dataset.
|
dataset becomes a clone of the specified dataset.
|
||||||
.Pp
|
.Pp
|
||||||
|
|
|
@ -215,7 +215,8 @@ compress on the receiver, unless you specify
|
||||||
.Fl o Sy compress Ns = Em off .
|
.Fl o Sy compress Ns = Em off .
|
||||||
.It Fl w , -raw
|
.It Fl w , -raw
|
||||||
For encrypted datasets, send data exactly as it exists on disk.
|
For encrypted datasets, send data exactly as it exists on disk.
|
||||||
This allows backups to be taken even if encryption keys are not currently loaded.
|
This allows backups to be taken even if encryption keys are not currently
|
||||||
|
loaded.
|
||||||
The backup may then be received on an untrusted machine since that machine will
|
The backup may then be received on an untrusted machine since that machine will
|
||||||
not have the encryption keys to read the protected data or alter it without
|
not have the encryption keys to read the protected data or alter it without
|
||||||
being detected.
|
being detected.
|
||||||
|
@ -286,7 +287,8 @@ when using this flag.
|
||||||
Allows sending a replication stream even when there are snapshots missing in the
|
Allows sending a replication stream even when there are snapshots missing in the
|
||||||
hierarchy.
|
hierarchy.
|
||||||
When a snapshot is missing, instead of throwing an error and aborting the send,
|
When a snapshot is missing, instead of throwing an error and aborting the send,
|
||||||
a warning is printed to the standard error stream and the dataset to which it belongs
|
a warning is printed to the standard error stream and the dataset to which it
|
||||||
|
belongs
|
||||||
and its descendents are skipped.
|
and its descendents are skipped.
|
||||||
This flag can only be used in conjunction with
|
This flag can only be used in conjunction with
|
||||||
.Fl R .
|
.Fl R .
|
||||||
|
@ -354,7 +356,8 @@ then the data will be decompressed before sending so it can be split into
|
||||||
smaller block sizes.
|
smaller block sizes.
|
||||||
.It Fl w , -raw
|
.It Fl w , -raw
|
||||||
For encrypted datasets, send data exactly as it exists on disk.
|
For encrypted datasets, send data exactly as it exists on disk.
|
||||||
This allows backups to be taken even if encryption keys are not currently loaded.
|
This allows backups to be taken even if encryption keys are not currently
|
||||||
|
loaded.
|
||||||
The backup may then be received on an untrusted machine since that machine will
|
The backup may then be received on an untrusted machine since that machine will
|
||||||
not have the encryption keys to read the protected data or alter it without
|
not have the encryption keys to read the protected data or alter it without
|
||||||
being detected.
|
being detected.
|
||||||
|
@ -386,7 +389,8 @@ If the
|
||||||
.Sy lz4_compress
|
.Sy lz4_compress
|
||||||
feature is active on the sending system, then the receiving system must have
|
feature is active on the sending system, then the receiving system must have
|
||||||
that feature enabled as well.
|
that feature enabled as well.
|
||||||
Datasets that are sent with this flag may not be received as an encrypted dataset,
|
Datasets that are sent with this flag may not be received as an encrypted
|
||||||
|
dataset,
|
||||||
since encrypted datasets cannot use the
|
since encrypted datasets cannot use the
|
||||||
.Sy embedded_data
|
.Sy embedded_data
|
||||||
feature.
|
feature.
|
||||||
|
@ -445,7 +449,7 @@ included in the redaction list contained in the bookmark specified by the
|
||||||
flag.
|
flag.
|
||||||
The resulting send stream is said to be redacted with respect to the snapshots
|
The resulting send stream is said to be redacted with respect to the snapshots
|
||||||
the bookmark specified by the
|
the bookmark specified by the
|
||||||
.Fl -redact No flag was created with.
|
.Fl -redact No flag was created with .
|
||||||
The bookmark must have been created by running
|
The bookmark must have been created by running
|
||||||
.Nm zfs Cm redact
|
.Nm zfs Cm redact
|
||||||
on the snapshot being sent.
|
on the snapshot being sent.
|
||||||
|
@ -629,7 +633,8 @@ snapshots themselves.
|
||||||
In order to make the purpose of the feature more clear, an example is provided.
|
In order to make the purpose of the feature more clear, an example is provided.
|
||||||
Consider a zfs filesystem containing four files.
|
Consider a zfs filesystem containing four files.
|
||||||
These files represent information for an online shopping service.
|
These files represent information for an online shopping service.
|
||||||
One file contains a list of usernames and passwords, another contains purchase histories,
|
One file contains a list of usernames and passwords, another contains purchase
|
||||||
|
histories,
|
||||||
a third contains click tracking data, and a fourth contains user preferences.
|
a third contains click tracking data, and a fourth contains user preferences.
|
||||||
The owner of this data wants to make it available for their development teams to
|
The owner of this data wants to make it available for their development teams to
|
||||||
test against, and their market research teams to do analysis on.
|
test against, and their market research teams to do analysis on.
|
||||||
|
@ -641,7 +646,8 @@ However, because all of this data is stored in one ZFS filesystem,
|
||||||
it must all be sent and received together.
|
it must all be sent and received together.
|
||||||
In addition, the owner of the data
|
In addition, the owner of the data
|
||||||
wants to take advantage of features like compression, checksumming, and
|
wants to take advantage of features like compression, checksumming, and
|
||||||
snapshots, so they do want to continue to use ZFS to store and transmit their data.
|
snapshots, so they do want to continue to use ZFS to store and transmit their
|
||||||
|
data.
|
||||||
Redaction can help them do so.
|
Redaction can help them do so.
|
||||||
First, they would make two clones of a snapshot of the data on the source.
|
First, they would make two clones of a snapshot of the data on the source.
|
||||||
In one clone, they create the setup they want their market research team to see;
|
In one clone, they create the setup they want their market research team to see;
|
||||||
|
@ -654,7 +660,8 @@ They would then create a redaction bookmark on the parent snapshot,
|
||||||
using snapshots on the two clones as redaction snapshots.
|
using snapshots on the two clones as redaction snapshots.
|
||||||
The parent can then be sent, redacted, to the target
|
The parent can then be sent, redacted, to the target
|
||||||
server where the research and development teams have access.
|
server where the research and development teams have access.
|
||||||
Finally, incremental sends from the parent snapshot to each of the clones can be sent
|
Finally, incremental sends from the parent snapshot to each of the clones can be
|
||||||
|
sent
|
||||||
to and received on the target server; these snapshots are identical to the
|
to and received on the target server; these snapshots are identical to the
|
||||||
ones on the source, and are ready to be used, while the parent snapshot on the
|
ones on the source, and are ready to be used, while the parent snapshot on the
|
||||||
target contains none of the username and password data present on the source,
|
target contains none of the username and password data present on the source,
|
||||||
|
|
|
@ -73,7 +73,8 @@
|
||||||
.Oo Fl t Ar type Ns Oo , Ns Ar type Oc Ns … Oc
|
.Oo Fl t Ar type Ns Oo , Ns Ar type Oc Ns … Oc
|
||||||
.Ar filesystem Ns | Ns Ar snapshot Ns | Ns Ar path
|
.Ar filesystem Ns | Ns Ar snapshot Ns | Ns Ar path
|
||||||
.Xc
|
.Xc
|
||||||
Displays space consumed by, and quotas on, each user in the specified filesystem,
|
Displays space consumed by, and quotas on, each user in the specified
|
||||||
|
filesystem,
|
||||||
snapshot, or path.
|
snapshot, or path.
|
||||||
If a path is given, the filesystem that contains that path will be used.
|
If a path is given, the filesystem that contains that path will be used.
|
||||||
This corresponds to the
|
This corresponds to the
|
||||||
|
|
|
@ -188,7 +188,7 @@ Each number is in hexadecimal, and only one block can be specified.
|
||||||
.It Fl C Ar dvas
|
.It Fl C Ar dvas
|
||||||
Inject the given error only into specific DVAs.
|
Inject the given error only into specific DVAs.
|
||||||
The mask should be specified as a list of 0-indexed DVAs separated by commas
|
The mask should be specified as a list of 0-indexed DVAs separated by commas
|
||||||
.No (e.g. Ar 0,2 Ns No ).
|
.No (e.g . Ar 0,2 Ns No ).
|
||||||
This option is not applicable to logical data errors such as
|
This option is not applicable to logical data errors such as
|
||||||
.Sy decompress
|
.Sy decompress
|
||||||
and
|
and
|
||||||
|
|
|
@ -87,7 +87,8 @@ currently in use by another subsystem.
|
||||||
However this check is not robust enough
|
However this check is not robust enough
|
||||||
to detect simultaneous attempts to use a new device in different pools, even if
|
to detect simultaneous attempts to use a new device in different pools, even if
|
||||||
.Sy multihost Ns = Sy enabled .
|
.Sy multihost Ns = Sy enabled .
|
||||||
The administrator must ensure, that simultaneous invocations of any combination of
|
The administrator must ensure, that simultaneous invocations of any combination
|
||||||
|
of
|
||||||
.Nm zpool Cm replace ,
|
.Nm zpool Cm replace ,
|
||||||
.Nm zpool Cm create ,
|
.Nm zpool Cm create ,
|
||||||
.Nm zpool Cm add ,
|
.Nm zpool Cm add ,
|
||||||
|
|
|
@ -108,7 +108,8 @@ Issued when a pool is exported.
|
||||||
.It Sy zpool.import
|
.It Sy zpool.import
|
||||||
Issued when a pool is imported.
|
Issued when a pool is imported.
|
||||||
.It Sy zpool.reguid
|
.It Sy zpool.reguid
|
||||||
Issued when a REGUID (new unique identifier for the pool have been regenerated) have been detected.
|
Issued when a REGUID (new unique identifier for the pool have been regenerated)
|
||||||
|
have been detected.
|
||||||
.It Sy vdev.unknown
|
.It Sy vdev.unknown
|
||||||
Issued when the vdev is unknown.
|
Issued when the vdev is unknown.
|
||||||
Such as trying to clear device errors on a vdev that have failed/been kicked
|
Such as trying to clear device errors on a vdev that have failed/been kicked
|
||||||
|
@ -226,7 +227,8 @@ ID of vdev (if any).
|
||||||
.It Sy vdev_fru
|
.It Sy vdev_fru
|
||||||
Physical FRU location.
|
Physical FRU location.
|
||||||
.It Sy vdev_state
|
.It Sy vdev_state
|
||||||
State of vdev (0=uninitialized, 1=closed, 2=offline, 3=removed, 4=failed to open, 5=faulted, 6=degraded, 7=healthy).
|
State of vdev (0=uninitialized, 1=closed, 2=offline, 3=removed, 4=failed to
|
||||||
|
open, 5=faulted, 6=degraded, 7=healthy).
|
||||||
.It Sy vdev_ashift
|
.It Sy vdev_ashift
|
||||||
The ashift value of the vdev.
|
The ashift value of the vdev.
|
||||||
.It Sy vdev_complete_ts
|
.It Sy vdev_complete_ts
|
||||||
|
@ -373,7 +375,8 @@ If this field exists, it is an array of counters.
|
||||||
Each entry counts bit clears in a particular bit of a big-endian uint64 type.
|
Each entry counts bit clears in a particular bit of a big-endian uint64 type.
|
||||||
The first entry counts bits
|
The first entry counts bits
|
||||||
clears of the high-order bit of the first byte, the 9th byte, etc, and the
|
clears of the high-order bit of the first byte, the 9th byte, etc, and the
|
||||||
last entry counts clears of the low-order bit of the 8th byte, the 16th byte, etc.
|
last entry counts clears of the low-order bit of the 8th byte, the 16th byte,
|
||||||
|
etc.
|
||||||
This information is useful for observing a stuck bit in a parallel data
|
This information is useful for observing a stuck bit in a parallel data
|
||||||
path, such as IDE or parallel SCSI.
|
path, such as IDE or parallel SCSI.
|
||||||
.El
|
.El
|
||||||
|
|
|
@ -61,7 +61,8 @@ the disks.
|
||||||
.It Fl a
|
.It Fl a
|
||||||
Exports all pools imported on the system.
|
Exports all pools imported on the system.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Forcefully unmount all datasets, and allow export of pools with active shared spares.
|
Forcefully unmount all datasets, and allow export of pools with active shared
|
||||||
|
spares.
|
||||||
.Pp
|
.Pp
|
||||||
This command will forcefully export the pool even if it has a shared spare that
|
This command will forcefully export the pool even if it has a shared spare that
|
||||||
is currently being used.
|
is currently being used.
|
||||||
|
|
|
@ -66,7 +66,8 @@ If
|
||||||
is specified, the command exits after
|
is specified, the command exits after
|
||||||
.Ar count
|
.Ar count
|
||||||
reports are printed.
|
reports are printed.
|
||||||
The first report printed is always the statistics since boot regardless of whether
|
The first report printed is always the statistics since boot regardless of
|
||||||
|
whether
|
||||||
.Ar interval
|
.Ar interval
|
||||||
and
|
and
|
||||||
.Ar count
|
.Ar count
|
||||||
|
@ -117,7 +118,7 @@ If
|
||||||
is passed without a script name, it prints a list of all scripts.
|
is passed without a script name, it prints a list of all scripts.
|
||||||
.Fl c
|
.Fl c
|
||||||
also sets verbose mode
|
also sets verbose mode
|
||||||
.No \&( Ns Fl v Ns No \&).
|
.No \&( Ns Fl v Ns No \&) .
|
||||||
.Pp
|
.Pp
|
||||||
Script output should be in the form of "name=value".
|
Script output should be in the form of "name=value".
|
||||||
The column name is set to "name" and the value is set to "value".
|
The column name is set to "name" and the value is set to "value".
|
||||||
|
|
|
@ -75,9 +75,11 @@ The
|
||||||
feature flag must be enabled to remove a top-level vdev, see
|
feature flag must be enabled to remove a top-level vdev, see
|
||||||
.Xr zpool-features 7 .
|
.Xr zpool-features 7 .
|
||||||
.Pp
|
.Pp
|
||||||
A mirrored top-level device (log or data) can be removed by specifying the top-level mirror for the
|
A mirrored top-level device (log or data) can be removed by specifying the top-
|
||||||
|
level mirror for the
|
||||||
same.
|
same.
|
||||||
Non-log devices or data devices that are part of a mirrored configuration can be removed using
|
Non-log devices or data devices that are part of a mirrored configuration can be
|
||||||
|
removed using
|
||||||
the
|
the
|
||||||
.Nm zpool Cm detach
|
.Nm zpool Cm detach
|
||||||
command.
|
command.
|
||||||
|
@ -137,11 +139,11 @@ config:
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The command to remove the mirrored log
|
The command to remove the mirrored log
|
||||||
.Ar mirror-2 No is:
|
.Ar mirror-2 No is :
|
||||||
.Dl # Nm zpool Cm remove Ar tank mirror-2
|
.Dl # Nm zpool Cm remove Ar tank mirror-2
|
||||||
.Pp
|
.Pp
|
||||||
The command to remove the mirrored data
|
The command to remove the mirrored data
|
||||||
.Ar mirror-1 No is:
|
.Ar mirror-1 No is :
|
||||||
.Dl # Nm zpool Cm remove Ar tank mirror-1
|
.Dl # Nm zpool Cm remove Ar tank mirror-1
|
||||||
.
|
.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
|
|
@ -40,7 +40,8 @@
|
||||||
.
|
.
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
Starts a resilver of the specified pools.
|
Starts a resilver of the specified pools.
|
||||||
If an existing resilver is already running it will be restarted from the beginning.
|
If an existing resilver is already running it will be restarted from the
|
||||||
|
beginning.
|
||||||
Any drives that were scheduled for a deferred
|
Any drives that were scheduled for a deferred
|
||||||
resilver will be added to the new one.
|
resilver will be added to the new one.
|
||||||
This requires the
|
This requires the
|
||||||
|
|
|
@ -97,7 +97,9 @@ again.
|
||||||
Wait until scrub has completed before returning.
|
Wait until scrub has completed before returning.
|
||||||
.El
|
.El
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
.Ss Example 1 : No Status of pool with ongoing scrub:
|
.Ss Example 1
|
||||||
|
Status of pool with ongoing scrub:
|
||||||
|
.sp
|
||||||
.Bd -literal -compact
|
.Bd -literal -compact
|
||||||
.No # Nm zpool Cm status
|
.No # Nm zpool Cm status
|
||||||
...
|
...
|
||||||
|
|
|
@ -81,7 +81,8 @@ datasets it attempts to mount as it is bringing the new pool online.
|
||||||
Note that if any datasets have
|
Note that if any datasets have
|
||||||
.Sy keylocation Ns = Ns Sy prompt ,
|
.Sy keylocation Ns = Ns Sy prompt ,
|
||||||
this command will block waiting for the keys to be entered.
|
this command will block waiting for the keys to be entered.
|
||||||
Without this flag, encrypted datasets will be left unavailable until the keys are loaded.
|
Without this flag, encrypted datasets will be left unavailable until the keys
|
||||||
|
are loaded.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
Do a dry-run
|
Do a dry-run
|
||||||
.Pq Qq No-op
|
.Pq Qq No-op
|
||||||
|
|
|
@ -98,7 +98,8 @@ This is the number of I/O operations that didn't complete in
|
||||||
.Sy zio_slow_io_ms
|
.Sy zio_slow_io_ms
|
||||||
milliseconds
|
milliseconds
|
||||||
.Pq Sy 30000 No by default .
|
.Pq Sy 30000 No by default .
|
||||||
This does not necessarily mean the I/O operations failed to complete, just took an
|
This does not necessarily mean the I/O operations failed to complete, just took
|
||||||
|
an
|
||||||
unreasonably long amount of time.
|
unreasonably long amount of time.
|
||||||
This may indicate a problem with the underlying storage.
|
This may indicate a problem with the underlying storage.
|
||||||
.It Fl t
|
.It Fl t
|
||||||
|
|
|
@ -92,7 +92,8 @@ for details on compatibility with systems that support feature flags, but do not
|
||||||
support all features enabled on the pool.
|
support all features enabled on the pool.
|
||||||
.Bl -tag -width Ds
|
.Bl -tag -width Ds
|
||||||
.It Fl a
|
.It Fl a
|
||||||
Enables all supported features (from specified compatibility sets, if any) on all
|
Enables all supported features (from specified compatibility sets, if any) on
|
||||||
|
all
|
||||||
pools.
|
pools.
|
||||||
.It Fl V Ar version
|
.It Fl V Ar version
|
||||||
Upgrade to the specified legacy version.
|
Upgrade to the specified legacy version.
|
||||||
|
|
|
@ -121,7 +121,8 @@ or removes the specified device from the pool.
|
||||||
.It Xr zpool-replace 8
|
.It Xr zpool-replace 8
|
||||||
Replaces an existing device (which may be faulted) with a new one.
|
Replaces an existing device (which may be faulted) with a new one.
|
||||||
.It Xr zpool-split 8
|
.It Xr zpool-split 8
|
||||||
Creates a new pool by splitting all mirrors in an existing pool (which decreases its redundancy).
|
Creates a new pool by splitting all mirrors in an existing pool (which decreases
|
||||||
|
its redundancy).
|
||||||
.El
|
.El
|
||||||
.
|
.
|
||||||
.Ss Properties
|
.Ss Properties
|
||||||
|
@ -174,7 +175,8 @@ Checkpoints the current state of
|
||||||
which can be later restored by
|
which can be later restored by
|
||||||
.Nm zpool Cm import Fl -rewind-to-checkpoint .
|
.Nm zpool Cm import Fl -rewind-to-checkpoint .
|
||||||
.It Xr zpool-trim 8
|
.It Xr zpool-trim 8
|
||||||
Initiates an immediate on-demand TRIM operation for all of the free space in a pool.
|
Initiates an immediate on-demand TRIM operation for all of the free space in a
|
||||||
|
pool.
|
||||||
This operation informs the underlying storage devices of all blocks
|
This operation informs the underlying storage devices of all blocks
|
||||||
in the pool which are no longer allocated and allows thinly provisioned
|
in the pool which are no longer allocated and allows thinly provisioned
|
||||||
devices to reclaim the space.
|
devices to reclaim the space.
|
||||||
|
@ -201,7 +203,8 @@ pool.
|
||||||
Takes the specified physical device offline or brings it online.
|
Takes the specified physical device offline or brings it online.
|
||||||
.It Xr zpool-resilver 8
|
.It Xr zpool-resilver 8
|
||||||
Starts a resilver.
|
Starts a resilver.
|
||||||
If an existing resilver is already running it will be restarted from the beginning.
|
If an existing resilver is already running it will be restarted from the
|
||||||
|
beginning.
|
||||||
.It Xr zpool-reopen 8
|
.It Xr zpool-reopen 8
|
||||||
Reopen all the vdevs associated with the pool.
|
Reopen all the vdevs associated with the pool.
|
||||||
.It Xr zpool-clear 8
|
.It Xr zpool-clear 8
|
||||||
|
@ -384,11 +387,11 @@ config:
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The command to remove the mirrored log
|
The command to remove the mirrored log
|
||||||
.Ar mirror-2 No is:
|
.Ar mirror-2 No is :
|
||||||
.Dl # Nm zpool Cm remove Ar tank mirror-2
|
.Dl # Nm zpool Cm remove Ar tank mirror-2
|
||||||
.Pp
|
.Pp
|
||||||
The command to remove the mirrored data
|
The command to remove the mirrored data
|
||||||
.Ar mirror-1 No is:
|
.Ar mirror-1 No is :
|
||||||
.Dl # Nm zpool Cm remove Ar tank mirror-1
|
.Dl # Nm zpool Cm remove Ar tank mirror-1
|
||||||
.
|
.
|
||||||
.Ss Example 15 : No Displaying expanded space on a device
|
.Ss Example 15 : No Displaying expanded space on a device
|
||||||
|
|
Loading…
Reference in New Issue