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 <mail@gmelikov.ru>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
Closes #8626
This commit is contained in:
Richard Laager 2019-04-14 20:46:19 -05:00 committed by Brian Behlendorf
parent c2c6eadf29
commit 9810410a53
2 changed files with 13 additions and 13 deletions

View File

@ -26,7 +26,7 @@
.\" Copyright (c) 2014, Joyent, Inc. All rights reserved. .\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
.\" Copyright (c) 2014 by Adam Stevko. All rights reserved. .\" Copyright (c) 2014 by Adam Stevko. All rights reserved.
.\" Copyright (c) 2014 Integros [integros.com] .\" 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 Nexenta Systems, Inc.
.\" Copyright 2018 Joyent, 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. behavior when checking file system free space.
.It Sy volume .It Sy volume
A logical volume exported as a raw or block device. 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. File systems are typically used in most environments.
.It Sy snapshot .It Sy snapshot
A read-only version of a file system or volume at a given point in time. 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. value of the property.
The property must be one of the properties described in the The property must be one of the properties described in the
.Sx Properties .Sx Properties
section, or the special value section or the value
.Sy name .Sy name
to sort by the dataset name. to sort by the dataset name.
Multiple properties can be specified at one time using multiple Multiple properties can be specified at one time using multiple
@ -2976,7 +2976,7 @@ and
.Sx User Properties .Sx User Properties
sections. sections.
.Pp .Pp
The special value The value
.Sy all .Sy all
can be used to display all properties that apply to the given dataset's type can be used to display all properties that apply to the given dataset's type
.Pq filesystem, volume, snapshot, or bookmark . .Pq filesystem, volume, snapshot, or bookmark .
@ -4061,7 +4061,7 @@ leaves any existing local setting or explicit inheritance unchanged.
.Pp .Pp
All All
.Fl o .Fl o
restrictions on set-once and special properties apply equally to restrictions (e.g. set-once) apply equally to
.Fl x . .Fl x .
.El .El
.It Xo .It Xo

View File

@ -280,7 +280,7 @@ 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.
.It Sy spare .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 For more information, see the
.Sx Hot Spares .Sx Hot Spares
section. section.
@ -294,16 +294,16 @@ For more information, see the
.Sx Intent Log .Sx Intent Log
section. section.
.It Sy dedup .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 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 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 data.
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 devices. allocations are load-balanced between those devices.
.Pp .Pp
For more information on special allocations, see the For more information on special allocations, see the
.Sx Special Allocation Class .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 can control the size of small file blocks allowed in the special class by
setting the setting the
.Sy special_small_blocks .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 non-zero value. See
.Xr zfs 8 .Xr zfs 8
for more info on setting this property. for more info on setting this property.
@ -715,7 +715,7 @@ Pool sector size exponent, to the power of
.Sy 2 .Sy 2
(internally referred to as (internally referred to as
.Sy ashift .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 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 layer and a ZFS internal exception list. I/O operations will be aligned
to the specified size boundaries. Additionally, the minimum (disk) 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 Setting this property caches the pool configuration in a different location that
can later be imported with can later be imported with
.Nm zpool Cm import Fl c . .Nm zpool Cm import Fl c .
Setting it to the special value Setting it to the value
.Sy none .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 .Qq
.Pq empty string .Pq empty string
uses the default location. uses the default location.