Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / ntp / scripts / stats

Annotation of embedaddon/ntp/scripts/stats/README, revision 1.1.1.1

1.1       misho       1: Statistics processing scripts (README)
                      2: 
                      3: This directory contains a number of scripts for use with the filegen
                      4: facility. Those files ending in .awk are for the Unix awk utility, while
                      5: those ending in .sh are for the csh utility. Normally, the summary.sh
                      6: script is called from a cron job once per day. This script processes the
                      7: daily loopstats, peerstats and clockstats files produced by the daemon,
                      8: updates the loop_summary, peer_summary and clock_summary archive files,
                      9: and deletes the daily files.
                     10: 
                     11: In the case of the Austron 2201A GPS receiver, the clockstats file
                     12: contains a wealth of additional monitoring data. These data are summarized
                     13: and writted to the clock_summary file, then a series of special files are
                     14: constructed for later processing by the S utility.
                     15: 
                     16: The summary.sh script invokes a number of awk scripts to actually produce
                     17: the data. This may result in multiple scans of the same input file.
                     18: The input file is deleted after processing. In fact, the shell scripts will
                     19: process all input files found of the correct type in chronological order,
                     20: deleting each one as it is scanned, except the current day file.
                     21: 
                     22: The summary.sh script can produce input files for the S utility, if it
                     23: is found on the search path. This utility makes PostScript graphs of the
                     24: loopstats data for each day, as well as various statistics produced by
                     25: the Austorn 220aA GPS receiver. The S utility is automatically run
                     26: as a background job. Its control files have the .S extension.
                     27: 
                     28: The psummary.awk script can be used to scan the peer_summary file and
                     29: construct an historical reprise of the daily summaries. 
                     30: 
                     31: The file formats are documented in the README.stats file and in the
                     32: scripts themselves. Further detail on the radio clock ASCII timecode
                     33: formats and related data are in the README.timecode file.
                     34: 
                     35: David L. Mills
                     36: University of Delaware
                     37: mills@udel.edu
                     38: 1 November 1993
                     39: Revised 12 April 1994