File: assoc-options.adoc

package info (click to toggle)
ntpsec 1.2.0%2Bdfsg1-4
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 10,044 kB
  • sloc: ansic: 60,737; python: 31,610; sh: 1,494; yacc: 1,291; makefile: 176; javascript: 138
file content (75 lines) | stat: -rw-r--r-- 3,321 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
// Association options - included twice.
//
// Note, some of these options are described with special refclock
// semantics in includes/clock-options.adoc.

+bias+::
  Add the command argument, a floating-point value in seconds, to the
  time offset (θ) computed for this server; this may be useful if
  you are a client on a network connection such as an ADSL line where
  there is a predictable asymmetry between upstream and downstream
  flight times.  One way you might see this is if you use a fixed set
  of others and one has a stable offset that is an outlier from the
  others; in that case, you might want to use +bias+ to compensate out
  the offset.

+burst+::
  When the server is reachable, send a burst of eight packets instead of
  the usual one. The packet spacing is normally 2 s; however, the
  spacing between the first and second packets can be changed with the
  calldelay command to allow additional time for a modem or ISDN call to
  complete; this is designed to improve timekeeping quality with the
  +server+ command.

+iburst+::
  When the server is unreachable, send a burst of six packets instead
  of the usual one. The packet spacing is normally 2 s; however, the
  spacing between the first and second packets can be changed with the
  calldelay command to allow additional time for a modem or ISDN call to
  complete; this is designed to speed the initial synchronization
  acquisition with the +server+ command, and when
  {ntpdman} is started with the +-q+ option.

+key+ _key_::
  All packets sent to and received from the server or peer are to
  include authentication fields encrypted using the specified _key_
  identifier with values from 1 to 65535, inclusive. The default is to
  include no encryption field.

+minpoll+ _minpoll_::
+maxpoll+ _maxpoll_::
  These options specify the minimum and maximum poll intervals for NTP
  messages, as a power of 2 in seconds. The maximum poll interval
  defaults to 10 (1,024 s), but can be increased by the _maxpoll_ option
  to an upper limit of 17 (36.4 h). The minimum poll interval defaults
  to 6 (64 s), but can be decreased by the _minpoll_ option to a lower
  limit of 0 (1 s).

+mode+ 'option'::
  Pass the +option+ to a reference clock driver. This option is valid
  only with refclock addresses.

+noselect+::
  Marks the server as unused, except for display purposes. The server is
  discarded by the selection algorithm.

+prefer+::
  Marks the server as preferred. All other things being equal, this host
  will be chosen for synchronization among a set of correctly operating
  hosts. See the "Mitigation Rules and the prefer Keyword" page
  for further information.

+true+::
  Mark the association to assume truechimer status; that is, always
  survive the selection and clustering algorithms. This option can be
  used with any association but is most useful for reference clocks
  with large jitter on the serial port and precision pulse-per-second
  (PPS) signals. Caution: this option defeats the algorithms designed to
  cast out falsetickers and can allow these sources to set the system
  clock. This option is valid only with the +server+ command.

+version+ _version_::
  Specifies the version number to be used for outgoing NTP packets.
  Versions 1-4 are the choices, with version 4 the default.

// end