143 lines
4.4 KiB
Groff
143 lines
4.4 KiB
Groff
.\" -*- nroff -*-
|
|
.\" Copyright 2002 by Szabolcs Szakacsits All Rights Reserved.
|
|
.\"
|
|
.TH NTFSRESIZE 8 "November 2002" "Linux\-NTFS @VERSION@"
|
|
.SH NAME
|
|
ntfsresize \- resize an NTFS filesystem
|
|
.SH SYNOPSIS
|
|
.B ntfsresize
|
|
[\fB\-fhin\fR]
|
|
[\fB\-s \fIsize\fR[\fBk\fR|\fBM\fR|\fBG\fR]]
|
|
.I device
|
|
.SH DESCRIPTION
|
|
The
|
|
.B ntfsresize
|
|
program non-destructively resizes Windows NT4, 2000, XP or .NET
|
|
NTFS filesystems. At present it can be used to enlarge or shrink a
|
|
defragmented NTFS filesystem located on an unmounted
|
|
.I device
|
|
(usually a disk partition). The new volume will have
|
|
.I size
|
|
bytes.
|
|
The
|
|
.I size
|
|
parameter may have one of the optional modifiers
|
|
\fBk\fR, \fBM\fR, \fBG\fR, which means the
|
|
.I size
|
|
parameter is given in kilo-, mega- or gigabytes respectively.
|
|
.B ntfsresize
|
|
conforms to the SI, ATA, IEEE standards and the disk manufacturers
|
|
by using k=10^3, M=10^6 and G=10^9.
|
|
The options
|
|
.B -i
|
|
and
|
|
.B -s
|
|
are mutually exclusive. If both of them is omitted then the
|
|
NTFS filesystem will be enlarged to the device size.
|
|
.PP
|
|
The
|
|
.B ntfsresize
|
|
program doesn't manipulate the size of partitions.
|
|
To do that you have to use a disk partitioning tool, for example
|
|
.BR fdisk (8).
|
|
.PP
|
|
If you wish to enlarge an NTFS 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.
|
|
Then you may use
|
|
.B ntfsresize
|
|
to enlarge the size of the filesystem.
|
|
.PP
|
|
If you wish to shrink an NTFS partition, first use
|
|
.B ntfsresize
|
|
to shrink the size of the filesystem. Then you may use
|
|
.BR fdisk (8)
|
|
to shrink the size of the partition by deleting the
|
|
partition and recreating it with the smaller size.
|
|
.PP
|
|
.B IMPORTANT!
|
|
When recreating the partition with
|
|
.BR fdisk (8)
|
|
make sure you create it with the same starting
|
|
disk cylinder and partition type
|
|
as before.
|
|
If you enlarge a partition make sure it will not overlap with
|
|
an other existing partition!
|
|
If you shrink a partition, do not make
|
|
it smaller than the new size of the NTFS filesystem!
|
|
Otherwise you may lose your entire filesystem.
|
|
Also make sure you set the bootable flag for the partition if it
|
|
existed before. Failing to do so you might not be able to boot your
|
|
computer from the disk!
|
|
.PP
|
|
Note,
|
|
.B ntfsresize
|
|
schedules 'chkdsk' to make an NTFS consistency check
|
|
when you will boot Windows. Windows may force a reboot after
|
|
the successful consistency check.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -f
|
|
Forces ntfsresize to proceed with the filesystem resize operation, overriding
|
|
some safety checks which
|
|
.B ntfsresize
|
|
normally enforces. You can use this
|
|
parameter multiply times if you want to overcome every single safety checks.
|
|
.TP
|
|
.B -h
|
|
Display help and exit.
|
|
.TP
|
|
.B -i
|
|
Using this option you can calculate the smallest shrunken volume size supported.
|
|
This option will not make any changes to the filesystem.
|
|
.TP
|
|
.B -n
|
|
You can use this option to make a test run before doing the real resize operation.
|
|
Volume will be opened read-only and
|
|
.B ntfsresize
|
|
displays what it would do if it were to resize the filesystem.
|
|
.TP
|
|
.B -s \fIsize\fR[\fBk\fR|\fBM\fR|\fBG\fR]
|
|
Resize volume to \fIsize\fR[\fBk\fR|\fBM\fR|\fBG\fR] bytes.
|
|
The optional modifiers \fBk\fR, \fBM\fR, \fBG\fR mean the
|
|
.I size
|
|
parameter is given in kilo-, mega- or gigabytes respectively.
|
|
Conforming to standards, k=10^3, M=10^6 and G=10^9.
|
|
.SH BUGS
|
|
No bugs are known or has been reported so far in the current version.
|
|
If you find otherwise, please report it to <linux-ntfs-dev@lists.sourceforge.net>
|
|
(no subscription needed). It's also strongly advised you
|
|
.B MAKE SURE YOU HAVE A BACKUP
|
|
of your important data in case of an unexpected failure.
|
|
.PP
|
|
Future work is planned to include support resizing fragmented NTFS volumes.
|
|
Please note, Windows 2000, XP and .NET have built in NTFS defragmenter.
|
|
.SH AUTHOR
|
|
.B ntfsresize
|
|
has been written by
|
|
Szabolcs Szakacsits <szaka@sienet.hu>.
|
|
.SH ACKNOWLEDGEMENT
|
|
Many thanks to Anton Altaparmakov and Richard Russon (FlatCap)
|
|
for libntfs, excellent documentation, comments, testing and fixes,
|
|
moreover to Theodore Ts'o whose
|
|
.BR resize2fs (8)
|
|
man page formed the basis of this page.
|
|
.SH AVAILABILITY
|
|
.B ntfsresize
|
|
is part of the linux-ntfs package and is available from
|
|
http://linux-ntfs.sourceforge.net/ as source and pre-compiled binary.
|
|
.B ntfsresize
|
|
related news and FAQ (frequently asked questions) is maintained at
|
|
http://mlf.linux.rulez.org/mlf/ezaz/ntfsresize.html
|
|
.SH SEE ALSO
|
|
.BR fdisk (8),
|
|
.BR cfdisk (8),
|
|
.BR sfdisk (8),
|
|
.BR parted (8),
|
|
.BR mkntfs (8),
|
|
.BR ntfsprogs (8)
|
|
|