Blame view

Documentation/filesystems/ntfs.txt 31.3 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
  The Linux NTFS filesystem driver
  ================================
  
  
  Table of contents
  =================
  
  - Overview
  - Web site
  - Features
  - Supported mount options
  - Known bugs and (mis-)features
  - Using NTFS volume and stripe sets
    - The Device-Mapper driver
    - The Software RAID / MD driver
2fe0ae78c   Matt LaPlante   Fix typos in Docu...
16
    - Limitations when using the MD driver
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
17
18
19
20
21
22
23
  - ChangeLog
  
  
  Overview
  ========
  
  Linux-NTFS comes with a number of user-space programs known as ntfsprogs.
c002f4254   Anton Altaparmakov   NTFS: - Add disab...
24
  These include mkntfs, a full-featured ntfs filesystem format utility,
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
  ntfsundelete used for recovering files that were unintentionally deleted
  from an NTFS volume and ntfsresize which is used to resize an NTFS partition.
  See the web site for more information.
  
  To mount an NTFS 1.2/3.x (Windows NT4/2000/XP/2003) volume, use the file
  system type 'ntfs'.  The driver currently supports read-only mode (with no
  fault-tolerance, encryption or journalling) and very limited, but safe, write
  support.
  
  For fault tolerance and raid support (i.e. volume and stripe sets), you can
  use the kernel's Software RAID / MD driver.  See section "Using Software RAID
  with NTFS" for details.
  
  
  Web site
  ========
  
  There is plenty of additional information on the linux-ntfs web site
169ccbd44   Adrian Bunk   NTFS: update home...
43
  at http://www.linux-ntfs.org/
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
44
45
  
  The web site has a lot of additional information, such as a comprehensive
2fe0ae78c   Matt LaPlante   Fix typos in Docu...
46
  FAQ, documentation on the NTFS on-disk format, information on the Linux-NTFS
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
47
48
49
50
51
  userspace utilities, etc.
  
  
  Features
  ========
98b270362   Anton Altaparmakov   NTFS: The big ntf...
52
53
54
55
56
57
58
59
  - This is a complete rewrite of the NTFS driver that used to be in the 2.4 and
    earlier kernels.  This new driver implements NTFS read support and is
    functionally equivalent to the old ntfs driver and it also implements limited
    write support.  The biggest limitation at present is that files/directories
    cannot be created or deleted.  See below for the list of write features that
    are so far supported.  Another limitation is that writing to compressed files
    is not implemented at all.  Also, neither read nor write access to encrypted
    files is so far implemented.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
  - The new driver has full support for sparse files on NTFS 3.x volumes which
    the old driver isn't happy with.
  - The new driver supports execution of binaries due to mmap() now being
    supported.
  - The new driver supports loopback mounting of files on NTFS which is used by
    some Linux distributions to enable the user to run Linux from an NTFS
    partition by creating a large file while in Windows and then loopback
    mounting the file while in Linux and creating a Linux filesystem on it that
    is used to install Linux on it.
  - A comparison of the two drivers using:
  	time find . -type f -exec md5sum "{}" \;
    run three times in sequence with each driver (after a reboot) on a 1.4GiB
    NTFS partition, showed the new driver to be 20% faster in total time elapsed
    (from 9:43 minutes on average down to 7:53).  The time spent in user space
    was unchanged but the time spent in the kernel was decreased by a factor of
    2.5 (from 85 CPU seconds down to 33).
  - The driver does not support short file names in general.  For backwards
    compatibility, we implement access to files using their short file names if
    they exist.  The driver will not create short file names however, and a
    rename will discard any existing short file name.
  - The new driver supports exporting of mounted NTFS volumes via NFS.
  - The new driver supports async io (aio).
  - The new driver supports fsync(2), fdatasync(2), and msync(2).
  - The new driver supports readv(2) and writev(2).
  - The new driver supports access time updates (including mtime and ctime).
