calc_tickadj.1calc_tickadjman revision 280849
1139827Simp.de1 NOP 2194619Srwatson. it 1 an-trap 3133422Srwatson. if \\n[.$] \,\\$*\/ 4133422Srwatson.. 5133422Srwatson.ie t \ 6133422Srwatson.ds B-Font [CB] 7133422Srwatson.ds I-Font [CI] 8133422Srwatson.ds R-Font [CR] 9133422Srwatson.el \ 10133422Srwatson.ds B-Font B 11133422Srwatson.ds I-Font I 12133422Srwatson.ds R-Font R 13133422Srwatson.TH calc_tickadj 1calc_tickadjman "04 Feb 2015" "ntp (4.2.8p1)" "User Commands" 14133422Srwatson.\" 15133422Srwatson.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-1GaySe/ag-cHaGRe) 16133422Srwatson.\" 17133422Srwatson.\" It has been AutoGen-ed February 4, 2015 at 02:37:11 AM by AutoGen 5.18.5pre4 18133422Srwatson.\" From the definitions calc_tickadj-opts.def 19133422Srwatson.\" and the template file agman-cmd.tpl 20133422Srwatson.SH NAME 21133422Srwatson\f\*[B-Font]calc_tickadj\fP 22133422Srwatson\- Calculates optimal value for tick given ntp drift file. 23133422Srwatson.SH SYNOPSIS 24133422Srwatson\f\*[B-Font]calc_tickadj\fP 25165891Srwatson.\" Mixture of short (flag) options and long options 26165974Srwatson[\f\*[B-Font]\-flags\f[]] 2756555Sbrian[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28133422Srwatson[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29133422Srwatson.sp \n(Ppu 30133422Srwatson.ne 2 31133422Srwatson 32133422SrwatsonAll arguments must be options. 33133422Srwatson.sp \n(Ppu 34133422Srwatson.ne 2 35133422Srwatson 36133422Srwatson.SH DESCRIPTION 37133422SrwatsonThe \fBcalc_tickadj\fP script uses provided ntp drift file to generate optimal 38133422Srwatsontick value. Generally, ntpd can do better job if the drift value is the 39133422Srwatsonsmallest possible number. 40133422Srwatson.sp 41133422SrwatsonThe example output of 42133422Srwatson.br 43133422Srwatson.in +4 44133422Srwatson.nf 45133422Srwatson$ ./calc_tickadj 46133422Srwatson81.699 (drift) 47133422Srwatson9999 usec; 9999779 nsec 48133422Srwatson$ cat /etc/ntp/drift 4956555Sbrian-23.159 5015885Sjulian.in -4 5115885Sjulian.fi 5215885Sjulian.sp 5315885Sjulianmeans the following. If tick on that box is 10,000, by making the value 9999 5495759Stanimurawe'll shift the box from its current drift of \-23.159 to a drift of 81.699, and 5515885Sjulianin doing so we'll speed the clock up a little every second instead of slowing 5695759Stanimurathe clock down a little. 5715885Sjulian.sp 5815885SjulianIf 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift 5995759Stanimuravalue will be somewhere around 0.0. 6095759Stanimura.sp 6115885Sjulian\fBcalc_tickadj\fP tries to determine the the tick value by using 6215885Sjulian\fBtickadj\fP program from ntp package. If this doesn't work you can specify 6315885Sjuliancurrent tick manually on command line. 6418207Sbde.SH "OPTIONS" 6518207Sbde.TP 6618207Sbde.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-drift\-file\f[]=\f\*[I-Font]string\f[] 6718207SbdeNtp drift file to use. 68132043SrwatsonThe default 6915885Sjulian\f\*[I-Font]string\f[] 7015885Sjulianfor this option is: 71163606Srwatson.ti +4 72163606Srwatson /etc/ntp/drift 7329185Sbde.sp 7429185SbdeUse the specified drift file for calculations 7529184Sbde.TP 76132043Srwatson.NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-tick\f[]=\f\*[I-Font]number\f[] 7729185SbdeTick value of this host. 7829184SbdeThis option takes an integer number as its argument. 7929185Sbde.sp 8015885SjulianThe current tick which to adjustment will be calculated 8115885Sjulian.TP 8215885Sjulian.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 8315885SjulianDisplay usage information and exit. 84111888Sjlemon.TP 85111888Sjlemon.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 8615885SjulianPass the extended usage information through a pager. 8715885Sjulian.TP 88111888Sjlemon.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[]}]}] 89165974SrwatsonOutput version of program and exit. The default mode is `v', a simple 90111888Sjlemonversion. The `c' mode will print copyright information and `n' will 91111888Sjlemonprint the full copyright notice. 92111888Sjlemon.PP 9315885Sjulian.SH "EXIT STATUS" 94111888SjlemonOne of the following exit values will be returned: 95111888Sjlemon.TP 96111888Sjlemon.NOP 0 " (EXIT_SUCCESS)" 97111888SjlemonSuccessful program execution. 9815885Sjulian.TP 99111888Sjlemon.NOP 1 " (EXIT_FAILURE)" 100111888SjlemonThe operation failed or the command syntax was not valid. 101111888Sjlemon.TP 102165974Srwatson.NOP 70 " (EX_SOFTWARE)" 103165974Srwatsonlibopts had an internal operational error. Please report 104111888Sjlemonit to autogen-users@lists.sourceforge.net. Thank you. 105111888Sjlemon.PP 10615885Sjulian.SH "NOTES" 10715885SjulianThis manual page was \fIAutoGen\fP-erated from the \fBcalc_tickadj\fP 10830822Sjulianoption definitions. 109111888Sjlemon