1997-04-26 17:21:57 +04:00
|
|
|
.\" -*- nroff -*-
|
1997-04-26 18:00:26 +04:00
|
|
|
.\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
|
|
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
|
|
.\"
|
1997-04-26 18:37:06 +04:00
|
|
|
.TH MKE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH NAME
|
|
|
|
mke2fs \- create a Linux second extended file system
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B mke2fs
|
|
|
|
[
|
|
|
|
.B \-c
|
|
|
|
|
|
|
|
|
.\" .B \-t
|
|
|
|
.\" test
|
|
|
|
.\" |
|
|
|
|
.B \-l
|
1997-04-29 18:53:37 +04:00
|
|
|
.I filename
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
[
|
|
|
|
.B \-b
|
1997-04-29 18:53:37 +04:00
|
|
|
.I block-size
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
[
|
|
|
|
.B \-f
|
1997-04-29 18:53:37 +04:00
|
|
|
.I fragment-size
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
[
|
|
|
|
.B \-i
|
1997-04-29 18:53:37 +04:00
|
|
|
.I bytes-per-inode
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
[
|
1999-01-05 10:25:06 +03:00
|
|
|
.B \-N
|
|
|
|
.I number-of-inodes
|
|
|
|
]
|
|
|
|
[
|
1997-04-26 17:21:57 +04:00
|
|
|
.B \-m
|
1997-04-29 18:53:37 +04:00
|
|
|
.I reserved-blocks-percentage
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.B \-o
|
|
|
|
.I creator-os
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
[
|
1997-04-26 17:34:30 +04:00
|
|
|
.B \-q
|
|
|
|
]
|
|
|
|
[
|
1997-04-30 01:26:48 +04:00
|
|
|
.B \-r fs-revision-level
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.B -R raid_options
|
|
|
|
]
|
|
|
|
[
|
1997-04-29 21:48:10 +04:00
|
|
|
.B -s sparse-super-flag
|
|
|
|
]
|
|
|
|
[
|
1997-04-26 17:21:57 +04:00
|
|
|
.B \-v
|
|
|
|
]
|
1997-04-26 17:34:30 +04:00
|
|
|
[
|
1997-04-26 18:37:06 +04:00
|
|
|
.B \-F
|
|
|
|
]
|
|
|
|
[
|
1997-04-29 18:53:37 +04:00
|
|
|
.B \-L
|
|
|
|
.I volume-label
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.B \-M
|
|
|
|
.I last-mounted-directory
|
|
|
|
]
|
|
|
|
[
|
1997-04-26 17:34:30 +04:00
|
|
|
.B \-S
|
|
|
|
]
|
ChangeLog, debugfs.8.in, debugfs.c:
Add a -V option which displays the current version.
ChangeLog, unix.c:
unix.c (e2fsck_update_progress): Remove unused variables.
ChangeLog, inode.c:
inode.c (get_next_blockgroup): Fix bug where if get_next_blockgroup()
is called early because of a missing inode table in a block group, the
current_inode counter wasn't incremented correctly.
ChangeLog, tst_uuid.c:
tst_uuid.c (main): Fixed bogus declaration of the main's argv parameter.
ChangeLog, test_icount.c:
test_icount.c (main): Fix main() declaration so that it returns int,
not void.
Many files:
fsck.c (ignore): Remove unused variable cp.
chattr.c (fatal_error):
tune2fs.c (usage):
lsattr.c (usage):
dumpe2fs.c (usage):
badblocks.c (usage): Remove volatile from declaration.
fsck.c: Change use of strdup to be string_copy, since we don't trust
what glibc is doing with strdup. (Whatever it is, it isn't pretty.)
1998-06-27 09:11:14 +04:00
|
|
|
[
|
1999-07-19 19:30:21 +04:00
|
|
|
.B \-T
|
|
|
|
.I filesystem-type
|
|
|
|
]
|
|
|
|
[
|
ChangeLog, debugfs.8.in, debugfs.c:
Add a -V option which displays the current version.
ChangeLog, unix.c:
unix.c (e2fsck_update_progress): Remove unused variables.
ChangeLog, inode.c:
inode.c (get_next_blockgroup): Fix bug where if get_next_blockgroup()
is called early because of a missing inode table in a block group, the
current_inode counter wasn't incremented correctly.
ChangeLog, tst_uuid.c:
tst_uuid.c (main): Fixed bogus declaration of the main's argv parameter.
ChangeLog, test_icount.c:
test_icount.c (main): Fix main() declaration so that it returns int,
not void.
Many files:
fsck.c (ignore): Remove unused variable cp.
chattr.c (fatal_error):
tune2fs.c (usage):
lsattr.c (usage):
dumpe2fs.c (usage):
badblocks.c (usage): Remove volatile from declaration.
fsck.c: Change use of strdup to be string_copy, since we don't trust
what glibc is doing with strdup. (Whatever it is, it isn't pretty.)
1998-06-27 09:11:14 +04:00
|
|
|
.B \-V
|
|
|
|
]
|
1997-04-29 18:53:37 +04:00
|
|
|
.I device
|
1997-04-26 17:21:57 +04:00
|
|
|
[
|
1997-04-29 18:53:37 +04:00
|
|
|
.I blocks-count
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
.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
|
1999-07-19 19:30:21 +04:00
|
|
|
bytes of space on the disk.
|
|
|
|
The larger the bytes-per-inode ratio, the fewer inodes will be created.
|
|
|
|
This value generally shouldn't be smaller than
|
|
|
|
the blocksize of the filesystem, since then too many inodes will be made.
|
|
|
|
Be warned that is not possible to expand the number of inodes on a
|
|
|
|
filesystem after it is created, so be careful decided the correct
|
|
|
|
value for this parameter.
|
1997-04-26 17:21:57 +04:00
|
|
|
.TP
|
1999-01-05 10:25:06 +03:00
|
|
|
.I -N number-of-inodes
|
|
|
|
overrides the default calculation of the number of inodes that should be
|
|
|
|
reserved for the filesystem (which is based on the number of blocks and
|
|
|
|
the bytes-per-inode ratio). This allows the user to specify the number
|
|
|
|
of desired inodes directly.
|
|
|
|
.TP
|
1997-04-26 17:21:57 +04:00
|
|
|
.I -l filename
|
|
|
|
Read the bad blocks list from
|
1997-05-09 07:06:31 +04:00
|
|
|
.I filename.
|
1997-04-26 17:21:57 +04:00
|
|
|
\.
|
|
|
|
.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
|
1997-04-29 18:53:37 +04:00
|
|
|
.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
|
1997-05-09 07:06:31 +04:00
|
|
|
of the
|
|
|
|
.B mke2fs
|
|
|
|
executable.
|
1997-04-29 18:53:37 +04:00
|
|
|
.TP
|
1997-04-26 17:34:30 +04:00
|
|
|
.I -q
|
1997-05-09 07:06:31 +04:00
|
|
|
Quiet execution. Useful if
|
|
|
|
.B mke2fs
|
|
|
|
is run in a script.
|
1997-04-26 17:34:30 +04:00
|
|
|
.TP
|
1997-04-29 21:48:10 +04:00
|
|
|
.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
|
1997-04-30 01:26:48 +04:00
|
|
|
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!
|
1997-04-29 21:48:10 +04:00
|
|
|
.TP
|
1997-04-26 17:21:57 +04:00
|
|
|
.I -v
|
|
|
|
Verbose execution.
|
1997-04-26 18:48:50 +04:00
|
|
|
.TP
|
1997-04-26 18:37:06 +04:00
|
|
|
.I -F
|
1997-05-09 07:06:31 +04:00
|
|
|
Force
|
|
|
|
.B mke2fs
|
|
|
|
to run, even if the specified device is not a
|
1999-06-29 18:37:35 +04:00
|
|
|
block special device, or appears to be mounted.
|
1997-04-26 17:34:30 +04:00
|
|
|
.TP
|
1997-04-29 18:53:37 +04:00
|
|
|
.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
|
1997-04-30 01:26:48 +04:00
|
|
|
.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
|
1998-12-08 05:21:29 +03:00
|
|
|
Set raid-related options for the filesystem. Raid options are comma
|
1997-04-30 01:26:48 +04:00
|
|
|
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
|
1997-04-26 17:34:30 +04:00
|
|
|
.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
|
1997-05-09 07:06:31 +04:00
|
|
|
recovery method is desired. It causes
|
|
|
|
.B mke2fs
|
|
|
|
to reinitialize the
|
1997-04-26 17:34:30 +04:00
|
|
|
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
|
1997-04-26 18:48:50 +04:00
|
|
|
is no guarantee that any data will be salvageable.
|
ChangeLog, debugfs.8.in, debugfs.c:
Add a -V option which displays the current version.
ChangeLog, unix.c:
unix.c (e2fsck_update_progress): Remove unused variables.
ChangeLog, inode.c:
inode.c (get_next_blockgroup): Fix bug where if get_next_blockgroup()
is called early because of a missing inode table in a block group, the
current_inode counter wasn't incremented correctly.
ChangeLog, tst_uuid.c:
tst_uuid.c (main): Fixed bogus declaration of the main's argv parameter.
ChangeLog, test_icount.c:
test_icount.c (main): Fix main() declaration so that it returns int,
not void.
Many files:
fsck.c (ignore): Remove unused variable cp.
chattr.c (fatal_error):
tune2fs.c (usage):
lsattr.c (usage):
dumpe2fs.c (usage):
badblocks.c (usage): Remove volatile from declaration.
fsck.c: Change use of strdup to be string_copy, since we don't trust
what glibc is doing with strdup. (Whatever it is, it isn't pretty.)
1998-06-27 09:11:14 +04:00
|
|
|
.TP
|
1999-07-19 19:30:21 +04:00
|
|
|
.I -T fs-type
|
|
|
|
Specify how the filesystem is going to be used, so that mke2fs can
|
|
|
|
automatically determine the optimal filesystem parameters. The only
|
|
|
|
filesystem type which is currently supported is "news".
|
|
|
|
.TP
|
ChangeLog, debugfs.8.in, debugfs.c:
Add a -V option which displays the current version.
ChangeLog, unix.c:
unix.c (e2fsck_update_progress): Remove unused variables.
ChangeLog, inode.c:
inode.c (get_next_blockgroup): Fix bug where if get_next_blockgroup()
is called early because of a missing inode table in a block group, the
current_inode counter wasn't incremented correctly.
ChangeLog, tst_uuid.c:
tst_uuid.c (main): Fixed bogus declaration of the main's argv parameter.
ChangeLog, test_icount.c:
test_icount.c (main): Fix main() declaration so that it returns int,
not void.
Many files:
fsck.c (ignore): Remove unused variable cp.
chattr.c (fatal_error):
tune2fs.c (usage):
lsattr.c (usage):
dumpe2fs.c (usage):
badblocks.c (usage): Remove volatile from declaration.
fsck.c: Change use of strdup to be string_copy, since we don't trust
what glibc is doing with strdup. (Whatever it is, it isn't pretty.)
1998-06-27 09:11:14 +04:00
|
|
|
.I -V
|
1999-07-19 19:30:21 +04:00
|
|
|
Print the version number of
|
ChangeLog, debugfs.8.in, debugfs.c:
Add a -V option which displays the current version.
ChangeLog, unix.c:
unix.c (e2fsck_update_progress): Remove unused variables.
ChangeLog, inode.c:
inode.c (get_next_blockgroup): Fix bug where if get_next_blockgroup()
is called early because of a missing inode table in a block group, the
current_inode counter wasn't incremented correctly.
ChangeLog, tst_uuid.c:
tst_uuid.c (main): Fixed bogus declaration of the main's argv parameter.
ChangeLog, test_icount.c:
test_icount.c (main): Fix main() declaration so that it returns int,
not void.
Many files:
fsck.c (ignore): Remove unused variable cp.
chattr.c (fatal_error):
tune2fs.c (usage):
lsattr.c (usage):
dumpe2fs.c (usage):
badblocks.c (usage): Remove volatile from declaration.
fsck.c: Change use of strdup to be string_copy, since we don't trust
what glibc is doing with strdup. (Whatever it is, it isn't pretty.)
1998-06-27 09:11:14 +04:00
|
|
|
.B mke2fs
|
|
|
|
and exit.
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH AUTHOR
|
|
|
|
This version of
|
|
|
|
.B mke2fs
|
1997-04-26 18:00:26 +04:00
|
|
|
has been written by Theodore Ts'o <tytso@mit.edu>.
|
1997-04-26 17:21:57 +04:00
|
|
|
.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
|
1998-03-30 05:20:55 +04:00
|
|
|
is part of the e2fsprogs package and is available for anonymous
|
|
|
|
ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs.
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH SEE ALSO
|
ChangeLog, e2fsck.h, pass1.c, pass2.c, pass4.c, swapfs.c:
e2fsck.h:
pass1.c (pass1_get_blocks, pass1_read_inode, pass1_write_inode,
pass1_check_directory, e2fsck_use_inode_shortcuts): Make pass1_* be
private static functions, and create new function
e2fsck_use_inode_shortcuts which sets and clears the inode shortcut
functions in the fs structure.
e2fsck.h:
pass2.c (e2fsck_process_bad_inode): Make process_bad_inode() an
exported function.
pass4.c (e2fsck_pass4): Call e2fsck_process_bad_inode to check if a
disconnected inode has any problems before connecting it to
/lost+found. Bug and suggested fix by Pavel Machek <pavel@bug.ucw.cz>
ChangeLog, swapfs.c:
swapfs.c (ext2fs_swap_inode): Add compatibility for Linux 2.3 kernels
that use i_generation instead of i_version. Patch supplied by Jon
Bright <sircus@sircus.demon.co.uk>.
ChangeLog, mke2fs.8.in:
mke2fs.8.in: Fix typo in man page which caused the badblocks command
to not show up in the "SEE ALSO" section.
ChangeLog, expect.1, expect.2, image.gz, name:
f_recnect_bad: New test which checks the case where a disconnect inode
also bad inode fields; we need to make sure e2fsck offers to fix the
inode (or clear the inode, as necessary).
1999-06-25 19:40:18 +04:00
|
|
|
.BR badblocks (8),
|
1997-04-26 17:21:57 +04:00
|
|
|
.BR dumpe2fs (8),
|
|
|
|
.BR e2fsck (8),
|
|
|
|
.BR tune2fs (8)
|