calc_tickadj.man.in revision 358659
1.de1 NOP 2. it 1 an-trap 3. if \\n[.$] \,\\$*\/ 4.. 5.ie t \ 6.ds B-Font [CB] 7.ds I-Font [CI] 8.ds R-Font [CR] 9.el \ 10.ds B-Font B 11.ds I-Font I 12.ds R-Font R 13.TH calc_tickadj 1calc_tickadjman "03 Mar 2020" "ntp (4.2.8p14)" "User Commands" 14.\" 15.\" EDIT THIS FILE WITH CAUTION (in-mem file) 16.\" 17.\" It has been AutoGen-ed March 3, 2020 at 05:41:52 PM by AutoGen 5.18.5 18.\" From the definitions calc_tickadj-opts.def 19.\" and the template file agman-cmd.tpl 20.SH NAME 21\f\*[B-Font]calc_tickadj\fP 22\- Calculates optimal value for tick given ntp drift file. 23.SH SYNOPSIS 24\f\*[B-Font]calc_tickadj\fP 25.\" Mixture of short (flag) options and long options 26[\f\*[B-Font]\-flags\f[]] 27[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29.sp \n(Ppu 30.ne 2 31 32All arguments must be options. 33.sp \n(Ppu 34.ne 2 35 36.SH DESCRIPTION 37The \fBcalc_tickadj\fP script uses provided ntp drift file to generate optimal 38tick value. Generally, ntpd can do better job if the drift value is the 39smallest possible number. 40.sp 41The example output of 42.br 43.in +4 44.nf 45$ ./calc_tickadj 4681.699 (drift) 479999 usec; 9999779 nsec 48$ cat /etc/ntp/drift 49-23.159 50.in -4 51.fi 52.sp 53means the following. If tick on that box is 10,000, by making the value 9999 54we'll shift the box from its current drift of \-23.159 to a drift of 81.699, and 55in doing so we'll speed the clock up a little every second instead of slowing 56the clock down a little. 57.sp 58If 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift 59value will be somewhere around 0.0. 60.sp 61\fBcalc_tickadj\fP tries to determine the the tick value by using 62\fBtickadj\fP program from ntp package. If this doesn't work you can specify 63current tick manually on command line. 64.SH "OPTIONS" 65.TP 66.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-drift\-file\f[]=\f\*[I-Font]string\f[] 67Ntp drift file to use. 68The default 69\f\*[I-Font]string\f[] 70for this option is: 71.ti +4 72 /etc/ntp/drift 73.sp 74Use the specified drift file for calculations 75.TP 76.NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-tick\f[]=\f\*[I-Font]number\f[] 77Tick value of this host. 78This option takes an integer number as its argument. 79.sp 80The current tick which to adjustment will be calculated 81.TP 82.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 83Display usage information and exit. 84.TP 85.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 86Pass the extended usage information through a pager. 87.TP 88.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[]}]}] 89Output version of program and exit. The default mode is `v', a simple 90version. The `c' mode will print copyright information and `n' will 91print the full copyright notice. 92.PP 93.SH "EXIT STATUS" 94One of the following exit values will be returned: 95.TP 96.NOP 0 " (EXIT_SUCCESS)" 97Successful program execution. 98.TP 99.NOP 1 " (EXIT_FAILURE)" 100The operation failed or the command syntax was not valid. 101.TP 102.NOP 70 " (EX_SOFTWARE)" 103libopts had an internal operational error. Please report 104it to autogen-users@lists.sourceforge.net. Thank you. 105.PP 106.SH "NOTES" 107This manual page was \fIAutoGen\fP-erated from the \fBcalc_tickadj\fP 108option definitions. 109