1275970Scy.de1 NOP 2275970Scy. it 1 an-trap 3275970Scy. if \\n[.$] \,\\$*\/ 4275970Scy.. 5275970Scy.ie t \ 6275970Scy.ds B-Font [CB] 7275970Scy.ds I-Font [CI] 8275970Scy.ds R-Font [CR] 9275970Scy.el \ 10275970Scy.ds B-Font B 11275970Scy.ds I-Font I 12275970Scy.ds R-Font R 13338531Sdelphij.TH ntptrace 1ntptraceman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" 14275970Scy.\" 15338531Sdelphij.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-n1aOAe/ag-B1aWze) 16275970Scy.\" 17338531Sdelphij.\" It has been AutoGen-ed August 14, 2018 at 08:09:22 AM by AutoGen 5.18.5 18275970Scy.\" From the definitions ntptrace-opts.def 19275970Scy.\" and the template file agman-cmd.tpl 20275970Scy.SH NAME 21275970Scy\f\*[B-Font]ntptrace\fP 22275970Scy\- Trace peers of an NTP server 23275970Scy.SH SYNOPSIS 24275970Scy\f\*[B-Font]ntptrace\fP 25275970Scy.\" Mixture of short (flag) options and long options 26275970Scy[\f\*[B-Font]\-flags\f[]] 27275970Scy[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28275970Scy[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29275970Scy[host] 30275970Scy.sp \n(Ppu 31275970Scy.ne 2 32275970Scy 33275970Scy.SH DESCRIPTION 34275970Scy\fBntptrace\fP is a perl script that uses the ntpq utility program to follow 35275970Scythe chain of NTP servers from a given host back to the primary time source. For 36275970Scyntptrace to work properly, each of these servers must implement the NTP Control 37275970Scyand Monitoring Protocol specified in RFC 1305 and enable NTP Mode 6 packets. 38275970Scy.sp 39275970ScyIf given no arguments, ntptrace starts with localhost. Here is an example of 40275970Scythe output from ntptrace: 41275970Scy.sp 42275970Scy.br 43275970Scy.in +4 44275970Scy.nf 45275970Scy% ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135 46275970Scyserver2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu: 47275970Scystratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB' 48275970Scy.in -4 49275970Scy.fi 50275970Scy.sp 51275970ScyOn each line, the fields are (left to right): the host name, the host stratum, 52275970Scythe time offset between that host and the local host (as measured by 53275970Scy\fBntptrace\fP; this is why it is not always zero for "localhost"), the host 54275970Scysynchronization distance, and (only for stratum\-1 servers) the reference clock 55275970ScyID. All times are given in seconds. Note that the stratum is the server hop 56275970Scycount to the primary source, while the synchronization distance is the 57275970Scyestimated error relative to the primary source. These terms are precisely 58275970Scydefined in RFC\-1305. 59275970Scy.SH "OPTIONS" 60275970Scy.TP 61275970Scy.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[] 62275970ScyPrint IP addresses instead of hostnames. 63275970Scy.sp 64275970ScyOutput hosts as dotted-quad numeric format rather than converting to 65275970Scythe canonical host names. 66275970Scy.TP 67275970Scy.NOP \f\*[B-Font]\-m\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-max\-hosts\f[]=\f\*[I-Font]number\f[] 68275970ScyMaximum number of peers to trace. 69275970ScyThis option takes an integer number as its argument. 70275970ScyThe default 71275970Scy\f\*[I-Font]number\f[] 72275970Scyfor this option is: 73275970Scy.ti +4 74275970Scy 99 75275970Scy.sp 76275970ScyThis option has not been fully documented. 77275970Scy.TP 78275970Scy.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-host\f[]=\f\*[I-Font]string\f[] 79275970ScySingle remote host. 80275970ScyThe default 81275970Scy\f\*[I-Font]string\f[] 82275970Scyfor this option is: 83275970Scy.ti +4 84275970Scy 127.0.0.1 85275970Scy.sp 86275970ScyThis option has not been fully documented. 87275970Scy.TP 88275970Scy.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 89275970ScyDisplay usage information and exit. 90275970Scy.TP 91275970Scy.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 92275970ScyPass the extended usage information through a pager. 93275970Scy.TP 94275970Scy.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}] 95275970ScyOutput version of program and exit. The default mode is `v', a simple 96275970Scyversion. The `c' mode will print copyright information and `n' will 97275970Scyprint the full copyright notice. 98275970Scy.PP 99275970Scy.SH "EXIT STATUS" 100275970ScyOne of the following exit values will be returned: 101275970Scy.TP 102275970Scy.NOP 0 " (EXIT_SUCCESS)" 103275970ScySuccessful program execution. 104275970Scy.TP 105275970Scy.NOP 1 " (EXIT_FAILURE)" 106275970ScyThe operation failed or the command syntax was not valid. 107275970Scy.TP 108275970Scy.NOP 70 " (EX_SOFTWARE)" 109275970Scylibopts had an internal operational error. Please report 110275970Scyit to autogen-users@lists.sourceforge.net. Thank you. 111275970Scy.PP 112275970Scy.SH "NOTES" 113275970ScyThis manual page was \fIAutoGen\fP-erated from the \fBntptrace\fP 114275970Scyoption definitions. 115