From: Ritesh Raj Sarraf <rrs@researchut.com>
Date: Wed, 17 Aug 2011 17:40:37 +0000 (+0530)
Subject: Add kpartx example to manpage
X-Git-Tag: upstream/0.5.0~94
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=fa7074f35c67ff1ef29f1aea5a484c5dea25863a;p=platform%2Fupstream%2Fmultipath-tools.git

Add kpartx example to manpage

Thanks: Lars Wirzenius
Closes: 637538

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>
---

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)