Annotation of embedaddon/ntp/scripts/stats/README.stats, revision 1.1

1.1     ! misho       1: Statistics file formats (README.stats)
        !             2: 
        !             3: The xntp3 daemon can produce a variety of statistics files which are
        !             4: useful for maintenance, evaluation and retrospective calibration
        !             5: purposes. See the xntpd.8 man page for instructions on how to configure
        !             6: this feature. Since these files can become rather large and cumbersome,
        !             7: they are ordinarily reduced to summary form by running the summary.sh
        !             8: shell script once per day, week or month, as appropriate. There are
        !             9: three file collections presently defined: peerstats, loopstats and
        !            10: clockstats, each of which is described in this note.
        !            11: 
        !            12: peerstats
        !            13: 
        !            14: The following data are collected in the peerstats files. The files are
        !            15: reduced to summary data using the peer.sh shell script. See the peer.awk
        !            16: script for further information. A line in the file is produced upon
        !            17: reception of each valid update from a configured peer.
        !            18: 
        !            19:   49236 30.756 140.173.96.1 9474 0.000603 0.37532
        !            20: 
        !            21:   49236             modified Julian day number
        !            22:   30.756            time of day (s) past midnight UTC
        !            23:   140.173.96.1      peer identifier (IP address or receiver identifier)
        !            24:   9474              peer status word (hex) (see NTP specification)
        !            25:   0.000603          offset (s)
        !            26:   0.08929           delay (s)
        !            27:   0.37532           dispersion (s)
        !            28: 
        !            29: loopstats
        !            30: 
        !            31: The following data are collected in the loopstats files. The files are
        !            32: reduced to summary data using the loop.sh shell script. See the loop.awk
        !            33: script for further information. A line in the file is produced at each
        !            34: valid update of the local clock.
        !            35: 
        !            36:   49236 11.897 -0.000004 -35.9384 0
        !            37: 
        !            38:   49236             modified Julian day number
        !            39:   11.897            time of day (s) past midnight UTC
        !            40:   -0.000004         time offset (s)
        !            41:   -35.9384          frequency offset (ppm)
        !            42:   0                 phase-lock loop time constant
        !            43: 
        !            44: clockstats
        !            45: 
        !            46: The following data are collected in the clockstats files. The files are
        !            47: reduced to summary data using the clock.sh shell script, which also
        !            48: updates the ensemble, etf, itf and tdata data files as well. See the
        !            49: clock.awk, ensemble.awk, etf.awk, itf.awk and tdta.awk scripts for
        !            50: further information. A line in the file is produced at each valid update
        !            51: received from a configured radio clock. Data are at present recorded for
        !            52: several radios. The first part of each data line is similar for all
        !            53: radios, e.g.:
        !            54: 
        !            55:   49234 60517.826 127.127.4.1   93 247 16:48:21.814
        !            56: 
        !            57:   49234             modified Julian day number
        !            58:   60517.826         time of day (s) past midnight UTC
        !            59:   127.127.4.1       receiver identifier (Spectracom 8170/Netclock-2)
        !            60:   93 247 16:48:21.814  timecode (format varies)
        !            61: 
        !            62: In the case of the Austron GPS receiver, a good deal of additional
        !            63: information is extracted from the radio, as described below. The formats
        !            64: shown consist of one line with all the fields shown in order. The
        !            65: timecode formats specific to each radio follow. See the file
        !            66: README.timecodes for detailed information on the timecode formats used
        !            67: by these radios.
        !            68: 
        !            69: Spectracom 8170/Netclock-2 WWVB receiver
        !            70: 
        !            71:   49234 60517.826 127.127.4.1 ?A93 247 16:48:21.814
        !            72: 
        !            73:   The '?' and 'A' characters are present only when the receiver is
        !            74:   unsynchronized; otherwise, they are replaced by space ' ' characters.
        !            75: 
        !            76: IRIG audio decoder
        !            77: 
        !            78:   49234 60517.826 127.127.6.0 247 16:48:21?
        !            79: 
        !            80:   The '?' character is present only when the receiver is unsynchronized.
        !            81: 
        !            82: Austron 2200A/2201A GPS receiver
        !            83: 
        !            84:   49234 60580.843 127.127.10.1 93:247:16:49:24.814?
        !            85: 
        !            86:   The '?' character is present only when the receiver is unsynchronized.
        !            87: 
        !            88: Depending on the installed options, the Austron 2200A/2201A recognizes a
        !            89: number of special commands that report various data items. See the
        !            90: refclock_as2201.c source module for a list of the commands used. These
        !            91: data are collected only if the following line is included in the
        !            92: configuration file ntp.conf:
        !            93: 
        !            94:   fudge 127.127.10.1 flag4 1    # enable extended statistics collection
        !            95: 
        !            96: The format of each data line returned is summarized in the following
        !            97: list.
        !            98: 
        !            99: External time/frequency data (requires input buffer option IN)
        !           100: 
        !           101: These data determine the deviations of external time/frequency inputs
        !           102: relative to receiver oscillator time. The following data are typical
        !           103: using an external cesium oscillator PPS and 5-MHz outputs.
        !           104: 
        !           105:   49234 60580.843 127.127.10.1 93:247:16:49:24.814 ETF
        !           106: 
        !           107:   -85.9             time interval (ns)
        !           108:   -89.0             average time interval (ns)
        !           109:   4.0               time interval sigma (ns)
        !           110:   +1.510E-11        time interval rate
        !           111:   -4.500E-11        deltaf/f
        !           112:   +1.592E-11        average deltaf/f
        !           113:   5.297E-13         sigma deltaf/f
        !           114:   500               number of samples
        !           115: 
        !           116: Model and option identifiers
        !           117: 
        !           118: These data show the receiver model number and option configuration.
        !           119: 
        !           120:   49234 60708.848 127.127.10.1 93:247:16:51:32.817 ID;OPT;VER
        !           121: 
        !           122:   GPS 2201A         model ident (must be "GPS 2200A" or "GPS 2201A")
        !           123:   TTY1              rs232 option present (required)
        !           124:   TC1               IRIG option present (optional)
        !           125:   LORAN             LORAN assist option present (optional)
        !           126:   IN                input buffer option present (optional)
        !           127:   OUT1              output buffer option present (required)
        !           128:   B.00              data processor software version ("B.00" or later)
        !           129:   B.00              signal processor software version ("B.00" or later)
        !           130:   28-Apr-93         software version date ("28-Apr-93" or later)
        !           131: 
        !           132: Internal time/frequency data
        !           133: 
        !           134: These data determine the deviations of the receiver oscillator with
        !           135: respect to satellite time.
        !           136: 
        !           137:   49234 60564.846 127.127.10.1 93:247:16:49:08.816 ITF
        !           138: 
        !           139:   COCO              current mode (must be "COCO")
        !           140:   0                 code coast mode (must be zero)
        !           141:   +6.6152E-08       code sigma (s)
        !           142:   -3.5053E-08       code delta t (s)
        !           143:   -4.0361E-11       deltat/t
        !           144:   -6.4746E-11       oscillator ageing rate
        !           145:   500.00            loop time constant
        !           146:   4.984072          electrical tuning (V)
        !           147: 
        !           148: GPS/LORAN ensemble data (requires LORAN assist option LORAN)
        !           149: 
        !           150: These data determine the deviations and weights to calculate ensemble
        !           151: time from GPS and LORAN data.
        !           152: 
        !           153:   49234 60596.852 127.127.10.1 93:247:16:49:40.812 LORAN ENSEMBLE
        !           154: 
        !           155:   +9.06E-08         GPS t (s)
        !           156:   +3.53E-08         GPS sigma (s)
        !           157:   .532              GPS weight
        !           158:   +3.71E-08         LORAN t (s)
        !           159:   +3.76E-08         LORAN sigma (s)
        !           160:   .468              LORAN weight
        !           161:   +6.56E-08         ensemble t
        !           162:   +6.94E-08         ensemble sigma (s)
        !           163: 
        !           164: LORAN stationkeeping data (requires LORAN assist option LORAN)
        !           165: 
        !           166: These data determine which stations of the LORAN chain are being
        !           167: tracked, together with individual signal/noise ratios, deviations and
        !           168: weights.
        !           169: 
        !           170:   49234 60532.850 127.127.10.1 93:247:16:48:36.820 LORAN TDATA
        !           171: 
        !           172:   M                 station identifier; data follows
        !           173:   OK                status (must be "OK" for tracking)
        !           174:   0                 cw flag
        !           175:   0                 sw flag
        !           176:   1162.17           time of arrival
        !           177:   -4.6              snr (-30.0 if not "OK" status)
        !           178:   1.67E-07          2-sample phase-time deviation
        !           179:   .507              weight (included only if "OK" status)
        !           180:   W AQ 0 0 3387.80 -31.0  station identifier and data
        !           181:   X OK 0 0 1740.27 -11.2 2.20E-07 .294  station identifier and data
        !           182:   Y OK 0 0 2180.71 -4.6 2.68E-07 .198  station identifier and data
        !           183:   Z CV 0 0 3392.94 -30.0  station identifier and data
        !           184: 
        !           185: Oscillator status and environment
        !           186: 
        !           187: These data determine the receiver oscillator type, mode, status and
        !           188: environment. Nominal operating conditions are shown below.
        !           189: 
        !           190:   49234 60628.847 127.127.10.1 93:247:16:50:12.817 OSC;ET;TEMP
        !           191: 
        !           192:   1121 Software     Control  oscillator model and mode (must be
        !           193:                     "Software Control")
        !           194:   Locked            status (must be "Locked")
        !           195:   4.979905          electrical tuning (V)
        !           196:   44.81             oscillator cavity temperature
        !           197: 
        !           198: Receiver position, status and offsets
        !           199: 
        !           200: These data determine the receiver position and elevation, together with
        !           201: programmable delay corrections for the antenna cable and receiver.
        !           202: 
        !           203:   49234 60788.847 127.127.10.1 93:247:16:52:52.817 POS;PPS;PPSOFF
        !           204: 
        !           205:   +39:40:48.425     receiver latitude (N)
        !           206:   -075:45:02.392    receiver longitude (E)
        !           207:   +74.09            receiver elevation (m)
        !           208:   Stored            position status (must be "Stored")
        !           209:   UTC               PPS/PPM alignment (must be "UTC")
        !           210:   0                 receiver delay (ns) (should be zero for calibrated
        !           211:                     receiver)
        !           212:   200               cable delay (ns)
        !           213:   0                 user time bias (ns) (must be zero)
        !           214: 
        !           215: Satellite tracking status
        !           216: 
        !           217: These data determine how many satellites are being tracked. At the
        !           218: present state of constellation development, there should be at least
        !           219: three visible satellites in view. Much of the time the maximum of
        !           220: seven are being tracked; rarely this number drops to two.
        !           221: 
        !           222:   49234 60612.850 127.127.10.1 93:247:16:49:56.820 TRSTAT
        !           223: 
        !           224:   24 T              satellite prn and status (T = track, A = acquire)
        !           225:   16 A 13 T 20 T 18 T 07 T 12 T  list continued
        !           226: 
        !           227: UTC leap-second information
        !           228: 
        !           229: These data determine when the next leap second is to occur. The exact
        !           230: method to use is obscure.
        !           231: 
        !           232:   49234 60548.847 127.127.10.1 93:247:16:48:52.818 UTC
        !           233: 
        !           234:   -1.2107E-08       A0 term (s)
        !           235:   -1.2790E-13       A1 term (s)
        !           236:   +9.0000E+00       current leap seconds (s)
        !           237:   +2.0480E+05       time for leap seconds (s)
        !           238:   +2.0100E+02       week number for delta leap (weeks)
        !           239:   +1.9100E+02       week number for future leap (weeks)
        !           240:   +4.0000E+00       day number for future leap (days)
        !           241:   +9.0000E+00       future leap seconds (s)
        !           242: 
        !           243: David L. Mills
        !           244: University of Delaware
        !           245: mills@udel.edu
        !           246: 23 October 1993

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>