{
    "content": [
        {
            "type": "text",
            "text": "# ntfslabel(8) (man)\n\n**Summary:** ntfslabel - display/change the label on an ntfs file system\n\n**Synopsis:** ntfslabel [options] device [new-label]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -f | --force | — | This will override some sensible defaults, such as not working with a mounted volume. Use this option with caution. |\n| -h | --help | — | Show a list of options with a brief description of each one. --new-serial[=ssssssssssssssss], or --new-half-serial[=ssss |\n| -n | --no-action | — | Don't actually write to disk. |\n| -q | --quiet | — | Reduce the amount of output to a minimum. |\n| -v | --verbose | — | Increase the amount of output that ntfslabel prints. The label and the serial number are displayed. |\n| -V | --version | — | Show the version number, copyright and license for ntfslabel. |\n\n## See Also\n\n- mkntfs(8)\n- ntfsprogs(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (14 lines)\n- **OPTIONS** (6 lines) — 6 subsections\n  - -f --force (3 lines)\n  - -h --help (17 lines)\n  - -n --no-action (2 lines)\n  - -q --quiet (2 lines)\n  - -v --verbose (3 lines)\n  - -V --version (2 lines)\n- **BUGS** (4 lines)\n- **AUTHORS** (3 lines)\n- **AVAILABILITY** (3 lines)\n- **SEE ALSO** (5 lines)\n\n## Full Content\n\n### NAME\n\nntfslabel - display/change the label on an ntfs file system\n\n### SYNOPSIS\n\nntfslabel [options] device [new-label]\n\n### DESCRIPTION\n\nntfslabel will display or change the file system label on the ntfs file system located on de‐\nvice.  It can also change the serial number of the device.\n\nIf the optional argument new-label is not present, and no option is present,  ntfslabel  will\nsimply display the current file system label.\n\nIf  the optional argument new-label is present, then ntfslabel will set the file system label\nto be new-label.  NTFS file system labels can be at most  128  Unicode  characters  long;  if\nnew-label is longer than 128 Unicode characters, ntfslabel will truncate it and print a warn‐\ning message.\n\nIt is also possible to set the file system label using the -L option of mkntfs(8) during cre‐\nation of the file system.\n\n### OPTIONS\n\nBelow  is  a  summary of all the options that ntfslabel 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\n#### -f --force\n\nThis  will override some sensible defaults, such as not working with a mounted volume.\nUse this option with caution.\n\n#### -h --help\n\nShow a list of options with a brief description of each one.\n\n--new-serial[=ssssssssssssssss], or\n\n--new-half-serial[=ssssssss]\nSet a new serial number to the device, either the argument value, or a random  one  if\nno  argument is given. The serial number is a 64 bit number, represented as a sixteen-\ndigit hexadecimal number, used to identify the device during the mounting process.  As\na  consequence,  two devices with the same serial number cannot be mounted at the same\ntime on the same computer.  This is not the volume UUID  used  by  Windows  to  locate\nfiles which have been moved to another volume.\n\nThe option --new-half-serial only changes the upper part of the serial number, keeping\nthe lower part which is used by Windows unchanged.  In this case the optional argument\nis an eight-digit hexadecimal number.\n\n#### -n --no-action\n\nDon't actually write to disk.\n\n#### -q --quiet\n\nReduce the amount of output to a minimum.\n\n#### -v --verbose\n\nIncrease  the  amount of output that ntfslabel prints. The label and the serial number\nare displayed.\n\n#### -V --version\n\nShow the version number, copyright and license for ntfslabel.\n\n### BUGS\n\nThere are no known problems with ntfslabel.  If you find a bug please send an email  describ‐\ning the problem to the development team:\nntfs-3g-devel@lists.sf.net\n\n### AUTHORS\n\nntfslabel  was  written  by  Matthew J. Fanto, with contributions from Anton Altaparmakov and\nRichard Russon.  It was ported to ntfs-3g by Erik Larsson.\n\n### AVAILABILITY\n\nntfslabel is part of the ntfs-3g package and is available from:\nhttps://github.com/tuxera/ntfs-3g/wiki/\n\n### SEE ALSO\n\nmkntfs(8), ntfsprogs(8)\n\n\n\nntfs-3g 2021.8.22                           January 2012                                NTFSLABEL(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "ntfslabel",
        "section": "8",
        "mode": "man",
        "summary": "ntfslabel - display/change the label on an ntfs file system",
        "synopsis": "ntfslabel [options] device [new-label]",
        "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 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. --new-serial[=ssssssssssssssss], or --new-half-serial[=ssssssss] Set a new serial number to the device, either the argument value, or a random one if no argument is given. The serial number is a 64 bit number, represented as a sixteen- digit hexadecimal number, used to identify the device during the mounting process. As a consequence, two devices with the same serial number cannot be mounted at the same time on the same computer. This is not the volume UUID used by Windows to locate files which have been moved to another volume. The option --new-half-serial only changes the upper part of the serial number, keeping the lower part which is used by Windows unchanged. In this case the optional argument is an eight-digit hexadecimal number."
            },
            {
                "flag": "-n",
                "long": "--no-action",
                "arg": null,
                "description": "Don't actually write to disk."
            },
            {
                "flag": "-q",
                "long": "--quiet",
                "arg": null,
                "description": "Reduce the amount of output to a minimum."
            },
            {
                "flag": "-v",
                "long": "--verbose",
                "arg": null,
                "description": "Increase the amount of output that ntfslabel prints. The label and the serial number are displayed."
            },
            {
                "flag": "-V",
                "long": "--version",
                "arg": null,
                "description": "Show the version number, copyright and license for ntfslabel."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "mkntfs",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/mkntfs/8/json"
            },
            {
                "name": "ntfsprogs",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/ntfsprogs/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 14,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 6,
                "subsections": [
                    {
                        "name": "-f --force",
                        "lines": 3,
                        "flag": "-f",
                        "long": "--force"
                    },
                    {
                        "name": "-h --help",
                        "lines": 17,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "-n --no-action",
                        "lines": 2,
                        "flag": "-n",
                        "long": "--no-action"
                    },
                    {
                        "name": "-q --quiet",
                        "lines": 2,
                        "flag": "-q",
                        "long": "--quiet"
                    },
                    {
                        "name": "-v --verbose",
                        "lines": 3,
                        "flag": "-v",
                        "long": "--verbose"
                    },
                    {
                        "name": "-V --version",
                        "lines": 2,
                        "flag": "-V",
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "BUGS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "AUTHORS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "AVAILABILITY",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}