"Fossies" - the Fresh Open Source Software Archive

Member "ntp-4.2.8p15/ntpdc/ntpdc.1ntpdcmdoc" (23 Jun 2020, 24624 Bytes) of package /linux/misc/ntp-4.2.8p15.tar.gz:

As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "ntpdc.1ntpdcmdoc": 4.2.8p14_vs_4.2.8p15.

    1 .Dd June 23 2020
    2 .Dt NTPDC 1ntpdcmdoc User Commands
    3 .Os
    4 .\"  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.mdoc)
    5 .\"
    6 .\"  It has been AutoGen-ed  June 23, 2020 at 02:20:44 AM by AutoGen 5.18.5
    7 .\"  From the definitions    ntpdc-opts.def
    8 .\"  and the template file   agmdoc-cmd.tpl
    9 .Sh NAME
   10 .Nm ntpdc
   11 .Nd vendor-specific NTPD control program
   12 .Sh SYNOPSIS
   13 .Nm
   14 .\" Mixture of short (flag) options and long options
   15 .Op Fl flags
   16 .Op Fl flag Op Ar value
   17 .Op Fl \-option\-name Ns Oo Oo Ns "=| " Oc Ns Ar value Oc
   18 [ host ...]
   19 .Pp
   21 .Nm
   22 is deprecated.
   23 Please use
   24 .Xr ntpq 1ntpqmdoc instead \- it can do everything
   25 .Nm
   26 used to do, and it does so using a much more sane interface.
   27 .Pp
   28 .Nm
   29 is a utility program used to query
   30 .Xr ntpd 1ntpdmdoc
   31 about its
   32 current state and to request changes in that state.
   33 It uses NTP mode 7 control message formats described in the source code.
   34 The program may
   35 be run either in interactive mode or controlled using command line
   36 arguments.
   37 Extensive state and statistics information is available
   38 through the
   39 .Nm
   40 interface.
   41 In addition, nearly all the
   42 configuration options which can be specified at startup using
   43 ntpd's configuration file may also be specified at run time using
   44 .Nm .
   45 .Sh "OPTIONS"
   46 .Bl -tag
   47 .It  Fl 4 , Fl \-ipv4 
   48 Force IPv4 DNS name resolution.
   49 This option must not appear in combination with any of the following options:
   50 ipv6.
   51 .sp
   52 Force DNS resolution of following host names on the command line
   53 to the IPv4 namespace.
   54 .It  Fl 6 , Fl \-ipv6 
   55 Force IPv6 DNS name resolution.
   56 This option must not appear in combination with any of the following options:
   57 ipv4.
   58 .sp
   59 Force DNS resolution of following host names on the command line
   60 to the IPv6 namespace.
   61 .It  Fl c Ar cmd , Fl \-command Ns = Ns Ar cmd 
   62 run a command and exit.
   63 This option may appear an unlimited number of times.
   64 .sp
   65 The following argument is interpreted as an interactive format command
   66 and is added to the list of commands to be executed on the specified
   67 host(s).
   68 .It  Fl d , Fl \-debug\-level 
   69 Increase debug verbosity level.
   70 This option may appear an unlimited number of times.
   71 .sp
   72 .It  Fl D Ar number , Fl \-set\-debug\-level Ns = Ns Ar number 
   73 Set the debug verbosity level.
   74 This option may appear an unlimited number of times.
   75 This option takes an integer number as its argument.
   76 .sp
   77 .It  Fl i , Fl \-interactive 
   78 Force ntpq to operate in interactive mode.
   79 This option must not appear in combination with any of the following options:
   80 command, listpeers, peers, showpeers.
   81 .sp
   82 Force ntpq to operate in interactive mode.  Prompts will be written
   83 to the standard output and commands read from the standard input.
   84 .It  Fl l , Fl \-listpeers 
   85 Print a list of the peers.
   86 This option must not appear in combination with any of the following options:
   87 command.
   88 .sp
   89 Print a list of the peers known to the server as well as a summary of
   90 their state. This is equivalent to the 'listpeers' interactive command.
   91 .It  Fl n , Fl \-numeric 
   92 numeric host addresses.
   93 .sp
   94 Output all host addresses in dotted\-quad numeric format rather than
   95 converting to the canonical host names. 
   96 .It  Fl p , Fl \-peers 
   97 Print a list of the peers.
   98 This option must not appear in combination with any of the following options:
   99 command.
  100 .sp
  101 Print a list of the peers known to the server as well as a summary
  102 of their state. This is equivalent to the 'peers' interactive command.
  103 .It  Fl s , Fl \-showpeers 
  104 Show a list of the peers.
  105 This option must not appear in combination with any of the following options:
  106 command.
  107 .sp
  108 Print a list of the peers known to the server as well as a summary
  109 of their state. This is equivalent to the 'dmpeers' interactive command.
  110 .It Fl \&? , Fl \-help
  111 Display usage information and exit.
  112 .It Fl \&! , Fl \-more\-help
  113 Pass the extended usage information through a pager.
  114 .It Fl > Oo Ar cfgfile Oc , Fl \-save\-opts Oo Ns = Ns Ar cfgfile Oc
  115 Save the option state to \fIcfgfile\fP.  The default is the \fIlast\fP
  116 configuration file listed in the \fBOPTION PRESETS\fP section, below.
  117 The command will exit after updating the config file.
  118 .It Fl < Ar cfgfile , Fl \-load\-opts Ns = Ns Ar cfgfile , Fl \-no\-load\-opts
  119 Load options from \fIcfgfile\fP.
  120 The \fIno\-load\-opts\fP form will disable the loading
  121 of earlier config/rc/ini files.  \fI\-\-no\-load\-opts\fP is handled early,
  122 out of order.
  123 .It Fl \-version Op Brq Ar v|c|n
  124 Output version of program and exit.  The default mode is `v', a simple
  125 version.  The `c' mode will print copyright information and `n' will
  126 print the full copyright notice.
  127 .El
  129 Any option that is not marked as \fInot presettable\fP may be preset
  130 by loading values from configuration ("RC" or ".INI") file(s) and values from
  131 environment variables named:
  132 .nf
  133   \fBNTPDC_<option\-name>\fP or \fBNTPDC\fP
  134 .fi
  135 .ad
  136 The environmental presets take precedence (are processed later than)
  137 the configuration files.
  138 The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP".
  139 If any of these are directories, then the file \fI.ntprc\fP
  140 is searched for within those directories.
  141 .Sh USAGE
  142 If one or more request options are included on the command line
  143 when
  144 .Nm
  145 is executed, each of the requests will be sent
  146 to the NTP servers running on each of the hosts given as command
  147 line arguments, or on localhost by default.
  148 If no request options
  149 are given,
  150 .Nm
  151 will attempt to read commands from the
  152 standard input and execute these on the NTP server running on the
  153 first host given on the command line, again defaulting to localhost
  154 when no other host is specified.
  155 The
  156 .Nm
  157 utility will prompt for
  158 commands if the standard input is a terminal device.
  159 .Pp
  160 The
  161 .Nm
  162 utility uses NTP mode 7 packets to communicate with the
  163 NTP server, and hence can be used to query any compatible server on
  164 the network which permits it.
  165 Note that since NTP is a UDP protocol
  166 this communication will be somewhat unreliable, especially over
  167 large distances in terms of network topology.
  168 The
  169 .Nm
  170 utility makes
  171 no attempt to retransmit requests, and will time requests out if
  172 the remote host is not heard from within a suitable timeout
  173 time.
  174 .Pp
  175 The operation of
  176 .Nm
  177 are specific to the particular
  178 implementation of the
  179 .Xr ntpd 1ntpdmdoc
  180 daemon and can be expected to
  181 work only with this and maybe some previous versions of the daemon.
  182 Requests from a remote
  183 .Nm
  184 utility which affect the
  185 state of the local server must be authenticated, which requires
  186 both the remote program and local server share a common key and key
  187 identifier.
  188 .Pp
  189 Note that in contexts where a host name is expected, a
  190 .Fl 4
  191 qualifier preceding the host name forces DNS resolution to the IPv4 namespace,
  192 while a
  193 .Fl 6
  194 qualifier forces DNS resolution to the IPv6 namespace.
  195 Specifying a command line option other than
  196 .Fl i
  197 or
  198 .Fl n
  199 will cause the specified query (queries) to be sent to
  200 the indicated host(s) immediately.
  201 Otherwise,
  202 .Nm
  203 will
  204 attempt to read interactive format commands from the standard
  205 input.
  206 .Ss "Interactive Commands"
  207 Interactive format commands consist of a keyword followed by zero
  208 to four arguments.
  209 Only enough characters of the full keyword to
  210 uniquely identify the command need be typed.
  211 The output of a
  212 command is normally sent to the standard output, but optionally the
  213 output of individual commands may be sent to a file by appending a
  214 .Ql \&> ,
  215 followed by a file name, to the command line.
  216 .Pp
  217 A number of interactive format commands are executed entirely
  218 within the
  219 .Nm
  220 utility itself and do not result in NTP
  221 mode 7 requests being sent to a server.
  222 These are described
  223 following.
  224 .Bl -tag -width indent
  225 .It Ic \&? Ar command_keyword
  226 .It Ic help Ar command_keyword
  227 A
  228 .Sq Ic \&?
  229 will print a list of all the command
  230 keywords known to this incarnation of
  231 .Nm .
  232 A
  233 .Sq Ic \&?
  234 followed by a command keyword will print function and usage
  235 information about the command.
  236 This command is probably a better
  237 source of information about
  238 .Xr ntpq 1ntpqmdoc
  239 than this manual
  240 page.
  241 .It Ic delay Ar milliseconds
  242 Specify a time interval to be added to timestamps included in
  243 requests which require authentication.
  244 This is used to enable
  245 (unreliable) server reconfiguration over long delay network paths
  246 or between machines whose clocks are unsynchronized.
  247 Actually the
  248 server does not now require timestamps in authenticated requests,
  249 so this command may be obsolete.
  250 .It Ic host Ar hostname
  251 Set the host to which future queries will be sent.
  252 Hostname may
  253 be either a host name or a numeric address.
  254 .It Ic hostnames Op Cm yes | Cm no
  255 If
  256 .Cm yes
  257 is specified, host names are printed in
  258 information displays.
  259 If
  260 .Cm no
  261 is specified, numeric
  262 addresses are printed instead.
  263 The default is
  264 .Cm yes ,
  265 unless
  266 modified using the command line
  267 .Fl n
  268 switch.
  269 .It Ic keyid Ar keyid
  270 This command allows the specification of a key number to be
  271 used to authenticate configuration requests.
  272 This must correspond
  273 to a key number the server has been configured to use for this
  274 purpose.
  275 .It Ic quit
  276 Exit
  277 .Nm .
  278 .It Ic passwd
  279 This command prompts you to type in a password (which will not
  280 be echoed) which will be used to authenticate configuration
  281 requests.
  282 The password must correspond to the key configured for
  283 use by the NTP server for this purpose if such requests are to be
  284 successful.
  285 .It Ic timeout Ar milliseconds
  286 Specify a timeout period for responses to server queries.
  287 The
  288 default is about 8000 milliseconds.
  289 Note that since
  290 .Nm
  291 retries each query once after a timeout, the total waiting time for
  292 a timeout will be twice the timeout value set.
  293 .El
  294 .Ss "Control Message Commands"
  295 Query commands result in NTP mode 7 packets containing requests for
  296 information being sent to the server.
  297 These are read\-only commands
  298 in that they make no modification of the server configuration
  299 state.
  300 .Bl -tag -width indent
  301 .It Ic listpeers
  302 Obtains and prints a brief list of the peers for which the
  303 server is maintaining state.
  304 These should include all configured
  305 peer associations as well as those peers whose stratum is such that
  306 they are considered by the server to be possible future
  307 synchronization candidates.
  308 .It Ic peers
  309 Obtains a list of peers for which the server is maintaining
  310 state, along with a summary of that state.
  311 Summary information
  312 includes the address of the remote peer, the local interface
  313 address ( if a local address has yet to be determined), the
  314 stratum of the remote peer (a stratum of 16 indicates the remote
  315 peer is unsynchronized), the polling interval, in seconds, the
  316 reachability register, in octal, and the current estimated delay,
  317 offset and dispersion of the peer, all in seconds.
  318 .Pp
  319 The character in the left margin indicates the mode this peer
  320 entry is operating in.
  321 A
  322 .Ql \&+
  323 denotes symmetric active, a
  324 .Ql \&\-
  325 indicates symmetric passive, a
  326 .Ql \&=
  327 means the
  328 remote server is being polled in client mode, a
  329 .Ql \&^
  330 indicates that the server is broadcasting to this address, a
  331 .Ql \&~
  332 denotes that the remote peer is sending broadcasts and a
  333 .Ql \&~
  334 denotes that the remote peer is sending broadcasts and a
  335 .Ql \&*
  336 marks the peer the server is currently synchronizing
  337 to.
  338 .Pp
  339 The contents of the host field may be one of four forms.
  340 It may
  341 be a host name, an IP address, a reference clock implementation
  342 name with its parameter or
  343 .Fn REFCLK "implementation_number" "parameter" .
  344 On
  345 .Ic hostnames
  346 .Cm no
  347 only IP\-addresses
  348 will be displayed.
  349 .It Ic dmpeers
  350 A slightly different peer summary list.
  351 Identical to the output
  352 of the
  353 .Ic peers
  354 command, except for the character in the
  355 leftmost column.
  356 Characters only appear beside peers which were
  357 included in the final stage of the clock selection algorithm.
  358 A
  359 .Ql \&.
  360 indicates that this peer was cast off in the falseticker
  361 detection, while a
  362 .Ql \&+
  363 indicates that the peer made it
  364 through.
  365 A
  366 .Ql \&*
  367 denotes the peer the server is currently
  368 synchronizing with.
  369 .It Ic showpeer Ar peer_address Oo Ar ... Oc
  370 Shows a detailed display of the current peer variables for one
  371 or more peers.
  372 Most of these values are described in the NTP
  373 Version 2 specification.
  374 .It Ic pstats Ar peer_address Oo Ar ... Oc
  375 Show per\-peer statistic counters associated with the specified
  376 peer(s).
  377 .It Ic clockstat Ar clock_peer_address Oo Ar ... Oc
  378 Obtain and print information concerning a peer clock.
  379 The
  380 values obtained provide information on the setting of fudge factors
  381 and other clock performance information.
  382 .It Ic kerninfo
  383 Obtain and print kernel phase\-lock loop operating parameters.
  384 This information is available only if the kernel has been specially
  385 modified for a precision timekeeping function.
  386 .It Ic loopinfo Op Cm oneline | Cm multiline
  387 Print the values of selected loop filter variables.
  388 The loop
  389 filter is the part of NTP which deals with adjusting the local
  390 system clock.
  391 The
  392 .Sq offset
  393 is the last offset given to the
  394 loop filter by the packet processing code.
  395 The
  396 .Sq frequency
  397 is the frequency error of the local clock in parts\-per\-million
  398 (ppm).
  399 The
  400 .Sq time_const
  401 controls the stiffness of the
  402 phase\-lock loop and thus the speed at which it can adapt to
  403 oscillator drift.
  404 The
  405 .Sq watchdog timer
  406 value is the number
  407 of seconds which have elapsed since the last sample offset was
  408 given to the loop filter.
  409 The
  410 .Cm oneline
  411 and
  412 .Cm multiline
  413 options specify the format in which this
  414 information is to be printed, with
  415 .Cm multiline
  416 as the
  417 default.
  418 .It Ic sysinfo
  419 Print a variety of system state variables, i.e., state related
  420 to the local server.
  421 All except the last four lines are described
  422 in the NTP Version 3 specification, RFC\-1305.
  423 .Pp
  424 The
  425 .Sq system flags
  426 show various system flags, some of
  427 which can be set and cleared by the
  428 .Ic enable
  429 and
  430 .Ic disable
  431 configuration commands, respectively.
  432 These are
  433 the
  434 .Cm auth ,
  435 .Cm bclient ,
  436 .Cm monitor ,
  437 .Cm pll ,
  438 .Cm pps
  439 and
  440 .Cm stats
  441 flags.
  442 See the
  443 .Xr ntpd 1ntpdmdoc
  444 documentation for the meaning of these flags.
  445 There
  446 are two additional flags which are read only, the
  447 .Cm kernel_pll
  448 and
  449 .Cm kernel_pps .
  450 These flags indicate
  451 the synchronization status when the precision time kernel
  452 modifications are in use.
  453 The
  454 .Sq kernel_pll
  455 indicates that
  456 the local clock is being disciplined by the kernel, while the
  457 .Sq kernel_pps
  458 indicates the kernel discipline is provided by the PPS
  459 signal.
  460 .Pp
  461 The
  462 .Sq stability
  463 is the residual frequency error remaining
  464 after the system frequency correction is applied and is intended for
  465 maintenance and debugging.
  466 In most architectures, this value will
  467 initially decrease from as high as 500 ppm to a nominal value in
  468 the range .01 to 0.1 ppm.
  469 If it remains high for some time after
  470 starting the daemon, something may be wrong with the local clock,
  471 or the value of the kernel variable
  472 .Va kern.clockrate.tick
  473 may be
  474 incorrect.
  475 .Pp
  476 The
  477 .Sq broadcastdelay
  478 shows the default broadcast delay,
  479 as set by the
  480 .Ic broadcastdelay
  481 configuration command.
  482 .Pp
  483 The
  484 .Sq authdelay
  485 shows the default authentication delay,
  486 as set by the
  487 .Ic authdelay
  488 configuration command.
  489 .It Ic sysstats
  490 Print statistics counters maintained in the protocol
  491 module.
  492 .It Ic memstats
  493 Print statistics counters related to memory allocation
  494 code.
  495 .It Ic iostats
  496 Print statistics counters maintained in the input\-output
  497 module.
  498 .It Ic timerstats
  499 Print statistics counters maintained in the timer/event queue
  500 support code.
  501 .It Ic reslist
  502 Obtain and print the server's restriction list.
  503 This list is
  504 (usually) printed in sorted order and may help to understand how
  505 the restrictions are applied.
  506 .It Ic monlist Op Ar version
  507 Obtain and print traffic counts collected and maintained by the
  508 monitor facility.
  509 The version number should not normally need to be
  510 specified.
  511 .It Ic clkbug Ar clock_peer_address Oo Ar ... Oc
  512 Obtain debugging information for a reference clock driver.
  513 This
  514 information is provided only by some clock drivers and is mostly
  515 undecodable without a copy of the driver source in hand.
  516 .El
  517 .Ss "Runtime Configuration Requests"
  518 All requests which cause state changes in the server are
  519 authenticated by the server using a configured NTP key (the
  520 facility can also be disabled by the server by not configuring a
  521 key).
  522 The key number and the corresponding key must also be made
  523 known to
  524 .Nm .
  525 This can be done using the
  526 .Ic keyid
  527 and
  528 .Ic passwd
  529 commands, the latter of which will prompt at the terminal for a
  530 password to use as the encryption key.
  531 You will also be prompted
  532 automatically for both the key number and password the first time a
  533 command which would result in an authenticated request to the
  534 server is given.
  535 Authentication not only provides verification that
  536 the requester has permission to make such changes, but also gives
  537 an extra degree of protection again transmission errors.
  538 .Pp
  539 Authenticated requests always include a timestamp in the packet
  540 data, which is included in the computation of the authentication
  541 code.
  542 This timestamp is compared by the server to its receive time
  543 stamp.
  544 If they differ by more than a small amount the request is
  545 rejected.
  546 This is done for two reasons.
  547 First, it makes simple
  548 replay attacks on the server, by someone who might be able to
  549 overhear traffic on your LAN, much more difficult.
  550 Second, it makes
  551 it more difficult to request configuration changes to your server
  552 from topologically remote hosts.
  553 While the reconfiguration facility
  554 will work well with a server on the local host, and may work
  555 adequately between time\-synchronized hosts on the same LAN, it will
  556 work very poorly for more distant hosts.
  557 As such, if reasonable
  558 passwords are chosen, care is taken in the distribution and
  559 protection of keys and appropriate source address restrictions are
  560 applied, the run time reconfiguration facility should provide an
  561 adequate level of security.
  562 .Pp
  563 The following commands all make authenticated requests.
  564 .Bl -tag -width indent
  565 .It Xo Ic addpeer Ar peer_address
  566 .Op Ar keyid
  567 .Op Ar version
  568 .Op Cm prefer
  569 .Xc
  570 Add a configured peer association at the given address and
  571 operating in symmetric active mode.
  572 Note that an existing
  573 association with the same peer may be deleted when this command is
  574 executed, or may simply be converted to conform to the new
  575 configuration, as appropriate.
  576 If the optional
  577 .Ar keyid
  578 is a
  579 nonzero integer, all outgoing packets to the remote server will
  580 have an authentication field attached encrypted with this key.
  581 If
  582 the value is 0 (or not given) no authentication will be done.
  583 The
  584 .Ar version
  585 can be 1, 2 or 3 and defaults to 3.
  586 The
  587 .Cm prefer
  588 keyword indicates a preferred peer (and thus will
  589 be used primarily for clock synchronisation if possible).
  590 The
  591 preferred peer also determines the validity of the PPS signal \- if
  592 the preferred peer is suitable for synchronisation so is the PPS
  593 signal.
  594 .It Xo Ic addserver Ar peer_address
  595 .Op Ar keyid
  596 .Op Ar version
  597 .Op Cm prefer
  598 .Xc
  599 Identical to the addpeer command, except that the operating
  600 mode is client.
  601 .It Xo Ic broadcast Ar peer_address
  602 .Op Ar keyid
  603 .Op Ar version
  604 .Op Cm prefer
  605 .Xc
  606 Identical to the addpeer command, except that the operating
  607 mode is broadcast.
  608 In this case a valid key identifier and key are
  609 required.
  610 The
  611 .Ar peer_address
  612 parameter can be the broadcast
  613 address of the local network or a multicast group address assigned
  614 to NTP.
  615 If a multicast address, a multicast\-capable kernel is
  616 required.
  617 .It Ic unconfig Ar peer_address Oo Ar ... Oc
  618 This command causes the configured bit to be removed from the
  619 specified peer(s).
  620 In many cases this will cause the peer
  621 association to be deleted.
  622 When appropriate, however, the
  623 association may persist in an unconfigured mode if the remote peer
  624 is willing to continue on in this fashion.
  625 .It Xo Ic fudge Ar peer_address
  626 .Op Cm time1
  627 .Op Cm time2
  628 .Op Ar stratum
  629 .Op Ar refid
  630 .Xc
  631 This command provides a way to set certain data for a reference
  632 clock.
  633 See the source listing for further information.
  634 .It Xo Ic enable
  635 .Oo
  636 .Cm auth | Cm bclient |
  637 .Cm calibrate | Cm kernel |
  638 .Cm monitor | Cm ntp |
  639 .Cm pps | Cm stats
  640 .Oc
  641 .Xc
  642 .It Xo Ic disable
  643 .Oo
  644 .Cm auth | Cm bclient |
  645 .Cm calibrate | Cm kernel |
  646 .Cm monitor | Cm ntp |
  647 .Cm pps | Cm stats
  648 .Oc
  649 .Xc
  650 These commands operate in the same way as the
  651 .Ic enable
  652 and
  653 .Ic disable
  654 configuration file commands of
  655 .Xr ntpd 1ntpdmdoc .
  656 .Bl -tag -width indent
  657 .It Cm auth
  658 Enables the server to synchronize with unconfigured peers only
  659 if the peer has been correctly authenticated using either public key
  660 or private key cryptography.
  661 The default for this flag is enable.
  662 .It Cm bclient
  663 Enables the server to listen for a message from a broadcast or
  664 multicast server, as in the multicastclient command with
  665 default address.
  666 The default for this flag is disable.
  667 .It Cm calibrate
  668 Enables the calibrate feature for reference clocks.
  669 The default for this flag is disable.
  670 .It Cm kernel
  671 Enables the kernel time discipline, if available.
  672 The default for this flag is enable if support is available, otherwise disable.
  673 .It Cm monitor
  674 Enables the monitoring facility.
  675 See the documentation here about the
  676 .Cm monlist
  677 command or further information.
  678 The default for this flag is enable.
  679 .It Cm ntp
  680 Enables time and frequency discipline.
  681 In effect, this switch opens and closes the feedback loop,
  682 which is useful for testing.
  683 The default for this flag is enable.
  684 .It Cm pps
  685 Enables the pulse\-per\-second (PPS) signal when frequency
  686 and time is disciplined by the precision time kernel modifications.
  687 See the
  688 .Qq A Kernel Model for Precision Timekeeping
  689 (available as part of the HTML documentation
  690 provided in
  691 .Pa /usr/share/doc/ntp )
  692 page for further information.
  693 The default for this flag is disable.
  694 .It Cm stats
  695 Enables the statistics facility.
  696 See the
  697 .Sx Monitoring Options
  698 section of
  699 .Xr ntp.conf 5
  700 for further information.
  701 The default for this flag is disable.
  702 .El
  703 .It Xo Ic restrict Ar address Ar mask
  704 .Ar flag Oo Ar ... Oc
  705 .Xc
  706 This command operates in the same way as the
  707 .Ic restrict
  708 configuration file commands of
  709 .Xr ntpd 1ntpdmdoc .
  710 .It Xo Ic unrestrict Ar address Ar mask
  711 .Ar flag Oo Ar ... Oc
  712 .Xc
  713 Unrestrict the matching entry from the restrict list.
  714 .It Xo Ic delrestrict Ar address Ar mask
  715 .Op Cm ntpport
  716 .Xc
  717 Delete the matching entry from the restrict list.
  718 .It Ic readkeys
  719 Causes the current set of authentication keys to be purged and
  720 a new set to be obtained by rereading the keys file (which must
  721 have been specified in the
  722 .Xr ntpd 1ntpdmdoc
  723 configuration file).
  724 This
  725 allows encryption keys to be changed without restarting the
  726 server.
  727 .It Ic trustedkey Ar keyid Oo Ar ... Oc
  728 .It Ic untrustedkey Ar keyid Oo Ar ... Oc
  729 These commands operate in the same way as the
  730 .Ic trustedkey
  731 and
  732 .Ic untrustedkey
  733 configuration file
  734 commands of
  735 .Xr ntpd 1ntpdmdoc .
  736 .It Ic authinfo
  737 Returns information concerning the authentication module,
  738 including known keys and counts of encryptions and decryptions
  739 which have been done.
  740 .It Ic traps
  741 Display the traps set in the server.
  742 See the source listing for
  743 further information.
  744 .It Xo Ic addtrap Ar address
  745 .Op Ar port
  746 .Op Ar interface
  747 .Xc
  748 Set a trap for asynchronous messages.
  749 See the source listing
  750 for further information.
  751 .It Xo Ic clrtrap Ar address
  752 .Op Ar port
  753 .Op Ar interface
  754 .Xc
  755 Clear a trap for asynchronous messages.
  756 See the source listing
  757 for further information.
  758 .It Ic reset
  759 Clear the statistics counters in various modules of the server.
  760 See the source listing for further information.
  761 .El
  763 See \fBOPTION PRESETS\fP for configuration environment variables.
  764 .Sh "FILES"
  765 See \fBOPTION PRESETS\fP for configuration files.
  766 .Sh "EXIT STATUS"
  767 One of the following exit values will be returned:
  768 .Bl -tag
  769 .It 0 " (EXIT_SUCCESS)"
  770 Successful program execution.
  771 .It 1 " (EXIT_FAILURE)"
  772 The operation failed or the command syntax was not valid.
  773 .It 66 " (EX_NOINPUT)"
  774 A specified configuration file could not be loaded.
  775 .It 70 " (EX_SOFTWARE)"
  776 libopts had an internal operational error.  Please report
  777 it to autogen\-users@lists.sourceforge.net.  Thank you.
  778 .El
  779 .Sh "SEE ALSO"
  780 .Xr ntp.conf 5 ,
  781 .Xr ntpd 1ntpdmdoc
  782 .Rs
  783 .%A David L. Mills
  784 .%T Network Time Protocol (Version 3)
  785 .%O RFC1305
  786 .Re
  787 .Sh AUTHORS
  788 The formatting directives in this document came from FreeBSD.
  789 .Sh "COPYRIGHT"
  790 Copyright (C) 1992\-2020 The University of Delaware and Network Time Foundation all rights reserved.
  791 This program is released under the terms of the NTP license, <http://ntp.org/license>.
  792 .Sh BUGS
  793 The
  794 .Nm
  795 utility is a crude hack.
  796 Much of the information it shows is
  797 deadly boring and could only be loved by its implementer.
  798 The
  799 program was designed so that new (and temporary) features were easy
  800 to hack in, at great expense to the program's ease of use.
  801 Despite
  802 this, the program is occasionally useful.
  803 .Pp
  804 Please report bugs to http://bugs.ntp.org .
  805 .Pp
  806 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
  807 .Sh "NOTES"
  808 This manual page was \fIAutoGen\fP\-erated from the \fBntpdc\fP
  809 option definitions.