xref: /netbsd-src/external/bsd/ntp/dist/html/hints/bsdi (revision abb0f93cd77b67f080613360c65701f85e5f5cfe)
1*abb0f93cSkardelhints/bsdi
2*abb0f93cSkardel
3*abb0f93cSkardelAuthor:		Bdale Garbee, bdale@gag.com
4*abb0f93cSkardelLast revision:	27Oct94 (Paul Vixie)
5*abb0f93cSkardel
6*abb0f93cSkardelIncluded in this distribution of XNTP is a configuration file suitable
7*abb0f93cSkardelfor use with BSDI's BSD/OS 1.1 (formerly BSD/386 1.1).  On this system,
8*abb0f93cSkardelthe "cc" command is GCC 1.4x rather than PCC or GCC 2.x.  It is imperative
9*abb0f93cSkardelthat "cc" be used since it predefines the symbol __bsdi__; if you want to
10*abb0f93cSkardeluse another compiler you will need to add -D__bsdi__ to catch the various
11*abb0f93cSkardel#ifdef's required for this system.
12*abb0f93cSkardel
13*abb0f93cSkardelThe Kinemetrics/Truetime GPS-TM/TMD driver is known to work on this system.
14*abb0f93cSkardelThe GPS-805 and GOES should also work fine.  Hell, they should all work fine
15*abb0f93cSkardelbut it's hard to test very many locally.
16*abb0f93cSkardel
17*abb0f93cSkardelDue to BNR2's strict interpretation of POSIX and XNTP's use of SIGIO, BSD/OS
18*abb0f93cSkardelcan only handle one refclock per daemon.  We're working this out with the
19*abb0f93cSkardelsystem architects.
20*abb0f93cSkardel
21*abb0f93cSkardelThe config file is machine/bsdi, and the following steps should be all that
22*abb0f93cSkardelare required to install and use the bits.
23*abb0f93cSkardel
24*abb0f93cSkardelNote that you will need GNU sed; the version supplied with BSD/OS 1.1 loops
25*abb0f93cSkardelendlessly during "make refconf".  Likewise you should get GNU make, which
26*abb0f93cSkardelthe instructions below assume that you have put in /usr/local/bin/gnumake.
27*abb0f93cSkardel
28*abb0f93cSkardelTo build the software:
29*abb0f93cSkardel
30*abb0f93cSkardel	rm -f Config.local
31*abb0f93cSkardel	gnumake refconf
32*abb0f93cSkardel	gnumake MAKE=gnumake
33*abb0f93cSkardel
34*abb0f93cSkardelTo install the software:
35*abb0f93cSkardel
36*abb0f93cSkardel	gnumake install
37*abb0f93cSkardel
38*abb0f93cSkardel	This will place all of the executables in /usr/local/etc.  The config
39*abb0f93cSkardel	file is expected to be /usr/local/etc/xntp.conf and the key file for
40*abb0f93cSkardel	the optional authentication is /etc/ntp.keys.
41*abb0f93cSkardel
42*abb0f93cSkardel	Craft a config file and a key file, and put them in the right places.
43*abb0f93cSkardel	There is information on how to do this elsewhere in the documentation,
44*abb0f93cSkardel	the only thing I'll mention is that I put the drift file in
45*abb0f93cSkardel	/var/log/ntp.drift, and the authdelay on my 486DX/50 system is
46*abb0f93cSkardel	0.000064.  Your mileage will vary, learn to use the authspeed tools
47*abb0f93cSkardel	if you're going to authenticate.
48*abb0f93cSkardel
49*abb0f93cSkardel	In the file /etc/rc.local, make sure that the invocation of ntpd is
50*abb0f93cSkardel	commented out, and add an invocation of xntpd.  Here's what I'm using:
51*abb0f93cSkardel
52*abb0f93cSkardel		echo -n 'starting local daemons:'
53*abb0f93cSkardel
54*abb0f93cSkardel		if [ -f /etc/ntp.keys -a -f /usr/local/etc/xntp.conf ]; then
55*abb0f93cSkardel		    echo -n ' xntpd';           /usr/local/etc/xntpd
56*abb0f93cSkardel		fi
57*abb0f93cSkardel
58*abb0f93cSkardel		#XXX# echo -n ' ntpd';          /usr/libexec/ntpd -t
59*abb0f93cSkardel
60*abb0f93cSkardelAt this point, you should be good to go.  Try running /usr/local/etc/xntpd and
61*abb0f93cSkardelusing ntpq or xntpdc to see if things are working, then pay attention the next
62*abb0f93cSkardeltime you reboot to make sure that xntpd is being invoked, and use ntpq or
63*abb0f93cSkardelxntpdc again to make sure all is well.
64*abb0f93cSkardel
65*abb0f93cSkardelEnjoy!
66