[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

[lvm-devel] Patch for adding --resize to manpage



Here is proposal for adding documentation about --resizefs, --nofsck,--force option for lvextend, lvresize, lvreduce.

It should resolve: https://bugzilla.redhat.com/show_bug.cgi?id=592428

Zdenek

>From 413ea8eb523d4e3392fa39e7cd904e7fd4b5d060 Mon Sep 17 00:00:00 2001
From: Zdenek Kabelac <zkabelac redhat com>
Date: Tue, 8 Jun 2010 11:40:54 +0200
Subject: Man page update for lvresize --resizefs

---
 man/lvextend.8.in |   16 ++++++++++++++++
 man/lvreduce.8.in |   12 ++++++++++++
 man/lvresize.8.in |   16 ++++++++++++++++
 3 files changed, 44 insertions(+), 0 deletions(-)

diff --git a/man/lvextend.8.in b/man/lvextend.8.in
index e73571f..8f409ab 100644
--- a/man/lvextend.8.in
+++ b/man/lvextend.8.in
@@ -9,6 +9,9 @@ lvextend \- extend the size of a logical volume
 [\-i|\-\-stripes Stripes [\-I|\-\-stripesize StripeSize]]
 {\-l|\-\-extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}] |
 \-L|\-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
+[\-f|\-\-force]
+[\-n|\-\-nofsck]
+[\-r|\-\-resizefs]
 [\-t|\-\-test]
 [\-v|\-\-verbose] LogicalVolumePath [PhysicalVolumePath[:PE[-PE]]...]
 .SH DESCRIPTION
@@ -60,6 +63,18 @@ Not applicable to LVs using the original metadata LVM format, which must
 use a single value throughout.
 .br
 StripeSize must be 2^n (n = 2 to 9)
+.TP
+.I \-f, \-\-force
+Force size extension without any question.
+.TP
+.I \-n, \-\-nofsck
+Do not perform fsck before extending filesystem when filesystem
+requires it. You may need to use \fB--force\fR to proceed with 
+this option.
+.TP
+.I \-r, \-\-resizefs
+Resize underlying filesystem together with logical volume size.
+\fBfsadm\fR tool is used for filesystem resize.
 .SH Examples
 "lvextend -L +54 /dev/vg01/lvol10 /dev/sdk3" tries to extend the size of
 that logical volume by 54MB on physical volume /dev/sdk3.
@@ -77,6 +92,7 @@ tries to extend a logical volume "vg01/lvol01" by 16MB using physical extents
 /dev/sda:8-9 and /dev/sdb:8-9 for allocation of extents.
 
 .SH SEE ALSO
+.BR fsadm (8),
 .BR lvm (8), 
 .BR lvcreate (8), 
 .BR lvconvert (8), 
diff --git a/man/lvreduce.8.in b/man/lvreduce.8.in
index 8d5eb3d..5d55b5c 100644
--- a/man/lvreduce.8.in
+++ b/man/lvreduce.8.in
@@ -8,6 +8,8 @@ lvreduce \- reduce the size of a logical volume
 [\-\-noudevsync]
 {\-l|\-\-extents [\-]LogicalExtentsNumber[%{VG|LV|FREE|ORIGIN}] |
 \-L|\-\-size [\-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
+[\-n|\-\-nofsck]
+[\-r|\-\-resizefs]
 [\-t|\-\-test]
 [\-v|\-\-verbose] LogicalVolume[Path]
 .SH DESCRIPTION
@@ -64,10 +66,20 @@ or e for exabytes is optional.
 With the - sign the value will be subtracted from
 the logical volume's actual size and without it it will be taken as
 an absolute size.
+.TP
+.I \-n, \-\-nofsck
+Do not perform fsck before resizing filesystem when filesystem
+requires it. You may need to use \fB--force\fR to proceed with 
+this option. Note: using this option is dangerous.
+.TP
+.I \-r, \-\-resizefs
+Resize underlying filesystem together with logical volume size.
+\fBfsadm\fR tool is used for filesystem resize.
 .SH Example
 "lvreduce -l -3 vg00/lvol1" reduces the size of logical volume lvol1
 in volume group vg00 by 3 logical extents.
 .SH SEE ALSO
+.BR fsadm (8),
 .BR lvchange (8),
 .BR lvconvert (8), 
 .BR lvcreate (8), 
diff --git a/man/lvresize.8.in b/man/lvresize.8.in
index b5bbc07..a288304 100644
--- a/man/lvresize.8.in
+++ b/man/lvresize.8.in
@@ -9,6 +9,9 @@ lvresize \- resize a logical volume
 [\-i|\-\-stripes Stripes [\-I|\-\-stripesize StripeSize]]
 {\-l|\-\-extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}] |
 \-L|\-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
+[\-f|\-\-force]
+[\-n|\-\-nofsck]
+[\-r|\-\-resizefs]
 [\-t|\-\-test]
 [\-v|\-\-verbose] LogicalVolumePath [PhysicalVolumePath[:PE[-PE]]...]
 .SH DESCRIPTION
@@ -67,6 +70,18 @@ Not applicable to LVs using the original metadata LVM format, which
 must use a single value throughout.
 .br
 StripeSize must be 2^n (n = 2 to 9)
+.TP
+.I \-f, \-\-force
+Force resize without any question.
+.TP
+.I \-n, \-\-nofsck
+Do not perform fsck before resizing filesystem when filesystem
+requires it. You may need to use \fB--force\fR to proceed with 
+this option.
+.TP
+.I \-r, \-\-resizefs
+Resize underlying filesystem together with logical volume size.
+\fBfsadm\fR tool is used for filesystem resize.
 .SH Examples
 .br
 "lvresize -L+16M vg1/lv1 /dev/sda:0-1 /dev/sdb:0-1"
@@ -75,6 +90,7 @@ tries to extend a logical volume "vg1/lv1" by 16MB using physical extents
 /dev/sda:0-1 and /dev/sdb:0-1 for allocation of extents.
 
 .SH SEE ALSO
+.BR fsadm (8),
 .BR lvm (8), 
 .BR lvconvert (8),
 .BR lvcreate (8), 
-- 
1.7.1


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]