~ubuntu-branches/debian/squeeze/ntp/squeeze-201010051545

« back to all changes in this revision

Viewing changes to html/tickadj.htm

  • Committer: Bazaar Package Importer
  • Author(s): Matt Zimmerman
  • Date: 2004-10-11 16:10:27 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20041011161027-icyjbji8ujym633o
Tags: 1:4.2.0a-10ubuntu2
Use ntp.ubuntulinux.org instead of pool.ntp.org

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2
 
<html>
3
 
<head>
4
 
<meta name="generator" content="HTML Tidy, see www.w3.org">
5
 
<title>tickadj - set time-related kernel variables</title>
6
 
</head>
7
 
<body>
8
 
<h3><tt>tickadj</tt> - set time-related kernel variables</h3>
9
 
 
10
 
<hr>
11
 
<h4>Synopsis</h4>
12
 
 
13
 
<tt>tickadj [ -Aqs ] [ -a <i>tickadj</i> ] [ -t <i>tick</i> ]</tt> 
14
 
 
15
 
<h4>Description</h4>
16
 
 
17
 
The <tt>tickadj</tt> program reads, and optionally modifies,
18
 
several timekeeping-related variables in the running kernel in some
19
 
machines, via <tt>/dev/kmem</tt>. The particular variables it is
20
 
concerned with are <tt>tick</tt>, which is the number of
21
 
microseconds added to the system time during a clock interrupt,
22
 
<tt>tickadj</tt>, which sets the slew rate and resolution used by
23
 
the <tt>adjtime</tt> system call, and <tt>dosynctodr</tt>, which
24
 
indicates to the kernels on some machines whether they should
25
 
internally adjust the system clock to keep it in line with
26
 
time-of-day clock or not. 
27
 
 
28
 
<p>Note that this program does NOT work in some kernels, in
29
 
particular Solaris 2.6 or later. See the <a href=
30
 
"solaris-dosynctodr.html">report</a>.</p>
31
 
 
32
 
<p>By default, with no arguments, <tt>tickadj</tt> reads the
33
 
variables of interest in the kernel and displays them. At the same
34
 
time, it determines an "optimal" value for the value of the <tt>
35
 
tickadj</tt> variable if the intent is to run the <tt>ntpd</tt>
36
 
Network Time Protocol (NTP) daemon, and prints this as well. Since
37
 
the operation of <tt>tickadj</tt> when reading the kernel mimics
38
 
the operation of similar parts of the <tt>ntpd</tt> program fairly
39
 
closely, this can be useful when debugging problems with <tt>
40
 
ntpd</tt>.</p>
41
 
 
42
 
<p>Note that <tt>tickadj</tt> should be run with some caution when
43
 
being used for the first time on different types of machines. The
44
 
operations which <tt>tickadj</tt> tries to perform are not
45
 
guaranteed to work on all Unix machines and may in rare cases cause
46
 
the kernel to crash.</p>
47
 
 
48
 
<h4>Command Line Options</h4>
49
 
 
50
 
<dl>
51
 
<dt><tt>-a <i>tickadj</i></tt></dt>
52
 
 
53
 
<dd>Set the kernel variable <tt>tickadj</tt> to the value <i><tt>
54
 
tickadj</tt></i>specified.</dd>
55
 
 
56
 
<dt><tt>-A</tt></dt>
57
 
 
58
 
<dd>Set the kernel variable <tt>tickadj</tt> to an internally
59
 
computed "optimal" value.</dd>
60
 
 
61
 
<dt><tt>-t <i>tick</i></tt></dt>
62
 
 
63
 
<dd>Set the kernel variable <tt>tick</tt> to the value <i><tt>
64
 
tick</tt></i> specified.</dd>
65
 
 
66
 
<dt><tt>-s</tt></dt>
67
 
 
68
 
<dd>Set the kernel variable <tt>dosynctodr</tt> to zero, which
69
 
disables the hardware time-of-year clock, a prerequisite for
70
 
running the <tt>ntpd</tt> daemon under SunOS4.</dd>
71
 
 
72
 
<dt><tt>-q</tt></dt>
73
 
 
74
 
<dd>Normally, <tt>tickadj</tt> is quite verbose about what it is
75
 
doing. The <tt>-q</tt> flag tells it to shut up about everything
76
 
except errors.</dd>
77
 
</dl>
78
 
 
79
 
<h4>Files</h4>
80
 
 
81
 
<pre>
82
 
/vmunix
83
 
 
84
 
/unix
85
 
 
86
 
/dev/kmem
87
 
</pre>
88
 
 
89
 
<h4>Bugs</h4>
90
 
 
91
 
Fiddling with kernel variables at run time as a part of ordinary
92
 
operations is a hideous practice which is only necessary to make up
93
 
for deficiencies in the implementation of <tt>adjtime</tt> in many
94
 
kernels and/or brokenness of the system clock in some vendors'
95
 
kernels. It would be much better if the kernels were fixed and the
96
 
<tt>tickadj</tt> program went away.&nbsp; 
97
 
 
98
 
<hr>
99
 
<a href="index.htm"><img align="left" src="pic/home.gif" alt=
100
 
"gif"></a>
101
 
<address><a href="mailto:mills@udel.edu">David L. Mills
102
 
&lt;mills@udel.edu&gt;</a></address>
103
 
</body>
104
 
</html>
105