39
39
.Cm attach
40
40
.Op Fl fsw
41
41
.Oo Fl o Ar property Ns = Ns Ar value Oc
42
- .Ar pool device new_device
42
+ .Ar pool vdev new_device
43
43
.
44
44
.Sh DESCRIPTION
45
45
Attaches
46
46
.Ar new_device
47
47
to the existing
48
- .Ar device .
48
+ .Ar vdev .
49
49
The behavior differs depending on if the existing
50
- .Ar device
50
+ .Ar vdev
51
51
is a RAID-Z device, or a mirror/plain device.
52
52
.Pp
53
- If the existing device is a mirror or plain device
53
+ If the existing vdev is a mirror or plain device
54
54
.Pq e.g. specified as Qo Li sda Qc or Qq Li mirror-7 ,
55
- the new device will be mirrored with the existing device , a resilver will be
55
+ the new device will be mirrored with the existing vdev , a resilver will be
56
56
initiated, and the new device will contribute to additional redundancy once the
57
57
resilver completes.
58
58
If
59
- .Ar device
59
+ .Ar vdev
60
60
is not currently part of a mirrored configuration,
61
61
.Ar device
62
62
automatically transforms into a two-way mirror of
63
63
.Ar device
64
64
and
65
65
.Ar new_device .
66
66
If
67
- .Ar device
67
+ .Ar vdev
68
68
is part of a two-way mirror, attaching
69
69
.Ar new_device
70
70
creates a three-way mirror, and so on.
71
71
In either case,
72
72
.Ar new_device
73
73
begins to resilver immediately and any running scrub is canceled.
74
74
.Pp
75
- If the existing device is a RAID-Z device
75
+ If the existing vdev is a RAID-Z device
76
76
.Pq e.g. specified as Qq Ar raidz2-0 ,
77
77
the new device will become part of that RAID-Z group.
78
78
A "raidz expansion" will be initiated, and once the expansion completes,
@@ -112,7 +112,7 @@ the checksums of all blocks which have been copied during the expansion.
112
112
Forces use of
113
113
.Ar new_device ,
114
114
even if it appears to be in use.
115
- Not all devices can be overridden in this manner.
115
+ Not all vdevs can be overridden in this manner.
116
116
.It Fl o Ar property Ns = Ns Ar value
117
117
Sets the given pool properties.
118
118
See the
@@ -121,7 +121,7 @@ manual page for a list of valid properties that can be set.
121
121
The only property supported at the moment is
122
122
.Sy ashift .
123
123
.It Fl s
124
- When attaching to a mirror or plain device , the
124
+ When attaching to a mirror or plain vdev , the
125
125
.Ar new_device
126
126
is reconstructed sequentially to restore redundancy as quickly as possible.
127
127
Checksums are not verified during sequential reconstruction so a scrub is
0 commit comments