1 files changed, 630 insertions, 0 deletions

diff --git a/Documentation/filesystems/ntfs.txt b/Documentation/filesystems/ntfs.txt
new file mode 100644
index 000000000000..f89b440fad1d
--- /dev/null
+++ b/Documentation/filesystems/ntfs.txt
@@ -0,0 +1,630 @@
+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
+  - Limitiations when using the MD driver
+- ChangeLog
+
+
+Overview
+========
+
+Linux-NTFS comes with a number of user-space programs known as ntfsprogs.
+These include mkntfs, a full-featured ntfs file system format utility,
+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
+at http://linux-ntfs.sourceforge.net/
+
+The web site has a lot of additional information, such as a comprehensive
+FAQ, documentation on the NTFS on-disk format, informaiton on the Linux-NTFS
+userspace utilities, etc.
+
+
+Features
+========
+
+- This is a complete rewrite of the NTFS driver that used to be in the kernel.
+  This new driver implements NTFS read support and is functionally equivalent
+  to the old ntfs driver.
+- 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).
+
+
+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.
+
+errors=opt              What to do when critical file system errors are found.
+                        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:
+        http://linux-ntfs.sourceforge.net/downloads.html
+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 ---
+# Ofs Size   Raid   Log  Number Region Should Number Source  Start Taget  Start
+# 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"
+and the Device-Mapper driver will then copy the entirey of the "Source Device"
+to the "Target Device" or if you specified multipled target devices to all of
+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
+0, have been tested and work fine (though see section "Limitiations when using
+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
+superblock used by the MD driver would damange the NTFS volume.
+
+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
+        raid-disl       1
+
+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.
+
+
+Limitiations when using the Software RAID / MD driver
+-----------------------------------------------------
+
+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.
+
+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:
+        - Major bug fixes aleviating the hangs in statfs experienced by some
+          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.
+