Contents of this page are obsolete.
This page is preserved and stored at this URL just from historical viewpoint.
Original URL was http://www.mm.media.kyoto-u.ac.jp/members/kameda/...
Please visit
www.kameda-lab.org
for recent information. (2002/12/06, kameda@ieee.org)
Miscellaneous Options
Miscellaneous Commands
broadcastdelay seconds
- The broadcast and multicast modes require a special calibration to
determine the network delay between the local and remote servers.
Ordinarily, this is done automatically by the initial protocol exchanges
between the local and remote servers. In some cases, the calibration
procedure may fail due to network or server access controls, for
example. This command specifies the default delay to be used under these
circumstances. Typically (for Ethernet), a number between 0.003 and
0.007 seconds is appropriate. The default when this command is not used
is 0.004 seconds.
trap host_address [ port port_number ] [
interface interface_address ]
- This command configures a trap receiver at the given host address
and port number for sending messages with the specified local interface
address. If the port number is unspecified. a value of 18447 is used. If
the interface address is not specified, the message is sent with a
source address of the local interface the message is sent through. Note
that on a multihomed host the interface used may vary from time to time
with routing changes.
- The trap receiver will generally log event messages and other
information from the server in a log file. While such monitor programs
may also request their own trap dynamically, configuring a trap receiver
will ensure that no messages are lost when the server is started.
setvar variable [ default ]
- This command adds an additional system variable. These variables can
be used to distribute additional information such as the access policy.
If the variable of the form
name = value
is
followed by the default
keyword, the variable will be
listed as part of the default system variables (ntpq rv
command). These additional variables serve informational purposes only.
They are not related to the protocol other that they can be listed. The
known protocol variables will always override any variables defined via
the setvar
mechanism.
- There are three special variables that contain the names of all
variable of the same group. The
sys_var_list
holds the
names of all system variables. The peer_var_list
holds the
names of all peer variables and the clock_var_list
holds
the names of the reference clock variables.
logfile logfile
- This command specifies the location of an alternate log file to be
used instead of the default system
syslog
facility.
logconfig configkeyword
- This command controls the amount and type of output written to the
system
syslog
facility or the alternate
logfile
log file. By default, all output is turned on. All
configkeyword
keywords can be prefixed with
=
, +
and -
, where =
sets the syslogmask
, +
adds and -
removes messages. syslog messages
can be controlled in four
classes (, peer
, sys
and sync
).
Within these classes four types of messages can be controlled.
- Informational messages (
info
) control configuration
information. Event messages (events
) control logging of
events (reachability, synchronization, alarm conditions). Statistical
output is controlled with the statistics
keyword. The final
message group is the status messages. This describes mainly the
synchronizations status. Configuration keywords are formed by
concatenating the message class with the event class. The
allprefix
can be used instead of a message class. A message
class may also be followed by the all
keyword to
enable/disable all messages of the respective message class.
- Thus, a minimal log configuration could look like this:
logconfig = syncstatus +sysevents
- This would just list the synchronizations state of
xntpd
and the major system events. For a simple reference
server, the following minimum message configuration could be useful:
logconfig = syncall +clockall
- This configuration will list all clock information and
synchronization information. All other events and messages about peers,
system events and so on is suppressed.
Variables
Most variables used by the NTP protocol can be examined with the
xntpdc
(mode 7 messages) and the ntpq
(mode 6
messages). Currently, very few variables can be modified via mode 6
messages. These variables are either created with the
setvar
directive or the leap warning bits. The leap warning
bits can be set in the leapwarning
variable up to one month
ahead. Both the leapwarning
and leapindication
variables have a slightly different encoding than the usual leap bits
interpretation:
00
- The daemon passes the leap bits of its synchronization source (usual
mode of operation).
01/10
- A leap second is added/deleted (operator forced leap second).
11
- Leap information from the synchronizations source is ignored (thus
LEAP_NOWARNING
is passed on).
David L. Mills (mills@udel.edu)