98b270362   Anton Altaparmakov   NTFS: The big ntf...
85
86
87
88
89
90
91
92
93
94
95
96
97
98
  - The new driver supports truncate(2) and open(2) with O_TRUNC.  But at present
    only very limited support for highly fragmented files, i.e. ones which have
    their data attribute split across multiple extents, is included.  Another
    limitation is that at present truncate(2) will never create sparse files,
    since to mark a file sparse we need to modify the directory entry for the
    file and we do not implement directory modifications yet.
  - The new driver supports write(2) which can both overwrite existing data and
    extend the file size so that you can write beyond the existing data.  Also,
    writing into sparse regions is supported and the holes are filled in with
    clusters.  But at present only limited support for highly fragmented files,
    i.e. ones which have their data attribute split across multiple extents, is
    included.  Another limitation is that write(2) will never create sparse
    files, since to mark a file sparse we need to modify the directory entry for
    the file and we do not implement directory modifications yet.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
  
  Supported mount options
  =======================
  
  In addition to the generic mount options described by the manual page for the
  mount command (man 8 mount, also see man 5 fstab), the NTFS driver supports the
  following mount options:
  
  iocharset=name		Deprecated option.  Still supported but please use
  			nls=name in the future.  See description for nls=name.
  
  nls=name		Character set to use when returning file names.
  			Unlike VFAT, NTFS suppresses names that contain
  			unconvertible characters.  Note that most character
  			sets contain insufficient characters to represent all
  			possible Unicode characters that can exist on NTFS.
  			To be sure you are not missing any files, you are
  			advised to use nls=utf8 which is capable of
  			representing all Unicode characters.
  
  utf8=<bool>		Option no longer supported.  Currently mapped to
  			nls=utf8 but please use nls=utf8 in the future and
  			make sure utf8 is compiled either as module or into
  			the kernel.  See description for nls=name.
  
  uid=
  gid=
  umask=			Provide default owner, group, and access mode mask.
  			These options work as documented in mount(8).  By
  			default, the files/directories are owned by root and
  			he/she has read and write permissions, as well as
  			browse permission for directories.  No one else has any
  			access permissions.  I.e. the mode on all files is by
  			default rw------- and for directories rwx------, a
  			consequence of the default fmask=0177 and dmask=0077.
  			Using a umask of zero will grant all permissions to
  			everyone, i.e. all files and directories will have mode
  			rwxrwxrwx.
  
  fmask=
  dmask=			Instead of specifying umask which applies both to
  			files and directories, fmask applies only to files and
  			dmask only to directories.
  
  sloppy=<BOOL>		If sloppy is specified, ignore unknown mount options.
  			Otherwise the default behaviour is to abort mount if
  			any unknown options are found.
  
  show_sys_files=<BOOL>	If show_sys_files is specified, show the system files
  			in directory listings.  Otherwise the default behaviour
  			is to hide the system files.
  			Note that even when show_sys_files is specified, "$MFT"
  			will not be visible due to bugs/mis-features in glibc.
  			Further, note that irrespective of show_sys_files, all
  			files are accessible by name, i.e. you can always do
  			"ls -l \$UpCase" for example to specifically show the
  			system file containing the Unicode upcase table.
  
  case_sensitive=<BOOL>	If case_sensitive is specified, treat all file names as
  			case sensitive and create file names in the POSIX
  			namespace.  Otherwise the default behaviour is to treat
  			file names as case insensitive and to create file names
  			in the WIN32/LONG name space.  Note, the Linux NTFS
  			driver will never create short file names and will
  			remove them on rename/delete of the corresponding long
  			file name.
  			Note that files remain accessible via their short file
  			name, if it exists.  If case_sensitive, you will need
  			to provide the correct case of the short file name.
