aboutsummaryrefslogtreecommitdiff
path: root/sntp/sntp.texi
diff options
context:
space:
mode:
Diffstat (limited to 'sntp/sntp.texi')
-rw-r--r--sntp/sntp.texi84
1 files changed, 84 insertions, 0 deletions
diff --git a/sntp/sntp.texi b/sntp/sntp.texi
new file mode 100644
index 000000000000..482cf1eb065d
--- /dev/null
+++ b/sntp/sntp.texi
@@ -0,0 +1,84 @@
+\input texinfo @c -*-texinfo-*-
+@c %**start of header
+@setfilename sntp.info
+@settitle Sntp User's Manual
+@include version.texi
+@paragraphindent 2
+@c %**end of header
+
+@ifinfo
+This file documents the use of the NTP Project's SNTP, a program for
+querying and setting the time.
+@end ifinfo
+
+@direntry
+* sntp: (sntp). Simple Network Time Protocol
+@end direntry
+
+@titlepage
+@title Simple Network Time Protocol User's Manual
+@subtitle sntp, version @value{VERSION}, @value{UPDATED}
+@c @author Max @email{foo@ntp.org}
+@end titlepage
+
+@c @page
+@c @vskip 0pt plus 1filll
+
+@node Top, sntp Description, (dir), (dir)
+@top Simple Network Time Protocol User Manual
+
+This document describes the use of the NTP Project's @code{sntp} program,
+that can be used to query a Network Time Protocol (NTP) server and
+display the time offset of the system clock relative to the server
+clock. Run as root, it can correct the system clock to this offset as
+well. It can be run as an interactive command or from a cron job.
+
+This document applies to version @value{VERSION} of @code{sntp}.
+
+The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
+IETF specification.
+
+@shortcontents
+
+@menu
+* sntp Description:: Description
+* sntp Invocation:: Invoking sntp
+* Usage:: Usage
+@end menu
+
+@node sntp Description
+@comment node-name, next, previous, up
+@section Description
+
+By default, @code{sntp} writes the local data and time (i.e., not UTC) to the
+standard output in the format:
+
+@example
+1996 Oct 15 20:17:25.123 +4.567 +/- 0.089 secs
+@end example
+
+where the +4.567 +/- 0.089 secs indicates the time offset and
+error bound of the system clock relative to the server clock.
+
+@include sntp-opts.texi
+
+@node Usage
+@comment node-name, next, previous, up
+@section Usage
+
+The simplest use of this program is as an unprivileged command to
+check the current time, offset, and error in the local clock.
+For example:
+
+@example
+sntp ntpserver.somewhere
+@end example
+
+With suitable privilege, it can be run as a command or in a
+@code{crom} job to reset the local clock from a reliable server, like
+the @code{ntpdate} and @code{rdate} commands.
+For example:
+
+@example
+sntp -a ntpserver.somewhere
+@end example