]>
Commit | Line | Data |
---|---|---|
ec8f24b7 | 1 | # SPDX-License-Identifier: GPL-2.0-only |
1c6ace01 AD |
2 | config FAT_FS |
3 | tristate | |
925c86a1 | 4 | select BUFFER_HEAD |
1c6ace01 | 5 | select NLS |
9636e650 | 6 | select LEGACY_DIRECT_IO |
1c6ace01 AD |
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 | |
4ecfed61 | 46 | <https://www.tldp.org/docs.html#howto>, or try dmsdosfs in |
1c6ace01 AD |
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 | |
72ef5e52 | 74 | the file <file:Documentation/filesystems/vfat.rst> for details. If |
1c6ace01 AD |
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" | |
b0d4adaf | 82 | depends on FAT_FS |
1c6ace01 AD |
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. | |
72ef5e52 | 87 | See <file:Documentation/filesystems/vfat.rst> for more information. |
1c6ace01 AD |
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. | |
38739380 MS |
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. | |
72ef5e52 | 101 | See <file:Documentation/filesystems/vfat.rst> for more information. |
d29a2e94 AC |
102 | |
103 | Enable any character sets you need in File Systems/Native Language | |
104 | Support. | |
38739380 MS |
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 | ||
72ef5e52 | 119 | See <file:Documentation/filesystems/vfat.rst> for more information. |
b0d4adaf DG |
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 |