jchvr@ihlpg.UUCP (VanRietschote) (01/07/86)
---
manual page of mtime.c see previous news item.
--- cut here ---
.TH MTIME 1 "HFVR"
.SH NAME
.\" name \- one-line description for in permuted index
mtime \- to display modification time of files
.SH SYNOPSIS
.\" bnf on command syntax
mtime { [+format] file}+
.SH DESCRIPTION
.\" semantics
\fBmtime\fR will display the last modification time of all files
mentioned as argument. An argument starting with a \fB+\fR will be
treated to set the display format. The display format is then used for
all files following the display format. The display format is simular
to that of the first argument of \fIprintf(3S)\fR. All output fields
are of fixed size (zero padded if necessary). Each field descriptor
is preceded by % and will be replaced in the output by its
corresponding value. A single % is encoded by %%. All other characters
are copied to the output whithout change. The string always terminates
with a new-line character.
.sp
Field descriptors:
.nf
\fBn\fR insert a new-line character
\fBt\fR insert a tab character
\fBm\fR month of year \- 01 to 12
\fBd\fR day of month \- 01 to 31
\fBy\fR last 2 digits of year \- 00 to 99
\fBD\fR date as in mm/dd/yy
\fBH\fR hour \- 00 to 23
\fBM\fR minute \- 00 to 59
\fBS\fR second \- 00 to 59
\fBT\fR time as HH:MM:SS
\fBj\fR day of year \- 001 to 366
\fBw\fR day of week \- Sunday = 0
\fBa\fR abbreviated weekday \- Sun to Sat
\fBh\fR abbreviated month \- Jan to Dec
.fi
.sp
The default field descriptor is:
.nf
+%a %h %d %H:%M:%S 19%y
.fi
.SH EXAMPLES
.nf
mtime '+DATE:%m/%d/%y%nTIME: %H:%M:%S' file
would have generated as output:
DATE: 08/01/76
TIME: 14:45:05
.fi
.SH USEFUL FOR
\fBmtime\fR is usefule for adding the last modification date to
printouts of databases etc.
.SH SEE ALSO
stat(3), date(1), printf(3S)
.SH DIAGNOSTICS
An error message is displayed if a file cannot be stat(3)'ed.