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

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISO 1 "Version 1.5.7, Jun 28, 2024"
@c man .TH XORRISO 1 "Version 1.5.7, Jun 29, 2024"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -1105,8 +1105,39 @@ address. The following entities are defined:
@*
"lba" or "sbsector" with a number as of a line "ISO ...", column "sbsector".
@*
"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 ...".
@*
"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.
@*
"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.
@*
"not_after" is like "before" but also matches an entity with exactly the
given time.
@*
"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.
@*
"not_before" is like "after" but also matches an entity with exactly the
given time.
@*
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 :".
@*
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".
@*
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.
@ -2317,7 +2348,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.
@*
Absolute seconds counted from Jan 1 1970:
Absolute seconds counted from Jan 1 1970 00:00 GMT:
@*
=Number
@*