c002f4254   Anton Altaparmakov   NTFS: - Add disab...
168
169
170
171
172
173
174
175
  disable_sparse=<BOOL>	If disable_sparse is specified, creation of sparse
  			regions, i.e. holes, inside files is disabled for the
  			volume (for the duration of this mount only).  By
  			default, creation of sparse regions is enabled, which
  			is consistent with the behaviour of traditional Unix
  			filesystems.
  
  errors=opt		What to do when critical filesystem errors are found.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
  			Following values can be used for "opt":
  			  continue: DEFAULT, try to clean-up as much as
  				    possible, e.g. marking a corrupt inode as
  				    bad so it is no longer accessed, and then
  				    continue.
  			  recover:  At present only supported is recovery of
  				    the boot sector from the backup copy.
  				    If read-only mount, the recovery is done
  				    in memory only and not written to disk.
  			Note that the options are additive, i.e. specifying:
  			   errors=continue,errors=recover
  			means the driver will attempt to recover and if that
  			fails it will clean-up as much as possible and
  			continue.
  
  mft_zone_multiplier=	Set the MFT zone multiplier for the volume (this
  			setting is not persistent across mounts and can be
  			changed from mount to mount but cannot be changed on
  			remount).  Values of 1 to 4 are allowed, 1 being the
  			default.  The MFT zone multiplier determines how much
  			space is reserved for the MFT on the volume.  If all
  			other space is used up, then the MFT zone will be
  			shrunk dynamically, so this has no impact on the
  			amount of free space.  However, it can have an impact
  			on performance by affecting fragmentation of the MFT.
  			In general use the default.  If you have a lot of small
  			files then use a higher value.  The values have the
  			following meaning:
  			      Value	     MFT zone size (% of volume size)
  				1		12.5%
  				2		25%
  				3		37.5%
  				4		50%
  			Note this option is irrelevant for read-only mounts.
  
  
  Known bugs and (mis-)features
  =============================
  
  - The link count on each directory inode entry is set to 1, due to Linux not
    supporting directory hard links.  This may well confuse some user space
    applications, since the directory names will have the same inode numbers.
    This also speeds up ntfs_read_inode() immensely.  And we haven't found any
    problems with this approach so far.  If you find a problem with this, please
    let us know.
  
  
  Please send bug reports/comments/feedback/abuse to the Linux-NTFS development
  list at sourceforge: linux-ntfs-dev@lists.sourceforge.net
  
  
  Using NTFS volume and stripe sets
  =================================
  
  For support of volume and stripe sets, you can either use the kernel's
  Device-Mapper driver or the kernel's Software RAID / MD driver.  The former is
  the recommended one to use for linear raid.  But the latter is required for
  raid level 5.  For striping and mirroring, either driver should work fine.
  
  
  The Device-Mapper driver
  ------------------------
  
  You will need to create a table of the components of the volume/stripe set and
  how they fit together and load this into the kernel using the dmsetup utility
  (see man 8 dmsetup).
  
  Linear volume sets, i.e. linear raid, has been tested and works fine.  Even
  though untested, there is no reason why stripe sets, i.e. raid level 0, and
  mirrors, i.e. raid level 1 should not work, too.  Stripes with parity, i.e.
  raid level 5, unfortunately cannot work yet because the current version of the
  Device-Mapper driver does not support raid level 5.  You may be able to use the
  Software RAID / MD driver for raid level 5, see the next section for details.
  
  To create the table describing your volume you will need to know each of its
  components and their sizes in sectors, i.e. multiples of 512-byte blocks.
  
  For NT4 fault tolerant volumes you can obtain the sizes using fdisk.  So for
  example if one of your partitions is /dev/hda2 you would do:
  
  $ fdisk -ul /dev/hda
  
  Disk /dev/hda: 81.9 GB, 81964302336 bytes
  255 heads, 63 sectors/track, 9964 cylinders, total 160086528 sectors
  Units = sectors of 1 * 512 = 512 bytes
  
     Device Boot      Start         End      Blocks   Id  System
     /dev/hda1   *          63     4209029     2104483+  83  Linux
     /dev/hda2         4209030    37768814    16779892+  86  NTFS
     /dev/hda3        37768815    46170809     4200997+  83  Linux
  
  And you would know that /dev/hda2 has a size of 37768814 - 4209030 + 1 =
  33559785 sectors.
  
  For Win2k and later dynamic disks, you can for example use the ldminfo utility
  which is part of the Linux LDM tools (the latest version at the time of
  writing is linux-ldm-0.0.8.tar.bz2).  You can download it from:
