Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mkfs.gfs(8) [debian man page]

mkfs.gfs(8)						      System Manager's Manual						       mkfs.gfs(8)

NAME
mkfs.gfs - Make a GFS filesystem SYNOPSIS
mkfs.gfs [OPTION]... DEVICE DESCRIPTION
mkfs.gfs is used to create a Global File System. OPTIONS
-b BlockSize Set the filesystem block size to BlockSize (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, GFS filesystems should not deviate from the default value. -D Enable debugging output. -h Print out a help message describing available options, then exit. -J MegaBytes The size of the journals in Megabytes. The default journal size is 128 megabytes. The minimum size is 32 megabytes. -j Number The number of journals for mkfs.gfs to create. You need at least one journal per machine that will mount the filesystem. -O This option prevents mkfs.gfs from asking for confirmation before writing the filesystem. -p LockProtoName LockProtoName is the name of the locking protocol to use. The locking protocol should be lock_dlm for a clustered file system or if you are using GFS as a local filesystem (1 node only), you can specify the lock_nolock protocol. -q Be quiet. Don't print anything. -r MegaBytes mkfs.gfs will try to make Resource Groups (RGs) about this big. Minimum RG size is 32 MB. Maximum RG size is 2048 MB. A large RG size may increase performance on very large file systems. If not specified, mkfs.gfs will choose the RG size based on the size of the file system: average size file systems will have 256 MB RGs, and bigger file systems will have bigger RGs for better perfor- mance. -s Blocks Journal segment size in filesystem blocks. This value must be at least two and not large enough to produce a segment size greater than 4MB. -t LockTableName The lock table field appropriate to the lock module you're using. It is clustername:fsname. Clustername must match that in clus- ter.conf; only members of this cluster are permitted to use this file system. Fsname is a unique file system name used to distin- guish this GFS file system from others created (1 to 16 characters). Lock_nolock doesn't use this field. -V Print program version information, then exit. EXAMPLE
mkfs.gfs -t mycluster:mygfs -p lock_dlm -j 2 /dev/vg0/mygfs This will make a Global File System on the block device "/dev/vg0/mygfs". It will belong to "mycluster" and register itself as wanting locking for "mygfs". It will use DLM for locking and make two journals. mkfs.gfs(8)

Check Out this Related Man Page

mkfs.gfs2(8)						      System Manager's Manual						      mkfs.gfs2(8)

NAME
mkfs.gfs2 - Make a GFS2 filesystem SYNOPSIS
mkfs.gfs2 [OPTION]... DEVICE [ block-count ] DESCRIPTION
mkfs.gfs2 is used to create a Global File System. OPTIONS
-b BlockSize Set the filesystem block size to BlockSize (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. -c MegaBytes Initial size of each journal's quota change file -D Enable debugging output. -h Print out a help message describing available options, then exit. -J MegaBytes The size of the journals in Megabytes. The default journal size is 128 megabytes. The minimum size is 8 megabytes. -j Number The number of journals for gfs2_mkfs to create. You need at least one journal per machine that will mount the filesystem. If this option is not specified, one journal will be created. -O This option prevents gfs2_mkfs from asking for confirmation before writing the filesystem. -p LockProtoName LockProtoName is the name of the locking protocol to use. Acceptable locking protocols are lock_dlm (for shared storage) or if you are using GFS2 as a local filesystem (1 node only), you can specify the lock_nolock protocol. If this option is not specified, lock_dlm protocol will be assumed. -q Be quiet. Don't print anything. -r MegaBytes gfs2_mkfs will try to make Resource Groups about this big. Minimum RG size is 32 MB. Maximum RG size is 2048 MB. A large RG size may increase performance on very large file systems. If not specified, mkfs.gfs2 will choose the RG size based on the size of the file system: average size file systems will have 256 MB RGs, and bigger file systems will have bigger RGs for better performance. -t LockTableName The lock table field appropriate to the lock module you're using. It is clustername:fsname. Clustername must match that in clus- ter.conf; only members of this cluster are permitted to use this file system. Fsname is a unique file system name used to distin- guish this GFS2 file system from others created (1 to 16 characters). Lock_nolock doesn't use this field. -u MegaBytes Initial size of each journal's unlinked tag file -V Print program version information, then exit. [ block-count ] Make the file system this many blocks in size. If not specified, the entire length of the specified device is used. EXAMPLE
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. 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. mkfs.gfs2(8)
Man Page