[Cluster-devel] cluster/gfs2 Makefile man/mkfs.gfs2.8

[Cluster-devel] cluster/gfs2 Makefile man/mkfs.gfs2.8

[rpeterso]

CVSROOT:	/cvs/cluster
Module name:	cluster
Changes by:	rpeterso at sourceware.org	2006-06-12 23:04:47

Modified files:
	gfs2           : Makefile 
Added files:
	gfs2/man       : mkfs.gfs2.8 

Log message:
	Improvements to Makefile, renamed gfs2_mkfs man page to mkfs.gfs2.8

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/gfs2/Makefile.diff?cvsroot=cluster&r1=1.6&r2=1.7
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/gfs2/man/mkfs.gfs2.8.diff?cvsroot=cluster&r1=NONE&r2=1.1

--- cluster/gfs2/Makefile	2006/06/09 22:13:18	1.6
+++ cluster/gfs2/Makefile	2006/06/12 23:04:47	1.7
@@ -11,47 +11,54 @@
 ###############################################################################
 ###############################################################################
 
-all:
-	cd libgfs2 && ${MAKE} all
-	cd convert && ${MAKE} all
-	cd edit && ${MAKE} all
-	cd fsck && ${MAKE} all
-	cd mkfs && ${MAKE} all
-	cd mount && ${MAKE} all
-	cd quota && ${MAKE} all
-	cd tool && ${MAKE} all
+all: tag_libgfs2 tag_convert tag_edit tag_fsck tag_mkfs tag_mount tag_tool
+
+tag_libgfs2:
+	${MAKE} -C libgfs2 all
+tag_convert:
+	${MAKE} -C convert all
+tag_edit:
+	${MAKE} -C edit all
+tag_fsck:
+	${MAKE} -C fsck all
+tag_mkfs:
+	${MAKE} -C mkfs all
+tag_mount:
+	${MAKE} -C mount all
+tag_quota:
+	${MAKE} -C quota all
+tag_tool:
+	${MAKE} -C tool all
 
 copytobin:
-#	cd libgfs2 && ${MAKE} copytobin
-	cd convert && ${MAKE} copytobin
-	cd edit && ${MAKE} copytobin
-	cd fsck && ${MAKE} copytobin
-	cd mkfs && ${MAKE} copytobin
-	cd mount && ${MAKE} copytobin
-	cd quota && ${MAKE} copytobin
-	cd tool && ${MAKE} copytobin
+	${MAKE} -C convert copytobin
+	${MAKE} -C edit copytobin
+	${MAKE} -C fsck copytobin
+	${MAKE} -C mkfs copytobin
+	${MAKE} -C mount copytobin
+	${MAKE} -C quota copytobin
+	${MAKE} -C tool copytobin
 
 clean:
-	cd libgfs2 && ${MAKE} clean
-	cd convert && ${MAKE} clean
-	cd bin && ${MAKE} clean
-	cd fsck && ${MAKE} clean
-	cd edit && ${MAKE} clean
-	cd mkfs && ${MAKE} clean
-	cd mount && ${MAKE} clean
-	cd quota && ${MAKE} clean
-	cd tool && ${MAKE} clean
+	${MAKE} -C libgfs2 clean
+	${MAKE} -C convert clean
+	${MAKE} -C edit clean
+	${MAKE} -C fsck clean
+	${MAKE} -C mkfs clean
+	${MAKE} -C mount clean
+	${MAKE} -C quota clean
+	${MAKE} -C tool clean
+	${MAKE} -C bin clean
 
 distclean: clean
 	rm -f make/defines.mk
 
 install:
-	cd bin && ${MAKE} install
-	cd man && ${MAKE} install
-	cd init.d && ${MAKE} install
+	${MAKE} -C bin install
+	${MAKE} -C man install
+	${MAKE} -C init.d install
 
 deinstall uninstall:
