1.\" $NetBSD: mount_msdos.8,v 1.13 1998/02/06 05:57:00 perry Exp $ 2.\" 3.\" Copyright (c) 1993,1994 Christopher G. Demetriou 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$ 32.\" 33.Dd October 3, 2016 34.Dt MOUNT_MSDOSFS 8 35.Os 36.Sh NAME 37.Nm mount_msdosfs 38.Nd mount an MS-DOS file system 39.Sh SYNOPSIS 40.Nm 41.Op Fl 9ls 42.Op Fl D Ar DOS_codepage 43.Op Fl g Ar gid 44.Op Fl L Ar locale 45.Op Fl M Ar mask 46.Op Fl m Ar mask 47.Op Fl o Ar options 48.Op Fl u Ar uid 49.Op Fl W Ar table 50.Ar special node 51.Sh DESCRIPTION 52The 53.Nm 54utility attaches the MS-DOS file system residing on 55the device 56.Pa special 57to the global file system namespace at the location 58indicated by 59.Pa node . 60This command is normally executed by 61.Xr mount 8 62at boot time, but can be used by any user to mount an 63MS-DOS file system on any directory that they own (provided, 64of course, that they have appropriate access to the device that 65contains the file system). 66.Pp 67The options are as follows: 68.Bl -tag -width Ds 69.It Fl o Ar options 70Use the specified mount 71.Ar options , 72as described in 73.Xr mount 8 . 74The following MSDOS file system-specific options are available: 75.Bl -tag -width indent 76.It Cm large 77Support file systems larger than 128 gigabytes at the expense 78of 32 bytes of kernel memory for each file on disk. 79This memory will not be reclaimed until the file system has 80been unmounted. 81.It Cm longnames 82Force Windows 95 long filenames to be visible. 83.It Cm shortnames 84Force only the old MS-DOS 8.3 style filenames to be visible. 85.It Cm nowin95 86Completely ignore Windows 95 extended file information. 87.El 88.It Fl u Ar uid 89Set the owner of the files in the file system to 90.Ar uid . 91The default owner is the owner of the directory 92on which the file system is being mounted. 93.It Fl g Ar gid 94Set the group of the files in the file system to 95.Ar gid . 96The default group is the group of the directory 97on which the file system is being mounted. 98.It Fl m Ar mask 99Specify the maximum file permissions for files 100in the file system. 101(For example, a 102.Ar mask 103of 104.Li 755 105specifies that, by default, the owner should have 106read, write, and execute permissions for files, but 107others should only have read and execute permissions. 108See 109.Xr chmod 1 110for more information about octal file modes. 111Only the nine low-order bits of 112.Ar mask 113are used. 114The value of 115.Ar -M 116is used if it is supplied and 117.Ar -m 118is omitted. 119The default 120.Ar mask 121is taken from the 122directory on which the file system is being mounted. 123.It Fl M Ar mask 124Specify the maximum file permissions for directories 125in the file system. 126The value of 127.Ar -m 128is used if it is supplied and 129.Ar -M 130is omitted. 131See the previous option's description for details. 132.It Fl s 133Force behaviour to 134ignore and not generate Win'95 long filenames. 135.It Fl l 136Force listing and generation of 137Win'95 long filenames 138and separate creation/modification/access dates. 139.Pp 140If neither 141.Fl s 142nor 143.Fl l 144are given, 145.Fl l 146is the default. 147.It Fl 9 148Ignore the special Win'95 directory entries even 149if deleting or renaming a file. 150This forces 151.Fl s . 152.\".It Fl G 153.\"This option causes the file system to be interpreted as an Atari-Gemdos 154.\"file system. 155.\"The differences to the MS-DOS file system are minimal and 156.\"limited to the boot block. 157.\"This option enforces 158.\".Fl s . 159.It Fl L Ar locale 160Specify locale name used for file name conversions 161for DOS and Win'95 names. 162By default ISO 8859-1 assumed as local character set. 163.It Fl D Ar DOS_codepage 164Specify the MS-DOS code page (aka IBM/OEM code page) name used for 165file name conversions for DOS names. 166.It Fl W Ar table 167.Bf Em 168This option is preserved for backward compatibility purpose only, 169and will be removed in the future. 170Please avoid using this option. 171.Ef 172.Pp 173Specify text file name with conversion table: 174.Pa iso22dos , iso72dos , koi2dos , koi8u2dos . 175.El 176.Sh EXAMPLES 177To mount a Russian MS-DOS file system located in 178.Pa /dev/ada1s1 : 179.Pp 180.Dl "mount_msdosfs -L ru_RU.KOI8-R -D CP866 /dev/ada1s1 /mnt" 181.Pp 182To mount a Japanese MS-DOS file system located in 183.Pa /dev/ada1s1 : 184.Pp 185.Dl "mount_msdosfs -L ja_JP.eucJP -D CP932 /dev/ada1s1 /mnt" 186.Sh SEE ALSO 187.Xr mount 2 , 188.Xr unmount 2 , 189.Xr fstab 5 , 190.Xr msdosfs 5 , 191.Xr mount 8 192.Pp 193List of Localized MS Operating Systems: 194.Pa http://www.microsoft.com/globaldev/reference/oslocversion.mspx . 195.Sh HISTORY 196The predecessor to 197.Nm mount_msdos 198utility named 199.Nm mount_pcfs 200appeared in 201.Bx 386 . 202It was rewritten in 203.Nx 1.0 204and first appeared in 205.Fx 2.0 . 206.Nm mount_msdos 207was renamed to the more aptly-named 208.Nm 209in 210.Fx 5.0. 211The character code conversion routine was added in 2003. 212.Sh AUTHORS 213Initial implementation as 214.Nm mount_pcfs 215was written by 216.An -nosplit 217.An Paul Popelka Aq Mt paulp@uts.amdahl.com . 218It was rewritten by 219.An Christopher G. Demetriou Aq Mt cgd@NetBSD.org . 220The character code conversion routine was added by 221.An Ryuichiro Imura Aq Mt imura@ryu16.org . 222.Sh CAVEATS 223The use of the 224.Fl 9 225flag could result in damaged file systems, 226albeit the damage is in part taken care of by 227procedures similar to the ones used in Win'95. 228