bionic (8) ntfstruncate.8.gz

Provided by: ntfs-3g_2017.3.23-2ubuntu0.18.04.5_amd64 bug

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).