usr/src/usr.sbin/timed/timedc/timedc.8


.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"     @(#)timedc.8    1.1 (Berkeley) %G%
.\"
.TH TIMEDC 8 ""
.UC 6
.ad
.SH NAME
timedc \- timed control program
.SH SYNOPSIS
.B /etc/timedc
[ command [ argument ... ] ]
.SH DESCRIPTION
.I Timedc
is used to control the operation of the \fItimed\fP program.
It may be used to:
.IP \(bu
measure the differences between machines' clocks,
.IP \(bu
find the location where the master timed is running,
.IP \(bu
cause election timers on several machines to expire at the same time,
.IP \(bu
enable or disable tracing of messages received by \fItimed\fP.
.PP
Without any arguments,
.I timedc
will prompt for commands from the standard input.
If arguments are supplied,
.IR timedc
interprets the first argument as a command and the remaining
arguments as parameters to the command.  The standard input
may be redirected causing
.I timedc
to read commands from a file.
Commands may be abbreviated;
recognized commands are:
.TP
? [ command ... ]
.TP
help [ command ... ]
.br
Print a short description of each command specified in the argument list,
or, if no arguments are given, a list of the recognized commands.
.TP
clockdiff host ...
.br
Compute the differences between the clock of the host machine
and the clocks of the machines given as arguments.
.TP
testing host ...
.br
Cause timed election timers to expire in the specified
hosts. It is used to test the election algorithm.
.TP
tracing { on | off }
.br
Enable or disable the tracing of incoming messages to \fItimed\fP
in the file /usr/adm/timed.log.
.TP
quit
.br
Exit from timedc.
.SH FILES
.nf
.ta \w'/usr/adm/masterlog       'u
/usr/adm/timed.log              tracing file for timed
/usr/adm/timed.masterlog        log file for master timed
.fi
.SH "SEE ALSO"
date(1), adjtime(2), timed(8),
\fITSP: The Time Synchronization Protocol for UNIX 4.3BSD\fP,
R. Gusella and S. Zatti
.SH DIAGNOSTICS
.nf
.ta \w'?Ambiguous command      'u
?Ambiguous command      abbreviation matches more than one command
?Invalid command        no match found
?Privileged command     command can be executed by root only
.fi