From mboxrd@z Thu Jan 1 00:00:00 1970 From: rpeterso@sourceware.org Date: 12 Jun 2006 20:35:03 -0000 Subject: [Cluster-devel] cluster/gfs2/man gfs2_convert.8 gfs2_fsck.8 gf ... Message-ID: <20060612203503.16913.qmail@sourceware.org> List-Id: To: cluster-devel.redhat.com MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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.