-	cd bin && ${MAKE} uninstall
-	cd man && ${MAKE} uninstall
-	cd init.d && ${MAKE} uninstall
-
+	${MAKE} -C bin uninstall
+	${MAKE} -C man uninstall
+	${MAKE} -C init.d uninstall
/cvs/cluster/cluster/gfs2/man/mkfs.gfs2.8,v  -->  standard output
revision 1.1
--- cluster/gfs2/man/mkfs.gfs2.8
+++ -	2006-06-12 23:04:48.522604000 +0000
@@ -0,0 +1,87 @@
+.\"  Copyright (C) Sistina Software, Inc.  1997-2003  All rights reserved.
+.\"  Copyright (C) 2004 Red Hat, Inc.  All rights reserved.
+
+.TH mkfs.gfs2 8
+
+.SH NAME
+mkfs.gfs2 - Make a GFS2 filesystem
+
+.SH SYNOPSIS
+.B mkfs.gfs2
+[\fIOPTION\fR]... \fIDEVICE\fR
+
+.SH DESCRIPTION
+mkfs.gfs2 is used to create a Global File System.
+
+.SH OPTIONS
+.TP
+\fB-b\fP \fIBlockSize\fR 
+Set the filesystem block size to \fIBlockSize\fR (must be a power of
+two).  The minimum block size is 512.  The FS block size cannot exceed
+the machine's memory page size.  On the most architectures (i386,
+x86_64, s390, s390x), the memory page size is 4096 bytes.  On other
+architectures it may be bigger.  The default block size is 4096 bytes.
+In general, GFS2 filesystems should not deviate from the default value.
+.TP
+\fB-c MegaBytes\fP
+Initial size of each journal's quota change file
+.TP
+\fB-D\fP
+Enable debugging output.
+.TP
+\fB-h\fP
+Print  out  a  help  message  describing  available
+options, then exit.
+.TP
+\fB-J\fP \fIMegaBytes\fR 
+The size of the journals in Megabytes. The default journal size is 
+32 megabytes.  The minimum size is 8 megabytes.
+.TP
+\fB-j\fP \fINumber\fR 
+The number of journals for gfs2_mkfs to create.  You need at least one
+journal per machine that will mount the filesystem.
+.TP
+\fB-O\fP
+This option prevents gfs2_mkfs from asking for confirmation before writing
+the filesystem.
+.TP
+\fB-p\fP \fILockProtoName\fR 
+LockProtoName is the name of the  locking  protocol to use.  Acceptable
+locking protocols are \fIlock_dlm\fR or if you are using GFS2
+as a local filesystem (\fB1 node only\fP), you can specify the
+\fIlock_nolock\fR protocol.
+.TP
+\fB-q\fP
+Be quiet.  Don't print anything.
+.TP
+\fB-r\fP \fIMegaBytes\fR
+gfs2_mkfs will try to make Resource Groups about this big.
+The default is 256 MB.
+.TP
+\fB-t\fP \fILockTableName\fR 
+The lock table field appropriate to the lock module you're using.
+It is \fIclustername:fsname\fR.
+Clustername must match that in cluster.conf; only members of this
+cluster are permitted to use this file system.
+Fsname is a unique file system name used to distinguish this GFS2 file
+system from others created (1 to 16 characters).  Lock_nolock doesn't
+use this field.
+.TP
+\fB-u MegaBytes\fP
+Initial size of each journal's unlinked tag file
+.TP
+\fB-V\fP
+Print program version information, then exit.
+
+.SH EXAMPLE
+.TP
+gfs2_mkfs -t mycluster:mygfs2 -p lock_dlm -j 2 /dev/vg0/mygfs2
+This will make a Global File System on the block device
+"/dev/vg0/mygfs2".  It will belong to "mycluster" and register itself
+as wanting locking for "mygfs2".  It will use DLM for locking and make
+two journals.
+.TP
+gfs2_mkfs -t mycluster:mygfs2 -p lock_nolock -j 3 /dev/vg0/mygfs2
+This will make a Global File System on the block device
+"/dev/vg0/mygfs2".  It will belong to "mycluster" and but have no
+cluster locking.  It will have three journals.