ec8f24b7faaf3 (Thomas Gleixner 2019-05-19 13:07:45 +0100 1) # SPDX-License-Identifier: GPL-2.0-only
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 2) config NTFS_FS
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 3) tristate "NTFS file system support"
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 4) select NLS
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 5) help
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 6) NTFS is the file system of Microsoft Windows NT, 2000, XP and 2003.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 7)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 8) Saying Y or M here enables read support. There is partial, but
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 9) safe, write support available. For write support you must also
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 10) say Y to "NTFS write support" below.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 11)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 12) There are also a number of user-space tools available, called
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 13) ntfsprogs. These include ntfsundelete and ntfsresize, that work
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 14) without NTFS support enabled in the kernel.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 15)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 16) This is a rewrite from scratch of Linux NTFS support and replaced
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 17) the old NTFS code starting with Linux 2.5.11. A backport to
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 18) the Linux 2.4 kernel series is separately available as a patch
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 19) from the project web site.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 20)
0c1bc6b84525b (Mauro Carvalho Chehab 2020-04-14 18:48:37 +0200 21) For more information see <file:Documentation/filesystems/ntfs.rst>
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 22) and <http://www.linux-ntfs.org/>.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 23)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 24) To compile this file system support as a module, choose M here: the
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 25) module will be called ntfs.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 26)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 27) If you are not using Windows NT, 2000, XP or 2003 in addition to
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 28) Linux on your computer it is safe to say N.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 29)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 30) config NTFS_DEBUG
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 31) bool "NTFS debugging support"
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 32) depends on NTFS_FS
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 33) help
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 34) If you are experiencing any problems with the NTFS file system, say
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 35) Y here. This will result in additional consistency checks to be
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 36) performed by the driver as well as additional debugging messages to
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 37) be written to the system log. Note that debugging messages are
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 38) disabled by default. To enable them, supply the option debug_msgs=1
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 39) at the kernel command line when booting the kernel or as an option
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 40) to insmod when loading the ntfs module. Once the driver is active,
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 41) you can enable debugging messages by doing (as root):
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 42) echo 1 > /proc/sys/fs/ntfs-debug
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 43) Replacing the "1" with "0" would disable debug messages.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 44)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 45) If you leave debugging messages disabled, this results in little
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 46) overhead, but enabling debug messages results in very significant
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 47) slowdown of the system.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 48)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 49) When reporting bugs, please try to have available a full dump of
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 50) debugging messages while the misbehaviour was occurring.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 51)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 52) config NTFS_RW
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 53) bool "NTFS write support"
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 54) depends on NTFS_FS
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 55) help
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 56) This enables the partial, but safe, write support in the NTFS driver.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 57)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 58) The only supported operation is overwriting existing files, without
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 59) changing the file length. No file or directory creation, deletion or
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 60) renaming is possible. Note only non-resident files can be written to
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 61) so you may find that some very small files (<500 bytes or so) cannot
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 62) be written to.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 63)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 64) While we cannot guarantee that it will not damage any data, we have
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 65) so far not received a single report where the driver would have
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 66) damaged someones data so we assume it is perfectly safe to use.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 67)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 68) Note: While write support is safe in this version (a rewrite from
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 69) scratch of the NTFS support), it should be noted that the old NTFS
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 70) write support, included in Linux 2.5.10 and before (since 1997),
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 71) is not safe.
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 72)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 73) This is currently useful with TopologiLinux. TopologiLinux is run
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 74) on top of any DOS/Microsoft Windows system without partitioning your
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 75) hard disk. Unlike other Linux distributions TopologiLinux does not
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 76) need its own partition. For more information see
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 77) <http://topologi-linux.sourceforge.net/>
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 78)
9d73ac9e8faff (Alexey Dobriyan 2009-01-22 10:39:20 +0300 79) It is perfectly safe to say N here.