Prepared next cdrskin-0.3.1 cycle

libburn/trunk/cdrskin/README

@@ -143,6 +143,9 @@ It is not checked for the necessary degree of hacker safety.
 
                                 Usage examples 
 
+For options and recordable media classes see 
+    man 1 cdrskin
+
 Get an overview of cdrecord style addresses of available devices
     cdrskin -scanbus 
     cdrskin dev=ATA -scanbus 
@@ -158,24 +161,34 @@ Obtain some info about the drive
 Obtain some info about the drive and the inserted media
     cdrskin dev=0,1,0 -atip -v
 
-Thoroughly blank a CD-RW
+Make used CD-RW or used unformatted DVD-RW writeable again
-    cdrskin -v dev=0,1,0 blank=all -eject 
-
-Format DVD-RW before first use with cdrskin
-    cdrskin -v dev=0,1,0 blank=format_overwrite
-
-Blank CD-RW sufficiently for making it ready for overwrite
     cdrskin -v dev=0,1,0 blank=fast -eject 
 
-Burn image file  my_image.iso  to CD-R, CD-RW, DVD+RW, DVD-RAM, DVD-RW
+Format DVD-RW to avoid need for blanking before re-use
+    cdrskin -v dev=0,1,0 blank=format_overwrite
+
+De-format DVD-RW to make it capable of multi-session again
+    cdrskin -v dev=/dev/sr0 blank=deformat_sequential
+
+Burn image file  my_image.iso  to media
     cdrskin -v dev=0,1,0 speed=12 fs=8m driveropts=burnfree padsize=300k \
             -eject  my_image.iso 
 
-Burn a compressed afio archive to any of the above media types on-the-fly
+Write several sessions to the same CD or DVD-R[W]
+    cdrskin dev=/dev/hdc padsize=300k -multi 1.iso
+    cdrskin dev=/dev/hdc padsize=300k -multi -tao 2.iso
+    cdrskin dev=/dev/hdc padsize=300k -multi -tao 3.iso
+    cdrskin dev=/dev/hdc padsize=300k -tao 4.iso
+
+Get CD or DVD-R[W] multi-session info for option -C of program mkisofs:
+    c_values=$(cdrskin dev=/dev/hdc -msinfo 2>/dev/null)
+    mkisofs ... -C "$c_values" ...
+
+Burn a compressed afio archive to media on-the-fly
     find . | afio -oZ - | cdrskin -v dev=0,1,0 fs=32m speed=8 -tao \
                                   driveropts=burnfree padsize=300k - 
 
-Burn 6 audio tracks from files with different formats to CD.
+Burn 6 audio tracks from files with different formats to CD (not to any DVD).
 Anything except .wav or .au files has to be converted into raw format first.
 See below "Audio CD" for specifications.
     ogg123 -d raw -f track01.cd /path/to/track1.ogg
@@ -409,20 +422,33 @@ task of maintaining extendable ISO-Filesystems on DVD+RW.
 
                                      DVD-RW
 
-DVD-RW are usable if formatted to state "Restricted Overwrite". They then
+DVD-RW are usable if formatted to state "Restricted Overwrite" or if in state
-behave much like DVD+RW. See above.
+"Sequential Recording" - provided the "Incremental Streaming" feature (21h) is
-DVD-RW in state "Sequential" have first to be formatted by
+available.
-  cdrskin dev=... -v blank=format_overwrite
+
 "Sequential" is the state of unused media and of media previously blanked
 or written by cdrecord. dvd+rw-format -blank can also achieve this state.
-(Command  dvd+rw-format -force  can achieve "Restricted Overwrite".)
+The according cdrskin option is blank=deformat_sequential .
+If "Incremental Streaming" is available, then sequential media are capable
+of multi-session like CD-RW. (But not capable of -audio recording.)
+This means they need option -multi to stay appendable, need to be blanked
+to be writeable from start, return useable info with -toc and -msinfo,
+eventually perform appending automatically.
+Without "Incremental Streaming" offered by the drive, they are regarded as
+unsuitable media for now.
+ 
+Overwriteable DVD behave much like DVD+RW. "Restricted" refers only to the
+granularity of random access and block size which have always to be aligned to
+full 32 kB. Sequential DVD-RW are converted into overwriteable DVD-RW by
+  cdrskin dev=... -v blank=format_overwrite
+(Command  dvd+rw-format -force  can achieve "Restricted Overwrite", too.)
 
 Formatting or first use of freshly formatted DVD-RW can produce unusual noises
 from the drive and last several minutes. Depending on mutual compatibility of
 drive and media, formatting can yield unusable media. It seems that those die
-too on blanking by cdrecord or dvd+rw-format. Perils of DVD-RW, i fear.
+too on blanking by cdrecord, dvd+rw-format or cdrskin. Perils of DVD-RW.
 
-There are three formatting variants with cdrskin currently:
+There are three DVD-RW formatting variants with cdrskin currently:
 
 blank=format_overwrite  uses "DVD-RW Quick" formatting (MMC-type 15h)
 and writes a first session of 128 MB. This leads to media which are expandable
