<SYNOPSIS>
mkfs -F sfcfs [ generic_options ] [ -o specific_options ] special
<DESCRIPTION>
The mkfs_sfcfs builds a GFS Shared File System on the disks that were specified.
Once a GFS Shared File System has been created, its entry is added to file system configure information in a management partition. Thereafter, file system configure information in a management partition is used to manage the GFS Shared File System.
<OPTIONS>
The following options can be specified:
generic_options is supported by a general-purpose mkfs(1M).
See the options of mkfs(1M) for details.
Allows options specific to the GFS Shared File System to be specified. Insert a comma delimiter between options.
Displays parameters used for creating a file system.
Does not actually create a file system.
Specifies the path name of a character special file or a block special file for a file data partition.
If a file system is built with multiple partitions that are used as file data partitions, specify multiple entries for this parameter.
Specifies whether a representative partition includes a file data area if file data partitions are specified with the data sub-option. If y is specified, the representative partition does not include a file data area. If n is specified, the representative partition includes a file data area.
The default is n.
If no file data partitions are specified, n is set, regardless of whether this parameter is specified.
Specifies the percentage of the file data area that only a super user is allowed to use.
The default is 10%.
A value can be specified in the range from 0 to 99.
Specify the force option to re-create a file system previously registered in file system configure information in a management partition when its configuration is unchanged. If, however, the target file system is being mounted, specifying this option results in an error.
Specifies the size of the update log area.
The unit is megabytes.
The default is about 1% of the file system size. When maxdsz has been specified, the default is about 1% of the maxdsz value. If the default value is smaller than 5 megabytes, 5 megabytes is set. If the default value is greater than 50 megabytes, 50 megabytes is set.
A value can be specified in the range from 5 to 100.
Specifies the maximum size of the file data area of a file system that includes additional partitions. The unit is megabytes. Based on the value specified for this parameter, the size of meta-data and the update log area size are set to proper values after taking into account the additional partitions.
If this option is not specified, the sizes of meta-data area and the update log area are determined based on the file system size of the specified partition.
A minimum value is the same as default. A maximum value is 1048576 (1 terabyte).
Specifies the maximum number of nodes, including any anticipated in future expansion with sfcnode(1M), that share a file system constructed on disks.
The default is 16.
A value can be specified in the range from 1 to 32.
Specifies the maximum number of partitions, including any anticipated in future expansion with sfcadd(1M), that constitute the file system constructed on disks.
The default is 16.
A value can be specified in the range from 1 to 32.
Specifies the size of the meta-data area. The unit is megabytes.
The default is about 10% of the file system size. When maxdsz has been specified, the default is about 10% of the maxdsz value. However, when the file system size is larger, the ratio of the meta-data area becomes smaller.
The minimum value that can be specified is same as default. The maximum value is minimum requirement size for managing 1-mega V-data. (The total number of V-data of the file system can be confirmed by executing df_sfcfs(1M).) However, larger value than the size of the representative partition cannot be specified.
Specifies the percentage of the V-data area that only a super user is allowed to use.
The default is 10%.
A value can be specified in the range from 0 to 99.
Specifies an average number of blocks to be managed by one extent.
This parameter is used as a fragmentation factor for the file data area.
The default is 1.
A value can be specified in the range from 1 to 100.
Specifies the byte count of data per i-node. Number of total i-nodes is decided by dividing the size of the file system's file data area by this parameter.
Specify a large value for this parameter if the number of total i-nodes is to be reduced.
And specify a larger value for this parameter if the meta-data area is to be saved, too.
The default is 8192 or a value adjusted as the number of total i-nodes should not exceed the maximum value (16 mega).
A value can be specified by the N power of 2. (N is a range from 9 to 20.)
Registers the name of a host that will share the file system. If multiple nodes share the file system, specify multiple entries for this parameter.
Hosts whose names are to be specified with host must be able to communicate with each other. MDS (meta-data server) placing nodes are selected from head of the host names specified with this option.
Unless this option is specified, only the host name of the local node is registered.
<OPERANDS>
The following operand can be specified:
Specifies path name of a character special file or a block special file for the representative partition of the GFS Shared File System.
<EXAMPLES>
# mkfs -F sfcfs -o node=host1,host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> # mkfs -F sfcfs -o dataopt=y,data=/dev/sfdsk/gfs01/rdsk/volume02,data=/dev/sfdsk/gfs01/rdsk/volume03,node=host1,host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
<FILES>
/etc/vfstab
Environment file of a file system.
<SEE ALSO>
df_sfcfs(1M), sfcadd(1M), sfcadm(1M), sfcnode(1M), sfcsetup(1M)
vfstab(4) in the Solaris documentation
<NOTES>
host is necessary to be the host name of the node which constitutes the GFS Shared File System registered into the management partition by sfcsetup(1M).
A file system can be created only when all hosts that share the file system have started operation and the GFS Shared File System has been installed. The reason is that the information for these hosts is required.
If another option is specified after a comma (,) that follows a node option, the option will have no effect because it will be interpreted as a host name.
In the GFS Shared File System, the data block size is fixed at 8192 bytes and cannot be altered.
To re-create a GFS Shared File System by modifying its configuration, first delete the file system with sfcadm(1M).
The parameter value of the metasz option that is included in the command line displayed by -m option is a value in which the size of an actual meta-data area was rounded up every a megabyte. Therefore, if the size of an actual meta-data area is same as upper limit, the following warning message might be displayed when the file system is built by using the command line displayed by -m option. However, the action is unnecessary.
mkfs_sfcfs:WARNING: value : bogus metasz reset |
