libburnia/legacy
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Unified some nomenclature. Removed an error with dev_translation=

Browse Source
This commit is contained in:
Thomas Schmitt 2006-12-14 10:22:17 +00:00
parent 7dfbc05395
commit a9edb33a4f
1 changed files with 21 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
libburn/trunk/cdrskin/cdrskin.1
View File

@ -50,13 +50,15 @@ See section EXAMPLES at the end of this text.
.br .br
No DVD support yet. No DVD support yet.
.PP .PP
.B Data recording model: .B Track recording model:
.br .br
The input-output entities which get processed are called "tracks". Each track The input-output entities which get processed are called tracks.
is depicted by one input argument, which may either be "-" for standard input A track stores a stream of bytes.
or the address of a readable file. If no write mode is given explicitely then .br
one will be choosen which matches the peculiarities of track input and the Each track is initiated by one track source address argument, which may either
state of the output media. be "-" for standard input or the address of a readable file. If no write mode
is given explicitely then one will be chosen which matches the peculiarities
of track source and the state of the output media.
.PP .PP
There can be more than one track burned by a single run of cdrskin. There can be more than one track burned by a single run of cdrskin.
CDs can be kept appendable so that further tracks can CDs can be kept appendable so that further tracks can
@ -118,7 +120,7 @@ Retrieve some info about media state. With CD-RW print "Is erasable".
.TP .TP
.BI \-audio .BI \-audio
Announces that the subsequent tracks are to be burned as audio. Announces that the subsequent tracks are to be burned as audio.
The input is supposed to be uncompressed headerless PCM, 44100 Hz, 16 bit, The source is supposed to be uncompressed headerless PCM, 44100 Hz, 16 bit,
stereo. For little-endian byte order (which is usual on PCs) use option stereo. For little-endian byte order (which is usual on PCs) use option
-swab. Input files with suffix .wav are examined wether they have a header -swab. Input files with suffix .wav are examined wether they have a header
in MS-WAVE format confirming those parameters and eventually raw audio data in MS-WAVE format confirming those parameters and eventually raw audio data
@ -166,8 +168,8 @@ Bus,Target,Lun addresses.
.TP .TP
.BI driveropts= opt .BI driveropts= opt
Set "driveropts=burnfree" to enable the drive's eventual protection mechanism Set "driveropts=burnfree" to enable the drive's eventual protection mechanism
against temporary lack of input data (i.e. buffer underrun). It is not an error against temporary lack of source data (i.e. buffer underrun).
to do this with a drive that has no such capabilities. It is not an error to do this with a drive that has no such capabilities.
.TP .TP
.BI \-dummy .BI \-dummy
Try to perform the drive operations without actually affecting the inserted Try to perform the drive operations without actually affecting the inserted
@ -193,9 +195,11 @@ multiply the preceding number:
.br .br
Set size to 0 in order to disable the fifo (default is "4m"). Set size to 0 in order to disable the fifo (default is "4m").
.br .br
The fifo buffers an eventual temporary surplus of input data in order to The fifo buffers an eventual temporary surplus of track source data in order to
provide the drive with a steady stream during times of temporary lack of input. provide the drive with a steady stream during times of temporary lack of track
The larger the fifo, the longer periods of poor input can be compensated. source supply.
The larger the fifo, the longer periods of poor source supply can be
compensated.
But a large fifo needs substantial time to fill up if not curbed via But a large fifo needs substantial time to fill up if not curbed via
option fifo_start_at=size. option fifo_start_at=size.
.TP .TP
@ -275,8 +279,8 @@ Set speed of drive. With data CD, 1x speed corresponds to a throughput of
and media. One should stay within a realistic speed range, though. and media. One should stay within a realistic speed range, though.
.TP .TP
.BI \-swab .BI \-swab
Announce that raw audio data input of subsequent tracks is byte swapped versus Announce that the raw audio data source of subsequent tracks is byte swapped
the expectations of cdrecord. This option is suitable for audio where versus the expectations of cdrecord. This option is suitable for audio where
the least significant byte of a 16 bit word is first (little-endian, Intel). the least significant byte of a 16 bit word is first (little-endian, Intel).
Most raw audio data on PC systems are available in this byte order. Most raw audio data on PC systems are available in this byte order.
Less guesswork is needed if track sources are in format MS-WAVE in a file with Less guesswork is needed if track sources are in format MS-WAVE in a file with
@ -372,7 +376,7 @@ Do not wait for full fifo but start burning as soon as the given number
of bytes is read. This option may be helpful to bring the average throughput of bytes is read. This option may be helpful to bring the average throughput
near to the maximum throughput of a drive. A large fs= and a small near to the maximum throughput of a drive. A large fs= and a small
fifo_start_at= combine a quick burn start and a large savings buffer to fifo_start_at= combine a quick burn start and a large savings buffer to
compensate for temporary lack of input data. At the beginning of burning, compensate for temporary lack of source data. At the beginning of burning,
the software protection against buffer underun is as weak as the size of the software protection against buffer underun is as weak as the size of
fifo_start_at= . So it is best if the drive offers hardware protection which fifo_start_at= . So it is best if the drive offers hardware protection which
has to be enabled by driveropts=burnfree. has to be enabled by driveropts=burnfree.
@ -399,7 +403,7 @@ This option is only needed for revoking eventual --ignore_signals or
--no_abort_handler. --no_abort_handler.
.TP .TP
.BI dev_translation= <sep><from><sep><to> .BI dev_translation= <sep><from><sep><to>
Set input address alias. This was necessary before cdrskin-0.2.4 to manually Set drive address alias. This was necessary before cdrskin-0.2.4 to manually
translate cdrecord addresses into cdrskin addresses. translate cdrecord addresses into cdrskin addresses.
.br .br
<sep> is a single character which may not occur in the address string <sep> is a single character which may not occur in the address string
@ -576,7 +580,7 @@ fs=16m
.br .br
.SH SEE ALSO .SH SEE ALSO
.TP .TP
Formatting track input for cdrskin: Formatting track sources for cdrskin:
.br .br
.BR mkisofs (8), .BR mkisofs (8),
.BR genisoimage (8), .BR genisoimage (8),