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

FreeBSD Manual Pages

  
 
  

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
       device.

       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 characters, ntfslabel will truncate it and print	a warning mes-
       sage.

       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  num-
	      ber is a 64 bit number, represented as a sixteen-digit hexadeci-
	      mal  number,  used  to  identify	the device during the mounting
	      process. As a consequence, two devices with the same serial num-
	      ber 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.

       -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  An-
       ton  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+14.3.quarterly>

home | help