acpi*.4: Update manual pages for the recent ACPI update.
[dragonfly.git] / share / man / man4 / acpi_thermal.4
index 9613cc1..81c27d8 100644 (file)
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/acpi_thermal.4,v 1.6 2004/02/03 04:18:55 njl Exp $
-.\" $DragonFly: src/share/man/man4/acpi_thermal.4,v 1.3 2008/10/03 10:33:49 swildner Exp $
+.\" $FreeBSD: src/share/man/man4/acpi_thermal.4,v 1.11.8.1 2009/04/15 03:14:26 kensmith Exp $
 .\"
-.Dd October 3, 2008
+.Dd November 11, 2009
 .Dt ACPI_THERMAL 4
 .Os
 .Sh NAME
@@ -54,13 +53,29 @@ The
 .Nm
 driver also activates the active cooling system according to
 each thermal zone's setpoints.
-.Sh SYSCTLS
+.Sh SYSCTL VARIABLES
 .Bl -tag -width indent
+.It Va hw.acpi.thermal.min_runtime
+Number of seconds to continue active cooling once started.
+A new active cooling level will not be selected until this interval expires.
+.It Va hw.acpi.thermal.polling_rate
+Number of seconds between polling the current temperature.
+.It Va hw.acpi.thermal.user_override
+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).
 .It Va hw.acpi.thermal.tz%d.active
 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.
+.It Va hw.acpi.thermal.tz%d.passive_cooling
+If set to 1, passive cooling is enabled.
+It does cooling without fans using
+.Xr cpufreq 4
+as the mechanism for controlling CPU speed.
+Default is enabled for tz0 where it is available.
 .It Va hw.acpi.thermal.tz%d.thermal_flags
 Current thermal zone status.
 These are bit-masked values.
@@ -68,25 +83,26 @@ These are bit-masked values.
 Current temperature for this zone.
 .It Va hw.acpi.thermal.tz%d._PSV
 Temperature to start passive cooling by throttling down CPU, etc.
+This value can be overridden by the user.
 .It Va hw.acpi.thermal.tz%d._HOT
 Temperature to start critical suspend to disk (S4).
+This value can be overridden by the user.
 .It Va hw.acpi.thermal.tz%d._CRT
 Temperature to start critical shutdown (S5).
+This value can be overridden by the user.
 .It Va hw.acpi.thermal.tz%d._ACx
 Temperatures at which to switch to the corresponding active cooling
 level.
-For instance, values of
-.Qq Li "3200 3100"
-mean to switch on _AC0 at 320.0K
-and _AC1 at 310.0K.
 The lower the _ACx value, the higher the cooling power.
 .El
 .Pp
-All temperatures are represented in tenths of a Kelvin.
-For example, 300.0K is represented by the integer 3000.
-To convert to units of Centigrade,
-the formula is
-.Li "(x - 2731.5) / 10" .
+All temperatures are printed in Celsius.
+Values can be set in Celsius (by providing a trailing
+.Qq C )
+or Kelvin (by leaving off any trailing letter).
+When setting a value by
+.Xr sysctl 8 ,
+do not specify a trailing decimal (i.e., 90C instead of 90.0C).
 .Sh NOTIFIES
 Notifies are passed to userland via
 .Xr devd 8 .
@@ -123,6 +139,7 @@ stays above _CRT or _HOT for one more poll cycle.
 .El
 .Sh SEE ALSO
 .Xr acpi 4 ,
+.\".Xr cpufreq 4 ,
 .Xr acpidump 8
 .Sh AUTHORS
 .An -nosplit