diff options
Diffstat (limited to 'static/freebsd/man4/man4.i386/apm.4 3.html')
| -rw-r--r-- | static/freebsd/man4/man4.i386/apm.4 3.html | 187 |
1 files changed, 0 insertions, 187 deletions
diff --git a/static/freebsd/man4/man4.i386/apm.4 3.html b/static/freebsd/man4/man4.i386/apm.4 3.html deleted file mode 100644 index c92c4fbb..00000000 --- a/static/freebsd/man4/man4.i386/apm.4 3.html +++ /dev/null @@ -1,187 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">APM(4)</td> - <td class="head-vol">Device Drivers Manual (i386)</td> - <td class="head-rtitle">APM(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">apm</code> — <span class="Nd">APM BIOS - interface</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp"><code class="Cd">device apm</code></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DEPRECATION_NOTICE"><a class="permalink" href="#DEPRECATION_NOTICE">DEPRECATION - NOTICE</a></h1> -<p class="Pp">This driver is scheduled for removal prior to the release of - <span class="Ux">FreeBSD 13.0</span>.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp"><code class="Nm">apm</code> is an interface to the Intel / - Microsoft APM (Advanced Power Management) BIOS on laptop PCs.</p> -<p class="Pp"><code class="Nm">apm</code> provides the following power - management functions.</p> -<ol class="Bl-enum Bd-indent"> - <li>When the system wakes up from suspended mode, <code class="Nm">apm</code> - adjusts the system clock to RTC.</li> - <li>When the system wakes up from suspended mode, <code class="Nm">apm</code> - passes a message to <a class="Xr">syslogd(8)</a> comprising of system - wakeup time and elapsed time during suspended mode.</li> - <li><code class="Nm">apm</code> slows CPU clock when there are no system - activities (runnable processes, interrupts, etc.). This function is - available only on systems whose APM supports CPU idling.</li> - <li><code class="Nm">apm</code> exports an application interface as a - character device. Applications can control APM, or retrieve APM status - information via this interface. <code class="Nm">apm</code> exports the - following interfaces. These symbols are defined in - <code class="In"><<a class="In">machine/apm_bios.h</a>></code>. - <div class="Bd-indent"> - <dl class="Bl-tag"> - <dt id="APMIO_SUSPEND"><a class="permalink" href="#APMIO_SUSPEND"><b class="Sy">APMIO_SUSPEND</b></a></dt> - <dd>Suspend system.</dd> - <dt id="APMIO_GET"><a class="permalink" href="#APMIO_GET"><b class="Sy">APMIO_GET</b></a></dt> - <dd>Get power management information.</dd> - <dt id="APMIO_ENABLE"><a class="permalink" href="#APMIO_ENABLE"><b class="Sy">APMIO_ENABLE</b></a></dt> - <dd style="width: auto;"> </dd> - <dt id="APMIO_DISABLE"><a class="permalink" href="#APMIO_DISABLE"><b class="Sy">APMIO_DISABLE</b></a></dt> - <dd>Enable / Disable power management.</dd> - <dt id="APMIO_HALTCPU"><a class="permalink" href="#APMIO_HALTCPU"><b class="Sy">APMIO_HALTCPU</b></a></dt> - <dd style="width: auto;"> </dd> - <dt id="APMIO_NOTHALTCPU"><a class="permalink" href="#APMIO_NOTHALTCPU"><b class="Sy">APMIO_NOTHALTCPU</b></a></dt> - <dd>Control execution of HLT in the kernel context switch routine.</dd> - <dt id="APMIO_GETPWSTATUS"><a class="permalink" href="#APMIO_GETPWSTATUS"><b class="Sy">APMIO_GETPWSTATUS</b></a></dt> - <dd>Get per battery information. - <p class="Pp">Some APM implementations execute the HLT (Halt CPU until - an interrupt occurs) instruction in the “<i class="Em">Idle - CPU</i>” call, while others do not. Thus enabling this may - result in redundant HLT executions because - “<i class="Em">Idle CPU</i>” is called from the kernel - context switch routine that inherently executes HLT. This may reduce - peak system performance.</p> - <p class="Pp">Also the system hangs up if HLT instruction is disabled in - the kernel context switch routine, and if the APM implementation of - the machine does not execute HLT in “<i class="Em">Idle - CPU</i>”. On some implementations that do not support CPU - clock slowdown, APM might not execute HLT. - <code class="Nm">apm</code> disables - <b class="Sy">APMIO_NOTHALTCPU</b> operation on such machines.</p> - <p class="Pp">The current version of <code class="Nm">apm</code> does - not call “<i class="Em">Idle CPU</i>” from the kernel - context switch routine if clock slowdown is not supported, and it - executes HLT instruction by default. Therefore, there is no need to - use these two operations in most cases.</p> - </dd> - </dl> - </div> - <p class="Pp">These interfaces are used by <a class="Xr">apm(8)</a>.</p> - </li> - <li><code class="Nm">apm</code> polls APM events and handles the following - events. - <table class="Bl-column"> - <tr id="Name"> - <td><a class="permalink" href="#Name"><b class="Sy">Name</b></a></td> - <td><a class="permalink" href="#Action"><b class="Sy" id="Action">Action</b></a></td> - <td><a class="permalink" href="#Description"><b class="Sy" id="Description">Description</b></a></td> - </tr> - <tr id="PMEV_STANDBYREQ"> - <td><a class="permalink" href="#PMEV_STANDBYREQ"><code class="Dv">PMEV_STANDBYREQ</code></a></td> - <td><a class="permalink" href="#suspend"><span class="No" id="suspend">suspend - system</span></a></td> - <td>standby request</td> - </tr> - <tr id="PMEV_SUSPENDREQ"> - <td><a class="permalink" href="#PMEV_SUSPENDREQ"><code class="Dv">PMEV_SUSPENDREQ</code></a></td> - <td><a class="permalink" href="#suspend~2"><span class="No" id="suspend~2">suspend - system</span></a></td> - <td>suspend request</td> - </tr> - <tr id="PMEV_USERSUSPENDREQ"> - <td><a class="permalink" href="#PMEV_USERSUSPENDREQ"><code class="Dv">PMEV_USERSUSPENDREQ</code></a></td> - <td><a class="permalink" href="#suspend~3"><span class="No" id="suspend~3">suspend - system</span></a></td> - <td>user suspend request</td> - </tr> - <tr id="PMEV_CRITSUSPEND"> - <td><a class="permalink" href="#PMEV_CRITSUSPEND"><code class="Dv">PMEV_CRITSUSPEND</code></a></td> - <td><a class="permalink" href="#suspend~4"><span class="No" id="suspend~4">suspend - system</span></a></td> - <td>critical suspend request</td> - </tr> - <tr id="PMEV_NORMRESUME"> - <td><a class="permalink" href="#PMEV_NORMRESUME"><code class="Dv">PMEV_NORMRESUME</code></a></td> - <td><a class="permalink" href="#resume"><span class="No" id="resume">resume - system</span></a></td> - <td>normal resume</td> - </tr> - <tr id="PMEV_CRITRESUME"> - <td><a class="permalink" href="#PMEV_CRITRESUME"><code class="Dv">PMEV_CRITRESUME</code></a></td> - <td><a class="permalink" href="#resume~2"><span class="No" id="resume~2">resume - system</span></a></td> - <td>critical resume</td> - </tr> - <tr id="PMEV_STANDBYRESUME"> - <td><a class="permalink" href="#PMEV_STANDBYRESUME"><code class="Dv">PMEV_STANDBYRESUME</code></a></td> - <td><a class="permalink" href="#resume~3"><span class="No" id="resume~3">resume - system</span></a></td> - <td>standby resume</td> - </tr> - <tr id="PMEV_BATTERYLOW"> - <td><a class="permalink" href="#PMEV_BATTERYLOW"><code class="Dv">PMEV_BATTERYLOW</code></a></td> - <td><a class="permalink" href="#notify"><span class="No" id="notify">notify - message</span></a></td> - <td>battery low</td> - </tr> - <tr id="PMEV_UPDATETIME"> - <td><a class="permalink" href="#PMEV_UPDATETIME"><code class="Dv">PMEV_UPDATETIME</code></a></td> - <td><a class="permalink" href="#adjust"><span class="No" id="adjust">adjust - clock</span></a></td> - <td>update time</td> - </tr> - </table> - </li> -</ol> -</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">apm(8)</a>, <a class="Xr">zzz(8)</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> -<p class="Pp"><span class="An">Tatsumi Hosokawa</span> - <<a class="Mt" href="mailto:hosokawa@jp.FreeBSD.org">hosokawa@jp.FreeBSD.org</a>></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> -<p class="Pp">WARNING! Many, if not most, of the implementations of APM-bios in - laptops today are buggy. You may be putting your LCD-display and batteries - at a risk by using this interface. (The reason this is not a problem for - MS-Windows is that they use the real-mode interface.) If you see any weird - behavior from your system with this code in use, unplug the power and - batteries ASAP, if not immediately, and disable this code.</p> -<p class="Pp">We are very interested in getting this code working, so please - send your observations of any anomalous behavior to us.</p> -<p class="Pp">When <code class="Nm">apm</code> is active, calling the BIOS setup - routine by using hot-keys, may cause serious trouble when resuming the - system. BIOS setup programs should be called during bootstrap, or from - DOS.</p> -<p class="Pp">Some APM implementations cannot handle events such as pushing the - power button or closing the cover. On such implementations, the system - <var class="Ar">must</var> be suspended <var class="Ar">only</var> by using - <a class="Xr">apm(8)</a> or <a class="Xr">zzz(8)</a>.</p> -<p class="Pp">Disk spin-down, LCD backlight control, and power on demand have - not been supported on the current version.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">November 1, 1994</td> - <td class="foot-os">FreeBSD 15.0</td> - </tr> -</table> |