xref: /csrg-svn/usr.sbin/timed/timedc/timedc.8 (revision 61885)
1*61885Sbostic.\" Copyright (c) 1980, 1991, 1993
2*61885Sbostic.\"	The Regents of the University of California.  All rights reserved.
323740Sgusella.\"
443848Strent.\" %sccs.include.redist.man%
523740Sgusella.\"
6*61885Sbostic.\"     @(#)timedc.8	8.1 (Berkeley) 06/06/93
733124Sbostic.\"
847470Scael.Dd
947470Scael.Dt TIMEDC 8
1047470Scael.Os BSD 4.3
1123740Sgusella.ad
1247470Scael.Sh NAME
1347470Scael.Nm timedc
1447470Scael.Nd timed control program
1547470Scael.Sh SYNOPSIS
1647470Scael.Nm timedc
1747470Scael.Oo Ar command\ \&
1847470Scael.Op Ar argument ...
1947470Scael.Oc
2047470Scael.Sh DESCRIPTION
2147470Scael.Nm Timedc
2247470Scaelis used to control the operation of the
2347470Scael.Xr timed 8
2447470Scaelprogram.
2523740SgusellaIt may be used to:
2647470Scael.Bl -bullet
2747470Scael.It
2847470ScaelMeasure the differences between machines' clocks,
2947470Scael.It
3047470ScaelFind the location where the master time server is running,
3147470Scael.It
3247470ScaelEnable or disable tracing of messages received by
3347470Scael.Xr timed ,
3447470Scaeland
3547470Scael.It
3647470ScaelPerform various debugging actions.
3747470Scael.El
3847470Scael.Pp
3923740SgusellaWithout any arguments,
4047470Scael.Nm timedc
4123740Sgusellawill prompt for commands from the standard input.
4223740SgusellaIf arguments are supplied,
4347470Scael.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
4747470Scael.Nm timedc
4823740Sgusellato read commands from a file.
4923740SgusellaCommands may be abbreviated;
5023740Sgusellarecognized commands are:
5147470Scael.Pp
5247470Scael.Bl -tag -width Ds -compact
5347470Scael.It Ic \&? Op Ar command ...
5459906Sbostic.Pp
5547470Scael.It Ic help Op Ar command ...
5623740SgusellaPrint a short description of each command specified in the argument list,
5723740Sgusellaor, if no arguments are given, a list of the recognized commands.
5847470Scael.Pp
5947470Scael.It Ic clockdiff Ar host ...
6023740SgusellaCompute the differences between the clock of the host machine
6123740Sgusellaand the clocks of the machines given as arguments.
6247470Scael.Pp
6359906Sbostic.It Ic msite Op Ar host ...
6459906SbosticShow the master time server for specified host(s).
6559906Sbostic.Pp
6647470Scael.It Xo
6747470Scael.Ic trace
6847470Scael.Li \&{ Ar on Li \&|
6947470Scael.Ar off \&}
7047470Scael.Xc
7147470ScaelEnable or disable the tracing of incoming messages to
7247470Scael.Xr timed
7347470Scaelin the file
7447470Scael.Pa /var/log/timed.log.
7547470Scael.Pp
7659906Sbostic.It Ic election Ar host
7759906SbosticAsks the daemon
7859906Sbosticon the target host to reset its "election" timers and to ensure that
7959906Sbostica time master has been elected.
8059906Sbostic.Pp
8147470Scael.It Ic quit
8223740SgusellaExit from timedc.
8347470Scael.El
8447470Scael.Pp
8528857SkarelsOther commands may be included for use in testing and debugging
8647470Scael.Xr timed ;
8728857Skarelsthe help command and
8828857Skarelsthe program source may be consulted for details.
8947470Scael.Sh FILES
9047470Scael.Bl -tag -width /var/log/timed.masterlog -compact
9147470Scael.It Pa /var/log/timed.log
9247470Scaeltracing file for timed
9347470Scael.It Pa /var/log/timed.masterlog
9447470Scaellog file for master timed
9547470Scael.El
9647470Scael.Sh SEE ALSO
9747470Scael.Xr date 1 ,
9847470Scael.Xr adjtime 2 ,
9947470Scael.Xr icmp 4 ,
10047470Scael.Xr timed 8 ,
10147470Scael.Rs
10247470Scael.%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD"
10347470Scael.%A R. Gusella
10447470Scael.%A S. Zatti
10547470Scael.Re
10647470Scael.Sh DIAGNOSTICS
10747470Scael.Bl -tag -width Ds -compact
10847470Scael.It ?Ambiguous command
10947470Scaelabbreviation matches more than one command
11047470Scael.It ?Invalid command
11147470Scaelno match found
11247470Scael.It ?Privileged command
11347470Scaelcommand can be executed by root only
11447470Scael.El
11547470Scael.Sh HISTORY
11647470ScaelThe
11747470Scael.Nm
11847470Scaelcommand appeared in
11947470Scael.Bx 4.3 .
120