New -find action "show_time"

This commit is contained in:
2025-10-03 21:46:51 +02:00
parent 0f557975bb
commit 9358936f79
10 changed files with 172 additions and 59 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, Sep 28, 2025"
.TH XORRISO 1 "Version 1.5.7, Oct 03, 2025"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@@ -2511,6 +2511,20 @@ sets the ctime and atime to the value found in mtime.
\fBlsdl\fR
prints file information like shell command ls \-dl.
.br
\fBshow_time\fR
prints the timestamp of the given type and the file path.
Other than with lsdl the time is always shown exact to the second.
.br
This action gets a type text as parameter. It has to begin by one of the
letters 'a', 'c', or 'm' to request atime, ctime, or mtime. Letters 'u' or 'U'
may be appended to request UTC instead of local time. Letter 's' may be
appended to request sortable timestamps of form YYYY.MM.DD.hhmmss like
2025.10.03.183911. Note that for ASCII\-alphabetic sortability the year 10000
is represented as "999A" and year \-1 is represented as "\-001".
Requesting UTC prevents such oddities.
.br
E.g.: \-exec show_time mus \-\-
.br
\fBcompare\fR
performs command \-compare with the found file address as
iso_rr_path and the corresponding file address below its parameter