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