+
+Project Home
+------------
+
+http://www.jankratochvil.net/project/captive/
+
+
+Overview
+--------
+
+'captive' is the base package. It contains debugging 'captive-cmdline' client.
+'captive-lufs' permits mounting NTFS as regular filesystem. It needs 'lufs'.
+'lufs' is a daemon to enable userland process to provide filesystem functions.
+
+Any errors from 'captive-lufs' are written to '/var/log/messages'.
+
+Needed drivers (at least ntoskrnl.exe+ntfs.sys) must be in '/var/lib/captive'.
+
+'captive' package creates 'captive' user and 'captive' group on your system.
+
+
+Drivers Availability
+--------------------
+
+All the source packages involved in this project are GNU General Public License
+2.0 (GPL-2.0) compatible (see the file "AUTHORS" for details). The purpose of
+this project is to run the original Microsoft Windows drivers to get the best
+filesystem compatibility and safety ever reachable. This is the method known
+most by the Wine http://www.winehq.com/ project. Required driver files:
+
+ ntoskrnl.exe - Windows NT kernel; required for ANY use of this project.
+ ntfs.sys - NTFS filesystem driver; required to access NTFS disk drives.
+
+Run captive-install-acquire(1) installer for proper guided steps.
+
+
+Packaged Installations
+----------------------
+
+Case #1 - All packages installed:
+ captive-install - Acquire needed MS-Windows drivers and setup /etc/fstab.
+ captive-lufs - Linux Userland File System module to be native filesystem.
+ captive - Base package of this project.
+ lufs >=0.9.6-1captive - Linux Userland File System engine for captive-lufs.
+ gnome-vfs-httpcaptive - Gnome-VFS httpcaptive:// method for captive-install.
+ ntfsprogs >=200309071734 - Readonly NTFS to get drivers by captive-install.
+ ntfsprogs-gnomevfs - Gnome-VFS readonly NTFS access used by captive-install.
+
+ Required W32 drivers were automatically found if Microsoft Windows XP is
+ installed on any (mounted or unmounted) NTFS or (mounted) FAT partition.
+ You may want to run captive-install-acquire(1) to check the drivers state
+ and possibly update them. Installer uses X Windows or console automatically.
+
+ Any NTFS disk partitions were automatically added to /etc/fstab.
+ These partitions are now available for mount by
+ mount /mnt/captive-DISK_LABEL
+ such as (if the label is empty)
+ mount /mnt/captive-
+
+Case #2 - Packages without installer:
+ captive-lufs - Linux Userland File System module to be native filesystem.
+ captive - Base package of this project.
+ lufs >=0.9.6-1captive - Linux Userland File System engine for captive-lufs.
+
+ You must obtain W32 drivers - at least "ntoskrnl.exe" and "ntfs.sys".
+ They should be stored in '/var/lib/captive' directory (lowercased filenames).
+ These driver must be from Microsoft Windows XP;
+ Service Pack 1 Check Build U.S. preferred:
+ http://www.microsoft.com/WindowsXP/pro/downloads/servicepacks/sp1/checkedbuild.asp
+
+ NTFS disk drives can be mounted by
+ mkdir /mnt/drive-c
+ mount -t captive-ntfs /dev/hda1 /mnt/drive-c
+
+Case #3 - Command-line client (or Gnome-VFS) access only:
+ captive - Base package of this project.
+
+ You must obtain W32 drivers - at least "ntoskrnl.exe" and "ntfs.sys".
+ They should be stored in '/var/lib/captive' directory (lowercased filenames).
+ These driver must be from Microsoft Windows XP;
+ Service Pack 1 Check Build U.S. preferred.
+ http://www.microsoft.com/WindowsXP/pro/downloads/servicepacks/sp1/checkedbuild.asp
+
+ NTFS disk drives can be accessed by:
+ captive-cmdline --load-module=/tmp/ntoskrnl.exe --filesystem=/tmp/ntfs.sys \
+ --sandbox-server=/usr/sbin/captive-sandbox-server \
+ --bug-pathname=/tmp/captive-bug-%FT%T.captivebug.xml.gz \
+ --disk --rw /dev/hda1
+ (Backslash end-of-line characters '\' to be omitted for line continuation.)
+
+ In the case of 'sandbox' invocation error you can also run directly but
+ read/write (--rw) mode is definitely discouraged in such case:
+ captive-cmdline --load-module=/tmp/ntoskrnl.exe --filesystem=/tmp/ntfs.sys \
+ --disk --rw /dev/hda1
+ (Backslash end-of-line characters '\' to be omitted for line continuation.)
+
+ Gnome-VFS aware applications can access NTFS disk drives by:
+ gnomevfs-info file:///dev/hda1#captive-ntfs:/config.sys
+ gnomevfs-copy file:///dev/hda1#captive-ntfs:/config.sys /tmp/
+ You can replace 'captive-ntfs' by other supported methods, see:
+ /etc/gnome-vfs-2.0/modules/captive.conf
+
+
+Source Installations
+--------------------
+
+Case #1 - All packages installed:
+ ./configure --enable-lufs --enable-install-pkg
+Case #2 - Packages without installer:
+ ./configure --enable-lufs
+Case #3 - Command-line client (or Gnome-VFS) access only:
+ ./configure
+'configure' will compile 'Case #1' or 'Case #2' automatically if possible
+when run with no arguments. For generic instructions see the file 'INSTALL'
+otherwise run:
+ ./configure --help
+
+Compile by:
+ make
+
+Now you have './src/client/cmdline/captive-cmdline' available for testing.
+Later you may invoke standard:
+ make install
+
+Manual addition of user and group 'captive' is required for '--sandbox-server':
+ useradd captive
+
+
+Bug Reporting