ChangeLog, mke2fs.c, badblocks.c:

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

.\" -*- 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 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
.SH NAME
mke2fs \- create a Linux second extended file system
.SH SYNOPSIS
.B mke2fs
[
.B \-c
| 
.\" .B \-t
.\" test
.\" |
.B \-l
.I filename
]
[
.B \-b
.I block-size
]
[
.B \-f
.I fragment-size
]
[
.B \-i
.I bytes-per-inode
]
[
.B \-m
.I reserved-blocks-percentage
]
[
.B \-o
.I creator-os
]
[
.B \-q
]
[
.B \-r fs-revision-level
]
[
.B -R raid_options
]
[
.B -s sparse-super-flag
]
[
.B \-v
]
[
.B \-F
]
[
.B \-L
.I volume-label
]
[
.B \-M
.I last-mounted-directory
]
[
.B \-S
]
.I device
[
.I 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 -o
Manually override the default value of the "creator os" field of the 
filesystem.  Normally the creator field is set by default to the native OS
of the mke2fs executable.
.TP
.I -q
Quiet execution.  Useful if mke2fs is run in a script.
.TP
.I -s sparse-super-flag
If sparse-super-flag is 1, then turn on the sparse superblock flag.  
If 0, then turn off the sparse superblock flag.  (Currently, the sparse 
superblock flag defaults to off.)  
.B Warning:
The Linux 2.0 kernel does not properly support this feature.  Neither do
all Linux 2.1 kernels; please don't use this unless you know what you're
doing!
.TP
.I -v
Verbose execution.
.TP
.I -F
Force mke2fs to run, even if the specified device is not a 
block special device.
.TP
.I -L
Set the volume label for the filesystem.
.TP
.I -M
Set the last mounted directory for the filesystem.  This might be useful 
for the sake of utilities that key off of the last mounted directory to 
determine where the filesytem should be mounted.
.TP
.I -r revision
Set the filesystem revision for the new filesystem.  Note that 1.2
kernels only support revision 0 filesystems.
.TP
.I -R raid_options
Set raid-related options for the filesystem.  Raid options are common
separated, and may take an argument using the equals ('=')  sign.
Currently the only supported argument is 
.I stride
which takes as its argument the number of blocks in a RAID stripe.
.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 guarantee 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)