diff --git a/man/man4/zfs.4 b/man/man4/zfs.4 index 38233fefbe..2f7a18ea62 100644 --- a/man/man4/zfs.4 +++ b/man/man4/zfs.4 @@ -1087,7 +1087,8 @@ This should be less than .It Sy zfs_wrlog_data_max Ns = Pq int The upper limit of write-transaction zil log data size in bytes. Once it is reached, write operation is blocked, until log data is cleared out -after transaction group sync. Because of some overhead, it should be set +after transaction group sync. +Because of some overhead, it should be set at least 2 times the size of .Sy zfs_dirty_data_max .No to prevent harming normal write throughput. @@ -1622,8 +1623,8 @@ After this threshold is crossed, additional frees will wait until the next TXG. . .It Sy zfs_prefetch_disable Ns = Ns Sy 0 Ns | Ns 1 Pq int Disable predictive prefetch. -Note that it leaves "prescient" prefetch (for. e.g.\& -.Nm zfs Cm send ) +Note that it leaves "prescient" prefetch +.Pq for, e.g., Nm zfs Cm send intact. Unlike predictive prefetch, prescient prefetch never issues I/O that ends up not being needed, so it can't hurt performance. diff --git a/man/man7/zpool-features.7 b/man/man7/zpool-features.7 index d10ca7f441..20d1c8d6c2 100644 --- a/man/man7/zpool-features.7 +++ b/man/man7/zpool-features.7 @@ -701,7 +701,7 @@ For more information about redacted sends, see .feature com.delphix redacted_datasets no extensible_dataset This feature enables the receiving of redacted .Nm zfs Cm send Ns -streams. which create redacted datasets when received. +streams, which create redacted datasets when received. These datasets are missing some of their blocks, and so cannot be safely mounted, and their contents cannot be safely read. For more information about redacted receives, see diff --git a/man/man7/zpoolprops.7 b/man/man7/zpoolprops.7 index 5bd1c2bf31..944fbf2b8d 100644 --- a/man/man7/zpoolprops.7 +++ b/man/man7/zpoolprops.7 @@ -188,7 +188,7 @@ layer and a ZFS internal exception list. I/O operations will be aligned to the specified size boundaries. Additionally, the minimum (disk) write size will be set to the specified size, so this represents a -space vs. performance trade-off. +space/performance trade-off. For optimal performance, the pool sector size should be greater than or equal to the sector size of the underlying disks. The typical case for setting this property is when diff --git a/man/man8/zinject.8 b/man/man8/zinject.8 index 179d11a618..1cd8aa85e3 100644 --- a/man/man8/zinject.8 +++ b/man/man8/zinject.8 @@ -188,7 +188,7 @@ Each number is in hexadecimal, and only one block can be specified. .It Fl C Ar dvas Inject the given error only into specific DVAs. The mask should be specified as a list of 0-indexed DVAs separated by commas -.No (ex. Ar 0,2 Ns No ). +.No (e.g. Ar 0,2 Ns No ). This option is not applicable to logical data errors such as .Sy decompress and diff --git a/man/man8/zpool-labelclear.8 b/man/man8/zpool-labelclear.8 index c7edc91160..912adb0700 100644 --- a/man/man8/zpool-labelclear.8 +++ b/man/man8/zpool-labelclear.8 @@ -45,7 +45,8 @@ Removes ZFS label information from the specified If the .Ar device is a cache device, it also removes the L2ARC header -(persistent L2ARC). The +(persistent L2ARC). +The .Ar device must not be part of an active pool configuration. .Bl -tag -width Ds