xref: /csrg-svn/usr.sbin/timed/timedc/timedc.8 (revision 47470)
1*47470Scael.\" Copyright (c) 1980, 1991 Regents of the University of California.
233124Sbostic.\" All rights reserved.
323740Sgusella.\"
443848Strent.\" %sccs.include.redist.man%
523740Sgusella.\"
6*47470Scael.\"     @(#)timedc.8	6.6 (Berkeley) 03/16/91
733124Sbostic.\"
8*47470Scael.Dd
9*47470Scael.Dt TIMEDC 8
10*47470Scael.Os BSD 4.3
1123740Sgusella.ad
12*47470Scael.Sh NAME
13*47470Scael.Nm timedc
14*47470Scael.Nd timed control program
15*47470Scael.Sh SYNOPSIS
16*47470Scael.Nm timedc
17*47470Scael.Oo Ar command\ \&
18*47470Scael.Op Ar argument ...
19*47470Scael.Oc
20*47470Scael.Sh DESCRIPTION
21*47470Scael.Nm Timedc
22*47470Scaelis used to control the operation of the
23*47470Scael.Xr timed 8
24*47470Scaelprogram.
2523740SgusellaIt may be used to:
26*47470Scael.Bl -bullet
27*47470Scael.It
28*47470ScaelMeasure the differences between machines' clocks,
29*47470Scael.It
30*47470ScaelFind the location where the master time server is running,
31*47470Scael.It
32*47470ScaelEnable or disable tracing of messages received by
33*47470Scael.Xr timed ,
34*47470Scaeland
35*47470Scael.It
36*47470ScaelPerform various debugging actions.
37*47470Scael.El
38*47470Scael.Pp
3923740SgusellaWithout any arguments,
40*47470Scael.Nm timedc
4123740Sgusellawill prompt for commands from the standard input.
4223740SgusellaIf arguments are supplied,
43*47470Scael.Nm timedc
4423740Sgusellainterprets the first argument as a command and the remaining
4523740Sgusellaarguments as parameters to the command.  The standard input
4623740Sgusellamay be redirected causing
47*47470Scael.Nm timedc
4823740Sgusellato read commands from a file.
4923740SgusellaCommands may be abbreviated;
5023740Sgusellarecognized commands are:
51*47470Scael.Pp
52*47470Scael.Bl -tag -width Ds -compact
53*47470Scael.It Ic \&? Op Ar command ...
54*47470Scael.It Ic help Op Ar command ...
5523740SgusellaPrint a short description of each command specified in the argument list,
5623740Sgusellaor, if no arguments are given, a list of the recognized commands.
57*47470Scael.Pp
58*47470Scael.It Ic clockdiff Ar host ...
5923740SgusellaCompute the differences between the clock of the host machine
6023740Sgusellaand the clocks of the machines given as arguments.
61*47470Scael.Pp
62*47470Scael.It Xo
63*47470Scael.Ic trace
64*47470Scael.Li \&{ Ar on Li \&|
65*47470Scael.Ar off \&}
66*47470Scael.Xc
67*47470ScaelEnable or disable the tracing of incoming messages to
68*47470Scael.Xr timed
69*47470Scaelin the file
70*47470Scael.Pa /var/log/timed.log.
71*47470Scael.Pp
72*47470Scael.It Ic quit
7323740SgusellaExit from timedc.
74*47470Scael.El
75*47470Scael.Pp
7628857SkarelsOther commands may be included for use in testing and debugging
77*47470Scael.Xr timed ;
7828857Skarelsthe help command and
7928857Skarelsthe program source may be consulted for details.
80*47470Scael.Sh FILES
81*47470Scael.Bl -tag -width /var/log/timed.masterlog -compact
82*47470Scael.It Pa /var/log/timed.log
83*47470Scaeltracing file for timed
84*47470Scael.It Pa /var/log/timed.masterlog
85*47470Scaellog file for master timed
86*47470Scael.El
87*47470Scael.Sh SEE ALSO
88*47470Scael.Xr date 1 ,
89*47470Scael.Xr adjtime 2 ,
90*47470Scael.Xr icmp 4 ,
91*47470Scael.Xr timed 8 ,
92*47470Scael.Rs
93*47470Scael.%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD"
94*47470Scael.%A R. Gusella
95*47470Scael.%A S. Zatti
96*47470Scael.Re
97*47470Scael.Sh DIAGNOSTICS
98*47470Scael.Bl -tag -width Ds -compact
99*47470Scael.It ?Ambiguous command
100*47470Scaelabbreviation matches more than one command
101*47470Scael.It ?Invalid command
102*47470Scaelno match found
103*47470Scael.It ?Privileged command
104*47470Scaelcommand can be executed by root only
105*47470Scael.El
106*47470Scael.Sh HISTORY
107*47470ScaelThe
108*47470Scael.Nm
109*47470Scaelcommand appeared in
110*47470Scael.Bx 4.3 .
111