417 lines
17 KiB
Plaintext
417 lines
17 KiB
Plaintext
------------------------------------------------------------------------------
|
|
libburn.pykix.org scdbackup.sourceforge.net/cdrskin_eng.html
|
|
------------------------------------------------------------------------------
|
|
Installation instructions at about line 60. First the legal stuff:
|
|
------------------------------------------------------------------------------
|
|
This all is under GPL.
|
|
(See GPL reference, our clarification and commitment at the end of this text)
|
|
------------------------------------------------------------------------------
|
|
Based on and sub project of:
|
|
libburn.pykix.org
|
|
By Mario Danic <mario.danic@gmail.com> and Thomas Schmitt <scdbackup@gmx.net>
|
|
Copyright (C) 2006 Mario Danic, Thomas Schmitt
|
|
|
|
libburn.pykix.org is inspired by and in other components still containing
|
|
parts of
|
|
Libburn. By Derek Foreman <derek@signalmarketing.com> and
|
|
Ben Jansens <xor@orodu.net>
|
|
Copyright (C) 2002-2006 Derek Foreman and Ben Jansens
|
|
See toplevel README for an overview of the current copyright situation in
|
|
libburn.pykix.org.
|
|
|
|
------------------------------------------------------------------------------
|
|
My thanks to the above authors (except myself, of course) for making the
|
|
following possible.
|
|
|
|
cdrskin. By Thomas Schmitt <scdbackup@gmx.net>
|
|
Integrated sub project of libburn.pykix.org but also published via:
|
|
http://scdbackup.sourceforge.net/cdrskin_eng.html
|
|
http://scdbackup.sourceforge.net/cdrskin-0.2.3.tar.gz
|
|
Copyright (C) 2006 Thomas Schmitt
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
On top of libburn there is implemented cdrskin 0.2.3, a limited cdrecord
|
|
compatibility wrapper which allows to use some libburn features from
|
|
the command line.
|
|
Interested users of cdrecord are invited to participate in the development
|
|
of cdrskin. Contact: scdbackup@gmx.net or libburn-hackers@pykix.org .
|
|
We will keep copyright narrow but will of course acknowledge valuable
|
|
contributions in a due way.
|
|
|
|
|
|
Important :
|
|
This software is provided as is. There is no warranty implied and no
|
|
protection against possible damages. You use this on your own risk.
|
|
Don't blame me or other authors of libburn if anything goes wrong.
|
|
|
|
I used it on my own risk with :
|
|
SuSE 7.2, kernel 2.4.4, ide-scsi emulation, LITE-ON LTR48125S CD burner
|
|
SuSE 9.0, kernel 2.4.21, ide-scsi emulation, LG GSA-4082B CD/DVD burner
|
|
RIP-14.4, kernel 2.6.14, no ide-scsi, with both above burners
|
|
|
|
It fails to compile or run on SuSE 6.4 (kernel 2.2.14).
|
|
It does not find the IDE CD burner on SuSE 7.2 without ide-scsi.
|
|
Other people sucessfully tested cdrskin on several kernel 2.6 based x86 Linux
|
|
systems, including 64 bit systems. (Further reports are welcome.)
|
|
|
|
|
|
Compilation, First Glimpse, Installation
|
|
|
|
Obtain cdrskin-0.2.3.tar.gz , take it to a directory of your choice and do:
|
|
|
|
tar xzf cdrskin-0.2.3.tar.gz
|
|
cd cdrskin-0.2.3
|
|
|
|
Or obtain a libburn.pykix.org SVN snapshot,
|
|
go into the toplevel directory of the snapshot (e.g. cd libburn_pykix ),
|
|
and execute the autotools script ./bootstrap . Use autools version >= 1.7 .
|
|
|
|
Within that toplevel directory of either cdrskin-0.2.3 or libburn then execute:
|
|
|
|
./configure
|
|
make
|
|
|
|
(Note: there are next-level directories "libburn" and "cdrskin". Those
|
|
would be the wrong ones. Meant is the highest directory of tarball resp.
|
|
SVN download. Among others containing files "AUTHORS", "configure",
|
|
"Makefile.am", as well as directories "libburn" and "cdrskin".)
|
|
|
|
This will already produce a cdrskin binary. But it might be necessary to
|
|
install libburn in order to use this binary. Installation of libburn is
|
|
beyond the scope of cdrskin. For this, see included libburn docs.
|
|
|
|
In order to surely get a standalone binary, execute
|
|
|
|
cdrskin/compile_cdrskin.sh
|
|
|
|
Version identification an help texts available afterwards:
|
|
cdrskin/cdrskin -version
|
|
cdrskin/cdrskin --help
|
|
cdrskin/cdrskin -help
|
|
|
|
Install (eventually as superuser) cdrskin to a directory where it can be found:
|
|
If cdrskin was already installed by a previous version, or by "make install"
|
|
in the course of this installation, then find out where:
|
|
which cdrskin
|
|
Copy your standalone binary to exactly the address which you get as reply
|
|
|
|
cp cdrskin/cdrskin /usr/bin/cdrskin
|
|
|
|
Check the version timestamps of the globally installed binary
|
|
cdrskin -version
|
|
|
|
It is not necessary for the standalone cdrskin binary to have libburn
|
|
installed, since it incorporates the necessary libburn parts at compile time.
|
|
It will not collide with an installed version of libburn either.
|
|
But libpthread must be installed on the system and glibc has to match. (See
|
|
below for a way to create a statically linked binary.)
|
|
|
|
|
|
Usage
|
|
|
|
The user of cdrskin needs rw-permission for the CD burner device.
|
|
A list of rw-accessible drives can be obtained by
|
|
|
|
cdrskin --devices
|
|
|
|
CD devices which offer no rw-permission are invisible to normal users.
|
|
The superuser should be able to see any usable drive and then set the
|
|
permissions as needed. If this hangs then there is a drive with
|
|
unexpected problems (locked, busy, broken, whatever). You might have to
|
|
guess the address of your (non-broken) burner by other means, then.
|
|
On Linux 2.4 this would be some /dev/sgN and on 2.6. some /dev/hdX.
|
|
|
|
The output of cdrskin --devices might look like
|
|
|
|
0 dev='/dev/sg0' rwrwr- : 'TEAC' 'CD-ROM CD-532S'
|
|
1 dev='/dev/sg1' rwrw-- : 'LITE-ON' 'LTR-48125S'
|
|
|
|
So full and insecure enabling of both for everybody would look like
|
|
|
|
chmod a+rw /dev/sg0 /dev/sg1
|
|
|
|
(The CD-ROM is in these examples only for demonstrating the presence of another
|
|
SCSI device. This /dev/sg0 may be left as it is and stay invisible for normal
|
|
users.)
|
|
|
|
I strongly discourage to run cdrskin with setuid root or via sudo !
|
|
It is not checked for the necessary degree of hacker safety.
|
|
|
|
|
|
Usage examples
|
|
|
|
Get an overview of cdrecord style addresses of available devices
|
|
cdrskin -scanbus
|
|
cdrskin dev=ATA -scanbus
|
|
|
|
Note: Adresses reported with dev=ATA are to be used with prefix "ATA:".
|
|
Like "ATA:2,2,0" . Their numbers are not cdrecord compatible. See
|
|
"Pseudo-SCSI Adresses". It is well possible to use IDE device file
|
|
paths like "/dev/hdc" rather than "ATA:2,2,0".
|
|
With SCSI devices it is possible to use "/dev/sg1" or "/dev/scd0".
|
|
Note: Address numbers have changed since cdrskin-0.2.2. To get the old number
|
|
scheme, use option --old_pseudo_scsi_adr . Sorry for any inconvenience.
|
|
|
|
|
|
Obtain some info about the drive
|
|
cdrskin dev=1,1,0 -checkdrive
|
|
|
|
Obtain some info about the drive and the inserted media
|
|
cdrskin dev=1,1,0 -atip
|
|
|
|
Thoroughly blank a CD-RW
|
|
cdrskin -v dev=1,1,0 blank=all -eject
|
|
|
|
Blank CD-RW sufficiently for making it ready for overwrite
|
|
cdrskin -v dev=1,1,0 blank=fast -eject
|
|
|
|
Burn image file my_image.iso to CD
|
|
cdrskin -v dev=1,1,0 speed=12 fs=8m -sao driveropts=burnfree padsize=300k \
|
|
-eject my_image.iso
|
|
|
|
Burn a compressed afio archive to CD on-the-fly
|
|
find . | afio -oZ - | cdrskin -v dev=1,1,0 fs=32m speed=8 -sao \
|
|
driveropts=burnfree padsize=300k tsize=650m -
|
|
|
|
Burn 6 audio tracks from files with different formats to CD.
|
|
Anything except .wav files has to be converted into raw format first
|
|
ogg123 -d raw -f track01.cd /path/to/track1.ogg
|
|
oggdec -R -o track02.cd /path/to/track2.ogg
|
|
lame --decode -t /path/to/track3.mp3 track03.cd
|
|
madplay -o raw:track04.cd /path/to/track4.mp3
|
|
mppdec --raw-le /path/to/track5.mpc track05.cd
|
|
|
|
cdrskin dev=/dev/hdc blank=fast fs=0 -eject \
|
|
-audio track0[1-5].cd /path/to/track6.wav
|
|
|
|
|
|
Usage example with http://scdbackup.sourceforge.net
|
|
|
|
Address may be a cdrecord-style "scsibus,target,lun" as listed with
|
|
cdrskin -scanbus (but not as listed with cdrecord -scanbus) :
|
|
|
|
export SCDBACKUP_SCSI_ADR="1,1,0"
|
|
|
|
or a device file address as listed by --devices with an accessible drive :
|
|
|
|
export SCDBACKUP_SCSI_ADR="/dev/sg1"
|
|
|
|
Set usage of cdrskin with appropriate options rather than cdrecord :
|
|
|
|
export SCDBACKUP_CDRECORD="cdrskin -v -v tao_to_sao_tsize=650m"
|
|
|
|
Run a backup :
|
|
|
|
scdbackup_home
|
|
|
|
|
|
Restrictions
|
|
|
|
The convenient burn mode TAO is not available with libburn yet.
|
|
Therefore it has to be defaulted to mode SAO which needs to know the track
|
|
size in advance. non-cdrecord option tao_to_sao_tsize=650m causes each CD
|
|
to get burned up to 650 MB regardless of the payload size.
|
|
|
|
Audio features are incomplete in respect to cdrecord. Well prepaired track
|
|
files should get burned flawlessly, thanks to Lorenzo Taylor.
|
|
Builtin extraction of raw audio data from filetypes .au and .wav is not
|
|
implemented yet. See chapter "Audio CD" for details.
|
|
|
|
No multi session yet ... Please report your wishes.
|
|
|
|
|
|
Inspiration and Standard
|
|
|
|
For the original meaning of cdrecord options see :
|
|
man cdrecord
|
|
(http://cdrecord.berlios.de/old/private/man/cdrecord-2.0.html)
|
|
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.)
|
|
cdrskin does not contain any bytes copied from cdrecord's sources. Many bytes
|
|
have been copied from the message output of cdrecord runs, though. I am
|
|
thankful to Joerg Schilling for every single one of them.
|
|
|
|
Actually i, Thomas Schmitt, am a devoted user of cdrecord via my project
|
|
scdbackup which still runs a bit better with cdrecord than with cdrskin. TAO.
|
|
I have the hope that Joerg feels more flattered than annoyed by cdrskin.
|
|
|
|
|
|
Pseudo-SCSI Adresses
|
|
|
|
cdrecord and cdrskin share the syntax of addresses but not necessarily
|
|
the meaning of the components. A cdrecord-style address for cdrskin
|
|
[prefix:]scsibus,target,lun
|
|
can be interpreted in two different modes.
|
|
|
|
Standard mode tries to be compatible to original cdrecord. This should be true
|
|
with (emulated) SCSI where the /dev/sgN with is looked up with matching
|
|
scsibus,target,lun as given by the operating system.
|
|
With dev=ATA: or dev=ATAPI: the translation to /dev/hdX is purely literal
|
|
but matches the cdrecord addresses on all systems tested so far:
|
|
X = 'a' + 2 * scsibus + target
|
|
where target only may have the values 0 or 1.
|
|
|
|
In this mode, option -scanbus will list only SCSI devices unless option
|
|
dev=ATA or dev=ATAPI are given, which will suppress SCSI devices and only
|
|
show IDE drives (i.e. /dev/hdX without ide-scsi emulation).
|
|
|
|
|
|
In mode --old_pseudo_scsi_adr there is a scsibus,target,lun representation
|
|
which has nothing to do with SCSI and thus is not compatible to cdrecord.
|
|
Each number triple corresponds either to a device file address or to a
|
|
libburn drive number.
|
|
Component "scsibus" indicates the translation method. Defined busses are:
|
|
0 target is the libburn drivenumber as listed with --devices
|
|
1 associated to device file /dev/sgN , target chooses N
|
|
2 associated to device file /dev/hdX , target 0='a', 1='b' ..., 25='z'
|
|
|
|
So "1,1,0" is /dev/sg1, "2,3,0" is /dev/hdd, "0,2,0" is libburn drive #2 at
|
|
some unspecified device file.
|
|
This scheme shall help to keep cdrecord-style addresses stable and exchangeable
|
|
between users without excluding drives with unexpected device addresses.
|
|
The numbering on bus 0 is prone to arbitrary changes caused by changes in
|
|
drive accessability.
|
|
Further busses may emerge as libburn evolves. "prefix" and "lun" may get
|
|
a meaning. To stay upward compatible, use addresses as printed by -scanbus.
|
|
|
|
|
|
Some programs or users have their own ideas about the address of their burner.
|
|
K3b 0.10 for example derives cdrecord addresses by own examination of the
|
|
devices and not by calling cdrecord -scanbus.
|
|
Standard mode will hopefully be fully compatible with their ideas.
|
|
|
|
Old frontends which do not know dev=ATA or dev=ATAPI and which do ask their
|
|
"cdrecord" via -scanbus may be well served with option --old_pseudo_scsi_adr .
|
|
|
|
To direct any stubborn callers to the appropriate drives, cdrskin allows to
|
|
define device address aliases. Like
|
|
cdrskin dev_translation=+1,0,0+/dev/sg1 \
|
|
dev_translation=+ATA:1,0,0+/dev/sg1 \
|
|
dev_translation=-"cd+dvd"-1,1,0 \
|
|
...
|
|
Any of the addresses dev=1,0,0, dev=ATA:1,0,0, dev=cd+dvd will be mapped to
|
|
/dev/sg1 resp. to its standard alias 1,1,0.
|
|
The first character after "dev_translation=" defines the character which
|
|
separates the two parts of the translation pair. (Above: "+" and "-".)
|
|
|
|
In K3b 0.10 it is possible to employ alternative writer programs by setting
|
|
their full path (e.g. /usr/bin/cdrskin) in menu
|
|
Settings:Configure K3b...:Programs:Search Path
|
|
and to make them default in menu
|
|
Settings:Configure K3b...:Programs:Programs:
|
|
A suitable setting for "cdrecord" in menu
|
|
Settings:Configure K3b...:Programs:User Parameters
|
|
would then probably be
|
|
-v dev_translation=+1,0,0+/dev/sg1
|
|
You will learn from button "Show Debugging Output" after a failed burn run
|
|
what cdrecord command was used with what address "dev=...". This address "..."
|
|
will be the right one to replace "1,0,0" in above example.
|
|
|
|
|
|
Startup Files
|
|
|
|
If not --no_rc is the first argument then cdrskin attempts on startup to read
|
|
arguments from the following three files:
|
|
/etc/defaults/cdrskin
|
|
/etc/opt/cdrskin/rc
|
|
$HOME/.cdrskinrc
|
|
The files are read in the sequence given above.
|
|
Each readable line is treated as one single argument. No extra blanks.
|
|
A first character '#' marks a comment, empty lines are ignored.
|
|
|
|
Example content of a startup file:
|
|
# This is the default device
|
|
dev=0,1,0
|
|
# To accomodate to eventual remnant cdrskin-0.2.2 addresses
|
|
dev_translation=+1,0,0+0,1,0
|
|
|
|
# Some more options
|
|
--fifo_start_empty
|
|
fs=16m
|
|
|
|
|
|
Audio CD
|
|
|
|
Lorenzo Taylor enabled option -audio in cdrskin (thanks !) and reports neat
|
|
results with audio data files which are :
|
|
headerless PCM
|
|
44100 Hz sampling rate
|
|
16 bit persample
|
|
stereo (2 channels)
|
|
little-endian byte order
|
|
Files with name extension .wav get examined wether they are in Microsoft WAVE
|
|
format with above parameters and eventually get extracted by cdrskin itself.
|
|
All other formats (including SUN's format .au) are to be extracted by commands
|
|
like those given above under "Usage examples".
|
|
|
|
I myself am not into audio. So libburn-hackers@pykix.org might be the
|
|
best address for suggestions, requests and bug reports.
|
|
|
|
|
|
Special compilation variations
|
|
|
|
You may get a (super fat) statically linked binary by :
|
|
cdrskin/compile_cdrskin.sh -static
|
|
if your system supports static linking, at all. This will not help with kernels
|
|
which do not properly support the necessary low-level interfaces chosen by
|
|
your compile-time libraries.
|
|
|
|
A size reduced but fully functional binary may be produced by
|
|
cdrskin/compile_cdrskin.sh -do_strip
|
|
|
|
An extra lean binary with reduced capabilities is created by
|
|
cdrskin/compile_cdrskin.sh -do_diet -do_strip
|
|
It will not read startup files, will abort on option dev_translation= ,
|
|
will not have a fifo buffer, and will not be able to put out help texts or
|
|
debugging messages.
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
------------------------------------------------------------------------------
|
|
cdrskin is currently copyright Thomas Schmitt only.
|
|
It adopts the following commitment by the toplevel copyright holders:
|
|
------------------------------------------------------------------------------
|
|
|
|
We, the copyright holders, agree on the interpretation that
|
|
dynamical linking of our libraries constitutes "use of" and
|
|
not "derivation from" our work in the sense of GPL, provided
|
|
those libraries are compiled from our unaltered code.
|
|
|
|
Thus you may link our libraries dynamically with applications
|
|
which are not under GPL. You may distribute our libraries and
|
|
application tools in binary form, if you fulfill the usual
|
|
condition of GPL to offer a copy of the source code -altered
|
|
or unaltered- under GPL.
|
|
|
|
We ask you politely to use our work in open source spirit
|
|
and with the due reference to the entire open source community.
|
|
|
|
If there should really arise the case where above clarification
|
|
does not suffice to fulfill a clear and neat request in open source
|
|
spirit that would otherwise be declined for mere formal reasons,
|
|
only in that case we will duely consider to issue a special license
|
|
covering only that special case.
|
|
It is the open source idea of responsible freedom which will be
|
|
decisive and you will have to prove that you exhausted all own
|
|
means to qualify for GPL.
|
|
|
|
For now we are firmly committed to maintain one single license: GPL.
|
|
|
|
signed for cdrskin: Thomas Schmitt
|