--------------------------------------------------------------
|                         CDW-Tools 0.93                     |
--------------------------------------------------------------
| 20.01.96 T.Niederreiter                                    |
|          (p7003ad@sunmail.lrz-muenchen.de)                 |
--------------------------------------------------------------

Table of Contents:
-----------------

0) DISCLAIMER
1) Introduction
2) Hardware-Requirements
3) Software-Requirements
4) Knowledge-Requirements
5) Installation
6) Defaultsettings in cdwtools.sh
7) Program-Documentation
  7.1 The Main-Menu
  7.2 Copy-Data-CD
  7.3 Copy Audio- or Mixed-Mode-CD
  7.4 Master Data-CD
8) Useful Information
9) Bugs
10) Todo
11) Credits
12) Conclusion

 
0) DISCLAIMER
-------------

I am not responsible for any damage to your hardware or software 
caused by this program.
The use of the program can be dangerous. If you don't know what you
are doing, don't do it. 
I am also not responsible for any misuse of the program by creating
copies of CDs without permission. 

                       ----------------------
                        USE IT AT OWN RISK !
                       ----------------------

1) Introduction
---------------

This are the CD-Writer-Tools. It is a frontend for some CD
related programs like "cdwrite", "mkisofs" and "cdda2cdr".
The intention is that a normal user can work with the cdwriter,
without long studying of the complex commandline-options
of these programs.

You can copy ISO9660-CDs, Non-ISO9660-CDs (like Mac- or Sun-CDs),
Mixed-Mode-CDs and Audio-CDs.
You can master your own Data-CDs and create your own Audio-CDs with
your favorite track-selection.


2) Hardware-Requirements
------------------------

To use this program you need the following hardware:

- A CD-Writer supported by the program "cdwrite".                                
  In the newest version 2.0 there is support for Philips, Yamaha and 
  HP-Writers. Exact documention for that is in the cdwrite-manpage.
  If you have another writer you have bad luck, until there is support
  for it.
 
- A Harddrive with at least one 700 MB partition for storing         
  disk-images. If you want master your own CD's you need also     
  the space for your data in addition to that partition.

  I recommend a big (2 GB and above), fast SCSI-Harddrive. Create as 
  many 700 MB partitions as you may need. 

- A SCSI-Controller supported by linux to connect the CD-Writer, the
  harddrive and the CD-ROM.

- Version 0.92 still needed an extra CD-Rom to read audio. Now you don't
  need an CD-Rom anymore. All CD-Writers are supported with data and
  audio read!

3) Software-Requirements
------------------------

This program is mainly a script that calls other programs. Therefore
you have to get all this external programs prior to execution.
(I included all BINARIES (a.out-format) you need, but if you want compile 
yourself, you have to get some of the sourcecode at your own.)

