Cleanup special/dedup language

This standardizes the language on "deduplication tables" rather than
"dedup data" (which might be read as the data blocks rather than the
DDT).  Likewise, it standardizes on "small file blocks".  It also
standardizes on "normal" rather than using both "normal" and "general"
in the same paragraph. I also replaced "non-specified" with the more
explicit "non-dedup/special".

Reviewed-by: George Melikov <mail@gmelikov.ru>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
Closes #8713
This commit is contained in:
Richard Laager 2019-05-07 11:51:09 -05:00 committed by Brian Behlendorf
parent 6aff30ad80
commit c6eaa14620

View File

@ -296,13 +296,13 @@ For more information, see the
.Sx Intent Log .Sx Intent Log
section. section.
.It Sy dedup .It Sy dedup
A device dedicated solely for dedup data. A device dedicated solely for deduplication tables.
The redundancy of this device should match the redundancy of the other normal The redundancy of this device should match the redundancy of the other normal
devices in the pool. If more than one dedup device is specified, then devices in the pool. If more than one dedup device is specified, then
allocations are load-balanced between those devices. allocations are load-balanced between those devices.
.It Sy special .It Sy special
A device dedicated solely for allocating various kinds of internal metadata, A device dedicated solely for allocating various kinds of internal metadata,
and optionally small file data. and optionally small file blocks.
The redundancy of this device should match the redundancy of the other normal The redundancy of this device should match the redundancy of the other normal
devices in the pool. If more than one special device is specified, then devices in the pool. If more than one special device is specified, then
allocations are load-balanced between those devices. allocations are load-balanced between those devices.
@ -560,15 +560,15 @@ current state of the pool won't be scanned during a scrub.
.Ss Special Allocation Class .Ss Special Allocation Class
The allocations in the special class are dedicated to specific block types. The allocations in the special class are dedicated to specific block types.
By default this includes all metadata, the indirect blocks of user data, and By default this includes all metadata, the indirect blocks of user data, and
any dedup data. The class can also be provisioned to accept a limited any deduplication tables. The class can also be provisioned to accept
percentage of small file data blocks. small file blocks.
.Pp .Pp
A pool must always have at least one general (non-specified) vdev before A pool must always have at least one normal (non-dedup/special) vdev before
other devices can be assigned to the special class. If the special class other devices can be assigned to the special class. If the special class
becomes full, then allocations intended for it will spill back into the becomes full, then allocations intended for it will spill back into the
normal class. normal class.
.Pp .Pp
Dedup data can be excluded from the special class by setting the Deduplication tables can be excluded from the special class by setting the
.Sy zfs_ddt_data_is_special .Sy zfs_ddt_data_is_special
zfs module parameter to false (0). zfs module parameter to false (0).
.Pp .Pp