commit 49d3da55baca52545da914d5682a64f8ffa44ed1 Author: Abhijith Das <adas@redhat.com> Date: 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@redhat.com> 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.