Unknown switch: (null)
multipath-tools v0.15.1 (08/27, 2026)
Usage:
/usr/bin/multipath [-v level] [-B|-d|-i|-q|-r] [-b file] [-p policy] [device]
/usr/bin/multipath [-v level] [-R retries] -f device
/usr/bin/multipath [-v level] [-R retries] -F
/usr/bin/multipath [-v level] [-l|-ll] [device]
/usr/bin/multipath [-v level] [-a|-w] device
/usr/bin/multipath [-v level] -W
/usr/bin/multipath [-v level] [-i] [-c|-C] device
/usr/bin/multipath [-v level] [-i] [-u|-U]
/usr/bin/multipath [-h|-t|-T]
Where:
-h print this usage text
-l show multipath topology (sysfs and DM info)
-ll show multipath topology (maximum info)
-e enable foreign libraries with -l/-ll
-f flush a multipath device map
-F flush all multipath device maps
-a add a device wwid to the wwids file
-c check if a device should be a path in a multipath device
-C check if a multipath device has usable paths
-q allow queue_if_no_path when multipathd is not running
-d dry run, do not create or update devmaps
-t display the currently used multipathd configuration
-T display the multipathd configuration without builtin defaults
-r force devmap reload
-i ignore wwids file
-B treat the bindings file as read only
-b fil bindings file location
-w remove a device from the wwids file
-W reset the wwids file include only the current devices
-R num number of times to retry removes of in-use devices
-u check if the device specified in the program environment should be a
path in a multipath device
-U check if the device specified in the program environment is a
multipath device with usable paths, see -C flag
-p pol force all maps to specified path grouping policy:
. failover one path per priority group
. multibus all paths in one priority group
. group_by_serial one priority group per serial
. group_by_prio one priority group per priority lvl
. group_by_node_name one priority group per target node
. group_by_tpg one priority group per ALUA target port group
-v lvl verbosity level:
. 0 no output
. 1 print created devmap names only
. 2 default verbosity
. 3 print debug information
device action limited to:
. multipath named 'device' (ex: mpath0)
. multipath whose wwid is 'device' (ex: 60051...)
. multipath including the path named 'device' (ex: /dev/sda or
/dev/dm-0)
. multipath including the path with maj:min 'device' (ex: 8:0)
Options (24)
| Option | Description | Source |
|---|
-h | print this usage text | help |
-l | show multipath topology (sysfs and DM info) | help |
-ll | show multipath topology (maximum info) | help |
-e | enable foreign libraries with -l/-ll | help + man |
-f | flush a multipath device map | help |
-F | flush all multipath device maps | help |
-a | add a device wwid to the wwids file | help |
-c | check if a device should be a path in a multipath device | help |
-C | check if a multipath device has usable paths | help |
-q | Don't unset the device mapper feature queue_if_no_path for multipath maps. | help + man |
-d | Dry run, do not create or update devmaps. | help + man |
-t | display the currently used multipathd configuration | help |
-T | display the multipathd configuration without builtin defaults | help |
-r | Force a reload of all existing multipath maps. | help + man |
-i | Ignore WWIDs file when processing devices. | help + man |
-B | Treat the bindings file as read only. | help + man |
-b fil | (deprecated, do not use) Set user_friendly_names bindings file location. | help + man |
-w | remove a device from the wwids file | help |
-W | reset the wwids file include only the current devices | help |
-R num | Number of times to retry flushing multipath devices that are in use. | help + man |
-u | check if the device specified in the program environment should be a path in a multipath device | help |
-U | check if the device specified in the program environment is a multipath device with usable paths, see -C flag | help |
-p pol | Force new maps to use the specified policy, overriding the configuration in multipath.conf(5). | help + man |
-v lvl | Verbosity of information printed to stdout in default and "list" operation modes. | help + man |
Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.