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