Homepage of

cdrskin

Limited cdrecord compatibility wrapper for libburn

Purpose:

Burns preformatted data to CD and single layer DVD media:
CD-R, DVD-R, DVD+R, CD-RW, DVD-RW, DVD-RAM, DVD+RW

Hardware requirements:

A CD/DVD recorder suitable for http://libburnia-project.org
(SCSI , ATA , USB , or SATA writers compliant to standard MMC-3 for CD and to MMC-5 for DVD).

Software requirements :

Linux with kernel 2.4 or higher (and libc, of course) :: With kernel 2.4 an ATA 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.4.2: (founded by Derek Foreman and Ben Jansens, furthered by team of libburnia-project.org); transfers data to CD and DVD

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 most common options of cdrecord for data and audio on CD media are provided in a compatible way. On single layer DVD media cdrskin is able to perform any recording job which is possible with cdrecord. Other than with cdrecord, options -multi and -tao are supported with certain DVD types.
Get an overview of drives and their addresses: # cdrskin -scanbus; # cdrskin dev=ATA -scanbus; # cdrskin --devices
Being superuser avoids permission problems with /dev/srN resp. /dev/hdX .
Ordinary users should then get granted rw access to the /dev files as listed by option --devices.

Get info about a particular drive or loaded media:: $ cdrskin dev=0,1,0 -checkdrive; $ cdrskin dev=ATA:1,0,0 -v -atip; $ cdrskin dev=/dev/hdc -toc
Make used CD-RW or used unformatted DVD-RW writable again:: $ cdrskin -v dev=/dev/sg1 blank=fast -eject; $ cdrskin -v dev=/dev/dvd blank=all -eject
Format DVD-RW to avoid need for blanking before re-use:: $ cdrskin -v dev=/dev/sr0 blank=format_overwrite
De-format DVD-RW to make it capable of multi-session again:: $ cdrskin -v dev=/dev/sr0 blank=deformat_sequential
Write ISO-9660 filesystem image as only one to blank or formatted media:: $ cdrskin -v dev=/dev/hdc speed=12 fs=8m \; -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 \; -tao padsize=300k -
Write several sessions to the same CD, DVD-R[W] or DVD+R:: $ cdrskin dev=/dev/hdc -v padsize=300k -multi -tao 1.iso; $ cdrskin dev=/dev/hdc -v padsize=300k -multi -tao 2.iso; $ cdrskin dev=/dev/hdc -v padsize=300k -multi -tao 3.iso; $ cdrskin dev=/dev/hdc -v padsize=300k -tao 4.iso
Get multi-session info for option -C of program mkisofs:: $ c_values=$(cdrskin dev=/dev/sr0 -msinfo 2>/dev/null); $ mkisofs ... -C "$c_values" ...
Inquire free space on media for a -tao -multi run:: $ x=$(cdrskin dev=/dev/sr0 -tao -multi \; --tell_media_space 2>/dev/null); $ echo "Available: $x blocks of 2048 data bytes"
Write audio tracks to CD:: $ cdrskin -v dev=ATA:1,0,0 speed=48 -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.)

Testers wanted who are willing to risk some double layer DVD media.

Download as source code (see README):

cdrskin-0.4.2.pl00.tar.gz (700 KB).

The cdrskin tarballs are source code identical with libburn releases of the same version number. 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.4.2.pl00-x86-suse9_0.tar.gz, (110 KB),

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

cdrskin_0.4.2.pl00-x86-suse9_0-static.tar.gz, (310 KB), -static compiled,

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

Documentation:: README an 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.4.0:

Safe dynamic linking possible with libburn.so.4

Development snapshot, version 0.4.3 :

Enhancements towards stable version 0.4.2.pl00:

none yet

README 0.4.3

cdrskin_0.4.3 --help

cdrskin_0.4.3 -help

man cdrskin (as of 0.4.3)

Maintainers of cdrskin unstable packages please use SVN of libburnia-project.org

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

Build: cd libburn ; ./bootstrap ; ./configure --prefix /usr ; 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.4.3.tar.gz (700 KB).

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

cdrskin_0.4.3-x86-suse9_0.tar.gz, (110 KB).

cdrskin_0.4.3-x86-suse9_0-static.tar.gz, (310 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
Very special thanks to Andy Polyakov whose dvd+rw-tools provide libburn with invaluable examples on how to deal with DVD media.

Example for a setup of device permissions. To be done by the superuser:
(CD devices which offer no rw-permission are invisible to normal users.): # cdrskin --devices; ...; 0 dev='/dev/sr0' rwrwr- : 'TEAC' 'CD-ROM CD-532S'; 1 dev='/dev/hdc' rwrw-- : 'LITE-ON' 'LTR-48125S'; # chmod a+rw /dev/sr0 /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"; $ 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.3.8 : 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