summaryrefslogtreecommitdiff
path: root/sys/man/8/timesync
diff options
context:
space:
mode:
Diffstat (limited to 'sys/man/8/timesync')
-rwxr-xr-xsys/man/8/timesync110
1 files changed, 110 insertions, 0 deletions
diff --git a/sys/man/8/timesync b/sys/man/8/timesync
new file mode 100755
index 000000000..c1272f715
--- /dev/null
+++ b/sys/man/8/timesync
@@ -0,0 +1,110 @@
+.TH TIMESYNC 8
+.SH NAME
+timesync \- synchronize the system clock to a time source
+.SH SYNOPSIS
+.B aux/timesync
+[
+.B -a
+.I accuracy
+]
+[
+.B -S
+.I stratum
+]
+[
+.B -s
+.I netroot
+]
+[
+.B -frnDdLilG
+]
+[
+.I timeserver
+]
+.SH DESCRIPTION
+.B Aux/timesync
+synchronizes the system clock to a time source, by default a
+file server.
+The options are:
+.TP
+.B -f
+synchronize to a file server. If
+.I timeserver
+is missing, use
+.BR /srv/boot .
+.TP
+.B -r
+synchronize to the local real time clock,
+.BR #r/rtc .
+.TP
+.B -L
+used with
+.B -r
+to indicate the real time clock is in
+local time rather than GMT. This is
+useful on PCs that also run the
+Windows OS.
+.TP
+.B -n
+synchronize to an NTP server. If
+.I timeserver
+is missing, dial the server
+.BR udp!$ntp!ntp .
+.TP
+.B -D
+print debugging to standard error
+.TP
+.B -d
+put file containing last determined clock
+frequency in directory
+.IR dir ,
+default
+.BR /tmp .
+.TP
+.B -i
+stands for impotent.
+.I Timesync
+announces what it would do but doesn't do it.
+This is useful for tracking alternate time sources.
+.TP
+.B -a
+specifies the
+.I accuracy
+in nanoseconds to which the
+clock should be synchronized. This determines
+how often the reference clock is accessed.
+.TP
+.B -G
+causes
+.I timesync
+to use a gps server (see
+.IR gpsfs (8))
+as a time source.
+.TP
+.B -s
+causes
+.I timesync
+to listen for UDP NTP requests on the
+network rooted at
+.IR netroot .
+Up to 4
+.B -s
+options are allowed.
+.TP
+.B -S
+sets the stratum number to
+.IR stratum .
+.TP
+.B -l
+turns on logging to
+.BR /sys/log/timesync .
+.SH FILES
+.TF /tmp/ts.<sysname>.<type>.timeserver
+.TP
+.B /tmp/ts.<sysname>.<type>.timeserver
+where the last frequency guess is kept
+.TP
+.B /sys/log/timesync
+log file
+.SH SOURCE
+.B /sys/src/cmd/aux/timesync.c