share/man/man5/msdosfs.5

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