cluster: RHEL56 - gfs2 manual pages: gfs2_convert manpage and documentation updates

Abhijith Das adas at fedoraproject.org
Mon Jun 7 16:32:02 UTC 2010


Gitweb:        http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=49d3da55baca52545da914d5682a64f8ffa44ed1
Commit:        49d3da55baca52545da914d5682a64f8ffa44ed1
Parent:        fabddd788110b7812b4d4d856db02644ef36756f
Author:        Abhijith Das <adas at redhat.com>
AuthorDate:    Mon Jun 7 11:28:58 2010 -0500
Committer:     Abhijith Das <adas at redhat.com>
CommitterDate: Mon Jun 7 11:28:58 2010 -0500

gfs2 manual pages: gfs2_convert manpage and documentation updates

The recent fixes/updates to gfs2_convert changes its behavior
in a few cases such as handling of CDPNs, converting full
filesystems etc. This updates the manpage to reflect that.

Resolves: rhbz#588374
Signed-off-by: Abhi Das <adas at redhat.com>
---
 gfs2/man/gfs2_convert.8 |   24 +++++++++++++++++++++++-
 1 files changed, 23 insertions(+), 1 deletions(-)

diff --git a/gfs2/man/gfs2_convert.8 b/gfs2/man/gfs2_convert.8
index 2f6f2de..1f7d044 100644
--- a/gfs2/man/gfs2_convert.8
+++ b/gfs2/man/gfs2_convert.8
@@ -11,7 +11,13 @@ gfs2_convert - Convert a GFS1 filesystem to GFS2
 [\fIOPTION\fR]... \fIDEVICE\fR
 
 .SH DESCRIPTION
-gfs2_convert is used to convert a filesystem from GFS1 to GFS2.
+gfs2_convert is used to convert a filesystem from GFS1 to GFS2. It is
+required that the GFS1 filesystem be checked and fixed for errors using 
+\fBgfs_fsck\fP and that the filesystem be backed up before
+attempting to convert it. The convert process is irreversible and any
+error encountered during the conversion can result in the abrupt
+termination of the program and consequently an unusable filesystem.
+See \fBNOTES\fP section below for more information. 
 
 .SH OPTIONS
 .TP
@@ -47,3 +53,19 @@ changes.
 gfs2_convert /dev/vg0/lvol0
 This will convert the Global File System on the block device
 "/dev/vg0/lvol0" to gfs2 format.
+
+.SH NOTES
+If gfs2_convert is interrupted for some reason other than a conversion 
+failure, DO NOT run \fBgfs2_fsck\fP on this partially converted filesystem.
+When this occurs, reissue the gfs2_convert command on the partially converted
+filesystem to complete the conversion process.
+
+The GFS2 filesystem does not support Context-Dependent Path Names (CDPNs). 
+gfs2_convert identifies such CDPNs and replaces them with empty directories 
+with the same name. The administrator can use bind mounts on these 
+directories to get the same effect as CDPNs.
+
+When converting full or nearly full filesystems, it is possible that there
+won't be enough space available to fit all the GFS2 filesystem data 
+structures. In such cases, the size of all the journals is reduced uniformly
+such that everything fits in the available space.


More information about the cluster-commits mailing list