− display/change the label on an ntfs file system
[options] device [new−label]
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.
This will override some
sensible defaults, such as not working with a mounted
volume. Use this option with caution.
Show a list of options with a
brief description of each one.
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.
−−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.
Don’t actually write to
Reduce the amount of output to
Increase the amount of output
that ntfslabel prints. The label and the serial
number are displayed.
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
was written by Matthew J. Fanto, with contributions from
Anton Altaparmakov and Richard Russon. It was ported to
ntfs-3g by Erik Larsson.
is part of the ntfs-3g package and is available from: