1290001Sglebius@node calc_tickadj Invocation 2290001Sglebius@section Invoking calc_tickadj 3290001Sglebius@pindex calc_tickadj 4290001Sglebius@cindex Calculates "optimal" value for tick given ntp drift file. 5290001Sglebius@ignore 6290001Sglebius# 7290001Sglebius# EDIT THIS FILE WITH CAUTION (invoke-calc_tickadj.texi) 8290001Sglebius# 9310419Sdelphij# It has been AutoGen-ed November 21, 2016 at 07:58:38 AM by AutoGen 5.18.5 10290001Sglebius# From the definitions calc_tickadj-opts.def 11290001Sglebius# and the template file agtexi-cmd.tpl 12290001Sglebius@end ignore 13290001Sglebius 14290001SglebiusThe @code{calc_tickadj} script uses provided ntp drift file to generate optimal 15290001Sglebiustick value. Generally, ntpd can do better job if the drift value is the 16290001Sglebiussmallest possible number. 17290001Sglebius 18290001SglebiusThe example output of 19290001Sglebius@example 20290001Sglebius$ ./calc_tickadj 21290001Sglebius81.699 (drift) 22290001Sglebius9999 usec; 9999779 nsec 23290001Sglebius$ cat /etc/ntp/drift 24290001Sglebius-23.159 25290001Sglebius@end example 26290001Sglebius 27290001Sglebiusmeans the following. If tick on that box is 10,000, by making the value 9999 28290001Sglebiuswe'll shift the box from its current drift of -23.159 to a drift of 81.699, and 29290001Sglebiusin doing so we'll speed the clock up a little every second instead of slowing 30290001Sglebiusthe clock down a little. 31290001Sglebius 32290001SglebiusIf 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift 33290001Sglebiusvalue will be somewhere around 0.0. 34290001Sglebius 35290001Sglebius@code{calc_tickadj} tries to determine the the tick value by using 36290001Sglebius@code{tickadj} program from ntp package. If this doesn't work you can specify 37290001Sglebiuscurrent tick manually on command line. 38290001Sglebius 39290001Sglebius 40290001SglebiusThis section was generated by @strong{AutoGen}, 41290001Sglebiususing the @code{agtexi-cmd} template and the option descriptions for the @code{calc_tickadj} program. 42290001Sglebius 43290001Sglebius@menu 44290001Sglebius* calc_tickadj usage:: calc_tickadj help/usage (@option{--help}) 45290001Sglebius* calc_tickadj drift-file:: drift-file option (-d) 46290001Sglebius* calc_tickadj tick:: tick option (-t) 47290001Sglebius* calc_tickadj exit status:: exit status 48290001Sglebius@end menu 49290001Sglebius 50290001Sglebius@node calc_tickadj usage 51290001Sglebius@subsection calc_tickadj help/usage (@option{--help}) 52290001Sglebius@cindex calc_tickadj help 53290001Sglebius 54290001SglebiusThis is the automatically generated usage text for calc_tickadj. 55290001Sglebius 56290001SglebiusThe text printed is the same whether selected with the @code{help} option 57290001Sglebius(@option{--help}) or the @code{more-help} option (@option{--more-help}). @code{more-help} will print 58290001Sglebiusthe usage text by passing it through a pager program. 59290001Sglebius@code{more-help} is disabled on platforms without a working 60290001Sglebius@code{fork(2)} function. The @code{PAGER} environment variable is 61290001Sglebiusused to select the program, defaulting to @file{more}. Both will exit 62290001Sglebiuswith a status code of 0. 63290001Sglebius 64290001Sglebius@exampleindent 0 65290001Sglebius@example 66290001Sglebiuscalc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467 67290001SglebiusUSAGE: calc_tickadj [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... 68290001Sglebius 69290001Sglebius -d, --drift-file=str Ntp drift file to use 70290001Sglebius -t, --tick=num Tick value of this host 71290001Sglebius -?, --help Display usage information and exit 72290001Sglebius --more-help Pass the extended usage text through a pager 73290001Sglebius 74290001SglebiusOptions are specified by doubled hyphens and their name or by a single 75290001Sglebiushyphen and the flag character. 76290001Sglebius@end example 77290001Sglebius@exampleindent 4 78290001Sglebius 79290001Sglebius@node calc_tickadj drift-file 80290001Sglebius@subsection drift-file option (-d) 81290001Sglebius@cindex calc_tickadj-drift-file 82290001Sglebius 83290001SglebiusThis is the ``ntp drift file to use'' option. 84290001SglebiusThis option takes a string argument. 85290001SglebiusUse the specified drift file for calculations 86290001Sglebius@node calc_tickadj tick 87290001Sglebius@subsection tick option (-t) 88290001Sglebius@cindex calc_tickadj-tick 89290001Sglebius 90290001SglebiusThis is the ``tick value of this host'' option. 91290001SglebiusThis option takes a number argument. 92290001SglebiusThe current tick which to adjustment will be calculated 93290001Sglebius@node calc_tickadj exit status 94290001Sglebius@subsection calc_tickadj exit status 95290001Sglebius 96290001SglebiusOne of the following exit values will be returned: 97290001Sglebius@table @samp 98290001Sglebius@item 0 (EXIT_SUCCESS) 99290001SglebiusSuccessful program execution. 100290001Sglebius@item 1 (EXIT_FAILURE) 101290001SglebiusThe operation failed or the command syntax was not valid. 102290001Sglebius@end table 103