git: purgatorio

ref: 00c219c7d9c2b9f60c2db0e1ba7289b2301209a7
dir: /man/1/timestamp/

View raw version
.TH TIMESTAMP 1
.SH NAME
timestamp \- log event times
.SH SYNOPSIS
.B timestamp
[
.I tag
]
.SH DESCRIPTION
.I Timestamp
reads lines from its standard input and writes them to its
standard output, prefixing each line with the time that
it was written, in decimal milliseconds since
.I timestamp
was started. If
.I tag
is given, it is written along with the time stamp on each line,
to enable tagging if several writers are each writing
to the same log file.
.PP
The first line written gives the time that
.I timestamp
was started, in milliseconds since the epoch.
Note that logging events can cause timings to change,
and that the timestamps are only as accurate as the
times reported by
.BR /dev/time .
.SH SOURCE
.B /appl/cmd/timestamp.b
.SH EXAMPLE
.EX
% {echo hello; sleep 1; echo goodbye} | timestamp eg
0000000000 eg start 1080156139468
0000000007 eg hello
0000000988 eg goodbye
.EE