Henry Spencer's REGEX package modified for vi (bug fixes)
[unix-history] / contrib / xntpd / Config.local.dist
CommitLineData
09169146
GW
1# This is the local configure file (distribution version).
2# You must modify it to fit your particular configuration
3# and name it Config.local
4# The following configuratiions can be auto-generated:
5#
6# make Config.local.green
7# make a Config.local that supports a local clock
8# (i.e. allow fallback to use of the CPU's own clock)
9# make Config.local.NO.clock
10# make a Config.local that supports no clocks
11#
12#
13# NOTE TO GREENHORNS
14#
15# For plug-'n-play and no radios or other complicated gadgetry,
16# use "make Config.local.green" as above.
17#
18# Following defines can be set in the DEFS_OPT= define:
19#
20# The flag -DDEBUG includes some debugging code. To use this, include
21# the define and start the daemon with one or more -d flags, depending
22# on your calibration of pearannoya. The daemon will not detach your
23# terminal in this case. Judicious use of grep will reduce the speaker
24# volume to bearable levels.
25#
26# To change the location of the configuration file, use a
27# -DCONFIG_FILE=\\"/local/etc/ntp.conf\\" or something similar.
28#
29# The -DSYSLOG_FILE defines allows logging messages that are normally
30# reported via syslof() in a file. The file name can be configured using
31# the configuration line "logfile <filename>" in CONFIG_FILE.
32#
33# There are three serial port system software interfaces, each of
34# which is peculiar to one or more Unix versions. Define
35# -DHAVE_SYSV_TTYS for basic System V compatibility; define -DSTREAM
36# for POSIX compatibility including System V Streams, and
37# HAVE_BSD_TTYS for 4.3bsd compatibility. Only one of these three
38# should be defined. If none are defined, HAVE_BSD_TTYS is assumed.
39# Usually these defines are already set correctly.
40#
41DEFS_OPT=-DDEBUG
42
43#
44# The DEFS_LOCAL define picks up all flags from DEFS_OPT (do not delete that)
45# and one of the following:
46#
47# The flag -DREFCLOCK causes the basic reference clock support to be
48# compiled into the daemon. If you set this you may also want to
49# configure the particular clock drivers you want in the CLOCKDEFS= line
50# below. This flag affects xntpd only. This define is included by
51# default when using the "make makeconfig" script.
52#
53# The next two sets of defines are meaningful only when radio clock
54# drivers or special 1-pps signals are to be used. For systems without
55# these features, these delicious complexities can be avoided. Ordinarily,
56# the "make makeconfig" script figures out which ones to use, but your
57# mileage may vary.
58#
59# There are three ways to utilize external 1-pps signals. Define
60# -DPPS to include just the pps routine, such as used by the DCF77(PARSE)
61# clock driver. Define -DPPSCLK to include a serial device driver
62# which avoids much of the jitter due to upper level port
63# processing. This requires a dedicated serial port and either the
64# tty_clock line discipline or tty_clk_streams module, both of
65# which are in the ./kernel directory. Define -DPPSCD to include a
66# special driver which intercepts carrier-detect transitions
67# generated by the pps signal. This requires a nondedicated serial
68# port and the ppsclock streams module in the ./kernel directory.
69# Only one of these three flags should be defined.
70#
71# The flag KERNEL_PLL causes code to be compiled for a special feature of
72# the kernel that (a) implements the phase-lock loop and (b) provides
73# a user interface to learn time, maximum error and estimated error.
74# See the file README.kern in the doc directory for further info.
75# This code is activated only if the relevant kernel features have
76# been configured; it does not affect operation of unmodified kernels.
77# To compile it, however, requires a few header files from the
78# special distribution.
79#
80# Note: following line must always start with DEFS_LOCAL= $(DEFS_OPT)
81DEFS_LOCAL= $(DEFS_OPT) #GREEN -DREFCLOCK #TEST -DPPSPPS -DKERNEL_PLL
82
83#
84# Radio clock support definitions (these only make sense if -DREFCLOCK
85# used), which is normally the case. Note that a configuration can include
86# no clocks, more than one type of clock and even multiple clocks of the
87# same type.
88#
89# For most radio clocks operating with serial ports, accuracy can
90# be considerably improved through use of the tty_clk line
91# discipline or tty_clk_STREAMS streams module found in the
92# ./kernel directory. These gizmos capture a timestamp upon
93# occurrence of an intercept character and stuff it in the data
94# stream for the clock driver to munch. To select this mode,
95# postfix the driver name with the string CLK; that is, WWVB
96# becomes WWVBCLK. If more than one clock is in use, the CLK
97# postfix can be used with any or all of them.
98#
99# Alternatively, for the best accuracy, use the ppsclock streams
100# module in the ./ppsclock directory to steal the carrier-detect
101# transition and capture a precision timestamp. At present this
102# works only with SunOS 4.1.1 or later. To select this mode,
103# postfix the driver name with the string PPS; that is, AS2201
104# becomes AS2201PPS. If more than one clock is in use, the PPS
105# postfix should be used with only one of them. If any PPS
106# postfix is defined, the -DPPSPPS define should be used on the
107# DEFS above.
108#
109# Define -DLOCAL_CLOCK for a local pseudo-clock to masquerade as a
110# reference clock for those subnets without access to the real thing.
111# Works in all systems and requires no hardware support. This is defined
112# by default when using the "make makeconfig" script and greenhorn
113# configuraiton.
114#
115# Define -DPST for a PST/Traconex 1020 WWV/H receiver. The driver
116# supports both the CLK and PPS modes. It should work in all systems
117# with a serial port.
118#
119# Define -DWWVB for a Spectracom 8170 or Netclock/2 WWVB receiver. It
120# should work in all systems with a serial port. The driver supports
121# both the CLK and PPS modes if the requisite kernel support is installed.
122#
123# Define -DCHU for a special CHU receiver using an ordinary shortwave
124# radio. This requires the chu_clk line discipline or chu_clk_STREAMS
125# module in the ./kernel directory. At present, this driver works only
126# on SunOS4.1.x; operation in other systems has not been confirmed.
127# Construction details for a suitable modem can be found in the ./gadget
128# directory. The driver supports # neither the CLK nor PPS modes.
129#
130# Define -DPARSE for a DCF77/GPS(GENERIC) receiver. For best performance
131# this requires a special parsestreams STREAMS (SunOS 4.x) module in the
132# ./parse directory. Define -DPARSEPPS for PPS support via the
133# DCF77/GPS (GENERIC) receiver; also, define -DPPS in the DEFS above.
134# Define: -DCLOCK_MEINBERG for Meinberg clocks
135# -DCLOCK_SCHMID for Schmid receivers
136# -DCLOCK_DCF7000 for ELV DCF7000
137# -DCLOCK_RAWDCF for simple receivers (100/200ms pulses on Rx)
138# -DCLOCK_TRIMSV6 for Trimble SV6 GPS receiver
139#
140# Define -DMX4200PPS for a Magnavox 4200 GPS receiver. At present, this
141# driver works only on SunOS4.1.x with CPU serial ports only. The PPS
142# mode is required.
143#
144# Define -DAS2201 for an Austron 2200A or 2201A GPS receiver. It should
145# work in all systems with a serial port. The driver does not support the
146# CLK mode, but does support the PPS mode. If the radio is connected to
147# more than one machine, the PPS mode is required.
148#
149# Define -DGOES for a Kinemetrics/TrueTime 468-DC GOES receiver. This
150# driver is known to work with some other TrueTime products as well,
151# including the GPS-DC GPS receiver. It should work in all systems with
152# a serial port. The driver does not support the CLK mode, but does
153# support the PPS mode.
154#
155# Define -DOMEGA for a Kinemetrics/TrueTime OM-DC OMEGA receiver. It
156# should work in all systems with a serial port. The driver does not
157# support the CLK mode, but does support the PPS mode.
158#
159# Define -DTPRO for a KSI/Odetics TPRO-S IRIG-B timecode reader. This
160# requires the SunOS interface driver available from KSI. The driver
161# supports neither the CLK nor PPS modes.
162#
163# Define -DLEITCH for a Leitch CSD 5300 Master Clock System Driver for
164# the HP 5061B Cesium Clock. It should work in all systems with a serial
165# port. The driver does not support the CLK mode, but does support the
166# PPS mode.
167#
168# Define -DMSFEESPPS for an EES M201 MSF receiver. It currently only works
169# under SunOS 4.x with the PPSCD (ppsclock) STREAMS module, but the RCS
170# files on cl.cam.ac.uk still has support for CLK and CBREAK modes.
171#
172# Define -DIRIG for a IRIG-B timecode timecode using the audio codec of
173# the Sun SPARCstations. This requires a modified BSD audio driver and
174# exclusive access to the audio port. A memo describing how it works and
175# how to install the driver is in the README.irig file in the ./doc
176# directory.
177#
178# Note: The following defines result in compilation of all the above radio
179# clocks. This works on a Sun 4.1.x system which has tty_clk, chu_clk and
180# ppsclock STREAMS modules installed. If the trailing CLK and PPS suffixes
181# are removed and the IRIG, PARSE* and CLOCK* deleted, all of the rest compile
182# under Ultrix 4.2a/3. If the MX4200 is removed, all the rest compile on a DEC
183# OSF/1 Alpha.
184#
185CLOCKDEFS= #GREEN -DLOCAL_CLOCK #TEST -DAS2201PPS -DCHU -DGOES -DIRIG -DMX4200PPS -DOMEGA -DPST -DPSTCLK -DTPRO -DWWVBCLK -DMSFEESPPS -DLEITCH -DPARSE -DPARSEPPS -DCLOCK_MEINBERG -DCLOCK_RAWDCF -DCLOCK_SCHMID -DCLOCK_DCF7000 -DCLOCK_TRIMSV6
186
187#
188# Directory into which binaries should be installed (default /usr/local)
189#
190BINDIR= /usr/local/bin