169ccbd44   Adrian Bunk   NTFS: update home...
273
  	http://www.linux-ntfs.org/
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
  Simply extract the downloaded archive (tar xvjf linux-ldm-0.0.8.tar.bz2), go
  into it (cd linux-ldm-0.0.8) and change to the test directory (cd test).  You
  will find the precompiled (i386) ldminfo utility there.  NOTE: You will not be
  able to compile this yourself easily so use the binary version!
  
  Then you would use ldminfo in dump mode to obtain the necessary information:
  
  $ ./ldminfo --dump /dev/hda
  
  This would dump the LDM database found on /dev/hda which describes all of your
  dynamic disks and all the volumes on them.  At the bottom you will see the
  VOLUME DEFINITIONS section which is all you really need.  You may need to look
  further above to determine which of the disks in the volume definitions is
  which device in Linux.  Hint: Run ldminfo on each of your dynamic disks and
  look at the Disk Id close to the top of the output for each (the PRIVATE HEADER
  section).  You can then find these Disk Ids in the VBLK DATABASE section in the
  <Disk> components where you will get the LDM Name for the disk that is found in
  the VOLUME DEFINITIONS section.
  
  Note you will also need to enable the LDM driver in the Linux kernel.  If your
  distribution did not enable it, you will need to recompile the kernel with it
  enabled.  This will create the LDM partitions on each device at boot time.  You
  would then use those devices (for /dev/hda they would be /dev/hda1, 2, 3, etc)
  in the Device-Mapper table.
  
  You can also bypass using the LDM driver by using the main device (e.g.
  /dev/hda) and then using the offsets of the LDM partitions into this device as
  the "Start sector of device" when creating the table.  Once again ldminfo would
  give you the correct information to do this.
  
  Assuming you know all your devices and their sizes things are easy.
  
  For a linear raid the table would look like this (note all values are in
  512-byte sectors):
  
  --- cut here ---
  # Offset into	Size of this	Raid type	Device		Start sector
  # volume	device						of device
  0		1028161		linear		/dev/hda1	0
  1028161		3903762		linear		/dev/hdb2	0
  4931923		2103211		linear		/dev/hdc1	0
  --- cut here ---
  
  For a striped volume, i.e. raid level 0, you will need to know the chunk size
  you used when creating the volume.  Windows uses 64kiB as the default, so it
  will probably be this unless you changes the defaults when creating the array.
  
  For a raid level 0 the table would look like this (note all values are in
  512-byte sectors):
  
  --- cut here ---
  # Offset   Size	    Raid     Number   Chunk  1st        Start	2nd	  Start
  # into     of the   type     of	      size   Device	in	Device	  in
  # volume   volume	     stripes			device		  device
  0	   2056320  striped  2	      128    /dev/hda1	0	/dev/hdb1 0
  --- cut here ---
  
  If there are more than two devices, just add each of them to the end of the
  line.
  
  Finally, for a mirrored volume, i.e. raid level 1, the table would look like
  this (note all values are in 512-byte sectors):
  
  --- cut here ---
fa00e7e15   Matt LaPlante   Fix typos in /Doc...
338
  # Ofs Size   Raid   Log  Number Region Should Number Source  Start Target Start
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
339
340
341
342
343
344
345
346
347
348
349
  # in  of the type   type of log size   sync?  of     Device  in    Device in
  # vol volume		 params		     mirrors	     Device	  Device
  0    2056320 mirror core 2	16     nosync 2	   /dev/hda1 0   /dev/hdb1 0
  --- cut here ---
  
  If you are mirroring to multiple devices you can specify further targets at the
  end of the line.
  
  Note the "Should sync?" parameter "nosync" means that the two mirrors are
  already in sync which will be the case on a clean shutdown of Windows.  If the
  mirrors are not clean, you can specify the "sync" option instead of "nosync"
a982ac06b   Matt LaPlante   misc doc and kcon...
350
  and the Device-Mapper driver will then copy the entirety of the "Source Device"
25985edce   Lucas De Marchi   Fix common misspe...
351
  to the "Target Device" or if you specified multiple target devices to all of
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
  them.
  
  Once you have your table, save it in a file somewhere (e.g. /etc/ntfsvolume1),
  and hand it over to dmsetup to work with, like so:
  
  $ dmsetup create myvolume1 /etc/ntfsvolume1
  
  You can obviously replace "myvolume1" with whatever name you like.
  
  If it all worked, you will now have the device /dev/device-mapper/myvolume1
  which you can then just use as an argument to the mount command as usual to
  mount the ntfs volume.  For example:
  
  $ mount -t ntfs -o ro /dev/device-mapper/myvolume1 /mnt/myvol1
  
  (You need to create the directory /mnt/myvol1 first and of course you can use
  anything you like instead of /mnt/myvol1 as long as it is an existing
  directory.)
  
  It is advisable to do the mount read-only to see if the volume has been setup
  correctly to avoid the possibility of causing damage to the data on the ntfs
  volume.
  
  
  The Software RAID / MD driver
  -----------------------------
  
  An alternative to using the Device-Mapper driver is to use the kernel's
  Software RAID / MD driver.  For which you need to set up your /etc/raidtab
  appropriately (see man 5 raidtab).
  
  Linear volume sets, i.e. linear raid, as well as stripe sets, i.e. raid level
