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

@ -4,7 +4,7 @@ xorriso.texi.
xorriso - creates, loads, manipulates and writes ISO 9660 filesystem
images with Rock Ridge extensions.
Copyright (C) 2007 - 2019 Thomas Schmitt
Copyright (C) 2007 - 2020 Thomas Schmitt
Permission is granted to distribute this text freely.
INFO-DIR-SECTION Archiving
@ -2259,6 +2259,48 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command
speeds, 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".
-list_profiles "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)".
-truncate_overwritable 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 *inaccessible* 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.
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.
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.
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.
"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.
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.
Examples:
Activate session 4 and enable overwriting of the blocks of younger
sessions:
-truncate_overwritable session 4 new
Activate session 4 and claim the blocks of younger sessions as
useless part of session 4:
-truncate_overwritable session 4 old
Let session 4 claim additional 500 MiB as useless data:
-truncate_overwritable session 4 +500m
-close_damaged "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,
@ -2272,10 +2314,6 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command
media which appear undamaged.
No image changes are allowed to be pending before this command is
performed. After closing was attempted, both drives are given up.
-list_profiles "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)".

File: xorriso.info, Node: SetWrite, Next: Bootable, Prev: Writing, Up: Commands
@ -5307,7 +5345,7 @@ for libburnia-project.org
15.2 Copyright
==============
Copyright (c) 2007 - 2019 Thomas Schmitt
Copyright (c) 2007 - 2020 Thomas Schmitt
Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of 'xorriso'. If you
make use of the license to derive modified versions of 'xorriso' then
@ -5370,7 +5408,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 185)
* -close controls media closing: SetWrite. (line 407)
* -close_damaged closes damaged track and session: Writing. (line 163)
* -close_damaged closes damaged track and session: Writing. (line 205)
* -close_filter_list bans filter registration: Filter. (line 50)
* -commit writes pending ISO image: Writing. (line 27)
* -commit_eject writes and ejects: Writing. (line 53)
@ -5448,7 +5486,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -list_delimiter replaces '--': Scripting. (line 55)
* -list_extras lists compile time extra features: Scripting. (line 24)
* -list_formats lists available formats: Writing. (line 128)
* -list_profiles lists supported media: Writing. (line 176)
* -list_profiles lists supported media: Writing. (line 163)
* -list_speeds lists available write speeds: Writing. (line 139)
* -lns creates ISO symbolic link: Insert. (line 181)
* -load addresses a particular session as input: Loading. (line 33)
@ -5556,6 +5594,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -temp_mem_limit curbs memory consumption: Scripting. (line 96)
* -toc shows list of sessions: Inquiry. (line 27)
* -toc_of shows list of sessions: Inquiry. (line 41)
* -truncate_overwritable activates older session: Writing. (line 167)
* -uid sets global ownership: SetWrite. (line 290)
* -update inserts path if different: Insert. (line 100)
* -update_l inserts paths if different: Insert. (line 120)
@ -5619,7 +5658,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Create, new ISO image, _definition: Methods. (line 7)
* Cylinder alignment, _definition: Bootable. (line 338)
* Cylinder size, _definition: Bootable. (line 323)
* Damaged track and session, close, -close_damaged: Writing. (line 163)
* Damaged track and session, close, -close_damaged: Writing. (line 205)
* DEC Alpha SRM boot sector, production: Bootable. (line 398)
* Delete, from ISO image, -rm: Manip. (line 20)
* Delete, from ISO image, -rm_r: Manip. (line 26)
@ -5645,7 +5684,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Drive, for output, -outdev: AqDrive. (line 29)
* Drive, get drive list, -devices: Inquiry. (line 7)
* Drive, get drive list, -device_links: Inquiry. (line 17)
* Drive, list supported media, -list_profiles: Writing. (line 176)
* Drive, list supported media, -list_profiles: Writing. (line 163)
* Drive, reduce activity, -calm_drive: Loading. (line 306)
* Drive, report SCSI commands, -scsi_log: Scripting. (line 143)
* Drive, write and eject, -commit_eject: Writing. (line 53)
@ -5772,6 +5811,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Navigate, tell disk working directory, -pwdx: Navigate. (line 21)
* Navigate, tell ISO working directory, -pwd: Navigate. (line 19)
* Next writeable address, -grow_blindly: AqDrive. (line 112)
* Older session, activate, -truncate_overwritable: Writing. (line 167)
* Output Character Set, _definition: Charset. (line 26)
* Overwritable media, _definition: Media. (line 14)
* Ownership, global in ISO image, -uid: SetWrite. (line 290)
@ -5913,42 +5953,42 @@ Node: Manip76969
Node: CmdFind87069
Node: Filter105998
Node: Writing110620
Node: SetWrite120767
Node: Bootable145844
Node: Jigdo172799
Node: Charset177802
Node: Exception181131
Node: DialogCtl187260
Node: Inquiry189862
Node: Navigate198744
Node: Verify207201
Node: Restore217672
Node: Emulation226838
Node: Scripting237294
Node: Frontend245077
Node: Examples254703
Node: ExDevices255881
Node: ExCreate256542
Node: ExDialog257842
Node: ExGrowing259113
Node: ExModifying259922
Node: ExBootable260432
Node: ExCharset260987
Node: ExPseudo261883
Node: ExCdrecord262810
Node: ExMkisofs263130
Node: ExGrowisofs265027
Node: ExException266180
Node: ExTime266638
Node: ExIncBackup267096
Node: ExRestore271122
Node: ExRecovery272068
Node: Files272640
Node: Environ273974
Node: Seealso274722
Node: Bugreport275439
Node: Legal276030
Node: CommandIdx277042
Node: ConceptIdx294585
Node: SetWrite122875
Node: Bootable147952
Node: Jigdo174907
Node: Charset179910
Node: Exception183239
Node: DialogCtl189368
Node: Inquiry191970
Node: Navigate200852
Node: Verify209309
Node: Restore219780
Node: Emulation228946
Node: Scripting239402
Node: Frontend247185
Node: Examples256811
Node: ExDevices257989
Node: ExCreate258650
Node: ExDialog259950
Node: ExGrowing261221
Node: ExModifying262030
Node: ExBootable262540
Node: ExCharset263095
Node: ExPseudo263991
Node: ExCdrecord264918
Node: ExMkisofs265238
Node: ExGrowisofs267135
Node: ExException268288
Node: ExTime268746
Node: ExIncBackup269204
Node: ExRestore273230
Node: ExRecovery274176
Node: Files274748
Node: Environ276082
Node: Seealso276830
Node: Bugreport277547
Node: Legal278138
Node: CommandIdx279150
Node: ConceptIdx296766

End Tag Table