calc_tickadj.man.in revision 344884
147831Sfoxfair.de1 NOP 247831Sfoxfair. it 1 an-trap 347831Sfoxfair. if \\n[.$] \,\\$*\/ 487106Sache.. 587106Sache.ie t \ 647831Sfoxfair.ds B-Font [CB] 747831Sfoxfair.ds I-Font [CI] 847831Sfoxfair.ds R-Font [CR] 947831Sfoxfair.el \ 1047831Sfoxfair.ds B-Font B 1147831Sfoxfair.ds I-Font I 1247831Sfoxfair.ds R-Font R 1347831Sfoxfair.TH calc_tickadj 1calc_tickadjman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" 1447831Sfoxfair.\" 1547831Sfoxfair.\" EDIT THIS FILE WITH CAUTION (in-mem file) 1647831Sfoxfair.\" 1747831Sfoxfair.\" It has been AutoGen-ed February 20, 2019 at 09:57:23 AM by AutoGen 5.18.5 1847831Sfoxfair.\" From the definitions calc_tickadj-opts.def 1947831Sfoxfair.\" and the template file agman-cmd.tpl 2047831Sfoxfair.SH NAME 2147831Sfoxfair\f\*[B-Font]calc_tickadj\fP 2247831Sfoxfair\- Calculates optimal value for tick given ntp drift file. 2347831Sfoxfair.SH SYNOPSIS 2447831Sfoxfair\f\*[B-Font]calc_tickadj\fP 25156014Sdelphij.\" Mixture of short (flag) options and long options 2647831Sfoxfair[\f\*[B-Font]\-flags\f[]] 2747831Sfoxfair[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 2847831Sfoxfair[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 2947831Sfoxfair.sp \n(Ppu 3047831Sfoxfair.ne 2 3147831Sfoxfair 3247831SfoxfairAll arguments must be options. 3347831Sfoxfair.sp \n(Ppu 3447831Sfoxfair.ne 2 3547831Sfoxfair 3647831Sfoxfair.SH DESCRIPTION 3747831SfoxfairThe \fBcalc_tickadj\fP script uses provided ntp drift file to generate optimal 3847831Sfoxfairtick value. Generally, ntpd can do better job if the drift value is the 3947831Sfoxfairsmallest possible number. 40156014Sdelphij.sp 4147831SfoxfairThe example output of 4247831Sfoxfair.br 43156014Sdelphij.in +4 4447831Sfoxfair.nf 4547831Sfoxfair$ ./calc_tickadj 4687106Sache81.699 (drift) 47156014Sdelphij9999 usec; 9999779 nsec 4847831Sfoxfair$ cat /etc/ntp/drift 4947831Sfoxfair-23.159 5047831Sfoxfair.in -4 5147831Sfoxfair.fi 5247831Sfoxfair.sp 5347831Sfoxfairmeans the following. If tick on that box is 10,000, by making the value 9999 5447831Sfoxfairwe'll shift the box from its current drift of \-23.159 to a drift of 81.699, and 5547831Sfoxfairin doing so we'll speed the clock up a little every second instead of slowing 5647831Sfoxfairthe clock down a little. 57156014Sdelphij.sp 58156014SdelphijIf 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift 5947831Sfoxfairvalue will be somewhere around 0.0. 6047831Sfoxfair.sp 6147831Sfoxfair\fBcalc_tickadj\fP tries to determine the the tick value by using 6247831Sfoxfair\fBtickadj\fP program from ntp package. If this doesn't work you can specify 6347831Sfoxfaircurrent tick manually on command line. 6447831Sfoxfair.SH "OPTIONS" 6547831Sfoxfair.TP 6687106Sache.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-drift\-file\f[]=\f\*[I-Font]string\f[] 67156014SdelphijNtp drift file to use. 6847831SfoxfairThe default 6947831Sfoxfair\f\*[I-Font]string\f[] 7087108Sachefor this option is: 71156014Sdelphij.ti +4 7247831Sfoxfair /etc/ntp/drift 7347831Sfoxfair.sp 74156014SdelphijUse the specified drift file for calculations 7547831Sfoxfair.TP 7647831Sfoxfair.NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-tick\f[]=\f\*[I-Font]number\f[] 77156014SdelphijTick value of this host. 7888310SacheThis option takes an integer number as its argument. 7988310Sache.sp 8047831SfoxfairThe current tick which to adjustment will be calculated 8147831Sfoxfair.TP 8247831Sfoxfair.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 8347831SfoxfairDisplay usage information and exit. 84156014Sdelphij.TP 85156014Sdelphij.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 8647831SfoxfairPass the extended usage information through a pager. 8747831Sfoxfair.TP 8847831Sfoxfair.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[]}]}] 8947831SfoxfairOutput version of program and exit. The default mode is `v', a simple 9047831Sfoxfairversion. The `c' mode will print copyright information and `n' will 9147831Sfoxfairprint the full copyright notice. 92156014Sdelphij.PP 93156014Sdelphij.SH "EXIT STATUS" 9447831SfoxfairOne of the following exit values will be returned: 9547831Sfoxfair.TP 9647831Sfoxfair.NOP 0 " (EXIT_SUCCESS)" 9747831SfoxfairSuccessful program execution. 9847831Sfoxfair.TP 9947831Sfoxfair.NOP 1 " (EXIT_FAILURE)" 10047831SfoxfairThe operation failed or the command syntax was not valid. 10147831Sfoxfair.TP 10247831Sfoxfair.NOP 70 " (EX_SOFTWARE)" 10347831Sfoxfairlibopts had an internal operational error. Please report 10447831Sfoxfairit to autogen-users@lists.sourceforge.net. Thank you. 10547831Sfoxfair.PP 10647831Sfoxfair.SH "NOTES" 10747831SfoxfairThis manual page was \fIAutoGen\fP-erated from the \fBcalc_tickadj\fP 10847831Sfoxfairoption definitions. 10947831Sfoxfair