- mkisofs 1.04: Needed to master your own Data-CDs.
  (ftp://tsx-11.mit.edu/pub/linux/BETA/cdrom/mkisofs-1.04.tar.gz)

- cdwrite 2.0: Handles all writing operations on the CD-Writer.
  (ftp://sunsite.unc.edu/pub/Linux/utils/disk-management/cdwrite-2.0.tar.gz)

- isosize, isovfy: Utility and Diagnostics for ISO9660-Images
  (included in the mkisofs-1.04 and cdwrite-2.0 package)

- dialog 0.6c: Creates all the nice menus on screen.
  Be sure to compile GUAGE-support in! (edit makefile)
  (ftp://sunsite.unc.edu/pub/Linux/utils/shell/dialog-0.6c.tar.gz)

- cat2,cmp2,isodetect,playcdr,cdda2cdr: Sourcecode included in this
  package.

- A mount-command that autodetects the type of filesystem.
  You can test this if you can mount a partition without the
  -t <fs-type> option. 
  (Example: If "mount /dev/cdrom /cdrom" works instead of the old
   version "mount -r -t iso9660 /dev/cdrom /cdrom" you are fine.)
  All newer distributions include this mount. 


4) Knowledge Requirements
-------------------------

To operate the program savely you should have knowledge how to handle
SCSI-Devices. How to assign the SCSI-ID, which device has to be
terminated and so on.

You must know how to access each SCSI-Device via the devices in the /dev-
directory.  

For those who are not SCSI-experts here a quick introduction:

All SCSI-Devices are identified at boottime by the kernel. The order
they appear is the order of the SCSI-IDs.
(The first device shown is the one with the lowest SCSI-ID.)
 
The first recognized SCSI-Disk is /dev/sda, the next /dev/sdb and so on.
/dev/sda1 is the first partition on that disk, /dev/sda2 the second...
you get the point.
(For IDE-Disks this are /dev/hda and /dev/hdb respectivly.)

The first CD-ROM is /dev/sr0 (on some distributions this can be /dev/scd0).
The number on the end is the number of the CD-ROM. The kernel handles a
CD-Writer like a CD-ROM. 

The next important things are the GENERIC-Devices. 
This are devices indepentent of the type of the device. They are used
to communicate "raw" any device. This is needed for accessing the write-mode
of the CD-Writer (or to read Audio-Tracks from an Audio-CD).

The generic device looks this way: /dev/sg<letter>
The first shown device at boottime (the one with the lowest SCSI-ID) is
/dev/sga, the next one /dev/sgb and so on. 

EXAMPLE:

We have a internal SCSI-Disk at ID 0, a external disk at ID 1, the
CD-Writer on ID 4 and CD-ROM at ID 6.
The devices in the case look like this way:

SCSI-Disk, ID 0 = /dev/sda (the partitions on it: /dev/sda1, /dev/sda2...)
SCSI-Disk, ID 1 = /dev/sdb
CD-Writer, ID 4 = /dev/sr0 (generic device: /dev/sgc)
CD-Rom   , ID 6 = /dev/sr1 (generic device: /dev/sgd)

Hint: Be sure that you have enabled SCSI-Generic-Support when you compiled
      the kernel!


5) Installation
---------------

- Type "make" to build all programs in the src-directory. The binaries
  are copied automatically in the bin-directory. 
  (This is not necessary if you want to use the precompiled binaries)

- Get the software-packages mentioned above and install the binaries in
  the bin-directory.
  (Also not necessary if you want to use the precompiled binaries)

- Edit the defaults in the main-module cdwtools.sh to suit your
  hardware-setup and program-paths.
  (Further explaination follows)


6) Defaultsettings in cdwtools.sh
---------------------------------

- Path-settings: 
   Here you specify where to find the help programs. 
   Should be ok for most cases. 

This are all the default settings: Every setting can be changed via a menu
from the program. But nevertheless you should enter resonable settings
here for your system.

- Global Defaults:

   SOURCE_CD_DRIVE_IOC: This is the SCSI-Device to access the CD-ROM-Drive.
    Usually this is /dev/cdrom (which is a link to /dev/sr0 or /dev/sr1).

   SOURCE_CD_DRIVE_GEN: This is the GENERIC-SCSI-Device to access the 
    CD-ROM-Drive. This is needed for reading Audio-Tracks.
    (This is explained in the Audio-documentation below)

   DEST_CD_WRITER: This is the GENERIC-SCSI-Device to access the 
    CD-Writer.

   CDW_MODEL: Select your CD-Writer-Model. At the moment only
    "philips", "yamaha" or "hp".

   CDWSPEED: Writing speed of the writer. Only choose speed supported
    by the writer. Usually 1x or 2x.

   DUMMY_MODE: Disable Writing-Laser. Used to simulate the write-process.
    STRONGLY RECOMMENDED ON YOUR FIRST TRIES!!!!!!

   NETWORK_STATUS: Disable network while burning? Because the timing is
    very critical while writing a CD you perhaps feel better when nobody
    can access the system over the network. 

