xref: /original-bsd/usr.sbin/timed/timedc/timedc.8 (revision f8013ff8)
1.\" Copyright (c) 1980, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)timedc.8	6.6 (Berkeley) 03/16/91
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.It Ic help Op Ar command ...
55Print a short description of each command specified in the argument list,
56or, if no arguments are given, a list of the recognized commands.
57.Pp
58.It Ic clockdiff Ar host ...
59Compute the differences between the clock of the host machine
60and the clocks of the machines given as arguments.
61.Pp
62.It Xo
63.Ic trace
64.Li \&{ Ar on Li \&|
65.Ar off \&}
66.Xc
67Enable or disable the tracing of incoming messages to
68.Xr timed
69in the file
70.Pa /var/log/timed.log.
71.Pp
72.It Ic quit
73Exit from timedc.
74.El
75.Pp
76Other commands may be included for use in testing and debugging
77.Xr timed ;
78the help command and
79the program source may be consulted for details.
80.Sh FILES
81.Bl -tag -width /var/log/timed.masterlog -compact
82.It Pa /var/log/timed.log
83tracing file for timed
84.It Pa /var/log/timed.masterlog
85log file for master timed
86.El
87.Sh SEE ALSO
88.Xr date 1 ,
89.Xr adjtime 2 ,
90.Xr icmp 4 ,
91.Xr timed 8 ,
92.Rs
93.%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD"
94.%A R. Gusella
95.%A S. Zatti
96.Re
97.Sh DIAGNOSTICS
98.Bl -tag -width Ds -compact
99.It ?Ambiguous command
100abbreviation matches more than one command
101.It ?Invalid command
102no match found
103.It ?Privileged command
104command can be executed by root only
105.El
106.Sh HISTORY
107The
108.Nm
109command appeared in
110.Bx 4.3 .
111