GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NTFSFALLOCATE (8)

NAME

ntfsfallocate - preallocate space to a file on an NTFS volume

CONTENTS

Synopsis
Description
Options
Examples
Bugs
Authors
Availability
See Also

SYNOPSIS

ntfsfallocate [options] -l length device file [attr-type [attr-name]]

DESCRIPTION

ntfsfallocate preallocates space for any attribute of a file or directory, thus reserving space before actual contents is written. This is similar to fallocate(1).

OPTIONS

Below is a summary of all the options that ntfsfallocate 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, --length LENGTH
  This is a mandatory option to specify the number of bytes to preallocate. 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.
-n, --no-size-change
  Do not change the apparent size of the file. The space allocated beyond the apparent size is not zeroed, but subsequent writing beyond the apparent end of file will force zeroing the inner allocated space as it cannot be considered as a hole any more, and this may take significant time.
-N, --no-action
  Simulate the allocation without actually write to device.
-o, --offset OFFSET
  Specify the offset in the file where preallocation starts. By default, the preallocation is counted from the beginning of the file. Space already allocated in the area defined by offset and length is preserved.
-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 ntfsfallocate.
attr-type
  Define a particular attribute type to be preallocated (advanced use only). By default, the unnamed $DATA attribute (the contents of a plain file) will be preallocated. The attribute has to be specified by a number in decimal or hexadecimal :

HexDecimalName
0x1016"$STANDARD_INFORMATION"
0x2032"$ATTRIBUTE_LIST"
0x3048"$FILE_NAME"
0x4064"$OBJECT_ID"
0x5080"$SECURITY_DESCRIPTOR"
0x6096"$VOLUME_NAME"
0x70112"$VOLUME_INFORMATION"
0x80128"$DATA"
0x90144"$INDEX_ROOT"
0xA0160"$INDEX_ALLOCATION"
0xB0176"$BITMAP"
0xC0192"$REPARSE_POINT"
0xD0208"$EA_INFORMATION"
0xE0224"$EA"
0xF0240"$PROPERTY_SET"
0x100256"$LOGGED_UTILITY_STREAM"

attr-name
  Define the name of the particular attribute type to be preallocated (advanced use only).

EXAMPLES

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

ntfsfallocate -l 100M /dev/sda1 Data/database.db

BUGS

There are no known problems with ntfsfallocate, however it can lead to configurations not supported by Windows and Windows may crash (BSOD) when writing to preallocated clusters which were not written to earlier. Files with preallocated space should be fully be written to before they are updated by Windows.

If you find a bug in ntfsfallocate proper, please send an email describing the problem to the development team:
ntfs-3g-devel@lists.sf.net

AUTHORS

ntfsfallocate was written by Jean-Pierre Andre.

AVAILABILITY

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

SEE ALSO

ntfs-3g(8), ntfstruncate(8), ntfsprogs(8), fallocate(1)
Search for    or go to Top of page |  Section 8 |  Main Index


ntfs-3g 2015.3.14 NTFSFALLOCATE (8) June 2014

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.