                     NDPNTFS (c) 2008 by nickk, froloff
                     __________________________________


CONTENTS
________

 1. Introduction
 2. Installation
 3. Usage
 4. Bugs And Limitations
 5. LICENSE
 6. Authors
 7. Changelog

1. Introduction
_______________

NDPNTFS is NTFS filesystem plugin for NetDrive for OS/2.
NDPNTFS allows to read/write access NTFS volumes and images in files (like 
VHD uncompressed images from VPC).

2. Installation
_______________

First you must have NetDrive for OS/2 installed and fully functioning and be 
in your %PATH% to use NDPNTFS plugin.

To install NDPNTFS unpacke the archive somewhere and run instpl.cmd. This will
copy all nessessary files into NetDrive's ndplugs directory and load plugin. 

If your ndplugs is not listed in your LIBPATH, either copy ntfs.dll from 
ndplugs somewhere within your LIBPATH or add ndplugs in your LIBPATH (this will
require system reboot) and then restart ndctl.exe manually.

3. Usage
________

The NDPNTFS plugin usage is common to any other NetDrive plugin usage. Refer to
NetDrive documentation for the common knowledge and ndpntfs.hlp for the 
NDPNTFS specific mounting parameters.

If you use filenames on NTFS volume in your national characters and do not see
them the proper way under ndpntfs, adjust your %LANG% enviroment variable 
(either put it in CONFIG.SYS and reboot, or set it in the same session where
you start NDCTL) like :

SET LANG=ru_RU.CP866

where ru_RU is a designator to your country. You dont need to be strict there.
CP866 - your system codepage.

A couple of guidelines:

 a. If you fear any data loss, try to mount your volume in read-only mode (see 
NetDrive documetation for details). This way NDPNTFS wont make any changes to 
your NTFS volume. Although it will set dirty flag on the volume anyway, which
will be cleared upon dismount (see clause b).
 b. Dont forget to dismount all mounted NTFS volumes prior to reboot. This way
NDPNTFS will correctly close the volumes, otherwise on next boot MS Windows 
might start disk checking.

4. Bugs And Limitations
_______________________

Known bugs are:

  a. moving/renaming files across the NTFS volume does not work currently. 
     Use combination of copy and delete instead of move while waiting this 
     bug to be fixed ;)

If you found smth goes wrong and want to report the issue, please generate 
first the debug log. To do so stop ndctl.exe, copy ndpntfs.dll.debug over 
the ndpntfs.dll within 'plugins'  directory of NetDrive and start ndctl.exe
again. Then mount your NTFS resource, repeat the problem, take the ntfslog from
the root directory of the drive where NetDrive is installed and send it with
your bugreport.

5. License
__________

Use this software for free.

And, of course:

THIS SOFTWARE IS PROVIDED BY THE AUTHOR OR CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, SEX OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE, SHIT ON CARPET OR OTHERWISE) 
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE.

6. Authors
__________

 ndpntfs.dll made by nickk, dev.nul@mail.ru
 ntfs.dll made by froloff, froloff@os2.ru, based on linux code samples.

 Feel free to send authors bugreports and suggestions about this software, but 
 first, please, make sure that your email provider accepts emails from our mail 
 domains. Or you may never receive the response.

