home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / nistime2.zip / README < prev    next >
Text File  |  1993-06-11  |  5KB  |  132 lines
  1. =======================================================================
  2. nistime        for OS/2 2.0
  3. -----------------------------------------------------------------------
  4. version 0.1b
  5.  
  6.  
  7. Ported by Michael Thompson, 1993
  8. Original code from NIST - see liscence below
  9. =======================================================================
  10.  
  11.  
  12. Description
  13. ===========
  14.  
  15. This program access the NIST time/date server via TCP/IP and obtains the
  16. standard time.  This time is compared to the current setting of the
  17. internal clock, and the difference is reported to stadard output.  With
  18. appropriate flags, this program will also reset the internal clock
  19. to agree with the NIST standard.  TCP/IP must already be installed and
  20. configured for this program to work.
  21.  
  22. The OS/2 implementation is a port of the UNIX equivalent named program
  23. available from anonymous ftp at time_a.timefreq.bldrdoc.gov.  It has been
  24. appropriately hacked (quite substantially, though unnecessarily) to work
  25. with the IBM CSET/2 compiler and the IBM TCP/IP 1.2.1 package.
  26.  
  27. NISTIME uses the timezone information set in the TZ variable to convert
  28. from UTC to local time.  Copy the value from one of your UNIX systems
  29. or create form "set TZ=CST6CDT" where the 6 represents number of hours
  30. from UTC (6 for Central Time in the US).  Default if no TZ is set is
  31. EST5EDT, Eastern Standard Time.
  32.  
  33. The following help may be obtained by typing "nistime -?".
  34.  
  35.   Syntax: nistime [ options ]
  36.  
  37.   Description:
  38.       This program connects to the daytime service on the NIST time server
  39.       time_a.timefreq.bldrdoc.gov using tcp/ip port 13.  The time server
  40.       returns the current time which is then compared with the time of the
  41.       local clock. The difference may be used to adjust the time of the
  42.       local clock using DosSetDateTime().
  43.  
  44.   Options:
  45.       -m0  Terse mode.  Only the time difference in seconds is written
  46.            to standard output.  A positive value means local clock is fast.
  47.       -m1  Display short time messages. (also -M and default)
  48.       -m2  Display verbose time messages.
  49.  
  50.       -s0  Do not set the local clock.
  51.       -s1  Set the local clock if the server is healthy. (also -S)
  52.       -s2  Set the local clock even if the server is not healthy.
  53.       -s3  Query operator before setting the clock. (default)
  54.  
  55.   Bugs: (1) This version does not estimate transmission delays in the network.
  56.             Not a big deal since time is set to the nearest second only.
  57.         (2) Time is instantaneously reset and thus may be non-monotonic.
  58.  
  59. The default call will access the server, compare the time, and if different,
  60. query if you want to reset the internal clock.
  61.  
  62.  
  63. Installation
  64. ============
  65. NISTIME.EXE should be placed a directory such as \tcpip\bin, accessible from
  66. the path.  To run automatically, modify either STARTUP.CMD to run NISTIME
  67. following TCPSTART.CMD, or hack TCPSTART.CMD so this is run last.
  68.  
  69.  
  70. Contents of Archive
  71. ===================
  72. nistime.exe             The executable
  73. nistime.c               Source code
  74. nistime.man             Original man page accompanying the UNIX version
  75. makefile                Makefile to create nistime.exe given TCP/IP 1.2.1
  76.                         programming package and 32 bit header file CSD.
  77. readme                  This file
  78.  
  79.  
  80. Licensing
  81. =========
  82. From the original code:
  83.    This software was developed with US Government support and it may not be
  84.    sold, restricted or licensed.  You may duplicate this program provided
  85.    that this notice remains in all of the copies, and you may give it to
  86.    others provided they understand and agree to this condition.
  87.  
  88. Comments and suggestions for changes in this port may be sent to me at:
  89.       Michael Thompson
  90.       Cornell University
  91.       Dept. of Materials Science
  92.       129 Bard Hall
  93.       tommy@msc.cornell.edu
  94.  
  95.  
  96. NO WARRANTY
  97. ===========
  98. As you guess, I disclaim all responsibility for any problems arising from
  99. the use of this program.  This program is provided "AS IS" without warranty
  100. of any kind, either expressed or implied, including, but not limited to, the
  101. implied warranties of merchantability and fitness for a particular purpose.
  102.  
  103.  
  104. Know bugs
  105. =========
  106. - This version does not estimate transmission delays in the network.
  107.   Not a big deal since time is set to the nearest second only.
  108.  
  109. - The time is instantaneously reset using DosSetDateTime.  If the local
  110.   clock was ahead of the standard, then time will be momentarily 
  111.   non-monotonic.  This has the potential to screw up file timestamps used
  112.   in makefiles.  I don't think it is worth the effort to create the
  113.   equivalent of adjtime (2) to avoid this problem.
  114.  
  115. - There is no icon attached to this program.  If someone wants to make an
  116.   appropriate one, please send it to me to be added in any subsequent
  117.   revisions.
  118.  
  119.  
  120. History
  121. =======
  122.  
  123. Version 0.1  1993 May 22 (Initial release to public)
  124. ----------------------------------------------------
  125. - Initial release
  126.  
  127. Version 0.1b  1993 June 11 (Whoops bug fix)
  128. --------------------------------------------
  129. - Original version failed to use the TZ variable to access
  130.   the local timezone.  Always set clock assuming you lived
  131.   on the East Coast (no surprise it always worked for me!)
  132.