ntfslabel - display/change the label on an ntfs file system
ntfslabel [
options]
device [
new-label]
ntfslabel will display or change the file system label on the ntfs file
system located on
device. It can also change the serial number of the
device.
If the optional argument
new-label is not present, and no option is
present,
ntfslabel will simply display the current file system label.
If the optional argument
new-label is present, then
ntfslabel will
set the file system label to be
new-label. NTFS file system labels can
be at most 128 Unicode characters long; if
new-label is longer than 128
Unicode characters,
ntfslabel will truncate it and print a warning
message.
It is also possible to set the file system label using the
-L option of
mkntfs(8) during creation of the file system.
Below is a summary of all the options that
ntfslabel 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
working with a mounted volume. Use this option with caution.
-
-h, --help
- 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.
-
-n, --no-action
- Don't actually write to disk.
-
-q, --quiet
- Reduce the amount of output to a minimum.
-
-v, --verbose
- Increase the amount of output that ntfslabel prints.
The label and the serial number are displayed.
-
-V, --version
- Show the version number, copyright and license for
ntfslabel.
There are no known problems with
ntfslabel. If you find a bug please send
an email describing the problem to the development team:
[email protected]
ntfslabel was written by Matthew J. Fanto, with contributions from Anton
Altaparmakov and Richard Russon. It was ported to ntfs-3g by Erik Larsson.
ntfslabel is part of the
ntfs-3g package and is available from:
https://github.com/tuxera/ntfs-3g/wiki/
mkntfs(8),
ntfsprogs(8)