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