sbin/mount_msdos/mount_msdos.8

   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$
  31 .\"
  32 .Dd April 7, 1994
  33 .Dt MOUNT_MSDOS 8
  34 .Os FreeBSD 2.0
  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 u Ar uid
  41 .Op Fl g Ar gid
  42 .Op Fl m Ar mask
  43 .Pa special
  44 .Pa node
  45 .Sh DESCRIPTION
  46 The
  47 .Nm mount_msdos
  48 command attaches the MS-DOS filesystem residing on
  49 the device
  50 .Pa special
  51 to the global filesystem namespace at the location
  52 indicated by
  53 .Pa node .
  54 This command is normally executed by
  55 .Xr mount 8
  56 at boot time, but can be used by any user to mount an
  57 MS-DOS file system on any directory that they own (provided,
  58 of course, that they have appropriate access to the device that
  59 contains the file system).
  60 .Pp
  61 The options are as follows:
  62 .Bl -tag -width Ds
  63 .It Fl u
  64 Set the owner of the files in the file system to
  65 .Ar uid .
  66 The default owner is the owner of the directory
  67 on which the file system is being mounted.
  68 .It Fl g
  69 Set the group of the files in the file system to
  70 .Ar gid .
  71 The default group is the group of the directory
  72 on which the file system is being mounted.
  73 .It Fl m
  74 Specify the maximum file permissions for files
  75 in the file system.
  76 (For example, a mask of
  77 .Li 755
  78 specifies that, by default, the owner should have
  79 read, write, and execute permissions for files, but
  80 others should only have read and execute permissions.
  81 See
  82 .Xr chmod 1
  83 for more information about octal file modes.)
  84 Only the nine low-order bits of
  85 .Ar mask
  86 are used.
  87 The default mask is taken from the
  88 directory on which the file system is being mounted.
  89 .El
  90 .Sh SEE ALSO
  91 .Xr mount 2 ,
  92 .Xr unmount 2 ,
  93 .Xr fstab 5
  94 .Sh CAVEATS
  95 The
  96 .Nm msdos
  97 filesystem is not known to work reliably with filesystems created by versions
  98 of MS-DOS later than version 3.3.
  99 .Pp
 100 The limitations on file names imposed by MS-DOS are strange, at best.
 101 For instance, they are
 102 limited to single-case, 8 character names with 3 character extensions.
 103 .Pp
 104 If you see the warning:
 105 .Pp
 106 mountmsdosfs(): Warning: root directory is not a multiple of the clustersize in length
 107 .Pp
 108 then it is possible that writing to the MS-DOS filesystem would
 109 produce corruption on the disk. This is a shortcoming in the code
 110 which needs to be addressed.
 111 .Sh HISTORY
 112 The
 113 .Nm mount_msdos
 114 utility first appeared in FreeBSD 2.0.
 115 Its predecessor, the
 116 .Nm mount_pcfs
 117 utility appeared in FreeBSD 1, and was abandoned in favor
 118 of the more aptly-named
 119 .Nm mount_msdos .