multipath/multipath.8

   1 .TH MULTIPATH 8 "February 2004" "" "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 [\| \-d \|]
   9 .RB [\| \-l | \-ll | \-f | \-F \|]
  10 .RB [\| \-p\ \c
  11 .BR failover | multibus | group_by_serial | group_by_prio | group_by_node_name \|]
  12 .RB [\| device \|]
  13 .SH DESCRIPTION
  14 .B multipath
  15 is used to detect multiple paths to devices for fail-over or performance reasons and coalesces them
  16 .SH OPTIONS
  17 .TP
  18 .B \-v " level"
  19 verbosity, print all paths and multipaths
  20 .RS 1.2i
  21 .TP 1.2i
  22 .B 0
  23 no output
  24 .TP
  25 .B 1
  26 print the created or updated multipath names only, for use to feed other tools like kpartx
  27 .TP
  28 .B 2 +
  29 print all info : detected paths, coalesced paths (ie multipaths) and device maps
  30 .RE
  31 .TP
  32 .B \-d
  33 dry run, do not create or update devmaps
  34 .TP
  35 .B \-l
  36 show the current multipath topology from information fetched in sysfs and the device mapper
  37 .TP
  38 .B \-ll
  39 show the current multipath topology from all available information (sysfs, the device mapper, path checkers ...)
  40 .TP
  41 .TP
  42 .BI \-D " major:minor"
  43 update only the devmap the path pointed by
  44 .I major:minor
  45 is in
  46 .TP
  47 .B \-f
  48 flush a multipath device map specified as parameter, if unused
  49 .TP
  50 .B \-F
  51 flush all unused multipath device maps
  52 .TP
  53 .BI \-p " policy"
  54 force maps to specified policy:
  55 .RS 1.2i
  56 .TP 1.2i
  57 .B failover
  58 1 path per priority group
  59 .TP
  60 .B multibus
  61 all paths in 1 priority group
  62 .TP
  63 .B group_by_serial
  64 1 priority group per serial
  65 .TP
  66 .B group_by_prio
  67 1 priority group per priority value. Priorities are determined by callout programs specified as a global, per-controler or per-multipath option in the configuration file
  68 .TP
  69 .B group_by_node_name
  70 1 priority group per target node name. Target node names are fetched in /sys/class/fc_transport/target*/node_name.
  71 .RE
  72 .TP
  73 .BI device
  74 update only the devmap the path pointed by
  75 .I device
  76 is in.
  77 .I device
  78 is in the /dev/sdb (as shown by udev in the $DEVNAME variable) or major:minor format.
  79 .I device
  80 may alternatively be a multipath mapname
  81 .SH "SEE ALSO"
  82 .BR udev (8),
  83 .BR dmsetup (8)
  84 .BR hotplug (8)
  85 .SH AUTHORS
  86 .B multipath
  87 was developed by Christophe Varoqui, <christophe.varoqui@free.fr> and others.