Scroll to navigation

VNL-TS(1) vnlog VNL-TS(1)

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.

2019-01-22