/etc/mkfs [-y | -n] [-p] device proto [gap blks_per_cyl] [fsopts]
/etc/mkfs [-y | -n] [-p] [-f fstype] device [fsopts]
fsopts are options specific to the filesystem type (fstyp):
The fstyp argument to the -f option specifies one of the following filesystem types:
device is the raw special device on which to make the filesystem.
blocks specifies the size of the filesystem as the decimal number of physical (512-byte) disk blocks the filesystem will occupy. If the number of inodes is not given, the default used is approximately the number of logical (1024-byte) blocks divided by 4 (except DTFS which uses any available blocks for inodes). mkfs builds a filesystem containing a single empty directory. The boot program block (block zero) is left uninitialized. When creating a filesystem, the blocks specification is optional. For a DTFS filesystem, the inodes specification is not used.
If the specified size (in blocks) exceeds the capacity of the device, mkfs will fail, unless the -y option is used. The -y option forces mkfs to ignore the results of any matching.
If the second argument is the name of a file that can be opened, mkfs assumes it to be a prototype file proto, and will take its directions from that file. The prototype file contains tokens separated by spaces or new-lines.
The following is an example of a prototype specification (line numbers have been added to aid in the explanation):
1 /stand/diskboot 2 4872 110 3 d--777 3 1 4 usr d--777 3 1 5 sh ---755 3 1 /bin/sh 6 ken d--755 6 1 7 $ 8 b0 b--644 3 1 0 0 9 c0 c--644 3 1 0 0 10 $ 11 $Line 1 is the name of a file to be copied onto block zero as the bootstrap program.
Line 2 specifies the number of physical (512-byte) blocks the filesystem is to occupy and the number of inodes in the filesystem. Note that the number of inodes is not specified when creating a DTFS filesystem.
Lines 3-9 tell mkfs about files and directories to be included in this filesystem.
Line 3 specifies the root directory.
Lines 4-6 and 8-9 specify other directories and files.
The ``$'' on line 7 tells mkfs to end the branch of the filesystem it is on, and continue from the next higher directory. The ``$'' on lines 10 and 11 end the process, since no additional specifications follow.
File specifications give the mode, the user ID, the group ID, and the initial contents of the file. Valid syntax for the contents field depends on the first character of the mode.
The mode for a file is specified by a 6-character string. The first character specifies the type of the file. The character range is -bcd to specify regular, block special, character special and directory files, respectively. The second character of the mode is either u or - to specify set-user-id mode or not. The third is g or - for the set-group-id mode. The rest of the mode is a 3-digit octal number giving the owner, group, and other read, write, execute permissions (see chmod(C)).
Two decimal number tokens come after the mode; they specify the user and group IDs of the owner of the file.
If the file is a regular file, the next token of the specification may be a pathname from which the contents and size are copied. If the file is a block or character special file, two decimal numbers follow which give the major and minor device numbers.
If the file is a directory, mkfs makes the entries ``.'' and ``..'', then reads a list of names and (recursively) file specifications for the entries in the directory. As noted above, the scan is terminated with the token ``$''.
The gap and blks_per_cyl arguments specify the rotational gap and the number of blocks per cylinder. This option is not used when creating a DTFS filesystem.
gap must be greater than zero and less than or equal to the number of blk_per_cyl; otherwise the default value of 1 is used. If the default value is used, the value of blk_per_cyl has no effect on the filesystem layout.
blk_per_cyl must be greater than zero and less than 1500; otherwise the default of 400 blocks per cylinder is used.
If the -C option is specified, the filesystem created will be AFS unless the type is specified using -f or -E.