[Cluster-devel] cluster/gfs2/man gfs2_convert.8 gfs2_fsck.8 gf ...

[rpeterso@sourceware.org <rpeterso@sourceware.org>]

CVSROOT:	/cvs/cluster
Module name:	cluster
Changes by:	rpeterso at sourceware.org	2006-06-12 20:35:03

Added files:
	gfs2/man       : gfs2_convert.8 gfs2_fsck.8 
Removed files:
	gfs2/man       : gfs2_mkfs.8 

Log message:
	Added gfs2_fsck, added gfs2_convert, renamed gfs2_mkfs to mkfs.gfs2

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/gfs2/man/gfs2_convert.8.diff?cvsroot=cluster&r1=NONE&r2=1.1
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/gfs2/man/gfs2_fsck.8.diff?cvsroot=cluster&r1=NONE&r2=1.1
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/gfs2/man/gfs2_mkfs.8.diff?cvsroot=cluster&r1=1.2&r2=NONE

/cvs/cluster/cluster/gfs2/man/gfs2_convert.8,v  -->  standard output
revision 1.1
--- cluster/gfs2/man/gfs2_convert.8
+++ -	2006-06-12 20:35:03.698645000 +0000
@@ -0,0 +1,49 @@
+.\"  Copyright (C) Sistina Software, Inc.  1997-2003  All rights reserved.
+.\"  Copyright (C) 2004-2006 Red Hat, Inc.  All rights reserved.
+
+.TH gfs2_convert 8
+
+.SH NAME
+gfs2_convert - Convert a GFS1 filesystem to GFS2
+
+.SH SYNOPSIS
+.B gfs2_convert
+[\fIOPTION\fR]... \fIDEVICE\fR
+
+.SH DESCRIPTION
+gfs2_convert is used to convert a filesystem from GFS1 to GFS2.
+
+.SH OPTIONS
+.TP
+\fB-h\fP
+Help.
+
+This prints out the proper command line usage syntax.
+.TP
+\fB-q\fP
+Quiet.  Print less information while running.
+.TP
+\fB-n\fP
+No to all questions.
+.TP
+\fB-V\fP
+Print program Version information only.
+
+Print out the current version name.
+.TP
+\fB-v\fP
+Verbose operation.
+
+Print more information while running.
+.TP
+\fB-y\fP
+Yes to all questions.
+
+By specifying this option, gfs2_convert will not prompt before making
+changes.
+
+.SH EXAMPLE
+.TP
+gfs2_convert /dev/vg0/lvol0
+This will convert the Global File System on the block device
+"/dev/vg0/lvol0" to gfs2 format.
/cvs/cluster/cluster/gfs2/man/gfs2_fsck.8,v  -->  standard output
revision 1.1
--- cluster/gfs2/man/gfs2_fsck.8
+++ -	2006-06-12 20:35:03.788630000 +0000
@@ -0,0 +1,62 @@
+.\"  Copyright (C) Sistina Software, Inc.  1997-2003  All rights reserved.
+.\"  Copyright (C) 2004-2006 Red Hat, Inc.  All rights reserved.
+
+.TH gfs2_fsck 8
+
+.SH NAME
+gfs2_fsck - Offline GFS2 file system checker
+
+.SH SYNOPSIS
+.B gfs2_fsck
+[\fIOPTION\fR]... \fIDEVICE\fR
+
+.SH WARNING
+All GFS2 nodes \fImust\fP have the GFS2 filesystem unmounted before running
+gfs2_fsck.  Failure to unmount all nodes may result in filesystem corruption.
+
+.SH DESCRIPTION
+gfs2_fsck will check that the GFS2 file system on a device is structurally valid.
+It should not be run on a mounted file system.  If file system corruption is
+detected, it will attempt to repair the file system.  There is a limit to what
+gfs2_fsck can do.  If important file system structures are destroyed, such that
+the checker cannot determine what the repairs should be, reparations could
+fail.
+
+GFS2 is a journaled file system, and as such should be able to repair damages to
+the file system on its own.  However, faulty hardware has the ability to write
+incomplete blocks to a file system thereby causing corruption that GFS2 cannot
+fix.  The first step to ensuring a healthy file system is the selection of
+reliable hardware (i.e. storage systems that will write complete blocks - even
+in the event of power failure).
+
+.SH OPTIONS
+.TP
+\fB-h\fP
+Help.
+
+This prints out the proper command line usage syntax.
+.TP
+\fB-q\fP
+Quiet.
+.TP
+\fB-n\fP
+No to all questions.
+
+By specifying this option, gfs2_fsck will only show the changes that
+would be made, but not make any changes to the filesystem.
+.TP
+\fB-V\fP
+Version.
+
+Print out the program version information.
+.TP
+\fB-v\fP
+Verbose operation.
+
+Print more information while running.
+.TP
+\fB-y\fP
+Yes to all questions.
+
+By specifying this option, gfs2_fsck will not prompt before making
+changes.