ntptrace.man.in revision 301301
1327Sjkh.de1 NOP 2327Sjkh. it 1 an-trap 3327Sjkh. if \\n[.$] \,\\$*\/ 4327Sjkh.. 5327Sjkh.ie t \ 6327Sjkh.ds B-Font [CB] 7327Sjkh.ds I-Font [CI] 8327Sjkh.ds R-Font [CR] 9327Sjkh.el \ 10327Sjkh.ds B-Font B 11327Sjkh.ds I-Font I 12327Sjkh.ds R-Font R 13327Sjkh.TH ntptrace @NTPTRACE_MS@ "02 Jun 2016" "ntp (4.2.8p8)" "User Commands" 14327Sjkh.\" 15327Sjkh.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-GMa4.N/ag-VMaa.N) 16327Sjkh.\" 17327Sjkh.\" It has been AutoGen-ed June 2, 2016 at 07:24:59 AM by AutoGen 5.18.5 18327Sjkh.\" From the definitions ntptrace-opts.def 19327Sjkh.\" and the template file agman-cmd.tpl 20327Sjkh.SH NAME 2193520Sobrien\f\*[B-Font]ntptrace\fP 2293520Sobrien\- Trace peers of an NTP server 2376392Sobrien.SH SYNOPSIS 2430221Scharnier\f\*[B-Font]ntptrace\fP 2512219Sjkh.\" Mixture of short (flag) options and long options 2647916Sobrien[\f\*[B-Font]\-flags\f[]] 27327Sjkh[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28327Sjkh[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29327Sjkh[host] 3048170Simp.sp \n(Ppu 31327Sjkh.ne 2 32327Sjkh 33327Sjkh.SH DESCRIPTION 34327Sjkh\fBntptrace\fP is a perl script that uses the ntpq utility program to follow 3542740Sbillfthe chain of NTP servers from a given host back to the primary time source. For 36327Sjkhntptrace to work properly, each of these servers must implement the NTP Control 37327Sjkhand Monitoring Protocol specified in RFC 1305 and enable NTP Mode 6 packets. 38327Sjkh.sp 39327SjkhIf given no arguments, ntptrace starts with localhost. Here is an example of 40327Sjkhthe output from ntptrace: 41327Sjkh.sp 4211780Sjkh.br 43382Sjkh.in +4 44327Sjkh.nf 4585023Sobrien% ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135 4612219Sjkhserver2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu: 4712219Sjkhstratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB' 4812219Sjkh.in -4 4976504Skris.fi 5076504Skris.sp 5176504SkrisOn each line, the fields are (left to right): the host name, the host stratum, 5276504Skristhe time offset between that host and the local host (as measured by 5376504Skris\fBntptrace\fP; this is why it is not always zero for "localhost"), the host 5476504Skrissynchronization distance, and (only for stratum\-1 servers) the reference clock 5576504SkrisID. All times are given in seconds. Note that the stratum is the server hop 5676504Skriscount to the primary source, while the synchronization distance is the 5776504Skrisestimated error relative to the primary source. These terms are precisely 5876504Skrisdefined in RFC\-1305. 5976504Skris.SH "OPTIONS" 6076504Skris.TP 6176504Skris.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[] 6276504SkrisPrint IP addresses instead of hostnames. 6376504Skris.sp 6476504SkrisOutput hosts as dotted-quad numeric format rather than converting to 6576504Skristhe canonical host names. 6651638Sbillf.TP 6742740Sbillf.NOP \f\*[B-Font]\-m\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-max\-hosts\f[]=\f\*[I-Font]number\f[] 6842740SbillfMaximum number of peers to trace. 6930221ScharnierThis option takes an integer number as its argument. 7030221ScharnierThe default 71327Sjkh\f\*[I-Font]number\f[] 72327Sjkhfor this option is: 73327Sjkh.ti +4 7476504Skris 99 7512219Sjkh.sp 7683573SsobomaxThis option has not been fully documented. 7753388Scpiazza.TP 7842740Sbillf.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-host\f[]=\f\*[I-Font]string\f[] 7912219SjkhSingle remote host. 8024428SimpThe default 81327Sjkh\f\*[I-Font]string\f[] 82327Sjkhfor this option is: 83327Sjkh.ti +4 84327Sjkh 127.0.0.1 85327Sjkh.sp 86327SjkhThis option has not been fully documented. 87327Sjkh.TP 88327Sjkh.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 89327SjkhDisplay usage information and exit. 90327Sjkh.TP 91327Sjkh.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 92327SjkhPass the extended usage information through a pager. 93327Sjkh.TP 94327Sjkh.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[]}]}] 95327SjkhOutput version of program and exit. The default mode is `v', a simple 96327Sjkhversion. The `c' mode will print copyright information and `n' will 97327Sjkhprint the full copyright notice. 984996Sjkh.PP 994996Sjkh.SH "EXIT STATUS" 1004996SjkhOne of the following exit values will be returned: 1014996Sjkh.TP 102327Sjkh.NOP 0 " (EXIT_SUCCESS)" 103327SjkhSuccessful program execution. 104327Sjkh.TP 105327Sjkh.NOP 1 " (EXIT_FAILURE)" 106327SjkhThe operation failed or the command syntax was not valid. 10742740Sbillf.TP 10842740Sbillf.NOP 70 " (EX_SOFTWARE)" 10942740Sbillflibopts had an internal operational error. Please report 11042740Sbillfit to autogen-users@lists.sourceforge.net. Thank you. 111382Sjkh.PP 11281571Sobrien.SH "NOTES" 11376504SkrisThis manual page was \fIAutoGen\fP-erated from the \fBntptrace\fP 114382Sjkhoption definitions. 115382Sjkh