- Data-CD Defaults:

   TEMP_PART_IMAGE: This is the HD-Partition where the CD-Image will be stored. 
    (Sould be about 700 MB in size!)
 
   MOUNT_IMAGE: This the mountpoint where the HD-Partition for the CD-Image 
    will be mounted. This will be only used when you copy Non-ISO9660-CDs.

- Audio-CD Defaults:

   TEMP_PART_AUDIO: This is the HD-Partition where the Audio-Tracks will be
    saved. This partition will be mounted automatically when you enter
    the audio-sub-menu of the program. If you don't want an automount set
    "none" here.

   MOUNT_AUDIO: Mountpoint for the partition above.

   AUDIO_FILENAME: Default filename for Audio-Tracks. The program will 
    save the tracks in the directory MOUNT_AUDIO with the filename
    AUDIO_FILENAME<# of track>.cdr (a Data-Track gets the extension .raw).

   SWAP_BYTE_ORDER: Most CD-Writers like their Audio-Data big-endian. But
    e.g. Yamaha wants them little-endian. So if you have a Yamaha-writer
    and you read and write Audio with it, set this to "On". All others 
    should try "Off" first.
 
- Master Defaults:

   MASTER_SOURCE: This is the HD-Partition where the data to master is
    found.

   MOUNT_MASTER: Mountpoint for the MASTER_SOURCE-Partition.

   MASTER_DIR: This is the directory that will become the root of the 
    mastered CD. 
    Example: Your data is on an external HD-Partition /dev/sdb1. On that
     partition the data is in the directory /cdstuff. You set MOUNT_MASTER
     to /mnt. Then your MASTER_DIR should be /mnt/cdstuff. On the mastered
     CD the directory cdstuff WON'T appear..just its contents!

   IMAGE_DEST: On this partition the generated CD-Image will be saved.
    In most cases this should be the same as the TEMP_PART_IMAGE.

   IMAGE_TYPE: Indicates the type of the CD-Image mastered. This can be
    "RockRidge" or "MSDOS"

   ISOVOLID: Default ISO-Header Volume-ID. 

   ISOPUBID: Default ISO-Header Publisher-ID.

   ISOPREID: Default ISO-Header Preparer-ID. 

   ISOAPPID: Default ISO-Header Application-ID.

- Security-Locking of Partitions:

   Here you specify all the partitions that you want to lock. This means
   that the user can't enter this partitions in any menu. Because the 
   program can write raw on any partition you may enter, this is a 
   protection against erasing any system-partitions.

   Example: Your harddisk contains /dev/sda1 as your linux-root-partition
    and /dev/sda2 as your /usr-partition. Your DOS-Partition is on /dev/hda1.
    To make sure that noone can use any of this partitions as image-storage
    you enter them in the lock-string. Its also saver when you add
    the generic-devices of that SCSI-Harddrives as well. 


7) Program-Documentation
------------------------

You must be the user root to run this program. Just setting the sticky-bit
won't work. (You can't give a script the sticky-bit)
  
I created a new user called "cdw" who got the User-ID 0. The start-shell
of this user is the "cdwtools.sh"-program. This combined with locking of
system-partitions should be save enough to avoid any damage to the system.

Example /etc/passwd-line:
 cdw::0:0:CDW-Tools-User:/home/cdwtools:/home/cdwtools/cdwtools.sh

You can also set a password for that user.

When this user logs in, the CDW-Tools are started automatically.
Or start as user root the program by typing ./cdwtools.sh


7.1 The Main-Menu
-----------------

Here you can see the default-settings of the CD-ROM-Devices (normal and
generic), the generic CD-Writer-device and model, the speed, the dummy-
write-mode and the network-status. 
All these menu-options got a little online help, so I won't discuss them
again. 

[Background-Information:
 Shutting down the network is done by running this command:
  "/sbin/ifconfig eth0 down"
 The reactivation is done by running this command:
  "/etc/rc.d/rc.inet1"
 If you know a better method, please tell me. ]

