README.md

   1 [![basic-build-and-ci](https://github.com/openSUSE/multipath-tools/actions/workflows/build-and-unittest.yaml/badge.svg)](https://github.com/openSUSE/multipath-tools/actions/workflows/build-and-unittest.yaml) [![compile and unit test on native arch](https://github.com/openSUSE/multipath-tools/actions/workflows/native.yaml/badge.svg)](https://github.com/openSUSE/multipath-tools/actions/workflows/native.yaml) [![compile and unit test on foreign arch](https://github.com/openSUSE/multipath-tools/actions/workflows/foreign.yaml/badge.svg)](https://github.com/openSUSE/multipath-tools/actions/workflows/foreign.yaml)
   2
   3 multipath-tools for Linux
   4 =========================
   5
   6
   7 https://github.com/opensvc/multipath-tools
   8
   9 This package provides the following binaries to drive the Device Mapper multipathing driver:
  10
  11 * multipath - Device mapper target autoconfig.
  12 * multipathd - Multipath daemon.
  13 * mpathpersist - Manages SCSI persistent reservations on dm multipath devices.
  14 * kpartx - Create device maps from partition tables.
  15
  16
  17 Releases
  18 ========
  19
  20 To get a specific X.Y.Z release, use one of the following method:
  21
  22
  23 Git
  24 ---
  25
  26     git clone https://github.com/opensvc/multipath-tools.git
  27     cd multipath-tools
  28     git tag
  29     git archive --format=tar.gz --prefix=multipath-tools-X.Y.Z/ X.Y.Z > ../multipath-tools-X.Y.Z.tar.gz
  30
  31
  32 Direct download
  33 ---------------
  34
  35     wget "https://github.com/opensvc/multipath-tools/archive/X.Y.Z.tar.gz" -O multipath-tools-X.Y.Z.tar.gz
  36
  37
  38 Browser
  39 -------
  40
  41 Go to: https://github.com/opensvc/multipath-tools/tags
  42 Select a release-tag and then click on "zip" or "tar.gz".
  43
  44
  45 Source code
  46 ===========
  47
  48 To get latest devel code:
  49
  50     git clone https://github.com/opensvc/multipath-tools.git
  51
  52 Github page: https://github.com/opensvc/multipath-tools
  53
  54
  55 Add storage devices
  56 ===================
  57
  58 Follow the instructions in the `libmultipath/hwtable.c` header.
  59
  60
  61 Mailing list
  62 ============
  63
  64 (subscribers-only)
  65 To subscribe and archives: https://www.redhat.com/mailman/listinfo/dm-devel
  66 Searchable: https://marc.info/?l=dm-devel
  67
  68
  69 Changelog
  70 =========
  71
  72 pre-0.4.5: https://web.archive.org/web/20070309224034/http://christophe.varoqui.free.fr/wiki/wakka.php?wiki=ChangeLog
  73 post-0.4.5: https://github.com/opensvc/multipath-tools/commits/master
  74
  75
  76 Maintainer
  77 ==========
  78
  79 Christophe Varoqui <christophe.varoqui@opensvc.com>
  80 Device-mapper development mailing list <dm-devel@redhat.com>
  81
  82
  83 Licence
  84 =======
  85
  86 The multipath-tools source code is covered by several different licences.
  87 Refer to the individual source files for details.
  88 Source files which do not specify a licence are shipped under LGPL-2.0
  89 (see `LICENSES/LGPL-2.0`).
  90