diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:43 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:43 -0400 |
| commit | ac5e55f5f2af5b92794c2aded46c6bae85b5f5ed (patch) | |
| tree | 9367490586c84cba28652e443e3166d66c33b0d9 /static/freebsd/man4/acpi_thermal.4 3.html | |
| parent | 253e67c8b3a72b3a4757fdbc5845297628db0a4a (diff) | |
docs: Added All FreeBSD Manuals
Diffstat (limited to 'static/freebsd/man4/acpi_thermal.4 3.html')
| -rw-r--r-- | static/freebsd/man4/acpi_thermal.4 3.html | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/static/freebsd/man4/acpi_thermal.4 3.html b/static/freebsd/man4/acpi_thermal.4 3.html new file mode 100644 index 00000000..aae47629 --- /dev/null +++ b/static/freebsd/man4/acpi_thermal.4 3.html @@ -0,0 +1,129 @@ +<table class="head"> + <tr> + <td class="head-ltitle">ACPI_THERMAL(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">ACPI_THERMAL(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">acpi_thermal</code> — + <span class="Nd">ACPI thermal management subsystem</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 acpi</code></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> +<p class="Pp">The <code class="Nm">acpi_thermal</code> driver provides the + thermal management features of the ACPI module. This driver has a + <a class="Xr">sysctl(8)</a> interface and a <a class="Xr">devd(8)</a> + notification interface. The sysctls export properties of each ACPI thermal + zone object.</p> +<p class="Pp">There can be multiple thermal zones in a system. For example, each + CPU and the enclosure could all be separate thermal zones, each with its own + setpoints and cooling devices. Thermal zones are numbered sequentially in + the order they appear in the AML.</p> +<p class="Pp">The <code class="Nm">acpi_thermal</code> driver also activates the + active cooling system according to each thermal zone's setpoints.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL + VARIABLES</a></h1> +<dl class="Bl-tag"> + <dt id="hw.acpi.thermal.min_runtime"><var class="Va">hw.acpi.thermal.min_runtime</var></dt> + <dd>Number of seconds to continue active cooling once started. A new active + cooling level will not be selected until this interval expires.</dd> + <dt id="hw.acpi.thermal.polling_rate"><var class="Va">hw.acpi.thermal.polling_rate</var></dt> + <dd>Number of seconds between polling the current temperature.</dd> + <dt id="hw.acpi.thermal.user_override"><var class="Va">hw.acpi.thermal.user_override</var></dt> + <dd>If set to 1, allow user override of various setpoints (below). The + original values for these settings are obtained from the BIOS and system + overheating and possible damage could occur if changed. Default is 0 (no + override).</dd> + <dt id="hw.acpi.thermal.tz_d.active"><var class="Va">hw.acpi.thermal.tz%d.active</var></dt> + <dd>Current active cooling system state. If this is non-negative, the + appropriate _AC%d object is running. Set this value to the desired active + cooling level to force the corresponding fan object to the appropriate + level.</dd> + <dt id="hw.acpi.thermal.tz_d.passive_cooling"><var class="Va">hw.acpi.thermal.tz%d.passive_cooling</var></dt> + <dd>If set to 1, passive cooling is enabled. It does cooling without fans + using <a class="Xr">cpufreq(4)</a> as the mechanism for controlling CPU + speed. Default is enabled for tz0 where it is available.</dd> + <dt id="hw.acpi.thermal.tz_d.thermal_flags"><var class="Va">hw.acpi.thermal.tz%d.thermal_flags</var></dt> + <dd>Current thermal zone status. These are bit-masked values.</dd> + <dt id="hw.acpi.thermal.tz_d.temperature"><var class="Va">hw.acpi.thermal.tz%d.temperature</var></dt> + <dd>Current temperature for this zone.</dd> + <dt id="hw.acpi.thermal.tz_d._PSV"><var class="Va">hw.acpi.thermal.tz%d._PSV</var></dt> + <dd>Temperature to start passive cooling by throttling down CPU, etc. This + value can be overridden by the user.</dd> + <dt id="hw.acpi.thermal.tz_d._CR3"><var class="Va">hw.acpi.thermal.tz%d._CR3</var></dt> + <dd>Temperature to start critical suspend to RAM (S3). This value can be + overridden by the user.</dd> + <dt id="hw.acpi.thermal.tz_d._HOT"><var class="Va">hw.acpi.thermal.tz%d._HOT</var></dt> + <dd>Temperature to start critical suspend to disk (S4). This value can be + overridden by the user.</dd> + <dt id="hw.acpi.thermal.tz_d._CRT"><var class="Va">hw.acpi.thermal.tz%d._CRT</var></dt> + <dd>Temperature to start critical shutdown (S5). This value can be overridden + by the user.</dd> + <dt id="hw.acpi.thermal.tz_d._ACx"><var class="Va">hw.acpi.thermal.tz%d._ACx</var></dt> + <dd>Temperatures at which to switch to the corresponding active cooling level. + The lower the _ACx value, the higher the cooling power.</dd> +</dl> +<p class="Pp">All temperatures are printed in Celsius. Values can be set in + Celsius (by providing a trailing "C") or Kelvin (by leaving off + any trailing letter). When setting a value by <a class="Xr">sysctl(8)</a>, + do not specify a trailing decimal (i.e., 90C instead of 90.0C).</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="NOTIFIES"><a class="permalink" href="#NOTIFIES">NOTIFIES</a></h1> +<p class="Pp">Notifies are passed to userland via <a class="Xr">devd(8)</a>. See + <span class="Pa">/etc/devd.conf</span> and <a class="Xr">devd.conf(5)</a> + for examples. The <code class="Nm">acpi_thermal</code> driver sends events + with the following attributes:</p> +<p class="Pp"></p> +<dl class="Bl-tag Bl-compact"> + <dt id="ACPI">system</dt> + <dd><a class="permalink" href="#ACPI"><code class="Li">ACPI</code></a></dd> + <dt id="Thermal">subsystem</dt> + <dd><a class="permalink" href="#Thermal"><code class="Li">Thermal</code></a></dd> + <dt>type</dt> + <dd>The fully qualified thermal zone object path as in the ASL.</dd> + <dt>notify</dt> + <dd>An integer designating the event: + <p class="Pp"></p> + <dl class="Bl-tag Bl-compact"> + <dt id="0x80"><a class="permalink" href="#0x80"><code class="Li">0x80</code></a></dt> + <dd>Current temperature has changed.</dd> + <dt id="0x81"><a class="permalink" href="#0x81"><code class="Li">0x81</code></a></dt> + <dd>One or more trip points (_ACx, _PSV) have changed.</dd> + <dt id="0x82"><a class="permalink" href="#0x82"><code class="Li">0x82</code></a></dt> + <dd>One or more device lists (_ALx, _PSL, _TZD) have changed.</dd> + <dt id="0xcc"><a class="permalink" href="#0xcc"><code class="Li">0xcc</code></a></dt> + <dd>Non-standard notify that the system will shutdown if the temperature + stays above _CRT or _HOT for one more poll cycle.</dd> + </dl> + </dd> +</dl> +</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">acpi(4)</a>, <a class="Xr">cpufreq(4)</a>, + <a class="Xr">acpidump(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">Michael Smith</span></p> +<p class="Pp">This manual page was written by <span class="An">Takanori + Watanabe</span>.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">November 21, 2022</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |
