View | Details | Raw Unified | Return to bug 200673
Collapse All | Expand All

(-)b/sbin/geom/class/multipath/gmultipath.8 (-12 / +12 lines)
Lines 24-30 Link Here
24
.\"
24
.\"
25
.\" $FreeBSD$
25
.\" $FreeBSD$
26
.\"
26
.\"
27
.Dd April 18, 2012
27
.Dd April 5, 2015
28
.Dt GMULTIPATH 8
28
.Dt GMULTIPATH 8
29
.Os
29
.Os
30
.Sh NAME
30
.Sh NAME
Lines 253-266 This I/O continues until an I/O is returned with Link Here
253
a generic I/O error or a "Nonexistent Device" error.
253
a generic I/O error or a "Nonexistent Device" error.
254
When this occurs, that path is marked FAIL, the next path
254
When this occurs, that path is marked FAIL, the next path
255
in a list is selected as active and the failed I/O reissued.
255
in a list is selected as active and the failed I/O reissued.
256
In Active/Active mode all paths not marked FAIL may handle I/O same time.
256
In Active/Active mode all paths not marked FAIL may handle I/O
257
at the same time.
257
Requests are distributed between paths to equalize load.
258
Requests are distributed between paths to equalize load.
258
For capable devices it allows to utilize bandwidth of all paths.
259
For capable devices it allows to utilize the bandwidth of all paths.
259
In Active/Read mode all paths not marked FAIL may handle reads same time,
260
In Active/Read mode all paths not marked FAIL may handle reads at the
260
but unlike Active/Active only one path handles write requests at any
261
same time, but unlike in Active/Active mode only one path handles write
261
point in time.
262
requests at any point in time.
262
It allows to closer follow original write request order if above layer
263
It allows to closer follow the original write request order if the layer
263
needs it for data consistency (not waiting for requisite write completion
264
above needs it for data consistency (not waiting for requisite write completion
264
before sending dependent write).
265
before sending dependent write).
265
.Pp
266
.Pp
266
When new devices are added to the system the
267
When new devices are added to the system the
Lines 269-277 GEOM class is given an opportunity to taste these new devices. Link Here
269
If a new
270
If a new
270
device has a
271
device has a
271
.Nm MULTIPATH
272
.Nm MULTIPATH
272
on-disk metadata label, the device is used to either create a new
273
on-disk metadata label, the device is either used to create a new
273
.Nm MULTIPATH
274
.Nm MULTIPATH
274
GEOM, or been added the list of paths for an existing
275
GEOM, or added to the list of paths for an existing
275
.Nm MULTIPATH
276
.Nm MULTIPATH
276
GEOM.
277
GEOM.
277
.Pp
278
.Pp
Lines 281-287 and Link Here
281
.Xr mpt 4
282
.Xr mpt 4
282
based Fibre Channel disk devices.
283
based Fibre Channel disk devices.
283
For these devices, when a device disappears
284
For these devices, when a device disappears
284
(due e.g., to a cable pull or power failure to a switch), the device is
285
(due to e.g. a cable pull or power failure to a switch), the device is
285
proactively marked as gone and I/O to it failed.
286
proactively marked as gone and I/O to it failed.
286
This causes the
287
This causes the
287
.Nm MULTIPATH
288
.Nm MULTIPATH
288
- 

Return to bug 200673