CDRecord/2 V2.0 final (CDRTools-2.0) 17.01.2003
------------------------------------------------

This is the binary distribution of the cdrtools package for OS/2
available at

http://www.fokus.fhg.de/usr/schilling/cdrecord.html
http://www.fokus.gmd.de/nthp/employees/schilling/cdrecord.html

The package has the full feature set of the original program
written by J. Schilling. There're no differences to cdrtools on
other systems like Solaris, BSD, Linux etc. or limitations in the
OS/2 version.

You may find the OS/2 homepage of cdrecord/cdrtools here:

http://www.geocities.com/SiliconValley/Sector/5785/
http://www.os2world.com/cdwriting

The cdrtools package is released under the Gnu Public License
so full source is available. See the file COPYING for more
info.


Remarks
-------

I didn't test the remote scsi support (rscsi.exe). It may work
or may not work. Same goes for discT@2 because I simply don't
own such a device. If you want to donate one feel free to do
so...

The scgcheck program only works with the ASPIROUT.SYS beta 6 or
higher by Paul Ratcliffe. See installation section for more info.

There's a special version of cdda2wav included which works with
the Traxdata CDRW2260EL PRO writer. This writer returns the following
data on cdrecord -scanbus:

      'SCSI-CD ' 'ReWritable-2x2x6' '2.00' Removable CD-ROM

If you own this writer use the executable in the trax directory.

WRT to UnixOS/2 (see http://www.unixos2.org and 
http://www.os2ports.com):

The source package itself is UnixOS/2 'compliant'.
If you have such an environment just type 'make' and 'make install'
and you're done. There's one minor glitch in the install script, though.
It doesn't copy the *.exe files but the empty files without extension
created during compilation. This will hopefully be fixed in the
future.


Installation
------------

You need the ASPI-router:

ftp://ftp.leo.org/pub/comp/os/os2/leo/drivers/misc/aspir101.zip
http://hobbes.nmsu.edu

or an improved one (c) Paul Ratcliffe:

http://home.clara.net/orac/os2.htm

For your convenience I included this driver (beta 6) in the
distribution. Note that this driver IS NOT RELEASED UNDER THE
TERMS OF THE GPL!
The driver may be found in the subdirectory 'aspirout'.

and the EMX runtime libraries 0.9d fix 4:

ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/emxrt.zip
http://hobbes.nmsu.edu

If you use an ATAPI writer you need also DaniAtapi.flt
and Danis506.add. Get both from Hobbes:

http://hobbes.nmsu.edu/pub/os2/system/drivers/storage/


1a. Unzip the Aspi-Router distribution in a directory of your choice. Add the following lines to your
    config.sys file.

           BASEDEV=OS2ASPI.DMD /ALL

    A similar line may be already present in your config.sys depending on the software you've got installed.

           DEVICE=x:\os2\boot\aspirout.sys

   Change the path to aspirout.sys as necessary.

   Note: The switch /ALL must be present or CDRecord/2 will not work!

1b. If you have an Atapi Cd-writer add - after unzipping the files to x:\OS2\BOOT\ - 
    to your config.sys

           BASEDEV=DANIS506.ADD

           BASEDEV=DANIATAPI.FLT

           BASEDEV=OS2ASPI.DMD /ALL

    A similar line may already be present in your config.sys depending on the software you've got installed.

           DEVICE=x:\OS2\BOOT\ASPIROUT.SYS

    Change the path to aspirout.sys as necessary.

    Note: The switch /ALL must be present or CDRecord/2 will not work!

    Note: Adding switches to DANIS506.ADD is normally NOT necessary. In contrary 
    it can cause several faults.

    REM or delete from your config.sys: 

           BASEDEV=IBM1S506.ADD

           BASEDEV=IBMATAPI.FLT

           BASEDEV=IBMIDECD.FLT

    If one of these drivers is in your config.sys CD-Record refuses to work.

1.c: If you have an Mix of SCSI and Atapi (e.g. Scsi CD-Player, Atapi CD-Recorder) 
     use the Atapi settings.

2:  Put the EMX runtime libraries into your LIBPATH following the instructions
    contained in the distribution.

3:  Reboot. Thats necessary because OS/2 has to load changed or added drivers.


The command EMXREV.EXE should give you the following:

EMX : revision = 61
EMXIO : revision = 60
EMXLIBC : revision = 63
EMXLIBCM : revision = 64
EMXLIBCS : revision = 64
EMXWRAP : revision = 60

If not the libraries are not installed properly.

The command CDRECORD.EXE -scanbus should give you a listing
of all your devices on the SCSI bus. If you've installed the
DANIATAP.FLT you should also see your ATAPI devices on the
IDE bus.
If CDRecord complains about not able to open the ASPI-Router
check the installation of ASPIROUT.SYS.


How to use it
-----------
Read the files in the doc directory and cdrecordfaq.htm.

The programs in the cdrtools package are command line tools
with a unix like syntax. You have to accept that! This
kind of documentation is all you get.
The directories *_docs contain additional ReadMe files for
the various programs.

If you want to have a point and click environment get
Audio/Data-CD-Creator from

http://www.os2world.com/cdwriting
http://www.geocities.com/SiliconValley/Sector/5785/

It's a WPS integrated CD-writing solution to burn CDs
using drag and drop. An extensive tutorials gives advice on
installing and using.


How to compile
--------------

Get the source tarball from

http://www.fokus.fhg.de/usr/schilling/cdrecord.html
http://www.fokus.gmd.de/nthp/employees/schilling/cdrecord.html

the EMX development environment and the usual *nix tools
from http://www.os2ports.com:

fileutls.zip
sh-utils-2.0.zip
gawk-3_1_0-bin.zip
gettext-0_10_39-r2-bin.zip
pdksh-5.2.14-bin-2.zip
libregex-0_12-bin.zip
make-3_79_2a1-bin.zip
textutils-2_0-bin.zip
sed-3.02
m4-1_4-r2
grep-2_4_2-r2-bin.zip
texinfo.zip
ksh
(and maybe some more)

Type make and you're done.

Be aware that the archive contains symlinks which are often not properly
handled on OS/2. You may have to copy some files to the proper location
of the source tree.


Contacting the maintainer of the port
-------------------------------------

Chris Wohlgemuth

chris [dot] wohlgemuth [at] cityweb [dot] de

http://www.os2world.com/cdwriting
http://www.geocities.com/SiliconValley/Sector/5785/

