1189765Sgabor.Dd November 21 2016 2189765Sgabor.Dt NTPDC @NTPDC_MS@ User Commands 3189765Sgabor.Os 4189765Sgabor.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc) 5189765Sgabor.\" 6189765Sgabor.\" It has been AutoGen-ed November 21, 2016 at 08:02:35 AM by AutoGen 5.18.5 7189765Sgabor.\" From the definitions ntpdc-opts.def 8189765Sgabor.\" and the template file agmdoc-cmd.tpl 9189765Sgabor.Sh NAME 10189765Sgabor.Nm ntpdc 11189765Sgabor.Nd vendor-specific NTPD control program 12189765Sgabor.Sh SYNOPSIS 13189765Sgabor.Nm 14189765Sgabor.\" Mixture of short (flag) options and long options 15189765Sgabor.Op Fl flags 16189765Sgabor.Op Fl flag Op Ar value 17189765Sgabor.Op Fl \-option\-name Ns Oo Oo Ns "=| " Oc Ns Ar value Oc 18189765Sgabor[ host ...] 19189765Sgabor.Pp 20189765Sgabor.Sh DESCRIPTION 21189765Sgabor.Nm 22189765Sgaboris deprecated. 23189765SgaborPlease use 24189765Sgabor.Xr ntpq @NTPQ_MS@ instead \- it can do everything 25189765Sgabor.Nm 26189765Sgaborused to do, and it does so using a much more sane interface. 27189765Sgabor.Pp 28189765Sgabor.Nm 29189765Sgaboris a utility program used to query 30189765Sgabor.Xr ntpd @NTPD_MS@ 31189765Sgaborabout its 32189765Sgaborcurrent state and to request changes in that state. 33189765SgaborIt uses NTP mode 7 control message formats described in the source code. 34189765SgaborThe program may 35189765Sgaborbe run either in interactive mode or controlled using command line 36189765Sgaborarguments. 37189765SgaborExtensive state and statistics information is available 38189765Sgaborthrough the 39189765Sgabor.Nm 40189765Sgaborinterface. 41189765SgaborIn addition, nearly all the 42189765Sgaborconfiguration options which can be specified at startup using 43189765Sgaborntpd's configuration file may also be specified at run time using 44189765Sgabor.Nm . 45189765Sgabor.Sh "OPTIONS" 46189765Sgabor.Bl -tag 47189765Sgabor.It Fl 4 , Fl \-ipv4 48189765SgaborForce IPv4 DNS name resolution. 49189765SgaborThis option must not appear in combination with any of the following options: 50189765Sgaboripv6. 51189765Sgabor.sp 52189765SgaborForce DNS resolution of following host names on the command line 53189765Sgaborto the IPv4 namespace. 54189765Sgabor.It Fl 6 , Fl \-ipv6 55189765SgaborForce IPv6 DNS name resolution. 56189765SgaborThis option must not appear in combination with any of the following options: 57189765Sgaboripv4. 58189765Sgabor.sp 59189765SgaborForce DNS resolution of following host names on the command line 60189765Sgaborto the IPv6 namespace. 61189765Sgabor.It Fl c Ar cmd , Fl \-command Ns = Ns Ar cmd 62189765Sgaborrun a command and exit. 63189765SgaborThis option may appear an unlimited number of times. 64189765Sgabor.sp 65189765SgaborThe following argument is interpreted as an interactive format command 66189765Sgaborand is added to the list of commands to be executed on the specified 67189765Sgaborhost(s). 68189765Sgabor.It Fl d , Fl \-debug\-level 69189765SgaborIncrease debug verbosity level. 70189765SgaborThis option may appear an unlimited number of times. 71189765Sgabor.sp 72189765Sgabor.It Fl D Ar number , Fl \-set\-debug\-level Ns = Ns Ar number 73189765SgaborSet the debug verbosity level. 74189765SgaborThis option may appear an unlimited number of times. 75189765SgaborThis option takes an integer number as its argument. 76189765Sgabor.sp 77189765Sgabor.It Fl i , Fl \-interactive 78189765SgaborForce ntpq to operate in interactive mode. 79189765SgaborThis option must not appear in combination with any of the following options: 80189765Sgaborcommand, listpeers, peers, showpeers. 81189765Sgabor.sp 82189765SgaborForce ntpq to operate in interactive mode. Prompts will be written 83189765Sgaborto the standard output and commands read from the standard input. 84189765Sgabor.It Fl l , Fl \-listpeers 85189765SgaborPrint a list of the peers. 86189765SgaborThis option must not appear in combination with any of the following options: 87189765Sgaborcommand. 88189765Sgabor.sp 89189765SgaborPrint a list of the peers known to the server as well as a summary of 90189765Sgabortheir state. This is equivalent to the 'listpeers' interactive command. 91189765Sgabor.It Fl n , Fl \-numeric 92189765Sgabornumeric host addresses. 93189765Sgabor.sp 94189765SgaborOutput all host addresses in dotted\-quad numeric format rather than 95189765Sgaborconverting to the canonical host names. 96189765Sgabor.It Fl p , Fl \-peers 97189765SgaborPrint a list of the peers. 98189765SgaborThis option must not appear in combination with any of the following options: 99189765Sgaborcommand. 100189765Sgabor.sp 101189765SgaborPrint a list of the peers known to the server as well as a summary 102189765Sgaborof their state. This is equivalent to the 'peers' interactive command. 103189765Sgabor.It Fl s , Fl \-showpeers 104189765SgaborShow a list of the peers. 105189765SgaborThis option must not appear in combination with any of the following options: 106189765Sgaborcommand. 107189765Sgabor.sp 108189765SgaborPrint a list of the peers known to the server as well as a summary 109189765Sgaborof their state. This is equivalent to the 'dmpeers' interactive command. 110189765Sgabor.It Fl \&? , Fl \-help 111189765SgaborDisplay usage information and exit. 112189765Sgabor.It Fl \&! , Fl \-more\-help 113189765SgaborPass the extended usage information through a pager. 114189765Sgabor.It Fl > Oo Ar cfgfile Oc , Fl \-save\-opts Oo Ns = Ns Ar cfgfile Oc 115189765SgaborSave the option state to \fIcfgfile\fP. The default is the \fIlast\fP 116189765Sgaborconfiguration file listed in the \fBOPTION PRESETS\fP section, below. 117189765SgaborThe command will exit after updating the config file. 118189765Sgabor.It Fl < Ar cfgfile , Fl \-load\-opts Ns = Ns Ar cfgfile , Fl \-no\-load\-opts 119189765SgaborLoad options from \fIcfgfile\fP. 120189765SgaborThe \fIno\-load\-opts\fP form will disable the loading 121189765Sgaborof earlier config/rc/ini files. \fI\-\-no\-load\-opts\fP is handled early, 122189765Sgaborout of order. 123189765Sgabor.It Fl \-version Op Brq Ar v|c|n 124189765SgaborOutput version of program and exit. The default mode is `v', a simple 125189765Sgaborversion. The `c' mode will print copyright information and `n' will 126189765Sgaborprint the full copyright notice. 127189765Sgabor.El 128189765Sgabor.Sh "OPTION PRESETS" 129189765SgaborAny option that is not marked as \fInot presettable\fP may be preset 130189765Sgaborby loading values from configuration ("RC" or ".INI") file(s) and values from 131189765Sgaborenvironment variables named: 132189765Sgabor.nf 133189765Sgabor \fBNTPDC_<option\-name>\fP or \fBNTPDC\fP 134189765Sgabor.fi 135189765Sgabor.ad 136189765SgaborThe environmental presets take precedence (are processed later than) 137189765Sgaborthe configuration files. 138189765SgaborThe \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP". 139189765SgaborIf any of these are directories, then the file \fI.ntprc\fP 140189765Sgaboris searched for within those directories. 141189765Sgabor.Sh USAGE 142189765SgaborIf one or more request options are included on the command line 143189765Sgaborwhen 144189765Sgabor.Nm 145189765Sgaboris executed, each of the requests will be sent 146189765Sgaborto the NTP servers running on each of the hosts given as command 147189765Sgaborline arguments, or on localhost by default. 148189765SgaborIf no request options 149189765Sgaborare given, 150189765Sgabor.Nm 151189765Sgaborwill attempt to read commands from the 152189765Sgaborstandard input and execute these on the NTP server running on the 153189765Sgaborfirst host given on the command line, again defaulting to localhost 154189765Sgaborwhen no other host is specified. 155189765SgaborThe 156189765Sgabor.Nm 157189765Sgaborutility will prompt for 158189765Sgaborcommands if the standard input is a terminal device. 159189765Sgabor.Pp 160189765SgaborThe 161189765Sgabor.Nm 162189765Sgaborutility uses NTP mode 7 packets to communicate with the 163189765SgaborNTP server, and hence can be used to query any compatible server on 164189765Sgaborthe network which permits it. 165189765SgaborNote that since NTP is a UDP protocol 166189765Sgaborthis communication will be somewhat unreliable, especially over 167189765Sgaborlarge distances in terms of network topology. 168189765SgaborThe 169189765Sgabor.Nm 170189765Sgaborutility makes 171189765Sgaborno attempt to retransmit requests, and will time requests out if 172189765Sgaborthe remote host is not heard from within a suitable timeout 173189765Sgabortime. 174189765Sgabor.Pp 175189765SgaborThe operation of 176189765Sgabor.Nm 177189765Sgaborare specific to the particular 178189765Sgaborimplementation of the 179189765Sgabor.Xr ntpd @NTPD_MS@ 180189765Sgabordaemon and can be expected to 181189765Sgaborwork only with this and maybe some previous versions of the daemon. 182189765SgaborRequests from a remote 183189765Sgabor.Nm 184189765Sgaborutility which affect the 185189765Sgaborstate of the local server must be authenticated, which requires 186189765Sgaborboth the remote program and local server share a common key and key 187189765Sgaboridentifier. 188189765Sgabor.Pp 189189765SgaborNote that in contexts where a host name is expected, a 190189765Sgabor.Fl 4 191189765Sgaborqualifier preceding the host name forces DNS resolution to the IPv4 namespace, 192189765Sgaborwhile a 193189765Sgabor.Fl 6 194189765Sgaborqualifier forces DNS resolution to the IPv6 namespace. 195189765SgaborSpecifying a command line option other than 196189765Sgabor.Fl i 197189765Sgaboror 198189765Sgabor.Fl n 199189765Sgaborwill cause the specified query (queries) to be sent to 200189765Sgaborthe indicated host(s) immediately. 201189765SgaborOtherwise, 202189765Sgabor.Nm 203189765Sgaborwill 204189765Sgaborattempt to read interactive format commands from the standard 205189765Sgaborinput. 206189765Sgabor.Ss "Interactive Commands" 207189765SgaborInteractive format commands consist of a keyword followed by zero 208189765Sgaborto four arguments. 209189765SgaborOnly enough characters of the full keyword to 210189765Sgaboruniquely identify the command need be typed. 211189765SgaborThe output of a 212189765Sgaborcommand is normally sent to the standard output, but optionally the 213189765Sgaboroutput of individual commands may be sent to a file by appending a 214189765Sgabor.Ql \&> , 215189765Sgaborfollowed by a file name, to the command line. 216189765Sgabor.Pp 217189765SgaborA number of interactive format commands are executed entirely 218189765Sgaborwithin the 219189765Sgabor.Nm 220189765Sgaborutility itself and do not result in NTP 221189765Sgabormode 7 requests being sent to a server. 222189765SgaborThese are described 223189765Sgaborfollowing. 224189765Sgabor.Bl -tag -width indent 225189765Sgabor.It Ic \&? Ar command_keyword 226189765Sgabor.It Ic help Ar command_keyword 227189765SgaborA 228189765Sgabor.Sq Ic \&? 229189765Sgaborwill print a list of all the command 230189765Sgaborkeywords known to this incarnation of 231189765Sgabor.Nm . 232189765SgaborA 233189765Sgabor.Sq Ic \&? 234189765Sgaborfollowed by a command keyword will print function and usage 235189765Sgaborinformation about the command. 236189765SgaborThis command is probably a better 237189765Sgaborsource of information about 238189765Sgabor.Xr ntpq @NTPQ_MS@ 239189765Sgaborthan this manual 240189765Sgaborpage. 241189765Sgabor.It Ic delay Ar milliseconds 242189765SgaborSpecify a time interval to be added to timestamps included in 243189765Sgaborrequests which require authentication. 244189765SgaborThis is used to enable 245189765Sgabor(unreliable) server reconfiguration over long delay network paths 246189765Sgaboror between machines whose clocks are unsynchronized. 247189765SgaborActually the 248189765Sgaborserver does not now require timestamps in authenticated requests, 249189765Sgaborso this command may be obsolete. 250.It Ic host Ar hostname 251Set the host to which future queries will be sent. 252Hostname may 253be either a host name or a numeric address. 254.It Ic hostnames Op Cm yes | Cm no 255If 256.Cm yes 257is specified, host names are printed in 258information displays. 259If 260.Cm no 261is specified, numeric 262addresses are printed instead. 263The default is 264.Cm yes , 265unless 266modified using the command line 267.Fl n 268switch. 269.It Ic keyid Ar keyid 270This command allows the specification of a key number to be 271used to authenticate configuration requests. 272This must correspond 273to a key number the server has been configured to use for this 274purpose. 275.It Ic quit 276Exit 277.Nm . 278.It Ic passwd 279This command prompts you to type in a password (which will not 280be echoed) which will be used to authenticate configuration 281requests. 282The password must correspond to the key configured for 283use by the NTP server for this purpose if such requests are to be 284successful. 285.It Ic timeout Ar milliseconds 286Specify a timeout period for responses to server queries. 287The 288default is about 8000 milliseconds. 289Note that since 290.Nm 291retries each query once after a timeout, the total waiting time for 292a timeout will be twice the timeout value set. 293.El 294.Ss "Control Message Commands" 295Query commands result in NTP mode 7 packets containing requests for 296information being sent to the server. 297These are read\-only commands 298in that they make no modification of the server configuration 299state. 300.Bl -tag -width indent 301.It Ic listpeers 302Obtains and prints a brief list of the peers for which the 303server is maintaining state. 304These should include all configured 305peer associations as well as those peers whose stratum is such that 306they are considered by the server to be possible future 307synchronization candidates. 308.It Ic peers 309Obtains a list of peers for which the server is maintaining 310state, along with a summary of that state. 311Summary information 312includes the address of the remote peer, the local interface 313address (0.0.0.0 if a local address has yet to be determined), the 314stratum of the remote peer (a stratum of 16 indicates the remote 315peer is unsynchronized), the polling interval, in seconds, the 316reachability register, in octal, and the current estimated delay, 317offset and dispersion of the peer, all in seconds. 318.Pp 319The character in the left margin indicates the mode this peer 320entry is operating in. 321A 322.Ql \&+ 323denotes symmetric active, a 324.Ql \&\- 325indicates symmetric passive, a 326.Ql \&= 327means the 328remote server is being polled in client mode, a 329.Ql \&^ 330indicates that the server is broadcasting to this address, a 331.Ql \&~ 332denotes that the remote peer is sending broadcasts and a 333.Ql \&~ 334denotes that the remote peer is sending broadcasts and a 335.Ql \&* 336marks the peer the server is currently synchronizing 337to. 338.Pp 339The contents of the host field may be one of four forms. 340It may 341be a host name, an IP address, a reference clock implementation 342name with its parameter or 343.Fn REFCLK "implementation_number" "parameter" . 344On 345.Ic hostnames 346.Cm no 347only IP\-addresses 348will be displayed. 349.It Ic dmpeers 350A slightly different peer summary list. 351Identical to the output 352of the 353.Ic peers 354command, except for the character in the 355leftmost column. 356Characters only appear beside peers which were 357included in the final stage of the clock selection algorithm. 358A 359.Ql \&. 360indicates that this peer was cast off in the falseticker 361detection, while a 362.Ql \&+ 363indicates that the peer made it 364through. 365A 366.Ql \&* 367denotes the peer the server is currently 368synchronizing with. 369.It Ic showpeer Ar peer_address Oo Ar ... Oc 370Shows a detailed display of the current peer variables for one 371or more peers. 372Most of these values are described in the NTP 373Version 2 specification. 374.It Ic pstats Ar peer_address Oo Ar ... Oc 375Show per\-peer statistic counters associated with the specified 376peer(s). 377.It Ic clockstat Ar clock_peer_address Oo Ar ... Oc 378Obtain and print information concerning a peer clock. 379The 380values obtained provide information on the setting of fudge factors 381and other clock performance information. 382.It Ic kerninfo 383Obtain and print kernel phase\-lock loop operating parameters. 384This information is available only if the kernel has been specially 385modified for a precision timekeeping function. 386.It Ic loopinfo Op Cm oneline | Cm multiline 387Print the values of selected loop filter variables. 388The loop 389filter is the part of NTP which deals with adjusting the local 390system clock. 391The 392.Sq offset 393is the last offset given to the 394loop filter by the packet processing code. 395The 396.Sq frequency 397is the frequency error of the local clock in parts\-per\-million 398(ppm). 399The 400.Sq time_const 401controls the stiffness of the 402phase\-lock loop and thus the speed at which it can adapt to 403oscillator drift. 404The 405.Sq watchdog timer 406value is the number 407of seconds which have elapsed since the last sample offset was 408given to the loop filter. 409The 410.Cm oneline 411and 412.Cm multiline 413options specify the format in which this 414information is to be printed, with 415.Cm multiline 416as the 417default. 418.It Ic sysinfo 419Print a variety of system state variables, i.e., state related 420to the local server. 421All except the last four lines are described 422in the NTP Version 3 specification, RFC\-1305. 423.Pp 424The 425.Sq system flags 426show various system flags, some of 427which can be set and cleared by the 428.Ic enable 429and 430.Ic disable 431configuration commands, respectively. 432These are 433the 434.Cm auth , 435.Cm bclient , 436.Cm monitor , 437.Cm pll , 438.Cm pps 439and 440.Cm stats 441flags. 442See the 443.Xr ntpd @NTPD_MS@ 444documentation for the meaning of these flags. 445There 446are two additional flags which are read only, the 447.Cm kernel_pll 448and 449.Cm kernel_pps . 450These flags indicate 451the synchronization status when the precision time kernel 452modifications are in use. 453The 454.Sq kernel_pll 455indicates that 456the local clock is being disciplined by the kernel, while the 457.Sq kernel_pps 458indicates the kernel discipline is provided by the PPS 459signal. 460.Pp 461The 462.Sq stability 463is the residual frequency error remaining 464after the system frequency correction is applied and is intended for 465maintenance and debugging. 466In most architectures, this value will 467initially decrease from as high as 500 ppm to a nominal value in 468the range .01 to 0.1 ppm. 469If it remains high for some time after 470starting the daemon, something may be wrong with the local clock, 471or the value of the kernel variable 472.Va kern.clockrate.tick 473may be 474incorrect. 475.Pp 476The 477.Sq broadcastdelay 478shows the default broadcast delay, 479as set by the 480.Ic broadcastdelay 481configuration command. 482.Pp 483The 484.Sq authdelay 485shows the default authentication delay, 486as set by the 487.Ic authdelay 488configuration command. 489.It Ic sysstats 490Print statistics counters maintained in the protocol 491module. 492.It Ic memstats 493Print statistics counters related to memory allocation 494code. 495.It Ic iostats 496Print statistics counters maintained in the input\-output 497module. 498.It Ic timerstats 499Print statistics counters maintained in the timer/event queue 500support code. 501.It Ic reslist 502Obtain and print the server's restriction list. 503This list is 504(usually) printed in sorted order and may help to understand how 505the restrictions are applied. 506.It Ic monlist Op Ar version 507Obtain and print traffic counts collected and maintained by the 508monitor facility. 509The version number should not normally need to be 510specified. 511.It Ic clkbug Ar clock_peer_address Oo Ar ... Oc 512Obtain debugging information for a reference clock driver. 513This 514information is provided only by some clock drivers and is mostly 515undecodable without a copy of the driver source in hand. 516.El 517.Ss "Runtime Configuration Requests" 518All requests which cause state changes in the server are 519authenticated by the server using a configured NTP key (the 520facility can also be disabled by the server by not configuring a 521key). 522The key number and the corresponding key must also be made 523known to 524.Nm . 525This can be done using the 526.Ic keyid 527and 528.Ic passwd 529commands, the latter of which will prompt at the terminal for a 530password to use as the encryption key. 531You will also be prompted 532automatically for both the key number and password the first time a 533command which would result in an authenticated request to the 534server is given. 535Authentication not only provides verification that 536the requester has permission to make such changes, but also gives 537an extra degree of protection again transmission errors. 538.Pp 539Authenticated requests always include a timestamp in the packet 540data, which is included in the computation of the authentication 541code. 542This timestamp is compared by the server to its receive time 543stamp. 544If they differ by more than a small amount the request is 545rejected. 546This is done for two reasons. 547First, it makes simple 548replay attacks on the server, by someone who might be able to 549overhear traffic on your LAN, much more difficult. 550Second, it makes 551it more difficult to request configuration changes to your server 552from topologically remote hosts. 553While the reconfiguration facility 554will work well with a server on the local host, and may work 555adequately between time\-synchronized hosts on the same LAN, it will 556work very poorly for more distant hosts. 557As such, if reasonable 558passwords are chosen, care is taken in the distribution and 559protection of keys and appropriate source address restrictions are 560applied, the run time reconfiguration facility should provide an 561adequate level of security. 562.Pp 563The 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 570Add a configured peer association at the given address and 571operating in symmetric active mode. 572Note that an existing 573association with the same peer may be deleted when this command is 574executed, or may simply be converted to conform to the new 575configuration, as appropriate. 576If the optional 577.Ar keyid 578is a 579nonzero integer, all outgoing packets to the remote server will 580have an authentication field attached encrypted with this key. 581If 582the value is 0 (or not given) no authentication will be done. 583The 584.Ar version 585can be 1, 2 or 3 and defaults to 3. 586The 587.Cm prefer 588keyword indicates a preferred peer (and thus will 589be used primarily for clock synchronisation if possible). 590The 591preferred peer also determines the validity of the PPS signal \- if 592the preferred peer is suitable for synchronisation so is the PPS 593signal. 594.It Xo Ic addserver Ar peer_address 595.Op Ar keyid 596.Op Ar version 597.Op Cm prefer 598.Xc 599Identical to the addpeer command, except that the operating 600mode is client. 601.It Xo Ic broadcast Ar peer_address 602.Op Ar keyid 603.Op Ar version 604.Op Cm prefer 605.Xc 606Identical to the addpeer command, except that the operating 607mode is broadcast. 608In this case a valid key identifier and key are 609required. 610The 611.Ar peer_address 612parameter can be the broadcast 613address of the local network or a multicast group address assigned 614to NTP. 615If a multicast address, a multicast\-capable kernel is 616required. 617.It Ic unconfig Ar peer_address Oo Ar ... Oc 618This command causes the configured bit to be removed from the 619specified peer(s). 620In many cases this will cause the peer 621association to be deleted. 622When appropriate, however, the 623association may persist in an unconfigured mode if the remote peer 624is 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 631This command provides a way to set certain data for a reference 632clock. 633See 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 650These commands operate in the same way as the 651.Ic enable 652and 653.Ic disable 654configuration file commands of 655.Xr ntpd @NTPD_MS@ . 656.Bl -tag -width indent 657.It Cm auth 658Enables the server to synchronize with unconfigured peers only 659if the peer has been correctly authenticated using either public key 660or private key cryptography. 661The default for this flag is enable. 662.It Cm bclient 663Enables the server to listen for a message from a broadcast or 664multicast server, as in the multicastclient command with 665default address. 666The default for this flag is disable. 667.It Cm calibrate 668Enables the calibrate feature for reference clocks. 669The default for this flag is disable. 670.It Cm kernel 671Enables the kernel time discipline, if available. 672The default for this flag is enable if support is available, otherwise disable. 673.It Cm monitor 674Enables the monitoring facility. 675See the documentation here about the 676.Cm monlist 677command or further information. 678The default for this flag is enable. 679.It Cm ntp 680Enables time and frequency discipline. 681In effect, this switch opens and closes the feedback loop, 682which is useful for testing. 683The default for this flag is enable. 684.It Cm pps 685Enables the pulse\-per\-second (PPS) signal when frequency 686and time is disciplined by the precision time kernel modifications. 687See the 688.Qq A Kernel Model for Precision Timekeeping 689(available as part of the HTML documentation 690provided in 691.Pa /usr/share/doc/ntp ) 692page for further information. 693The default for this flag is disable. 694.It Cm stats 695Enables the statistics facility. 696See the 697.Sx Monitoring Options 698section of 699.Xr ntp.conf 5 700for further information. 701The 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 706This command operates in the same way as the 707.Ic restrict 708configuration 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 713Unrestrict the matching entry from the restrict list. 714.It Xo Ic delrestrict Ar address Ar mask 715.Op Cm ntpport 716.Xc 717Delete the matching entry from the restrict list. 718.It Ic readkeys 719Causes the current set of authentication keys to be purged and 720a new set to be obtained by rereading the keys file (which must 721have been specified in the 722.Xr ntpd @NTPD_MS@ 723configuration file). 724This 725allows encryption keys to be changed without restarting the 726server. 727.It Ic trustedkey Ar keyid Oo Ar ... Oc 728.It Ic untrustedkey Ar keyid Oo Ar ... Oc 729These commands operate in the same way as the 730.Ic trustedkey 731and 732.Ic untrustedkey 733configuration file 734commands of 735.Xr ntpd @NTPD_MS@ . 736.It Ic authinfo 737Returns information concerning the authentication module, 738including known keys and counts of encryptions and decryptions 739which have been done. 740.It Ic traps 741Display the traps set in the server. 742See the source listing for 743further information. 744.It Xo Ic addtrap Ar address 745.Op Ar port 746.Op Ar interface 747.Xc 748Set a trap for asynchronous messages. 749See the source listing 750for further information. 751.It Xo Ic clrtrap Ar address 752.Op Ar port 753.Op Ar interface 754.Xc 755Clear a trap for asynchronous messages. 756See the source listing 757for further information. 758.It Ic reset 759Clear the statistics counters in various modules of the server. 760See the source listing for further information. 761.El 762.Sh "ENVIRONMENT" 763See \fBOPTION PRESETS\fP for configuration environment variables. 764.Sh "FILES" 765See \fBOPTION PRESETS\fP for configuration files. 766.Sh "EXIT STATUS" 767One of the following exit values will be returned: 768.Bl -tag 769.It 0 " (EXIT_SUCCESS)" 770Successful program execution. 771.It 1 " (EXIT_FAILURE)" 772The operation failed or the command syntax was not valid. 773.It 66 " (EX_NOINPUT)" 774A specified configuration file could not be loaded. 775.It 70 " (EX_SOFTWARE)" 776libopts had an internal operational error. Please report 777it 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 788The formatting directives in this document came from FreeBSD. 789.Sh "COPYRIGHT" 790Copyright (C) 1992\-2016 The University of Delaware and Network Time Foundation all rights reserved. 791This program is released under the terms of the NTP license, <http://ntp.org/license>. 792.Sh BUGS 793The 794.Nm 795utility is a crude hack. 796Much of the information it shows is 797deadly boring and could only be loved by its implementer. 798The 799program was designed so that new (and temporary) features were easy 800to hack in, at great expense to the program's ease of use. 801Despite 802this, the program is occasionally useful. 803.Pp 804Please report bugs to http://bugs.ntp.org . 805.Pp 806Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org 807.Sh "NOTES" 808This manual page was \fIAutoGen\fP\-erated from the \fBntpdc\fP 809option definitions. 810