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

FreeBSD Manual Pages

  
 
  

home | help
MOUNT_NTFS(8)		  BSD System Manager's Manual		 MOUNT_NTFS(8)

NAME
     mount_ntfs	-- mount an NTFS file system

SYNOPSIS
     mount_ntfs	[-a] [-i] [-u user] [-g	group] [-m mask] [-C charset]
		[-W u2wtable] special node

DESCRIPTION
     The mount_ntfs utility attaches the NTFS file system residing on the de-
     vice special to the global	file system namespace at the location indi-
     cated by node.  This command is normally executed by mount(8) at boot
     time, but can be used by any user to mount	an NTFS	file system on any di-
     rectory that they own (provided, of course, that they have	appropriate
     access to the device that contains	the file system).

     The options are as	follows:

     -a	     Force behaviour to	return MS-DOS 8.3 names	also on	readdir().

     -i	     Make name lookup case insensitive for all names except POSIX
	     names.

     -u	user
	     Set the owner of the files	in the file system to user.  The de-
	     fault owner is the	owner of the directory on which	the file sys-
	     tem is being mounted.

     -g	group
	     Set the group of the files	in the file system to group.  The de-
	     fault group is the	group of the directory on which	the file sys-
	     tem is being mounted.

     -m	mask
	     Specify the maximum file permissions for files in the file	sys-
	     tem.  Only	the nine low-order bits	of mask	are used.

     -C	charset
	     Specify local charset to convert Unicode file names.  Currently
	     only reading is supported,	thus the file system is	to be mounted
	     read-only.

     -W	u2wtable
	     Specify UNIX to Unicode translation table.	 See mount_msdosfs(8)
	     for the description of this option.  This option is preserved for
	     backward compatibility purpose only, and will be removed in the
	     future.  Please do	not use	this option.

FEATURES
     NTFS file attributes are accessed in following way:

	   foo[[:ATTRTYPE]:ATTRNAME]

     `ATTRTYPE'	is one of the identifiers listed in $AttrDef file of volume.
     Default is	$DATA.	`ATTRNAME' is an attribute name.  Default is none.

EXAMPLES
     To	mount an NTFS volume located in	/dev/ad1s1:

	   mount_ntfs /dev/ad1s1 /mnt

     To	get the	volume name (in	Unicode):

	   cat /mnt/\$Volume:\$VOLUME_NAME

     To	read directory raw data:

	   cat /mnt/foodir:\$INDEX_ROOT:\$I30

     To	mount a	Japanese NTFS volume located in	/dev/ad0s1:

	   mount_ntfs -C eucJP /dev/ad0s1 /mnt

WRITING
     There is limited writing ability.	Limitations: file must be nonresident
     and must not contain any sparces (uninitialized areas); compressed	files
     are also not supported.  The file name must not contain multibyte charac-
     ters.

SEE ALSO
     mount(2), unmount(2), fstab(5), mount(8), mount_msdosfs(8)

CAVEATS
     This utility is primarily used for	read access to an NTFS volume.	See
     the WRITING section for details about writing to an NTFS volume.

     For a full	read-write NTFS	support	consider sysutils/fusefs-ntfs
     port/package.

HISTORY
     The mount_ntfs utility first appeared in FreeBSD 3.0.

     The Unicode conversion routine was	added by Ryuichiro Imura
     <imura@ryu16.org> in 2003.

AUTHORS
     The NTFS kernel implementation, mount_ntfs	utility, and manual were writ-
     ten by Semen Ustimenko <semenu@FreeBSD.org>.

BSD			       November	17, 2007			   BSD

NAME | SYNOPSIS | DESCRIPTION | FEATURES | EXAMPLES | WRITING | SEE ALSO | CAVEATS | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mount_ntfs&sektion=8&manpath=FreeBSD+8.2-RELEASE>

home | help