2fe0ae78c   Matt LaPlante   Fix typos in Docu...
384
  0, have been tested and work fine (though see section "Limitations when using
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
385
386
387
388
389
390
  the MD driver with NTFS volumes" especially if you want to use linear raid).
  Even though untested, there is no reason why mirrors, i.e. raid level 1, and
  stripes with parity, i.e. raid level 5, should not work, too.
  
  You have to use the "persistent-superblock 0" option for each raid-disk in the
  NTFS volume/stripe you are configuring in /etc/raidtab as the persistent
fff9289b2   Matt LaPlante   Fix typos in Docu...
391
  superblock used by the MD driver would damage the NTFS volume.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
  
  Windows by default uses a stripe chunk size of 64k, so you probably want the
  "chunk-size 64k" option for each raid-disk, too.
  
  For example, if you have a stripe set consisting of two partitions /dev/hda5
  and /dev/hdb1 your /etc/raidtab would look like this:
  
  raiddev /dev/md0
  	raid-level	0
  	nr-raid-disks	2
  	nr-spare-disks	0
  	persistent-superblock	0
  	chunk-size	64k
  	device		/dev/hda5
  	raid-disk	0
  	device		/dev/hdb1
bfab36e81   Anton Altaparmakov   NTFS: Fix a mount...
408
  	raid-disk	1
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
  
  For linear raid, just change the raid-level above to "raid-level linear", for
  mirrors, change it to "raid-level 1", and for stripe sets with parity, change
  it to "raid-level 5".
  
  Note for stripe sets with parity you will also need to tell the MD driver
  which parity algorithm to use by specifying the option "parity-algorithm
  which", where you need to replace "which" with the name of the algorithm to
  use (see man 5 raidtab for available algorithms) and you will have to try the
  different available algorithms until you find one that works.  Make sure you
  are working read-only when playing with this as you may damage your data
  otherwise.  If you find which algorithm works please let us know (email the
  linux-ntfs developers list linux-ntfs-dev@lists.sourceforge.net or drop in on
  IRC in channel #ntfs on the irc.freenode.net network) so we can update this
  documentation.
  
  Once the raidtab is setup, run for example raid0run -a to start all devices or
  raid0run /dev/md0 to start a particular md device, in this case /dev/md0.
  
  Then just use the mount command as usual to mount the ntfs volume using for
  example:	mount -t ntfs -o ro /dev/md0 /mnt/myntfsvolume
  
  It is advisable to do the mount read-only to see if the md volume has been
  setup correctly to avoid the possibility of causing damage to the data on the
  ntfs volume.
2fe0ae78c   Matt LaPlante   Fix typos in Docu...
434
  Limitations when using the Software RAID / MD driver
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
  -----------------------------------------------------
  
  Using the md driver will not work properly if any of your NTFS partitions have
  an odd number of sectors.  This is especially important for linear raid as all
  data after the first partition with an odd number of sectors will be offset by
  one or more sectors so if you mount such a partition with write support you
  will cause massive damage to the data on the volume which will only become
  apparent when you try to use the volume again under Windows.
  
  So when using linear raid, make sure that all your partitions have an even
  number of sectors BEFORE attempting to use it.  You have been warned!
  
  Even better is to simply use the Device-Mapper for linear raid and then you do
  not have this problem with odd numbers of sectors.
  
  
  ChangeLog
  =========
  
  Note, a technical ChangeLog aimed at kernel hackers is in fs/ntfs/ChangeLog.
2818ef50c   Anton Altaparmakov   NTFS: writev() fi...
455
456
457
  2.1.30:
  	- Fix writev() (it kept writing the first segment over and over again
  	  instead of moving onto subsequent segments).
af5eb745e   Anton Altaparmakov   NTFS: Fix invalid...
458
459
  	- Fix crash in ntfs_mft_record_alloc() when mapping the new extent mft
  	  record failed.
bfab36e81   Anton Altaparmakov   NTFS: Fix a mount...
460
461
  2.1.29:
  	- Fix a deadlock when mounting read-write.
8331191e5   Anton Altaparmakov   NTFS: 2.1.28 - Fi...
462
463
  2.1.28:
  	- Fix a deadlock.
e750d1c7c   Anton Altaparmakov   NTFS: 2.1.27 - Va...
464
465
466
467
468
  2.1.27:
  	- Implement page migration support so the kernel can move memory used
  	  by NTFS files and directories around for management purposes.
  	- Add support for writing to sparse files created with Windows XP SP2.
  	- Many minor improvements and bug fixes.
1cf3109ff   Anton Altaparmakov   NTFS: Do more det...
469
470
471
472
473
474
  2.1.26:
  	- Implement support for sector sizes above 512 bytes (up to the maximum
  	  supported by NTFS which is 4096 bytes).
  	- Enhance support for NTFS volumes which were supported by Windows but
  	  not by Linux due to invalid attribute list attribute flags.
  	- A few minor updates and bug fixes.
98b270362   Anton Altaparmakov   NTFS: The big ntf...
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
  2.1.25:
  	- Write support is now extended with write(2) being able to both
  	  overwrite existing file data and to extend files.  Also, if a write
  	  to a sparse region occurs, write(2) will fill in the hole.  Note,
  	  mmap(2) based writes still do not support writing into holes or
  	  writing beyond the initialized size.
  	- Write support has a new feature and that is that truncate(2) and
  	  open(2) with O_TRUNC are now implemented thus files can be both made
  	  smaller and larger.
  	- Note: Both write(2) and truncate(2)/open(2) with O_TRUNC still have
  	  limitations in that they
  	  - only provide limited support for highly fragmented files.
  	  - only work on regular, i.e. uncompressed and unencrypted files.
  	  - never create sparse files although this will change once directory
  	    operations are implemented.
  	- Lots of bug fixes and enhancements across the board.
7d333d6c7   Anton Altaparmakov   NTFS: 2.1.24 rele...
491
492
493
494
495
496
497
498
499
500
501
502
  2.1.24:
  	- Support journals ($LogFile) which have been modified by chkdsk.  This
  	  means users can boot into Windows after we marked the volume dirty.
  	  The Windows boot will run chkdsk and then reboot.  The user can then
  	  immediately boot into Linux rather than having to do a full Windows
  	  boot first before rebooting into Linux and we will recognize such a
  	  journal and empty it as it is clean by definition.
  	- Support journals ($LogFile) with only one restart page as well as
  	  journals with two different restart pages.  We sanity check both and
  	  either use the only sane one or the more recent one of the two in the
  	  case that both are valid.
  	- Lots of bug fixes and enhancements across the board.
af859a42d   Anton Altaparmakov   NTFS: Prepare for...
503
504
505
506
507
508
509
510
511
512
513
514
  2.1.23:
  	- Stamp the user space journal, aka transaction log, aka $UsnJrnl, if
  	  it is present and active thus telling Windows and applications using
  	  the transaction log that changes can have happened on the volume
  	  which are not recorded in $UsnJrnl.
  	- Detect the case when Windows has been hibernated (suspended to disk)
  	  and if this is the case do not allow (re)mounting read-write to
  	  prevent data corruption when you boot back into the suspended
  	  Windows session.
  	- Implement extension of resident files using the normal file write
  	  code paths, i.e. most very small files can be extended to be a little
  	  bit bigger but not by much.
ba6d2377c   Anton Altaparmakov   NTFS: Fix a nasty...
515
516
  	- Add new mount option "disable_sparse".  (See list of mount options
  	  above for details.)
af859a42d   Anton Altaparmakov   NTFS: Prepare for...
517
518
  	- Improve handling of ntfs volumes with errors and strange boot sectors
  	  in particular.
ba6d2377c   Anton Altaparmakov   NTFS: Fix a nasty...
519
520
  	- Fix various bugs including a nasty deadlock that appeared in recent
  	  kernels (around 2.6.11-2.6.12 timeframe).
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
  2.1.22:
  	- Improve handling of ntfs volumes with errors.
  	- Fix various bugs and race conditions.
  2.1.21:
  	- Fix several race conditions and various other bugs.
  	- Many internal cleanups, code reorganization, optimizations, and mft
  	  and index record writing code rewritten to fit in with the changes.
  	- Update Documentation/filesystems/ntfs.txt with instructions on how to
  	  use the Device-Mapper driver with NTFS ftdisk/LDM raid.
  2.1.20:
  	- Fix two stupid bugs introduced in 2.1.18 release.
  2.1.19:
  	- Minor bugfix in handling of the default upcase table.
  	- Many internal cleanups and improvements.  Many thanks to Linus
  	  Torvalds and Al Viro for the help and advice with the sparse
  	  annotations and cleanups.
  2.1.18:
  	- Fix scheduling latencies at mount time.  (Ingo Molnar)
  	- Fix endianness bug in a little traversed portion of the attribute
  	  lookup code.
  2.1.17:
  	- Fix bugs in mount time error code paths.
  2.1.16:
  	- Implement access time updates (including mtime and ctime).
  	- Implement fsync(2), fdatasync(2), and msync(2) system calls.
  	- Enable the readv(2) and writev(2) system calls.
  	- Enable access via the asynchronous io (aio) API by adding support for
  	  the aio_read(3) and aio_write(3) functions.
  2.1.15:
  	- Invalidate quotas when (re)mounting read-write.
  	  NOTE:  This now only leave user space journalling on the side.  (See
  	  note for version 2.1.13, below.)
  2.1.14:
  	- Fix an NFSd caused deadlock reported by several users.
  2.1.13:
  	- Implement writing of inodes (access time updates are not implemented
  	  yet so mounting with -o noatime,nodiratime is enforced).
  	- Enable writing out of resident files so you can now overwrite any
  	  uncompressed, unencrypted, nonsparse file as long as you do not
  	  change the file size.
  	- Add housekeeping of ntfs system files so that ntfsfix no longer needs
  	  to be run after writing to an NTFS volume.
  	  NOTE:  This still leaves quota tracking and user space journalling on
  	  the side but they should not cause data corruption.  In the worst
  	  case the charged quotas will be out of date ($Quota) and some
  	  userspace applications might get confused due to the out of date
  	  userspace journal ($UsnJrnl).
  2.1.12:
  	- Fix the second fix to the decompression engine from the 2.1.9 release
  	  and some further internals cleanups.
  2.1.11:
  	- Driver internal cleanups.
  2.1.10:
  	- Force read-only (re)mounting of volumes with unsupported volume
  	  flags and various cleanups.
  2.1.9:
  	- Fix two bugs in handling of corner cases in the decompression engine.
  2.1.8:
  	- Read the $MFT mirror and compare it to the $MFT and if the two do not
  	  match, force a read-only mount and do not allow read-write remounts.
  	- Read and parse the $LogFile journal and if it indicates that the
  	  volume was not shutdown cleanly, force a read-only mount and do not
  	  allow read-write remounts.  If the $LogFile indicates a clean
  	  shutdown and a read-write (re)mount is requested, empty $LogFile to
  	  ensure that Windows cannot cause data corruption by replaying a stale
  	  journal after Linux has written to the volume.
  	- Improve time handling so that the NTFS time is fully preserved when
  	  converted to kernel time and only up to 99 nano-seconds are lost when
  	  kernel time is converted to NTFS time.
  2.1.7:
  	- Enable NFS exporting of mounted NTFS volumes.
  2.1.6:
  	- Fix minor bug in handling of compressed directories that fixes the
  	  erroneous "du" and "stat" output people reported.
  2.1.5:
  	- Minor bug fix in attribute list attribute handling that fixes the
  	  I/O errors on "ls" of certain fragmented files found by at least two
  	  people running Windows XP.
  2.1.4:
  	- Minor update allowing compilation with all gcc versions (well, the
  	  ones the kernel can be compiled with anyway).
  2.1.3:
  	- Major bug fixes for reading files and volumes in corner cases which
  	  were being hit by Windows 2k/XP users.
  2.1.2:
5d3f083d8   Matt LaPlante   Fix typos in /Doc...
606
  	- Major bug fixes alleviating the hangs in statfs experienced by some
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
  	  users.
  2.1.1:
  	- Update handling of compressed files so people no longer get the
  	  frequently reported warning messages about initialized_size !=
  	  data_size.
  2.1.0:
  	- Add configuration option for developmental write support.
  	- Initial implementation of file overwriting. (Writes to resident files
  	  are not written out to disk yet, so avoid writing to files smaller
  	  than about 1kiB.)
  	- Intercept/abort changes in file size as they are not implemented yet.
  2.0.25:
  	- Minor bugfixes in error code paths and small cleanups.
  2.0.24:
  	- Small internal cleanups.
  	- Support for sendfile system call. (Christoph Hellwig)
  2.0.23:
  	- Massive internal locking changes to mft record locking. Fixes
  	  various race conditions and deadlocks.
  	- Fix ntfs over loopback for compressed files by adding an
  	  optimization barrier. (gcc was screwing up otherwise ?)
  	Thanks go to Christoph Hellwig for pointing these two out:
  	- Remove now unused function fs/ntfs/malloc.h::vmalloc_nofs().
  	- Fix ntfs_free() for ia64 and parisc.
  2.0.22:
  	- Small internal cleanups.
  2.0.21:
  	These only affect 32-bit architectures:
  	- Check for, and refuse to mount too large volumes (maximum is 2TiB).
  	- Check for, and refuse to open too large files and directories
  	  (maximum is 16TiB).
  2.0.20:
  	- Support non-resident directory index bitmaps. This means we now cope
  	  with huge directories without problems.
  	- Fix a page leak that manifested itself in some cases when reading
  	  directory contents.
  	- Internal cleanups.
  2.0.19:
  	- Fix race condition and improvements in block i/o interface.
  	- Optimization when reading compressed files.
  2.0.18:
  	- Fix race condition in reading of compressed files.
  2.0.17:
  	- Cleanups and optimizations.
  2.0.16:
  	- Fix stupid bug introduced in 2.0.15 in new attribute inode API.
  	- Big internal cleanup replacing the mftbmp access hacks by using the
  	  new attribute inode API instead.
  2.0.15:
  	- Bug fix in parsing of remount options.
  	- Internal changes implementing attribute (fake) inodes allowing all
  	  attribute i/o to go via the page cache and to use all the normal
  	  vfs/mm functionality.
  2.0.14:
  	- Internal changes improving run list merging code and minor locking
  	  change to not rely on BKL in ntfs_statfs().
  2.0.13:
  	- Internal changes towards using iget5_locked() in preparation for
  	  fake inodes and small cleanups to ntfs_volume structure.
  2.0.12:
  	- Internal cleanups in address space operations made possible by the
  	  changes introduced in the previous release.
  2.0.11:
  	- Internal updates and cleanups introducing the first step towards
  	  fake inode based attribute i/o.
  2.0.10:
  	- Microsoft says that the maximum number of inodes is 2^32 - 1. Update
  	  the driver accordingly to only use 32-bits to store inode numbers on
  	  32-bit architectures. This improves the speed of the driver a little.
  2.0.9:
  	- Change decompression engine to use a single buffer. This should not
  	  affect performance except perhaps on the most heavy i/o on SMP
  	  systems when accessing multiple compressed files from multiple
  	  devices simultaneously.
  	- Minor updates and cleanups.
  2.0.8:
  	- Remove now obsolete show_inodes and posix mount option(s).
  	- Restore show_sys_files mount option.
  	- Add new mount option case_sensitive, to determine if the driver
  	  treats file names as case sensitive or not.
  	- Mostly drop support for short file names (for backwards compatibility
  	  we only support accessing files via their short file name if one
  	  exists).
  	- Fix dcache aliasing issues wrt short/long file names.
  	- Cleanups and minor fixes.
  2.0.7:
  	- Just cleanups.
  2.0.6:
  	- Major bugfix to make compatible with other kernel changes. This fixes
  	  the hangs/oopses on umount.
  	- Locking cleanup in directory operations (remove BKL usage).
  2.0.5:
  	- Major buffer overflow bug fix.
  	- Minor cleanups and updates for kernel 2.5.12.
  2.0.4:
  	- Cleanups and updates for kernel 2.5.11.
  2.0.3:
  	- Small bug fixes, cleanups, and performance improvements.
  2.0.2:
  	- Use default fmask of 0177 so that files are no executable by default.
  	  If you want owner executable files, just use fmask=0077.
  	- Update for kernel 2.5.9 but preserve backwards compatibility with
  	  kernel 2.5.7.
  	- Minor bug fixes, cleanups, and updates.
  2.0.1:
  	- Minor updates, primarily set the executable bit by default on files
  	  so they can be executed.
  2.0.0:
  	- Started ChangeLog.