[thirdparty/e2fsprogs.git] / misc / mke2fs.8

.\" -*- nroff -*-
.\" Copyright 1993, 1994, 1995 by Theodore Ts'o.  All Rights Reserved.
.\" This file may be copied under the terms of the GNU Public License.
.\" 
.TH MKE2FS 8 "October 1995" "Version 1.01"
.SH NAME
mke2fs \- create a Linux second extended file system
.SH SYNOPSIS
.B mke2fs
[
.B \-c
| 
.\" .B \-t
.\" test
.\" |
.B \-l
filename
]
[
.B \-b
block-size
]
[
.B \-f
fragment-size
]
[
.B \-i
bytes-per-inode
]
[
.B \-m
reserved-blocks-percentage
]
[
.B \-q
]
[
.B \-v
]
[
.B \-S
]
device
[
blocks-count
]
.SH DESCRIPTION
.B mke2fs
is used to create a Linux second extended file system on a device (usually
a disk partition).
.br
.I device
is the special file corresponding to the device (e.g /dev/hdXX).
.br
.I blocks-count
is the number of blocks on the device.  If omitted,
.B mke2fs
automagically figures the file system size.
.SH OPTIONS
.TP
.I -b block-size
Specify the size of blocks in bytes.
.TP
.I -c
Check the device for bad blocks before creating the file system, using a
fast read-only test.
.TP
.I -f fragment-size
Specify the size of fragments in bytes.
.TP
.I -i bytes-per-inode
Specify the bytes/inode ratio. 
.B mke2fs
creates an inode for every
.I bytes-per-inode
bytes of space on the disk.  This value defaults to 4096 bytes.
.I bytes-per-inode
must be at least 1024.
.TP
.I -l filename
Read the bad blocks list from
.I filename
\.
.TP
.I -m reserved-blocks-percentage
Specify the percentage of reserved blocks for the super-user.  This value
defaults to 5%.
.\" .TP
.\" .I -t test
.\" Check the device for bad blocks before creating the file system
.\" using the specified test.
.TP
.I -q
Quiet execution.  Useful if mke2fs is run in a script.
.TP
.I -v
Verbose execution.
.TP
.I -S
Write superblock and group descriptors only.  This is useful if all of
the superblock and backup superblocks are corrupted, and a last-ditch
recovery method is desired.  It causes mke2fs to reinitialize the
superblock and group descriptors, while not touching the inode table
and the block and inode bitmaps.  The
.B e2fsck
program should be run immediately after this option is used, and there
is no gaurantee that any data will be salvageable.
.SH AUTHOR
This version of
.B mke2fs
has been written by Theodore Ts'o <tytso@mit.edu>.
.SH BUGS
.B mke2fs
accepts the -f option but currently ignores it because the second
extended file system does not support fragments yet.
.br
There may be some other ones.  Please, report them to the author.
.SH AVAILABILITY
.B mke2fs
is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in
/pub/linux/packages/ext2fs.
.SH SEE ALSO
.BT badblocks (8),
.BR dumpe2fs (8),
.BR e2fsck (8),
.BR tune2fs (8)
Commit	Line	Data
3839e657	1	.\" -- nroff --
a418d3ad TT	2	.\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
	3	.\" This file may be copied under the terms of the GNU Public License.
	4	.\"
900e4427	5	.TH MKE2FS 8 "October 1995" "Version 1.01"
3839e657 TT	6	.SH NAME
	7	mke2fs \- create a Linux second extended file system
	8	.SH SYNOPSIS
	9	.B mke2fs
	10	[
	11	.B \-c
	12	\|
	13	.\" .B \-t
	14	.\" test
	15	.\" \|
	16	.B \-l
	17	filename
	18	]
	19	[
	20	.B \-b
	21	block-size
	22	]
	23	[
	24	.B \-f
	25	fragment-size
	26	]
	27	[
	28	.B \-i
	29	bytes-per-inode
	30	]
	31	[
	32	.B \-m
	33	reserved-blocks-percentage
	34	]
	35	[
f3db3566 TT	36	.B \-q
	37	]
	38	[
3839e657 TT	39	.B \-v
3839e657 TT	40	]
f3db3566 TT	41	[
	42	.B \-S
	43	]
3839e657 TT	44	device
	45	[
	46	blocks-count
	47	]
	48	.SH DESCRIPTION
	49	.B mke2fs
	50	is used to create a Linux second extended file system on a device (usually
	51	a disk partition).
	52	.br
	53	.I device
	54	is the special file corresponding to the device (e.g /dev/hdXX).
	55	.br
	56	.I blocks-count
	57	is the number of blocks on the device. If omitted,
	58	.B mke2fs
	59	automagically figures the file system size.
	60	.SH OPTIONS
	61	.TP
	62	.I -b block-size
	63	Specify the size of blocks in bytes.
	64	.TP
	65	.I -c
	66	Check the device for bad blocks before creating the file system, using a
	67	fast read-only test.
	68	.TP
	69	.I -f fragment-size
	70	Specify the size of fragments in bytes.
	71	.TP
	72	.I -i bytes-per-inode
	73	Specify the bytes/inode ratio.
	74	.B mke2fs
	75	creates an inode for every
	76	.I bytes-per-inode
	77	bytes of space on the disk. This value defaults to 4096 bytes.
	78	.I bytes-per-inode
	79	must be at least 1024.
	80	.TP
	81	.I -l filename
	82	Read the bad blocks list from
	83	.I filename
	84	\.
	85	.TP
	86	.I -m reserved-blocks-percentage
	87	Specify the percentage of reserved blocks for the super-user. This value
	88	defaults to 5%.
	89	.\" .TP
	90	.\" .I -t test
	91	.\" Check the device for bad blocks before creating the file system
	92	.\" using the specified test.
	93	.TP
f3db3566 TT	94	.I -q
	95	Quiet execution. Useful if mke2fs is run in a script.
	96	.TP
3839e657 TT	97	.I -v
3839e657 TT	98	Verbose execution.
f3db3566 TT	99	.TP
	100	.I -S
	101	Write superblock and group descriptors only. This is useful if all of
	102	the superblock and backup superblocks are corrupted, and a last-ditch
	103	recovery method is desired. It causes mke2fs to reinitialize the
	104	superblock and group descriptors, while not touching the inode table
	105	and the block and inode bitmaps. The
	106	.B e2fsck
	107	program should be run immediately after this option is used, and there
	108	is no gaurantee that any data will be salvageable.
3839e657 TT	109	.SH AUTHOR
	110	This version of
	111	.B mke2fs
a418d3ad	112	has been written by Theodore Ts'o <tytso@mit.edu>.
3839e657 TT	113	.SH BUGS
	114	.B mke2fs
	115	accepts the -f option but currently ignores it because the second
	116	extended file system does not support fragments yet.
	117	.br
	118	There may be some other ones. Please, report them to the author.
	119	.SH AVAILABILITY
	120	.B mke2fs
f3db3566 TT	121	is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in
f3db3566 TT	122	/pub/linux/packages/ext2fs.
3839e657	123	.SH SEE ALSO
f3db3566	124	.BT badblocks (8),
3839e657 TT	125	.BR dumpe2fs (8),
	126	.BR e2fsck (8),
	127	.BR tune2fs (8)