[unix-history] / 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.
Commit	Line	Data
e26f5261 C	1	.TH MKFS 8 "10 May 1981"
	2	.UC 4
	3	.SH NAME
	4	mkfs \- construct a file system
	5	.SH SYNOPSIS
	6	.B /etc/mkfs
	7	special size
	8	[ nsect ]
	9	[ ntrack ]
	10	[ blksize ]
	11	[ fragsize ]
	12	[ ncpg ]
	13	[ minfree ]
	14	[ rps ]
	15	.SH DESCRIPTION
	16	.B N.B.:
	17	file system are normally created with the
	18	.IR newfs (8)
	19	command.
	20	.PP
	21	.I Mkfs
	22	constructs a file system
	23	by writing on the special file
	24	.I special.
	25	The numeric size specifies the number of sectors in the file system.
	26	.I Mkfs
	27	builds a file system with a root directory and a
	28	.I lost+found
	29	directory.
	30	(see
	31	.IR fsck (8))
	32	The number of i-nodes is calculated as a function of the file system size.
	33	No boot program is initialized by
	34	.I mkfs
	35	(see
	36	.IR newfs (8).)
	37	.PP
	38	The optional arguments allow fine tune control over the
	39	parameters of the file system.
	40	.B Nsect
	41	specify the number of sectors per track on the disk.
	42	.B Ntrack
	43	specify the number of tracks per cylinder on the disk.
	44	.B Blksize
	45	gives the primary block size for files on the file system.
	46	It must be a power of two, currently selected from 4096 or 8192.
	47	.B Fragsize
	48	gives the fragment size for files on the file system.
	49	The
	50	.B fragsize
	51	represents the smallest amount of disk space that will be allocated to a file.
	52	It must be a power of two currently selected from the range 512 to 8192.
	53	.B Ncpg
	54	specifies the number of disk cylinders per cylinder group.
	55	This number must be in the range 1 to 32.
	56	.B Minfree
	57	specifies the minimum percentage of free disk space allowed.
	58	Once the file system capacity reaches this threshold, only
	59	the super-user is allowed to allocate disk blocks. The default
	60	value is 10%.
	61	If a disk does not revolve at 60 revolutions per second, the
	62	.B rps
	63	parameter may be specified.
	64	Users with special demands for their file systems are referred to
65	the paper cited below for a discussion of the tradeoffs in using
66	different configurations.
67	.SH "SEE ALSO"
68	fs(5),
69	dir(5),
70	fsck(8),
71	newfs(8),
72	tunefs(8)
73	.PP
74	McKusick, Joy, Leffler; "A Fast File System for Unix",
75	Computer Systems Research Group, Dept of EECS, Berkeley, CA 94720;
76	TR #7, September 1982.
77	.SH BUGS
78	There should be some way to specify bad blocks.