xref: /freebsd/contrib/ntp/clockstuff/README (revision c0b746e5e8d9479f05b3749cbf1f73b8928719bd)
1c0b746e5SOllivier RobertREADME file for directory ./clockstuff of the NTP Version 4 distribution
2c0b746e5SOllivier Robert
3c0b746e5SOllivier RobertThis directory contains the sources for utility programs designed to
4c0b746e5SOllivier Robertsupport radio clocks. The chutest.c and clktest.c are desgined to
5c0b746e5SOllivier Roberttest the chu_clk and tty_clk line disciplines and STREAMS modules in
6c0b746e5SOllivier Robertthe ../kernel directory.
7c0b746e5SOllivier Robert
8c0b746e5SOllivier RobertThese files have been modified to work with either the line disciplines
9c0b746e5SOllivier Robertor the STREAMS modules. Be sure to define -DSTREAM if appropriate.
10c0b746e5SOllivier Robert
11c0b746e5SOllivier RobertThese are random bits of things written to help with clocks.  You can
12c0b746e5SOllivier Robertmake things in here by typing one or more of:
13c0b746e5SOllivier Robert
14c0b746e5SOllivier Robert	make propdelay (or `make')
15c0b746e5SOllivier Robert	make chutest
16c0b746e5SOllivier Robert	make clktest
17c0b746e5SOllivier Robert
18c0b746e5SOllivier RobertPropdelay computes high frequency propagation delays, given the
19c0b746e5SOllivier Robertlongitude and latitude of the transmitter and receiver.  Use
20c0b746e5SOllivier Robertthis for WWV/H and CHU.  Don't use it for WWVB (the computation
21c0b746e5SOllivier Robertis easier for that).
22c0b746e5SOllivier Robert
23c0b746e5SOllivier RobertChutest can be used to input and process data from a CHU modem
24c0b746e5SOllivier Robertattached to a serial port.  It will use the CHU line discipline
25c0b746e5SOllivier Robert(if installed), or raw mode otherwise.  This was used to test
26c0b746e5SOllivier Robertout the initial reduction algorithms, and may not be up to date.
27c0b746e5SOllivier Robert
28c0b746e5SOllivier RobertClktest can be used to test the clock line discipline (CLKLDISC,
29c0b746e5SOllivier Robertit must be available), and to take a look at radio clocks attached to a
30c0b746e5SOllivier Robertserial port.
31c0b746e5SOllivier Robert
32