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 \|]
  10 .RB [\| \-i\ \c
  11 .IR int \|]
  12 .RB [\| \-p\ \c
  13 .BR failover | multibus | group_by_serial | group_by_prio | group_by_node_name \|]
  14 .RB [\| -S \|]
  15 .RB [\| device \|]
  16 .SH DESCRIPTION
  17 .B multipath
  18 is used to detect multiple paths to devices for fail-over or performance reasons and coalesces them
  19 .SH OPTIONS
  20 .TP
  21 .B \-v " level"
  22 verbosity, print all paths and multipaths
  23 .RS 1.2i
  24 .TP 1.2i
  25 .B 0
  26 no output
  27 .TP
  28 .B 1
  29 print the created or updated multipath names only, for use to feed other tools like kpartx
  30 .TP
  31 .B 2 +
  32 print all info : detected paths, coalesced paths (ie multipaths) and device maps
  33 .RE
  34 .TP
  35 .B \-d
  36 dry run, do not create or update devmaps
  37 .TP
  38 .B \-l
  39 list the current multipath configuration
  40 .TP
  41 .TP
  42 .BI \-i " interval"
  43 multipath target param: polling interval
  44 .TP
  45 .BI \-D " major:minor"
  46 update only the devmap the path pointed by
  47 .I major:minor
  48 is in
  49 .TP
  50 .B \-F
  51 flush all the 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 .B \-S
  74 do not send signal to multipathd. -d activate this silently.
  75 .TP
  76 .BI device
  77 update only the devmap the path pointed by
  78 .I device
  79 is in.
  80 .I device
  81 is in the /dev/sdb (as shown by udev in the $DEVNAME variable) or major:minor format.
  82 .I device
  83 may alternatively be a multipath mapname
  84 .SH "SEE ALSO"
  85 .BR udev (8),
  86 .BR dmsetup (8)
  87 .BR hotplug (8)
  88 .SH AUTHORS
  89 .B multipath
  90 was developed by Christophe Varoqui, <christophe.varoqui@free.fr> and others.