Homepage of

cdrskin

Limited cdrecord compatibility wrapper for libburn

Purpose:

Burns preformatted data to CD-R or CD-RW

Hardware requirements:

A CD recorder suitable for libburnia.pykix.org (SCSI or IDE/ATAPI writers compliant to mmc-3 standard).

Software requirements :

Linux kernel 2.4 or higher: With kernel 2.4 the drive has to be under ide-scsi emulation.; With kernel 2.6 the drive should not be under ide-scsi.
libpthread: is supposed to be a standard system component.

GPL software included:

libburn-0.2.6: (by Derek Foreman, Ben Jansens, and team of libburnia.pykix.org); transfers data to CD

This program system has been tested on Intel/AMD Linux systems only.
Ports to other usable systems are appreciated. Reports are welcome.

Special features:

Source code is independent of cdrecord

Commands:

The goal is to provide some of cdrecord's options in a compatible way. This has been achieved quite sufficiently for the needs of backup tool scdbackup and for data CD projects of K3b (see examples). Suitability for audio CD frontends has been improved much and is now being evaluated. Further enhancements depend on people who can describe and discuss their wishes as well as on the development of libburn.
Get an overview of drives:: $ cdrskin -scanbus; $ cdrskin dev=ATA -scanbus; $ cdrskin --devices
Get info about a particular drive or loaded media:: $ cdrskin dev=0,1,0 -checkdrive; $ cdrskin dev=ATA:1,0,0 -atip; $ cdrskin dev=/dev/hdc -toc
Make used CD-RW writable again:: $ cdrskin -v dev=/dev/sg1 blank=all -eject; $ cdrskin -v dev=/dev/dvd blank=fast -eject
Write ISO-9660 filesystem image:: $ cdrskin -v dev=/dev/hdc speed=12 fs=8m driveropts=burnfree -sao -eject padsize=300k my_image.iso
Write compressed afio archive on-the-fly :: $ find . | afio -oZ - | cdrskin -v dev=0,1,0 fs=32m speed=8 driveropts=burnfree padsize=300k -tao -
Write audio tracks:: $ cdrskin -v dev=ATA:1,0,0 speed=48 driveropts=burnfree -sao track1.wav track2.au -audio -swab track3.raw
Get overview of the cdrecord compatible options:: $ cdrskin -help
Get overview of the non-cdrecord options:: $ cdrskin --help
Read the detailed manual page:: $ man cdrskin
Read about the standard for which cdrskin is striving:: $ man cdrecord; Do not bother Joerg Schilling with any cdrskin problems. (Be cursed if you install cdrskin as "cdrecord" without clearly forwarding this "don't bother Joerg" demand.)

Known deficiencies:

Appending sessions to unclosed media is restricted to write mode TAO.
cdrskin -scanbus or --devices hangs for quite a while if there is a CD drive which does not work properly (e.g. because it has individual problems with DMA). So if the superuser gets no result with cdrskin --devices then one should disable DMA with the problematic CD drives (like: hdparm -d0 /dev/hdd ) and try again.
In severe cases it might be necessary to guess the device name /dev/sgN resp. /dev/hdX of the non-ill burner if it cannot be found otherwise among its ill peers. Alternatively one can guess the address of the ill device, remove rw-permissions and retry the bus scan as non-superuser.

Download as source code (see README):

cdrskin-0.2.6.pl02.tar.gz (510 KB).

(Most recent patch: backported man page from cdrskin-0.2.7)

The "stable" cdrskin tarballs are source code identical with "stable" libburn releases or with "stabilized" libburn SVN snapshots. They get produced via a different procedure, though.
cdrskin is part of libburn - full libburn is provided with cdrskin releases.

Download as single x86 binaries (untar and move to /usr/bin/cdrskin):

cdrskin_0.2.6.pl01-x86-suse9_0.tar.gz, (60 KB),

runs on SuSE 9.0 (2.4.21) , RIP-14.4 (2.6.14) , Gentoo (2.6.15 x86_64 Athlon).

cdrskin_0.2.6.pl01-x86-suse9_0-static.tar.gz, (260 KB), -static compiled,

runs on SuSE 7.2 (2.4.4), and on the systems above.

Documentation:: README a short introduction; cdrskin --help non-cdrecord options; cdrskin -help cdrecord compatible options; man cdrskin the manual page

Contact:: Thomas Schmitt, scdbackup@gmx.net; libburn development mailing list, libburn-hackers@pykix.org

License:: GPL, an Open Source approved license

Enhancements towards previous stable version cdrskin-0.2.4:

