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: src/sbin/mount_msdos/mount_msdos.8,v 1.19.2.1 2000/12/08 14:03:59 ru Exp $ 32.\" 33.Dd September 29, 2016 34.Dt MOUNT_MSDOS 8 35.Os 36.Sh NAME 37.Nm mount_msdos 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 o Ar options 47.Op Fl u Ar uid 48.\".Op Fl G 49.Pa special 50.Pa node 51.Sh DESCRIPTION 52The 53.Nm 54command attaches the MS-DOS filesystem residing on 55the device 56.Pa special 57to the global filesystem 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 , 74or one of the MS-DOS filesystem-specific options 75.Ar shortnames , 76.Ar longnames 77or 78.Ar nowin95 , 79all of which can be used to affect Windows name translation in the 80underlying filesystem. 81.It Fl u Ar uid 82Set the owner of the files in the file system to 83.Ar uid . 84The default owner is the owner of the directory 85on which the file system is being mounted. 86.It Fl g Ar gid 87Set the group of the files in the file system to 88.Ar gid . 89The default group is the group of the directory 90on which the file system is being mounted. 91.It Fl m Ar mask 92Specify the maximum file permissions for files 93in the file system. 94(For example, a 95.Ar mask 96of 97.Li 755 98specifies that, by default, the owner should have 99read, write, and execute permissions for files, but 100others should only have read and execute permissions. 101See 102.Xr chmod 1 103for more information about octal file modes.) 104Only the nine low-order bits of 105.Ar mask 106are used. 107The default 108.Ar mask 109is taken from the 110directory on which the file system is being mounted. 111.It Fl s 112Force behaviour to 113ignore and not generate Win'95 long filenames. 114.It Fl l 115Force listing and generation of 116Win'95 long filenames 117and separate creation/modification/access dates. 118.Pp 119If neither 120.Fl s 121nor 122.Fl l 123are given, 124.Nm 125searches the root directory of the filesystem to 126be mounted for any existing Win'95 long filenames. 127If no such entries are found, but short DOS filenames are found, 128.Fl s 129is the default. 130Otherwise 131.Fl l 132is assumed. 133.It Fl 9 134Ignore the special Win'95 directory entries even 135if deleting or renaming a file. 136This forces 137.Fl s . 138.\".It Fl G 139.\"This option causes the filesystem to be interpreted as an Atari-Gemdos 140.\"filesystem. The differences to the MS-DOS filesystem are minimal and 141.\"limited to the boot block. This option enforces 142.\".Fl s . 143.It Fl L Ar locale 144Specify locale name used for internal uppercase and lowercase conversions 145for DOS and Win'95 names. 146By default ISO 8859-1 assumed as local character set. 147.It Fl D Ar DOS_codepage 148Specify the MS-DOS code page (aka IBM/OEM code page) name used for 149file name conversions for DOS names. 150.El 151.Sh SEE ALSO 152.Xr mount 2 , 153.Xr unmount 2 , 154.Xr fstab 5 , 155.Xr mount 8 156.Sh HISTORY 157The predecessor to 158.Nm 159utility named 160.Nm mount_pcfs 161appeared in 162.Bx 386 . 163It was rewritten in 164.Nx 1.0 165and first appeared in 166.Fx 2.0 . 167.Sh AUTHORS 168Initial implimintation as 169.Nm mount_pcfs 170was written by 171.An -nosplit 172.An Paul Popelka Aq Mt paulp@uts.amdahl.com . 173It was rewritten by 174.An Christopher G. Demetriou Aq Mt cgd@NetBSD.org . 175.Sh CAVEATS 176The use of the 177.Fl 9 178flag could result in damaged filesystems, 179albeit the damage is in part taken care of by 180procedures similar to the ones used in Win'95. 181.Pp 182.Fx 2.1 183and earlier versions could not handle cluster sizes larger than 16K. 184Just mounting an MS-DOS file system could cause corruption to any 185mounted file system. 186Cluster sizes larger than 16K are unavoidable for file system sizes 187larger than 1G, and also occur when filesystems larger than 1G are 188shrunk to smaller than 1G using FIPS. 189