multipath (8)

multipath [\|-v.IRverbosity\|] [\|-b.IRbindings_file\|] [\|-d\|] [\|-h|-l|-ll|-f|-t|-F|-B|-c|-q|\|-r|-w|-W\|] [\|-p.BRfailover|multibus|group_by_serial|group_by_prio|group_by_node_name\|] [\|device\|]

multipath is used to detect and coalesce multiple paths to devices, for fail-over or performance reasons.

-v level

verbosity, print all paths and multipaths

0

no output

1

print the created or updated multipath names only, for use to feed other tools like kpartx

2 +

print all info : detected paths, coalesced paths (ie multipaths) and device maps

-h

print usage text

-d

dry run, do not create or update devmaps

-l

show the current multipath topology from information fetched in sysfs and the device mapper

-ll

show the current multipath topology from all available information (sysfs, the device mapper, path checkers ...)

-f

flush a multipath device map specified as parameter, if unused

-F

flush all unused multipath device maps

-t

print internal hardware table to stdout

-r

force devmap reload

-B

treat the bindings file as read only

-b bindings_file

set user_friendly_names bindings file location. The default is /etc/multipath/bindings

-c

check if a block device should be a path in a multipath device

-q

allow device tables with queue_if_no_path when multipathd is not running

-w

remove the wwid for the specified device from the wwids file

-W

reset the wwids file to only include the current multipath devices

-p policy

force new maps to use the specified policy:

failover

1 path per priority group

multibus

all paths in 1 priority group

group_by_serial

1 priority group per serial

group_by_prio

1 priority group per priority value. Priorities are determined by callout programs specified as a global, per-controller or per-multipath option in the configuration file

group_by_node_name

1 priority group per target node name. Target node names are fetched in /sys/class/fc_transport/target*/node_name.

Existing maps are not modified.

device

update only the devmap specified by device, which is either:

\[bu]

a devmap name

\[bu]

a path associated with the desired devmap; the path may be in one of the following formats:

\[bu]

/dev/sdb

\[bu]

major:minor

multipathd(8), multipath.conf(5), kpartx(8), udev(8), dmsetup(8) hotplug(8)

multipath was developed by Christophe Varoqui, <[email protected]> and others.