From b04752f443959c694a7111774ae992ab588a02d2 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sat, 10 May 2008 10:00:24 +0000 Subject: [PATCH] Made number transition to 0.4.6 and activated development documentation --- libburn/branches/ZeroFourSix/Makefile.am | 4 +- libburn/branches/ZeroFourSix/README | 7 +- libburn/branches/ZeroFourSix/cdrskin/README | 24 ++++--- .../branches/ZeroFourSix/cdrskin/cdrskin.1 | 12 ++-- .../branches/ZeroFourSix/cdrskin/cdrskin.c | 42 +++++------ .../ZeroFourSix/cdrskin/cdrskin_eng.html | 72 +++++++++---------- .../ZeroFourSix/cdrskin/cdrskin_timestamp.h | 2 +- .../ZeroFourSix/cdrskin/compile_cdrskin.sh | 10 +-- .../ZeroFourSix/cdrskin/wiki_plain.txt | 31 +++++--- libburn/branches/ZeroFourSix/configure.ac | 19 ++--- libburn/branches/ZeroFourSix/doc/comments | 2 +- .../branches/ZeroFourSix/libburn/libburn.h | 2 +- 12 files changed, 122 insertions(+), 105 deletions(-) diff --git a/libburn/branches/ZeroFourSix/Makefile.am b/libburn/branches/ZeroFourSix/Makefile.am index 18dfd1a9..f1a4e426 100644 --- a/libburn/branches/ZeroFourSix/Makefile.am +++ b/libburn/branches/ZeroFourSix/Makefile.am @@ -101,9 +101,9 @@ test_structest_CPPFLAGS = -Ilibburn test_structest_LDADD = $(libburn_libburn_la_OBJECTS) $(THREAD_LIBS) test_structest_SOURCES = test/structest.c -## cdrskin construction site - ts A60816 - A80408 +## cdrskin construction site - ts A60816 - A80510 cdrskin_cdrskin_CPPFLAGS = -Ilibburn -cdrskin_cdrskin_CFLAGS = -DCdrskin_libburn_0_4_5 +cdrskin_cdrskin_CFLAGS = -DCdrskin_libburn_0_4_6 # cdrskin_cdrskin_LDADD = $(libburn_libburn_la_OBJECTS) $(THREAD_LIBS) # ts A80123, change proposed by Simon Huggins to cause dynamic libburn linking diff --git a/libburn/branches/ZeroFourSix/README b/libburn/branches/ZeroFourSix/README index 7bacc284..2f1ac8b4 100644 --- a/libburn/branches/ZeroFourSix/README +++ b/libburn/branches/ZeroFourSix/README @@ -270,12 +270,17 @@ Project history as far as known to me: exposed in the API to allow future development. - 29th Apr 2008 libisoburn-0.1.4 was made more efficient with reading of - image tree nodes. It now depends on libisofs-0.6.4 and libburn-0.4.4. + image tree nodes. It now depends on libisofs-0.6.4 and libburn-0.4.4. xorriso makes use of new libisofs features by performing incremental updates of directory trees and by cutting oversized data files into pieces. A primitive single session emulation of cdrcord and mkisofs is provided. +- 10th May 2008 libburn-0.4.6 supports formatting and writing of BD-RE, + full nominal speed for DVD-RAM and BD-RE. cdrskin has a unified blank + type with automatic media state recognition. + + ------------------------------------------------------------------------------ This program is free software; you can redistribute it and/or modify diff --git a/libburn/branches/ZeroFourSix/cdrskin/README b/libburn/branches/ZeroFourSix/cdrskin/README index aa5698dc..5bf7d179 100644 --- a/libburn/branches/ZeroFourSix/cdrskin/README +++ b/libburn/branches/ZeroFourSix/cdrskin/README @@ -4,7 +4,7 @@ cdrskin. By Thomas Schmitt Integrated sub project of libburnia-project.org but also published via: http://scdbackup.sourceforge.net/cdrskin_eng.html -http://scdbackup.sourceforge.net/cdrskin-0.4.5.tar.gz +http://scdbackup.sourceforge.net/cdrskin-0.4.6.pl00.tar.gz Copyright (C) 2006-2008 Thomas Schmitt, provided under GPL version 2. ------------------------------------------------------------------------------ @@ -20,10 +20,10 @@ By using this software you agree to the disclaimer at the end of this text Compilation, First Glimpse, Installation -Obtain cdrskin-0.4.5.tar.gz, take it to a directory of your choice and do: +Obtain cdrskin-0.4.6.pl00.tar.gz, take it to a directory of your choice and do: - tar xzf cdrskin-0.4.5.tar.gz - cd cdrskin-0.4.5 + tar xzf cdrskin-0.4.6.pl00.tar.gz + cd cdrskin-0.4.6 Within that directory execute: @@ -262,17 +262,19 @@ I myself am not into audio. So libburn-hackers@pykix.org might be the best address for suggestions, requests and bug reports. - DVD+RW and DVD-RAM + DVD+RW , DVD-RAM , BD-RE -DVD+RW and DVD-RAM media get treated as blank media regardless wether they +These random access media get treated as blank media regardless wether they hold data or not. Options -audio and -multi are not allowed. Only one track is allowed. -toc does not return information about the media content. -Speed is counted in DVD units (i.e. 1x = 1,385,000 bytes/second). Currently -there is no difference between -sao and -tao. If ever, then -tao will be the -mode which preserves the current behavior. +Speed is counted in DVD units (i.e. 1x = 1,385,000 bytes/second) or BD units +(1x = 4,495,625 bytes/second). Currently there is no difference between -sao +and -tao. If ever, then -tao will be the mode which preserves the current +behavior. + +BD-RE media need formatting before first use. cdrskin option "blank=as_needed" +recognizes unformatted BD-RE and applies a lengthy formatting run. -Program growisofs can append to an ISO filesystem on DVD+RW by additionally -manipulating the first session. Meanwhile cdrskin can do the same. Option --grow_overwriteable_iso allows -multi (although unneeded), enables -msinfo and -toc, and makes blank=fast an invalidator for ISO filesystems on overwriteable media. diff --git a/libburn/branches/ZeroFourSix/cdrskin/cdrskin.1 b/libburn/branches/ZeroFourSix/cdrskin/cdrskin.1 index b6fa0bf2..1d4469b4 100644 --- a/libburn/branches/ZeroFourSix/cdrskin/cdrskin.1 +++ b/libburn/branches/ZeroFourSix/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 "May 06, 2008" +.TH CDRSKIN 1 "May 10, 2008" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -1201,11 +1201,9 @@ cdrskin dev=ATA:1,0,0 -v -atip .br cdrskin dev=/dev/hdc -toc .SS -.B Make used CD-RW or used unformatted DVD-RW writable again: +.B Prepare CD-RW or DVD-RW for re-use, DVD-RAM or BD-RE for first use: .br -cdrskin -v dev=/dev/sg1 blank=fast -eject -.br -cdrskin -v dev=/dev/dvd blank=all -eject +cdrskin -v dev=/dev/sg1 blank=as_needed -eject .SS .B Format DVD-RW to avoid need for blanking before re-use: .br @@ -1219,7 +1217,7 @@ cdrskin -v dev=/dev/sr0 blank=deformat_sequential .br cdrskin -v dev=/dev/hdc speed=12 fs=8m \\ .br --sao -eject padsize=300k my_image.iso +blank=as_needed -eject padsize=300k my_image.iso .SS .B Write compressed afio archive on-the-fly (not possible with minimally blanked DVD-RW): .br @@ -1227,7 +1225,7 @@ find . | afio -oZ - | \\ .br cdrskin -v dev=0,1,0 fs=32m speed=8 \\ .br --tao padsize=300k - +blank=as_needed padsize=300k - .SS .B Write multi-session to the same CD, DVD-R[W] or DVD+R[/DL]: .br diff --git a/libburn/branches/ZeroFourSix/cdrskin/cdrskin.c b/libburn/branches/ZeroFourSix/cdrskin/cdrskin.c index 6573beec..e50d87f8 100644 --- a/libburn/branches/ZeroFourSix/cdrskin/cdrskin.c +++ b/libburn/branches/ZeroFourSix/cdrskin/cdrskin.c @@ -7,7 +7,7 @@ A cdrecord compatible command line interface for libburn. This project is neither directed against original cdrecord nor does it exploit any source code of said program. It rather tries to be an alternative method -to burn CD or DVD, which is not based on the same code as cdrecord. +to burn CD, DVD, or BD, which is not based on the same code as cdrecord. See also : http://scdbackup.sourceforge.net/cdrskin_eng.html Interested users of cdrecord are encouraged to contribute further option @@ -88,7 +88,7 @@ or /** The official program version */ #ifndef Cdrskin_prog_versioN -#define Cdrskin_prog_versioN "0.4.5" +#define Cdrskin_prog_versioN "0.4.6" #endif /** The official libburn interface revision to use. @@ -101,7 +101,7 @@ or #define Cdrskin_libburn_minoR 4 #endif #ifndef Cdrskin_libburn_micrO -#define Cdrskin_libburn_micrO 4 +#define Cdrskin_libburn_micrO 6 #endif @@ -135,46 +135,44 @@ or #endif /* Cdrskin_libburn_cvs_A60220_tS */ -#ifdef Cdrskin_libburn_0_4_4 -#define Cdrskin_libburn_versioN "0.4.4" +#ifdef Cdrskin_libburn_0_4_6 +#define Cdrskin_libburn_versioN "0.4.6" #define Cdrskin_libburn_from_pykix_svN 1 -#endif /* Cdrskin_libburn_0_4_2 */ +#endif /* Cdrskin_libburn_0_4_6 */ -#ifdef Cdrskin_libburn_0_4_5 -#define Cdrskin_libburn_versioN "0.4.5" +#ifdef Cdrskin_libburn_0_4_7 +#define Cdrskin_libburn_versioN "0.4.7" #define Cdrskin_libburn_from_pykix_svN 1 /* Place novelty switch macros here. Move them down to Cdrskin_libburn_from_pykix_svN on version leap */ -#define Cdrskin_libburn_has_stream_recordinG 1 +/* there are no libburn novelties in 0.4.7 yet */ -/* there are novelties in 0.4.5 yet */ - -#endif /* Cdrskin_libburn_0_4_5 */ +#endif /* Cdrskin_libburn_0_4_7 */ #ifndef Cdrskin_libburn_versioN -#define Cdrskin_libburn_0_4_4 -#define Cdrskin_libburn_versioN "0.4.4" +#define Cdrskin_libburn_0_4_6 +#define Cdrskin_libburn_versioN "0.4.6" #define Cdrskin_libburn_from_pykix_svN 1 #endif -#ifdef Cdrskin_libburn_0_4_4 +#ifdef Cdrskin_libburn_0_4_6 #undef Cdrskin_libburn_majoR #undef Cdrskin_libburn_minoR #undef Cdrskin_libburn_micrO #define Cdrskin_libburn_majoR 0 #define Cdrskin_libburn_minoR 4 -#define Cdrskin_libburn_micrO 4 +#define Cdrskin_libburn_micrO 6 #endif -#ifdef Cdrskin_libburn_0_4_5 +#ifdef Cdrskin_libburn_0_4_7 #undef Cdrskin_libburn_majoR #undef Cdrskin_libburn_minoR #undef Cdrskin_libburn_micrO #define Cdrskin_libburn_majoR 0 #define Cdrskin_libburn_minoR 4 -#define Cdrskin_libburn_micrO 5 +#define Cdrskin_libburn_micrO 7 #endif @@ -242,10 +240,14 @@ or #define Cdrskin_libburn_has_drive_equals_adR 1 /* 0.4.2 */ -/* no novel features but rather organizational changes */ +/* no novel libburn features but rather organizational changes */ /* 0.4.4 */ -/* support for DVD+R/DL media is now official, BD-RE is experimental */ +/* novel libburn features are transparent to cdrskin */ + +/* 0.4.6 */ +#define Cdrskin_libburn_has_stream_recordinG 1 + #ifdef Cdrskin_new_api_tesT diff --git a/libburn/branches/ZeroFourSix/cdrskin/cdrskin_eng.html b/libburn/branches/ZeroFourSix/cdrskin/cdrskin_eng.html index af629160..638a4687 100644 --- a/libburn/branches/ZeroFourSix/cdrskin/cdrskin_eng.html +++ b/libburn/branches/ZeroFourSix/cdrskin/cdrskin_eng.html @@ -2,7 +2,7 @@ - + cdrskin homepage english @@ -17,15 +17,14 @@

