fs/fat/Kconfig

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 config FAT_FS
   3         tristate
   4         select BUFFER_HEAD
   5         select NLS
   6         select LEGACY_DIRECT_IO
   7         help
   8           If you want to use one of the FAT-based file systems (the MS-DOS and
   9           VFAT (Windows 95) file systems), then you must say Y or M here
  10           to include FAT support. You will then be able to mount partitions or
  11           diskettes with FAT-based file systems and transparently access the
  12           files on them, i.e. MSDOS files will look and behave just like all
  13           other Unix files.
  14
  15           This FAT support is not a file system in itself, it only provides
  16           the foundation for the other file systems. You will have to say Y or
  17           M to at least one of "MSDOS fs support" or "VFAT fs support" in
  18           order to make use of it.
  19
  20           Another way to read and write MSDOS floppies and hard drive
  21           partitions from within Linux (but not transparently) is with the
  22           mtools ("man mtools") program suite. You don't need to say Y here in
  23           order to do that.
  24
  25           If you need to move large files on floppies between a DOS and a
  26           Linux box, say Y here, mount the floppy under Linux with an MSDOS
  27           file system and use GNU tar's M option. GNU tar is a program
  28           available for Unix and DOS ("man tar" or "info tar").
  29
  30           The FAT support will enlarge your kernel by about 37 KB. If unsure,
  31           say Y.
  32
  33           To compile this as a module, choose M here: the module will be called
  34           fat.  Note that if you compile the FAT support as a module, you
  35           cannot compile any of the FAT-based file systems into the kernel
  36           -- they will have to be modules as well.
  37
  38 config MSDOS_FS
  39         tristate "MSDOS fs support"
  40         select FAT_FS
  41         help
  42           This allows you to mount MSDOS partitions of your hard drive (unless
  43           they are compressed; to access compressed MSDOS partitions under
  44           Linux, you can either use the DOS emulator DOSEMU, described in the
  45           DOSEMU-HOWTO, available from
  46           <https://www.tldp.org/docs.html#howto>, or try dmsdosfs in
  47           <ftp://ibiblio.org/pub/Linux/system/filesystems/dosfs/>. If you
  48           intend to use dosemu with a non-compressed MSDOS partition, say Y
  49           here) and MSDOS floppies. This means that file access becomes
  50           transparent, i.e. the MSDOS files look and behave just like all
  51           other Unix files.
  52
  53           If you have Windows 95 or Windows NT installed on your MSDOS
  54           partitions, you should use the VFAT file system (say Y to "VFAT fs
  55           support" below), or you will not be able to see the long filenames
  56           generated by Windows 95 / Windows NT.
  57
  58           This option will enlarge your kernel by about 7 KB. If unsure,
  59           answer Y. This will only work if you said Y to "DOS FAT fs support"
  60           as well. To compile this as a module, choose M here: the module will
  61           be called msdos.
  62
  63 config VFAT_FS
  64         tristate "VFAT (Windows-95) fs support"
  65         select FAT_FS
  66         help
  67           This option provides support for normal Windows file systems with
  68           long filenames.  That includes non-compressed FAT-based file systems
  69           used by Windows 95, Windows 98, Windows NT 4.0, and the Unix
  70           programs from the mtools package.
  71
  72           The VFAT support enlarges your kernel by about 10 KB and it only
  73           works if you said Y to the "DOS FAT fs support" above.  Please read
  74           the file <file:Documentation/filesystems/vfat.rst> for details.  If
  75           unsure, say Y.
  76
  77           To compile this as a module, choose M here: the module will be called
  78           vfat.
  79
  80 config FAT_DEFAULT_CODEPAGE
  81         int "Default codepage for FAT"
  82         depends on FAT_FS
  83         default 437
  84         help
  85           This option should be set to the codepage of your FAT filesystems.
  86           It can be overridden with the "codepage" mount option.
  87           See <file:Documentation/filesystems/vfat.rst> for more information.
  88
  89 config FAT_DEFAULT_IOCHARSET
  90         string "Default iocharset for FAT"
  91         depends on VFAT_FS
  92         default "iso8859-1"
  93         help
  94           Set this to the default input/output character set you'd
  95           like FAT to use. It should probably match the character set
  96           that most of your FAT filesystems use, and can be overridden
  97           with the "iocharset" mount option for FAT filesystems.
  98           Note that "utf8" is not recommended for FAT filesystems.
  99           If unsure, you shouldn't set "utf8" here - select the next option
 100           instead if you would like to use UTF-8 encoded file names by default.
 101           See <file:Documentation/filesystems/vfat.rst> for more information.
 102
 103           Enable any character sets you need in File Systems/Native Language
 104           Support.
 105
 106 config FAT_DEFAULT_UTF8
 107         bool "Enable FAT UTF-8 option by default"
 108         depends on VFAT_FS
 109         default n
 110         help
 111           Set this if you would like to have "utf8" mount option set
 112           by default when mounting FAT filesystems.
 113
 114           Even if you say Y here can always disable UTF-8 for
 115           particular mount by adding "utf8=0" to mount options.
 116
 117           Say Y if you use UTF-8 encoding for file names, N otherwise.
 118
 119           See <file:Documentation/filesystems/vfat.rst> for more information.
 120
 121 config FAT_KUNIT_TEST
 122         tristate "Unit Tests for FAT filesystems" if !KUNIT_ALL_TESTS
 123         depends on KUNIT && FAT_FS
 124         default KUNIT_ALL_TESTS
 125         help
 126           This builds the FAT KUnit tests
 127
 128           For more information on KUnit and unit tests in general, please refer
 129           to the KUnit documentation in Documentation/dev-tools/kunit
 130
 131           If unsure, say N