Skip to content
Permalink
Browse files

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.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
  • Loading branch information...
rlaager committed Apr 15, 2019
1 parent 83472fa commit d0bf0060aa3d1b9f9743c636eeab6c71d6c58968
Showing with 13 additions and 13 deletions.
  1. +5 −5 man/man8/zfs.8
  2. +8 −8 man/man8/zpool.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
@@ -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.

0 comments on commit d0bf006

Please sign in to comment.
You can’t perform that action at this time.