Mentioning BD-R in documentation

This commit is contained in:
Thomas Schmitt 2008-12-10 17:16:19 +00:00
parent 0d669b4369
commit 83ed108298
4 changed files with 89 additions and 63 deletions

80
README
View File

@ -4,44 +4,56 @@
This all is under GPL. This all is under GPL.
(See GPL reference, our clarification and commitment at the end of this text) (See GPL reference, our clarification and commitment at the end of this text)
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
libburnia-project.org libburn-project.org
By Mario Danic <mario.danic@gmail.com> and Thomas Schmitt <scdbackup@gmx.net> By Mario Danic <mario.danic@gmail.com> and Thomas Schmitt <scdbackup@gmx.net>
Copyright (C) 2006-2008 Mario Danic, Thomas Schmitt Copyright (C) 2006-2008 Mario Danic, Thomas Schmitt
Still containing parts of Libburn. By Derek Foreman <derek@signalmarketing.com>
Still containing parts of and Ben Jansens <xor@orodu.net>
Libburn. By Derek Foreman <derek@signalmarketing.com> and
Ben Jansens <xor@orodu.net>
Copyright (C) 2002-2006 Derek Foreman and Ben Jansens Copyright (C) 2002-2006 Derek Foreman and Ben Jansens
This libburnia-project.org toplevel README (C) 2006-2008 Thomas Schmitt http://files.libburnia-project.org/releases/libburn-0.5.8.pl00.tar.gz
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
Build and Installation Build and Installation
Our build system is based on autotools. For preparing the build of a SVN From tarball
snapshot you will need autotools of at least version 1.7.
Check out from SVN by
svn co http://svn.libburnia-project.org/libburn/trunk libburn
go into directory libburn and apply autotools by
./bootstrap
Alternatively you may unpack a release tarball for which you do not need Obtain libburn-0.5.8.pl00.tar.gz, take it to a directory of your choice and do:
autotools installed.
To build a libburnia-project.org subproject it should be sufficient to go tar xzf libburn-0.5.8.pl00.tar.gz
into its toplevel directory (here: "libburn") and execute cd libburn-0.5.8
./configure --prefix=/usr ./configure --prefix=/usr
make make
To make libburn accessible for running resp. application development, To make libburn accessible for running resp. application development,
and to install the cdrecord compatibility binary cdrskin, do: and to install the cdrecord compatibility binary cdrskin, do
(as Superuser):
make install make install
This procedure installs libburn.so.4 and cdrskin depending on it.
Above procedure installs cdrskin depending on libburn.so.4 .
For a standalone cdrskin binary, see cdrskin/README. For a standalone cdrskin binary, see cdrskin/README.
From SVN
Our build system is based on autotools. For preparing the build of a SVN
snapshot you will need autotools of at least version 1.7.
Do in a directory of your choice:
svn co http://svn.libburnia-project.org/libburn/trunk libburn-0.5.9
cd libburn-0.5.9
./bootstrap
./configure --prefix=/usr
make
make install
Warning: The trunk might contain experimental features which might not
persist until next release.
------------------------------------------------------------------------------
An important part of the project, libisofs, is hosted in a bzr repository at An important part of the project, libisofs, is hosted in a bzr repository at
launchpad.net : launchpad.net :
bzr branch lp:libisofs bzr branch lp:libisofs
@ -51,7 +63,6 @@ Another part the project, libisoburn, is hosted in the libburnia SVN, too:
See README files there. See README files there.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
@ -59,7 +70,7 @@ See README files there.
libburnia-project.org is an open-source software project for reading, mastering libburnia-project.org is an open-source software project for reading, mastering
and writing optical discs. and writing optical discs.
For now this means only CD media and all single layer DVD media except DVD+R. For now this means CD media, all DVD media except DVD-R DL, all BD media.
The project comprises of several more or less interdependent parts which The project comprises of several more or less interdependent parts which
together strive to be a usable foundation for application development. together strive to be a usable foundation for application development.
@ -68,18 +79,16 @@ classical (and valuable) Linux tools.
Currently it is supported on Linux with kernels >= 2.4 and on FreeBSD versions Currently it is supported on Linux with kernels >= 2.4 and on FreeBSD versions
with ATAPI/CAM support enabled in the kernel, see atapicam(4). with ATAPI/CAM support enabled in the kernel, see atapicam(4).
Our scope is currently Linux 2.4 or 2.6 and FreeBSD versions with ATAPI/CAM For ports to other systems we would need : login on a development machine
support enabled in the kernel, see atapicam(4). For ports to other systems resp. a live OS on CD or DVD, advise from a system person about the equivalent
we would need : login on a development machine resp. a live OS on CD or DVD, of Linux sg or FreeBSD CAM, volunteers for testing of realistic use cases.
advise from a system person about the equivalent of Linux sg or FreeBSD CAM,
volunteers for testing of realistic use cases.
We have a well tested code base for burning data and audio CDs and many DVD We have a well tested code base for burning data and audio CDs, DVDs and BDs.
types. The burn API is quite comprehensively documented and can be used to The burn API is quite comprehensively documented and can be used to build a
build a presentable application. presentable application.
We have a functional binary which emulates the core use cases of cdrecord in We have a functional application which emulates the core use cases of cdrecord
order to prove that usability, and in order to allow you to explore libburn's in order to prove that usability, and in order to allow you to explore
scope by help of existing cdrecord frontends. libburn's scope by help of existing cdrecord frontends.
ISO 9660 filesystems with Rock Ridge and Joliet extensions can be created ISO 9660 filesystems with Rock Ridge and Joliet extensions can be created
and manipulated quite freely. This capability together with our burn capability and manipulated quite freely. This capability together with our burn capability
@ -119,8 +128,9 @@ The project components (list subject to growth, hopefully):
- xorriso is an application of all three libraries which creates, loads, - xorriso is an application of all three libraries which creates, loads,
manipulates and writes ISO 9660 filesystem images with manipulates and writes ISO 9660 filesystem images with
Rock Ridge extensions. Manipulation is not only adding or Rock Ridge extensions. Manipulation is not only adding or
overwriting of files but also deletion, renaming, and attribute overwriting of files but also deleting, renaming, attribute
changing. changing, incremental backups, activating boot images, and
extracting of files from ISO images to disk.
See xorriso/README for more. See xorriso/README for more.
- "test" is a collection of application gestures and examples given by the - "test" is a collection of application gestures and examples given by the
@ -336,6 +346,8 @@ Project history as far as known to me:
- 7th Dec 2008 libburn-0.5.8 prevents a SIGSEGV with wierd CD table-of-content - 7th Dec 2008 libburn-0.5.8 prevents a SIGSEGV with wierd CD table-of-content
and improves BD-RE formatting. and improves BD-RE formatting.
- 9th Dec 2008 Our project received a donation from Thomas Weber.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------

