1258945Srobertohints/bsdi
2258945Sroberto
3258945SrobertoAuthor:		Bdale Garbee, bdale@gag.com
4258945SrobertoLast revision:	27Oct94 (Paul Vixie)
5258945Sroberto
6258945SrobertoIncluded in this distribution of XNTP is a configuration file suitable
7258945Srobertofor use with BSDI's BSD/OS 1.1 (formerly BSD/386 1.1).  On this system,
8258945Srobertothe "cc" command is GCC 1.4x rather than PCC or GCC 2.x.  It is imperative
9258945Srobertothat "cc" be used since it predefines the symbol __bsdi__; if you want to
10258945Srobertouse another compiler you will need to add -D__bsdi__ to catch the various
11258945Sroberto#ifdef's required for this system.
12258945Sroberto
13258945SrobertoThe Kinemetrics/Truetime GPS-TM/TMD driver is known to work on this system.
14258945SrobertoThe GPS-805 and GOES should also work fine.  Hell, they should all work fine
15258945Srobertobut it's hard to test very many locally.
16258945Sroberto
17258945SrobertoDue to BNR2's strict interpretation of POSIX and XNTP's use of SIGIO, BSD/OS
18258945Srobertocan only handle one refclock per daemon.  We're working this out with the
19258945Srobertosystem architects.
20258945Sroberto
21258945SrobertoThe config file is machine/bsdi, and the following steps should be all that
22258945Srobertoare required to install and use the bits.
23258945Sroberto
24258945SrobertoNote that you will need GNU sed; the version supplied with BSD/OS 1.1 loops
25258945Srobertoendlessly during "make refconf".  Likewise you should get GNU make, which
26258945Srobertothe instructions below assume that you have put in /usr/local/bin/gnumake.
27258945Sroberto
28258945SrobertoTo build the software:
29258945Sroberto
30258945Sroberto	rm -f Config.local
31258945Sroberto	gnumake refconf
32258945Sroberto	gnumake MAKE=gnumake
33258945Sroberto
34258945SrobertoTo install the software:
35258945Sroberto
36258945Sroberto	gnumake install
37258945Sroberto
38258945Sroberto	This will place all of the executables in /usr/local/etc.  The config
39258945Sroberto	file is expected to be /usr/local/etc/xntp.conf and the key file for
40258945Sroberto	the optional authentication is /etc/ntp.keys.
41258945Sroberto
42258945Sroberto	Craft a config file and a key file, and put them in the right places.
43258945Sroberto	There is information on how to do this elsewhere in the documentation,
44258945Sroberto	the only thing I'll mention is that I put the drift file in 
45258945Sroberto	/var/log/ntp.drift, and the authdelay on my 486DX/50 system is 
46258945Sroberto	0.000064.  Your mileage will vary, learn to use the authspeed tools
47258945Sroberto	if you're going to authenticate.
48258945Sroberto	
49258945Sroberto	In the file /etc/rc.local, make sure that the invocation of ntpd is
50258945Sroberto	commented out, and add an invocation of xntpd.  Here's what I'm using:
51258945Sroberto
52258945Sroberto		echo -n 'starting local daemons:'
53258945Sroberto
54258945Sroberto		if [ -f /etc/ntp.keys -a -f /usr/local/etc/xntp.conf ]; then
55258945Sroberto		    echo -n ' xntpd';           /usr/local/etc/xntpd
56258945Sroberto		fi
57258945Sroberto
58258945Sroberto		#XXX# echo -n ' ntpd';          /usr/libexec/ntpd -t
59258945Sroberto
60258945SrobertoAt this point, you should be good to go.  Try running /usr/local/etc/xntpd and
61258945Srobertousing ntpq or xntpdc to see if things are working, then pay attention the next
62258945Srobertotime you reboot to make sure that xntpd is being invoked, and use ntpq or
63258945Srobertoxntpdc again to make sure all is well.  
64258945Sroberto
65258945SrobertoEnjoy!
66