New entities "at_time", "before", "after", "not_after", "not_before" for commands -load, -mount, -mount_cmd, -session_string, -truncate_overwritable

This commit is contained in:
2024-06-29 23:31:15 +02:00
parent 2e4b824d65
commit 5133b9cba1
10 changed files with 262 additions and 116 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.5.7, Jun 28, 2024"
.TH XORRISO 1 "Version 1.5.7, Jun 29, 2024"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -873,8 +873,39 @@ address. The following entities are defined:
.br
"lba" or "sbsector" with a number as of a line "ISO ...", column "sbsector".
.br
"volid" with a search pattern for a text as of a line "ISO ...",
column "Volume Id".
"volid" with a search pattern for a text as in the column "Volume Id" of
a \-toc line "ISO ...".
.br
"at_time" with a time string as described with command \-alter_date chooses
the last session or track where the modification timestamp matches the given
time within the same second.
.br
"before" with a time string chooses the last session or track of which
the timestamp is older than the given time. But it does not match an entity
with exactly the given time.
.br
"not_after" is like "before" but also matches an entity with exactly the
given time.
.br
"after" with a time string chooses the first session or track of which
the timestamp is younger than the given time. But it does not match an entity
with exactly the given time.
.br
"not_before" is like "after" but also matches an entity with exactly the
given time.
.br
Comparison of time entities is done with an accuracy of one second. I.e. the
centiseconds of ISO 9660 timestamps are ignored.
If \-toc_info_type is set to "creation_time", then the comparison is done
against the creation timestamp of track or session rather than the modification
timestamp. The output of \-pvd_info shows both timestamps as "Creation Time:"
and "Modif. Time :".
.br
The time comparisons pick first and last matching sessions. If the sequence of
timestamps on a drive is not chronologically ascending, the picks might not be
the best choice.
In this case look at the output of \-toc_info_type "mtime" \-toc and choose the
desired entity by "session", "track", or "sbsector".
.br
Addressing a non\-existing entity or one which does not represent an ISO
image will either abandon \-indev or at least lead to a blank image.
@ -1927,7 +1958,7 @@ Relative times counted from current clock time:
where "s" means seconds, "h" hours, "d" days, "w" weeks, "m"=30d,
"y"=365.25d plus 1d added to multiplication result.
.br
Absolute seconds counted from Jan 1 1970:
Absolute seconds counted from Jan 1 1970 00:00 GMT:
.br
=Number
.br