Lines Matching +full:manual +full:- +full:span +full:- +full:operation +full:- +full:config
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
3 <!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6 <title>Sntp User’s Manual</title>
8 <meta name="description" content="Sntp User’s Manual">
9 <meta name="keywords" content="Sntp User’s Manual">
10 <meta name="resource-type" content="document">
16 <!--
17 a.summary-letter {text-decoration: none}
18 blockquote.indentedblock {margin-right: 0em}
19 div.display {margin-left: 3.2em}
20 div.example {margin-left: 3.2em}
21 div.lisp {margin-left: 3.2em}
22 kbd {font-style: oblique}
23 pre.display {font-family: inherit}
24 pre.format {font-family: inherit}
25 pre.menu-comment {font-family: serif}
26 pre.menu-preformatted {font-family: serif}
27 span.nolinebreak {white-space: nowrap}
28 span.roman {font-family: initial; font-weight: normal}
29 span.sansserif {font-family: sans-serif; font-weight: normal}
30 ul.no-bullet {list-style: none}
31 -->
38 <h1 class="settitle" align="center">Sntp User’s Manual</h1>
44 <span id="Top"></span><div class="header">
46 Next: <a href="#sntp-Description" accesskey="n" rel="next">sntp Description</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
48 <span id="Simple-Network-Time-Protocol-User-Manual"></span><h1 class="top">Simple Network Time Protocol User Manual</h1>
61 <span id="SEC_Overview"></span>
62 <h2 class="shortcontents-heading">Short Table of Contents</h2>
65 <ul class="no-bullet">
66 <li><a id="stoc-Description" href="#toc-Description">1 Description</a></li>
72 <tr><td align="left" valign="top">• <a href="#sntp-Description" accesskey="1">sntp Description</a></td><td> </td><td align="left" valign="top">Description
74 <tr><td align="left" valign="top">• <a href="#sntp-Invocation" accesskey="2">sntp Invocation</a></td><td> </td><td align="left" valign="top">Invoking sntp
81 <span id="sntp-Description"></span><div class="header">
83 Next: <a href="#sntp-Invocation" accesskey="n" rel="next">sntp Invocation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
85 <span id="Description"></span><h2 class="chapter">1 Description</h2>
91 <pre class="example">1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
95 YYYY-MM-DD HH:MM:SS.SUBSEC is the local date and time,
98 the +4.567 +/- 0.089 secs indicates the time offset and
102 <tr><td align="left" valign="top">• <a href="#sntp-Invocation" accesskey="1">Invoking sntp</a></td><td> </td><td align="left" valign="top">
109 <span id="sntp-Invocation"></span><div class="header">
111 Next: <a href="#Usage" accesskey="n" rel="next">Usage</a>, Previous: <a href="#sntp-Description" accesskey="p" rel="prev">sntp Description</a>, Up: <a href="#sntp-Description" accesskey="u" rel="up">sntp Description</a> </p>
113 <span id="Invoking-sntp"></span><h3 class="section">1.1 Invoking sntp</h3>
114 <span id="index-sntp"></span>
115 <span id="index-standard-Simple-Network-Time-Protocol-client-program"></span>
133 <p><code>'1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN'</code>
145 <code>'+/- 0.089'</code>
151 <code>'+/- ?'</code>.
166 using the <code>agtexi-cmd</code> template and the option descriptions for the <code>sntp</code> program.
170 <tr><td align="left" valign="top">• <a href="#sntp-usage" accesskey="1">sntp usage</a></td><td> </td><td align="left" valign="top">sntp help/usage (<samp>--help</samp>)
172 <tr><td align="left" valign="top">• <a href="#sntp-ipv4" accesskey="2">sntp ipv4</a></td><td> </td><td align="left" valign="top">ipv4 option (-4)
174 <tr><td align="left" valign="top">• <a href="#sntp-ipv6" accesskey="3">sntp ipv6</a></td><td> </td><td align="left" valign="top">ipv6 option (-6)
176 <tr><td align="left" valign="top">• <a href="#sntp-authentication" accesskey="4">sntp authentication</a></td><td> </td><td align="left" valign="top">authentication option (-a)
178 <tr><td align="left" valign="top">• <a href="#sntp-broadcast" accesskey="5">sntp broadcast</a></td><td> </td><td align="left" valign="top">broadcast option (-b)
180 <tr><td align="left" valign="top">• <a href="#sntp-concurrent" accesskey="6">sntp concurrent</a></td><td> </td><td align="left" valign="top">concurrent option (-c)
182 <tr><td align="left" valign="top">• <a href="#sntp-gap" accesskey="7">sntp gap</a></td><td> </td><td align="left" valign="top">gap option (-g)
184 <tr><td align="left" valign="top">• <a href="#sntp-kod" accesskey="8">sntp kod</a></td><td> </td><td align="left" valign="top">kod option (-K)
186 <tr><td align="left" valign="top">• <a href="#sntp-keyfile" accesskey="9">sntp keyfile</a></td><td> </td><td align="left" valign="top">keyfile option (-k)
188 <tr><td align="left" valign="top">• <a href="#sntp-logfile">sntp logfile</a></td><td> </td><td align="left" valign="top">logfile option (-l)
190 <tr><td align="left" valign="top">• <a href="#sntp-steplimit">sntp steplimit</a></td><td> </td><td align="left" valign="top">steplimit option (-M)
192 <tr><td align="left" valign="top">• <a href="#sntp-ntpversion">sntp ntpversion</a></td><td> </td><td align="left" valign="top">ntpversion option (-o)
194 <tr><td align="left" valign="top">• <a href="#sntp-usereservedport">sntp usereservedport</a></td><td> </td><td align="left" valign="top">usereservedport option (-r)
196 <tr><td align="left" valign="top">• <a href="#sntp-timeout">sntp timeout</a></td><td> </td><td align="left" valign="top">timeout option (-t)
198 <tr><td align="left" valign="top">• <a href="#sntp-wait">sntp wait</a></td><td> </td><td align="left" valign="top">wait option
200 <tr><td align="left" valign="top">• <a href="#sntp-config">sntp config</a></td><td> </td><td align="left" valign="top">presetting/configuring sntp
202 <tr><td align="left" valign="top">• <a href="#sntp-exit-status">sntp exit status</a></td><td> </td><td align="left" valign="top">exit status
204 <tr><td align="left" valign="top">• <a href="#sntp-Usage">sntp Usage</a></td><td> </td><td align="left" valign="top">Usage
206 <tr><td align="left" valign="top">• <a href="#sntp-Authors">sntp Authors</a></td><td> </td><td align="left" valign="top">Authors
211 <span id="sntp-usage"></span><div class="header">
213 Next: <a href="#sntp-ipv4" accesskey="n" rel="next">sntp ipv4</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
215 <span id="sntp-help_002fusage-_0028_002d_002dhelp_0029"></span><h4 class="subsection">1.1.1 sntp help/usage (<samp>--help</samp>)</h4>
216 <span id="index-sntp-help"></span>
221 (<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print
223 <code>more-help</code> is disabled on platforms without a working
229 <pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p18
230 Usage: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
231 [ hostname-or-IP ...]
232 Flg Arg Option-Name Description
233 -4 no ipv4 Force IPv4 DNS name resolution
234 - prohibits the option 'ipv6'
235 -6 no ipv6 Force IPv6 DNS name resolution
236 - prohibits the option 'ipv4'
237 -a Num authentication Enable authentication with the key auth-keynumber
238 -b Str broadcast Listen to the address specified for broadcast time sync
239 - may appear multiple times
240 -c Str concurrent Concurrently query all IPs returned for host-name
241 - may appear multiple times
242 -d no debug-level Increase debug verbosity level
243 - may appear multiple times
244 -D Num set-debug-level Set the debug verbosity level
245 - may appear multiple times
246 -g Num gap The gap (in milliseconds) between time requests
247 -K Fil kod KoD history filename
248 -k Fil keyfile Look in this file for the key specified with -a
249 -l Fil logfile Log to specified logfile
250 -M Num steplimit Adjustments less than steplimit msec will be slewed
251 - it must be in the range:
253 -o Num ntpversion Send int as our NTP protocol version
254 - it must be in the range:
256 -r no usereservedport Use the NTP Reserved Port (port 123)
257 -S no step OK to 'step' the time with settimeofday(2)
258 -s no slew OK to 'slew' the time with adjtime(2)
259 -t Num timeout The number of seconds to wait for responses
261 - disabled as '--no-wait'
262 - enabled by default
264 -? no help display extended usage information and exit
265 -! no more-help extended usage information passed thru pager
266 -> opt save-opts save the option state to a config file
267 -< Str load-opts load options from a config file
268 - disabled as '--no-load-opts'
269 - may appear multiple times
276 - reading file $HOME/.ntprc
277 - reading file ./.ntprc
278 - examining environment variables named SNTP_*
284 <span id="sntp-ipv4"></span><div class="header">
286 Next: <a href="#sntp-ipv6" accesskey="n" rel="next">sntp ipv6</a>, Previous: <a href="#sntp-usage" accesskey="p" rel="prev">sntp usage</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
288 <span id="ipv4-option-_0028_002d4_0029"></span><h4 class="subsection">1.1.2 ipv4 option (-4)</h4>
289 <span id="index-sntp_002dipv4"></span>
302 <span id="sntp-ipv6"></span><div class="header">
304 Next: <a href="#sntp-authentication" accesskey="n" rel="next">sntp authentication</a>, Previous: <a href="#sntp-ipv4" accesskey="p" rel="prev">sntp ipv4</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
306 <span id="ipv6-option-_0028_002d6_0029"></span><h4 class="subsection">1.1.3 ipv6 option (-6)</h4>
307 <span id="index-sntp_002dipv6"></span>
320 <span id="sntp-authentication"></span><div class="header">
322 Next: <a href="#sntp-broadcast" accesskey="n" rel="next">sntp broadcast</a>, Previous: <a href="#sntp-ipv6" accesskey="p" rel="prev">sntp ipv6</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
324 <span id="authentication-option-_0028_002da_0029"></span><h4 class="subsection">1.1.4 authentication option (-a)</h4>
325 <span id="index-sntp_002dauthentication"></span>
327 <p>This is the “enable authentication with the key <var>auth-keynumber</var>” option.
328 This option takes a number argument <samp>auth-keynumber</samp>.
332 See the <samp>keyfile</samp> option (<samp>-k</samp>) for more details.
334 <span id="sntp-broadcast"></span><div class="header">
336 Next: <a href="#sntp-concurrent" accesskey="n" rel="next">sntp concurrent</a>, Previous: <a href="#sntp-authentication" accesskey="p" rel="prev">sntp authentication</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
338 <span id="broadcast-option-_0028_002db_0029"></span><h4 class="subsection">1.1.5 broadcast option (-b)</h4>
339 <span id="index-sntp_002dbroadcast"></span>
342 This option takes a string argument <samp>broadcast-address</samp>.
351 can (and probably should) be modified with <samp>-t</samp>.
353 <span id="sntp-concurrent"></span><div class="header">
355 Next: <a href="#sntp-gap" accesskey="n" rel="next">sntp gap</a>, Previous: <a href="#sntp-broadcast" accesskey="p" rel="prev">sntp broadcast</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
357 <span id="concurrent-option-_0028_002dc_0029"></span><h4 class="subsection">1.1.6 concurrent option (-c)</h4>
358 <span id="index-sntp_002dconcurrent"></span>
360 <p>This is the “concurrently query all ips returned for host-name” option.
361 This option takes a string argument <samp>host-name</samp>.
372 one after another, with a 2-second gap in between each query.
374 <p>The <samp>-c</samp> or <samp>--concurrent</samp> flag says that any IPs
375 returned for the DNS lookup of the supplied host-name are on
378 <span id="sntp-gap"></span><div class="header">
380 Next: <a href="#sntp-kod" accesskey="n" rel="next">sntp kod</a>, Previous: <a href="#sntp-concurrent" accesskey="p" rel="prev">sntp concurrent</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
382 <span id="gap-option-_0028_002dg_0029"></span><h4 class="subsection">1.1.7 gap option (-g)</h4>
383 <span id="index-sntp_002dgap"></span>
392 <span id="sntp-kod"></span><div class="header">
394 Next: <a href="#sntp-keyfile" accesskey="n" rel="next">sntp keyfile</a>, Previous: <a href="#sntp-gap" accesskey="p" rel="prev">sntp gap</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
396 <span id="kod-option-_0028_002dK_0029"></span><h4 class="subsection">1.1.8 kod option (-K)</h4>
397 <span id="index-sntp_002dkod"></span>
400 This option takes a file argument <samp>file-name</samp>.
405 <span id="sntp-keyfile"></span><div class="header">
407 Next: <a href="#sntp-logfile" accesskey="n" rel="next">sntp logfile</a>, Previous: <a href="#sntp-kod" accesskey="p" rel="prev">sntp kod</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
409 <span id="keyfile-option-_0028_002dk_0029"></span><h4 class="subsection">1.1.9 keyfile option (-k)</h4>
410 <span id="index-sntp_002dkeyfile"></span>
412 <p>This is the “look in this file for the key specified with <samp>-a</samp>” option.
413 This option takes a file argument <samp>file-name</samp>.
415 <code>sntp</code> will search for the key specified with <samp>-a</samp>
419 <span id="sntp-logfile"></span><div class="header">
421 Next: <a href="#sntp-steplimit" accesskey="n" rel="next">sntp steplimit</a>, Previous: <a href="#sntp-keyfile" accesskey="p" rel="prev">sntp keyfile</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
423 <span id="logfile-option-_0028_002dl_0029"></span><h4 class="subsection">1.1.10 logfile option (-l)</h4>
424 <span id="index-sntp_002dlogfile"></span>
427 This option takes a file argument <samp>file-name</samp>.
431 <span id="sntp-steplimit"></span><div class="header">
433 Next: <a href="#sntp-ntpversion" accesskey="n" rel="next">sntp ntpversion</a>, Previous: <a href="#sntp-logfile" accesskey="p" rel="prev">sntp logfile</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
435 <span id="steplimit-option-_0028_002dM_0029"></span><h4 class="subsection">1.1.11 steplimit option (-M)</h4>
436 <span id="index-sntp_002dsteplimit"></span>
446 <span id="sntp-ntpversion"></span><div class="header">
448 Next: <a href="#sntp-usereservedport" accesskey="n" rel="next">sntp usereservedport</a>, Previous: <a href="#sntp-steplimit" accesskey="p" rel="prev">sntp steplimit</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
450 <span id="ntpversion-option-_0028_002do_0029"></span><h4 class="subsection">1.1.12 ntpversion option (-o)</h4>
451 <span id="index-sntp_002dntpversion"></span>
458 <span id="sntp-usereservedport"></span><div class="header">
460 Next: <a href="#sntp-timeout" accesskey="n" rel="next">sntp timeout</a>, Previous: <a href="#sntp-ntpversion" accesskey="p" rel="prev">sntp ntpversion</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
462 <span id="usereservedport-option-_0028_002dr_0029"></span><h4 class="subsection">1.1.13 usereservedport option (-r)</h4>
463 <span id="index-sntp_002dusereservedport"></span>
469 <span id="sntp-timeout"></span><div class="header">
471 Next: <a href="#sntp-wait" accesskey="n" rel="next">sntp wait</a>, Previous: <a href="#sntp-usereservedport" accesskey="p" rel="prev">sntp usereservedport</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
473 <span id="timeout-option-_0028_002dt_0029"></span><h4 class="subsection">1.1.14 timeout option (-t)</h4>
474 <span id="index-sntp_002dtimeout"></span>
484 <span id="sntp-wait"></span><div class="header">
486 Next: <a href="#sntp-config" accesskey="n" rel="next">sntp config</a>, Previous: <a href="#sntp-timeout" accesskey="p" rel="prev">sntp timeout</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
488 <span id="wait-option"></span><h4 class="subsection">1.1.15 wait option</h4>
489 <span id="index-sntp_002dwait"></span>
495 <li> can be disabled with –no-wait.
503 <span id="sntp-config"></span><div class="header">
505 Next: <a href="#sntp-exit-status" accesskey="n" rel="next">sntp exit status</a>, Previous: <a href="#sntp-wait" accesskey="p" rel="prev">sntp wait</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
507 <span id="presetting_002fconfiguring-sntp"></span><h4 class="subsection">1.1.16 presetting/configuring sntp</h4>
549 <pre class="example"><option-name>
550 <sub-opt>...&lt;...&gt;...</sub-opt>
551 </option-name>
553 <p>yielding an <code>option-name.sub-opt</code> string value of
563 <span id="version-_0028_002d_0029"></span><h4 class="subsubheading">version (-)</h4>
583 <span id="sntp-exit-status"></span><div class="header">
585 Next: <a href="#sntp-Usage" accesskey="n" rel="next">sntp Usage</a>, Previous: <a href="#sntp-config" accesskey="p" rel="prev">sntp config</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
587 <span id="sntp-exit-status-1"></span><h4 class="subsection">1.1.17 sntp exit status</h4>
595 <dd><p>The operation failed or the command syntax was not valid.
602 it to autogen-users@lists.sourceforge.net. Thank you.
606 <span id="sntp-Usage"></span><div class="header">
608 Next: <a href="#sntp-Authors" accesskey="n" rel="next">sntp Authors</a>, Previous: <a href="#sntp-exit-status" accesskey="p" rel="prev">sntp exit status</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
610 <span id="sntp-Usage-1"></span><h4 class="subsection">1.1.18 sntp Usage</h4>
612 <span id="sntp-Authors"></span><div class="header">
614 Previous: <a href="#sntp-Usage" accesskey="p" rel="prev">sntp Usage</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
616 <span id="sntp-Authors-1"></span><h4 class="subsection">1.1.19 sntp Authors</h4>
619 <span id="Usage"></span><div class="header">
621 Previous: <a href="#sntp-Invocation" accesskey="p" rel="prev">sntp Invocation</a>, Up: <a href="#sntp-Description" accesskey="u" rel="up">sntp Description</a> </p>
623 <span id="Usage-1"></span><h3 class="section">1.2 Usage</h3>
639 <pre class="example">sntp -a ntpserver.somewhere