a25439b686
Reviewed by: delphij (suggested MFC) Approved by: roberto Security: CVE-2015-1798, CVE-2015-1799 Security: VuXML ebd84c96-dd7e-11e4-854e-3c970e169bc2 MFC after: 1 month
103 lines
3.5 KiB
Plaintext
103 lines
3.5 KiB
Plaintext
@node calc_tickadj Invocation
|
|
@section Invoking calc_tickadj
|
|
@pindex calc_tickadj
|
|
@cindex Calculates "optimal" value for tick given ntp drift file.
|
|
@ignore
|
|
#
|
|
# EDIT THIS FILE WITH CAUTION (invoke-calc_tickadj.texi)
|
|
#
|
|
# It has been AutoGen-ed April 7, 2015 at 04:21:09 AM by AutoGen 5.18.5pre4
|
|
# From the definitions calc_tickadj-opts.def
|
|
# and the template file agtexi-cmd.tpl
|
|
@end ignore
|
|
|
|
The @code{calc_tickadj} script uses provided ntp drift file to generate optimal
|
|
tick value. Generally, ntpd can do better job if the drift value is the
|
|
smallest possible number.
|
|
|
|
The example output of
|
|
@example
|
|
$ ./calc_tickadj
|
|
81.699 (drift)
|
|
9999 usec; 9999779 nsec
|
|
$ cat /etc/ntp/drift
|
|
-23.159
|
|
@end example
|
|
|
|
means the following. If tick on that box is 10,000, by making the value 9999
|
|
we'll shift the box from its current drift of -23.159 to a drift of 81.699, and
|
|
in doing so we'll speed the clock up a little every second instead of slowing
|
|
the clock down a little.
|
|
|
|
If 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift
|
|
value will be somewhere around 0.0.
|
|
|
|
@code{calc_tickadj} tries to determine the the tick value by using
|
|
@code{tickadj} program from ntp package. If this doesn't work you can specify
|
|
current tick manually on command line.
|
|
|
|
|
|
This section was generated by @strong{AutoGen},
|
|
using the @code{agtexi-cmd} template and the option descriptions for the @code{calc_tickadj} program.
|
|
|
|
@menu
|
|
* calc_tickadj usage:: calc_tickadj help/usage (@option{--help})
|
|
* calc_tickadj drift-file:: drift-file option (-d)
|
|
* calc_tickadj tick:: tick option (-t)
|
|
* calc_tickadj exit status:: exit status
|
|
@end menu
|
|
|
|
@node calc_tickadj usage
|
|
@subsection calc_tickadj help/usage (@option{--help})
|
|
@cindex calc_tickadj help
|
|
|
|
This is the automatically generated usage text for calc_tickadj.
|
|
|
|
The text printed is the same whether selected with the @code{help} option
|
|
(@option{--help}) or the @code{more-help} option (@option{--more-help}). @code{more-help} will print
|
|
the usage text by passing it through a pager program.
|
|
@code{more-help} is disabled on platforms without a working
|
|
@code{fork(2)} function. The @code{PAGER} environment variable is
|
|
used to select the program, defaulting to @file{more}. Both will exit
|
|
with a status code of 0.
|
|
|
|
@exampleindent 0
|
|
@example
|
|
calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467
|
|
USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
|
|
|
|
-d, --drift-file=str Ntp drift file to use
|
|
-t, --tick=num Tick value of this host
|
|
-?, --help Display usage information and exit
|
|
--more-help Pass the extended usage text through a pager
|
|
|
|
Options are specified by doubled hyphens and their name or by a single
|
|
hyphen and the flag character.
|
|
@end example
|
|
@exampleindent 4
|
|
|
|
@node calc_tickadj drift-file
|
|
@subsection drift-file option (-d)
|
|
@cindex calc_tickadj-drift-file
|
|
|
|
This is the ``ntp drift file to use'' option.
|
|
This option takes a string argument.
|
|
Use the specified drift file for calculations
|
|
@node calc_tickadj tick
|
|
@subsection tick option (-t)
|
|
@cindex calc_tickadj-tick
|
|
|
|
This is the ``tick value of this host'' option.
|
|
This option takes a number argument.
|
|
The current tick which to adjustment will be calculated
|
|
@node calc_tickadj exit status
|
|
@subsection calc_tickadj exit status
|
|
|
|
One of the following exit values will be returned:
|
|
@table @samp
|
|
@item 0 (EXIT_SUCCESS)
|
|
Successful program execution.
|
|
@item 1 (EXIT_FAILURE)
|
|
The operation failed or the command syntax was not valid.
|
|
@end table
|