DESCRIPTION
multipath is used to detect multiple paths to devices for fail-over or
performance reasons and coalesces them
OPTIONS
-b bindings_file
specify an alternate location for the user friendly names bind-
ings file. The default location is /var/lib/multipath/bindings.
-d dry run, do not create or update devmaps
-f flush a multipath device map specified as parameter, if unused
-F flush all unused multipath device maps
-l show the current multipath topology from information fetched in
sysfs and the device mapper
-ll show the current multipath topology from all available informa-
tion (sysfs, the device mapper ...)
-p policy
force maps to 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. Priori-
ties are determined by callout programs speci-
fied as a global, per-controler or per-multi-
path 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_trans-
port/target*/node_name.
-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
device update only the devmap the path pointed by device is in.
device is in the /dev/sdb (as shown by udev in the $DEV-
NAME variable) or major:minor format. device may alter-
natively be a multipath mapname
FILES
/etc/multipath.conf
Configuration file for the multipath and multipathd pro-
grams.
/var/lib/multipath/bindings
The bindings file used if the user friendly names con-
figuration option is selected. This file should usually
not need to be modified by hand. To ensure That the mul-
tipath devices have the same names on all nodes access-
ing them, this file can be copied from one node to all
the others.