From 4cd36f3671cf3d779e0f367ffaeea4150b573316 Mon Sep 17 00:00:00 2001
From: Thomas Schmitt
+ Homepage of
+ cdrskin
+
+Limited cdrecord compatibility wrapper for libburn
+Purpose:
+Burns preformatted data to CD, DVD, and BD media:
+CD-R, DVD-R, DVD-R DL, DVD+R, DVD+R DL, BD-R, CD-RW,
+DVD-RW, DVD-RAM, DVD+RW, BD-RE
+
+ +
+
+
+
+This program system has been tested on Intel/AMD with Linux, FreeBSD,
+and OpenSolaris based operating systems.
+Ports to other usable systems are appreciated. Reports are welcome.
+
+
+
+
+Enhancements towards previous stable version cdrskin-1.1.0.pl01: +
+
+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 and BD media.
+
+
+
+Example how to setup K3b to use cdrskin for burning data CD projects.
+
+(K3b
+is a GUI frontend which uses cdrecord for CD burning.)
+
+
+Enjoying a FreeBSD shell account with the opportunity to
+build and install cdrskin at
+free-shells.com.ar
+
+Usage: test/libburner + [--drive address|driveno|"-"] [--audio] + [--blank_fast|--blank_full|--format] [--try_to_simulate] + [--multi] [one or more imagefiles|"-"] +Examples +A bus scan (needs rw-permissions to see a drive): + test/libburner --drive - +Burn a file to drive chosen by number, leave appendable: + test/libburner --drive 0 --multi my_image_file +Burn a file to drive chosen by persistent address, close: + test/libburner --drive /dev/hdc my_image_file +Blank a used CD-RW (is combinable with burning in one run): + test/libburner --drive /dev/hdc --blank_fast +Blank a used DVD-RW (is combinable with burning in one run): + test/libburner --drive /dev/hdc --blank_full +Format a DVD-RW, BD-RE or BD-R: + test/libburner --drive /dev/hdc --format +Burn two audio tracks (to CD only): + lame --decode -t /path/to/track1.mp3 track1.cd + test/dewav /path/to/track2.wav -o track2.cd + test/libburner --drive /dev/hdc --audio track1.cd track2.cd +Burn a compressed afio archive on-the-fly: + ( cd my_directory ; find . -print | afio -oZ - ) | \ + test/libburner --drive /dev/hdc - +To be read from *not mounted* media via: afio -tvZ /dev/hdc ++libburner has two companions, telltoc and dewav, which help to perform some +peripheral tasks of burning. + +telltoc prints a table of content (sessions, tracks and leadouts), it tells +about type and state of media, and also is able to provide the necessary +multi-session information for program mkisofs option -C. Especially helpful +are its predictions with "Write multi" and "Write modes" where availability +of "TAO" indicates that tracks of unpredicted length can be written. +See: test/telltoc --help. + +dewav extracts raw byte-swapped audio data from files of format .wav (MS WAVE) +or .au (SUN Audio). See example in libburner --help. + + @subsection libburner-source Sourceode of libburner + +Click on blue names of functions, structures, variables, etc in oder to +get to the according specs of libburn API or libburner sourcecode. + +@include libburner.c +*/ diff --git a/libburn/branches/1.1.6/doc/cookbook.txt b/libburn/branches/1.1.6/doc/cookbook.txt new file mode 100644 index 00000000..68cfda12 --- /dev/null +++ b/libburn/branches/1.1.6/doc/cookbook.txt @@ -0,0 +1,1409 @@ + +------------------------------------------------------------------------------- +Note: This is about how libburn operates optical drives. Not about how to + operate libburn. The libburn API is described in libburn/libburn.h +------------------------------------------------------------------------------- + +libburnia-project.org Optical Media Rotisserie Recipes as of January 2010 + +Content: +- TAO Multi-Session CD Cookbook (CD-R, CD-RW) +- SAO CD Cookbook (CD-R, CD-RW, pure audio or pure data only) +- Overwriteable DVD Cookbook (DVD-RAM, DVD+RW, DVD-RW, BD-RE) +- Sequential DVD-R[W] Cookbook +- DVD+R[/DL] Cookbook +- BD-R Cookbook + +------------------------------------------------------------------------------- + TAO Multi-Session CD Cookbook +------------------------------------------------------------------------------- +Guided by reading mmc-r10a.pdf , O.8 "Write a Track" + from http://www.t10.org/ftp/t10/drafts/mmc/ +backed by reading mmc5r03c.pdf from http://www.t10.org/ftp/t10/drafts/mmc5/ +by reading spc3r23.pdf from http://www.t10.org/ftp/t10/drafts/spc3/ +by reading libburn/* from http://icculus.org/burn +and by experiments with drives NEC ND-4570A, LG GSA-4082B, LITE-ON LTR48125S +which used in part code from http://icculus.org/burn. + +For libburnia-project.org by Thomas Schmitt