NAME    [Toc]    [Back]

     mount_ntfs -- mount an NTFS file system

SYNOPSIS    [Toc]    [Back]

     mount_ntfs [-a] [-i] [-u uid] [-g gid] [-m mask] [-C charset]
		[-W u2wtable] special node

DESCRIPTION    [Toc]    [Back]

     The mount_ntfs utility attaches the NTFS file system residing on the
     device special to the global file system namespace at the location indicated
 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
     directory 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 uid  Set the owner of the files in the file system to uid.  The
	     default owner is the owner of the directory on which the file
	     system is being mounted.

     -g gid  Set the group of the files in the file system to gid.  The
	     default group is the group of the directory on which the file
	     system is being mounted.

     -m mask
	     Specify the maximum file permissions for files in the file system.


     -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 remained for
	     backward compatibility purpose, so please do not use this option.
	     This option will be removed in the future.

FEATURES    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

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

CAVEATS    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

     The mount_ntfs utility first appeared in FreeBSD 3.0.

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

AUTHORS    [Toc]    [Back]

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


FreeBSD 5.2.1			January 3, 1999 		 FreeBSD 5.2.1