NTFSLABEL(8) System Manager's Manual NTFSLABEL(8)
NAME
ntfslabel - display/change the label on an ntfs file system
SYNOPSIS
ntfslabel [options] device [new-label]
DESCRIPTION
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 mes-
sage.
It is also possible to set the file system label using the -L option of
mkntfs(8) during creation of the file system.
OPTIONS
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.
BUGS
There are no known problems with ntfslabel. If you find a bug please
send an email describing the problem to the development team:
ntfs-3g-devel@lists.sf.net
AUTHORS
ntfslabel was written by Matthew J. Fanto, with contributions from Anton
Altaparmakov and Richard Russon. It was ported to ntfs-3g by Erik Lars-
son.
AVAILABILITY
ntfslabel is part of the ntfs-3g package and is available from:
https://github.com/tuxera/ntfs-3g/wiki/
SEE ALSO
mkntfs(8), ntfsprogs(8)
ntfs-3g 2022.10.3 January 2012 NTFSLABEL(8)
Generated by dwww version 1.16 on Sat Oct 3 09:31:46 CEST 2026.