ntp-4.2.8p15.tar.gz: ntp-4.2.8p15/ntpdc/ntpdc.mdoc.in

"Fossies" - the Fresh Open Source Software Archive

Member "ntp-4.2.8p15/ntpdc/ntpdc.mdoc.in" (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.mdoc.in":

4.2.8p14_vs_4.2.8p15.

1 .Dd June 23 2020 2 .Dt NTPDC @NTPDC_MS@ 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 20 .Sh DESCRIPTION 21 .Nm 22 is deprecated. 23 Please use 24 .Xr ntpq @NTPQ_MS@ 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 @NTPD_MS@ 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 128 .Sh "OPTION PRESETS" 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 @NTPD_MS@ 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 @NTPQ_MS@ 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 (0.0.0.0 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 @NTPD_MS@ 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 @NTPD_MS@ . 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 @NTPD_MS@ . 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 @NTPD_MS@ 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 @NTPD_MS@ . 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 762 .Sh "ENVIRONMENT" 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 @NTPD_MS@ 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.