share/man/man5/msdosfs.5

   1 .\" Written by Tom Rhodes
   2 .\" This file is in the public domain.
   3 .\"
   4 .Dd September 27, 2018
   5 .Dt MSDOSFS 5
   6 .Os
   7 .Sh NAME
   8 .Nm msdosfs
   9 .Nd MS-DOS file system
  10 .Sh SYNOPSIS
  11 .Cd "options MSDOSFS"
  12 .Sh DESCRIPTION
  13 The
  14 .Nm
  15 driver will permit the
  16 .Fx
  17 kernel to read and write MS-DOS based file systems.
  18 .Pp
  19 The most common usage follows:
  20 .Pp
  21 .Dl "mount -t msdosfs /dev/ada0sN /mnt"
  22 .Pp
  23 where
  24 .Ar N
  25 is the partition number and
  26 .Pa /mnt
  27 is a mount point.
  28 Some users tend to create a
  29 .Pa /dos
  30 directory for
  31 .Nm
  32 mount points.
  33 This helps to keep better track of the file system,
  34 and make it more easily accessible.
  35 .Pp
  36 It is possible to define an entry in
  37 .Pa /etc/fstab
  38 that looks similar to:
  39 .Bd -literal
  40 /dev/ada0sN             /dos    msdosfs         rw      0       0
  41 .Ed
  42 .Pp
  43 This will mount an MS-DOS based partition at the
  44 .Pa /dos
  45 mount point during system boot.
  46 Using
  47 .Pa /mnt
  48 as a permanent mount point is not advised as its intention
  49 has always been to be a temporary mount point for floppy and
  50 ZIP disks.
  51 See
  52 .Xr hier 7
  53 for more information on
  54 .Fx
  55 directory layout.
  56 .Sh EXAMPLES
  57 Determine which FAT file system version (e.g, FAT16, FAT32)
  58 is a partition formatted with:
  59 .Bd -literal -offset indent
  60 file -s /dev/da0s1
  61 .Ed
  62 .Pp
  63 .Xr gpart 8
  64 may also be used to extract this information.
  65 .Sh SEE ALSO
  66 .Xr mount 2 ,
  67 .Xr unmount 2 ,
  68 .Xr mount 8 ,
  69 .Xr mount_msdosfs 8 ,
  70 .Xr umount 8
  71 .Sh AUTHORS
  72 This manual page was written by
  73 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org .