xref: /netbsd-src/sbin/mount_msdos/mount_msdos.8 (revision 6929ad87a5c37179228b21785018bbb66fe06b56)
1.\"
2.\" Copyright (c) 1993,1994 Christopher G. Demetriou
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. All advertising materials mentioning features or use of this software
14.\"    must display the following acknowledgement:
15.\"      This product includes software developed by Christopher G. Demetriou.
16.\" 3. The name of the author may not be used to endorse or promote products
17.\"    derived from this software without specific prior written permission
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29.\"
30.\"	$Id: mount_msdos.8,v 1.6 1995/01/18 08:35:42 mycroft Exp $
31.\"
32.Dd April 7, 1994
33.Dt MOUNT_MSDOS 8
34.Os NetBSD 0.9a
35.Sh NAME
36.Nm mount_msdos
37.Nd mount an MS-DOS file system
38.Sh SYNOPSIS
39.Nm mount_msdos
40.Op Fl o Ar options
41.Op Fl u Ar uid
42.Op Fl g Ar gid
43.Op Fl m Ar mask
44.Pa special
45.Pa node
46.Sh DESCRIPTION
47The
48.Nm mount_msdos
49command attaches the MS-DOS filesystem residing on
50the device
51.Pa special
52to the global filesystem namespace at the location
53indicated by
54.Pa node .
55This command is normally executed by
56.Xr mount 8
57at boot time, but can be used by any user to mount an
58MS-DOS file system on any directory that they own (provided,
59of course, that they have appropriate access to the device that
60contains the file system).
61.Pp
62The options are as follows:
63.Bl -tag -width Ds
64.It Fl o Ar options
65Use the specified mount
66.Ar options ,
67as described in
68.Xr mount 8 .
69.It Fl u Ar uid
70Set the owner of the files in the file system to
71.Ar uid .
72The default owner is the owner of the directory
73on which the file system is being mounted.
74.It Fl g Ar gid
75Set the group of the files in the file system to
76.Ar gid .
77The default group is the group of the directory
78on which the file system is being mounted.
79.It Fl m Ar mask
80Specify the maximum file permissions for files
81in the file system.
82(For example, a mask of
83.Li 755
84specifies that, by default, the owner should have
85read, write, and execute permissions for files, but
86others should only have read and execute permissions.
87See
88.Xr chmod 1
89for more information about octal file modes.)
90Only the nine low-order bits of
91.Ar mask
92are used.
93The default mask is taken from the
94directory on which the file system is being mounted.
95.El
96.Sh SEE ALSO
97.Xr mount 2 ,
98.Xr unmount 2 ,
99.Xr fstab 5 ,
100.Xr mount 8
101.Sh CAVEATS
102The
103.Nm msdos
104filesystem is not known to work reliably with filesystems created by versions
105of MS-DOS later than version 3.3.
106.Pp
107The limitations on file names imposed by MS-DOS are strange, at best.
108For instance, they are
109limited to single-case, 8 character names with 3 character extensions.
110.Sh HISTORY
111The
112.Nm mount_msdos
113utility first appeared in NetBSD 0.9.
114Its predecessor, the
115.Nm mount_pcfs
116utility appeared in NetBSD 0.8, and was abandoned in favor
117of the more aptly-named
118.Nm mount_msdos .
119