timesync 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110
  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 startum .
  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