[thirdparty/e2fsprogs.git] / resize / resize2fs.8.in

.\" -*- nroff -*-
.\" Copyright 1997 by Theodore Ts'o.  All Rights Reserved.
.\" 
.TH RESIZE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
.SH NAME
resize2fs \- ext2 file system resizer
.SH SYNOPSIS
.B resize2fs
[
.B \-d 
.I debug-flags
]
[
.B \-f
]
[
.B \-F
]
[
.B \-p
]
.I device
[
.I size
]
.SH DESCRIPTION
The 
.B resize2fs 
program will resize ext2 file systems.  It can be used to enlarge or
shrink an ext2 file system located on
.I device 
so that it will have 
.I size 
blocks.
If the
.I size
parameter is not specified, it will default to the size of the partition.
The 
.I size
parameter may never be larger than the size of the partition.
.PP
The
.B resize2fs
program does not manipulate the size of partitions.  If you wish to enlarge
a filesystem, you must first make sure you can expand the size of the
underlying partition first.  This can be done using 
.BR fdisk (8)
by deleting the partition and recreating it with a larger size.  When 
recreating the partition, make sure you create it with the same starting
disk cylinder as before!  Otherwise, the resize operation will 
certainly not work, and you may lose your entire filesystem.
.PP
If you wish to shrink the an ext2 partition, first use 
.B resize2fs
to shrink the size of filesystem.  Then you may use 
.BR fdisk (8)
to shrink the size of the partition.  When shrinking the size of 
the partition, make sure you do not make it smaller than the new size 
of the ext2 filesystem!
.SH OPTIONS
.TP
.I \-d debug-flags
Turns on various resize2fs debugging features, if they have been compiled 
into the binary.
.I debug-flags
should be computed by adding the numbers of the desired features 
from the following list:
.br
\	1\	\-\ Print out all disk I/O 
.br
\	2\	\-\ Debug block relocations
.br
\	8\	\-\ Debug inode relocations
.br
\	16\	\-\ Debug moving the inode table
.TP
.I \-p
Prints out a percentage completion bars for each 
.B resize2fs
operation, so that the user can keep track of what
the program is doing.
.TP 
.I \-f
Forces resize2fs to proceed with the filesystem resize operation, overriding 
some safety checks which resize2fs normally enforces.
.TP
.I \-F
Flush the filesystem device's buffer caches before beginning.  Only
really useful for doing 
.B resize2fs
time trials.
.SH AUTHOR
.B resize2fs
was written by Theodore Ts'o <tytso@mit.edu>.
.SH COPYRIGHT
Resize2fs is Copyright 1998 by Theodore Ts'o and PowerQuest, Inc.  All
rights reserved.  
.B Resize2fs
may not be redistributed without the prior
consent of PowerQuest.  This version of 
.B resize2fs
is available to licensed
users of Partition Magic(tm).
.SH SEE ALSO
.BR fdisk (8),
.BR e2fsck (8),
.BR mke2fs (8)
Commit	Line	Data
24b2c7a7 TT	1	.\" -- nroff --
	2	.\" Copyright 1997 by Theodore Ts'o. All Rights Reserved.
	3	.\"
	4	.TH RESIZE2FS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
	5	.SH NAME
	6	resize2fs \- ext2 file system resizer
	7	.SH SYNOPSIS
	8	.B resize2fs
	9	[
c762c8e6 TT	10	.B \-d
c762c8e6 TT	11	.I debug-flags
24b2c7a7	12	]
c762c8e6	13	[
f4b2a6db	14	.B \-f
c762c8e6 TT	15	]
	16	[
	17	.B \-F
	18	]
f4b2a6db TT	19	[
	20	.B \-p
	21	]
c762c8e6	22	.I device
f4b2a6db	23	[
c762c8e6	24	.I size
f4b2a6db	25	]
24b2c7a7 TT	26	.SH DESCRIPTION
24b2c7a7 TT	27	The
c762c8e6	28	.B resize2fs
24b2c7a7	29	program will resize ext2 file systems. It can be used to enlarge or
f4b2a6db TT	30	shrink an ext2 file system located on
	31	.I device
	32	so that it will have
c762c8e6 TT	33	.I size
c762c8e6 TT	34	blocks.
f4b2a6db TT	35	If the
	36	.I size
	37	parameter is not specified, it will default to the size of the partition.
	38	The
	39	.I size
	40	parameter may never be larger than the size of the partition.
	41	.PP
	42	The
	43	.B resize2fs
	44	program does not manipulate the size of partitions. If you wish to enlarge
	45	a filesystem, you must first make sure you can expand the size of the
	46	underlying partition first. This can be done using
	47	.BR fdisk (8)
	48	by deleting the partition and recreating it with a larger size. When
	49	recreating the partition, make sure you create it with the same starting
	50	disk cylinder as before! Otherwise, the resize operation will
	51	certainly not work, and you may lose your entire filesystem.
	52	.PP
	53	If you wish to shrink the an ext2 partition, first use
	54	.B resize2fs
	55	to shrink the size of filesystem. Then you may use
	56	.BR fdisk (8)
	57	to shrink the size of the partition. When shrinking the size of
	58	the partition, make sure you do not make it smaller than the new size
	59	of the ext2 filesystem!
24b2c7a7 TT	60	.SH OPTIONS
24b2c7a7 TT	61	.TP
c762c8e6	62	.I \-d debug-flags
f4b2a6db TT	63	Turns on various resize2fs debugging features, if they have been compiled
f4b2a6db TT	64	into the binary.
c762c8e6 TT	65	.I debug-flags
	66	should be computed by adding the numbers of the desired features
	67	from the following list:
	68	.br
	69	\ 1\ \-\ Print out all disk I/O
	70	.br
	71	\ 2\ \-\ Debug block relocations
	72	.br
	73	\ 8\ \-\ Debug inode relocations
	74	.br
	75	\ 16\ \-\ Debug moving the inode table
	76	.TP
	77	.I \-p
	78	Prints out a percentage completion bars for each
	79	.B resize2fs
	80	operation, so that the user can keep track of what
	81	the program is doing.
	82	.TP
f4b2a6db TT	83	.I \-f
	84	Forces resize2fs to proceed with the filesystem resize operation, overriding
	85	some safety checks which resize2fs normally enforces.
	86	.TP
c762c8e6 TT	87	.I \-F
	88	Flush the filesystem device's buffer caches before beginning. Only
	89	really useful for doing
	90	.B resize2fs
	91	time trials.
24b2c7a7	92	.SH AUTHOR
c762c8e6	93	.B resize2fs
24b2c7a7	94	was written by Theodore Ts'o <tytso@mit.edu>.
fac9c206 TT	95	.SH COPYRIGHT
	96	Resize2fs is Copyright 1998 by Theodore Ts'o and PowerQuest, Inc. All
	97	rights reserved.
	98	.B Resize2fs
	99	may not be redistributed without the prior
	100	consent of PowerQuest. This version of
	101	.B resize2fs
	102	is available to licensed
	103	users of Partition Magic(tm).
24b2c7a7	104	.SH SEE ALSO
f4b2a6db	105	.BR fdisk (8),
24b2c7a7 TT	106	.BR e2fsck (8),
24b2c7a7 TT	107	.BR mke2fs (8)