multipath/multipath.8

   1 .TH MULTIPATH 8 "July 2006" "" "Linux Administrator's Manual"
   2 .SH NAME
   3 multipath \- Device mapper target autoconfig
   4 .SH SYNOPSIS
   5 .B multipath
   6 .RB [\| \-v\ \c
   7 .IR verbosity \|]
   8 .RB [\| \-b\ \c
   9 .IR bindings_file \|]
  10 .RB [\| \-d \|]
  11 .RB [\| \-h | \-l | \-ll | \-f | \-t | \-F | \-B | \-c | \-q | \|-r | \-w | \-W \|]
  12 .RB [\| \-p\ \c
  13 .BR failover | multibus | group_by_serial | group_by_prio | group_by_node_name \|]
  14 .RB [\| device \|]
  15 .SH DESCRIPTION
  16 .B multipath
  17 is used to detect and coalesce multiple paths to devices, for fail-over or performance reasons.
  18 .SH OPTIONS
  19 .TP
  20 .B \-v " level"
  21 verbosity, print all paths and multipaths
  22 .RS 1.2i
  23 .TP 1.2i
  24 .B 0
  25 no output
  26 .TP
  27 .B 1
  28 print the created or updated multipath names only, for use to feed other tools like kpartx
  29 .TP
  30 .B 2 +
  31 print all info : detected paths, coalesced paths (ie multipaths) and device maps
  32 .RE
  33 .TP
  34 .B \-h
  35 print usage text
  36 .TP
  37 .B \-d
  38 dry run, do not create or update devmaps
  39 .TP
  40 .B \-l
  41 show the current multipath topology from information fetched in sysfs and the device mapper
  42 .TP
  43 .B \-ll
  44 show the current multipath topology from all available information (sysfs, the device mapper, path checkers ...)
  45 .TP
  46 .B \-f
  47 flush a multipath device map specified as parameter, if unused
  48 .TP
  49 .B \-F
  50 flush all unused multipath device maps
  51 .TP
  52 .B \-t
  53 print internal hardware table to stdout
  54 .TP
  55 .B \-r
  56 force devmap reload
  57 .TP
  58 .B \-B
  59 treat the bindings file as read only
  60 .TP
  61 .B \-b " bindings_file"
  62 set user_friendly_names bindings file location.  The default is
  63 /etc/multipath/bindings
  64 .TP
  65 .B \-c
  66 check if a block device should be a path in a multipath device
  67 .TP
  68 .B \-q
  69 allow device tables with queue_if_no_path when multipathd is not running
  70 .TP
  71 .B \-w
  72 remove the wwid for the specified device from the wwids file
  73 .TP
  74 .B \-W
  75 reset the wwids file to only include the current multipath devices
  76 .TP
  77 .BI \-p " policy"
  78 force new maps to use the specified policy:
  79 .RS 1.2i
  80 .TP 1.2i
  81 .B failover
  82 1 path per priority group
  83 .TP
  84 .B multibus
  85 all paths in 1 priority group
  86 .TP
  87 .B group_by_serial
  88 1 priority group per serial
  89 .TP
  90 .B group_by_prio
  91 1 priority group per priority value. Priorities are determined by callout programs specified as a global, per-controller or per-multipath option in the configuration file
  92 .TP
  93 .B group_by_node_name
  94 1 priority group per target node name. Target node names are fetched
  95 in /sys/class/fc_transport/target*/node_name.
  96 .TP
  97 .RE
  98 Existing maps are not modified.
  99 .TP
 100 .BI device
 101 update only the devmap specified by
 102 .IR device ,
 103 which is either:
 104 .RS 1.2i
 105 .IP \[bu]
 106 a devmap name
 107 .IP \[bu]
 108 a path associated with the desired devmap; the path may be in one of the following formats:
 109 .RS 1.2i
 110 .IP \[bu]
 111 .B /dev/sdb
 112 .IP \[bu]
 113 .B major:minor
 114 .SH "SEE ALSO"
 115 .BR multipathd (8),
 116 .BR multipath.conf (5),
 117 .BR kpartx (8),
 118 .BR udev (8),
 119 .BR dmsetup (8)
 120 .BR hotplug (8)
 121 .SH AUTHORS
 122 .B multipath
 123 was developed by Christophe Varoqui, <christophe.varoqui@opensvc.com> and others.