View File

@ -274,8 +274,8 @@ behavior.
BD-RE media need formatting before first use. cdrskin option "blank=as_needed" BD-RE media need formatting before first use. cdrskin option "blank=as_needed"
recognizes unformatted BD-RE and applies a lengthy formatting run. recognizes unformatted BD-RE and applies a lengthy formatting run.
During write operations DVD-RAM and BD-RE automatically apply defect During write operations DVD-RAM and BD-RE automatically apply Defect
management. This usually slows them down to half nominal speed. If drive Management. This usually slows them down to half nominal speed. If drive
and media produce flawless results anyway, then one can try to reach full and media produce flawless results anyway, then one can try to reach full
nominal speed by option "stream_recording=on". nominal speed by option "stream_recording=on".
In this case bad blocks are not detected during write and not even previously In this case bad blocks are not detected during write and not even previously
@ -350,14 +350,24 @@ Incremental Streaming afterwards. So blank=fast will do full blanking.
blank=deformat_sequential_quickest is faster but might yield DAO-only media. blank=deformat_sequential_quickest is faster but might yield DAO-only media.
DVD+R and DVD+R DL DVD+R , DVD+R DL , BD-R
From the view of cdrskin they behave much like DVD-R. Each track gets wrapped From the view of cdrskin they behave much like DVD-R. Each track gets wrapped
into an own session, though. into an own session, though.
DVD+R DL appear as extra large DVD+R. cdrskin does not allow to set the address DVD+R DL appear as extra large DVD+R. cdrskin does not allow to set the address
of the layer break where a reading drive might show some delay while switching of the layer break where a reading drive might show some delay while switching
between both media layers. between both media layers.
BD-R are sold unformatted blank. If used without initial formatting then the
drive is supposed to format them to maximum payload size with no Defect
Management (see also above with BD-RE).
If Defect Management is desired then BD-R need to be formatted before the
first attempt to write a session to them.
blank=format_if_needed will detect the situation and eventually apply
default sized Defect Management formatting.
blank=format_defectmgt_* will apply non-default parameters to formatting.
Emulated Drives Emulated Drives

