
Installation instructions of ienclock 1.0

In order to install the package, execute the following commands:

tar -xzf ienclock-1.0.tgz
 
cd ienclock-1.0
 
make
 
make install


Now you can tune your radio card with a radio program, ( I use radio of xawtv package)
example:

radio -qf 89.70

Next, few minutes before the change of the hour you can execute the program

ienclock

Consider that the signal is transmitted each (about) hour at the 59th minute and 53 seconds.

If the signal is transmitted, it's intercepted and, if correctly interpreted
a message is emitted as

UTC:   Sun Oct 31 04:59:53 2004
Local: Sun Oct 31 05:59:53 2004

then the program updates the system's clock and writes the message:

Time successfully updated!


Obviously you should log as root to update the system time, but if you want to try the program as a generic user, without updating the clock, use the -s option when launching the program.

Consider that the program will not update the system's clock if the time interpreted differs (+-) 5 minutes  by the actual time. 

The program expects to work with a system's clock set with UTC, failing this, the update of time will fail with a "diff check" error message.

The shell program supplied, updateclock.sh, will automate each described phase, and you can place an entry of this program into a crontab to be recalled every hour 

example:

59 * * * * updateclock.sh 89.70  2>&1 | logger -i -t ienclock

If you don't have a radio card installed on your computer, you can use a normal pocket radio, with the audio  output connected to "line-in" entry of your audio card, obviously, you can't use the shell program to tune the radio.



Placed in public domain by
 
Mario Grosso.

2004
 
MGrosso<at>inwind<dot>it

