]>
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 | .\" | |
74becf3c | 5 | .TH MKE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
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 | |
1e3472c5 | 17 | .I filename |
3839e657 TT |
18 | ] |
19 | [ | |
20 | .B \-b | |
1e3472c5 | 21 | .I block-size |
3839e657 TT |
22 | ] |
23 | [ | |
24 | .B \-f | |
1e3472c5 | 25 | .I fragment-size |
3839e657 TT |
26 | ] |
27 | [ | |
28 | .B \-i | |
1e3472c5 | 29 | .I bytes-per-inode |
3839e657 TT |
30 | ] |
31 | [ | |
32 | .B \-m | |
1e3472c5 TT |
33 | .I reserved-blocks-percentage |
34 | ] | |
35 | [ | |
36 | .B \-o | |
37 | .I creator-os | |
3839e657 TT |
38 | ] |
39 | [ | |
f3db3566 TT |
40 | .B \-q |
41 | ] | |
42 | [ | |
a29f4d30 TT |
43 | .B \-r fs-revision-level |
44 | ] | |
45 | [ | |
46 | .B -R raid_options | |
47 | ] | |
48 | [ | |
521e3685 TT |
49 | .B -s sparse-super-flag |
50 | ] | |
51 | [ | |
3839e657 TT |
52 | .B \-v |
53 | ] | |
f3db3566 | 54 | [ |
74becf3c TT |
55 | .B \-F |
56 | ] | |
57 | [ | |
1e3472c5 TT |
58 | .B \-L |
59 | .I volume-label | |
60 | ] | |
61 | [ | |
62 | .B \-M | |
63 | .I last-mounted-directory | |
64 | ] | |
65 | [ | |
f3db3566 TT |
66 | .B \-S |
67 | ] | |
1e3472c5 | 68 | .I device |
3839e657 | 69 | [ |
1e3472c5 | 70 | .I blocks-count |
3839e657 TT |
71 | ] |
72 | .SH DESCRIPTION | |
73 | .B mke2fs | |
74 | is used to create a Linux second extended file system on a device (usually | |
75 | a disk partition). | |
76 | .br | |
77 | .I device | |
78 | is the special file corresponding to the device (e.g /dev/hdXX). | |
79 | .br | |
80 | .I blocks-count | |
81 | is the number of blocks on the device. If omitted, | |
82 | .B mke2fs | |
83 | automagically figures the file system size. | |
84 | .SH OPTIONS | |
85 | .TP | |
86 | .I -b block-size | |
87 | Specify the size of blocks in bytes. | |
88 | .TP | |
89 | .I -c | |
90 | Check the device for bad blocks before creating the file system, using a | |
91 | fast read-only test. | |
92 | .TP | |
93 | .I -f fragment-size | |
94 | Specify the size of fragments in bytes. | |
95 | .TP | |
96 | .I -i bytes-per-inode | |
97 | Specify the bytes/inode ratio. | |
98 | .B mke2fs | |
99 | creates an inode for every | |
100 | .I bytes-per-inode | |
101 | bytes of space on the disk. This value defaults to 4096 bytes. | |
102 | .I bytes-per-inode | |
103 | must be at least 1024. | |
104 | .TP | |
105 | .I -l filename | |
106 | Read the bad blocks list from | |
583ccdc3 | 107 | .I filename. |
3839e657 TT |
108 | \. |
109 | .TP | |
110 | .I -m reserved-blocks-percentage | |
111 | Specify the percentage of reserved blocks for the super-user. This value | |
112 | defaults to 5%. | |
113 | .\" .TP | |
114 | .\" .I -t test | |
115 | .\" Check the device for bad blocks before creating the file system | |
116 | .\" using the specified test. | |
117 | .TP | |
1e3472c5 TT |
118 | .I -o |
119 | Manually override the default value of the "creator os" field of the | |
120 | filesystem. Normally the creator field is set by default to the native OS | |
583ccdc3 TT |
121 | of the |
122 | .B mke2fs | |
123 | executable. | |
1e3472c5 | 124 | .TP |
f3db3566 | 125 | .I -q |
583ccdc3 TT |
126 | Quiet execution. Useful if |
127 | .B mke2fs | |
128 | is run in a script. | |
f3db3566 | 129 | .TP |
521e3685 TT |
130 | .I -s sparse-super-flag |
131 | If sparse-super-flag is 1, then turn on the sparse superblock flag. | |
132 | If 0, then turn off the sparse superblock flag. (Currently, the sparse | |
a29f4d30 TT |
133 | superblock flag defaults to off.) |
134 | .B Warning: | |
135 | The Linux 2.0 kernel does not properly support this feature. Neither do | |
136 | all Linux 2.1 kernels; please don't use this unless you know what you're | |
137 | doing! | |
521e3685 | 138 | .TP |
3839e657 TT |
139 | .I -v |
140 | Verbose execution. | |
7f88b043 | 141 | .TP |
74becf3c | 142 | .I -F |
583ccdc3 TT |
143 | Force |
144 | .B mke2fs | |
145 | to run, even if the specified device is not a | |
7f88b043 | 146 | block special device. |
f3db3566 | 147 | .TP |
1e3472c5 TT |
148 | .I -L |
149 | Set the volume label for the filesystem. | |
150 | .TP | |
151 | .I -M | |
152 | Set the last mounted directory for the filesystem. This might be useful | |
153 | for the sake of utilities that key off of the last mounted directory to | |
154 | determine where the filesytem should be mounted. | |
155 | .TP | |
a29f4d30 TT |
156 | .I -r revision |
157 | Set the filesystem revision for the new filesystem. Note that 1.2 | |
158 | kernels only support revision 0 filesystems. | |
159 | .TP | |
160 | .I -R raid_options | |
161 | Set raid-related options for the filesystem. Raid options are common | |
162 | separated, and may take an argument using the equals ('=') sign. | |
163 | Currently the only supported argument is | |
164 | .I stride | |
165 | which takes as its argument the number of blocks in a RAID stripe. | |
166 | .TP | |
f3db3566 TT |
167 | .I -S |
168 | Write superblock and group descriptors only. This is useful if all of | |
169 | the superblock and backup superblocks are corrupted, and a last-ditch | |
583ccdc3 TT |
170 | recovery method is desired. It causes |
171 | .B mke2fs | |
172 | to reinitialize the | |
f3db3566 TT |
173 | superblock and group descriptors, while not touching the inode table |
174 | and the block and inode bitmaps. The | |
175 | .B e2fsck | |
176 | program should be run immediately after this option is used, and there | |
7f88b043 | 177 | is no guarantee that any data will be salvageable. |
3839e657 TT |
178 | .SH AUTHOR |
179 | This version of | |
180 | .B mke2fs | |
a418d3ad | 181 | has been written by Theodore Ts'o <tytso@mit.edu>. |
3839e657 TT |
182 | .SH BUGS |
183 | .B mke2fs | |
184 | accepts the -f option but currently ignores it because the second | |
185 | extended file system does not support fragments yet. | |
186 | .br | |
187 | There may be some other ones. Please, report them to the author. | |
188 | .SH AVAILABILITY | |
189 | .B mke2fs | |
a789d840 TT |
190 | is part of the e2fsprogs package and is available for anonymous |
191 | ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs. | |
3839e657 | 192 | .SH SEE ALSO |
f3db3566 | 193 | .BT badblocks (8), |
3839e657 TT |
194 | .BR dumpe2fs (8), |
195 | .BR e2fsck (8), | |
196 | .BR tune2fs (8) |