@@ -431,12 +457,32 @@ and random addressable by cdrskin.
 blank=format_overwrite_quickest  uses "DVD-RW Quick" formatting (type 15h) too,
 but leaves the media in "intermediate" state. In the first session of writing
 one may only write sequentially to such a DVD. After that, it gets random
-addressable by cdrskin.
+addressable by cdrskin. DVD-ROM drives might show ill behavior with them.
 
 blank=format_overwrite_full  uses preferrably "Full Format" (type 00h).
 This formatting lasts as long as writing a full DVD. It includes writing of
 lead-out which is said to be good for DVD ROM compatibility. 
 
+A de-formatting option is available to make overwriteable DVD-RW sequential:
+
+blank=deformat_sequential  performs thorough blanking of all states of DVD-RW.
+
+blank=all and blank=fast perform the same thorough blanking, but refuse to do
+this with overwriteable DVD-RW, thus preserving their formatting. The specs
+allow minimal blanking but the resulting media on my drives offer no 
+Incremental Streaming afterwards. So even blank=fast will do full blanking. 
+
+
+                                    DVD-R
+
+The specs state that DVD-R behave like sequential DVD-RW except the capability
+to get blanked or formatted. Thus they should be useable like CD-R media (but
+without -audio).
+Blank DVD-R media are accepted as suitable by cdrskin on my drives.
+I got only a few of those one-time recordable media and no real use case.
+So i prefer to start burning my DVD-R only at the end of my endeavor about
+sequential DVD. There's still plenty to do with DVD-RW testing.
+
 
                         Special compilation variations
 

libburn/trunk/cdrskin/cdrskin.1

@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH CDRSKIN 1 "January 30, 2007"
+.TH CDRSKIN 1 "February 1, 2007"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -227,6 +227,8 @@ stereo. For little-endian byte order (which is usual on PCs) use option
 .wav are examined wether they have a header in MS-WAVE format confirming
 those parameters and eventually raw audio data get extracted and burned as
 audio track. Same is done for suffix .au and SUN Audio.
+.br
+Option -audio may be used only with CD media and not with DVD.
 .TP 
 .BI blank= type
 Blank a CD-RW or format a DVD+/-RW.
@@ -628,7 +630,7 @@ in mode -tao.
 .br
 .SH EXAMPLES
 .SS
-.B Get an overview of drives:
+.B Get an overview of drives and their addresses:
 .br
 cdrskin -scanbus
 .br
@@ -640,7 +642,7 @@ cdrskin --devices
 .br
 cdrskin dev=0,1,0 -checkdrive
 .br
-cdrskin dev=ATA:1,0,0 -atip
+cdrskin dev=ATA:1,0,0 -v -atip
 .br
 cdrskin dev=/dev/hdc -toc
 .SS
@@ -654,6 +656,10 @@ cdrskin -v dev=/dev/dvd blank=fast -eject
 .br
 cdrskin -v dev=/dev/sr0 blank=format_overwrite
 .SS
+.B De-format DVD-RW to make it capable of multi-session again:
+.br
+cdrskin -v dev=/dev/sr0 blank=deformat_sequential
+.SS
 .B Write ISO-9660 filesystem image:
 .br
 cdrskin -v dev=/dev/hdc speed=12 fs=8m \\
@@ -668,17 +674,17 @@ cdrskin -v dev=0,1,0 fs=32m speed=8 \\
 .br
 padsize=300k -tao -
 .SS
-.B Write several sessions to the same CD:
+.B Write several sessions to the same CD or DVD-R[W]:
 .br
-cdrskin dev=/dev/hdc padsize=300k -multi 1.iso
+cdrskin dev=/dev/hdc -v padsize=300k -multi 1.iso
 .br
-cdrskin dev=/dev/hdc padsize=300k -multi -tao 2.afio
+cdrskin dev=/dev/hdc -v padsize=300k -multi -tao 2.iso
 .br
-cdrskin dev=/dev/hdc padsize=300k -multi -tao 3.afio
+cdrskin dev=/dev/hdc -v padsize=300k -multi -tao 3.iso
 .br
-cdrskin dev=/dev/hdc padsize=300k -tao 4.afio
+cdrskin dev=/dev/hdc -v padsize=300k -tao 4.iso
 .SS
-.B Get CD multi-session info for option -C of program mkisofs:
+.B Get CD or DVD-R[W] multi-session info for option -C of program mkisofs:
 .br
 c_values=$(cdrskin dev=/dev/sr0 -msinfo 2>/dev/null)
 .br

libburn/trunk/cdrskin/cdrskin_eng.html

@@ -229,7 +229,11 @@ directly from a disk file</LI>
 <DT><H3>Development snapshot, version 0.3.1 :</H3></DT>
 <DD>Enhancements towards stable version 0.3.0:
 <UL>
-<LI>-none yet-</LI>
+<LI>Burnfree enabled by default</LI>
+<LI>Multi-session burning to sequential (i.e. unformatted) DVD-RW</LI>
+<LI>Option -toc with sequential DVD-RW</LI>
+<LI>Options -msinfo and msifile= with appendable DVD-RW</LI>
+<LI>(Testers wanted for DVD-R)</LI>
 </UL>
 </DD>
 <DD>&nbsp;</DD>