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

NAME
     mount_ntfs -- mount an NTFS file system

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

DESCRIPTION
     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 be-
	     ing 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 be-
	     ing 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
     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.

HISTORY
     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
     The NTFS kernel implementation, mount_ntfs utility, and manual were written
     by Semen Ustimenko <semenu@FreeBSD.org>.

FreeBSD 5.2.1			 January 3, 1999		   MOUNT_NTFS(8)
home | help