xref: /original-bsd/usr.sbin/timed/timedc/timedc.8 (revision b4971bb3)
1.\" Copyright (c) 1980, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)timedc.8	8.1 (Berkeley) 06/06/93
7.\"
8.Dd
9.Dt TIMEDC 8
10.Os BSD 4.3
11.ad
12.Sh NAME
13.Nm timedc
14.Nd timed control program
15.Sh SYNOPSIS
16.Nm timedc
17.Oo Ar command\ \&
18.Op Ar argument ...
19.Oc
20.Sh DESCRIPTION
21.Nm Timedc
22is used to control the operation of the
23.Xr timed 8
24program.
25It may be used to:
26.Bl -bullet
27.It
28Measure the differences between machines' clocks,
29.It
30Find the location where the master time server is running,
31.It
32Enable or disable tracing of messages received by
33.Xr timed ,
34and
35.It
36Perform various debugging actions.
37.El
38.Pp
39Without any arguments,
40.Nm timedc
41will prompt for commands from the standard input.
42If arguments are supplied,
43.Nm timedc
44interprets the first argument as a command and the remaining
45arguments as parameters to the command.  The standard input
46may be redirected causing
47.Nm timedc
48to read commands from a file.
49Commands may be abbreviated;
50recognized commands are:
51.Pp
52.Bl -tag -width Ds -compact
53.It Ic \&? Op Ar command ...
54.Pp
55.It Ic help Op Ar command ...
56Print a short description of each command specified in the argument list,
57or, if no arguments are given, a list of the recognized commands.
58.Pp
59.It Ic clockdiff Ar host ...
60Compute the differences between the clock of the host machine
61and the clocks of the machines given as arguments.
62.Pp
63.It Ic msite Op Ar host ...
64Show the master time server for specified host(s).
65.Pp
66.It Xo
67.Ic trace
68.Li \&{ Ar on Li \&|
69.Ar off \&}
70.Xc
71Enable or disable the tracing of incoming messages to
72.Xr timed
73in the file
74.Pa /var/log/timed.log.
75.Pp
76.It Ic election Ar host
77Asks the daemon
78on the target host to reset its "election" timers and to ensure that
79a time master has been elected.
80.Pp
81.It Ic quit
82Exit from timedc.
83.El
84.Pp
85Other commands may be included for use in testing and debugging
86.Xr timed ;
87the help command and
88the program source may be consulted for details.
89.Sh FILES
90.Bl -tag -width /var/log/timed.masterlog -compact
91.It Pa /var/log/timed.log
92tracing file for timed
93.It Pa /var/log/timed.masterlog
94log file for master timed
95.El
96.Sh SEE ALSO
97.Xr date 1 ,
98.Xr adjtime 2 ,
99.Xr icmp 4 ,
100.Xr timed 8 ,
101.Rs
102.%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD"
103.%A R. Gusella
104.%A S. Zatti
105.Re
106.Sh DIAGNOSTICS
107.Bl -tag -width Ds -compact
108.It ?Ambiguous command
109abbreviation matches more than one command
110.It ?Invalid command
111no match found
112.It ?Privileged command
113command can be executed by root only
114.El
115.Sh HISTORY
116The
117.Nm
118command appeared in
119.Bx 4.3 .
120