1.\" $NetBSD: mount_msdos.8,v 1.23 2002/10/01 13:40:40 wiz 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 acknowledgement: 16.\" This product includes software developed for the 17.\" NetBSD Project. See http://www.netbsd.org/ for 18.\" information about NetBSD. 19.\" 4. The name of the author may not be used to endorse or promote products 20.\" derived from this software without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 23.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 24.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 25.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 26.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 27.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 28.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 29.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 30.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 31.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32.\" 33.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>> 34.\" 35.Dd April 7, 1994 36.Dt MOUNT_MSDOS 8 37.Os 38.Sh NAME 39.Nm mount_msdos 40.Nd mount an MS-DOS file system 41.Sh SYNOPSIS 42.Nm "" 43.Op Fl o Ar options 44.Op Fl u Ar uid 45.Op Fl g Ar gid 46.Op Fl m Ar mask 47.Op Fl s 48.Op Fl l 49.Op Fl 9 50.Op Fl G 51.Pa special 52.Pa node 53.Sh DESCRIPTION 54The 55.Nm 56command attaches the MS-DOS filesystem residing on 57the device 58.Pa special 59to the global filesystem namespace at the location 60indicated by 61.Pa node . 62This command is normally executed by 63.Xr mount 8 64at boot time, but can be used by any user to mount an 65MS-DOS file system on any directory that they own (provided, 66of course, that they have appropriate access to the device that 67contains the file system). 68.Pp 69Support for FAT16 and VFAT32 as well as long file names is available. 70.Pp 71The options are as follows: 72.Bl -tag -width Ds 73.It Fl o Ar options 74Use the specified mount 75.Ar options , 76as described in 77.Xr mount 8 . 78.It Fl u Ar uid 79Set the owner of the files in the file system to 80.Ar uid . 81The default owner is the owner of the directory 82on which the file system is being mounted. 83.It Fl g Ar gid 84Set the group of the files in the file system to 85.Ar gid . 86The default group is the group of the directory 87on which the file system is being mounted. 88.It Fl m Ar mask 89Specify the maximum file permissions for files 90in the file system. 91(For example, a mask of 92.Li 755 93specifies that, by default, the owner should have 94read, write, and execute permissions for files, but 95others should only have read and execute permissions. 96See 97.Xr chmod 1 98for more information about octal file modes.) 99Only the nine low-order bits of 100.Ar mask 101are used. 102The default mask is taken from the 103directory on which the file system is being mounted. 104.It Fl s 105Force behaviour to 106ignore and not generate Win'95 long filenames. 107.It Fl l 108Force listing and generation of 109Win'95 long filenames 110and separate creation/modification/access dates. 111.Pp 112If neither 113.Fl s 114nor 115.Fl l 116are given, 117.Nm 118searches the root directory of the filesystem to 119be mounted for any existing Win'95 long filenames. 120If no such entries are found, 121.Fl s 122is the default. 123Otherwise 124.Fl l 125is assumed. 126.It Fl 9 127Ignore the special Win'95 directory entries even 128if deleting or renaming a file. 129This forces 130.Fl s . 131.It Fl G 132This option causes the filesystem to be interpreted as an Atari-Gemdos 133filesystem. 134The differences to the msdos filesystem are minimal and 135limited to the boot block. 136This option enforces 137.Fl s . 138.El 139.Sh SEE ALSO 140.Xr mount 2 , 141.Xr unmount 2 , 142.Xr fstab 5 , 143.Xr mount 8 144.Sh HISTORY 145The 146.Nm 147utility first appeared in 148.Nx 0.9 . 149Its predecessor, the 150.Ic mount_pcfs 151utility appeared in 152.Nx 0.8 , 153and was abandoned in favor 154of the more aptly-named 155.Nm "" . 156.Sh BUGS 157Compressed partitions are not supported. 158.Pp 159The use of the 160.Fl 9 161flag could result in damaged filesystems, 162albeit the damage is in part taken care of by 163procedures similar to the ones used in Win'95. 164.Pp 165The default handling for 166.Fl s 167and 168.Fl l 169will result in empty filesystems to be populated 170with short filenames only. 171To generate long filenames 172on empty DOS filesystems use 173.Fl l . 174