Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH TIMESYNC 8
2 
.SH NAME
3 
timesync \- synchronize the system clock to a time source
4 
.SH SYNOPSIS
5 
.B aux/timesync
6 
[
7 
.B -a
8 
.I accuracy
9 
]
10 
[
11 
.B -S
12 
.I stratum
13 
]
14 
[
15 
.B -s
16 
.I netroot
17 
]
18 
[
19 
.B -frnDdLilG
20 
]
21 
[
22 
.I timeserver
23 
]
24 
.SH DESCRIPTION
25 
.B Aux/timesync
26 
synchronizes the system clock to a time source, by default a
27 
file server.
28 
The options are:
29 
.TF -L
30 
.PD
31 
.TP
32 
.B -f
33 
synchronize to a file server.  If
34 
.I timeserver
35 
is missing, use
36 
.BR /srv/boot .
37 
.TP
38 
.B -r
39 
synchronize to the local real time clock,
40 
.BR #r/rtc .
41 
.TP
42 
.B -L
43 
used with
44 
.B -r
45 
to indicate the real time clock is in
46 
local time rather than GMT.  This is
47 
useful on PCs that also run the
48 
Windows OS.
49 
.TP
50 
.B -n
51 
synchronize to an NTP server.  If
52 
.I timeserver
53 
is missing, dial the server
54 
.BR udp!$ntp!ntp .
55 
.TP
56 
.B -D
57 
print debugging to standard error
58 
.TP
59 
.B -d
60 
put file containing last determined clock
61 
frequency in directory
62 
.IR dir ,
63 
default
64 
.BR /tmp .
65 
.TP
66 
.B -i
67 
stands for impotent.
68 
.I Timesync
69 
announces what it would do but doesn't do it.
70 
This is useful for tracking alternate time sources.
71 
.TP
72 
.B -a
73 
specifies the
74 
.I accuracy
75 
in nanoseconds to which the
76 
clock should be synchronized.  This determines
77 
how often the reference clock is accessed.
78 
.TP
79 
.B -G
80 
causes
81 
.I timesync
82 
to use a gps server (see
83 
.IR gpsfs (8))
84 
as a time source.
85 
.TP
86 
.B -s
87 
causes
88 
.I timesync
89 
to listen for UDP NTP requests on the
90 
network rooted at
91 
.IR netroot .
92 
Up to 4
93 
.B -s
94 
options are allowed.
95 
.TP
96 
.B -S
97 
sets the stratum number to
98 
.IR stratum .
99 
.TP
100 
.B -l
101 
turns on logging to
102 
.BR /sys/log/timesync .
103 
.SH FILES
104 
.TF /tmp/ts.<sysname>.<type>.timeserver
105 
.TP
106 
.B /tmp/ts.<sysname>.<type>.timeserver
107 
where the last frequency guess is kept
108 
.TP
109 
.B /sys/log/timesync
110 
log file
111 
.SH SOURCE
112 
.B /sys/src/cmd/aux/timesync.c
113 
.SH BUGS
114 
Only works with IPv4.