blob: 12328b3ce2cfb2e27bbc8e8e81c396e12cc72b3e
| 1 | |
| 2 | INTRODUCTION |
| 3 | ============ |
| 4 | |
| 5 | The NTFS-3G driver is an open source, freely available read/write NTFS driver |
| 6 | for Linux, FreeBSD, Mac OS X, NetBSD, OpenSolaris, QNX and Haiku. It provides |
| 7 | safe and fast handling of the Windows XP, Windows Server 2003, Windows 2000, |
| 8 | Windows Vista, Windows Server 2008 and Windows 7 file systems. |
| 9 | |
| 10 | The purpose of the project is to develop, quality assurance and support a |
| 11 | trustable, featureful and high performance solution for hardware platforms |
| 12 | and operating systems whose users need to reliably interoperate with NTFS. |
| 13 | Besides this practical goal, the project also aims to explore the limits |
| 14 | of the hybrid, kernel/user space filesystem driver approach, performance, |
| 15 | reliability and feature richness per invested effort wise. |
| 16 | |
| 17 | Besides the common file system features, NTFS-3G has support for file |
| 18 | ownership and permissions, POSIX ACLs, junction points, extended attributes |
| 19 | and creating compressed files. Parameter files in the directory .NTFS-3G may |
| 20 | be required to enable them, please get the instructions from |
| 21 | |
| 22 | http://www.tuxera.com/community/ntfs-3g-advanced/ |
| 23 | |
| 24 | News, support answers, problem submission instructions, support and discussion |
| 25 | forums, performance numbers and other information are available on the project |
| 26 | web site at |
| 27 | |
| 28 | http://www.tuxera.com/community/ |
| 29 | |
| 30 | |
| 31 | QUICK INSTALLATION |
| 32 | ================== |
| 33 | |
| 34 | Linux: Make sure you have the basic development tools and the kernel includes |
| 35 | the FUSE kernel module. Then unpack the source tarball and type: |
| 36 | |
| 37 | ./configure |
| 38 | make |
| 39 | make install # or 'sudo make install' if you aren't root. |
| 40 | |
| 41 | Please note that NTFS-3G doesn't require the FUSE user space package. |
| 42 | |
| 43 | Non-Linux: Please see |
| 44 | |
| 45 | http://www.tuxera.com/community/ntfs-3g-download/ |
| 46 | |
| 47 | for OS specific installation and source packages. |
| 48 | |
| 49 | |
| 50 | USAGE |
| 51 | ===== |
| 52 | |
| 53 | If there was no error during installation then the NTFS volume can be |
| 54 | read-write mounted for everybody the following way as the root user |
| 55 | (unmount the volume if it was already mounted, and replace /dev/sda1 |
| 56 | and /mnt/windows, if needed): |
| 57 | |
| 58 | mount -t ntfs-3g /dev/sda1 /mnt/windows |
| 59 | or |
| 60 | ntfs-3g /dev/sda1 /mnt/windows |
| 61 | |
| 62 | Please see the ntfs-3g manual page for more options and examples. |
| 63 | |
| 64 | You can also make NTFS to be mounted during boot by putting the below |
| 65 | line at the END(!) of the /etc/fstab file: |
| 66 | |
| 67 | /dev/sda1 /mnt/windows ntfs-3g defaults 0 0 |
| 68 | |
| 69 |