2005-04-16 22:20:36 +00:00
|
|
|
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
|
2006-10-03 20:50:39 +00:00
|
|
|
- Limitations when using the MD driver
|
2005-04-16 22:20:36 +00:00
|
|
|
- ChangeLog
|
|
|
|
|
|
|
|
|
|
|
|
Overview
|
|
|
|
========
|
|
|
|
|
|
|
|
Linux-NTFS comes with a number of user-space programs known as ntfsprogs.
|
2005-02-03 12:02:56 +00:00
|
|
|
These include mkntfs, a full-featured ntfs filesystem format utility,
|
2005-04-16 22:20:36 +00:00
|
|
|
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
|
2008-09-02 21:35:37 +00:00
|
|
|
at http://www.linux-ntfs.org/
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
The web site has a lot of additional information, such as a comprehensive
|
2006-10-03 20:50:39 +00:00
|
|
|
FAQ, documentation on the NTFS on-disk format, information on the Linux-NTFS
|
2005-04-16 22:20:36 +00:00
|
|
|
userspace utilities, etc.
|
|
|
|
|
|
|
|
|
|
|
|
Features
|
|
|
|
========
|
|
|
|
|
2005-10-11 14:40:40 +00:00
|
|
|
- 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.
|
2005-04-16 22:20:36 +00:00
|
|
|
- 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).
|
2005-10-11 14:40:40 +00:00
|
|
|
- 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.
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
2005-02-03 12:02:56 +00:00
|
|
|
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.
|
2005-04-16 22:20:36 +00:00
|
|
|
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:
|
2008-09-02 21:35:37 +00:00
|
|
|
http://www.linux-ntfs.org/
|
2005-04-16 22:20:36 +00:00
|
|
|
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 ---
|
2006-11-30 03:55:36 +00:00
|
|
|
# Ofs Size Raid Log Number Region Should Number Source Start Target Start
|
2005-04-16 22:20:36 +00:00
|
|
|
# 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"
|
2007-05-09 05:35:06 +00:00
|
|
|
and the Device-Mapper driver will then copy the entirety of the "Source Device"
|
2005-04-16 22:20:36 +00:00
|
|
|
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
|
2006-10-03 20:50:39 +00:00
|
|
|
0, have been tested and work fine (though see section "Limitations when using
|
2005-04-16 22:20:36 +00:00
|
|
|
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
|
2006-10-03 20:47:42 +00:00
|
|
|
superblock used by the MD driver would damage the NTFS volume.
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
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
|
2007-10-12 08:37:15 +00:00
|
|
|
raid-disk 1
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
2006-10-03 20:50:39 +00:00
|
|
|
Limitations when using the Software RAID / MD driver
|
2005-04-16 22:20:36 +00:00
|
|
|
-----------------------------------------------------
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
2011-01-12 10:34:35 +00:00
|
|
|
2.1.30:
|
|
|
|
- Fix writev() (it kept writing the first segment over and over again
|
|
|
|
instead of moving onto subsequent segments).
|
2011-01-28 20:45:28 +00:00
|
|
|
- Fix crash in ntfs_mft_record_alloc() when mapping the new extent mft
|
|
|
|
record failed.
|
2007-10-12 08:37:15 +00:00
|
|
|
2.1.29:
|
|
|
|
- Fix a deadlock when mounting read-write.
|
2007-01-18 09:42:48 +00:00
|
|
|
2.1.28:
|
|
|
|
- Fix a deadlock.
|
2006-03-23 17:04:12 +00:00
|
|
|
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.
|
2006-02-24 10:48:14 +00:00
|
|
|
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.
|
2005-10-11 14:40:40 +00:00
|
|
|
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.
|
2005-09-08 22:01:16 +00:00
|
|
|
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.
|
2005-06-25 20:07:27 +00:00
|
|
|
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.
|
2005-06-26 21:12:02 +00:00
|
|
|
- Add new mount option "disable_sparse". (See list of mount options
|
|
|
|
above for details.)
|
2005-06-25 20:07:27 +00:00
|
|
|
- Improve handling of ntfs volumes with errors and strange boot sectors
|
|
|
|
in particular.
|
2005-06-26 21:12:02 +00:00
|
|
|
- Fix various bugs including a nasty deadlock that appeared in recent
|
|
|
|
kernels (around 2.6.11-2.6.12 timeframe).
|
2005-04-16 22:20:36 +00:00
|
|
|
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:
|
2006-11-30 04:21:10 +00:00
|
|
|
- Major bug fixes alleviating the hangs in statfs experienced by some
|
2005-04-16 22:20:36 +00:00
|
|
|
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.
|
|
|
|
|