DragonFly On-Line Manual Pages

TAI64NFRAC(1)                    User Commands                   TAI64NFRAC(1)

NAME
       tai64nfrac - Convert TAI64N timestamps to decimal seconds since epoch

SYNOPSIS
       tai64nfrac < 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
       otherwise 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
       analyze qmail logs that are being written by multilog rather than to
       syslog via splogger.

BUGS
       tai64nfrac 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)