Initial git import.
[multipath-tools/.git] / README
1 Dependancies :
2 ==============
3
4 These libs have been dropped in the multipath tree :
5   
6 o libdevmapper : comes with device-mapper-XXXX.tar.gz
7   See www.sistina.com
8 o libsysfs : comes with sysutils or udev
9   See ftp.kernel.org/pub/linux/utils/kernel/hotplug/
10 o klibc
11   See ftp.kernel.org/pub/linux/libs/klibc/
12
13 External :
14
15 o Linux kernel 2.6.10-rc with udm2 patchset (or greater)
16   ftp://sources.redhat.com/pub/dm/
17   
18 How it works :
19 ==============
20
21 Get a path list in sysfs.
22
23 For each path, a wwid is retrieved by a callout program.
24 Only White Listed HW can retrieve this info.
25
26 Coalesce the paths according to pluggable policies and store
27  the result in mp array.
28
29 Feed the maps to the kernel device mapper.
30
31 The naming of the corresponding block device is handeld 
32 by udev with the help of the devmap_name proggy. It is 
33 called by the following rule in /etc/udev/udev.rules :
34
35 KERNEL="dm-[0-9]*", PROGRAM="/sbin/devmap_name %M %m", \
36 NAME="%k", SYMLINK="%c"
37
38 Notes :
39 =======
40
41 o 2.4.21 version of DM does not like even segment size.
42   if you enconter pbs with this, upgrade DM.
43
44 Credits :
45 =========
46
47 o Heavy cut'n paste from sg_utils. Thanks goes to D. 
48   Gilbert.
49 o Light cut'n paste from dmsetup. Thanks Joe Thornber.
50 o Greg KH for the nice sysfs API.
51 o The klibc guys (Starving Linux Artists :), espacially
52   for their nice Makefiles and specfile