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