orb2logs - save log data from orb into local files
orb2logs [-cn] [-m match] [-r reject] [-S state]
[-w pattern] orb logdb
[start [stop|period]]
orb2logs reads packets from an orbserver(1) and saves the character packets
into files. The output file name is defined by a pattern using
trwfname(3); the default operation is to separate log files into day long
files. A special database referencing these files is also created; it is
not a standard css3.0 or rt1.0 database.
The optional start parameter can be a time, or "oldest" or "newest".
The default is "newest".
A stop time or a time period to collect may also be specified.
-
-c
orb2logs typically adds a linefeed after each string from a packet (if it's
not already present). The -c option suppresses this behavior.
-
-n
suppress the addition of a time tag to the packet strings.
-
-m match
Only packets which match the regular expression match
are requested from the orb server; by default, a match of
.*/syslog/.* is used, but any expression from the command
line overrides this.
-
-r reject
packets which match the regular expression reject
are not collected from the orb server.
-
-S statefile
this file saves the pktid of the latest packet processed.
-
-v
Mention each packet read.
-
-w wfname
see trwfname(3) -- this allows choosing the output
file naming convention. The default output file pattern is
"%Y/%j/%{srcname}". This places the log files into day directories,
with further subdivision according to the system of origin and
the path name there.
-
timetag_format
If the subcode for the packet srcname is not syslog, then
orb2logs may precede the packet contents with a time tag;
this specifies the epoch2str(3) format used. The default is
"%Y-%j %H:%M:%S.%s", the same as used by the elog routines.
The time comes from the packet time (not when the packet was
received).
-
has_timetag_pattern
packets which appear to already have a time tag don't need one added; orb2logs
recognizes such packets because the string matches this pattern.
-
logname_pattern
The default pattern for filenames loosely follows the standard waveform
naming convention: year and day directories, followed by the full srcname
of the packet.
% orb2logs -v :status db oldest
tail2orb(1)
rtlogs(1)
The path for a log file is passed inside the srcname of a packet, but
the srcname is limited to 63 characters. For long path names, this could
be a problem.
Daniel Quinlan
Table of Contents
Antelope Release 4.6 Linux 2.4.19-4GB 2004-04-16
Boulder Real Time Technologies, Inc
For more information, contact support@brtt.com