mirror of
https://git.code.sf.net/p/ntfs-3g/ntfs-3g.git
synced 2024-11-27 03:53:48 +08:00
120 lines
3.4 KiB
Groff
120 lines
3.4 KiB
Groff
.\" Copyright (c) 2002\-2004 Anton Altaparmakov.
|
|
.\" Copyright (c) 2005 Richard Russon.
|
|
.\" Copyright (c) 2012 Jean-Pierre Andre.
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
.\"
|
|
.TH NTFSLABEL 8 "January 2012" "ntfs-3g @VERSION@"
|
|
.SH NAME
|
|
ntfslabel \- display/change the label on an ntfs file system
|
|
.SH SYNOPSIS
|
|
.B ntfslabel
|
|
[\fIoptions\fR] \fIdevice \fR[\fInew\-label\fR]
|
|
.SH DESCRIPTION
|
|
.B ntfslabel
|
|
will display or change the file system label on the ntfs file system located on
|
|
.IR device .
|
|
It can also change the serial number of the
|
|
.IR device .
|
|
.PP
|
|
If the optional argument
|
|
.I new\-label
|
|
is not present, and no option is present,
|
|
.B ntfslabel
|
|
will simply display the current file system label.
|
|
.PP
|
|
If the optional argument
|
|
.I new\-label
|
|
is present, then
|
|
.B ntfslabel
|
|
will set the file system label to be
|
|
.IR new\-label .
|
|
NTFS file system labels can be at most 128 Unicode characters long; if
|
|
.I new\-label
|
|
is longer than 128 Unicode characters,
|
|
.B ntfslabel
|
|
will truncate it and print a warning message.
|
|
.PP
|
|
It is also possible to set the file system label using the
|
|
.B \-L
|
|
option of
|
|
.BR mkntfs (8)
|
|
during creation of the file system.
|
|
.SH OPTIONS
|
|
Below is a summary of all the options that
|
|
.B ntfslabel
|
|
accepts. Nearly all options have two equivalent names. The short name is
|
|
preceded by
|
|
.B \-
|
|
and the long name is preceded by
|
|
.BR \-\- .
|
|
Any single letter options, that don't take an argument, can be combined into a
|
|
single command, e.g.
|
|
.B \-fv
|
|
is equivalent to
|
|
.BR "\-f \-v" .
|
|
Long named options can be abbreviated to any unique prefix of their name.
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-force\fR
|
|
This will override some sensible defaults, such as not working with a mounted
|
|
volume. Use this option with caution.
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
Show a list of options with a brief description of each one.
|
|
.TP
|
|
\fB\-\-new\-serial\fR[\fI=ssssssssssssssss\fR], or
|
|
.TP
|
|
\fB\-\-new\-half\-serial\fR[\fI=ssssssss\fR]
|
|
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.
|
|
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-no\-action\fR
|
|
Don't actually write to disk.
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
Reduce the amount of output to a minimum.
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
Increase the amount of output that
|
|
.B ntfslabel
|
|
prints. The label and the serial number are displayed.
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
Show the version number, copyright and license for
|
|
.BR ntfslabel .
|
|
.SH BUGS
|
|
There are no known problems with
|
|
.BR ntfslabel .
|
|
If you find a bug please send an email describing the problem to the
|
|
development team:
|
|
.br
|
|
.nh
|
|
ntfs\-3g\-devel@lists.sf.net
|
|
.hy
|
|
.SH AUTHORS
|
|
.B ntfslabel
|
|
was written by Matthew J. Fanto, with contributions from Anton Altaparmakov and
|
|
Richard Russon.
|
|
It was ported to ntfs-3g by Erik Larsson.
|
|
.SH AVAILABILITY
|
|
.B ntfslabel
|
|
is part of the
|
|
.B ntfs-3g
|
|
package and is available from:
|
|
.br
|
|
.nh
|
|
http://www.tuxera.com/community/
|
|
.hy
|
|
.SH SEE ALSO
|
|
.BR mkntfs (8),
|
|
.BR ntfsprogs (8)
|