]>
Commit | Line | Data |
---|---|---|
24b2c7a7 TT |
1 | .\" -*- nroff -*- |
2 | .\" Copyright 1997 by Theodore Ts'o. All Rights Reserved. | |
3 | .\" | |
ba0af756 | 4 | .\" .TH RESIZE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
0cee8a5c | 5 | .TH RESIZE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
24b2c7a7 | 6 | .SH NAME |
4f858546 | 7 | resize2fs \- ext2/ext3/ext4 file system resizer |
24b2c7a7 TT |
8 | .SH SYNOPSIS |
9 | .B resize2fs | |
10 | [ | |
fe12931f | 11 | .B \-fFpPMbs |
199ddaaa JB |
12 | ] |
13 | [ | |
4780e870 | 14 | .B \-d |
c762c8e6 | 15 | .I debug-flags |
24b2c7a7 | 16 | ] |
c762c8e6 | 17 | [ |
46c5490d TT |
18 | .B \-S |
19 | .I RAID-stride | |
20 | ] | |
03f9fd2a DW |
21 | [ |
22 | .B \-z | |
23 | .I undo_file | |
24 | ] | |
c762c8e6 | 25 | .I device |
f4b2a6db | 26 | [ |
c762c8e6 | 27 | .I size |
f4b2a6db | 28 | ] |
24b2c7a7 | 29 | .SH DESCRIPTION |
4780e870 TT |
30 | The |
31 | .B resize2fs | |
4f858546 | 32 | program will resize ext2, ext3, or ext4 file systems. It can be used to |
4780e870 | 33 | enlarge or shrink an unmounted file system located on |
792a0881 | 34 | .IR device . |
bf69235a | 35 | If the filesystem is mounted, it can be used to expand the size of the |
061c566e TT |
36 | mounted filesystem, assuming the kernel and the file system supports |
37 | on-line resizing. (Modern Linux 2.6 kernels will support on-line resize | |
38 | for file systems mounted using ext3 and ext4; ext3 file systems will | |
39 | require the use of file systems with the resize_inode feature enabled.) | |
bf69235a | 40 | .PP |
4780e870 | 41 | The |
f4b2a6db | 42 | .I size |
792a0881 TT |
43 | parameter specifies the requested new size of the filesystem. |
44 | If no units are specified, the units of the | |
45 | .I size | |
46 | parameter shall be the filesystem blocksize of the filesystem. | |
4780e870 | 47 | Optionally, the |
792a0881 | 48 | .I size |
4780e870 | 49 | parameter may be suffixed by one of the following the units |
792a0881 TT |
50 | designators: 's', 'K', 'M', or 'G', |
51 | for 512 byte sectors, kilobytes, megabytes, or gigabytes, respectively. | |
4780e870 | 52 | The |
f4b2a6db | 53 | .I size |
792a0881 | 54 | of the filesystem may never be larger than the size of the partition. |
4780e870 | 55 | If |
792a0881 TT |
56 | .I size |
57 | parameter is not specified, it will default to the size of the partition. | |
f4b2a6db | 58 | .PP |
63feaa13 TT |
59 | Note: when kilobytes is used above, I mean |
60 | .IR real , | |
61 | power-of-2 kilobytes, (i.e., 1024 bytes), which some politically correct | |
62 | folks insist should be the stupid-sounding ``kibibytes''. The same | |
63 | holds true for megabytes, also sometimes known as ``mebibytes'', or | |
64 | gigabytes, as the amazingly silly ``gibibytes''. Makes you want to | |
65 | gibber, doesn't it? | |
66 | .PP | |
f4b2a6db TT |
67 | The |
68 | .B resize2fs | |
69 | program does not manipulate the size of partitions. If you wish to enlarge | |
3e9f8632 | 70 | a filesystem, you must make sure you can expand the size of the |
4780e870 | 71 | underlying partition first. This can be done using |
f4b2a6db | 72 | .BR fdisk (8) |
41e55437 TT |
73 | by deleting the partition and recreating it with a larger size or using |
74 | .BR lvextend (8), | |
75 | if you're using the logical volume manager | |
76 | .BR lvm (8). | |
4780e870 | 77 | When |
f4b2a6db | 78 | recreating the partition, make sure you create it with the same starting |
4780e870 TT |
79 | disk cylinder as before! Otherwise, the resize operation will |
80 | certainly not work, and you may lose your entire filesystem. | |
23658ffa TT |
81 | After running |
82 | .BR fdisk (8), | |
4780e870 | 83 | run resize2fs to resize the ext2 filesystem |
23658ffa | 84 | to use all of the space in the newly enlarged partition. |
f4b2a6db | 85 | .PP |
4780e870 | 86 | If you wish to shrink an ext2 partition, first use |
f4b2a6db | 87 | .B resize2fs |
4780e870 | 88 | to shrink the size of filesystem. Then you may use |
f4b2a6db | 89 | .BR fdisk (8) |
4780e870 TT |
90 | to shrink the size of the partition. When shrinking the size of |
91 | the partition, make sure you do not make it smaller than the new size | |
f4b2a6db | 92 | of the ext2 filesystem! |
fe12931f DW |
93 | .PP |
94 | The | |
95 | .B \-b | |
96 | and | |
97 | .B \-s | |
98 | options enable and disable the 64bit feature, respectively. The resize2fs | |
99 | program will, of course, take care of resizing the block group descriptors | |
100 | and moving other data blocks out of the way, as needed. It is not possible | |
101 | to resize the filesystem concurrent with changing the 64bit status. | |
24b2c7a7 TT |
102 | .SH OPTIONS |
103 | .TP | |
fe12931f DW |
104 | .B \-b |
105 | Turns on the 64bit feature, resizes the group descriptors as necessary, and | |
106 | moves other metadata out of the way. | |
107 | .TP | |
46c5490d | 108 | .B \-d \fIdebug-flags |
4780e870 | 109 | Turns on various resize2fs debugging features, if they have been compiled |
f4b2a6db | 110 | into the binary. |
c762c8e6 | 111 | .I debug-flags |
4780e870 | 112 | should be computed by adding the numbers of the desired features |
c762c8e6 TT |
113 | from the following list: |
114 | .br | |
4780e870 | 115 | 2 \-\ Debug block relocations |
c762c8e6 | 116 | .br |
4780e870 | 117 | 4 \-\ Debug inode relocations |
c762c8e6 | 118 | .br |
4780e870 | 119 | 8 \-\ Debug moving the inode table |
1eb31c48 TT |
120 | .br |
121 | 16 \-\ Print timing information | |
e231f175 TT |
122 | .br |
123 | 32 \-\ Debug minimum filesystem size (\-M) calculation | |
124 | .TP | |
46c5490d | 125 | .B \-f |
4780e870 | 126 | Forces resize2fs to proceed with the filesystem resize operation, overriding |
f4b2a6db TT |
127 | some safety checks which resize2fs normally enforces. |
128 | .TP | |
46c5490d | 129 | .B \-F |
c762c8e6 | 130 | Flush the filesystem device's buffer caches before beginning. Only |
4780e870 | 131 | really useful for doing |
c762c8e6 TT |
132 | .B resize2fs |
133 | time trials. | |
199ddaaa JB |
134 | .TP |
135 | .B \-M | |
97b7a946 TT |
136 | Shrink the file system to minimize its size as much as possible, |
137 | given the files stored in the file system. | |
199ddaaa JB |
138 | .TP |
139 | .B \-p | |
140 | Prints out a percentage completion bars for each | |
141 | .B resize2fs | |
4780e870 | 142 | operation during an offline resize, so that the user can keep track |
230709ae | 143 | of what the program is doing. |
199ddaaa JB |
144 | .TP |
145 | .B \-P | |
97b7a946 TT |
146 | Print an extimate of the number of file system blocks in the file system |
147 | if it is shrunk using | |
148 | .BR resize2fs 's | |
149 | .B \-M | |
150 | option and then exit. | |
199ddaaa | 151 | .TP |
fe12931f DW |
152 | .B \-s |
153 | Turns off the 64bit feature and frees blocks that are no longer in use. | |
154 | .TP | |
199ddaaa JB |
155 | .B \-S \fIRAID-stride |
156 | The | |
157 | .B resize2fs | |
158 | program will heuristically determine the RAID stride that was specified | |
159 | when the filesystem was created. This option allows the user to | |
160 | explicitly specify a RAID stride setting to be used by resize2fs instead. | |
03f9fd2a DW |
161 | .TP |
162 | .BI \-z " undo_file" | |
163 | Before overwriting a file system block, write the old contents of the block to | |
164 | an undo file. This undo file can be used with e2undo(8) to restore the old | |
165 | contents of the file system should something go wrong. If the empty string is | |
166 | passed as the undo_file argument, the undo file will be written to a file named | |
167 | resize2fs-\fIdevice\fR.e2undo in the directory specified via the | |
168 | \fIE2FSPROGS_UNDO_DIR\fR environment variable. | |
169 | ||
170 | WARNING: The undo file cannot be used to recover from a power or system crash. | |
199ddaaa JB |
171 | .SH KNOWN BUGS |
172 | The minimum size of the filesystem as estimated by resize2fs may be | |
173 | incorrect, especially for filesystems with 1k and 2k blocksizes. | |
24b2c7a7 | 174 | .SH AUTHOR |
c762c8e6 | 175 | .B resize2fs |
24b2c7a7 | 176 | was written by Theodore Ts'o <tytso@mit.edu>. |
fac9c206 TT |
177 | .SH COPYRIGHT |
178 | Resize2fs is Copyright 1998 by Theodore Ts'o and PowerQuest, Inc. All | |
4780e870 | 179 | rights reserved. |
0cee8a5c | 180 | As of April, 2000 |
fac9c206 | 181 | .B Resize2fs |
0cee8a5c | 182 | may be redistributed under the terms of the GPL. |
24b2c7a7 | 183 | .SH SEE ALSO |
f4b2a6db | 184 | .BR fdisk (8), |
24b2c7a7 | 185 | .BR e2fsck (8), |
41e55437 | 186 | .BR mke2fs (8), |
4780e870 | 187 | .BR lvm (8), |
41e55437 | 188 | .BR lvextend (8) |