[dm-devel] [PATCH] Add kpartx example to manpage

[Ritesh Raj Sarraf]

From: Ritesh Raj Sarraf <rrs at researchut.com>

Thanks: Lars Wirzenius
Closes: 637538

Signed-off-by: Ritesh Raj Sarraf <rrs at debian.org>
---
 kpartx/kpartx.8 |   20 ++++++++++++++++++++
 1 files changed, 20 insertions(+), 0 deletions(-)

diff --git a/kpartx/kpartx.8 b/kpartx/kpartx.8
index 5d73d31..795a2e0 100644
--- a/kpartx/kpartx.8
+++ b/kpartx/kpartx.8
@@ -34,6 +34,26 @@ force GUID partition table (GPT)
 .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)
-- 
1.7.5.4