Did a little overhaul of general paragraphs, mentioned new option -waiti

This commit is contained in:
Thomas Schmitt 2007-09-19 10:12:24 +00:00
parent 6a0742efd2
commit 3994e62697

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 "September 17, 2007" .TH CDRSKIN 1 "September 19, 2007"
.\" 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:
@ -48,7 +48,9 @@ or on DVD-R[W] (in Incremental mode) or on DVD+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
or on overwriteable DVD+RW, DVD-RW, DVD-RAM, Single session or emulated multi-session
.br
on overwriteable DVD+RW, DVD-RW, DVD-RAM,
.br .br
or on data file or block device. or on data file or block device.
.br .br
@ -114,6 +116,19 @@ the archivers afio and star. Not suitable seems GNU tar.
.PP .PP
.B Write mode selection: .B Write mode selection:
.br .br
In general there are two approaches for writing media:
.br
A permissive mode depicted by option
.B -tao
which needs no predicted track size and allows to make use of
eventual multi-session capabilities.
.br
A more restrictive mode
.B -sao
(alias -dao) which usually demands a predictable track size and is not
necessarily capable of multi-session. It may have advantages for some
readers resp. players of the recorded tracks.
.br
If none of the options -dao, -tao or -sao is given then the program will If none of the options -dao, -tao or -sao is given then the program will
try to choose a write mode which matches the defined recording job, try to choose a write mode which matches the defined recording job,
the capabilities of the drive and the state of the present media. the capabilities of the drive and the state of the present media.
@ -130,15 +145,11 @@ read-only. Closing is done automatically unless option
.B -multi .B -multi
is given which keeps the media appendable. is given which keeps the media appendable.
.br .br
There are two write modes, Write mode
.B -tao
and
.B -sao .
.br
-tao allows to use track source of unpredictable length (like stdin) and allows -tao allows to use track source of unpredictable length (like stdin) and allows
to write further sessions to appendable media. -sao produces audio sessions to write further sessions to appendable media.
with seamless tracks but needs predicted track sizes and cannot append sessions -sao produces audio sessions with seamless tracks but needs predicted track
to media. sizes and cannot append sessions to media.
.br .br
CD-RW media can be blanked to make them re-usable for another CD-RW media can be blanked to make them re-usable for another
round of overwriting. Usually round of overwriting. Usually
@ -208,7 +219,8 @@ single continuous data area for blockwise random access.
Option -audio is not allowed. Only one track is allowed. Option -audio is not allowed. Only one track is allowed.
Option -multi cannot mark a recognizeable end of overwriteable media. Option -multi cannot mark a recognizeable end of overwriteable media.
Therefore -multi is banned unless ISO-9660 images shall be expandable by help Therefore -multi is banned unless ISO-9660 images shall be expandable by help
of option --grow_overwriteable_iso. of option
.B --grow_overwriteable_iso .
Without this option or without an ISO-9660 filesystem image present Without this option or without an ISO-9660 filesystem image present
on media, -toc does not return information about the media content and on media, -toc does not return information about the media content and
media get treated as blank regardless wether they hold data or not. media get treated as blank regardless wether they hold data or not.
@ -667,6 +679,23 @@ some extra lines to be put out with info retrieval options.
Level 2 additionally reports about option settings derived from arguments or Level 2 additionally reports about option settings derived from arguments or
startup files. Level 3 is for debugging and useful mainly in conjunction with startup files. Level 3 is for debugging and useful mainly in conjunction with
somebody who had a look into the program sourcecode. somebody who had a look into the program sourcecode.
.TP
.BI \-waiti
Wait until input data is available at stdin or EOF occurs at stdin.
Only then begin to access any drives.
.br
One should use this if cdrskin is working at the end of a pipe where the
feeder process reads from the drive before it starts writing its output into
cdrskin. Example:
.br
mkisofs ... -C 0,12800 -M /dev/sr0 | \\
.br
cdrskin dev=/dev/sr0 ... -waiti -
.br
This option works even if stdin is not among the track sources. If no process
is piping in, then the Enter key of your terminal will act as trigger for
cdrskin. Note that this input line will not be consumed by cdrskin if stdin
is not among the track sources. It will end up as shell command, usually.
.PP .PP
Alphabetical list of options which are genuine to cdrskin and intended for Alphabetical list of options which are genuine to cdrskin and intended for
normal use: normal use:
@ -763,7 +792,9 @@ Enable emulation of multi-session writing on overwriteable media which
contain an ISO-9660 filesystem. This emulation is learned from growisofs -M contain an ISO-9660 filesystem. This emulation is learned from growisofs -M
but adapted to the usage model of but adapted to the usage model of
.br .br
.B cdrskin -msinfo ; mkisofs -C -M | cdrskin [-multi] - .B cdrskin -msinfo
.br
.B mkisofs -C -M | cdrskin -waiti [-multi] -
.br .br
--grow_overwriteable_iso does not hamper the use of true multi-session media. --grow_overwriteable_iso does not hamper the use of true multi-session media.
I.e. it is possible to use the same cdrskin options with both kinds of media I.e. it is possible to use the same cdrskin options with both kinds of media
@ -788,9 +819,11 @@ eventual ISO-9660 image by altering the first few bytes of block 16 on
overwriteable media. overwriteable media.
Option -multi is tolerated in order not to hamper true multi-session media. Option -multi is tolerated in order not to hamper true multi-session media.
.br .br
Note: The equivalent of growisofs -Z is An equivalent of growisofs -Z for overwriteable media is:
.br .br
.B mkisofs | cdrskin --grow_overwriteable_iso blank=fast [-multi] .B mkisofs | cdrskin --grow_overwriteable_iso blank=fast [-multi] -
.br
With multi-session DVD, blank=fast will act like dvd+rw-format -blank=full .
.br .br
growisofs -dvd-compat is roughly equivalent to cdrskin without option -multi. growisofs -dvd-compat is roughly equivalent to cdrskin without option -multi.
.TP .TP