sntp.texi revision 258945
1\input texinfo @c -*-texinfo-*- 2@c %**start of header 3@setfilename sntp.info 4@settitle Sntp User's Manual 5@include version.texi 6@paragraphindent 2 7@c %**end of header 8 9@ifinfo 10This file documents the use of the NTP Project's SNTP, a program for 11querying and setting the time. 12@end ifinfo 13 14@direntry 15* sntp: (sntp). Simple Network Time Protocol 16@end direntry 17 18@titlepage 19@title Simple Network Time Protocol User's Manual 20@subtitle sntp, version @value{VERSION}, @value{UPDATED} 21@c @author Max @email{foo@ntp.org} 22@end titlepage 23 24@c @page 25@c @vskip 0pt plus 1filll 26 27@node Top, sntp Description, (dir), (dir) 28@top Simple Network Time Protocol User Manual 29 30This document describes the use of the NTP Project's @code{sntp} program, 31that can be used to query a Network Time Protocol (NTP) server and 32display the time offset of the system clock relative to the server 33clock. Run as root, it can correct the system clock to this offset as 34well. It can be run as an interactive command or from a cron job. 35 36This document applies to version @value{VERSION} of @code{sntp}. 37 38The program implements the SNTP protocol as defined by RFC 5905, the NTPv4 39IETF specification. 40 41@shortcontents 42 43@menu 44* sntp Description:: Description 45* sntp Invocation:: Invoking sntp 46* Usage:: Usage 47@end menu 48 49@node sntp Description 50@comment node-name, next, previous, up 51@section Description 52 53By default, @code{sntp} writes the local data and time (i.e., not UTC) to the 54standard output in the format: 55 56@example 571996 Oct 15 20:17:25.123 +4.567 +/- 0.089 secs 58@end example 59 60where the +4.567 +/- 0.089 secs indicates the time offset and 61error bound of the system clock relative to the server clock. 62 63@include sntp-opts.texi 64 65@node Usage 66@comment node-name, next, previous, up 67@section Usage 68 69The simplest use of this program is as an unprivileged command to 70check the current time, offset, and error in the local clock. 71For example: 72 73@example 74sntp ntpserver.somewhere 75@end example 76 77With suitable privilege, it can be run as a command or in a 78@code{crom} job to reset the local clock from a reliable server, like 79the @code{ntpdate} and @code{rdate} commands. 80For example: 81 82@example 83sntp -a ntpserver.somewhere 84@end example 85