NAME

ntfstruncate - truncate a file on an NTFS volume

SYNOPSIS

ntfstruncate [options] device file [attr-type [attr-name]] new-length

DESCRIPTION

ntfstruncate truncates (or extends) a specified attribute belonging to a file or directory, to a specified length.

OPTIONS

Below is a summary of all the options that ntfstruncate accepts. Nearly all options have two equivalent names. The short name is preceded by - and the long name is preceded by --. Any single letter options, that don't take an argument, can be combined into a single command, e.g. -fv is equivalent to -f -v. Long named options can be abbreviated to any unique prefix of their name.

-f, --force

This will override some sensible defaults, such as not using a mounted volume. Use this option with caution.

-h, --help

Show a list of options with a brief description of each one.

-l

Display licensing information.

-n, --no-action

Simulate the truncation without actually write to device.

-q, --quiet

Suppress some debug/warning/error messages.

-v, --verbose

Display more debug/warning/error messages.

-V, --version

Show the version number, copyright and license of ntfstruncate.

attr-type

Define a particular attribute type to be truncated (advanced use only). By default, the unnamed $DATA attribute (the contents of a plain file) will be truncated. The attribute has to be specified by a number in decimal or hexadecimal :

Hex Decimal Name
0x10 16 "$STANDARD_INFORMATION"
0x20 32 "$ATTRIBUTE_LIST"
0x30 48 "$FILE_NAME"
0x40 64 "$OBJECT_ID"
0x50 80 "$SECURITY_DESCRIPTOR"
0x60 96 "$VOLUME_NAME"
0x70 112 "$VOLUME_INFORMATION"
0x80 128 "$DATA"
0x90 144 "$INDEX_ROOT"
0xA0 160 "$INDEX_ALLOCATION"
0xB0 176 "$BITMAP"
0xC0 192 "$REPARSE_POINT"
0xD0 208 "$EA_INFORMATION"
0xE0 224 "$EA"
0xF0 240 "$PROPERTY_SET"
0x100 256 "$LOGGED_UTILITY_STREAM"
attr-name

Define the name of the particular attribute type to be truncated (advanced use only).

new-length

Specify the target size of the file. It will be rounded up to a multiple of the cluster size. A suffix of K, M, G, T, P or E may be appended to mean a multiplicative factor of a power of 1000. Similarly a suffix of Ki, Mi, Gi, Ti, Pi or Ei may be appended to mean a multiplicative factor of a power of 1024.

EXAMPLES

Resize to 100MB the file database.db located in the Data directory which is at the root of an NTFS file system.

ntfstruncate /dev/sda1 Data/database.db 100M

BUGS

There are no known problems with ntfstruncate. If you find a bug, please send an email describing the problem to the development team:

ntfs-3g-devel@lists.sf.net

AUTHORS

ntfstruncate was written by Anton Altaparmakov.

AVAILABILITY

ntfstruncate is part of the ntfs-3g package and is available from:

http://www.tuxera.com/community/

SEE ALSO

ntfs-3g(8), ntfsfallocate(8), ntfsprogs(8).