(timestamp mode [label ...])
On success, t, otherwise one of the following error messages:
(error "textlog: Timestamp must be one of 'first', 'last' or 'average'") (error "textlog: Group or log label does not exist") (error "textlog: Too few arguments to timestamp: # < #") (error "textlog: Invalid command: timestamp")
or, if none of the above errors apply, nil.
The timestamp command lets you set the time resolution for each line. If no label is specified, this command sets a global default value for all logs and groups. Any specific value always overrides the global definition, regardless of the order in the configuration file or when a command is sent.
We recommend setting the timestamp to last, so the lines of output will be written in a non-decreasing order. Of course, this will only be true if the data itself is ordered incrementally by times. Otherwise, you may have to post-process the file and sort it to create a non-decreasing time sequence.
This command corresponds to the Cogent C API function LG_Timestamp.
Copyright © 1995-2006 by Cogent Real-Time Systems, Inc. All rights reserved.