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