NAME

       vnl-ts - add a timestamp to a vnlog stream

SYNOPSIS

        $ read_temperature
        # temperature
        29.5
        30.4
        28.3
        22.1
        ... continually produces data at 1Hz

        $ read_temperature | vnl-ts -s %.s
        # time-rel temperature
        0.013893 30.2
        1.048695 28.6
        2.105592 29.3
        3.162873 22.0
        ...

DESCRIPTION

         Usage: vnl-ts [-i | -s] [-m] [--vnl-field t] format < pipe

       This tool runs "ts" on given vnlog streams. "vnl-ts" is a wrapper around the "ts" tool
       from Joey Hess's moreutils <https://joeyh.name/code/moreutils/> toolkit. Since this is a
       wrapper, most commandline options and behaviors of the "ts" tool are present; consult the
       ts(1) manpage for details. The differences from "ts" are

       •   The input and output to this tool are vnlog files, complete with a legend

       •   The format must be passed-in by the user; no default is assumed.

       •   The given format must not contain whitespace, so that it fits a single vnlog field.

       •   "-r" is not supported: it assumes input timestamps with whitespace, which is
           incompatible with vnlog

       •   A "vnl-ts"-specific option "--vnl-field" is available to set the name of the new
           field. If omitted, a reasonable default will be used.

       Past that, everything "ts" does is supported, so see that man page for detailed
       documentation.

BUGS

       This and the other "vnl-xxx" tools that wrap standard utilities are written specifically
       to work with the Linux kernel. None of these have been tested with BSD tools or with non-
       Linux kernels, and I'm sure things don't just work. It's probably not too effortful to get
       that running, but somebody needs to at least bug me for that. Or better yet, send me nice
       patches :)

SEE ALSO

       ts(1)

REPOSITORY

       https://github.com/dkogan/vnlog/

AUTHOR

       Dima Kogan "<dima@secretsauce.net>"

LICENSE AND COPYRIGHT

       Copyright 2018 Dima Kogan "<dima@secretsauce.net>"

       This library is free software; you can redistribute it and/or modify it under the terms of
       the GNU Lesser General Public License as published by the Free Software Foundation; either
       version 2.1 of the License, or (at your option) any later version.

                                            2020-02-04                                  VNL-TS(1)