Homepage of

cdrskin

-

Limited cdrecord compatibility wrapper for libburn

Purpose:

-Burns preformatted data to CD and DVD media:
-CD-R, DVD-R, DVD+R, DVD+R/DL, CD-RW, DVD-RW, DVD-RAM, DVD+RW +Burns preformatted data to CD, DVD, and BD media:
+CD-R, DVD-R, DVD+R, DVD+R/DL, CD-RW, DVD-RW, DVD-RAM, DVD+RW, BD-RE

@@ -35,10 +34,10 @@ CD-R, DVD-R, DVD+R, DVD+R/DL, CD-RW, DVD-RW, DVD-RAM, DVD+RW

Hardware requirements:

-A CD/DVD recorder suitable for +A CD/DVD/BD 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). +and to MMC-5 for DVD or BD).

@@ -58,7 +57,7 @@ and to MMC-5 for DVD). GPL software included:
-
libburn-0.4.4
+
libburn-0.4.6
(founded by Derek Foreman and Ben Jansens, furthered by team of libburnia-project.org)
transfers data to CD and DVD
@@ -86,10 +85,10 @@ Ports to other usable systems are appreciated. Reports are welcome.
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 +On all DVD media except DVD-R DL, 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. +most DVD types and with BD-RE.


Get an overview of drives and their addresses
@@ -107,9 +106,8 @@ as listed by option --devices.
$ 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
+
Prepare CD-RW or DVD-RW for re-use, DVD-RAM or BD-RE for first use:
+
$ cdrskin -v dev=/dev/sg1 blank=as_needed -eject
Format DVD-RW to avoid need for blanking before re-use:
$ cdrskin -v dev=/dev/sr0 blank=format_overwrite
@@ -120,12 +118,12 @@ as listed by option --devices.
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
+
  blank=as_needed -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 -
