summaryrefslogtreecommitdiff
path: root/contrib/ntp/html/hints/winnt
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/ntp/html/hints/winnt')
-rw-r--r--contrib/ntp/html/hints/winnt207
1 files changed, 0 insertions, 207 deletions
diff --git a/contrib/ntp/html/hints/winnt b/contrib/ntp/html/hints/winnt
deleted file mode 100644
index 6fd7c84aa74d..000000000000
--- a/contrib/ntp/html/hints/winnt
+++ /dev/null
@@ -1,207 +0,0 @@
--------------
-INTRODUCTION:
--------------
-Last revision 27 July 1999 Version 4.0.95.
-
-This version compiles under WINNT with Visual C 6.0.
-
-Greg Brackley and Sven Dietrich
-
-Significant changes:
--Visual Studio v6.0 support
--Winsock 2.0 support
--Use of I/O completion ports for sockets and comm port I/O
--Removed the use of multimedia timers (from ntpd, others need removing)
--Use of waitable timers (with user mode APC) and performance counters to fake getting a better time
--Trimble Palisade NTP Reference Clock support
--General cleanup, prototyping of functions
--Moved receiver buffer code to a separate module (removed unused members from the recvbuff struct)
--Moved io signal code to a separate module
-
-Compiling Instructions:
-1. Requires Perl to be installed, and the Perl environment variable to be set correctly
-2. Open the .\ports\winnt\ntp.dsw
-3. Batch build of all debug projects compile
-
-
-Last revision: 20-Oct-1996
-
-This version corrects problems with building the XNTP
-version 3.5-86 distribution under Windows NT.
-
-The following files were modified:
- blddbg.bat
- bldrel.bat
- include\ntp_machine.h
- xntpd\ntp_unixclock.c
- xntpd\ntp_refclock.c
- scripts\wininstall\build.bat
- scripts\wininstall\setup.rul
- scripts\wininstall\readme.nt
- scripts\wininstall\distrib\ntpog.wri
- html\hints\winnt (this file)
-
-In order to build the entire Windows NT distribution you
-need to modify the file scripts\wininstall\build.bat
-with the installation directory of the InstallShield
-software. Then, simply type "bldrel" for non-debug
-or "blddbg" for debug executables.
-
-
-
-Greg Schueman
- <schueman@acm.org>
-
-
-Last revision: 07-May-1996
-
-This set of changes fixes all known bugs, and it includes
-several major enhancements.
-
-Many changes have been made both to the build environment as
-well as the code. There is no longer an ntp.mak file, instead
-there is a buildntall.bat file that will build the entire
-release in one shot. The batch file requires Perl. Perl
-is easily available from the NT Resource Kit or on the Net.
-
-The multiple interface support was adapted from Larry Kahn's
-work on the BIND NT port. I have not been able to test it
-adequately as I only have NT servers with one network
-interfaces on which to test.
-
-Enhancements:
-* Event Logging now works correctly.
-* Version numbers now work (requires Perl during build)
-* Support for multiple network interface cards (untested)
-* NTP.CONF now default, but supports ntp.ini if not found
-* Installation procedure automated.
-* All paths now allow environment variables such as %windir%
-
-Bug fixes:
-* INSTSRV replaced, works correctly
-* Cleaned up many warnings
-* Corrected use of an uninitialized variable in XNTPD
-* Fixed ntpdate -b option
-* Fixed ntpdate to accept names as well as IP addresses
- (Winsock WSAStartup was called after a gethostbyname())
-* Fixed problem with "longjmp" in xntpdc/ntpdc.c that
- caused a software exception on doing a Control-C in xntpdc.
- A Cntrl-C now terminates the program.
-
-See below for more detail:
-
- Note: SIGINT is not supported for any Win32 application including
- Windows NT and Windows 95. When a CTRL+C interrupt occurs, Win32
- operating systems generate a new thread to specifically handle that
- interrupt. This can cause a single-thread application such as UNIX,
- to become multithreaded, resulting in unexpected behavior.
-
-
-Possible enhancements and things left to do:
-* Reference clock drivers for NT (at least Local Clock support)
-* Control Panel Applet
-* InstallShield based installation, like NT BIND has
-* Integration with NT Performance Monitor
-* SNMP integration
-* Fully test multiple interface support
-
-
-Known problems:
-* bug in ntptrace - if no Stratum 1 servers are available,
- such as on an IntraNet, the application crashes.
-
-
-
-
-Last revision: 12-Apr-1995
-
-
-This NTPv3 distribution includes a sample configuration file and the project
-makefiles for WindowsNT 3.5 platform using Microsoft Visual C++ 2.0 compiler.
-Also included is a small routine to install the NTP daemon as a "service"
-on a WindowsNT box. Besides xntpd, the utilities that have been ported are
-ntpdate and xntpdc. The port to WindowsNT 3.5 has been tested using a Bancomm
-TimeServe2000 GPS receiver clock that acts as a strata 1 NTP server with no
-authentication (it has not been tested with any refclock drivers compiled in).
-Following are the known flaws in this port:
-1) currently, I do not know of a way in NT to get information about multiple
- network interface cards. The current port uses just one socket bound to
- INADDR_ANY address. Therefore when dealing with a multihomed NT time server,
- clients should point to the default address on the server (otherwise the
- reply is not guaranteed to come from the same interface to which the
- request was sent). Working with Microsoft to get this resolved.
-2) There is some problem with "longjmp" in xntpdc/ntpdc.c that causes a
- software exception on doing a Control-C in xntpdc. Be patient!
-3) The error messages logged by xntpd currently contain only the numerical
- error code. Corresponding error message string has to be looked up in
- "Books Online" on Visual C++ 2.0 under the topic "Numerical List of Error
- Codes".
-
-
-----------------------------------------------------
-MAKING XNTPD FOR WindowsNT 3.5 using Visual C++ 2.0:
-----------------------------------------------------
-
-Separate projects are needed for xntpd, ntpdate, xntpdc, and the library
-containing routines used by them.
-
-1) First build the static library composed of routines in the lib
- subdirectory of the distribution. Load the project by opening the
- corresponding makefile libntp.mak (in the lib subdirectory of the
- distribution) by choosing the Open option in the File menu. This should
- display a list of files contained in this project. Then choose the
- "Rebuild All" option from the Project menu in order to compile the
- routines into a library. The libntp.lib static library is created in
- the lib/WinDebug directory
-
- You can now choose to build xntpd, ntpdate, and xntpdc in any order.
-
-2) To build xntpd, load the project by opening the corresponding makefile
- xntpd.mak (in the xntpd subdirectory of the distribution), and rebuild
- all files. The xntpd.exe executable is created in the xntpd/WinDebug
- directory.
-
-3) repeat the above step for ntpdate and xntpdc
-
-
--------------------------------------------------
-INSTALLING XNTPD AS A SERVICE UNDER WindowsNT 3.5
--------------------------------------------------
-
-At this point you need to install 'xntpd' as a service. First modify the
-sample configuration file conf/config.winnt35 in the distribution to
-suit your needs. Then install it as "%SystemRoot%\NTP.INI" (%SystemRoot%
-is an environmental variable that can be determined by typing "set" at
-the "Command Prompt" or from the "System" icon in the "Control Panel",
-NTP.INI is the suggested name for the "ntp.conf" file in Windows environment).
-The instsrv.c program in the util subdirectory of the distribution can
-be used to install 'xntpd' as a service and start automatically at boot
-time. Compile instsrv.c, and enter form the command prompt
- "instsrv.exe NetWorkTimeProtocol <pathname_for_xntd.exe>"
-Clicking on the "Services" icon in the "Control Panel" ("Main" group
-in the "Program Manager") will display the list of currently installed
-services in a dialog box. The NetworkTimeProtocol service should show
-up in this list. Select it in the list and hit the "Start" button in
-the dialog box. The NTP service should start. View the event log by
-clicking on the "Event Viewer" icon in the "Administrative Tools" group
-of the "Program Manager", there should be several successful startup
-messages from NTP. NTP will keep running and restart automatically when
-the machine is rebooted.
-
-You can change the start mode (automatic/manual) and other startup
-parameters correponding to the NTP service (eg. location of conf file)
-also in the "Services" dialog box if you wish.
-
-There is no clean way to run 'ntpdate' before starting 'xntpd' at boot
-time, unlike the Unix environment. 'xntpd' will step the clock upto
-a 1000 seconds. While there is no reason that the system clock should
-be that much off during bootup if 'xntpd' was running before bootup,
-you may want to increase the CLOCK_WAYTOOBIG parameter in include/ntp.h
-from 1000 to, say, MAXINT.
-
-You can also use instsrv.c to delete the NTP service
- "instsrv.exe NetworkTimeProtocol remove"
-
-
-Viraj Bais
-<vbais@mailman1.intel.com>