193 files changed, 80411 insertions, 44563 deletions
diff --git a/ntfsprogs/ntfslabel.8.in b/ntfsprogs/ntfslabel.8.in new file mode 100755 index 0000000..291ba53 --- a/dev/null +++ b/ntfsprogs/ntfslabel.8.in @@ -0,0 +1,118 @@ +.\" Copyright (c) 2002\-2004 Anton Altaparmakov. +.\" Copyright (c) 2005 Richard Russon. +.\" This file may be copied under the terms of the GNU Public License. +.\" +.TH NTFSLABEL 8 "November 2005" "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) |