+
  blank=as_needed padsize=300k -
Write several sessions to the same CD, DVD-R[W] or DVD+R[/DL]:
$ cdrskin dev=/dev/hdc -v padsize=300k -multi -tao 1.iso @@ -176,8 +174,8 @@ Standalone ISO 9660 multi-session CD/DVD tool
-Testers wanted who are willing to risk some double layer DVD-R media -or to do experiments on BD-RE. +Testers wanted who are willing to risk some DVD-R DL media +or to do experiments on BD-R media.

@@ -188,8 +186,8 @@ or to do experiments on BD-RE.

Download as source code (see README):
-
cdrskin-0.4.4.pl00.tar.gz -(715 KB). +
cdrskin-0.4.6.pl00.tar.gz +(730 KB).
The cdrskin tarballs are source code identical with libburn releases @@ -198,7 +196,7 @@ They get produced via a different procedure, though.
cdrskin is part of libburn - full libburn is provided with cdrskin releases.
- -
  • Support for BD-RE media is now official
    • -
  • New blank type blank=as_needed for automatic handling -of media type and state
    • -
  • New option stream_recording=on can speed up DVD-RAM and BD-RE
    • -
  • New blank type blank=format_defectmgt for DVD-RAM and BD-RE
    • -
  • New option --list_formats
    • -
  • New blank type blank=format_by_index_<number>
    • +
  • none yet
    •  
    -
    README 0.4.5 -
    cdrskin_0.4.5 --help
    -
    cdrskin_0.4.5 -help
    -
    man cdrskin (as of 0.4.5)
    +
    README 0.4.7 +
    cdrskin_0.4.7 --help
    +
    cdrskin_0.4.7 -help
    +
    man cdrskin (as of 0.4.7)
     
    Maintainers of cdrskin unstable packages please use SVN of libburnia-project.org
    @@ -296,11 +292,11 @@ admins with full system souvereignty. upcoming README ):
    -cdrskin-0.4.5.tar.gz +cdrskin-0.4.7.tar.gz (730 KB).
    -