----------------------------
  KOnCD - Burn your own CDs
---=== KDE 2  EDITION ===---
----------------------------

Developed and Copyright (C) 2000-2001 by Kai Heitkamp
eMail: koncd@kai-heitkamp.de
Project homepage: http://www.koncd.de

KOnCD is a program that allows you to master CDs with mkisofs and
cdrecord programs. It can create multisession CD, bootable CD,
supports blanking on CD-RW. It also copy CDs on-the-fly. You
should have installed cdrecord and mkisofs on your system in
order to get KOnCD working !

Of course you use this software at YOUR OWN RISK - don't kill me because of
unusable CD-R media !


REQUIREMENTS
------------

  - Linux 2.2.x
  - QT 2.2.2 or later (2.2.4 or later recommended ! Not 2.1.0 !)
  - KDE 2.1 (KDE <= 2.0 don't work !)
  - SCSI CD-ROM and SCSI CD writer or IDE with SCSI emulation support
  - cdrecord 1.8x (http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html)
    (for Burn-Proof you need cdrecord 1.9 or later !)
  - mkisofs-1.12x (included with cdrecord 1.8.x)

KOnCD tested on Suse Linux 7.0:
Kernel 2.2.14 / KDE 2.1 / QT 2.2.4 / cdrecord 1.9 / mkisofs 1.13
CD-Writer: ATAPI CD-RW
CD-Reader: ATAPI DVD-ROM

KOnCD tested on Suse Linux 7.1:
Kernel 2.4.0 / KDE 2.1.1 / QT 2.3 / cdrecord 1.9 / mkisofs 1.13
CD-Writer: Yamaha CRW-6416S (SCSI)
CD-Reader: SCSI CD-ROM, SCSI DVD-ROM and ATAPI CD-ROM


INSTALLATION
------------

- ./configure
- make
- make install (as root !)


ATAPI CD-WRITER
---------------

The ATAPI standard describes method of sending SCSI commands over IDE
with some small limitations to the "real" SCSI standard.
For this reason ATAPI-SCSI emulation is the native method of
supporting ATAPI devices.

Many people ask why I use ATAPI-SCSI emulation.
The use of the naming convention "ATAPI-SCSI emulation" is a
litle bit misleading. It should rather be called:
"SCSI host adapter emulation"

Make your kernel ready for ATAPI CD-Writers,
made the following changes:

1.  Identify which device is the CD-R (/dev/hdx).

2.  Compile the kernel to include ATAPI CDROM and SCSI emulation:

     Under the block devices menu:
                Y or M     Include IDE/ATAPI CDROM support
                Y or M     SCSI emulation

3.  Build and install the upgraded kernel.


If you selected modules (Suse Linux !):

1.  Add 'ide-scsi' and 'sg' to the /etc/modules.conf file.
    If you want autoload the modules, add this lines to 'modules.conf':
	
	alias char-major-21 sg
	post-install sg modprobe "-k" ide-scsi

2.  In the /etc/lilo.conf file add an append line for ide-scsi:
        append = "hdx=ide-scsi hdy=ide-scsi"

        'x' is your CD-R device, 'y' is your CD device !
	Don't forget to run 'lilo' !
    
3.  Reboot to the new kernel and make sure the ide-scsi module is loaded

        to test with 'lsmod' !

4.  Make a link from the proper SCSI device to a symbolic, e.g., /dev/cdrom:
    Mostly the DVD is the first CD, hence appears as /dev/scd0 to scd7
    ('cat /proc/scsi/scsi' to get a full list of devices -- the first
    CD-ROM will appear as scd0, etc.)  With the current ATAPI-SCSI module, each CD
    device appears as 8 SCSI devices (different logical units).  If you have
    two devices, you may have to make a node for the second device:

            cd /dev
            mknod scd8 b 11 8

    Then make links:

            ln -s scd0 cdrom
            ln -s scd8 cdr

    Note, many CD-ROM player programs expect the audio CD drive to
    be located at /dev/cdrom (xplaycd, etc.), hence this link is recommended.

    If you try to use /dev/hdc (or wherever your CD or CD-R is) after loading
    the ide-scsi module, you may not be able to mount CD's or play audio
    discs -- you have to use the new SCSI names for the device.

5.  Fix your /etc/fstab file to mount the /dev/cdrom and /dev/cdr


6.  Run 'cdrecord -scanbus' to make sure, cdrecord can see the unit(s) and
    talk to it. Or use the KOnCD setup to see the devices !


YOUR PERMISSIONS !
------------------

Make sure you have enough permissions to cdrecord !
To make this, type at the console 'as root':

chown root /usr/bin/cdrecord
chmod 4711 /usr/bin/cdrecord

'/usr/bin/cdrecord' is the default path. When you don't know, where cdrecord is
located, type 'whereis cdrecord' ! Then you have the complete path of them !

You must have enough permissions to the cd-reader and cd-writer devices:
At least read permissions to the cd-reader and write permissions to the
cd-writer device ! Better you set read AND write permissions to the writer !
That is '/dev/scd0' or so. You must set this 'as root' with 'chmod' !


Have fun with it !
Kai Heitkamp