You can shutdown the system with the "HALT"-Option. You may want to
do this, to connect the SCSI-Devices you need. The time until halt is
2 min. to give users working on the system a chance to logout.


7.2 Copy Data-CD
----------------

Copies a CD in 3 steps.

Step 1: Read CD-Image.
   Copies a CD from the CD-ROM-Device to the HD-Partition for Image-Data.
   This task is performed as a byte-by-byte raw-copy.
   But if you want to copy a Non-ISO9660-CD (e.g. a MAC- or SUN-CD) we 
   have to format and mount that HD-Partition (done automatically). It will
   be mounted on the Mountpoint for Image-Data. 

[Background-Information:
 We copy with the "cat cd-rom >hd-partition"-command. To write a image
 generated this way, we need to know its size. For ISO-9660-Images we can
 do this with "isosize"-command, but for other formats we don't have such
 tools. This is the reason why Non-ISO9660-CDs have to be copied to a mounted
 directory. Then we can see the image-size with the "ls -l"-command. ]

Step 2: Verify CD-Image.
   Verifies the CD-Image in 2 passes. 
   Pass 1 does a quick compare between original CD and image. Not 100% 
   secure but takes only a few seconds. 

   Pass 2 compares byte-by-byte. This can take quite long (same time as the
   reading of the image) but it is reliable. Experience shows that you can
   abort the process after a short time. (If there are errors in the image, 
   they are usually at the beginning - don't know why, but it seems so).

[Background-Information:
 Pass 1 simply runs "isovfy" on the original CD and on the image. Any
 differences are shown. 
 Pass 2 runs a "cmp cd-rom image". ]

Step 3: Writing the CD-Image.
  Copies the CD-Image to the CD-Writer. 

  Hint: Is is possible to copy a CD without creating an image. But then
        you need a second CD-Rom that is faster than the CD-Writer. 
        To do that set your Image-Partition to /dev/cdrom (or whatever)
        and go to "write" immediatly (skip read and verify).
        But this is not recommended!


7.3 Copy Audio- or Mixed-Mode-CD
--------------------------------

Hint: When I talk about "Audio-tracks" or "Audio-CDs", I always include
      also Mixed-Mode-CDs with their Data-track.

You can copy Digital Audio with your CD-Writer now. Or you can use
another CD-Rom that is supported by cdda2cdr. 

When you enter this sub-menu the program tries to mount the Audio-HD-
Partition automatically. If you have set the default value to a wrong
device or you have not connected the SCSI-Disc you wanted to save onto,
then a error-message will displayed. You will get another message when
the automount fails, because there is not an ext2-fs on the partition.
In this case you will be asked if you want to format that partition. 

If you want to store the Audio-tracks on a premounted directory (local)
then you don't want that this automount will be performed. Set "none"
as your HD-Partition for Audio-Data in this case.

On top of the menu is the free disk-space displayed. The numbers in
brackets show the free space displayed in minutes and seconds.

Be sure to set the byte-order right: 
Most CD-Writers want their Audio-Data in the big-endian-format 
(MSB, LSB), but I found out that the Yamaha writer needs in little-endian
(LSB, MSB). So If you use a Yamaha-Writer for Audio-read and write you must
set this value to "On". In all other cases you should leave this at "Off".
If you read in audio with another device than you write you must be 
careful. (e.g Read Audio with an Toshiba CD-Rom and write with the Yamaha,
or Audiodata you sampled yourself.)
A rule of thumb: If you are going to write audio with the Yamaha, your audio-
data must play fine with the commandline-command "./bin/playcdr -x <file.cdr>"
and if you want to write with all other writers the data must play ok with
"./bin/playcdr <file.cdr>".
To convert audio-data from little-endian to big-endian and vice versa, use
"sox <file1.cdr> -x <file2.cdr>" (sox is not included).
 
INFO: View tracks of Audio-CD
 This shows all tracks on a CD. This can also be Data-tracks.
 For a better description read the documentation of CDDA2CDR. 
[Background-Information:
  Displays the output of "cdda2cdr -D<cdrom> -fio" ]

READ: Read digital Audio-tracks
 Tag here with the spacebar all the tracks you want to read.
 The tracks will be saved in the directory specified as mountpoint
 for Audio-tracks. 

LISTEN: Listen to Audio-tracks
 Here you can listen to your tracks you have saved on the harddisk.
 This is to check the qualitiy of the recording. 
 To use this you need a soundcard that is able to play 44.1khz, 16 bit
 stereo-files. 
 (But you can also use sox (not included) to listen to tracks - but with
  less quality)
[Background-Information:
 Runs "playcdr <file>" ]

WRITE: Write Audio-tracks
 Tag all the tracks you want to have on a CD. (You can also include one
 data-track).
 In the next screen you can check the track-layout. There is also the sum
 of times displayed, so you can check if it all fits on a CD.
 Next you have the possibilty to change the track-order. 
 To do that enter the numbers of the tracks in your prefered order, 
 separted by spaces.

 If all is ok we are ready to write the CD. 

DELETE: Delete Audio-tracks.
 In order to free up harddrive-space you can delete the tracks you 
 won't need anymore.

Hint: If you just want to copy a CD that contains Audio-tracks just select
      all tracks in the READ menu. When you enter the WRITE menu all tracks
      are already there in the correct order. 


7.4 Master Data-CD
------------------

When you enter this menu the program tries to automount the Master-
Source-Partition in case it is not set to "none". The same rules as
described in section 7.3 apply. 

Master a CD means that you setup a directory-tree containing up to 650 MB
files that should be burned to CD. Because the filesystem on a CD is
completely different to a filesystem on the harddrive, we must convert
the data to the CD-ROM-Format called ISO9660. This is quite complicated
and takes a few minutes (and a lot of RAM).  
 
Now an example setup to illustrate the usage of the program-module.
       -------------
Somebody prepared a harddisk with the data to master on it. The filesystem
is an ext2-fs (but could also be MSDOS or any other fs linux can mount).
The directory-tree on it looks this way: 

  /lost+found
  /cdstuff
  /cdstuff/backup/...
  /cdstuff/newdata/...
  /cdstuff/README

You now want to connect that harddisk to your system. After the next
bootup this partition is linked into the system as /dev/sdc1.
Therefore you set in the Master-Menu the Master-Source-Partition
to /dev/sdc1. Next you choose a valid Mount-Point for the Master-Source, 
for which /mnt may be a good choice. 

Now the program will mount the partition with the data. 

Next we need to setup the Master-Directory, to tell the program where
to look for the data to master. In this case this would be /mnt/cdstuff.

Now we had setup the SOURCE of the data, next is to setup the DESTINATION.
 
The Image-Destination can be a HD-Partition (recommended) or a filename.
If you choose to save the generated image on a partition make sure
it is not mounted and sufficent in size. Usually you want to set the
partition to the same like the HD-Partition for Image-Data in the Copy-Data-
CD-Menu.
If you want to save the image in a file (e.g. to be able to write as
data-track of a Mixed-Mode-CD) enter as destination a full filename 
(with path). The extension of that file should be ".raw". Also be sure
that there is enough space left in that directory. 
Example to save in file: Enter as Image-Destination "/mnt2/isoimage.raw".

With the Image-Type you set what type of Image should be generated.
The ISO9660-Format allows more than MSDOS can read, so we need a special
type "MSDOS". 

The MSDOS-Format uses only short filenames and no mixed cases, so be
careful if you create that from an Unix-filesystem with long filenames.

The other type is RockRidge, which allows long filenames and upper/lower-
case letters. A CD generated this way can be read by UNIX, OS/2, Win95
and most others systems. But it could make trouble with DOS/Windows.

The last thing we must prepare are the ISO9660-Header-Strings.
Here we set the Volume-ID (DOS calls this disklabel), the Publisher-ID,
the Preparer-ID and the Application-ID.

Its possible to let all or some entries blank.

If you want take the Header-Strings from an existing CD, you can use
the option "Get Header-Strings from CD". But this deletes all entries
you may have entered before. Its possible to edit the strings later
with "Define ISO9660-Header-Strings". 
[Background-Information:
 With the tool "isodetect" we can read that from any ISO9660-Image. ]

Hint: If you press only RETURN in an input-field the original-content 
      won't be altered.

Now all is set to master the image.
[Background-Information:
 We call "mkisofs" here. ]                   

After we generated the image you can run "Verify Image". This performs
a quick consistency-check. 
[Background-Information:
 This is simply the output of "isovfy". You may get some errors, but 
 usually you can ignore them. ]

To actually write the image go to the "Copy Data-CD"-Menu in Main-Menu.
Then check if there is the right partition set and click on "Write-CD-
Image".
The above works only if you wrote the image to an partition. If you wrote 
into a file you can write the image (perhaps combined with Audio-tracks)
in the Audio-module. But you have to take care yourself that you wrote
the image to a place where the "Write Audio-CD" can find it. 
(The mountpoint for the Audio-Tracks should be the path to your image
and your image must have the extension ".raw")


If we come back to our example the finished CD looks like this:

/backup/...
/newdata/...
/README

(The directory "cdstuff" won't appear!)

Hint: Its much easier than it looks! If you understood the example, 
      nothing worse can happen. 


8) Useful Information
---------------------

READ THIS. It helps!

- If you have problems compiling cdwrite-2.0 (this happens on 1.2.x-
  kernels and older 1.3.x-kernels) just remove the "-ansi -pedantic"
  from the makefile.

- Timing is critical while writing a CD. Be sure that nobody starts
  heavy-loaded processes. (Perhaps by shutting down the network.)
  You must care for a steady data-flow. If the CD-Writer "runs dry"
  the resulting disc may be unreadable. The more cache the CD-Writer
  got the likelyhood of missing data drops.
  I wrote successfully a CD with 4x-speed on a Yahama Writer with
  an ISA-Adaptec 1542B, 486/50, Kernel 1.3.57. So there is enough
  power in Linux. Don't worry. Use dummy-writes to be sure.

- The next hints are taken from the cdwrite-manpage:

       Unless  your  SCSI  controller  and driver support discon-
       nect/reconnects, you will probably not be able to write  a
       CD  correctly  if  the  CD writer and hard disk are on the
       same SCSI bus.  It is not recommended that IDE drives  are
       used  on  CD-writing system; if they are, it is imperative
       that interruptible operation is enabled using  the  hdparm
       command.

       It  is  not recommended to use more than single speed when
       reading data off a filesystem (as opposed to  a  raw  disk
       partition).

       cdwrite  does  not  verify that the input data will fit on
       the media.  In the case of media  overrun,  the  resulting
       disc is usually unreadable.

       A Compact Disc can have no more than 100 tracks.

       When  creating  a disc with both audio and data tracks, it
       is conventional to place the data on  track  1.   Some  CD
       players  or  CD-ROM  drives may respond incorrectly to any
       other arrangement, although the specifications permit  it.

       Many  systems are not able to read more than a single data
       track, or need special software to do so.

       Some CD players have problems reading ``gold''  CD's,  and
       some have problems reading the outermost tracks (i.e. very
       long CD's).

- I encountered a slightly unstable writing behavior when writing
  CDs with a lot of tracks. (Audio or Mixed-Mode). ALWAYS use
  the dummy-write-mode to check out if your Writer-SCSI-Controller
  combination works stable.
  (You can experiment with the SCSI-Setup in your SCSI-Bios...
   disabling disconnect may help.)

- If cdwrite crashes while writing, the resulting CD is usually totally
  unreadable. 

- Don't mount an ISO-Image. Its possible to mount an ISO-Image stored
  on a Disk-Partition (e.g. to check the contents on the newly mastered
  disc before writing) but I found out, that this corrupts the image. 
  I did this with an image mastered for MSDOS and the resulting disc was
  totally unreadable by DOS. (Under Linux it worked nevertheless).
  
- When you read digital Audio-tracks of a CD check the quality of the 
  sound-files before you write them. I tested a lot of CD-Roms to find
  out that many are supporting the digital access to the tracks, but
  the resulting quality is noisy or "scattered".
  A CD-Rom working ok is the Toshiba XM3601, Rev 0725.
  Best use your CD-Writer for Audio-read..they should all perform perfect.

- You can create your own Audio-tracks. Use the program "sox" (not 
  included) to convert any sound-format to the CDR-Format. If you
  do that on a little-endian-machine like a 386/486/Pentium you have
  to reverse the byte-order with the "-x" switch.

  Example: To convert a file "sound.wav" (44.1kHz, 16-bit, Stereo) to
    CDR do this:
     sox sound.wav -x sound.cdr

- It is possible to use the CD-Writer as CD-ROM-Reader.
  To get the Philips CDD-522 to read CDs I had to patch the kernel.
  This patch only works for the 1.3.x-kernels. (Tested with 1.3.37)
 ------------
--- drivers/scsi/sr.orig     Thu Oct 26 23:00:10 1995
+++ drivers/scsi/sr.c        Thu Oct 26 23:01:00 1995
@@ -1014,6 +1014,7 @@
        scsi_CDs[i].sector_size = (buffer[4] << 24) |
            (buffer[5] << 16) | (buffer[6] << 8) | buffer[7];
        if(scsi_CDs[i].sector_size == 0) scsi_CDs[i].sector_size = 2048;
+        if(scsi_CDs[i].sector_size == 2340) scsi_CDs[i].sector_size = 2048;
        if(scsi_CDs[i].sector_size != 2048 &&
           scsi_CDs[i].sector_size != 512) {
            printk ("scd%d : unsupported sector size %d.\n",
 -------------

  This Kernel-patch is since 1.3.56 obsolete! 
  If you have problems to access your Yamaha-Writer in Read-Mode use this
  patch, but change the "2340" to "2352". This should be in one of the
  next kernel-releases, anyway.

9) Bugs 
-------

- cdwrite 2.0 (and 1.5 also) seems not to be able to "dummy"-write
  when running a 1.3.x-kernel. I don't know why. I recommend using
  the 1.2.13-kernel.

  Use Kernel 1.3.56 or above, this fixes it.

- This documentation is confusing and too long.


10) Todo
--------

- Port the thing to X11. (Should be ready in a few month).
- Beep when CD is ready? 


11) Credits
-----------

Thanks go to:

- Authors of cdwrite: Adam Richter <adam@yggdrasil.com> 
                      H. Peter Anvin <hpa@storm.net>
                      and the others mentioned in the cdwrite-manpage

- Author of cdda2wav: Heiko Eissfeldt <heiko@colossus.escape.de>

- Author of mkisofs: Eric Youngdale and Yggdrasil Computing

- Authors of dialog: Savio Lam <lam836@cs.cuhk.hk> 
                     Stuart Herbert (S.Herbert@shef.ac.uk)

- Kai Dupke for supplying the kernel-patch to read CDs with the CD-Writer.

And all others who contributed to the linux-project.


12) Conclusion
--------------

I have tested the program with the following:

- Philips CDD-522 CD-Writer
- Yamaha CDR 100 CD-Writer
- Kodak CDD-521 CD-Writer
- Toshiba XM3601 Rev. 0725 CD-ROM
- Quantum Atlas 2 GB Harddisk
- Adaptec 1542B
- Linux Slackware 2.3, Kernel 1.3.57


Please report your experiences (good or bad) to me. Thanx.


20.01.96 Thomas Niederreiter <p7003ad@sunmail.lrz-muenchen.de>

