ntfstruncate(8)

1NTFSTRUNCATE(8)             System Manager's Manual            NTFSTRUNCATE(8)
2
3
4

NAME

6       ntfstruncate - truncate a file on an NTFS volume
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

16       Below is a summary  of  all  the  options  that  ntfstruncate  accepts.
17       Nearly  all  options have two equivalent names.  The short name is pre‐
18       ceded by - and the long name is preceded by --.  Any single letter  op‐
19       tions,  that don't take an argument, can be combined into a single com‐
20       mand, e.g.  -fv is equivalent to -f -v.  Long named options can be  ab‐
21       breviated to any unique prefix of their name.
22
23       -f, --force
24              This  will  override some sensible defaults, such as not using a
25              mounted volume.  Use this option with caution.
26
27       -h, --help
28              Show a list of options with a brief description of each one.
29
30       -l     Display licensing information.
31
32       -n, --no-action
33              Simulate the truncation without actually write to device.
34
35       -q, --quiet
36              Suppress some debug/warning/error messages.
37
38       -v, --verbose
39              Display more debug/warning/error messages.
40
41       -V, --version
42              Show the version number, copyright and license of ntfstruncate.
43
44       attr-type
45              Define a particular attribute type to be truncated (advanced use
46              only).  By default, the unnamed $DATA attribute (the contents of
47              a plain file) will be truncated. The attribute has to be  speci‐
48              fied by a number in decimal or hexadecimal :
49
50              ┌───────────────────────────────────────────┐
51              │Hex     Decimal   Name                     │
52              │0x10    16        "$STANDARD_INFORMATION"  │
53              │0x20    32        "$ATTRIBUTE_LIST"        │
54              │0x30    48        "$FILE_NAME"             │
55              │0x40    64        "$OBJECT_ID"             │
56              │0x50    80        "$SECURITY_DESCRIPTOR"   │
57              │0x60    96        "$VOLUME_NAME"           │
58              │0x70    112       "$VOLUME_INFORMATION"    │
59              │0x80    128       "$DATA"                  │
60              │0x90    144       "$INDEX_ROOT"            │
61              │0xA0    160       "$INDEX_ALLOCATION"      │
62              │0xB0    176       "$BITMAP"                │
63              │0xC0    192       "$REPARSE_POINT"         │
64              │0xD0    208       "$EA_INFORMATION"        │
65              │0xE0    224       "$EA"                    │
66              │0xF0    240       "$PROPERTY_SET"          │
67              │0x100   256       "$LOGGED_UTILITY_STREAM" │
68              └───────────────────────────────────────────┘
69
70       attr-name
71              Define the name of the particular attribute type to be truncated
72              (advanced use only).
73
74
75       new-length
76              Specify the target size of the file.  It will be rounded up to a
77              multiple  of  the  cluster size.  A suffix of K, M, G, T, P or E
78              may be appended to mean a multiplicative factor of  a  power  of
79              1000.  Similarly a suffix of Ki, Mi, Gi, Ti, Pi or Ei may be ap‐
80              pended to mean a multiplicative factor of a power of 1024.
81

EXAMPLES

83       Resize to 100MB the file database.db  located  in  the  Data  directory
84       which is at the root of an NTFS file system.
85
86              ntfstruncate /dev/sda1 Data/database.db 100M
87
88

BUGS

90       There  are  no  known  problems  with ntfstruncate.  If you find a bug,
91       please send an email describing the problem to the development team:
92       ntfs-3g-devel@lists.sf.net
93

AUTHORS

95       ntfstruncate was written by Anton Altaparmakov.
96

AVAILABILITY

98       ntfstruncate is part of the ntfs-3g package and is available from:
99       http://www.tuxera.com/community/
100