s6-portable-utils: the s6-tai64ndiff program

From 2491528e5542153370122aa6f64424d30610562e Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Sun, 21 Jun 2020 21:09:18 +0000 Subject: Add s6-tai64ndiff ; prepare for 2.2.3.0 --- doc/index.html | 2 +- doc/s6-tai64ndiff.html | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++ doc/upgrade.html | 4 ++-- 3 files changed, 63 insertions(+), 3 deletions(-) create mode 100644 doc/s6-tai64ndiff.html (limited to 'doc') diff --git a/doc/index.html b/doc/index.html index 157400a..f191c4f 100644 --- a/doc/index.html +++ b/doc/index.html @@ -77,7 +77,7 @@ library.

The current released version of s6-portable-utils is -2.2.2.5.

2.2.3.0

Alternatively, you can checkout a copy of the s6-portable-utils git repository: diff --git a/doc/s6-tai64ndiff.html b/doc/s6-tai64ndiff.html new file mode 100644 index 0000000..c1f0440 --- /dev/null +++ b/doc/s6-tai64ndiff.html @@ -0,0 +1,60 @@ + + + + + + s6-portable-utils: the s6-tai64ndiff program + + + + + + +
+s6-portable-utils
+Software
+skarnet.org +
+ +
The s6-tai64ndiff program
+ +
+s6-tai64ndiff acts as a filter, reading from stdin and writing to stdout. +It expects every line of its input to begin with a +TAI64N +timestamp. It replaces this timestamp with a prefix showing the time +difference between this line and the previous line. +
+ +
Interface
+ +
```
+     s6-tai64ndiff
+
```
+ +
- s6-tai64ndiff exits 0 when it sees the end of stdin. If there's an +unfinished line, s6-tai64ndiff processes it and writes it before exiting.
- The prefix it prints is of the form [ seconds.microseconds ], +in decimal. It can be interpreted as a fixed-point decimal number of seconds that +elapsed between the timestamp on the previous line and the timestamp on the +current line.
- If the difference isn't defined, seconds and microseconds +are just whitespace. The difference is not defined on the first line of stdin or +on non-timestamped lines. Following non-timestamped lines, the difference may not +be accurate.
+ +
Notes
+ +
- The typical use case of s6-tai64ndiff is to read files that have +been filtered through s6-tai64n, or log files +that have been produced by s6-log with the t +directive.
- The difference is a signed number. Negative numbers probably indicate +a backwards clock jump, which is a bad thing to have on a system.
+ + + diff --git a/doc/upgrade.html b/doc/upgrade.html index 270cea5..9600316 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -18,10 +18,10 @@
What has changed in s6-portable-utils
-
in 2.2.2.5
+
in 2.2.3.0
- Bugfix release, no changes.
- New binary: s6-tai64ndiff.
in 2.2.2.4
-- cgit 1.4.1

The s6-tai64ndiff program

Interface

Notes

What has changed in s6-portable-utils

in 2.2.2.5

in 2.2.3.0

in 2.2.2.4