OS Manuals

/usr/bin/multipath

Device Mapper Multipathing Driver

From multipath-tools 0.15.1-r1 (os), captured 2026-11-09 by running multipath --help (exit 1). permalink

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)
OptionDescriptionSource
-hprint this usage texthelp
-lshow multipath topology (sysfs and DM info)help
-llshow multipath topology (maximum info)help
-eenable foreign libraries with -l/-llhelp + man
-fflush a multipath device maphelp
-Fflush all multipath device mapshelp
-aadd a device wwid to the wwids filehelp
-ccheck if a device should be a path in a multipath devicehelp
-Ccheck if a multipath device has usable pathshelp
-qDon't unset the device mapper feature queue_if_no_path for multipath maps.help + man
-dDry run, do not create or update devmaps.help + man
-tdisplay the currently used multipathd configurationhelp
-Tdisplay the multipathd configuration without builtin defaultshelp
-rForce a reload of all existing multipath maps.help + man
-iIgnore WWIDs file when processing devices.help + man
-BTreat the bindings file as read only.help + man
-b fil(deprecated, do not use) Set user_friendly_names bindings file location.help + man
-wremove a device from the wwids filehelp
-Wreset the wwids file include only the current deviceshelp
-R numNumber of times to retry flushing multipath devices that are in use.help + man
-ucheck if the device specified in the program environment should be a path in a multipath devicehelp
-Ucheck if the device specified in the program environment is a multipath device with usable paths, see -C flaghelp
-p polForce new maps to use the specified policy, overriding the configuration in multipath.conf(5).help + man
-v lvlVerbosity 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.