                      NDPUDF (c) 2008 by nickk, froloff
                      _________________________________


CONTENTS
________

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

1. Introduction
_______________

NDPUDF is a UDF filesystem plugin for NetDrive for OS/2. It's fully compatible
with OS/2, Windows and Unix (OSTA UDF2.0) realisations and may be used as direct
replacement of the UDF.IFS.

2. Installation
_______________

First, you must have NetDrive for OS/2 installed and fully functional. 
Please check that Netdrive directory is included in your %PATH%.

Second, you must have proper installation of device driver set to access your
writer device. NDPUDF supports two schemes of device access:

 a. Access through OEM version of OS2CDROM.DMD (enclosed, made by froloff).
 b. Access through ASPI routing driver - ASPINKK.SYS (made by nicck) or 
    ASPIROUT.SYS (by Paul Ratcliffe).

Your config.sys should contain the following lines to ensure the proper
work of NDPUDF:

To work via ASPINKK.SYS or ASPIROUT.SYS:

  For SCSI systems:

REM The driver for your SCSI adapter
BASEDEV=SYM_HI.ADD
REM OS/2 ASPI Layer driver
BASEDEV=OS2ASPI.DMD /ALL
REM ASPI routing driver
DEVICE=D:\OS2\BOOT\ASPINKK.SYS
 or/and
DEVICE=D:\OS2\BOOT\ASPIROUT.SYS

  For IDE systems:

BASEDEV=DANIS506.ADD
BASEDEV=DANIATAPI.FLT
BASEDEV=OS2ASPI.DMD /ALL
DEVICE=D:\OS2\BOOT\ASPINKK.SYS
 or/and
DEVICE=D:\OS2\BOOT\ASPIROUT.SYS

To work via OS2CDROM your config.sys must contain:

DEVICE=D:\OS2\BOOT\OS2CDROM.DMD


You can have all the drivers mentioned above installed and working
simultaneously.

To install NDPUDF, unpack the archive in temporary directory and run instpl.cmd.
All nessessary files  will be copied during installation into NetDrive's ndplugs
directory, plugin will be loaded and added to the plugin list. 

If your ndplugs is not listed in your LIBPATH, either copy udf.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 NDPUDF plugin usage is similar to any other NetDrive plugins. Refer to
NetDrive documentation for the common knowledge and ndpudf.hlp for the 
NDPUDF specific mounting parameters.

A few guidelines:

 a. For safety reasons, burner tray will be locked after starting plugin 
    operations. It will be unlocked, when you unmount volume (see clause c).
 b. If you fear any data loss, try to mount your volume in read-only mode (see 
NetDrive documetation for details). This way, NDPUDF won't make any changes on 
your UDF volume. Although it will set dirty flag on the volume anyway, which
will be cleared upon unmount (see clause c).
 c. Don't forget to unmount all mounted UDF volumes prior to reboot. This way
NDPUDF will correctly close the volumes, otherwise some data, kept in cache, may
be lost.
 d. To create new UDF filesystem on the blank disk you should do the following
steps:
    - format you media (in packet mode in case of CD-RW/DVD-RW) either with 
      enclosed mmcformat.exe or dvddao.exe --format.
    - create new filesystem with enclosed udfformat.exe.

4. Bugs And Limitations
_______________________

Known bugs are:

   a. You know one? Report please ;)

Using UDF.IFS in write mode does not work with enclosed OS2CDROM.DMD. This is 
not the NDPUDF bug, it's the OS2CDROM.DMD OEM build issue, thus it's bases on 
older DDK sources. But, since NDPUDF plugin completely replaces and even exceedes
UDF.IFS functionality you will never need to use UDF.IFS (probably ;) ).

If you found smth goes wrong and want to report the issue, please generate 
first the debug log. To do this, so stop ndctl.exe, copy NDPUDF.dll.debug over 
the NDPUDF.dll within 'plugins'  directory of NetDrive and start ndctl.exe
again. Then mount your UDF resource, repeat the steps causing the problem, take 
the udflog 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
__________

 NDPUDF.dll made by nickk, dev.nul@mail.ru
 udf.dll made by nickk & froloff, froloff@os2.ru, based on NetBSD 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.

