1.\" 2.\" Copyright (c) 1993,1994 Christopher G. Demetriou 3.\" Copyright (c) 1999 Semen Ustimenko 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgment: 16.\" This product includes software developed by Christopher G. Demetriou. 17.\" 3. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.\" $FreeBSD: src/sbin/mount_ntfs/mount_ntfs.8,v 1.6.2.9 2003/02/24 00:56:42 trhodes Exp $ 32.\" 33.Dd December 2, 2012 34.Dt MOUNT_NTFS 8 35.Os 36.Sh NAME 37.Nm mount_ntfs 38.Nd mount an NTFS file system 39.Sh SYNOPSIS 40.Nm 41.Op Fl a 42.Op Fl i 43.Op Fl u Ar uid 44.Op Fl g Ar gid 45.Op Fl m Ar mask 46.Op Fl C Ar charset 47.Pa special 48.Pa node 49.Sh DESCRIPTION 50The 51.Nm 52utility attaches the NTFS file system residing on the device 53.Pa special 54to the global file system namespace at the location 55indicated by 56.Pa node . 57This command is normally executed by 58.Xr mount 8 59at boot time, but can be used by any user to mount an 60NTFS file system on any directory that they own (provided, 61of course, that they have appropriate access to the device that 62contains the file system). 63.Pp 64The options are as follows: 65.Bl -tag -width Ds 66.It Fl a 67Force behaviour to return MS-DOS 8.3 names also on 68.Fn readdir . 69.It Fl i 70Make name lookup case insensitive for all names except POSIX names. 71.It Fl u Ar uid 72Set the owner of the files in the file system to 73.Ar uid . 74The default owner is the owner of the directory 75on which the file system is being mounted. 76.It Fl g Ar gid 77Set the group of the files in the file system to 78.Ar gid . 79The default group is the group of the directory 80on which the file system is being mounted. 81.It Fl m Ar mask 82Specify the maximum file permissions for files 83in the file system. 84.It Fl C Ar charset 85Specify local 86.Ar charset 87to convert Unicode file names. 88Currently only reading is supported, thus the file system is to be 89mounted read-only. 90.El 91.Sh FEATURES 92NTFS file attributes are accessed in following way: 93.Bd -literal -offset indent 94foo[[:ATTRTYPE]:ATTRNAME] 95.Ed 96.Pp 97.Sq ATTRTYPE 98is one of the identifiers listed in $AttrDef file of 99volume. 100Default is $DATA. 101.Sq ATTRNAME 102is an attribute name. 103Default is none. 104.Sh EXAMPLES 105To mount an ntfs volume located in 106.Pa /dev/ad1s1 : 107.Bd -literal -offset indent 108# mount_ntfs /dev/ad1s1 /mnt 109.Ed 110.Pp 111To get the volume name (in Unicode): 112.Bd -literal -offset indent 113# cat /mnt/\\$Volume:\\$VOLUME_NAME 114.Ed 115.Pp 116To read directory raw data: 117.Bd -literal -offset indent 118# cat /mnt/foodir:\\$INDEX_ROOT:\\$I30 119.Ed 120.Pp 121To mount a Japanese NTFS volume located in 122.Pa /dev/ad0s1 : 123.Pp 124.Dl "mount_ntfs -C eucJP /dev/ad0s1 /mnt" 125.Sh WRITING 126There is limited writing ability. 127Limitations: file must be nonresident 128and must not contain any sparces (uninitialized areas); compressed 129files are also not supported. 130.Sh SEE ALSO 131.Xr mount 2 , 132.Xr unmount 2 , 133.Xr fstab 5 , 134.Xr mount 8 , 135.Xr mount_msdos 8 136.Sh HISTORY 137The 138.Nm 139utility first appeared in 140.Fx 3.0 . 141.Sh AUTHORS 142The NTFS kernel implementation, 143.Nm 144utility, and manual were written by 145.An Semen Ustimenko Aq Mt semenu@FreeBSD.org . 146.Sh CAVEATS 147This utility is primarily used for read access to an NTFS volume. 148See the 149.Sx WRITING 150section for details about writing to an NTFS volume. 151