Manpages - ntfstruncate.8
Table of Contents
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:
SEE ALSO
*ntfs-3g*(8), *ntfsfallocate*(8), *ntfsprogs*(8).