----------------------------
  KOnCD - Burn your own CDs
---=== KDE 2  EDITION ===---
----------------------------
------->>> README <<<-------
----------------------------

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 !


CONTACT ME !
------------

eMail: koncd@kai-heitkamp.de

Before you eMail me, search in the web or usenet for answers !!!
I'm getting more than 20 eMails each day and have no more
time to working on koncd !!!


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' !


OTHER IMPOTANT INFORMATIONS !
-----------------------------

You must activate 'padding' to create an audio cd from wav files
and 'isosize' to copy a cd !!!


Have fun with it !
Kai Heitkamp
