multipath/multipath.conf.5

   1 .TH MULTIPATH.CONF 5 "30 November 2006"
   2 .SH NAME
   3 multipath.conf \- multipath daemon configuration file
   4 .SH DESCRIPTION
   5 .B "multipath.conf"
   6 is the configuration file for the multipath daemon. It is used to
   7 overwrite the built-in configuration table of \fBmultipathd\fP.
   8 Any line whose first non-white-space character is a '#' is considered
   9 a comment line. Empty lines are ignored.
  10 .SH SYNTAX
  11 The configuration file contains entries of the form:
  12 .RS
  13 .nf
  14 .ft B
  15 .sp
  16 <section> {
  17 .RS
  18 .ft B
  19 <attribute> <value>
  20 .I "..."
  21 .ft B
  22 <subsection> {
  23 .RS
  24 .ft B
  25 <attribute> <value>
  26 .I "..."
  27 .RE
  28 }
  29 .RE
  30 }
  31 .ft R
  32 .fi
  33 .RE
  34 .LP
  35 Each \fIsection\fP contains one or more attributes or subsections. The
  36 recognized keywords for attributes or subsections depend on the
  37 section in which they occur.
  38 .LP
  39 The following \fIsection\fP keywords are recognized:
  40 .TP 17
  41 .B defaults
  42 This section defines default values for attributes which are used
  43 whenever no values are given in the appropriate device or multipath
  44 sections.
  45 .TP
  46 .B blacklist
  47 This section defines which devices should be excluded from the
  48 multipath topology discovery.
  49 .TP
  50 .B blacklist_exceptions
  51 This section defines which devices should be included in the
  52 multipath topology discovery, despite being listed in the
  53 .I blacklist
  54 section.
  55 .TP
  56 .B multipaths
  57 This section defines the multipath topologies. They are indexed by a
  58 \fIWorld Wide Identifier\fR(wwid). For details on the wwid generation
  59 see section \fBWWID generation\fR below.
  60 .TP
  61 .B devices
  62 This section defines the device-specific settings.
  63 .TP
  64 .B overrides
  65 This section defines values for attributes that should override the
  66 device-specific settings for all devices.
  67 .RE
  68 .LP
  69 .SH "defaults section"
  70 The
  71 .B defaults
  72 section recognizes the following keywords:
  73 .TP 17
  74 .B polling_interval
  75 interval between two path checks in seconds. For properly functioning paths,
  76 the interval between checks will gradually increase to
  77 .B max_polling_interval.
  78 This value will be overridden by the
  79 .B WatchdogSec
  80 setting in the multipathd.service definition if systemd is used.
  81 Default is
  82 .I 5
  83 .TP
  84 .B max_polling_interval
  85 maximal interval between two path checks in seconds; default is
  86 .I 4 * polling_interval
  87 .TP
  88 .B multipath_dir
  89 directory where the dynamic shared objects are stored; default is system
  90 dependent, commonly
  91 .I /lib/multipath
  92 .TP
  93 .B find_multipaths
  94 If set to
  95 .I yes
  96 , instead of trying to create a multipath device for every non-blacklisted
  97 path, multipath will only create a device if one of three condidions are
  98 met.
  99 .I 1
 100 There are at least two non-blacklisted paths with the same wwid,
 101 .I 2
 102 the user manually forces the creation, by specifying a device with the multipath
 103 command, or
 104 .I 3
 105 a path has the same WWID as a multipath device that was previously created
 106 while find_multipaths was set (even if that multipath device doesn't currently
 107 exist).
 108 Whenever a multipath device is created with find_multipaths set, multipath will
 109 remeber the WWID of the device, so that it will automatically create the
 110 device again, as soon as it sees a path with that WWID. This should allow most
 111 users to have multipath automatically choose the correct paths to make into
 112 multipath devices, without having to edit the blacklist; Default is
 113 .I no
 114 .TP
 115 .B verbosity
 116 default verbosity. Higher values increase the verbosity level. Valid
 117 levels are between 0 and 6; default is
 118 .I 2
 119 .TP
 120 .B reassign_maps
 121 enable reassigning of device-mapper maps. With this option multipathd
 122 will remap existing device-mapper maps to always point to multipath
 123 device, not the underlying block devices. Possible values are
 124 \fIyes\fR and \fIno\fR. Default is
 125 .I yes
 126 .TP
 127 .B path_selector
 128 The default path selector algorithm to use; they are offered by the
 129 kernel multipath target. There are three selector algorithms.
 130 .RS
 131 .TP 12
 132 .B "round-robin 0"
 133 Loop through every path in the path group, sending the same amount of IO to
 134 each.
 135 .TP
 136 .B "queue-length 0"
 137 Send the next bunch of IO down the path with the least amount of outstanding IO.
 138 .TP
 139 .B "service-time 0"
 140 Choose the path for the next bunch of IO based on the amount of outstanding IO
 141 to the path and its relative throughput.
 142 .RE
 143 .TP
 144 .B path_grouping_policy
 145 The default path grouping policy to apply to unspecified
 146 multipaths. Possible values are
 147 .RS
 148 .TP 12
 149 .B failover
 150 1 path per priority group
 151 .TP
 152 .B multibus
 153 all paths in 1 priority group
 154 .TP
 155 .B group_by_serial
 156 1 priority group per serial number
 157 .TP
 158 .B group_by_prio
 159 1 priority group per priority value. Priorities are determined by
 160 callout programs specified as a global, per-controller or
 161 per-multipath option in the configuration file.
 162 .TP
 163 .B group_by_node_name
 164 1 priority group per target node name. Target node names are fetched
 165 in /sys/class/fc_transport/target*/node_name.
 166 .TP
 167 Default value is \fIfailover\fR.
 168 .RE
 169 .TP
 170 .B uid_attribute
 171 The udev attribute providing a unique path
 172 identifier. Default value is
 173 .I ID_SERIAL
 174 .TP
 175 .B getuid_callout
 176 The default program and args to callout to obtain a unique path
 177 identifier. Should be specified with an absolute path.
 178 This parameter is deprecated.
 179 .TP
 180 .B prio
 181 The name of the path priority routine. The specified routine
 182 should return a numeric value specifying the relative priority
 183 of this path. Higher number have a higher priority.
 184 .I "none"
 185 is a valid value. Currently the following path priority routines
 186 are implemented:
 187 .RS
 188 .TP 12
 189 .B const
 190 Return a constant priority of \fI1\fR.
 191 .TP
 192 .B emc
 193 Generate the path priority for EMC arrays.
 194 .TP
 195 .B alua
 196 Generate the path priority based on the SCSI-3 ALUA settings. This prioritizer
 197 accepts the optional prio_arg
 198 .I exclusive_pref_bit
 199 .TP
 200 .B ontap
 201 Generate the path priority for NetApp arrays.
 202 .TP
 203 .B rdac
 204 Generate the path priority for LSI/Engenio/NetApp E-Series RDAC controller.
 205 .TP
 206 .B hp_sw
 207 Generate the path priority for Compaq/HP controller in
 208 active/standby mode.
 209 .TP
 210 .B hds
 211 Generate the path priority for Hitachi HDS Modular storage arrays.
 212 .TP
 213 .B random
 214 Generate a random priority between 1 and 10.
 215 .TP 12
 216 .B weightedpath
 217 Generate the path priority based on the regular expression and the
 218 priority provided as argument. requires prio_args keyword.
 219 .TP
 220 Default value is \fBnone\fR.
 221 .RE
 222 .TP
 223 .B prio_args
 224 Arguments to pass to to the prio function. This only applies to certain
 225 prioritizers
 226 .RS
 227 .TP 12
 228 .B weighted
 229 Needs a value of the form
 230 .I "<hbtl|devname|wwn> <regex1> <prio1> <regex2> <prio2> ..."
 231 .I hbtl
 232 regex can be of SCSI H:B:T:L format  Ex: 1:0:.:. , *:0:0:.
 233 .I devname
 234 regex can be of device name format  Ex: sda , sd.e
 235 .I wwn
 236 regex can be of the form
 237 .I "host_wwnn:host_wwpn:target_wwnn:target_wwpn"
 238 these values can be looked up through sysfs or by running
 239 .I mulitpathd show paths format "%N:%R:%n:%r" Ex: 0x200100e08ba0aea0:0x210100e08ba0aea0:.*:.* , .*:.*:iqn.2009-10.com.redhat.msp.lab.ask-06:.*
 240 .TP
 241 .B alua
 242 If
 243 .I exclusive_pref_bit
 244 is set, paths with the TPGS pref bit set will always be in their own path
 245 group.
 246 .RE
 247 .TP
 248 .B features
 249 Specify any device-mapper features to be used. Syntax is
 250 .I num list
 251 where
 252 .I num
 253 is the number of features in
 254 .I list.
 255 Possible values for the feature list are
 256 .RS
 257 .TP 12
 258 .B queue_if_no_path
 259 Queue IO if no path is active; identical to the
 260 .I no_path_retry
 261 keyword.
 262 .TP
 263 .B no_partitions
 264 Disable automatic partitions generation via kpartx.
 265 .RE
 266 .TP
 267 .B path_checker
 268 The default method used to determine the paths state. Possible values
 269 are
 270 .RS
 271 .TP 12
 272 .B readsector0
 273 (Deprecated) Read the first sector of the device. This checker is being
 274 deprecated, please use \fIdirectio\fR instead
 275 .TP
 276 .B tur
 277 Issue a
 278 .I TEST UNIT READY
 279 command to the device.
 280 .TP
 281 .B emc_clariion
 282 Query the EMC Clariion specific EVPD page 0xC0 to determine the path
 283 state.
 284 .TP
 285 .B hp_sw
 286 Check the path state for HP storage arrays with Active/Standby firmware.
 287 .TP
 288 .B rdac
 289 Check the path state for LSI/Engenio/NetApp E-Series RDAC storage controller.
 290 .TP
 291 .B directio
 292 Read the first sector with direct I/O.
 293 .TP
 294 Default value is \fIdirectio\fR.
 295 .RE
 296 .TP
 297 .B failback
 298 Tell multipathd how to manage path group failback.
 299 .RS
 300 .TP 12
 301 .B immediate
 302 Immediately failback to the highest priority pathgroup that contains
 303 active paths.
 304 .TP
 305 .B manual
 306 Do not perform automatic failback.
 307 .TP
 308 .B followover
 309 Only perform automatic failback when the first path of a pathgroup
 310 becomes active. This keeps a node from automatically failing back when
 311 another node requested the failover.
 312 .TP
 313 .B values > 0
 314 deferred failback (time to defer in seconds)
 315 .TP
 316 Default value is \fImanual\fR.
 317 .RE
 318 .TP
 319 .B  rr_min_io
 320 The number of IO to route to a path before switching to the next in
 321 the same path group. This is only for BIO based multipath. Default is
 322 .I 1000
 323 .TP
 324 .B rr_min_io_rq
 325 The number of IO requests to route to a path before switching to the
 326 next in the same path group. This is only for request based multipath.
 327 Default is
 328 .I 1
 329 .TP
 330 .B rr_weight
 331 If set to \fIpriorities\fR the multipath configurator will assign
 332 path weights as "path prio * rr_min_io". Possible values are
 333 .I priorities
 334 or
 335 .IR uniform .
 336 Default is
 337 .IR uniform .
 338 .TP
 339 .B no_path_retry
 340 Specify the number of retries until disable queueing, or
 341 .I fail
 342 for immediate failure (no queueing),
 343 .I queue
 344 for never stop queueing. If unset no queueing is attempted.
 345 Default is unset.
 346 .TP
 347 .B user_friendly_names
 348 If set to
 349 .I yes
 350 , using the bindings file
 351 .I /etc/multipath/bindings
 352 to assign a persistent and unique alias to the multipath, in the form of mpath<n>.
 353 If set to
 354 .I no
 355 use the WWID as the alias. In either case this be will
 356 be overridden by any specific aliases in the \fImultipaths\fR section.
 357 Default is
 358 .I no
 359 .TP
 360 .B flush_on_last_del
 361 If set to
 362 .I yes
 363 , multipathd will disable queueing when the last path to a device has been
 364 deleted. Default is
 365 .I no
 366 .TP
 367 .B max_fds
 368 Specify the maximum number of file descriptors that can be opened by multipath
 369 and multipathd.  This is equivalent to ulimit \-n. A value of \fImax\fR will set
 370 this to the system limit from /proc/sys/fs/nr_open. If this is not set, the
 371 maximum number of open fds is taken from the calling process. It is usually
 372 1024. To be safe, this should be set to the maximum number of paths plus 32,
 373 if that number is greated than 1024.
 374 .TP
 375 .B checker_timeout
 376 Specify the timeout to use for path checkers and prioritizers that issue scsi
 377 commands with an explicit timeout, in seconds; default taken from
 378 .I /sys/block/sd<x>/device/timeout
 379 .TP
 380 .B fast_io_fail_tmo
 381 Specify the number of seconds the scsi layer will wait after a problem has been
 382 detected on a FC remote port before failing IO to devices on that remote port.
 383 This should be smaller than dev_loss_tmo. Setting this to
 384 .I off
 385 will disable the timeout.
 386 .TP
 387 .B dev_loss_tmo
 388 Specify the number of seconds the scsi layer will wait after a problem has
 389 been detected on a FC remote port before removing it from the system. This
 390 can be set to "infinity" which sets it to the max value of 2147483647
 391 seconds, or 68 years. It will be automatically adjusted to the overall
 392 retry interval
 393 \fIno_path_retry\fR * \fIpolling_interval\fR
 394 if a number of retries is given with \fIno_path_retry\fR and the
 395 overall retry interval is longer than the specified \fIdev_loss_tmo\fR value.
 396 The linux kernel will cap this value to \fI300\fR if \fBfast_io_fail_tmo\fR
 397 is not set. Default is 600.
 398 .TP
 399 .B queue_without_daemon
 400 If set to
 401 .I no
 402 , when multipathd stops, queueing will be turned off for all devices.
 403 This is useful for devices that set no_path_retry.  If a machine is
 404 shut down while all paths to a device are down, it is possible to hang waiting
 405 for IO to return from the device after multipathd has been stopped. Without
 406 multipathd running, access to the paths cannot be restored, and the kernel
 407 cannot be told to stop queueing IO. Setting queue_without_daemon to
 408 .I no
 409 , avoids this problem. Default is
 410 .I no
 411 .TP
 412 .B bindings_file
 413 The full pathname of the binding file to be used when the user_friendly_names option is set. Defaults to
 414 .I /etc/multipath/bindings
 415 .TP
 416 .B wwids_file
 417 The full pathname of the wwids file, which is used by multipath to keep track
 418 of the wwids for LUNs it has created multipath devices on in the past.
 419 Defaults to
 420 .I /etc/multipath/wwids
 421 .TP
 422 .B log_checker_err
 423 If set to
 424 .I once
 425 , multipathd logs the first path checker error at logging level 2. Any later
 426 errors are logged at level 3 until the device is restored. If set to
 427 .I always
 428 , multipathd always logs the path checker error at logging level 2. Default is
 429 .I always
 430 .TP
 431 .B reservation_key
 432 This is the service action reservation key used by mpathpersist.  It must be
 433 set for all multipath devices using persistent reservations, and it must be
 434 the same as the RESERVATION KEY field of the PERSISTENT RESERVE OUT parameter
 435 list which contains an 8-byte value provided by the application client to the
 436 device server to identify the I_T nexus. It is unset by default.
 437 .TP
 438 .B retain_attached_hw_handler
 439 If set to
 440 .I yes
 441 and the scsi layer has already attached a hardware_handler to the device,
 442 multipath will not force the device to use the hardware_handler specified by
 443 mutipath.conf. If the scsi layer has not attached a hardware handler,
 444 multipath will continue to use its configured hardware handler. Default is
 445 .I no
 446 .TP
 447 .B detect_prio
 448 If set to
 449 .I yes
 450 , multipath will try to detect if the device supports ALUA. If so, the device
 451 will automatically use the
 452 .I alua
 453 prioritizer. If not, the prioritizer will be selected as usual. Default is
 454 .I no
 455 .TP
 456 .B force_sync
 457 If set to
 458 .I yes
 459 , multipathd will call the path checkers in sync mode only.  This means that
 460 only one checker will run at a time.  This is useful in the case where many
 461 multipathd checkers running in parallel causes significant CPU pressure. The
 462 Default is
 463 .I no
 464 .TP
 465 .B deferred_remove
 466 If set to
 467 .I yes
 468 , multipathd will do a deferred remove instead of a regular remove when the
 469 last path device has been deleted.  This means that if the multipath device is
 470 still in use, it will be freed when the last user closes it.  If path is added
 471 to the multipath device before the last user closes it, the deferred remove
 472 will be canceled. Default is
 473 .I no
 474 .TP
 475 .B config_dir
 476 If set to anything other than "", multipath will search this directory
 477 alphabetically for file ending in ".conf" and it will read configuration
 478 information from them, just as if it was in /etc/multipath.conf.  config_dir
 479 must either be "" or a fully qualified directory name. Default is
 480 .I "/etc/multipath/conf.d"
 481 .TP
 482 .B delay_watch_checks
 483 If set to a value greater than 0, multipathd will watch paths that have
 484 recently become valid for this many checks.  If they fail again while they are
 485 being watched, when they next become valid, they will not be used until they
 486 have stayed up for
 487 .I delay_wait_checks
 488 checks. Default is
 489 .I no
 490 .TP
 491 .B delay_wait_checks
 492 If set to a value greater than 0, when a device that has recently come back
 493 online fails again within
 494 .I delay_watch_checks
 495 checks, the next time it comes back online, it will marked and delayed, and not
 496 used until it has passed
 497 .I delay_wait_checks
 498 checks. Default is
 499 .I no
 500 .TP
 501 .B strict_timinig
 502 If set to
 503 .I yes
 504 , multipathd will start a new path checker loop after exactly one second,
 505 so that each path check will occur at exactly
 506 .I polling_interval
 507 seconds. On busy systems path checks might take longer than one second;
 508 here the missing ticks will be accounted for on the next round.
 509 A warning will be printed if path checks take longer than
 510 .I polling_interval
 511 seconds.
 512 Default is
 513 .I no
 514 .TP
 515 .B uxsock_timeout
 516 CLI receive timeout in milliseconds. For larger systems CLI commands
 517 might timeout before the multipathd lock is released and the CLI command
 518 can be processed. This will result in errors like
 519 'timeout receiving packet' to be returned from CLI commands.
 520 In these cases it is recommended to increase the CLI timeout to avoid
 521 those issues. The default is
 522 .I 1000
 523 .TP
 524 .B missing_uev_wait_timeout
 525 Controls how many seconds multipathd will wait, after a new multipath device
 526 is created, to receive a change event from udev for the device, before
 527 automatically enabling device reloads. Usually multipathd will delay reloads
 528 on a device until it receives a change uevent from the initial table load. The
 529 default is
 530 .I 30
 531 .
 532 .SH "blacklist section"
 533 The
 534 .I blacklist
 535 section is used to exclude specific device from inclusion in the
 536 multipath topology. It is most commonly used to exclude local disks or
 537 LUNs for the array controller.
 538 .LP
 539 The following keywords are recognized:
 540 .TP 17
 541 .B wwid
 542 The \fIWorld Wide Identification\fR of a device.
 543 .TP
 544 .B devnode
 545 Regular expression of the device nodes to be excluded.
 546 .TP
 547 .B property
 548 Regular expression of the udev property to be excluded.
 549 .TP
 550 .B device
 551 Subsection for the device description. This subsection recognizes the
 552 .I vendor
 553 and
 554 .I product
 555 keywords. For a full description of these keywords please see the
 556 .I devices
 557 section description.
 558 .SH "blacklist_exceptions section"
 559 The
 560 .I blacklist_exceptions
 561 section is used to revert the actions of the
 562 .I blacklist
 563 section, ie to include specific device in the
 564 multipath topology. This allows one to selectively include devices which
 565 would normally be excluded via the
 566 .I blacklist
 567 section.
 568 .LP
 569 The following keywords are recognized:
 570 .TP 17
 571 .B wwid
 572 The \fIWorld Wide Identification\fR of a device.
 573 .TP
 574 .B property
 575 Regular expression of the udev property to be whitelisted. Defaults to
 576 .I (ID_WWN|SCSI_IDENT_.*)
 577 .TP
 578 .B devnode
 579 Regular expression of the device nodes to be whitelisted.
 580 .TP
 581 .B device
 582 Subsection for the device description. This subsection recognizes the
 583 .I vendor
 584 and
 585 .I product
 586 keywords. For a full description of these keywords please see the
 587 .I devices
 588 section description.
 589 .LP
 590 The
 591 .I property
 592 blacklist and whitelist handling is different from the usual handling
 593 in the sense that the whitelist
 594 .B has
 595 to be set, otherwise the device will be blacklisted.
 596 In these cases the message
 597 .I blacklisted, udev property missing
 598 will be displayed.
 599 .SH "multipaths section"
 600 The only recognized attribute for the
 601 .B multipaths
 602 section is the
 603 .I multipath
 604 subsection.
 605 .LP
 606 The
 607 .B multipath
 608 subsection recognizes the following attributes:
 609 .TP 17
 610 .B wwid
 611 Index of the container. Mandatory for this subsection.
 612 .TP
 613 .B alias
 614 (Optional) symbolic name for the multipath map.
 615 .LP
 616 The following attributes are optional; if not set the default values
 617 are taken from the
 618 .I defaults
 619 or
 620 .I devices
 621 section:
 622 .sp 1
 623 .PD .1v
 624 .RS
 625 .TP 18
 626 .B path_grouping_policy
 627 .TP
 628 .B path_selector
 629 .TP
 630 .B prio
 631 .TP
 632 .B prio_args
 633 .TP
 634 .B failback
 635 .TP
 636 .B rr_weight
 637 .TP
 638 .B flush_on_last_del
 639 .TP
 640 .B no_path_retry
 641 .TP
 642 .B rr_min_io
 643 .TP
 644 .B rr_min_io_rq
 645 .TP
 646 .B features
 647 .TP
 648 .B reservation_key
 649 .TP
 650 .B deferred_remove
 651 .TP
 652 .B delay_watch_checks
 653 .TP
 654 .B delay_wait_checks
 655 .RE
 656 .PD
 657 .LP
 658 .SH "devices section"
 659 The only recognized attribute for the
 660 .B devices
 661 section is the
 662 .I device
 663 subsection.
 664 .LP
 665 The
 666 .I device
 667 subsection recognizes the following attributes:
 668 .TP 17
 669 .B vendor
 670 (Mandatory) Vendor identifier
 671 .TP
 672 .B product
 673 (Mandatory) Product identifier
 674 .TP
 675 .B revision
 676 (Optional) Revision identfier
 677 .TP
 678 .B product_blacklist
 679 (Optional) Product strings to blacklist for this vendor
 680 .TP
 681 .B alias_prefix
 682 (Optional) The user_friendly_names prefix to use for this
 683 device type, instead of the default "mpath"
 684 .TP
 685 .B hardware_handler
 686 (Optional) The hardware handler to use for this device type.
 687 The following hardware handler are implemented:
 688 .RS
 689 .TP 12
 690 .B 1 emc
 691 Hardware handler for EMC storage arrays.
 692 .TP
 693 .B 1 rdac
 694 Hardware handler for LSI/Engenio/NetApp E-Series RDAC storage controller.
 695 .TP
 696 .B 1 hp_sw
 697 Hardware handler for Compaq/HP storage arrays in active/standby
 698 mode.
 699 .TP
 700 .B 1 alua
 701 Hardware handler for SCSI-3 ALUA compatible arrays.
 702 .RE
 703 .LP
 704 The following attributes are optional; if not set the default values
 705 are taken from the
 706 .I defaults
 707 section:
 708 .sp 1
 709 .PD .1v
 710 .RS
 711 .TP 18
 712 .B path_grouping_policy
 713 .TP
 714 .B uid_attribute
 715 .TP
 716 .B path_selector
 717 .TP
 718 .B path_checker
 719 .TP
 720 .B prio
 721 .TP
 722 .B prio_args
 723 .TP
 724 .B features
 725 .TP
 726 .B failback
 727 .TP
 728 .B rr_weight
 729 .TP
 730 .B no_path_retry
 731 .TP
 732 .B rr_min_io
 733 .TP
 734 .B rr_min_io_rq
 735 .TP
 736 .B fast_io_fail_tmo
 737 .TP
 738 .B dev_loss_tmo
 739 .TP
 740 .B flush_on_last_del
 741 .TP
 742 .B retain_attached_hw_handler
 743 .TP
 744 .B detect_prio
 745 .TP
 746 .B deferred_remove
 747 .TP
 748 .B delay_watch_checks
 749 .TP
 750 .B delay_wait_checks
 751 .RE
 752 .PD
 753 .LP
 754 .SH "overrides section"
 755 The overrides section recognizes the following optional attributes; if not set
 756 the values are taken from the
 757 .I devices
 758 or
 759 .I defaults
 760 sections:
 761 .sp 1
 762 .PD .1v
 763 .RS
 764 .TP 18
 765 .B path_grouping_policy
 766 .TP
 767 .B uid_attribute
 768 .TP
 769 .B getuid_callout
 770 .TP
 771 .B path_selector
 772 .TP
 773 .B path_checker
 774 .TP
 775 .B alias_prefix
 776 .TP
 777 .B features
 778 .TP
 779 .B prio
 780 .TP
 781 .B prio_args
 782 .TP
 783 .B failback
 784 .TP
 785 .B rr_weight
 786 .TP
 787 .B no_path_retry
 788 .TP
 789 .B rr_min_io
 790 .TP
 791 .B rr_min_io_rq
 792 .TP
 793 .B flush_on_last_del
 794 .TP
 795 .B fast_io_fail_tmo
 796 .TP
 797 .B dev_loss_tmo
 798 .TP
 799 .B user_friendly_names
 800 .TP
 801 .B retain_attached_hw_handler
 802 .TP
 803 .B detect_prio
 804 .TP
 805 .B deferred_remove
 806 .TP
 807 .B delay_watch_checks
 808 .TP
 809 .B delay_wait_checks
 810 .RE
 811 .PD
 812 .LP
 813 .SH "WWID generation"
 814 Multipath uses a \fIWorld Wide Identification\fR (wwid) to determine
 815 which paths belong to the same device. Each path presenting the same
 816 wwid is assumed to point to the same device.
 817 .LP
 818 The wwid is generated by three methods (in the order of preference):
 819 .TP 17
 820 .B getuid_callout
 821 Use the specified external program; cf \fIgetuid_callout\fR above.
 822 Care should be taken when using this method; the external program
 823 needs to be loaded from disk for execution, which might lead to
 824 deadlock situations in an all-paths-down scenario.
 825 .TP
 826 .B uid_attribute
 827 Use the value of the specified udev attribute; cf \fIuid_attribute\fR
 828 above. This method is preferred to \fIgetuid_callout\fR as multipath
 829 does not need to call any external programs here. However, under
 830 certain circumstances udev might not be able to generate the requested
 831 variable.
 832 .TP
 833 .B vpd_pg83
 834 If none of the \fIgetuid_callout\fR or \fIuid_attribute\fR parameters
 835 are present multipath will try to use the sysfs attribute
 836 \fIvpd_pg83\fR to generate the wwid.
 837 .SH "KNOWN ISSUES"
 838 The usage of
 839 .B queue_if_no_path
 840 option can lead to
 841 .B D state
 842 processes being hung and not killable in situations where all the paths to the LUN go offline.
 843 It is advisable to use the
 844 .B no_path_retry
 845 option instead.
 846 .P
 847 The use of
 848 .B queue_if_no_path
 849 or
 850 .B no_path_retry
 851 might lead to a deadlock if the
 852 .B dev_loss_tmo
 853 setting results in a device being removed while I/O is still queued.
 854 The multipath daemon will update the
 855 .B dev_loss_tmo
 856 setting accordingly to avoid this deadlock. Hence if both values are
 857 specified the order of precedence is
 858 .I no_path_retry, queue_if_no_path, dev_loss_tmo
 859
 860 .SH "SEE ALSO"
 861 .BR udev (8),
 862 .BR dmsetup (8)
 863 .BR multipath (8)
 864 .BR multipathd (8)
 865 .SH AUTHORS
 866 .B multipath
 867 was developed by Christophe Varoqui, <christophe.varoqui@opensvc.com> and others.