sys/man/8/timesync

   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 .TP
  30 .B -f
  31 synchronize to a file server.  If
  32 .I timeserver
  33 is missing, use
  34 .BR /srv/boot .
  35 .TP
  36 .B -r
  37 synchronize to the local real time clock,
  38 .BR #r/rtc .
  39 .TP
  40 .B -L
  41 used with
  42 .B -r
  43 to indicate the real time clock is in
  44 local time rather than GMT.  This is
  45 useful on PCs that also run the
  46 Windows OS.
  47 .TP
  48 .B -n
  49 synchronize to an NTP server.  If
  50 .I timeserver
  51 is missing, dial the server
  52 .BR udp!$ntp!ntp .
  53 .TP
  54 .B -D
  55 print debugging to standard error
  56 .TP
  57 .B -d
  58 put file containing last determined clock
  59 frequency in directory
  60 .IR dir ,
  61 default
  62 .BR /tmp .
  63 .TP
  64 .B -i
  65 stands for impotent.
  66 .I Timesync
  67 announces what it would do but doesn't do it.
  68 This is useful for tracking alternate time sources.
  69 .TP
  70 .B -a
  71 specifies the
  72 .I accuracy
  73 in nanoseconds to which the
  74 clock should be synchronized.  This determines
  75 how often the reference clock is accessed.
  76 .TP
  77 .B -G
  78 causes
  79 .I timesync
  80 to use a gps server (see
  81 .IR gpsfs (8))
  82 as a time source.
  83 .TP
  84 .B -s
  85 causes
  86 .I timesync
  87 to listen for UDP NTP requests on the
  88 network rooted at
  89 .IR netroot .
  90 Up to 4
  91 .B -s
  92 options are allowed.
  93 .TP
  94 .B -S
  95 sets the stratum number to
  96 .IR stratum .
  97 .TP
  98 .B -l
  99 turns on logging to
 100 .BR /sys/log/timesync .
 101 .SH FILES
 102 .TF /tmp/ts.<sysname>.<type>.timeserver
 103 .TP
 104 .B /tmp/ts.<sysname>.<type>.timeserver
 105 where the last frequency guess is kept
 106 .TP
 107 .B /sys/log/timesync
 108 log file
 109 .SH SOURCE
 110 .B /sys/src/cmd/aux/timesync.c