154359SrobertoStatistics file formats (README.stats) 254359Sroberto 354359SrobertoThe xntp3 daemon can produce a variety of statistics files which are 454359Srobertouseful for maintenance, evaluation and retrospective calibration 554359Srobertopurposes. See the xntpd.8 man page for instructions on how to configure 654359Srobertothis feature. Since these files can become rather large and cumbersome, 754359Srobertothey are ordinarily reduced to summary form by running the summary.sh 854359Srobertoshell script once per day, week or month, as appropriate. There are 954359Srobertothree file collections presently defined: peerstats, loopstats and 1054359Srobertoclockstats, each of which is described in this note. 1154359Sroberto 1254359Srobertopeerstats 1354359Sroberto 1454359SrobertoThe following data are collected in the peerstats files. The files are 1554359Srobertoreduced to summary data using the peer.sh shell script. See the peer.awk 1654359Srobertoscript for further information. A line in the file is produced upon 1754359Srobertoreception of each valid update from a configured peer. 1854359Sroberto 1954359Sroberto 49236 30.756 140.173.96.1 9474 0.000603 0.37532 2054359Sroberto 2154359Sroberto 49236 modified Julian day number 2254359Sroberto 30.756 time of day (s) past midnight UTC 2354359Sroberto 140.173.96.1 peer identifier (IP address or receiver identifier) 2454359Sroberto 9474 peer status word (hex) (see NTP specification) 2554359Sroberto 0.000603 offset (s) 2654359Sroberto 0.08929 delay (s) 2754359Sroberto 0.37532 dispersion (s) 2854359Sroberto 2954359Srobertoloopstats 3054359Sroberto 3154359SrobertoThe following data are collected in the loopstats files. The files are 3254359Srobertoreduced to summary data using the loop.sh shell script. See the loop.awk 3354359Srobertoscript for further information. A line in the file is produced at each 3454359Srobertovalid update of the local clock. 3554359Sroberto 3654359Sroberto 49236 11.897 -0.000004 -35.9384 0 3754359Sroberto 3854359Sroberto 49236 modified Julian day number 3954359Sroberto 11.897 time of day (s) past midnight UTC 4054359Sroberto -0.000004 time offset (s) 4154359Sroberto -35.9384 frequency offset (ppm) 4254359Sroberto 0 phase-lock loop time constant 4354359Sroberto 4454359Srobertoclockstats 4554359Sroberto 4654359SrobertoThe following data are collected in the clockstats files. The files are 4754359Srobertoreduced to summary data using the clock.sh shell script, which also 4854359Srobertoupdates the ensemble, etf, itf and tdata data files as well. See the 4954359Srobertoclock.awk, ensemble.awk, etf.awk, itf.awk and tdta.awk scripts for 5054359Srobertofurther information. A line in the file is produced at each valid update 5154359Srobertoreceived from a configured radio clock. Data are at present recorded for 5254359Srobertoseveral radios. The first part of each data line is similar for all 5354359Srobertoradios, e.g.: 5454359Sroberto 5554359Sroberto 49234 60517.826 127.127.4.1 93 247 16:48:21.814 5654359Sroberto 5754359Sroberto 49234 modified Julian day number 5854359Sroberto 60517.826 time of day (s) past midnight UTC 5954359Sroberto 127.127.4.1 receiver identifier (Spectracom 8170/Netclock-2) 6054359Sroberto 93 247 16:48:21.814 timecode (format varies) 6154359Sroberto 6254359SrobertoIn the case of the Austron GPS receiver, a good deal of additional 6354359Srobertoinformation is extracted from the radio, as described below. The formats 6454359Srobertoshown consist of one line with all the fields shown in order. The 6554359Srobertotimecode formats specific to each radio follow. See the file 6654359SrobertoREADME.timecodes for detailed information on the timecode formats used 6754359Srobertoby these radios. 6854359Sroberto 6954359SrobertoSpectracom 8170/Netclock-2 WWVB receiver 7054359Sroberto 7154359Sroberto 49234 60517.826 127.127.4.1 ?A93 247 16:48:21.814 7254359Sroberto 7354359Sroberto The '?' and 'A' characters are present only when the receiver is 7454359Sroberto unsynchronized; otherwise, they are replaced by space ' ' characters. 7554359Sroberto 7654359SrobertoIRIG audio decoder 7754359Sroberto 7854359Sroberto 49234 60517.826 127.127.6.0 247 16:48:21? 7954359Sroberto 8054359Sroberto The '?' character is present only when the receiver is unsynchronized. 8154359Sroberto 8254359SrobertoAustron 2200A/2201A GPS receiver 8354359Sroberto 8454359Sroberto 49234 60580.843 127.127.10.1 93:247:16:49:24.814? 8554359Sroberto 8654359Sroberto The '?' character is present only when the receiver is unsynchronized. 8754359Sroberto 8854359SrobertoDepending on the installed options, the Austron 2200A/2201A recognizes a 8954359Srobertonumber of special commands that report various data items. See the 9054359Srobertorefclock_as2201.c source module for a list of the commands used. These 9154359Srobertodata are collected only if the following line is included in the 9254359Srobertoconfiguration file ntp.conf: 9354359Sroberto 9454359Sroberto fudge 127.127.10.1 flag4 1 # enable extended statistics collection 9554359Sroberto 9654359SrobertoThe format of each data line returned is summarized in the following 9754359Srobertolist. 9854359Sroberto 9954359SrobertoExternal time/frequency data (requires input buffer option IN) 10054359Sroberto 10154359SrobertoThese data determine the deviations of external time/frequency inputs 10254359Srobertorelative to receiver oscillator time. The following data are typical 10354359Srobertousing an external cesium oscillator PPS and 5-MHz outputs. 10454359Sroberto 10554359Sroberto 49234 60580.843 127.127.10.1 93:247:16:49:24.814 ETF 10654359Sroberto 10754359Sroberto -85.9 time interval (ns) 10854359Sroberto -89.0 average time interval (ns) 10954359Sroberto 4.0 time interval sigma (ns) 11054359Sroberto +1.510E-11 time interval rate 11154359Sroberto -4.500E-11 deltaf/f 11254359Sroberto +1.592E-11 average deltaf/f 11354359Sroberto 5.297E-13 sigma deltaf/f 11454359Sroberto 500 number of samples 11554359Sroberto 11654359SrobertoModel and option identifiers 11754359Sroberto 11854359SrobertoThese data show the receiver model number and option configuration. 11954359Sroberto 12054359Sroberto 49234 60708.848 127.127.10.1 93:247:16:51:32.817 ID;OPT;VER 12154359Sroberto 12254359Sroberto GPS 2201A model ident (must be "GPS 2200A" or "GPS 2201A") 12354359Sroberto TTY1 rs232 option present (required) 12454359Sroberto TC1 IRIG option present (optional) 12554359Sroberto LORAN LORAN assist option present (optional) 12654359Sroberto IN input buffer option present (optional) 12754359Sroberto OUT1 output buffer option present (required) 12854359Sroberto B.00 data processor software version ("B.00" or later) 12954359Sroberto B.00 signal processor software version ("B.00" or later) 13054359Sroberto 28-Apr-93 software version date ("28-Apr-93" or later) 13154359Sroberto 13254359SrobertoInternal time/frequency data 13354359Sroberto 13454359SrobertoThese data determine the deviations of the receiver oscillator with 13554359Srobertorespect to satellite time. 13654359Sroberto 13754359Sroberto 49234 60564.846 127.127.10.1 93:247:16:49:08.816 ITF 13854359Sroberto 13954359Sroberto COCO current mode (must be "COCO") 14054359Sroberto 0 code coast mode (must be zero) 14154359Sroberto +6.6152E-08 code sigma (s) 14254359Sroberto -3.5053E-08 code delta t (s) 14354359Sroberto -4.0361E-11 deltat/t 14454359Sroberto -6.4746E-11 oscillator ageing rate 14554359Sroberto 500.00 loop time constant 14654359Sroberto 4.984072 electrical tuning (V) 14754359Sroberto 14854359SrobertoGPS/LORAN ensemble data (requires LORAN assist option LORAN) 14954359Sroberto 15054359SrobertoThese data determine the deviations and weights to calculate ensemble 15154359Srobertotime from GPS and LORAN data. 15254359Sroberto 15354359Sroberto 49234 60596.852 127.127.10.1 93:247:16:49:40.812 LORAN ENSEMBLE 15454359Sroberto 15554359Sroberto +9.06E-08 GPS t (s) 15654359Sroberto +3.53E-08 GPS sigma (s) 15754359Sroberto .532 GPS weight 15854359Sroberto +3.71E-08 LORAN t (s) 15954359Sroberto +3.76E-08 LORAN sigma (s) 16054359Sroberto .468 LORAN weight 16154359Sroberto +6.56E-08 ensemble t 16254359Sroberto +6.94E-08 ensemble sigma (s) 16354359Sroberto 16454359SrobertoLORAN stationkeeping data (requires LORAN assist option LORAN) 16554359Sroberto 16654359SrobertoThese data determine which stations of the LORAN chain are being 16754359Srobertotracked, together with individual signal/noise ratios, deviations and 16854359Srobertoweights. 16954359Sroberto 17054359Sroberto 49234 60532.850 127.127.10.1 93:247:16:48:36.820 LORAN TDATA 17154359Sroberto 17254359Sroberto M station identifier; data follows 17354359Sroberto OK status (must be "OK" for tracking) 17454359Sroberto 0 cw flag 17554359Sroberto 0 sw flag 17654359Sroberto 1162.17 time of arrival 17754359Sroberto -4.6 snr (-30.0 if not "OK" status) 17854359Sroberto 1.67E-07 2-sample phase-time deviation 17954359Sroberto .507 weight (included only if "OK" status) 18054359Sroberto W AQ 0 0 3387.80 -31.0 station identifier and data 18154359Sroberto X OK 0 0 1740.27 -11.2 2.20E-07 .294 station identifier and data 18254359Sroberto Y OK 0 0 2180.71 -4.6 2.68E-07 .198 station identifier and data 18354359Sroberto Z CV 0 0 3392.94 -30.0 station identifier and data 18454359Sroberto 18554359SrobertoOscillator status and environment 18654359Sroberto 18754359SrobertoThese data determine the receiver oscillator type, mode, status and 18854359Srobertoenvironment. Nominal operating conditions are shown below. 18954359Sroberto 19054359Sroberto 49234 60628.847 127.127.10.1 93:247:16:50:12.817 OSC;ET;TEMP 19154359Sroberto 19254359Sroberto 1121 Software Control oscillator model and mode (must be 19354359Sroberto "Software Control") 19454359Sroberto Locked status (must be "Locked") 19554359Sroberto 4.979905 electrical tuning (V) 19654359Sroberto 44.81 oscillator cavity temperature 19754359Sroberto 19854359SrobertoReceiver position, status and offsets 19954359Sroberto 20054359SrobertoThese data determine the receiver position and elevation, together with 20154359Srobertoprogrammable delay corrections for the antenna cable and receiver. 20254359Sroberto 20354359Sroberto 49234 60788.847 127.127.10.1 93:247:16:52:52.817 POS;PPS;PPSOFF 20454359Sroberto 20554359Sroberto +39:40:48.425 receiver latitude (N) 20654359Sroberto -075:45:02.392 receiver longitude (E) 20754359Sroberto +74.09 receiver elevation (m) 20854359Sroberto Stored position status (must be "Stored") 20954359Sroberto UTC PPS/PPM alignment (must be "UTC") 21054359Sroberto 0 receiver delay (ns) (should be zero for calibrated 21154359Sroberto receiver) 21254359Sroberto 200 cable delay (ns) 21354359Sroberto 0 user time bias (ns) (must be zero) 21454359Sroberto 21554359SrobertoSatellite tracking status 21654359Sroberto 21754359SrobertoThese data determine how many satellites are being tracked. At the 21854359Srobertopresent state of constellation development, there should be at least 21954359Srobertothree visible satellites in view. Much of the time the maximum of 22054359Srobertoseven are being tracked; rarely this number drops to two. 22154359Sroberto 22254359Sroberto 49234 60612.850 127.127.10.1 93:247:16:49:56.820 TRSTAT 22354359Sroberto 22454359Sroberto 24 T satellite prn and status (T = track, A = acquire) 22554359Sroberto 16 A 13 T 20 T 18 T 07 T 12 T list continued 22654359Sroberto 22754359SrobertoUTC leap-second information 22854359Sroberto 22954359SrobertoThese data determine when the next leap second is to occur. The exact 23054359Srobertomethod to use is obscure. 23154359Sroberto 23254359Sroberto 49234 60548.847 127.127.10.1 93:247:16:48:52.818 UTC 23354359Sroberto 23454359Sroberto -1.2107E-08 A0 term (s) 23554359Sroberto -1.2790E-13 A1 term (s) 23654359Sroberto +9.0000E+00 current leap seconds (s) 23754359Sroberto +2.0480E+05 time for leap seconds (s) 23854359Sroberto +2.0100E+02 week number for delta leap (weeks) 23954359Sroberto +1.9100E+02 week number for future leap (weeks) 24054359Sroberto +4.0000E+00 day number for future leap (days) 24154359Sroberto +9.0000E+00 future leap seconds (s) 24254359Sroberto 24354359SrobertoDavid L. Mills 24454359SrobertoUniversity of Delaware 24554359Srobertomills@udel.edu 24654359Sroberto23 October 1993 247