1MULTIPATH(8) System Manager's Manual MULTIPATH(8)
2
6 multipath - Device mapper target autoconfig.
7
9 multipath [-v level] [-B|-d|-i|-q|-r] [-b file] [-p policy] [device]
10 multipath [-v level] [-R retries] -f device
12 multipath [-v level] [-R retries] -F
14 multipath [-v level] [-l|-ll] [device]
16 multipath [-v level] [-a|-w] device
18 multipath [-v level] [-A|-W]
20 multipath [-v level] [-i] [-c|-C] device
22 multipath [-v level] [-i] [-u|-U]
24 multipath [-h|-t|-T]
26
28 multipath is used to detect and coalesce multiple paths to devices, for
29 fail-over or performance reasons.
30
32 The device argument restricts multipath's operation to devices matching
33 the given expression. The argument may refer either to a multipath map
34 or to its components ("paths"). The expression may be in one of the
35 following formats:
36 device node file name of a device node, e.g. /dev/dm-10 or /dev/sda.
38 If the node refers to an existing device mapper device
39 representing a multipath map, this selects the map or its
40 paths, depending on the operation mode. Otherwise, it
41 selects a path device.
42 device ID kernel device number specified by major:minor numbers,
44 e.g. 65:16. This format can only be used for path
45 devices.
46 WWID a World Wide Identifier matching a multipath map or its
48 paths. To list WWIDs of devices present in the system,
49 use e.g. the command "multipath -d -v3 2>/dev/null".
50
52 The default operation mode is to detect and set up multipath maps from
53 the devices found in the system. Other operation modes are chosen by
54 using one of the following command line switches:
55 -f Flush (remove) a multipath device map specified as parameter, if
57 unused.
58 -F Flush (remove) all unused multipath device maps.
60 -l Show ("list") the current multipath topology from information
62 fetched in sysfs and the device mapper.
63 -ll Show ("list") the current multipath topology from all available
65 information (sysfs, the device mapper, path checkers ...).
66 -a Add the WWID for the specified device to the WWIDs file.
68 -A Add the WWIDs from any kernel command line mpath.wwid parameters
70 to the WWIDs file.
71 -w Remove the WWID for the specified device from the WWIDs file.
73 -W Reset the WWIDs file to only include the current multipath
75 devices.
76 -c Check if a block device should be a path in a multipath device.
78 -C Check if a multipath device has usable paths. This can be used
80 to test whether or not I/O on this device is likely to succeed.
81 The command itself doesn't attempt to do I/O on the device.
82 -u Check if the device specified in the program environment should
84 be a path in a multipath device.
85 -U Check if the device specified in the program environment is a
87 multipath device with usable paths. See -C.
88 -h Print usage text.
90 -t Display the currently used multipathd configuration.
92 -T Display the currently used multipathd configuration, limiting
94 the output to those devices actually present in the system. This
95 can be used a template for creating multipath.conf.
96
98 -v level
99 Verbosity of information printed to stdout in default and "list"
100 operation modes. The default level is -v 2.
101 0 Nothing is printed.
103 1 In default mode, Names/WWIDs of created or mod‐
105 ified multipath maps are printed. In list mode,
106 WWIDs of all multipath maps are printed.
107 2 In default mode, Topology of created or modi‐
109 fied multipath maps is printed. In list mode,
110 topology of all multipath maps is printed.
111 3 All detected paths and the topology of all mul‐
113 tipath maps are printed.
114 The verbosity level also controls the level of log and
116 debug messages printed to stderr. The default level corre‐
117 sponds to LOG_NOTICE (important messages that shouldn't be
118 missed in normal operation).
119 -d Dry run, do not create or update devmaps.
121 -i Ignore WWIDs file when processing devices. If find_multipaths
123 strict or find_multipaths no is set in multipath.conf, multipath
124 only considers devices that are listed in the WWIDs file. This
125 option overrides that behavior. For other values of find_multi‐
126 paths, this option has no effect. See the description of
127 find_multipaths in multipath.conf(5). This option should only
128 be used in rare circumstances.
129 -B Treat the bindings file as read only.
131 -b file
133 Set user_friendly_names bindings file location. The default is
134 /etc/multipath/bindings.
135 -q Don't unset the device mapper feature queue_if_no_path for mul‐
137 tipath maps. Normally, multipath would do so if multipathd is
138 not running, because only a running multipath daemon guarantees
139 that unusable paths are reinstated when they become usable
140 again.
141 -p policy
143 Force new maps to use the specified policy, overriding the con‐
144 figuration in multipath.conf(5). The possible values for policy
145 are the same as the values for path_grouping_policy in multi‐
146 path.conf(5). Existing maps are not modified.
147 -r Force a reload of all existing multipath maps. This command is
149 delegated to the multipathd daemon if it's running. In this
150 case, other command line switches of the multipath command have
151 no effect.
152 -R retries
154 Number of times to retry flushing multipath devices that are in
155 use. The default is 0.
156
158 multipathd(8), multipath.conf(5), kpartx(8), udev(8), dmsetup(8), hot‐
159 plug(8).
160
162 multipath-tools was developed by Christophe Varoqui <christophe.varo‐
163 qui@opensvc.com> and others.
164Linux 2018-10-10 MULTIPATH(8)