4 @cindex standard SNTP program
7 # EDIT THIS FILE WITH CAUTION (sntp-opts.texi)
9 # It has been AutoGen-ed Sunday August 17, 2008 at 05:27:25 AM EDT
10 # From the definitions sntp-opts.def
11 # and the template file aginfo.tpl
13 This program has no explanation.
16 can be used as a SNTP client to query a NTP or SNTP server and either display
17 the time or set the local system's time (given suitable privilege). It can be
18 run as an interactive command or in a
21 NTP is the Network Time Protocol (RFC 1305) and SNTP is the
22 Simple Network Time Protocol (RFC 2030, which supersedes RFC 1769).
24 This section was generated by @strong{AutoGen},
25 the aginfo template and the option descriptions for the @command{sntp} program. It documents the sntp usage text and option meanings.
27 This software is released under a specialized copyright license.
30 * sntp usage:: sntp usage help (-?)
31 * sntp adjtime:: adjtime option (-a)
32 * sntp extraverbose:: extraverbose option (-V)
33 * sntp ipv4:: ipv4 option (-4)
34 * sntp ipv6:: ipv6 option (-6)
35 * sntp megaverbose:: megaverbose option (-W)
36 * sntp normalverbose:: normalverbose option (-v)
37 * sntp settimeofday:: settimeofday option (-r)
38 * sntp unprivport:: unprivport option (-u)
42 @subsection sntp usage help (-?)
45 This is the automatically generated usage text for sntp:
49 sntp is unavailable - no --help
54 @subsection ipv4 option (-4)
57 This is the ``force ipv4 dns name resolution'' option.
59 This option has some usage constraints. It:
62 is a member of the ipv4 class of options.
65 Force DNS resolution of following host names on the command line
66 to the IPv4 namespace.
69 @subsection ipv6 option (-6)
72 This is the ``force ipv6 dns name resolution'' option.
74 This option has some usage constraints. It:
77 is a member of the ipv4 class of options.
80 Force DNS resolution of following host names on the command line
81 to the IPv6 namespace.
84 @subsection unprivport option (-u)
85 @cindex sntp-unprivport
87 This is the ``use an unprivileged port'' option.
88 Use an unprivilegded UDP port for our queries.
90 @node sntp normalverbose
91 @subsection normalverbose option (-v)
92 @cindex sntp-normalverbose
94 This is the ``slightly verbose'' option.
96 This option has some usage constraints. It:
99 must not appear in combination with any of the following options:
100 extraverbose, megaverbose.
103 Diagnostic messages for non-fatal errors and a limited amount of
104 tracing should be written to standard error. Fatal ones always
105 produce a diagnostic. This option should be set when there is a
106 suspected problem with the server, network or the source.
108 @node sntp extraverbose
109 @subsection extraverbose option (-V)
110 @cindex sntp-extraverbose
112 This is the ``extra verbose'' option.
114 This option has some usage constraints. It:
117 must not appear in combination with any of the following options:
118 normalverbose, megaverbose.
121 Produce more and less comprehensible output, mainly for investigating
122 problems with apparently inconsistent timestamps. This option should
123 be set when the program fails with a message indicating that is the
126 @node sntp megaverbose
127 @subsection megaverbose option (-W)
128 @cindex sntp-megaverbose
130 This is the ``mega verbose'' option.
132 This option has some usage constraints. It:
135 must not appear in combination with any of the following options:
136 normalverbose, extraverbose.
139 Very verbose debugging output that will interfere with the timing
140 when writing to the terminal (because of line buffered output from C).
141 Note that the times produced by this are the corrections needed, and
142 not the error in the local clock. This option should be set only when
143 debugging the source.
145 @node sntp settimeofday
146 @subsection settimeofday option (-r)
147 @cindex sntp-settimeofday
149 This is the ``set (step) the time with settimeofday()'' option.
151 This option has some usage constraints. It:
154 must not appear in combination with any of the following options:
161 @subsection adjtime option (-a)
164 This is the ``set (slew) the time with adjtime()'' option.
166 This option has some usage constraints. It:
169 must not appear in combination with any of the following options: