tscat

Package: WA2L/edrc 1.5.57
Section: Library Commands (3)
Updated: 26 January 2024
Index Return to Main Contents

 

NAME

tscat - filter to add a timestamp to the stream

 

SYNOPSIS

edrc/lib/tscat [ -h | -V ]

stream | tscat options
tscat options < stream

tail -f logfile... | tscat options

tail -f logfile -v | tscat options
tail -f logfile | tscat -f logfile options

options ::=
[ -z ] [ -r ] [ -m | -l ] [ -n | -f filename ] [ -d deliminator ] [ -s session ] [[ -q ] -a appendfile ]

 

AVAILABILITY

WA2L/edrc

 

DESCRIPTION

filter to add a timestamp and a filename to a stream.

 

OPTIONS

-h
usage message.

-V
print command version.

-n
no file name output.

-z
no output of zero length lines.

-r
print raw time stamp seconds.microseconds (s.uuuuuu) instead of the formatted version (YYYY-MM-DD hh:mm:s.uuuuuu).

-m
medium time stamp resolution (s.uuuu).

-l
low time stamp resolution, where no fraction of seconds are resolved.

-f filename
(default) filename to add to stream.

-d deliminator
field deliminator between timestamp, filename and stream data.

-s session
set session in square brackets.

-q
no output to stdout when appending to a file.

-a appendfile
append timestamped output to file. When this option is specified the output to stdout is without timestamp.

 

ENVIRONMENT

$EDRC_SESSION
set session as when using the -s session option.

 

EXIT STATUS

0
match

1
cannot write to the file specified in -a appendfile option.

4
usage printed.

5
version printed.

 

FILES

-

 

EXAMPLES

-

 

SEE ALSO

edrcintro(1), log(3), tee(1), xlog(1)

 

NOTES

For performance reasons tscat is implemented in C. However, for maximal compatibility the fallback for operating systems where the command (source: edrc/src/tscat/) has not be compiled yet it is implemented also in Perl.

 

BUGS

-

 

AUTHOR

tscat was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net . 

 

COPYRIGHT

Copyright © 2024 Christian Walther

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:54:48 GMT, August 28, 2024