1KPARTX(8)                   System Manager's Manual                  KPARTX(8)
2
3
4

NAME

6       kpartx - Create device maps from partition tables.
7

SYNOPSIS

9       kpartx [-a|-d|-u|-l] [-r] [-p] [-f] [-g] [-s] [-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       -d     Delete partition mappings.
21
22       -u     Update partition mappings.
23
24       -l     List partition mappings that would be added -a.
25
26       -r     Read-only partition mappings.
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       -s     Sync mode. Don't return until the partitions are created.
35
36       -v     Operate verbosely.
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              add map loop1p1 (254:4): 0 409597 linear 7:1 3
46
47       The loop1p1 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/loop1p1
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.
62
63       multipath-tools was developed by Christophe  Varoqui  <christophe.varo‐
64       qui@opensvc.com> and others.
65
66
67
68Linux                             2016-10-28                         KPARTX(8)