19c2daa00SOllivier Robert<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 29c2daa00SOllivier Robert 39c2daa00SOllivier Robert<html> 49c2daa00SOllivier Robert 59c2daa00SOllivier Robert <head> 69c2daa00SOllivier Robert <meta name="generator" content="HTML Tidy, see www.w3.org"> 79c2daa00SOllivier Robert <title>tickadj - set time-related kernel variables</title> 89c2daa00SOllivier Robert <link href="scripts/style.css" type="text/css" rel="stylesheet"> 99c2daa00SOllivier Robert </head> 109c2daa00SOllivier Robert 119c2daa00SOllivier Robert <body> 129c2daa00SOllivier Robert <h3><tt>tickadj</tt> - set time-related kernel variables</h3> 139c2daa00SOllivier Robert <p>Last update: <csobj format="ShortTime" h="24" locale="00000409" region="0" t="DateTime" w="50">20:11</csobj> UTC <csobj format="LongDate" h="24" locale="00000409" region="0" t="DateTime" w="257">Monday, December 02, 2002</csobj></p> 149c2daa00SOllivier Robert <hr> 159c2daa00SOllivier Robert <h4>Synopsis</h4> 169c2daa00SOllivier Robert <tt>tickadj [ -Aqs ] [ -a <i>tickadj</i> ] [ -t <i>tick</i> ]</tt> 179c2daa00SOllivier Robert <h4>Description</h4> 189c2daa00SOllivier Robert <p>The <tt>tickadj</tt> program reads, and optionally modifies, several timekeeping-related variables in older kernels that do not have support for precision ttimekeeping, including HP-UX, SunOS, Ultrix, SGI and probably others. Those machines provide means to patch the kernel <tt>/dev/kmem</tt>. Newer machines with precision time support, including Solaris, Tru64, FreeBSD and Linux (with PPSkit patch) should NOT use the program. The particular variables that can be changed with <tt>tickadj</tt> include <tt>tick</tt>, which is the number of microseconds added to the system time for a clock interrupt, <tt>tickadj</tt>, which sets the slew rate and resolution used by the <tt>adjtime</tt> system call, and <tt>dosynctodr</tt>, which indicates to the kernels on some machines whether they should internally adjust the system clock to keep it in line with time-of-day clock or not.</p> 199c2daa00SOllivier Robert <p>By default, with no arguments, <tt>tickadj</tt> reads the variables of interest in the kernel and displays them. At the same time, it determines an "optimal" value for the value of the <tt>tickadj</tt> variable if the intent is to run the <tt>ntpd</tt> Network Time Protocol (NTP) daemon, and prints this as well. Since the operation of <tt>tickadj</tt> when reading the kernel mimics the operation of similar parts of the <tt>ntpd</tt> program fairly closely, this can be useful when debugging problems with <tt>ntpd</tt>.</p> 209c2daa00SOllivier Robert <p>Note that <tt>tickadj</tt> should be run with some caution when being used for the first time on different types of machines. The operations which <tt>tickadj</tt> tries to perform are not guaranteed to work on all Unix machines and may in rare cases cause the kernel to crash.</p> 219c2daa00SOllivier Robert <h4>Command Line Options</h4> 229c2daa00SOllivier Robert <dl> 239c2daa00SOllivier Robert <dt><tt>-a <i>tickadj</i></tt> 249c2daa00SOllivier Robert <dd>Set the kernel variable <tt>tickadj</tt> to the value <i><tt>tickadj</tt></i>specified. 259c2daa00SOllivier Robert <dt><tt>-A</tt> 269c2daa00SOllivier Robert <dd>Set the kernel variable <tt>tickadj</tt> to an internally computed "optimal" value. 279c2daa00SOllivier Robert <dt><tt>-t <i>tick</i></tt> 289c2daa00SOllivier Robert <dd>Set the kernel variable <tt>tick</tt> to the value <i><tt>tick</tt></i> specified. 299c2daa00SOllivier Robert <dt><tt>-s</tt> 309c2daa00SOllivier Robert <dd>Set the kernel variable <tt>dosynctodr</tt> to zero, which disables the hardware time-of-year clock, a prerequisite for running the <tt>ntpd</tt> daemon under SunOS4. 319c2daa00SOllivier Robert <dt><tt>-q</tt> 329c2daa00SOllivier Robert <dd>Normally, <tt>tickadj</tt> is quite verbose about what it is doing. The <tt>-q</tt> flag tells it to shut up about everything except errors. 339c2daa00SOllivier Robert </dl> 349c2daa00SOllivier Robert <h4>Files</h4> 359c2daa00SOllivier Robert <pre> 369c2daa00SOllivier Robert/vmunix 379c2daa00SOllivier Robert 389c2daa00SOllivier Robert/unix 399c2daa00SOllivier Robert 409c2daa00SOllivier Robert/dev/kmem 419c2daa00SOllivier Robert</pre> 429c2daa00SOllivier Robert <h4>Bugs</h4> 439c2daa00SOllivier Robert Fiddling with kernel variables at run time as a part of ordinary operations is a hideous practice which is only necessary to make up for deficiencies in the implementation of <tt>adjtime</tt> in many kernels and/or brokenness of the system clock in some vendors' kernels. It would be much better if the kernels were fixed and the <tt>tickadj</tt> program went away. 449c2daa00SOllivier Robert <hr> 459c2daa00SOllivier Robert <script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> 469c2daa00SOllivier Robert </body> 479c2daa00SOllivier Robert 489c2daa00SOllivier Robert</html>