Option -tao is fully enabled.
SAO is still the preferred default but TAO is default if a track of unpredicted size is present (stdin, named pipe, ...) or if a follow-up session is written to an appendable CD. (This is an intentional deviation from cdrecord defaults which themselves have changed with the newest cdrecord versions.)
Status report during blank, preparation and finalization improved.
Bug fixed: Trailing trash appended to .wav files caused error message and, if exceeding fifo size, could even stall a burn. (Workaround: disable fifo by fs=0)
Bug fixed: False speed with first pacifier cycle. Potential program abort by floating point exception (NaN).
multi-session CDs: -multi, -msinfo, writing to appendable CDs (for now restricted to write mode TAO).

Development snapshot, version 0.2.7 :

Enhancements towards stable version 0.2.6:

Improved recognition of unsuitable media types
Ban of chmod u+s is replaced by a loud warning
Detailed man page (already backported to cdrskin-0.2.6.pl02)
Burning to DVD+RW as non-multi, non-appending, single-track session
Emulation of new wodim option msifile=path
Formatting and then burning to DVD-RW like to DVD+RW

README 0.2.7

cdrskin_0.2.7 --help

cdrskin_0.2.7 -help

man cdrskin (as of 0.2.7)

Maintainers of cdrskin unstable packages please use SVN of libburnia.pykix.org

Download: svn co http://libburnia-svn.pykix.org/libburn/trunk libburn_pykix

Build: cd libburn_pykix ; ./bootstrap ; ./configure ; make

Build of SVN versions needs autotools of at least version 1.7 installed. But after the run of ./bootstrap, only vanilla tools like make and gcc are needed.

The following downloads are intended for adventurous end users or admins with full system souvereignty.

Source (./bootstrap is already applied, build tested, for more see upcoming README ):

cdrskin-0.2.7.tar.gz (500 KB).

Binary (untar and move to /usr/bin/cdrskin):

cdrskin_0.2.7-x86-suse9_0.tar.gz, (60 KB).

cdrskin_0.2.7-x86-suse9_0-static.tar.gz, (260 KB)

Many thanks to Joerg Schilling for cdrecord,
and to Derek Foreman and Ben Jansens for creating libburn.
Historic versions based on Derek's and Ben's icculus.org/burn :
cdrskin-0.1.2.0.2.ts.tar.gz
cdrskin-0.1.3.0.2.ts.tar.gz

Example for a setup of device permissions. To be done by the superuser:
(CD devices which offer no r-permission are invisible to normal users.)
(CD devices which offer no w-permission are not useable.): # cdrskin --devices; ...; 0 dev='/dev/sg0' rwrwr- : 'TEAC' 'CD-ROM CD-532S'; 1 dev='/dev/hdc' rwrw-- : 'LITE-ON' 'LTR-48125S'; # chmod a+rw /dev/sg0 /dev/hdc

Example how to setup K3b to use cdrskin for burning data CD projects.
(K3b is a GUI frontend which uses cdrecord for CD burning.)

Example for a test session with a cdrecord based scdbackup installation:: $ cdrskin -scanbus; ...; 2,0,0 0) 'TEAC' 'CD-ROM CD-532S' '?' Removable CD-ROM; $ cdrskin -scanbus dev=ATA; ...; 1,0,0 1) 'LITE-ON' 'LTR-48125S' '?' Removable CD-ROM; $ export SCDBACKUP_SCSI_ADR="ATA:1,0,0"; $ export SCDBACKUP_CDRECORD="cdrskin -v -v tao_to_sao_tsize=650m"; $ scdbackup_home

Example for a permanent configuration of cdrskin based scdbackup: $ cd scdbackup-0.8.6/inst; $ export SCDBACKUP_USE_CDRSKIN=1; $ ./CONFIGURE_CD; ...; cdrskin 0.2.6 : limited cdrecord compatibility wrapper for libburn

If your system is stricken with some ill CD device then this can stall and you will have to press Ctrl+C to abort. In this case, you may execute export SCDBACKUP_NO_SCANBUS=1 and try again.

: ------------------- SCSI devices. To be used like 0,0,0; 2,0,0 0) 'TEAC' 'CD-ROM CD-532S' '?' Removable CD-ROM; ------------------- end of SCSI device list; ------------------- ATA devices. To be used like ATA:0,0,0; 1,0,0 1) 'LITE-ON' 'LTR-48125S' '?' Removable CD-ROM; ...; * Your cdrecord offers -driveropts=burnfree with your recorder.; ...; scdbackup for CD 0.8.6 : First stage of installation done.; ...; Now give it a try. Run : scdbackup_home; $ unset SCDBACKUP_USE_CDRSKIN

To get back to using cdrecord :: $ cd scdbackup-0.8.6/inst; $ export SCDBACKUP_USE_CDRSKIN=0; $ ./CONFIGURE_CD; ...; $ unset SCDBACKUP_USE_CDRSKIN