4.2BSD/usr/man/man8/mkfs.8

.TH MKFS 8 "10 May 1981"
.UC 4
.SH NAME
mkfs \- construct a file system
.SH SYNOPSIS
.B /etc/mkfs
special size
[ nsect ]
[ ntrack ]
[ blksize ]
[ fragsize ]
[ ncpg ]
[ minfree ]
[ rps ]
.SH DESCRIPTION
.B N.B.:
file system are normally created with the
.IR newfs (8)
command.
.PP
.I Mkfs
constructs a file system
by writing on the special file
.I special.
The numeric size specifies the number of sectors in the file system.
.I Mkfs
builds a file system with a root directory and a
.I lost+found
directory.
(see 
.IR fsck (8))
The number of i-nodes is calculated as a function of the file system size.
No boot program is initialized by
.I mkfs
(see
.IR newfs (8).)
.PP
The optional arguments allow fine tune control over the
parameters of the file system.
.B Nsect
specify the number of sectors per track on the disk.
.B Ntrack 
specify the number of tracks per cylinder on the disk.
.B Blksize 
gives the primary block size for files on the file system.
It must be a power of two, currently selected from 4096 or 8192.
.B Fragsize
gives the fragment size for files on the file system.
The
.B fragsize
represents the smallest amount of disk space that will be allocated to a file.
It must be a power of two currently selected from the range 512 to 8192.
.B Ncpg
specifies the number of disk cylinders per cylinder group.
This number must be in the range 1 to 32.
.B Minfree
specifies the minimum percentage of free disk space allowed.
Once the file system capacity reaches this threshold, only
the super-user is allowed to allocate disk blocks.  The default
value is 10%.
If a disk does not revolve at 60 revolutions per second, the
.B rps
parameter may be specified.
Users with special demands for their file systems are referred to
the paper cited below for a discussion of the tradeoffs in using
different configurations.
.SH "SEE ALSO"
fs(5),
dir(5),
fsck(8),
newfs(8),
tunefs(8)
.PP
McKusick, Joy, Leffler; "A Fast File System for Unix",
Computer Systems Research Group, Dept of EECS, Berkeley, CA 94720;
TR #7, September 1982.
.SH BUGS
There should be some way to specify bad blocks.