summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/attimer.4 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man4/attimer.4 3.html')
-rw-r--r--static/freebsd/man4/attimer.4 3.html67
1 files changed, 67 insertions, 0 deletions
diff --git a/static/freebsd/man4/attimer.4 3.html b/static/freebsd/man4/attimer.4 3.html
new file mode 100644
index 00000000..a43f8daf
--- /dev/null
+++ b/static/freebsd/man4/attimer.4 3.html
@@ -0,0 +1,67 @@
+<table class="head">
+ <tr>
+ <td class="head-ltitle">ATTIMER(4)</td>
+ <td class="head-vol">Device Drivers Manual</td>
+ <td class="head-rtitle">ATTIMER(4)</td>
+ </tr>
+</table>
+<div class="manual-text">
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<p class="Pp"><code class="Nm">attimer</code> &#x2014; <span class="Nd">i8254
+ Programmable Interval Timer (AT Timer) driver</span></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<p class="Pp">This driver is a mandatory part of x86 kernels.</p>
+<p class="Pp">The following tunables are settable from the
+ <a class="Xr">loader(8)</a>:</p>
+<dl class="Bl-ohang">
+ <dt id="hint.attimer."><var class="Va">hint.attimer.</var><var class="Ar">X</var><var class="Va">.clock</var></dt>
+ <dd>controls support for the event timer functionality. Setting this value to
+ <code class="Dv">0</code> disables it. The default value is
+ <code class="Dv">1</code>.</dd>
+ <dt id="hint.attimer.~2"><var class="Va">hint.attimer.</var><var class="Ar">X</var><var class="Va">.timecounter</var></dt>
+ <dd>controls support for the time counter functionality. Setting this value to
+ <code class="Dv">0</code> disables it. The default value is
+ <code class="Dv">1</code>.</dd>
+ <dt id="hw.i8254.freq"><var class="Va">hw.i8254.freq</var></dt>
+ <dd>allows overriding the default counter frequency. The same value is also
+ available at run-time via the <var class="Va">machdep.i8254_freq</var>
+ sysctl.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<p class="Pp">This driver uses i8254 Programmable Interval Timer (AT Timer)
+ hardware to supply the kernel with one timecounter and one event timer, and
+ to generate sound tones for the system speaker. This hardware includes three
+ channels. Each channel includes a 16 bit counter which decreases with a
+ known, platform-dependent frequency. Counters can operate in several
+ different modes, including periodic and one-shot. The output of each channel
+ has platform-defined wiring: one channel is wired to the interrupt
+ controller and may be used as event timer, one channel is wired to the
+ speaker and used to generate sound tones, and one timer is reserved for
+ platform purposes.</p>
+<p class="Pp">The <code class="Nm">attimer</code> driver uses a single hardware
+ channel to provide both time counter and event timer functionality. To make
+ this possible, the respective counter must be running in periodic mode. As a
+ result, the one-shot event timer mode is supported only when time counter
+ functionality is disabled.</p>
+<p class="Pp">The event timer provided by the driver is irrelevant to CPU power
+ states.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
+<p class="Pp"><a class="Xr">apic(4)</a>, <a class="Xr">atrtc(4)</a>,
+ <a class="Xr">eventtimers(4)</a>, <a class="Xr">hpet(4)</a>,
+ <a class="Xr">timecounters(4)</a></p>
+</section>
+</div>
+<table class="foot">
+ <tr>
+ <td class="foot-date">May 26, 2014</td>
+ <td class="foot-os">FreeBSD 15.0</td>
+ </tr>
+</table>