{
    "mode": "man",
    "parameter": "NTFSCP",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/NTFSCP/8/json",
    "generated": "2026-10-06T11:02:37Z",
    "synopsis": "ntfscp [options] device sourcefile destination",
    "sections": {
        "NAME": {
            "content": "ntfscp - copy file to an NTFS volume.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "ntfscp [options] device sourcefile destination\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "ntfscp will copy file to an NTFS volume. destination can be either file or directory. In case\nif destination is directory specified by name then sourcefile is copied into this directory,\nin case if destination is directory and specified by inode number then unnamed data attribute\nis  created  for  this inode and sourcefile is copied into it (WARNING: it's unusual to have\nunnamed data streams in the directories, think twice before  specifying  directory  by  inode\nnumber).\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "Below  is  a  summary  of  all  the options that ntfscp accepts.  Nearly all options have two\nequivalent names.  The short name is preceded by - and the long name is preceded by --.   Any\nsingle  letter  options,  that don't take an argument, can be combined into a single command,\ne.g.  -fv is equivalent to -f -v.  Long named options can be abbreviated to any unique prefix\nof their name.\n",
            "subsections": [
                {
                    "name": "-a --attribute",
                    "content": "Write to this attribute.\n",
                    "flag": "-a",
                    "long": "--attribute"
                },
                {
                    "name": "-i --inode",
                    "content": "Treat destination as inode number.\n",
                    "flag": "-i",
                    "long": "--inode"
                },
                {
                    "name": "-m --min-fragments",
                    "content": "Minimize fragmentation when allocating space to the attribute. This is  mostly  useful\nwhen creating big files.\n",
                    "flag": "-m",
                    "long": "--min-fragments"
                },
                {
                    "name": "-N --attr-name",
                    "content": "Write to attribute with this name.\n",
                    "flag": "-N",
                    "long": "--attr-name"
                },
                {
                    "name": "-n --no-action",
                    "content": "Use  this option to make a test run before doing the real copy operation.  Volume will\nbe opened read-only and no write will be done.\n",
                    "flag": "-n",
                    "long": "--no-action"
                },
                {
                    "name": "-f --force",
                    "content": "This will override some sensible defaults, such as not working with a mounted  volume.\nUse this option with caution.\n",
                    "flag": "-f",
                    "long": "--force"
                },
                {
                    "name": "-h --help",
                    "content": "Show a list of options with a brief description of each one.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-q --quiet",
                    "content": "Suppress some debug/warning/error messages.\n",
                    "flag": "-q",
                    "long": "--quiet"
                },
                {
                    "name": "-t --timestamp",
                    "content": "Copy  the modification time of sourcefile to destination. This is not compatible with\n--attr-name and --attribute.\n",
                    "flag": "-t",
                    "long": "--timestamp"
                },
                {
                    "name": "-V --version",
                    "content": "Show the version number, copyright and license ntfscp.\n",
                    "flag": "-V",
                    "long": "--version"
                },
                {
                    "name": "-v --verbose",
                    "content": "Display more debug/warning/error messages.\n",
                    "flag": "-v",
                    "long": "--verbose"
                }
            ]
        },
        "DATA STREAMS": {
            "content": "All data on NTFS is stored in streams, which can have names. A file can have  more  than  one\ndata  streams,  but  exactly one must have no name. The size of a file is the size of its un‐\nnamed data stream. Usually when you don't specify stream name you are access to unnamed  data\nstream.  If  you want access to named data stream you need to add \":streamname\" to the file‐\nname. For example: by opening \"some.mp3:artist\" you will open stream \"artist\" in  \"some.mp3\".\nBut windows usually prevent you from accessing to named data streams, so you need to use some\nprogram like FAR or utils from cygwin to access named data streams.\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "Copy newboot.ini from /home/user as boot.ini to the root of an /dev/hda1 NTFS volume:\n\nntfscp /dev/hda1 /home/user/newboot.ini boot.ini\n\nCopy myfile to C:\\some\\path\\myfile:stream (assume that /dev/hda1 letter in windows is C):\n\nntfscp -N stream /dev/hda1 myfile /some/path\n\n",
            "subsections": []
        },
        "BUGS": {
            "content": "There  are  no  known problems with ntfscp. If you find a bug please send an email describing\nthe problem to the development team:\nntfs-3g-devel@lists.sf.net\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "ntfscp was written by Yura Pakhuchiy, with contributions  from  Anton  Altaparmakov  and  Hil\nLiao.  It was ported to ntfs-3g by Erik Larsson.\n",
            "subsections": []
        },
        "DEDICATION": {
            "content": "With love to Marina Sapego.\n",
            "subsections": []
        },
        "AVAILABILITY": {
            "content": "ntfscp is part of the ntfs-3g package and is available from:\nhttps://github.com/tuxera/ntfs-3g\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "ntfsprogs(8)\n\nntfs-3g 2022.10.3                          September 2007                                  NTFSCP(8)",
            "subsections": []
        }
    },
    "summary": "ntfscp - copy file to an NTFS volume.",
    "flags": [
        {
            "flag": "-a",
            "long": "--attribute",
            "arg": null,
            "description": "Write to this attribute."
        },
        {
            "flag": "-i",
            "long": "--inode",
            "arg": null,
            "description": "Treat destination as inode number."
        },
        {
            "flag": "-m",
            "long": "--min-fragments",
            "arg": null,
            "description": "Minimize fragmentation when allocating space to the attribute. This is mostly useful when creating big files."
        },
        {
            "flag": "-N",
            "long": "--attr-name",
            "arg": null,
            "description": "Write to attribute with this name."
        },
        {
            "flag": "-n",
            "long": "--no-action",
            "arg": null,
            "description": "Use this option to make a test run before doing the real copy operation. Volume will be opened read-only and no write will be done."
        },
        {
            "flag": "-f",
            "long": "--force",
            "arg": null,
            "description": "This will override some sensible defaults, such as not working with 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": "-q",
            "long": "--quiet",
            "arg": null,
            "description": "Suppress some debug/warning/error messages."
        },
        {
            "flag": "-t",
            "long": "--timestamp",
            "arg": null,
            "description": "Copy the modification time of sourcefile to destination. This is not compatible with --attr-name and --attribute."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "Show the version number, copyright and license ntfscp."
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": null,
            "description": "Display more debug/warning/error messages."
        }
    ],
    "examples": [
        "Copy newboot.ini from /home/user as boot.ini to the root of an /dev/hda1 NTFS volume:",
        "ntfscp /dev/hda1 /home/user/newboot.ini boot.ini",
        "Copy myfile to C:\\some\\path\\myfile:stream (assume that /dev/hda1 letter in windows is C):",
        "ntfscp -N stream /dev/hda1 myfile /some/path"
    ],
    "see_also": [
        {
            "name": "ntfsprogs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/ntfsprogs/8/json"
        }
    ]
}