New command -read_speed

This commit is contained in:
2013-10-08 17:58:09 +00:00
parent 7e10d412a8
commit 0f3131cf0c
13 changed files with 417 additions and 168 deletions

View File

@ -9,7 +9,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 XORRISO 1 "Version 1.3.3, Sep 07, 2013"
.TH XORRISO 1 "Version 1.3.3, Oct 08, 2013"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -692,6 +692,38 @@ The following commands should normally be performed before loading an image
by acquiring an input drive. In rare cases it is desirable to activate
them only after image loading.
.TP
\fB\-read_speed\fR code|number[k|m|c|d|b]
Set the speed for reading. Default is "none", which avoids to send a speed
setting command to the drive before reading begins.
.br
Further special speed codes are:
.br
"max" (or "0") selects maximum speed as announced by the drive.
.br
"min" (or "\-1") selects minimum speed as announced by the drive.
.br
Speed can be given in media dependent numbers or as a
desired throughput per second in MMC compliant kB (= 1000)
or MB (= 1000 kB). Media x\-speed factor can be set explicity
by "c" for CD, "d" for DVD, "b" for BD, "x" is optional.
.br
Example speeds:
.br
706k = 706kB/s = 4c = 4xCD
.br
5540k = 5540kB/s = 4d = 4xDVD
.br
If there is no hint about the speed unit attached, then the
medium in the \-indev will decide. Default unit is CD = 176.4k.
.br
MMC drives usually activate their own idea of speed and take
the speed value given by the burn program only as upper limit
for their own decision.
.br
Depending on the drive, the reported read speeds can be deceivingly low.
Often it is possible to achieve higher read speeds by bold values
like "20xDVD" or "16xBD".
.TP
\fB\-load\fR entity id
Load a particular (possibly outdated) ISO session from \-dev or \-indev.
Usually all available sessions are shown with command \-toc.
@ -2291,8 +2323,11 @@ MMC format codes are manifold. Most important are:
Smaller format size with DVD\-RAM, BD\-RE, or BD\-R means more reserve space.
.TP
\fB\-list_speeds\fR
Put out a list of speed values as reported by the output drive with
the loaded medium. This does not necessarily mean that the medium is writable
Put out a list of speed values as reported by the drives with the loaded
media. The list tells read speeds of the input drive and of the output
drive. Further it tells write speeds of the output drive.
.br
The list of write speeds does not necessarily mean that the medium is writable
or that these speeds are actually achievable. Especially the
lists reported with empty drive or with ROM media obviously advertise
speeds for other media.
@ -2302,13 +2337,16 @@ The drive is supposed to choose a safe speed that is as near to the desired
speed as possible.
.br
At the end of the list, "Write speed L" and "Write speed H"
are the best guesses for lower and upper speed limit.
are the best guesses for lower and upper write speed limit.
"Write speed l" and "Write speed h" may appear only with CD
and eventually override the list of other speed offers.
.br
Only if the drive reports contradicting speed information there will appear
"Write speed 0", which tells the outcome of speed selection by command
\-speed 0, if it deviates from "Write speed H".
.br
"Read speed L" and "Read speed H" tell the minimum and maximum read speeds,
as would be chosen by \-read_speed "min" resp. "max".
.TP
\fB\-close_damaged\fR "as_needed"|"force"
Try to close the upcomming track and session if the drive reported the medium
@ -2665,8 +2703,16 @@ mkzftree.
.br
"default" same as "level=6:block_size=32k:by_magic=off"
.TP
\fB\-speed\fR number[k|m|c|d|b]
Set the burn speed. Default is 0 = maximum speed.
\fB\-speed\fR code|number[k|m|c|d|b]
Set the burn speed. Default is "max" (or "0") = maximum speed as announced
by the drive.
Further special speed codes are:
.br
"min" (or "\-1") selects minimum speed as announced by the drive.
.br
"none" avoids to send a speed setting command to the drive before
burning begins.
.br
Speed can be given in media dependent numbers or as a
desired throughput per second in MMC compliant kB (= 1000)
or MB (= 1000 kB). Media x\-speed factor can be set explicity