sbin/mount_msdos/mount_msdos.8

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