
                               TIMESYNC                         3/21/94

DESCRIPTION:

  Timesync is a simple winsock app that sets your PC's clock to match the 
time on a remote host.  The remote host must be provide the Unix time 
service on port 37 (timesync does NOT use NTP).  This should make the time 
setting accurate at least 1 second.  

  The host you get the time from should be a local machine (preferrably with
accurate time set via something like NTP). Timesync makes no adjustments for
network or cpu delays.  It simply gets the time, sets the clock, and exits.

TERMS OF USE:

  This application is released into the Public Domain for no charge.

AUTHOR:

   Brad Greer                                     brad@cac.washington.edu
   University of Washington
   Networks and Distributed Computing

LOCATION:

   The most current version of Timesync should be anonymously ftp'able
from ftphost.cac.washington.edu:/pub/winsock.

CHANGE LOG:
  1.8 - corrected a timing problem that could make timesync giveup when 
        using a slow server. 
 
  1.7 - Corrected Daylight Savings time to happen on the 1st sunday in April
        instead of the last. Put source tree on ftp.cac.

  1.6 - Change "Daylight Savings" text to say "U.S. Daylight Savings".

  1.4,1.5 - Internal changes to correct for overflow conditions.  These
            seemed to primarily affect users in Australia.

  1.3 - time and date are now displayed as per your Windows International 
        settings.  The offset from GMT can be set to negative values via the
        configuration menu.

  1.2 - not released.

  1.1 - fixed wrong version number request during Winsock Initialization. 
        This allowed timesync to now work with Trumpet Winsock #17/#18 (and
        probably others).

  1.0 - initial release.  Worked ok with LanWorkplace Winsock.

KNOWN BUGS:

  If you have your control panel set to show time in a 12 hour format with no 
  AM/PM indication, Timesync will always set your time to the AM.  This seems
  to be a behaviour of the Visual Basic Time Setting Function as shipped by
  Microsoft.  I suggest you add either AM/PM indication or use a 24 hour time 
  format.

HOW TO INSTALL:

  1. run setup (in this directory) - this should copy all required 
     files onto your harddisk.

  2. double click on the new timesync icon - this will bring up a 
     configuration screen since you will not have a valid timesync.ini 
     file.  If the configuratin screens reappears after you entered
     all your data, it is because your winsock could not resolve the name
     you entered for a timesync host.  Try again.  At worst, you may
     have to use an IP number for the hostname.

     Note - The delay option was put in for when one has many PC's
     that all use a cron-like program to set their clocks at the same 
     time each day.   This option's random delay of 10-41 seconds will 
     prevent the PC's from making their requests to simultaneously,
     so the timeserver is able to handle alot more clients.  Most people
     probably won't find this useful.

  3. you can then remove this directory containing the setup disk image.
     You may want to keep a backup copy on a floppy. 

  If you need to change the ini settings after timesyc is configured,
you can edit the timesync.ini file OR remove timesync.ini and rerun timesync 
to see the configuration screen OR double click the timesync icon when it is 
running (it stays on the screen for 3 seconds after it set the time).
