Archive-Team
/
zfs
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 103 Wiki Activity

man: zfs.4: miscellaneous cleanup 

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #12941
This commit is contained in:
наб 2022-01-13 20:09:03 +01:00 committed by GitHub
parent 4737a9eb70
commit 12bd322dde
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
man/man4/zfs.4
View File

@ -348,7 +348,7 @@ 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 ASHIFT_MAX Po 16 Pc Pq ulong .It Sy zfs_vdev_max_auto_ashift Ns = Ns Sy ASHIFT_MAX Po 16 Pc Pq ulong
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.
. .
.It Sy zfs_vdev_min_auto_ashift Ns = Ns Sy ASHIFT_MIN Po 9 Pc Pq ulong .It Sy zfs_vdev_min_auto_ashift Ns = Ns Sy ASHIFT_MIN Po 9 Pc Pq ulong
@ -498,7 +498,7 @@ linear in kernel memory.
Disabling can improve performance in some code paths Disabling can improve performance in some code paths
at the expense of fragmented kernel memory. at the expense of fragmented kernel memory.
. .
.It Sy zfs_abd_scatter_max_order Ns = Ns Sy MAX_ORDER-1 Pq uint .It Sy zfs_abd_scatter_max_order Ns = Ns Sy MAX_ORDER\-1 Pq uint
Maximum number of consecutive memory pages allocated in a single block for Maximum number of consecutive memory pages allocated in a single block for
scatter/gather lists. scatter/gather lists.
.Pp .Pp
@ -595,7 +595,9 @@ Under Linux, half of system memory will be used as the limit.
Under Under
.Fx , .Fx ,
the larger of the larger of
.Sy all_system_memory - 1GB No and Sy 5/8 * all_system_memory .Sy all_system_memory No \- Sy 1GB
and
.Sy 5/8 No \(mu Sy all_system_memory
will be used as the limit. will be used as the limit.
This value must be at least This value must be at least
.Sy 67108864 Ns B Pq 64MB . .Sy 67108864 Ns B Pq 64MB .
@ -666,7 +668,9 @@ to evict the required number of metadata buffers.
Min size of ARC in bytes. Min size of ARC in bytes.
.No If set to Sy 0 , arc_c_min .No If set to Sy 0 , arc_c_min
will default to consuming the larger of will default to consuming the larger of
.Sy 32MB No or Sy all_system_memory/32 . .Sy 32MB
and
.Sy all_system_memory No / Sy 32 .
. .
.It Sy zfs_arc_min_prefetch_ms Ns = Ns Sy 0 Ns ms Ns Po Ns ≡ Ns 1s Pc Pq int .It Sy zfs_arc_min_prefetch_ms Ns = Ns Sy 0 Ns ms Ns Po Ns ≡ Ns 1s Pc Pq int
Minimum time prefetched blocks are locked in the ARC. Minimum time prefetched blocks are locked in the ARC.
@ -726,10 +730,10 @@ ARC target size
.Pq Sy arc_c .Pq Sy arc_c
by thresholds determined by this parameter. by thresholds determined by this parameter.
Exceeding by Exceeding by
.Sy ( arc_c >> zfs_arc_overflow_shift ) * 0.5 .Sy ( arc_c No >> Sy zfs_arc_overflow_shift ) No / Sy 2
starts ARC reclamation process. starts ARC reclamation process.
If that appears insufficient, exceeding by If that appears insufficient, exceeding by
.Sy ( arc_c >> zfs_arc_overflow_shift ) * 1.5 .Sy ( arc_c No >> Sy zfs_arc_overflow_shift ) No \(mu Sy 1.5
blocks new buffer allocation until the reclaim thread catches up. blocks new buffer allocation until the reclaim thread catches up.
Started reclamation process continues till ARC size returns below the Started reclamation process continues till ARC size returns below the
target size. target size.
@ -938,7 +942,7 @@ by the maximum number of operations per second.
This will smoothly handle between ten times and a tenth of this number. This will smoothly handle between ten times and a tenth of this number.
.No See Sx ZFS TRANSACTION DELAY . .No See Sx ZFS TRANSACTION DELAY .
.Pp .Pp
.Sy zfs_delay_scale * zfs_dirty_data_max Em must be smaller than Sy 2^64 . .Sy zfs_delay_scale No \(mu Sy zfs_dirty_data_max Em must No be smaller than Sy 2^64 .
. .
.It Sy zfs_disable_ivset_guid_check Ns = Ns Sy 0 Ns | Ns 1 Pq int .It Sy zfs_disable_ivset_guid_check Ns = Ns Sy 0 Ns | Ns 1 Pq int
Disables requirement for IVset GUIDs to be present and match when doing a raw Disables requirement for IVset GUIDs to be present and match when doing a raw
@ -1141,11 +1145,6 @@ Maximum number of blocks freed in a single TXG.
.It Sy zfs_max_async_dedup_frees Ns = Ns Sy 100000 Po 10^5 Pc Pq ulong .It Sy zfs_max_async_dedup_frees Ns = Ns Sy 100000 Po 10^5 Pc Pq ulong
Maximum number of dedup blocks freed in a single TXG. Maximum number of dedup blocks freed in a single TXG.
. .
.It Sy zfs_override_estimate_recordsize Ns = Ns Sy 0 Pq ulong
If nonzero, override record size calculation for
.Nm zfs Cm send
estimates.
.
.It Sy zfs_vdev_async_read_max_active Ns = Ns Sy 3 Pq int .It Sy zfs_vdev_async_read_max_active Ns = Ns Sy 3 Pq int
Maximum asynchronous read I/O operations active to each device. Maximum asynchronous read I/O operations active to each device.
.No See Sx ZFS I/O SCHEDULER . .No See Sx ZFS I/O SCHEDULER .
@ -1422,7 +1421,7 @@ This option is used by the test suite to track race conditions.
. .
.It Sy zfs_livelist_condense_sync_pause Ns = Ns Sy 0 Ns | Ns 1 Pq int .It Sy zfs_livelist_condense_sync_pause Ns = Ns Sy 0 Ns | Ns 1 Pq int
When set, the livelist condense process pauses indefinitely before When set, the livelist condense process pauses indefinitely before
executing the synctask - executing the synctask \(em
.Fn spa_livelist_condense_sync . .Fn spa_livelist_condense_sync .
This option is used by the test suite to trigger race conditions. This option is used by the test suite to trigger race conditions.
. .
@ -1531,7 +1530,7 @@ This is one of the factors used to determine the
length of the activity check during import. length of the activity check during import.
.Pp .Pp
The multihost write period is The multihost write period is
.Sy zfs_multihost_interval / leaf-vdevs . .Sy zfs_multihost_interval No / Sy leaf-vdevs .
On average a multihost write will be issued for each leaf vdev On average a multihost write will be issued for each leaf vdev
every every
.Sy zfs_multihost_interval .Sy zfs_multihost_interval
@ -1548,7 +1547,7 @@ the risk of failing to detect an active pool.
The total activity check time is never allowed to drop below one second. The total activity check time is never allowed to drop below one second.
.Pp .Pp
On import the activity check waits a minimum amount of time determined by On import the activity check waits a minimum amount of time determined by
.Sy zfs_multihost_interval * zfs_multihost_import_intervals , .Sy zfs_multihost_interval No \(mu Sy zfs_multihost_import_intervals ,
or the same product computed on the host which last had the pool imported, or the same product computed on the host which last had the pool imported,
whichever is greater. whichever is greater.
The activity check time may be further extended if the value of MMP The activity check time may be further extended if the value of MMP
@ -1573,7 +1572,7 @@ its configuration may take action such as suspending the pool or offlining a
device. device.
.Pp .Pp
Otherwise, the pool will be suspended if Otherwise, the pool will be suspended if
.Sy zfs_multihost_fail_intervals * zfs_multihost_interval .Sy zfs_multihost_fail_intervals No \(mu Sy zfs_multihost_interval
milliseconds pass without a successful MMP write. milliseconds pass without a successful MMP write.
This guarantees the activity test will see MMP writes if the pool is imported. This guarantees the activity test will see MMP writes if the pool is imported.
.Sy 1 No is equivalent to Sy 2 ; .Sy 1 No is equivalent to Sy 2 ;
@ -1805,7 +1804,7 @@ remove the spill block from an existing object.
Including unmodified copies of the spill blocks creates a backwards-compatible Including unmodified copies of the spill blocks creates a backwards-compatible
stream which will recreate a spill block if it was incorrectly removed. stream which will recreate a spill block if it was incorrectly removed.
. .
.It Sy zfs_send_no_prefetch_queue_ff Ns = Ns Sy 20 Ns ^-1 Pq int .It Sy zfs_send_no_prefetch_queue_ff Ns = Ns Sy 20 Ns ^\-1 Pq int
The fill fraction of the The fill fraction of the
.Nm zfs Cm send .Nm zfs Cm send
internal queues. internal queues.
@ -1816,7 +1815,7 @@ The maximum number of bytes allowed in
.Nm zfs Cm send Ns 's .Nm zfs Cm send Ns 's
internal queues. internal queues.
. .
.It Sy zfs_send_queue_ff Ns = Ns Sy 20 Ns ^-1 Pq int .It Sy zfs_send_queue_ff Ns = Ns Sy 20 Ns ^\-1 Pq int
The fill fraction of the The fill fraction of the
.Nm zfs Cm send .Nm zfs Cm send
prefetch queue. prefetch queue.
@ -1827,7 +1826,7 @@ The maximum number of bytes allowed that will be prefetched by
.Nm zfs Cm send . .Nm zfs Cm send .
This value must be at least twice the maximum block size in use. This value must be at least twice the maximum block size in use.
. .
.It Sy zfs_recv_queue_ff Ns = Ns Sy 20 Ns ^-1 Pq int .It Sy zfs_recv_queue_ff Ns = Ns Sy 20 Ns ^\-1 Pq int
The fill fraction of the The fill fraction of the
.Nm zfs Cm receive .Nm zfs Cm receive
queue. queue.
@ -2319,7 +2318,7 @@ This credits the transaction for "time already served",
e.g. reading indirect blocks. e.g. reading indirect blocks.
.Pp .Pp
The minimum time for a transaction to take is calculated as The minimum time for a transaction to take is calculated as
.Dl min_time = min( Ns Sy zfs_delay_scale No * (dirty - min) / (max - dirty), 100ms) .D1 min_time = min( Ns Sy zfs_delay_scale No \(mu Po Sy dirty No \- Sy min Pc / Po Sy max No \- Sy dirty Pc , 100ms)
.Pp .Pp
The delay has two degrees of freedom that can be adjusted via tunables. The delay has two degrees of freedom that can be adjusted via tunables.
The percentage of dirty data at which we start to delay is defined by The percentage of dirty data at which we start to delay is defined by