Annotation of embedaddon/ntp/sntp/sntp-opts.texi, revision 1.1.1.1
1.1 misho 1: @node sntp Invocation
2: @section Invoking sntp
3: @pindex sntp
4: @cindex standard Simple Network Time Protocol program
5: @ignore
6: #
7: # EDIT THIS FILE WITH CAUTION (sntp-opts.texi)
8: #
9: # It has been AutoGen-ed December 24, 2011 at 06:34:00 PM by AutoGen 5.12
10: # From the definitions sntp-opts.def
11: # and the template file aginfo.tpl
12: @end ignore
13:
14: @code{sntp}
15: can be used as a SNTP client to query a NTP or SNTP server and either display
16: the time or set the local system's time (given suitable privilege). It can be
17: run as an interactive command or in a
18: @code{cron}
19: job.
20:
21: NTP (the Network Time Protocol) and SNTP (the Simple Network Time Protocol)
22: are defined and described by RFC 5905.
23:
24: @indent
25: The default is to write the estimated correct local date and time (i.e. not
26: UTC) to the standard output in a format like
27: @example
28: 1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
29: @end example
30: where the
31: @example
32: +4.567 +/- 0.089 secs
33: @end example
34: indicates the local clock is 4.567 seconds behind the correct time
35: (so 4.567 seconds must be added to the local clock to get it to be correct),
36: and the (local) time of
37: @code{1996-10-15 20:17:25.123}
38: can be converted to UTC time by adding 8 hours and 0 minutes, and
39: is believed to be correct to within
40: @code{+/- 0.089}
41: seconds.
42:
43: This section was generated by @strong{AutoGen},
44: the aginfo template and the option descriptions for the @command{sntp} program. It documents the @command{sntp} usage text and option meanings.
45:
46: This software is released under a specialized copyright license.
47:
48: @menu
49: * sntp usage:: sntp usage help (-?)
50: * sntp adjtime:: adjtime option (-j)
51: * sntp authentication:: authentication option (-a)
52: * sntp broadcast:: broadcast option (-b)
53: * sntp ipv4:: ipv4 option (-4)
54: * sntp ipv6:: ipv6 option (-6)
55: * sntp keyfile:: keyfile option (-k)
56: * sntp kod:: kod option (-K)
57: * sntp logfile:: logfile option (-l)
58: * sntp normalverbose:: normalverbose option (-d)
59: * sntp settod:: settod option (-s)
60: * sntp syslog:: syslog option (-p)
61: * sntp timeout:: timeout option (-t)
62: @end menu
63:
64: @node sntp usage
65: @subsection sntp usage help (-?)
66: @cindex sntp usage
67:
68: This is the automatically generated usage text for sntp:
69:
70: @exampleindent 0
71: @example
72: sntp - standard Simple Network Time Protocol program - Ver. 4.2.6p5
73: USAGE: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
74: [ hostname-or-IP ...]
75: Flg Arg Option-Name Description
76: -4 no ipv4 Force IPv4 DNS name resolution
77: - prohibits these options:
78: ipv6
79: -6 no ipv6 Force IPv6 DNS name resolution
80: - prohibits these options:
81: ipv4
82: -d no normalverbose Normal verbose
83: -K Str kod KoD history filename
84: -p no syslog Logging with syslog
85: - prohibits these options:
86: logfile
87: -l Str logfile Log to specified logfile
88: - prohibits these options:
89: syslog
90: -s no settod Set (step) the time with settimeofday()
91: - prohibits these options:
92: adjtime
93: -j no adjtime Set (slew) the time with adjtime()
94: - prohibits these options:
95: settod
96: -b Str broadcast Use broadcasts to the address specified for synchronisation
97: -t Num timeout Specify the number of seconds to wait for broadcasts
98: -a Num authentication Enable authentication with the key auth-keynumber
99: -k Str keyfile Specify a keyfile. SNTP will look in this file for the key specified with -a
100: opt version Output version information and exit
101: -? no help Display extended usage information and exit
102: -! no more-help Extended usage information passed thru pager
103: -> opt save-opts Save the option state to a config file
104: -< Str load-opts Load options from a config file
105: - disabled as --no-load-opts
106: - may appear multiple times
107:
108: Options are specified by doubled hyphens and their name or by a single
109: hyphen and the flag character.
110:
111:
112:
113: The following option preset mechanisms are supported:
114: - reading file $HOME/.ntprc
115: - reading file ./.ntprc
116: - examining environment variables named SNTP_*
117:
118: sntp implements the Simple Network Time Protocol, and is used to query an
119: NTP or SNTP server and either display the time or set the local system's
120: time (given suitable privilege).
121:
122: It can be run interactively from the command line or as a cron job.
123:
124: NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and RFC
125: 1305.
126:
127: please send bug reports to: http://bugs.ntp.org, bugs@@ntp.org
128: @end example
129: @exampleindent 4
130:
131: @node sntp adjtime
132: @subsection adjtime option (-j)
133: @cindex sntp-adjtime
134:
135: This is the ``set (slew) the time with adjtime()'' option.
136:
137: This option has some usage constraints. It:
138: @itemize @bullet
139: @item
140: must not appear in combination with any of the following options:
141: settod.
142: @end itemize
143:
144:
145:
146: @node sntp authentication
147: @subsection authentication option (-a)
148: @cindex sntp-authentication
149:
150: This is the ``enable authentication with the key auth-keynumber'' option.
151: This option enables authentication using the key specified in this option's argument.
152: The argument of this option is the keyid, a number specified in the keyfile as this
153: key's identifier. See the keyfile option (-k) for more details.
154:
155: @node sntp broadcast
156: @subsection broadcast option (-b)
157: @cindex sntp-broadcast
158:
159: This is the ``use broadcasts to the address specified for synchronisation'' option.
160: If specified SNTP will listen to the specified broadcast address
161: for NTP broadcasts. The default maximum wait time,
162: 68 seconds, can be modified with -t.
163:
164: @node sntp ipv4
165: @subsection ipv4 option (-4)
166: @cindex sntp-ipv4
167:
168: This is the ``force ipv4 dns name resolution'' option.
169:
170: This option has some usage constraints. It:
171: @itemize @bullet
172: @item
173: must not appear in combination with any of the following options:
174: ipv6.
175: @end itemize
176:
177: Force DNS resolution of the following host names on the command line
178: to the IPv4 namespace.
179:
180: @node sntp ipv6
181: @subsection ipv6 option (-6)
182: @cindex sntp-ipv6
183:
184: This is the ``force ipv6 dns name resolution'' option.
185:
186: This option has some usage constraints. It:
187: @itemize @bullet
188: @item
189: must not appear in combination with any of the following options:
190: ipv4.
191: @end itemize
192:
193: Force DNS resolution of the following host names on the command line
194: to the IPv6 namespace.
195:
196: @node sntp keyfile
197: @subsection keyfile option (-k)
198: @cindex sntp-keyfile
199:
200: This is the ``specify a keyfile. sntp will look in this file for the key specified with -a'' option.
201: This option specifies the keyfile. SNTP will search for the key specified with -a keyno in this
202: file. Key files follow the following format:
203:
204: keyid keytype key
205:
206: Where keyid is a number identifying this key
207: keytype is one of the follow:
208: S Key in 64 Bit hexadecimal number as specified in in the DES specification.
209: N Key in 64 Bit hexadecimal number as specified in the NTP standard.
210: A Key in a 1-to-8 character ASCII string.
211: M Key in a 1-to-8 character ASCII string using the MD5 authentication scheme.
212:
213: For more information see ntp.keys(5).
214:
215: @node sntp kod
216: @subsection kod option (-K)
217: @cindex sntp-kod
218:
219: This is the ``kod history filename'' option.
220: Specifies the filename to be used to persist the history of KoD
221: responses received from servers. The default is
222: /var/db/ntp-kod.
223:
224: @node sntp logfile
225: @subsection logfile option (-l)
226: @cindex sntp-logfile
227:
228: This is the ``log to specified logfile'' option.
229:
230: This option has some usage constraints. It:
231: @itemize @bullet
232: @item
233: must not appear in combination with any of the following options:
234: syslog.
235: @end itemize
236:
237: This option causes the client to write log messages to the specified
238: logfile.
239:
240: @node sntp normalverbose
241: @subsection normalverbose option (-d)
242: @cindex sntp-normalverbose
243:
244: This is the ``normal verbose'' option.
245: Diagnostic messages for non-fatal errors and a limited amount of
246: tracing should be written to standard error. Fatal ones always
247: produce a diagnostic. This option should be set when there is a
248: suspected problem with the server, network or the source.
249:
250: @node sntp settod
251: @subsection settod option (-s)
252: @cindex sntp-settod
253:
254: This is the ``set (step) the time with settimeofday()'' option.
255:
256: This option has some usage constraints. It:
257: @itemize @bullet
258: @item
259: must not appear in combination with any of the following options:
260: adjtime.
261: @end itemize
262:
263:
264:
265: @node sntp syslog
266: @subsection syslog option (-p)
267: @cindex sntp-syslog
268:
269: This is the ``logging with syslog'' option.
270:
271: This option has some usage constraints. It:
272: @itemize @bullet
273: @item
274: must not appear in combination with any of the following options:
275: logfile.
276: @end itemize
277:
278: When this option is set all logging will be done using syslog.
279:
280: @node sntp timeout
281: @subsection timeout option (-t)
282: @cindex sntp-timeout
283:
284: This is the ``specify the number of seconds to wait for broadcasts'' option.
285: When waiting for a broadcast packet SNTP will wait the number
286: of seconds specified before giving up. Default 68 seconds.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>