kpartx [\|-a.BR|-d|-l\|] [\|-v\|] wholedisk


This tool, derived from util-linux' partx, reads partition tables on specified device and create device maps over partitions segments detected. It is called from hotplug upon device maps creation and deletion.



Add partition mappings


Read-only partition mappings


Delete partition mappings


Update partition mappings


List partition mappings that would be added -a


set device name-partition number delimiter


force creation of mappings; overrides 'no_partitions' feature


force GUID partition table (GPT)


Operate verbosely


Sync mode. Don't return until the partitions are created


To mount all the partitions in a raw disk image:

  • kpartx -av disk.img

This will output lines such as:

  • loop3p1 : 0 20964762 /dev/loop3 63

The loop3p1 is the name of a device file under /dev/mapper which you can use to access the partition, for example to fsck it:

  • fsck /dev/mapper/loop3p1

When you're done, you need to remove the devices:

  • kpartx -d disk.img

RELATED TO kpartx…


This man page was assembled By Patrick Caulfield for the Debian project. From documentation provided by the multipath author Christophe Varoqui, <[email protected]> and others.