calc_tickadj.man.in revision 298699
124139Sjoerg.de1 NOP 224139Sjoerg. it 1 an-trap 324139Sjoerg. if \\n[.$] \,\\$*\/ 424139Sjoerg.. 524139Sjoerg.ie t \ 624139Sjoerg.ds B-Font [CB] 724139Sjoerg.ds I-Font [CI] 824139Sjoerg.ds R-Font [CR] 924139Sjoerg.el \ 1065937Speter.ds B-Font B 1165937Speter.ds I-Font I 1224139Sjoerg.ds R-Font R 1324139Sjoerg.TH calc_tickadj 1calc_tickadjman "26 Apr 2016" "ntp (4.2.8p7)" "User Commands" 1424139Sjoerg.\" 1524139Sjoerg.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-b1aGJu/ag-n1aOIu) 1624139Sjoerg.\" 1724139Sjoerg.\" It has been AutoGen-ed April 26, 2016 at 08:24:11 PM by AutoGen 5.18.5 1824139Sjoerg.\" From the definitions calc_tickadj-opts.def 1924139Sjoerg.\" and the template file agman-cmd.tpl 2024139Sjoerg.SH NAME 2124139Sjoerg\f\*[B-Font]calc_tickadj\fP 2224139Sjoerg\- Calculates optimal value for tick given ntp drift file. 2324139Sjoerg.SH SYNOPSIS 2424139Sjoerg\f\*[B-Font]calc_tickadj\fP 2524139Sjoerg.\" Mixture of short (flag) options and long options 2624139Sjoerg[\f\*[B-Font]\-flags\f[]] 2724139Sjoerg[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 2824139Sjoerg[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 2924139Sjoerg.sp \n(Ppu 3024139Sjoerg.ne 2 3124139Sjoerg 3224139SjoergAll arguments must be options. 3324139Sjoerg.sp \n(Ppu 3424139Sjoerg.ne 2 3524139Sjoerg 3624139Sjoerg.SH DESCRIPTION 3724139SjoergThe \fBcalc_tickadj\fP script uses provided ntp drift file to generate optimal 3824139Sjoergtick value. Generally, ntpd can do better job if the drift value is the 3924139Sjoergsmallest possible number. 4024139Sjoerg.sp 4124139SjoergThe example output of 4224139Sjoerg.br 4324139Sjoerg.in +4 4424139Sjoerg.nf 4524139Sjoerg$ ./calc_tickadj 4624139Sjoerg81.699 (drift) 4724139Sjoerg9999 usec; 9999779 nsec 4824139Sjoerg$ cat /etc/ntp/drift 4924139Sjoerg-23.159 5024139Sjoerg.in -4 5124139Sjoerg.fi 5224139Sjoerg.sp 5324139Sjoergmeans the following. If tick on that box is 10,000, by making the value 9999 5424139Sjoergwe'll shift the box from its current drift of \-23.159 to a drift of 81.699, and 5524139Sjoergin doing so we'll speed the clock up a little every second instead of slowing 5624139Sjoergthe clock down a little. 5724139Sjoerg.sp 5824139SjoergIf 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift 5924139Sjoergvalue will be somewhere around 0.0. 6024139Sjoerg.sp 6124139Sjoerg\fBcalc_tickadj\fP tries to determine the the tick value by using 6224139Sjoerg\fBtickadj\fP program from ntp package. If this doesn't work you can specify 6324139Sjoergcurrent tick manually on command line. 6424139Sjoerg.SH "OPTIONS" 6524139Sjoerg.TP 6624139Sjoerg.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-drift\-file\f[]=\f\*[I-Font]string\f[] 6724139SjoergNtp drift file to use. 6824139SjoergThe default 6924139Sjoerg\f\*[I-Font]string\f[] 7024139Sjoergfor this option is: 7124139Sjoerg.ti +4 7224139Sjoerg /etc/ntp/drift 7324139Sjoerg.sp 7424139SjoergUse the specified drift file for calculations 7524139Sjoerg.TP 7624139Sjoerg.NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-tick\f[]=\f\*[I-Font]number\f[] 7724139SjoergTick value of this host. 7824139SjoergThis option takes an integer number as its argument. 7924139Sjoerg.sp 8024139SjoergThe current tick which to adjustment will be calculated 8124139Sjoerg.TP 8224139Sjoerg.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 8324139SjoergDisplay usage information and exit. 8424139Sjoerg.TP 8524139Sjoerg.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 8624139SjoergPass the extended usage information through a pager. 8724139Sjoerg.TP 8824139Sjoerg.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[]}]}] 8924139SjoergOutput version of program and exit. The default mode is `v', a simple 9024139Sjoergversion. The `c' mode will print copyright information and `n' will 9124139Sjoergprint the full copyright notice. 9224139Sjoerg.PP 9324139Sjoerg.SH "EXIT STATUS" 9424139SjoergOne of the following exit values will be returned: 9524139Sjoerg.TP 9624139Sjoerg.NOP 0 " (EXIT_SUCCESS)" 9724139SjoergSuccessful program execution. 98210386Srpaulo.TP 9924139Sjoerg.NOP 1 " (EXIT_FAILURE)" 10024139SjoergThe operation failed or the command syntax was not valid. 10124139Sjoerg.TP 10224139Sjoerg.NOP 70 " (EX_SOFTWARE)" 10324139Sjoerglibopts had an internal operational error. Please report 10424139Sjoergit to autogen-users@lists.sourceforge.net. Thank you. 10524139Sjoerg.PP 10624139Sjoerg.SH "NOTES" 10724139SjoergThis manual page was \fIAutoGen\fP-erated from the \fBcalc_tickadj\fP 10824139Sjoergoption definitions. 10924139Sjoerg