Bug#637538: kpartx(8) manpage is missing an example

[Lars Wirzenius]

Package: kpartx
Version: 0.4.8+git0.761c66f-9
Severity: minor

Here's a patch to add an example to the kpartx(8) manual page.

--- 8< --- 8< --- 8< ---

--- kpartx/kpartx.8.orig    2011-08-12 13:27:35.190051077 +0100
+++ kpartx/kpartx.8 2011-08-12 13:30:09.743851526 +0100
@@ -34,6 +34,26 @@
 .TP
 .B \-v
 Operate verbosely
+.SH EXAMPLE
+To mount all the partitions in a raw disk image:
+.IP
+kpartx -av disk.img
+.PP
+This will output lines such as:
+.IP
+loop3p1 : 0 20964762 /dev/loop3 63
+.PP
+The 
+.I loop3p1
+is the name of a device file under 
+.I /dev/mapper
+which you can use to access the partition, for example to fsck it:
+.IP
+fsck /dev/mapper/loop3p1
+.PP
+When you're done, you need to remove the devices:
+.IP
+kpartx -d disk.img
 .SH "SEE ALSO"
 .BR multipath (8)
 .BR multipathd (8)

--- 8< --- 8< --- 8< ---


-- System Information:
Debian Release: 6.0.2
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages kpartx depends on:
ii  dmsetup                      2:1.02.48-5 The Linux Kernel Device Mapper use
ii  libc6                        2.11.2-10   Embedded GNU C Library: Shared lib
ii  libdevmapper1.02.1           2:1.02.48-5 The Linux Kernel Device Mapper use
ii  udev                         164-3       /dev/ and hotplug management daemo

kpartx recommends no packages.

kpartx suggests no packages.

-- no debconf information