{
    "content": [
        {
            "type": "text",
            "text": "# ntfsfallocate(8) (man)\n\n**Summary:** ntfsfallocate - preallocate space to a file on an NTFS volume\n\n**Synopsis:** ntfsfallocate [options] -l length device file [attr-type [attr-name]]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -f | --force | — | This will override some sensible defaults, such as not using a mounted volume. Use this option with caution. |\n| -h | --help | — | Show a list of options with a brief description of each one. |\n| -l | --length | — | This is a mandatory option to specify the number of bytes to preallocate. It will be rounded up to a multiple of the clu |\n| -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  |\n| -N | --no-action | — | Simulate the allocation without actually write to device. |\n| -o | --offset | — | Specify the offset in the file where preallocation starts. By default, the prealloca‐ tion is counted from the beginning |\n| -q | --quiet | — | Suppress some debug/warning/error messages. |\n| -v | --verbose | — | Display more debug/warning/error messages. |\n| -V | --version | — | Show the version number, copyright and license of ntfsfallocate. |\n\n## Examples\n\n- `Preallocate  100MB to the file database.db located in the Data directory which is at the root`\n- `of an NTFS file system.`\n- `ntfsfallocate -l 100M /dev/sda1 Data/database.db`\n\n## See Also\n\n- ntfs-3g(8)\n- ntfstruncate(8)\n- ntfsprogs(8)\n- fallocate(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (3 lines)\n- **OPTIONS** (6 lines) — 11 subsections\n  - -f --force (3 lines)\n  - -h --help (2 lines)\n  - -l --length (6 lines)\n  - -n --no-size-change (5 lines)\n  - -N --no-action (2 lines)\n  - -o --offset (4 lines)\n  - -q --quiet (2 lines)\n  - -v --verbose (2 lines)\n  - -V --version (2 lines)\n  - attr-type (24 lines)\n  - attr-name (3 lines)\n- **EXAMPLES** (6 lines)\n- **BUGS** (9 lines)\n- **AUTHORS** (2 lines)\n- **AVAILABILITY** (3 lines)\n- **SEE ALSO** (5 lines)\n\n## Full Content\n\n### NAME\n\nntfsfallocate - preallocate space to a file on an NTFS volume\n\n### SYNOPSIS\n\nntfsfallocate [options] -l length device file [attr-type [attr-name]]\n\n### DESCRIPTION\n\nntfsfallocate  preallocates  space  for  any attribute of a file or directory, thus reserving\nspace before actual contents is written. This is similar to fallocate(1).\n\n### OPTIONS\n\nBelow is a summary of all the options that ntfsfallocate accepts.  Nearly  all  options  have\ntwo  equivalent  names.  The short name is preceded by - and the long name is preceded by --.\nAny single letter options, that don't take an argument, can be combined into  a  single  com‐\nmand,  e.g.  -fv is equivalent to -f -v.  Long named options can be abbreviated to any unique\nprefix of their name.\n\n#### -f --force\n\nThis will override some sensible defaults, such as not using a  mounted  volume.   Use\nthis option with caution.\n\n#### -h --help\n\nShow a list of options with a brief description of each one.\n\n#### -l --length\n\nThis  is a mandatory option to specify the number of bytes to preallocate.  It will be\nrounded up to a multiple of the cluster size.  A suffix of K, M, G, T, P or E  may  be\nappended to mean a multiplicative factor of a power of 1000. Similarly a suffix of Ki,\nMi, Gi, Ti, Pi or Ei may be appended to mean a multiplicative factor  of  a  power  of\n1024.\n\n#### -n --no-size-change\n\nDo  not  change the apparent size of the file. The space allocated beyond the apparent\nsize is not zeroed, but subsequent writing beyond the apparent end of file will  force\nzeroing  the  inner allocated space as it cannot be considered as a hole any more, and\nthis may take significant time.\n\n#### -N --no-action\n\nSimulate the allocation without actually write to device.\n\n#### -o --offset\n\nSpecify the offset in the file where preallocation starts. By default, the  prealloca‐\ntion  is  counted  from the beginning of the file. Space already allocated in the area\ndefined by offset and length is preserved.\n\n#### -q --quiet\n\nSuppress some debug/warning/error messages.\n\n#### -v --verbose\n\nDisplay more debug/warning/error messages.\n\n#### -V --version\n\nShow the version number, copyright and license of ntfsfallocate.\n\n#### attr-type\n\nDefine a particular attribute type to be preallocated (advanced  use  only).   By  de‐\nfault,  the  unnamed  $DATA  attribute (the contents of a plain file) will be preallo‐\ncated. The attribute has to be specified by a number in decimal or hexadecimal :\n\n┌───────────────────────────────────────────┐\n│Hex     Decimal   Name                     │\n│0x10    16        \"$STANDARDINFORMATION\"  │\n│0x20    32        \"$ATTRIBUTELIST\"        │\n│0x30    48        \"$FILENAME\"             │\n│0x40    64        \"$OBJECTID\"             │\n│0x50    80        \"$SECURITYDESCRIPTOR\"   │\n│0x60    96        \"$VOLUMENAME\"           │\n│0x70    112       \"$VOLUMEINFORMATION\"    │\n│0x80    128       \"$DATA\"                  │\n│0x90    144       \"$INDEXROOT\"            │\n│0xA0    160       \"$INDEXALLOCATION\"      │\n│0xB0    176       \"$BITMAP\"                │\n│0xC0    192       \"$REPARSEPOINT\"         │\n│0xD0    208       \"$EAINFORMATION\"        │\n│0xE0    224       \"$EA\"                    │\n│0xF0    240       \"$PROPERTYSET\"          │\n│0x100   256       \"$LOGGEDUTILITYSTREAM\" │\n└───────────────────────────────────────────┘\n\n#### attr-name\n\nDefine the name of the particular attribute type  to  be  preallocated  (advanced  use\nonly).\n\n### EXAMPLES\n\nPreallocate  100MB to the file database.db located in the Data directory which is at the root\nof an NTFS file system.\n\nntfsfallocate -l 100M /dev/sda1 Data/database.db\n\n### BUGS\n\nThere are no known problems with ntfsfallocate, however it can  lead  to  configurations  not\nsupported by Windows and Windows may crash (BSOD) when writing to preallocated clusters which\nwere not written to earlier. Files with preallocated space should be fully be written to  be‐\nfore they are updated by Windows.\n\nIf you find a bug in ntfsfallocate proper, please send an email describing the problem to the\ndevelopment team:\nntfs-3g-devel@lists.sf.net\n\n### AUTHORS\n\nntfsfallocate was written by Jean-Pierre Andre.\n\n### AVAILABILITY\n\nntfsfallocate is part of the ntfs-3g package and is available from:\nhttps://github.com/tuxera/ntfs-3g/wiki/\n\n### SEE ALSO\n\nntfs-3g(8), ntfstruncate(8), ntfsprogs(8), fallocate(1)\n\n\n\nntfs-3g 2021.8.22                             June 2014                             NTFSFALLOCATE(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "ntfsfallocate",
        "section": "8",
        "mode": "man",
        "summary": "ntfsfallocate - preallocate space to a file on an NTFS volume",
        "synopsis": "ntfsfallocate [options] -l length device file [attr-type [attr-name]]",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-f",
                "long": "--force",
                "arg": null,
                "description": "This will override some sensible defaults, such as not using a mounted volume. Use this option with caution."
            },
            {
                "flag": "-h",
                "long": "--help",
                "arg": null,
                "description": "Show a list of options with a brief description of each one."
            },
            {
                "flag": "-l",
                "long": "--length",
                "arg": null,
                "description": "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."
            },
            {
                "flag": "-n",
                "long": "--no-size-change",
                "arg": null,
                "description": "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."
            },
            {
                "flag": "-N",
                "long": "--no-action",
                "arg": null,
                "description": "Simulate the allocation without actually write to device."
            },
            {
                "flag": "-o",
                "long": "--offset",
                "arg": null,
                "description": "Specify the offset in the file where preallocation starts. By default, the prealloca‐ tion is counted from the beginning of the file. Space already allocated in the area defined by offset and length is preserved."
            },
            {
                "flag": "-q",
                "long": "--quiet",
                "arg": null,
                "description": "Suppress some debug/warning/error messages."
            },
            {
                "flag": "-v",
                "long": "--verbose",
                "arg": null,
                "description": "Display more debug/warning/error messages."
            },
            {
                "flag": "-V",
                "long": "--version",
                "arg": null,
                "description": "Show the version number, copyright and license of ntfsfallocate."
            }
        ],
        "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"
        ],
        "see_also": [
            {
                "name": "ntfs-3g",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/ntfs-3g/8/json"
            },
            {
                "name": "ntfstruncate",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/ntfstruncate/8/json"
            },
            {
                "name": "ntfsprogs",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/ntfsprogs/8/json"
            },
            {
                "name": "fallocate",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/fallocate/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 6,
                "subsections": [
                    {
                        "name": "-f --force",
                        "lines": 3,
                        "flag": "-f",
                        "long": "--force"
                    },
                    {
                        "name": "-h --help",
                        "lines": 2,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "-l --length",
                        "lines": 6,
                        "flag": "-l",
                        "long": "--length"
                    },
                    {
                        "name": "-n --no-size-change",
                        "lines": 5,
                        "flag": "-n",
                        "long": "--no-size-change"
                    },
                    {
                        "name": "-N --no-action",
                        "lines": 2,
                        "flag": "-N",
                        "long": "--no-action"
                    },
                    {
                        "name": "-o --offset",
                        "lines": 4,
                        "flag": "-o",
                        "long": "--offset"
                    },
                    {
                        "name": "-q --quiet",
                        "lines": 2,
                        "flag": "-q",
                        "long": "--quiet"
                    },
                    {
                        "name": "-v --verbose",
                        "lines": 2,
                        "flag": "-v",
                        "long": "--verbose"
                    },
                    {
                        "name": "-V --version",
                        "lines": 2,
                        "flag": "-V",
                        "long": "--version"
                    },
                    {
                        "name": "attr-type",
                        "lines": 24
                    },
                    {
                        "name": "attr-name",
                        "lines": 3
                    }
                ]
            },
            {
                "name": "EXAMPLES",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "BUGS",
                "lines": 9,
                "subsections": []
            },
            {
                "name": "AUTHORS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AVAILABILITY",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}