ntfslabel(8)

1NTFSLABEL(8)                System Manager's Manual               NTFSLABEL(8)
2
3
4

NAME

6       ntfslabel - display/change the label on an ntfs file system
7

SYNOPSIS

9       ntfslabel [options] device [new-label]
10

DESCRIPTION

12       ntfslabel will display or change the file system label on the ntfs file
13       system located on device.  It can also change the serial number of  the
14       device.
15
16       If  the  optional  argument  new-label is not present, and no option is
17       present, ntfslabel will simply display the current file system label.
18
19       If the optional argument new-label is present, then ntfslabel will  set
20       the  file system label to be new-label.  NTFS file system labels can be
21       at most 128 Unicode characters long; if new-label is  longer  than  128
22       Unicode characters, ntfslabel will truncate it and print a warning mes‐
23       sage.
24
25       It is also possible to set the file system label using the -L option of
26       mkntfs(8) during creation of the file system.
27

OPTIONS

29       Below  is  a summary of all the options that ntfslabel accepts.  Nearly
30       all options have two equivalent names.  The short name is preceded by -
31       and  the  long name is preceded by --.  Any single letter options, that
32       don't take an argument, can be combined into  a  single  command,  e.g.
33       -fv  is  equivalent to -f -v.  Long named options can be abbreviated to
34       any unique prefix of their name.
35
36       -f, --force
37              This will override some sensible defaults, such as  not  working
38              with a mounted volume.  Use this option with caution.
39
40       -h, --help
41              Show a list of options with a brief description of each one.
42
43       --new-serial[=ssssssssssssssss], or
44
45       --new-half-serial[=ssssssss]
46              Set  a  new  serial  number  to  the device, either the argument
47              value, or a random one if no argument is given. The serial  num‐
48              ber is a 64 bit number, represented as a sixteen-digit hexadeci‐
49              mal number, used to identify  the  device  during  the  mounting
50              process. As a consequence, two devices with the same serial num‐
51              ber cannot be mounted at the same time  on  the  same  computer.
52              This  is  not  the  volume  UUID used by Windows to locate files
53              which have been moved to another volume.
54
55              The option --new-half-serial only changes the upper part of  the
56              serial  number,  keeping the lower part which is used by Windows
57              unchanged.  In this case the optional argument is an eight-digit
58              hexadecimal number.
59
60
61       -n, --no-action
62              Don't actually write to disk.
63
64       -q, --quiet
65              Reduce the amount of output to a minimum.
66
67       -v, --verbose
68              Increase  the  amount of output that ntfslabel prints. The label
69              and the serial number are displayed.
70
71       -V, --version
72              Show the version number, copyright and license for ntfslabel.
73

BUGS

75       There are no known problems with ntfslabel.  If you find a  bug  please
76       send an email describing the problem to the development team:
77       ntfs-3g-devel@lists.sf.net
78

AUTHORS

80       ntfslabel  was written by Matthew J. Fanto, with contributions from An‐
81       ton Altaparmakov and Richard Russon.  It was ported to ntfs-3g by  Erik
82       Larsson.
83

AVAILABILITY

85       ntfslabel is part of the ntfs-3g package and is available from:
86       https://github.com/tuxera/ntfs-3g/wiki/
87