184 lines
4.7 KiB
HTML
184 lines
4.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of NTFSLABEL</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>NTFSLABEL</H1>
|
|
Section: Maintenance Commands (8)<BR>Updated: January 2012<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
ntfslabel - display/change the label on an ntfs file system
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ntfslabel</B>
|
|
|
|
[<I>options</I>] <I>device </I>[<I>new-label</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>ntfslabel</B>
|
|
|
|
will display or change the file system label on the ntfs file system located on
|
|
<I>device</I>.
|
|
|
|
It can also change the serial number of the
|
|
<I>device</I>.
|
|
|
|
<P>
|
|
|
|
If the optional argument
|
|
<I>new-label</I>
|
|
|
|
is not present, and no option is present,
|
|
<B>ntfslabel</B>
|
|
|
|
will simply display the current file system label.
|
|
<P>
|
|
|
|
If the optional argument
|
|
<I>new-label</I>
|
|
|
|
is present, then
|
|
<B>ntfslabel</B>
|
|
|
|
will set the file system label to be
|
|
<I>new-label</I>.
|
|
|
|
NTFS file system labels can be at most 128 Unicode characters long; if
|
|
<I>new-label</I>
|
|
|
|
is longer than 128 Unicode characters,
|
|
<B>ntfslabel</B>
|
|
|
|
will truncate it and print a warning message.
|
|
<P>
|
|
|
|
It is also possible to set the file system label using the
|
|
<B>-L</B>
|
|
|
|
option of
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mkntfs">mkntfs</A></B>(8)
|
|
|
|
during creation of the file system.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
Below is a summary of all the options that
|
|
<B>ntfslabel</B>
|
|
|
|
accepts. Nearly all options have two equivalent names. The short name is
|
|
preceded by
|
|
<B>-</B>
|
|
|
|
and the long name is preceded by
|
|
<B>--</B>.
|
|
|
|
Any single letter options, that don't take an argument, can be combined into a
|
|
single command, e.g.
|
|
<B>-fv</B>
|
|
|
|
is equivalent to
|
|
<B>-f -v</B>.
|
|
|
|
Long named options can be abbreviated to any unique prefix of their name.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-f</B>, <B>--force</B><DD>
|
|
This will override some sensible defaults, such as not working with a mounted
|
|
volume. Use this option with caution.
|
|
<DT id="2"><B>-h</B>, <B>--help</B><DD>
|
|
Show a list of options with a brief description of each one.
|
|
<DT id="3"><B>--new-serial</B>[<I>=ssssssssssssssss</I>], or<DD>
|
|
<DT id="4"><B>--new-half-serial</B>[<I>=ssssssss</I>]<DD>
|
|
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.
|
|
<P>
|
|
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.
|
|
<P>
|
|
<DT id="5"><B>-n</B>, <B>--no-action</B><DD>
|
|
Don't actually write to disk.
|
|
<DT id="6"><B>-q</B>, <B>--quiet</B><DD>
|
|
Reduce the amount of output to a minimum.
|
|
<DT id="7"><B>-v</B>, <B>--verbose</B><DD>
|
|
Increase the amount of output that
|
|
<B>ntfslabel</B>
|
|
|
|
prints. The label and the serial number are displayed.
|
|
<DT id="8"><B>-V</B>, <B>--version</B><DD>
|
|
Show the version number, copyright and license for
|
|
<B>ntfslabel</B>.
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
There are no known problems with
|
|
<B>ntfslabel</B>.
|
|
|
|
If you find a bug please send an email describing the problem to the
|
|
development team:
|
|
<BR>
|
|
|
|
|
|
<A HREF="mailto:ntfs-3g-devel@lists.sf.net">ntfs-3g-devel@lists.sf.net</A>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
<B>ntfslabel</B>
|
|
|
|
was written by Matthew J. Fanto, with contributions from Anton Altaparmakov and
|
|
Richard Russon.
|
|
It was ported to ntfs-3g by Erik Larsson.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AVAILABILITY</H2>
|
|
|
|
<B>ntfslabel</B>
|
|
|
|
is part of the
|
|
<B>ntfs-3g</B>
|
|
|
|
package and is available from:
|
|
<BR>
|
|
|
|
|
|
<A HREF="http://www.tuxera.com/community/">http://www.tuxera.com/community/</A>
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mkntfs">mkntfs</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+ntfsprogs">ntfsprogs</A></B>(8)
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="13"><A HREF="#lbAF">BUGS</A><DD>
|
|
<DT id="14"><A HREF="#lbAG">AUTHORS</A><DD>
|
|
<DT id="15"><A HREF="#lbAH">AVAILABILITY</A><DD>
|
|
<DT id="16"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:14 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|