Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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  de-
     vice.

     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  char-
     acters, ntfslabel will truncate it and print a warning message.

     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 ser-
	    ial number, keeping the lower part which  is  used	by  Windows  un-
	    changed.  In this case the optional argument is an eight-digit hexa-
	    decimal 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 Larsson.

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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ntfslabel&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help