From 9810410a53f7e05cef7a901c3692d96a38475abc Mon Sep 17 00:00:00 2001 From: Richard Laager Date: Sun, 14 Apr 2019 20:46:19 -0500 Subject: [PATCH] Eliminate most mentions of "special" Previously, the "spare" vdev type was described as "A special pseudo-vdev which...". I wanted to eliminate the word "special" from that, now that the allocation_classes feature exists and there is such a thing as a "special vdev". I ended up eliminating almost all instances of the word "special" that are not referencing the allocation_classes feature. Reviewed-by: George Melikov Reviewed-by: Brian Behlendorf Signed-off-by: Richard Laager Closes #8626 --- man/man8/zfs.8 | 10 +++++----- man/man8/zpool.8 | 16 ++++++++-------- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/man/man8/zfs.8 b/man/man8/zfs.8 index 0d6f3731a..d475df650 100644 --- a/man/man8/zfs.8 +++ b/man/man8/zfs.8 @@ -26,7 +26,7 @@ .\" Copyright (c) 2014, Joyent, Inc. All rights reserved. .\" Copyright (c) 2014 by Adam Stevko. All rights reserved. .\" Copyright (c) 2014 Integros [integros.com] -.\" Copyright 2016 Richard Laager. All rights reserved. +.\" Copyright 2019 Richard Laager. All rights reserved. .\" Copyright 2018 Nexenta Systems, Inc. .\" Copyright 2018 Joyent, Inc. .\" @@ -356,7 +356,7 @@ Applications that depend on standards conformance might fail due to non-standard behavior when checking file system free space. .It Sy volume A logical volume exported as a raw or block device. -This type of dataset should only be used under special circumstances. +This type of dataset should only be used when a block device is required. File systems are typically used in most environments. .It Sy snapshot A read-only version of a file system or volume at a given point in time. @@ -2885,7 +2885,7 @@ A property for sorting the output by column in ascending order based on the value of the property. The property must be one of the properties described in the .Sx Properties -section, or the special value +section or the value .Sy name to sort by the dataset name. Multiple properties can be specified at one time using multiple @@ -2976,7 +2976,7 @@ and .Sx User Properties sections. .Pp -The special value +The value .Sy all can be used to display all properties that apply to the given dataset's type .Pq filesystem, volume, snapshot, or bookmark . @@ -4061,7 +4061,7 @@ leaves any existing local setting or explicit inheritance unchanged. .Pp All .Fl o -restrictions on set-once and special properties apply equally to +restrictions (e.g. set-once) apply equally to .Fl x . .El .It Xo diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index f52f9ee39..ebdb72251 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -280,7 +280,7 @@ The minimum number of devices in a raidz group is one more than the number of parity disks. The recommended number is between 3 and 9 to help increase performance. .It Sy spare -A special pseudo-vdev which keeps track of available hot spares for a pool. +A pseudo-vdev which keeps track of available hot spares for a pool. For more information, see the .Sx Hot Spares section. @@ -294,16 +294,16 @@ For more information, see the .Sx Intent Log section. .It Sy dedup -A device dedicated solely for allocating dedup data. +A device dedicated solely for dedup data. 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 -allocations are load-balanced between devices. +allocations are load-balanced between those devices. .It Sy special A device dedicated solely for allocating various kinds of internal metadata, and optionally small file data. 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 -allocations are load-balanced between devices. +allocations are load-balanced between those devices. .Pp For more information on special allocations, see the .Sx Special Allocation Class @@ -574,7 +574,7 @@ Inclusion of small file blocks in the special class is opt-in. Each dataset can control the size of small file blocks allowed in the special class by setting the .Sy special_small_blocks -dataset property. It defaults to zero so you must opt-in by setting it to a +dataset property. It defaults to zero, so you must opt-in by setting it to a non-zero value. See .Xr zfs 8 for more info on setting this property. @@ -715,7 +715,7 @@ Pool sector size exponent, to the power of .Sy 2 (internally referred to as .Sy ashift -). Values from 9 to 16, inclusive, are valid; also, the special +). Values from 9 to 16, inclusive, are valid; also, the value 0 (the default) means to auto-detect using the kernel's block layer and a ZFS internal exception list. I/O operations will be aligned to the specified size boundaries. Additionally, the minimum (disk) @@ -785,9 +785,9 @@ imported. Setting this property caches the pool configuration in a different location that can later be imported with .Nm zpool Cm import Fl c . -Setting it to the special value +Setting it to the value .Sy none -creates a temporary pool that is never cached, and the special value +creates a temporary pool that is never cached, and the .Qq .Pq empty string uses the default location. -- 2.39.2