`cdwrite' is a program to write cds, using libscsi for direct device
access.  It supports both HP Surestore 4020i and simmilar (e.g.,
Philips CDD2000), as well as Yamaha cdr-100 and cdr-102.  However, it
has been tested only on an hp-4020i.

It supports `emulated write', which means that the cd writer does the
whole process with it's write laser turned off.  Use this option until
you are confident both you and the hardware know what you are doing.

This program can be used to write audio and data disks, also with
multiple tracks and/or sessions.

`cdflush' can be used to flush the write buffer, if a write session
aborts, and the writer is in an inconsistent state.


`cdda' reads digital audio data from cd drives.  It currently supports
hp 4020i and Toshiba cd-roms.


Copyright, disclaimer & licence:
================================

  Copyright (C) 1996 Dieter Baron and Armin Obersteiner

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


cdwrite Examples:
=================

Write data cd (in emulation mode):
	cdwrite -cveCF -i ISOIMAGE
Write data cd (real write):
	cdwrite -cvwCF -i ISOIMAGE
This closes the session (no more tracks possible) and the disk (no
more sessions possible).

Write data cd (new session possible):
	cdwrite -cvwF -i ISOIMAGE

Write audio cd (closing disk):
	cdwrite -cvwFC -a TRACKS ...
Audio data are 16 bits 2 channel, 44.1kHz, big endian.

Note that an audio track should be a multiple of 2352 bytes in length,
otherwise you might hear a crackle at the end of the track.

WARNING: the Toshiba drives send little endian data, so you have to swap
bytes.


cdda Examples:
==============

Copy first track into TRACKFILE:
	cdda -v CDROM TRACKFILE 1 

Copy 30 seconds of second track into TRACKFILE
	cdda -v CDROM TRACKFILE 2 0:30


Amiga Specific Notes:
=====================

This is the first *free* cdwrite program for AmigaDOS. For the source
code have a look at the end of this file.

It works on my Amiga 2000-7MB (A2630-2MB), GVP Series II, HP 4020i.
Therefore it *should* work on similar configurations.  I think it may
be possible to write cd's with ANY Amiga (at least single speed).

Kickstart 2.04+ is required, but it's possible to downgrade libscsi to
1.3.  (I've no need for that.)  You further NEED 'ixemul.library'.
(Version 43.1 would be the best.)

WARNING: Because of the stupid I/O handling of the Amiga Shell, don't
touch any key during writing -- this stops the write action
immediately!!!!

Use `cdwrite -h' and `cdda -h' to get a list of available options,
especially the option to specify which SCSI device to use.

See also the section ``Notes on AmigaDOS'' in the libscsi
documentation.

Note also that we experienced some difficulties with `cdda' (SCSI bus
hang), but that might well be the controller's fault.


Contact, Source and Binaries: 
=============================

Send bug reports, comments, and additions to
     `bug-libscsi@giga.or.at'.

The latest version of the SOURCE can be found on 
        ftp.giga.or.at, /pub/nih/cdtools.tar.gz
or
        http://www.giga.or.at/pub/nih/cdtools.tar.gz

The latest version of the Amiga BINARIES can be found on 
	ftp.giga.or.at in /pub/nih/amiga/cdtools-bin.lha
or
	http://www.giga.or.at/pub/nih/amiga/cdtools-bin.lha