New command -truncate_overwritable

This commit is contained in:
2020-08-06 17:39:47 +02:00
parent ec49c627f9
commit 04a82ce28d
10 changed files with 885 additions and 98 deletions

View File

@ -2652,6 +2652,57 @@ as reported by the drive. They would be chosen by \-read_speed "min" or
"max" if they undercut or surpass the built\-in limits. These are "1x",
"52xCD", "24xDVD", "20xBD".
.TP
\fB\-list_profiles\fR "in"|"out"|"all"
Put out a list of media types supported by \-indev, \-outdev, or both,
respectively.
The currently recognized type is marked by text "(current)".
.TP
\fB\-truncate_overwritable\fR entity id adjust
On overwritable medium copy the volume descriptors of an existing session to
the overall descriptors at LBA 0 ff. This makes all sessions
\fBinaccessible\fR which are younger than the activated one.
A reason to do this would be read errors in the younger sessions and
the wish to re\-write or skip them.
.br
This operation is only allowed if no changes to the loaded filesystem are
pending. If an \-indev is acquired then it is released before the write
operation begins and re\-acquired only in case of success.
.br
The parameters "entity" and "id" have the same meaning as with command \-load.
They choose the existing ISO session which shall become the youngest accessible
session. Available entity names are "session", "track", "lba", "sbsector",
"volid". "auto" makes few sense. id is a number or search text as appropriate
for the given entity.
.br
Parameter "adjust" controls the claimed size of the activated session. Text
"new" means the size of the newly activated session as it was before this
command. I.e. the space of the then inaccessible younger sessions will be
re\-used when appending more sessions.
.br
"old" means the size up to the end of the previously youngest session.
I.e. "old" will not free the space of the then inaccessible younger sessions
for re\-use.
.br
A number preceded by "+" gives the number of bytes to be added to "new".
A number without "+" gives the overall number of bytes. In any case the result
may not be smaller than "new". Numbers may have a unit suffix: "d"=512,
"k"=1024, "s"=2048, "m"=1024k, "g"=1024m.
.br
Examples:
.br
Activate session 4 and enable overwriting of the blocks of younger sessions:
.br
\-truncate_overwritable session 4 new
.br
Activate session 4 and claim the blocks of younger sessions as useless part of
session 4:
.br
\-truncate_overwritable session 4 old
.br
Let session 4 claim additional 500 MiB as useless data:
.br
\-truncate_overwritable session 4 +500m
.TP
\fB\-close_damaged\fR "as_needed"|"force"
Try to close the upcoming track and session if the drive reported the medium
as damaged. This may apply to CD\-R, CD\-RW, DVD\-R, DVD\-RW, DVD+R, DVD+R DL,
@ -2668,11 +2719,6 @@ appear undamaged.
No image changes are allowed to be pending before this command is performed.
After closing was attempted, both drives are given up.
.TP
\fB\-list_profiles\fR "in"|"out"|"all"
Put out a list of media types supported by \-indev, \-outdev, or both,
respectively.
The currently recognized type is marked by text "(current)".
.TP
.B Settings for result writing:
.PP
Rock Ridge info will be generated by default.
@ -6268,7 +6314,7 @@ Thomas Schmitt <scdbackup@gmx.net>
.br
for libburnia\-project.org
.SH COPYRIGHT
Copyright (c) 2007 \- 2019 Thomas Schmitt
Copyright (c) 2007 \- 2020 Thomas Schmitt
.br
Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of \fBxorriso\fR.