1.\" $NetBSD: mount_msdos.8,v 1.22 2001/11/16 11:26:56 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. Otherwise 123.Fl l 124is assumed. 125.It Fl 9 126Ignore the special Win'95 directory entries even 127if deleting or renaming a file. This forces 128.Fl s . 129.It Fl G 130This option causes the filesystem to be interpreted as an Atari-Gemdos 131filesystem. The differences to the msdos filesystem are minimal and 132limited to the boot block. This option enforces 133.Fl s . 134.El 135.Sh SEE ALSO 136.Xr mount 2 , 137.Xr unmount 2 , 138.Xr fstab 5 , 139.Xr mount 8 140.Sh HISTORY 141The 142.Nm 143utility first appeared in 144.Nx 0.9 . 145Its predecessor, the 146.Ic mount_pcfs 147utility appeared in 148.Nx 0.8 , 149and was abandoned in favor 150of the more aptly-named 151.Nm "" . 152.Sh BUGS 153Compressed partitions are not supported. 154.Pp 155The use of the 156.Fl 9 157flag could result in damaged filesystems, 158albeit the damage is in part taken care of by 159procedures similar to the ones used in Win'95. 160.Pp 161The default handling for 162.Fl s 163and 164.Fl l 165will result in empty filesystems to be populated 166with short filenames only. To generate long filenames 167on empty DOS filesystems use 168.Fl l . 169