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