| ntpq.8 (82501) | ntpq.8 (89625) |
|---|---|
| 1.\" | 1.\" |
| 2.\" $FreeBSD: head/usr.sbin/ntp/doc/ntpq.8 82501 2001-08-29 14:50:56Z sheldonh $ | 2.\" $FreeBSD: head/usr.sbin/ntp/doc/ntpq.8 89625 2002-01-21 20:12:02Z roberto $ |
| 3.\" 4.Dd January 7, 2000 5.Dt NTPQ 8 6.Os 7.Sh NAME 8.Nm ntpq 9.Nd standard NTP query program 10.Sh SYNOPSIS --- 97 unchanged lines hidden (view full) --- 108.Ss "Internal Commands" 109Interactive format commands consist of a keyword followed by zero 110to four arguments. 111Only enough characters of the full keyword to 112uniquely identify the command need be typed. 113The output of a 114command is normally sent to the standard output, but optionally the 115output of individual commands may be sent to a file by appending a | 3.\" 4.Dd January 7, 2000 5.Dt NTPQ 8 6.Os 7.Sh NAME 8.Nm ntpq 9.Nd standard NTP query program 10.Sh SYNOPSIS --- 97 unchanged lines hidden (view full) --- 108.Ss "Internal Commands" 109Interactive format commands consist of a keyword followed by zero 110to four arguments. 111Only enough characters of the full keyword to 112uniquely identify the command need be typed. 113The output of a 114command is normally sent to the standard output, but optionally the 115output of individual commands may be sent to a file by appending a |
| 116.Ql \&< , | 116.Ql \&> , |
| 117followed by a file name, to the command line. 118A 119number of interactive format commands are executed entirely within 120the 121.Nm 122program itself and do not result in NTP mode 6 123requests being sent to a server. 124These are described following. --- 192 unchanged lines hidden (view full) --- 317returned by the 318.Ic associations 319command is cached internally 320in 321.Xr ntpq 8 . 322The index is then of use when dealing with stupid 323servers which use association identifiers which are hard for humans 324to type, in that for any subsequent commands which require an | 117followed by a file name, to the command line. 118A 119number of interactive format commands are executed entirely within 120the 121.Nm 122program itself and do not result in NTP mode 6 123requests being sent to a server. 124These are described following. --- 192 unchanged lines hidden (view full) --- 317returned by the 318.Ic associations 319command is cached internally 320in 321.Xr ntpq 8 . 322The index is then of use when dealing with stupid 323servers which use association identifiers which are hard for humans 324to type, in that for any subsequent commands which require an |
| 325association identifier as an argument, the form and index may be | 325association identifier as an argument, the form of index may be |
| 326used as an alternative. 327.It Xo Ic clockvar Op Ar assocID 328.Oo 329.Ar variable_name Ns Op = Ns Ar value ... 330.Oc 331.Ar ... 332.Xc 333.It Xo Ic cv Op Ar assocID --- 72 unchanged lines hidden (view full) --- 406determined from the association list cached by the most recent 407.Ic associations 408command. 409.It Ic opeers 410An old form of the 411.Ic peers 412command with the reference ID 413replaced by the local interface address. | 326used as an alternative. 327.It Xo Ic clockvar Op Ar assocID 328.Oo 329.Ar variable_name Ns Op = Ns Ar value ... 330.Oc 331.Ar ... 332.Xc 333.It Xo Ic cv Op Ar assocID --- 72 unchanged lines hidden (view full) --- 406determined from the association list cached by the most recent 407.Ic associations 408command. 409.It Ic opeers 410An old form of the 411.Ic peers 412command with the reference ID 413replaced by the local interface address. |
| 414.It Ic passocations | 414.It Ic passociations |
| 415Displays association data concerning in-spec peers from the 416internally cached list of associations. 417This command performs 418identically to the 419.Ic associations 420except that it displays 421the internally stored data rather than making a new query. 422.It Ic peers --- 27 unchanged lines hidden (view full) --- 450The peer is discarded as not among the first ten peers sorted 451by synchronization distance and so is probably a poor candidate for 452further consideration. 453.It \&- 454.Pq outlyer 455The peer is discarded by the clustering algorithm as an 456outlyer. 457.It \&+ | 415Displays association data concerning in-spec peers from the 416internally cached list of associations. 417This command performs 418identically to the 419.Ic associations 420except that it displays 421the internally stored data rather than making a new query. 422.It Ic peers --- 27 unchanged lines hidden (view full) --- 450The peer is discarded as not among the first ten peers sorted 451by synchronization distance and so is probably a poor candidate for 452further consideration. 453.It \&- 454.Pq outlyer 455The peer is discarded by the clustering algorithm as an 456outlyer. 457.It \&+ |
| 458.Pq candidat | 458.Pq candidate |
| 459The peer is a survivor and a candidate for the combining 460algorithm. 461.It \&# 462.Pq selected 463The peer is a survivor, but not among the first six peers 464sorted by synchronization distance. | 459The peer is a survivor and a candidate for the combining 460algorithm. 461.It \&# 462.Pq selected 463The peer is a survivor, but not among the first six peers 464sorted by synchronization distance. |
| 465If the assocation is ephemeral, | 465If the association is ephemeral, |
| 466it may be demobilized to conserve resources. 467.It \&* 468.Pq peer 469The peer has been declared the system peer and lends its 470variables to the system variables. 471.It o 472.Pq (pps.peer) 473The peer has been declared the system peer and lends its | 466it may be demobilized to conserve resources. 467.It \&* 468.Pq peer 469The peer has been declared the system peer and lends its 470variables to the system variables. 471.It o 472.Pq (pps.peer) 473The peer has been declared the system peer and lends its |
| 474variables to thesystem variables. | 474variables to the system variables. |
| 475However, the actual system 476synchronization is derived from a pulse-per-second (PPS) signal, 477either indirectly via the PPS reference clock driver or directly 478via kernel interface. 479.El 480.El 481.Pp 482The --- 200 unchanged lines hidden (view full) --- 683Shows the NTP seconds when the last autokey key list was 684generated and signed. 685.It Ic pstatus Ar assocID 686Sends a read status request to the server for the given 687association. 688The names and values of the peer variables returned 689will be printed. 690Note that the status word from the header is | 475However, the actual system 476synchronization is derived from a pulse-per-second (PPS) signal, 477either indirectly via the PPS reference clock driver or directly 478via kernel interface. 479.El 480.El 481.Pp 482The --- 200 unchanged lines hidden (view full) --- 683Shows the NTP seconds when the last autokey key list was 684generated and signed. 685.It Ic pstatus Ar assocID 686Sends a read status request to the server for the given 687association. 688The names and values of the peer variables returned 689will be printed. 690Note that the status word from the header is |
| 691displayed preceding the variables, both in hexidecimal and in | 691displayed preceding the variables, both in hexadecimal and in |
| 692pidgeon English. 693.It Ic readlist Ar assocID 694.It Ic rl Ar assocID 695Requests that the values of the variables in the internal 696variable list be returned by the server. 697If the association ID is 698omitted or is 0 the variables are assumed to be system variables. 699Otherwise they are treated as peer variables. --- 45 unchanged lines hidden --- | 692pidgeon English. 693.It Ic readlist Ar assocID 694.It Ic rl Ar assocID 695Requests that the values of the variables in the internal 696variable list be returned by the server. 697If the association ID is 698omitted or is 0 the variables are assumed to be system variables. 699Otherwise they are treated as peer variables. --- 45 unchanged lines hidden --- |