aboutsummaryrefslogtreecommitdiffstats
s6: the s6-tai64nlocal program

s6
Software
skarnet.org

The s6-tai64nlocal program

s6-tai64nlocal acts as a filter, reading from stdin and writing to stdout. For every line that begins with a TAI64N timestamp, it replaces this timestamp with a human-readable local date and time.

Interface

     s6-tai64nlocal [ -g ]
  • s6-tai64nlocal exits 0 when it sees the end of stdin. If there's an unfinished line, s6-tai64nlocal processes it and writes it before exiting.

Options

  • -g : print GMT time instead of local time.

Notes

  • The typical use case of s6-tai64nlocal is to read files that have been filtered through s6-tai64n, or log files that have been produced by s6-log with the -t option. For instance, to read the latest httpd logs with human-readable timestamps, s6-tai64nlocal < /var/log/httpd/current | less is a possible command.
  • s6-tai64nlocal does neither "line buffering" nor "block buffering". It does optimal buffering, i.e. it flushes its output buffer every time it risks blocking on input.

Troubleshooting

If s6-tai64nlocal does not appear to give the correct local time:

  • Check the compilation options that were used for the skalibs libraries your s6-tai64nlocal program was linked against. In particular, check whether the --enable-tai-clock or --enable-right-tz configure options have been given.
  • Compare these flags and their meanings with your current timezone. In particular, check /etc/localtime, /etc/timezone, /etc/TZ, and the TZ environment variable.