1KPARTX(8)                Linux Administrator's Manual                KPARTX(8)
2
3
4

NAME

6       kpartx - Create device maps from partition tables
7

SYNOPSIS

9       kpartx [-a | -d | -l] [-v] wholedisk
10

DESCRIPTION

12       This  tool,  derived  from util-linux' partx, reads partition tables on
13       specified device  and  create  device  maps  over  partitions  segments
14       detected. It is called from hotplug upon device maps creation and dele‐
15       tion.
16

OPTIONS

18       -a     Add partition mappings
19
20       -r     Read-only partition mappings
21
22       -d     Delete partition mappings
23
24       -u     Update partition mappings
25
26       -l     List partition mappings that would be added -a
27
28       -p     set device name-partition number delimiter
29
30       -f     force creation of mappings; overrides 'no_partitions' feature
31
32       -g     force GUID partition table (GPT)
33
34       -v     Operate verbosely
35
36       -s     Sync mode. Don't return until the partitions are created
37

EXAMPLE

39       To mount all the partitions in a raw disk image:
40
41              kpartx -av disk.img
42
43       This will output lines such as:
44
45              loop3p1 : 0 20964762 /dev/loop3 63
46
47       The loop3p1 is the name of a device file under  /dev/mapper  which  you
48       can use to access the partition, for example to fsck it:
49
50              fsck /dev/mapper/loop3p1
51
52       When you're done, you need to remove the devices:
53
54              kpartx -d disk.img
55

SEE ALSO

57       multipath(8) multipathd(8) hotplug(8)
58

AUTHORS

60       This  man  page  was  assembled  By  Patrick  Caulfield  for the Debian
61       project. From documentation provided by the multipath author Christophe
62       Varoqui, <christophe.varoqui@opensvc.com> and others.
63
64
65
66
67                                   July 2006                         KPARTX(8)