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.
 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 uxsock_timeout
 502 CLI receive timeout in milliseconds. For larger systems CLI commands
 503 might timeout before the multipathd lock is released and the CLI command
 504 can be processed. This will result in errors like
 505 'timeout receiving packet' to be returned from CLI commands.
 506 In these cases it is recommended to increase the CLI timeout to avoid
 507 those issues. The default is
 508 .I 1000
 509 .TP
 510 .B missing_uev_wait_timeout
 511 Controls how many seconds multipathd will wait, after a new multipath device
 512 is created, to receive a change event from udev for the device, before
 513 automatically enabling device reloads. Usually multipathd will delay reloads
 514 on a device until it receives a change uevent from the initial table load. The
 515 default is
 516 .I 30
 517 .
 518 .SH "blacklist section"
 519 The
 520 .I blacklist
 521 section is used to exclude specific device from inclusion in the
 522 multipath topology. It is most commonly used to exclude local disks or
 523 LUNs for the array controller.
 524 .LP
 525 The following keywords are recognized:
 526 .TP 17
 527 .B wwid
 528 The \fIWorld Wide Identification\fR of a device.
 529 .TP
 530 .B devnode
 531 Regular expression of the device nodes to be excluded.
 532 .TP
 533 .B property
 534 Regular expression of the udev property to be excluded.
 535 .TP
 536 .B device
 537 Subsection for the device description. This subsection recognizes the
 538 .I vendor
 539 and
 540 .I product
 541 keywords. For a full description of these keywords please see the
 542 .I devices
 543 section description.
 544 .SH "blacklist_exceptions section"
 545 The
 546 .I blacklist_exceptions
 547 section is used to revert the actions of the
 548 .I blacklist
 549 section, ie to include specific device in the
 550 multipath topology. This allows one to selectively include devices which
 551 would normally be excluded via the
 552 .I blacklist
 553 section.
 554 .LP
 555 The following keywords are recognized:
 556 .TP 17
 557 .B wwid
 558 The \fIWorld Wide Identification\fR of a device.
 559 .TP
 560 .B property
 561 Regular expression of the udev property to be whitelisted. Defaults to
 562 .I (ID_WWN|SCSI_IDENT_.*)
 563 .TP
 564 .B devnode
 565 Regular expression of the device nodes to be whitelisted.
 566 .TP
 567 .B device
 568 Subsection for the device description. This subsection recognizes the
 569 .I vendor
 570 and
 571 .I product
 572 keywords. For a full description of these keywords please see the
 573 .I devices
 574 section description.
 575 .LP
 576 The
 577 .I property
 578 blacklist and whitelist handling is different from the usual handling
 579 in the sense that the whitelist
 580 .B has
 581 to be set, otherwise the device will be blacklisted.
 582 In these cases the message
 583 .I blacklisted, udev property missing
 584 will be displayed.
 585 .SH "multipaths section"
 586 The only recognized attribute for the
 587 .B multipaths
 588 section is the
 589 .I multipath
 590 subsection.
 591 .LP
 592 The
 593 .B multipath
 594 subsection recognizes the following attributes:
 595 .TP 17
 596 .B wwid
 597 Index of the container. Mandatory for this subsection.
 598 .TP
 599 .B alias
 600 (Optional) symbolic name for the multipath map.
 601 .LP
 602 The following attributes are optional; if not set the default values
 603 are taken from the
 604 .I defaults
 605 or
 606 .I devices
 607 section:
 608 .sp 1
 609 .PD .1v
 610 .RS
 611 .TP 18
 612 .B path_grouping_policy
 613 .TP
 614 .B path_selector
 615 .TP
 616 .B prio
 617 .TP
 618 .B prio_args
 619 .TP
 620 .B failback
 621 .TP
 622 .B rr_weight
 623 .TP
 624 .B flush_on_last_del
 625 .TP
 626 .B no_path_retry
 627 .TP
 628 .B rr_min_io
 629 .TP
 630 .B rr_min_io_rq
 631 .TP
 632 .B features
 633 .TP
 634 .B reservation_key
 635 .TP
 636 .B deferred_remove
 637 .TP
 638 .B delay_watch_checks
 639 .TP
 640 .B delay_wait_checks
 641 .RE
 642 .PD
 643 .LP
 644 .SH "devices section"
 645 The only recognized attribute for the
 646 .B devices
 647 section is the
 648 .I device
 649 subsection.
 650 .LP
 651 The
 652 .I device
 653 subsection recognizes the following attributes:
 654 .TP 17
 655 .B vendor
 656 (Mandatory) Vendor identifier
 657 .TP
 658 .B product
 659 (Mandatory) Product identifier
 660 .TP
 661 .B revision
 662 (Optional) Revision identfier
 663 .TP
 664 .B product_blacklist
 665 (Optional) Product strings to blacklist for this vendor
 666 .TP
 667 .B alias_prefix
 668 (Optional) The user_friendly_names prefix to use for this
 669 device type, instead of the default "mpath"
 670 .TP
 671 .B hardware_handler
 672 (Optional) The hardware handler to use for this device type.
 673 The following hardware handler are implemented:
 674 .RS
 675 .TP 12
 676 .B 1 emc
 677 Hardware handler for EMC storage arrays.
 678 .TP
 679 .B 1 rdac
 680 Hardware handler for LSI/Engenio/NetApp E-Series RDAC storage controller.
 681 .TP
 682 .B 1 hp_sw
 683 Hardware handler for Compaq/HP storage arrays in active/standby
 684 mode.
 685 .TP
 686 .B 1 alua
 687 Hardware handler for SCSI-3 ALUA compatible arrays.
 688 .RE
 689 .LP
 690 The following attributes are optional; if not set the default values
 691 are taken from the
 692 .I defaults
 693 section:
 694 .sp 1
 695 .PD .1v
 696 .RS
 697 .TP 18
 698 .B path_grouping_policy
 699 .TP
 700 .B uid_attribute
 701 .TP
 702 .B path_selector
 703 .TP
 704 .B path_checker
 705 .TP
 706 .B prio
 707 .TP
 708 .B prio_args
 709 .TP
 710 .B features
 711 .TP
 712 .B failback
 713 .TP
 714 .B rr_weight
 715 .TP
 716 .B no_path_retry
 717 .TP
 718 .B rr_min_io
 719 .TP
 720 .B rr_min_io_rq
 721 .TP
 722 .B fast_io_fail_tmo
 723 .TP
 724 .B dev_loss_tmo
 725 .TP
 726 .B flush_on_last_del
 727 .TP
 728 .B retain_attached_hw_handler
 729 .TP
 730 .B detect_prio
 731 .TP
 732 .B deferred_remove
 733 .TP
 734 .B delay_watch_checks
 735 .TP
 736 .B delay_wait_checks
 737 .RE
 738 .PD
 739 .LP
 740 .SH "overrides section"
 741 The overrides section recognizes the following optional attributes; if not set
 742 the values are taken from the
 743 .I devices
 744 or
 745 .I defaults
 746 sections:
 747 .sp 1
 748 .PD .1v
 749 .RS
 750 .TP 18
 751 .B path_grouping_policy
 752 .TP
 753 .B uid_attribute
 754 .TP
 755 .B getuid_callout
 756 .TP
 757 .B path_selector
 758 .TP
 759 .B path_checker
 760 .TP
 761 .B alias_prefix
 762 .TP
 763 .B features
 764 .TP
 765 .B prio
 766 .TP
 767 .B prio_args
 768 .TP
 769 .B failback
 770 .TP
 771 .B rr_weight
 772 .TP
 773 .B no_path_retry
 774 .TP
 775 .B rr_min_io
 776 .TP
 777 .B rr_min_io_rq
 778 .TP
 779 .B flush_on_last_del
 780 .TP
 781 .B fast_io_fail_tmo
 782 .TP
 783 .B dev_loss_tmo
 784 .TP
 785 .B user_friendly_names
 786 .TP
 787 .B retain_attached_hw_handler
 788 .TP
 789 .B detect_prio
 790 .TP
 791 .B deferred_remove
 792 .TP
 793 .B delay_watch_checks
 794 .TP
 795 .B delay_wait_checks
 796 .RE
 797 .PD
 798 .LP
 799 .SH "WWID generation"
 800 Multipath uses a \fIWorld Wide Identification\fR (wwid) to determine
 801 which paths belong to the same device. Each path presenting the same
 802 wwid is assumed to point to the same device.
 803 .LP
 804 The wwid is generated by three methods (in the order of preference):
 805 .TP 17
 806 .B getuid_callout
 807 Use the specified external program; cf \fIgetuid_callout\fR above.
 808 Care should be taken when using this method; the external program
 809 needs to be loaded from disk for execution, which might lead to
 810 deadlock situations in an all-paths-down scenario.
 811 .TP
 812 .B uid_attribute
 813 Use the value of the specified udev attribute; cf \fIuid_attribute\fR
 814 above. This method is preferred to \fIgetuid_callout\fR as multipath
 815 does not need to call any external programs here. However, under
 816 certain circumstances udev might not be able to generate the requested
 817 variable.
 818 .TP
 819 .B vpd_pg83
 820 If none of the \fIgetuid_callout\fR or \fIuid_attribute\fR parameters
 821 are present multipath will try to use the sysfs attribute
 822 \fIvpd_pg83\fR to generate the wwid.
 823 .SH "KNOWN ISSUES"
 824 The usage of
 825 .B queue_if_no_path
 826 option can lead to
 827 .B D state
 828 processes being hung and not killable in situations where all the paths to the LUN go offline.
 829 It is advisable to use the
 830 .B no_path_retry
 831 option instead.
 832 .P
 833 The use of
 834 .B queue_if_no_path
 835 or
 836 .B no_path_retry
 837 might lead to a deadlock if the
 838 .B dev_loss_tmo
 839 setting results in a device being removed while I/O is still queued.
 840 The multipath daemon will update the
 841 .B dev_loss_tmo
 842 setting accordingly to avoid this deadlock. Hence if both values are
 843 specified the order of precedence is
 844 .I no_path_retry, queue_if_no_path, dev_loss_tmo
 845
 846 .SH "SEE ALSO"
 847 .BR udev (8),
 848 .BR dmsetup (8)
 849 .BR multipath (8)
 850 .BR multipathd (8)
 851 .SH AUTHORS
 852 .B multipath
 853 was developed by Christophe Varoqui, <christophe.varoqui@opensvc.com> and others.