Man pages sections > man8 > multipath

multipath - Device mapper target autoconfig.

MULTIPATH(8) System Manager's Manual MULTIPATH(8)


multipath - Device mapper target autoconfig.


multipath [-v verbosity] [-b bindings_file] [-d] [-h|-l|-ll|-f|-t|-F|-B|-c|-q|-r|-i|-a|-u|-w|-W] [-p failover|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:
No output.
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.
Print usage text.
Dry run, do not create or update devmaps.
Show the current multipath topology from information fetched in sysfs and the device mapper.
Show the current multipath topology from all available information (sysfs, the device mapper, path checkers ...).
Flush a multipath device map specified as parameter, if unused.
Flush all unused multipath device maps.
Print internal hardware table to stdout.
Force devmap reload.
Ignore WWIDs file when processing devices.
Treat the bindings file as read only.
-b bindings_file
Set user_friendly_names bindings file location. The default is /etc/multipath/bindings.
Check if a block device should be a path in a multipath device.
Allow device tables with queue_if_no_path when multipathd is not running.
Add the WWID for the specified device to the WWIDs file.
Check if the device specified in the program environment should be a path in a multipath device.
Remove the WWID for the specified device from the WWIDs file.
Reset the WWIDs file to only include the current multipath devices.
-p policy
Force new maps to use the specified policy:
One path per priority group.
All paths in one priority group.
One priority group per serial number.
One 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.
One priority group per target node name. Target node names are fetched in /sys/class/fc_transport/target*/node_name.
Existing maps are not modified.
Update only the devmap specified by device, which is either:
A devmap name.
A path associated with the desired devmap; the path may be in one of the following formats:


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


multipath-tools was developed by Christophe Varoqui <> and others.
2016-10-26 Linux