View File

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH CDRSKIN 1 "Oct 15, 2008" .TH CDRSKIN 1 "Dec 10, 2008"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -16,7 +16,7 @@
.\" .sp <n> insert n+1 empty lines .\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7) .\" for manpage-specific macros, see man(7)
.SH NAME .SH NAME
cdrskin \- burns preformatted data to CD, DVD, and BD-RE via libburn. cdrskin \- burns preformatted data to CD, DVD, and BD via libburn.
.SH SYNOPSIS .SH SYNOPSIS
.B cdrskin .B cdrskin
.RI [ options | track_source_addresses ] .RI [ options | track_source_addresses ]
@ -28,14 +28,14 @@ cdrskin \- burns preformatted data to CD, DVD, and BD-RE via libburn.
.\" respectively. .\" respectively.
.PP .PP
\fBcdrskin\fP is a program that provides some of cdrecord's options \fBcdrskin\fP is a program that provides some of cdrecord's options
in a compatible way for CD media. With DVD and BD-RE it has its own ways. in a compatible way for CD media. With DVD and BD it has its own ways.
You do not need to be superuser for its daily usage. You do not need to be superuser for its daily usage.
.SS .SS
.B Overview of features: .B Overview of features:
.br .br
Blanking of CD-RW and DVD-RW. Blanking of CD-RW and DVD-RW.
.br .br
Formatting of DVD-RW, DVD+RW, DVD-RAM, BD-RE. Formatting of DVD-RW, DVD+RW, DVD-RAM, BD.
.br .br
Burning of data or audio tracks to CD, Burning of data or audio tracks to CD,
.br .br
@ -45,7 +45,7 @@ or in Session at Once mode for seamless tracks.
.br .br
Multi session on CD (follow-up sessions in TAO only) Multi session on CD (follow-up sessions in TAO only)
.br .br
or on DVD-R[W] (in Incremental mode) or on DVD+R[/DL]. or on DVD-R[W] (in Incremental mode) or DVD+R[/DL] or BD-R.
.br .br
Single session on DVD-RW or DVD-R (Disk-at-once). Single session on DVD-RW or DVD-R (Disk-at-once).
.br .br
@ -164,10 +164,10 @@ make it completely unreadable. It is no effective privacy precaution.
Multiple cycles of blanking and overwriting with random numbers might be Multiple cycles of blanking and overwriting with random numbers might be
needed. needed.
.SS .SS
.B Sequentially Recordable DVD Media: .B Sequentially Recordable DVD or BD Media:
.br .br
Currently DVD-RW, DVD-R and DVD+R[/DL] can be used for the Sequential recording Currently DVD-RW, DVD-R , DVD+R[/DL], and BD-R can be used for the Sequential
model. recording model.
.br .br
This applies to DVD-RW only if they are in state "Sequential Recording". This applies to DVD-RW only if they are in state "Sequential Recording".
The media must be either blank or appendable. The media must be either blank or appendable.
@ -201,14 +201,18 @@ unpredicted length and to keep media appendable by option
The only restriction towards CD-R[W] is the lack of support for -audio tracks. The only restriction towards CD-R[W] is the lack of support for -audio tracks.
Multiple tracks per session are permissible. Multiple tracks per session are permissible.
.br .br
The write modes for DVD+R[/DL] resemble those with DVD-R except that with +R The write modes for DVD+R[/DL] and BD-R resemble those with DVD-R except that
each track gets wrapped in an own session. There is no -dummy writing with each track gets wrapped in an own session. There is no -dummy writing
DVD+R[/DL]. with DVD+R[/DL] or BD-R.
.br .br
Quite deliberately write mode -sao insists in the tradition of a predicted Quite deliberately write mode -sao insists in the tradition of a predicted
track size and blank media, whereas -tao writes the tracks open ended and track size and blank media, whereas -tao writes the tracks open ended and
allows appendable media. allows appendable media.
.br .br
BD-R may be formatted before first use to enable the Defect Management which
might catch and repair some bad spots at the expense of slow speed
even with flawless media.
.br
.B Note: .B Note:
Option -multi might make DVD media unreadable in some DVD-ROM drives. Option -multi might make DVD media unreadable in some DVD-ROM drives.
Best reader compatibility is achieved without it Best reader compatibility is achieved without it
@ -353,7 +357,7 @@ audio track. Same is done for suffix ".au" and SUN Audio.
Option -audio may be used only with CD media and not with DVD or BD. Option -audio may be used only with CD media and not with DVD or BD.
.TP .TP
.BI blank= type .BI blank= type
Blank a CD-RW, DVD-RW, or format a DVD-RW, DVD+RW, DVD-RAM, BD-RE. Blank a CD-RW, DVD-RW, or format a DVD-RW, DVD+RW, DVD-RAM, BD.
This is combinable with burning in the same run of cdrskin. This is combinable with burning in the same run of cdrskin.
The type given with blank= selects the particular behavior: The type given with blank= selects the particular behavior:
.RS .RS
@ -365,7 +369,7 @@ It is a reason to abort if the media cannot assume thoroughly writeable state,
e.g. if it is non-blank write-once. e.g. if it is non-blank write-once.
.br .br
This leaves unformatted DVD-RW in unformatted blank state. To format DVD-RW use This leaves unformatted DVD-RW in unformatted blank state. To format DVD-RW use
blank=format_overwriteable. blank=format_overwriteable. Blank unformatted BD-R stay unformatted.
.br .br
(Note: blank=as_needed is not an original cdrecord option.) (Note: blank=as_needed is not an original cdrecord option.)
.TP .TP
@ -394,10 +398,11 @@ This is faster than full blanking but may yield media incapable of
Incremental Streaming (-tao). Incremental Streaming (-tao).
.TP .TP
format_if_needed format_if_needed
Format a media if it is not overwriteably formatted yet, Format a media if it is not formatted yet,
and if cdrskin supports formatting for the media type, and if cdrskin supports formatting for the media type,
and if formatting will not happen automatically during write. and if formatting will not happen automatically during write.
This currently applies to unformatted DVD-RW, DVD-RAM and BD-RE. This currently applies to unformatted DVD-RW, DVD-RAM, BD-RE,
and blank unformatted BD-R.
Eventually the appropriate default formatting is chosen. Eventually the appropriate default formatting is chosen.
If other media or states are encountered then nothing happens. If other media or states are encountered then nothing happens.
.br .br
@ -427,7 +432,7 @@ For DVD+RW this is the only supported explicit formatting type. It provides
complete "de-icing" so no reader slips on unwritten data areas. complete "de-icing" so no reader slips on unwritten data areas.
.TP .TP
format_defectmgt format_defectmgt
Format DVD-RAM or BD-RE to reserve the default amount of spare blocks for Format DVD-RAM or BD to reserve the default amount of spare blocks for
defect management. defect management.
.br .br
The following format_defectmgt_* allow to submit user wishes which The following format_defectmgt_* allow to submit user wishes which
@ -451,25 +456,24 @@ Whether there happens certification at all depends much on the media state
and the actually selected format descriptor. and the actually selected format descriptor.
.TP .TP
format_defectmgt_max format_defectmgt_max
Format DVD-RAM or BD-RE to reserve a maximum number of spare blocks. Format DVD-RAM or BD to reserve a maximum number of spare blocks.
.TP .TP
format_defectmgt_min format_defectmgt_min
Format DVD-RAM or BD-RE to reserve a minimum number of spare blocks. Format DVD-RAM or BD to reserve a minimum number of spare blocks.
It might be necessary to format format_defectmgt_none first in order to get It might be necessary to format format_defectmgt_none first in order to get
offered the most minmal spare blocks sizes for format_defectmgt_min. offered the most minmal spare blocks sizes for format_defectmgt_min.
.TP .TP
format_defectmgt_none format_defectmgt_none
Format DVD-RAM or BD-RE to the largest available payload in the hope to disable Format DVD-RAM or BD to the largest available payload in the hope to disable
defect management at all. This seems not to have a speed increasing effect, defect management at all. This may or may not have a speed increasing effect.
though.
.TP .TP
format_defectmgt_payload_<size> format_defectmgt_payload_<size>
Format DVD-RAM or BD-RE. The text after "format_defectmgt_payload_" gives a Format DVD-RAM or BD. The text after "format_defectmgt_payload_" gives a
number of bytes, eventually with suffixes "s", "k", "m". The largest number number of bytes, eventually with suffixes "s", "k", "m". The largest number
of spare blocks will be chosen which allows at least the given payload size. of spare blocks will be chosen which allows at least the given payload size.
.TP .TP
format_by_index_<number> format_by_index_<number>
Format DVD-RW, DVD+RW, DVD-RAM or BD-RE. Format DVD-RW, DVD+RW, DVD-RAM or BD.
The number after "format_by_index_" is used as index to the list of available The number after "format_by_index_" is used as index to the list of available
format descriptors. This list can be obtained by option --list_formats. format descriptors. This list can be obtained by option --list_formats.
The numbers after text "Format idx" are the ones to be used with The numbers after text "Format idx" are the ones to be used with
@ -1182,7 +1186,7 @@ original cdrecord.
.TP .TP
.BI stream_recording="on"|"off" .BI stream_recording="on"|"off"
By setting "on" request that compliance to the desired speed setting is By setting "on" request that compliance to the desired speed setting is
preferred over management of write errors. With DVD-RAM and BD-RE this can preferred over management of write errors. With DVD-RAM and BD this can
bring effective write speed near to the nominal write speed of the media. bring effective write speed near to the nominal write speed of the media.
But it will also disable the automatic use of replacement blocks But it will also disable the automatic use of replacement blocks
if write errors occur. It might as well be disliked or ignored by the drive. if write errors occur. It might as well be disliked or ignored by the drive.

View File

@ -10,8 +10,8 @@ Schilling's cdrtools. cdrskin strives to be a second source for the services
traditionally provided by cdrecord. Currently it does CD-R and CD-RW this way. traditionally provided by cdrecord. Currently it does CD-R and CD-RW this way.
Overwriteable media DVD-RAM, DVD+RW, DVD-RW, and BD-RE are handled differently Overwriteable media DVD-RAM, DVD+RW, DVD-RW, and BD-RE are handled differently
than with cdrecord-ProDVD in order to offer TAO-like single track recording. than with cdrecord-ProDVD in order to offer TAO-like single track recording.
Sequential DVD-R[W], DVD+R, DVD+R DL are handled like CD-R[W] with TAO and Sequential DVD-R[W], DVD+R, DVD+R DL, BD-R are handled like CD-R[W] with TAO
multi-session. Additionally cdrskin offers cdrecord-ProDVD-like mode DAO and multi-session. Additionally cdrskin offers cdrecord-ProDVD-like mode DAO
with DVD-R[W]. with DVD-R[W].
cdrskin does not contain any bytes copied from cdrecord's sources. cdrskin does not contain any bytes copied from cdrecord's sources.