TAI64NFRAC(1) User Commands TAI64NFRAC(1)NAMEtai64nfrac - Convert TAI64N timestamps to decimal seconds since epoch
SYNOPSIStai64nfrac < input > output
DESCRIPTION
Given data with TAI64N timestamps at the beginning of each line as
input (such as data generated by multilog), tai64nfrac will convert
those times to seconds since epoch (with a fractional part) and other‐
wise output the same data. It's intended to be used as a filter that
changes the timestamp format at the beginning of each line.
tai64nfrac is primarily intended to support using qmailanalog to ana‐
lyze qmail logs that are being written by multilog rather than to sys‐
log via splogger.
BUGStai64nfrac makes no attempt to handle leap seconds or to handle TAI to
UTC conversion correctly. It was written with hard-coded adjustments
for systems where the system clock is in UTC and no leap seconds file
is present. In that situation, software generating TAI64N timestamps
will generate timestamps with an epoch 10 seconds different than UTC,
which tai64nfrac adjusts for.
This is obviously not the correct approach, which would be to use the
code and algorithms in libtai. It was just the expedient thing to do
for my immediate problem.
SEE ALSO
See <http://cr.yp.to/daemontools/tai64nlocal.html> for documentation of
tai64nlocal, which converts TAI64N timestamps to human-readable times
in the local time zone.
See <http://cr.yp.to/qmailanalog.html> for qmailanalog.
The current version of this program is available from its web page at
<http://www.eyrie.org/~eagle/software/tai64nfrac/>.
AUTHOR
Russ Allbery <rra@stanford.edu>
LICENSE
This program is in the public domain. If it is not legal or possible
to place a work in the public domain in your jurisdiction, then I
hereby grant you a license to treat this program in every way as if it
were in the public domain.
1.4 2003-03-09 TAI64NFRAC(1)
