public inbox for
help / color / mirror / Atom feed
* cluster: STABLE3 - man: More updates
@ 2009-05-27 10:20 Steven Whitehouse
  0 siblings, 0 replies; only message in thread
From: Steven Whitehouse @ 2009-05-27 10:20 UTC (permalink / raw)
  To: cluster-cvs-relay

Commit:        599a05c55f4ed804b2efb80eec5733f7219ac8a3
Parent:        5ac843f511e14f46c54a500c3f3c2dd7d5d2c0a4
Author:        Steven Whitehouse <>
AuthorDate:    Tue May 26 13:26:42 2009 +0100
Committer:     Steven Whitehouse <>
CommitterDate: Wed May 27 10:08:46 2009 +0100

man: More updates

Various missing, obsolete, or items requiring updates. This should
help make our docs a bit clearer I think.

Signed-off-by: Steven Whitehouse <>
 gfs2/man/gfs2_convert.8 |   16 +++++++++++++++-
 gfs2/man/gfs2_grow.8    |    7 ++++++-
 gfs2/man/gfs2_quota.8   |    2 +-
 gfs2/man/mount.gfs2.8   |   16 ++++++++++++++--
 4 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/gfs2/man/gfs2_convert.8 b/gfs2/man/gfs2_convert.8
index 059863b..a05a690 100644
--- a/gfs2/man/gfs2_convert.8
+++ b/gfs2/man/gfs2_convert.8
@@ -8,7 +8,21 @@ gfs2_convert - Convert a GFS1 filesystem to GFS2
-gfs2_convert is used to convert a filesystem from GFS1 to GFS2.
+gfs2_convert is used to convert a filesystem from GFS1 to GFS2. Do not
+attempt to convert a GFS1 filesystem which is not clean - the process
+of conversion will reinitialise the journals. We highly recommend that
+.B fsck.gfs
+is run successfully before attempting to convert a filesystem. Many
+of the on-disk structures are identical between GFS1 and GFS2, so
+the conversion process updates the journals, a few items of incompatible
+metadata (mostly indirect pointers and inodes) and adds the per-node
+directories required by the gfs2meta filesystem. The conversion process
+is performed in-place and does not require any extra disk space so that
+it is possible to successfully convert a GFS1 filesystem that is
+completely full.
+Always ensure you have a complete backup of the data on any filesystem
+before starting the conversion process.
diff --git a/gfs2/man/gfs2_grow.8 b/gfs2/man/gfs2_grow.8
index bd37328..a38f471 100644
--- a/gfs2/man/gfs2_grow.8
+++ b/gfs2/man/gfs2_grow.8
@@ -5,7 +5,7 @@ gfs2_grow - Expand a GFS2 filesystem
 .B gfs2_grow
 gfs2_grow is used to expand a GFS2 filesystem after the device
@@ -57,5 +57,10 @@ have done were it run without this flag.
 Version. Print out version information, then exit.
+There is no way to shrink a GFS2 filesystem.
 mkfs.gfs2(8) gfs2_jadd(8)
diff --git a/gfs2/man/gfs2_quota.8 b/gfs2/man/gfs2_quota.8
index 7b1311c..04e09e8 100644
--- a/gfs2/man/gfs2_quota.8
+++ b/gfs2/man/gfs2_quota.8
@@ -11,7 +11,7 @@ gfs2_quota - Manipulate GFS2 disk quotas
 gfs2_quota is used to examine and change quota values in a GFS2 filesystem.
 This command has a number of different actions.
-GFS2(5.1) introduced a new linked list format for the quotas in the quota file.
+GFS2 introduced a new linked list format for the quotas in the quota file.
 This list format allows for faster \fBlist\fP, \fBcheck\fP and \fBinit\fP 
 operations. Older GFS2 quota files may be migrated to this newer format using 
 the \fBgfs2_quota reset\fP command.
diff --git a/gfs2/man/mount.gfs2.8 b/gfs2/man/mount.gfs2.8
index 125e404..fcf99c4 100644
--- a/gfs2/man/mount.gfs2.8
+++ b/gfs2/man/mount.gfs2.8
@@ -41,9 +41,9 @@ interpreted by the mount command nor by the kernel's Virtual File System.  GFS2
 and non-GFS2 options may be intermingled after the \fB-o\fP, separated by
 commas (but no spaces).
-The options debug, acl, quota, suiddir, and data can be
+The options debug, commit, discard, acl, quota, suiddir, and data can be
 changed after mount using the "mount -o remount,option /mountpoint" command.
-The options debug, acl, and suiddir support the "no"
+The options debug, quota, discard, acl, and suiddir support the "no"
 prefix.  For example, "noacl" turns off what "acl" turns on.
 If you have trouble mounting GFS2, check the syslog (e.g. /var/log/messages)
@@ -149,6 +149,18 @@ the "account" state causes the per UID/GID usage statistics to be
 correctly maintained by the filesystem, limit and warn values are
 ignored.  The default value is "off".
+Causes GFS2 to generate "discard" I/O requests for blocks which have
+been freed. These can be used by suitable hardware to implement
+thin-provisioning and similar schemes. This feature is supported
+in kernel version 2.6.30 and above.
+This is similar to the ext3 \fBcommit=\fP option in that it sets
+the maximum number of seconds between journal commits if there is
+dirty data in the journal. The default is 60 seconds. This option
+is only provided in kernel versions 2.6.31 and above.
 When data=ordered is set, the user data modified by a transaction is
 flushed to the disk before the transaction is committed to disk.  This

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2009-05-27 10:20 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2009-05-27 10:20 cluster: STABLE3 - man: More updates Steven Whitehouse

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).