1MULTIPATHD(8) System Manager's Manual MULTIPATHD(8)
2
6 multipathd - multipath daemon
7
10 multipathd [options]
11
14 The multipathd daemon is in charge of checking for failed paths. When
15 this happens, it will reconfigure the multipath map the path belongs
16 to, so that this map regains its maximum performance and redundancy.
17 This daemon executes the external multipath config tool when events
19 occur. In turn, the multipath tool signals the multipathd daemon when
20 it is done with devmap reconfiguration, so that it can refresh its
21 failed path list.
22
25 -d Forground Mode. Don't daemonize, and print all messages to std‐
26 out and stderr.
27 -v level
29 Verbosity level. Print additional information while running mul‐
30 tipathd. A level of 0 means only print errors. A level of 3 or
31 greater prints debugging information as well.
32 -k multipathd will enter interactive mode. From this mode, the
34 available commands can be viewed by entering "help". When you
35 are finished entering commands, press CTRL-D to quit.
36
39 The following commands can be used in interactive mode:
40 list|show paths
42 Show the paths that multipathd is monitoring, and their state.
43 list|show paths format $format
45 Show the paths that multipathd is monitoring, using a format
46 string with path format wildcards.
47 list|show paths raw format $format
49 Show the paths that multipathd is monitoring, using a format
50 string with path format wildcards. No headers will be printed
51 and no padding will be applied to the strings.
52 list|show status
54 Show the number of monitored paths in each path checker state.
55 list|show maps|multipaths
57 Show the multipath devices that the multipathd is monitoring.
58 list|show daemon
60 Show the current state of the multipathd daemon
61 list|show maps|multipaths format $format
63 Show the status of all multipath devices that the multipathd is
64 monitoring, using a format string with multipath format wild‐
65 cards.
66 list|show maps|multipaths raw format $format
68 Show the status of all multipath devices that the multipathd is
69 monitoring, using a format string with multipath format wild‐
70 cards. No headers will be printed and no padding will be applied
71 to the strings.
72 list|show maps|multipaths status
74 Show the status of all multipath devices that the multipathd is
75 monitoring.
76 list|show maps|multipaths stats
78 Show some statistics of all multipath devices that the multi‐
79 pathd is monitoring.
80 list|show maps|multipaths topology
82 Show the current multipath topology. Same as "multipath -ll".
83 list|show topology
85 Show the current multipath topology. Same as "multipath -ll".
86 list|show map|multipath $map topology
88 Show topology of a single multipath device specified by $map,
89 e.g. 36005076303ffc56200000000000010aa. This map could be
90 obtained from "list maps".
91 list|show wildcards
93 Show the format wildcards used in interactive commands taking
94 $format
95 list|show config
97 Show the currently used configuration, derived from default val‐
98 ues and values specified within the configuration file /etc/mul‐
99 tipath.conf.
100 list|show blacklist
102 Show the currently used blacklist rules, derived from default
103 values and values specified within the configuration file
104 /etc/multipath.conf.
105 list|show devices
107 Show all available block devices by name including the informa‐
108 tion if they are blacklisted or not.
109 add path $path
111 Add a path to the list of monitored paths. $path is as listed in
112 /sys/block (e.g. sda).
113 remove|del path $path
115 Stop monitoring a path. $path is as listed in /sys/block (e.g.
116 sda).
117 paths count
119 Show the number of monitored paths, and whether multipathd is
120 currently handling a uevent.
121 add map|multipath $map
123 Add a multipath device to the list of monitored devices. $map
124 can either be a device-mapper device as listed in /sys/block
125 (e.g. dm-0) or it can be the alias for the multipath device
126 (e.g. mpath1) or the uid of the multipath device (e.g.
127 36005076303ffc56200000000000010aa).
128 remove|del map|multipath $map
130 Stop monitoring a multipath device.
131 resize map|multipath $map
133 Resizes map $map to the given size
134 switch|switchgroup map|multipath $map group $group
136 Force a multipath device to switch to a specific path group.
137 $group is the path group index, starting with 1.
138 reconfigure
140 Reconfigures the multipaths. This should be triggered automati‐
141 cally after any hotplug event.
142 suspend map|multipath $map
144 Sets map $map into suspend state.
145 resume map|multipath $map
147 Resumes map $map from suspend state.
148 fail path $path
150 Sets path $path into failed state.
151 reinstate path $path
153 Resumes path $path from failed state.
154 disablequeueing maps|multipaths
156 Disable queueing on all multipath devices.
157 restorequeueing maps|multipaths
159 Restore queueing on all multipath devices.
160 disablequeueing map|multipath $map
162 Disable queuing on multipathed map $map
163 restorequeueing map|multipath $map
165 Restore queuing on multipathed map $map
166 forcequeueing daemon
168 Forces multipathd into queue_without_daemon mode, so that
169 no_path_retry queueing will not be disabled when the daemon
170 stops
171 restorequeueing daemon
173 Restores configured queue_without_daemon mode
174 map|multipath $map setprstatus
176 Enable persistent reservation management on $map
177 map|multipath $map unsetprstatus
179 Disable persistent reservation management on $map
180 map|multipath $map getprstatus
182 Get the current persistent reservation management status of $map
183 quit|exit
185 End interactive session.
186
189 multipath(8) kpartx(8) hotplug(8)
190
192 multipathd was developed by Christophe Varoqui, <christophe.varo‐
193 qui@free.fr> and others.
194Linux Administrator's Manual November 2009 MULTIPATHD(8)