misc/mke2fs.8.in

   1 .\" -*- nroff -*-
   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 .\"
   5 .TH MKE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
   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 [
  36 .B \-q
  37 ]
  38 [
  39 .B \-v
  40 ]
  41 [
  42 .B \-F
  43 ]
  44 [
  45 .B \-S
  46 ]
  47 device
  48 [
  49 blocks-count
  50 ]
  51 .SH DESCRIPTION
  52 .B mke2fs
  53 is used to create a Linux second extended file system on a device (usually
  54 a disk partition).
  55 .br
  56 .I device
  57 is the special file corresponding to the device (e.g /dev/hdXX).
  58 .br
  59 .I blocks-count
  60 is the number of blocks on the device.  If omitted,
  61 .B mke2fs
  62 automagically figures the file system size.
  63 .SH OPTIONS
  64 .TP
  65 .I -b block-size
  66 Specify the size of blocks in bytes.
  67 .TP
  68 .I -c
  69 Check the device for bad blocks before creating the file system, using a
  70 fast read-only test.
  71 .TP
  72 .I -f fragment-size
  73 Specify the size of fragments in bytes.
  74 .TP
  75 .I -i bytes-per-inode
  76 Specify the bytes/inode ratio.
  77 .B mke2fs
  78 creates an inode for every
  79 .I bytes-per-inode
  80 bytes of space on the disk.  This value defaults to 4096 bytes.
  81 .I bytes-per-inode
  82 must be at least 1024.
  83 .TP
  84 .I -l filename
  85 Read the bad blocks list from
  86 .I filename
  87 \.
  88 .TP
  89 .I -m reserved-blocks-percentage
  90 Specify the percentage of reserved blocks for the super-user.  This value
  91 defaults to 5%.
  92 .\" .TP
  93 .\" .I -t test
  94 .\" Check the device for bad blocks before creating the file system
  95 .\" using the specified test.
  96 .TP
  97 .I -q
  98 Quiet execution.  Useful if mke2fs is run in a script.
  99 .TP
 100 .I -v
 101 Verbose execution.
 102 .TP
 103 .I -F
 104 Force mke2fs to run, even if the specified device is not a
 105 block special device.
 106 .TP
 107 .I -S
 108 Write superblock and group descriptors only.  This is useful if all of
 109 the superblock and backup superblocks are corrupted, and a last-ditch
 110 recovery method is desired.  It causes mke2fs to reinitialize the
 111 superblock and group descriptors, while not touching the inode table
 112 and the block and inode bitmaps.  The
 113 .B e2fsck
 114 program should be run immediately after this option is used, and there
 115 is no guarantee that any data will be salvageable.
 116 .SH AUTHOR
 117 This version of
 118 .B mke2fs
 119 has been written by Theodore Ts'o <tytso@mit.edu>.
 120 .SH BUGS
 121 .B mke2fs
 122 accepts the -f option but currently ignores it because the second
 123 extended file system does not support fragments yet.
 124 .br
 125 There may be some other ones.  Please, report them to the author.
 126 .SH AVAILABILITY
 127 .B mke2fs
 128 is available for anonymous ftp from ftp.ibp.fr and tsx-11.mit.edu in
 129 /pub/linux/packages/ext2fs.
 130 .SH SEE ALSO
 131 .BT badblocks (8),
 132 .BR dumpe2fs (8),
 133 .BR e2fsck (8),
 134 .BR tune2fs (8)