Re: enhanced speed step on AMD64

[Iain Hibbert <plunky%rya-online.net@localhost>]

On Sun, 23 May 2010, Iain Hibbert wrote:

> (an est(4) manpage would be nice)

how does the attached look?

iain

Index: share/man/man4/man4.i386/Makefile
===================================================================
RCS file: /cvsroot/src/share/man/man4/man4.i386/Makefile,v
retrieving revision 1.73
diff -u -r1.73 Makefile
--- share/man/man4/man4.i386/Makefile   10 Apr 2010 17:55:25 -0000      1.73
+++ share/man/man4/man4.i386/Makefile   23 May 2010 09:58:40 -0000
@@ -3,7 +3,7 @@
 
 MAN=   apm.4 autoconf.4 \
        cmos.4 console.4 \
-       elanpar.4 elanpex.4 elansc.4 \
+       elanpar.4 elanpex.4 elansc.4 est.4 \
        fdc.4 \
        gcscide.4 gcscpcib.4 geodewdog.4 geodecntr.4 glxsb.4 gscpcib.4 \
        intro.4 io.4 lms.4 lpt.4 mem.4 mms.4 npx.4 ndis.4 \
Index: share/man/man4/man4.i386/est.4
===================================================================
RCS file: share/man/man4/man4.i386/est.4
diff -N share/man/man4/man4.i386/est.4
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ share/man/man4/man4.i386/est.4      23 May 2010 09:58:40 -0000
@@ -0,0 +1,76 @@
+.\" $NetBSD: est.4$
+.\"
+.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd May 23, 2010
+.Dt EST 4
+.Os
+.Sh NAME
+.Nm est
+.Nd Enhanced SpeedStep Technology
+.Sh SYNOPSIS
+.Cd options Dv ENHANCED_SPEEDSTEP
+.Cd options Dv EST_FREQ_USERWRITE
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the
+.Qq Enhanced SpeedStep Technology
+present in newer
+.Tn Intel
+CPUs.
+When the CPU supports it, the driver will create
+.Sq est
+sysctl nodes under the
+.Sq machdep
+tree, comprising
+.Bl -tag -width machdep
+.It machdep.est.frequency.target
+This read-write value allows setting of the desired CPU frequency. When the
+.Dv EST_FREQ_USERWRITE
+kernel option is defined, any user will be permitted to write this value,
+otherwise only the super-user will succeed.
+.It machdep.est.frequency.current
+This readonly value shows the current CPU frequency.
+.It machdep.est.frequency.available
+This readonly value shows the available CPU frequencies.
+.El
+.Pp
+The
+.Pa pkgsrc/sysutils/estd
+package can be used to actively manage the CPU frequency according
+to system load.
+.Sh DIAGNOSTICS
+The
+.Nm
+driver will print debug output to the console if the
+.Dv AB_DEBUG
+is set, by passing
+.Fl x
+to
+.Xr boot 8 .
+.Sh SEE ALSO
+.Xr options 4 ,
+.Xr boot 8
Index: distrib/sets/lists/man/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/man/mi,v
retrieving revision 1.1210
diff -u -r1.1210 mi
--- distrib/sets/lists/man/mi   22 May 2010 18:56:00 -0000      1.1210
+++ distrib/sets/lists/man/mi   23 May 2010 09:58:51 -0000
@@ -1045,6 +1045,7 @@
 ./usr/share/man/cat4/i386/elanpar.0            man-sys-catman          .cat
 ./usr/share/man/cat4/i386/elanpex.0            man-sys-catman          .cat
 ./usr/share/man/cat4/i386/elansc.0             man-sys-catman          .cat
+./usr/share/man/cat4/i386/est.0                        man-sys-catman          
.cat
 ./usr/share/man/cat4/i386/fdc.0                        man-sys-catman          
.cat
 ./usr/share/man/cat4/i386/gcscide.0            man-sys-catman          .cat
 ./usr/share/man/cat4/i386/gcscpcib.0           man-sys-catman          .cat
@@ -3693,6 +3694,7 @@
 ./usr/share/man/html4/i386/elanpar.html                man-sys-htmlman         
html
 ./usr/share/man/html4/i386/elanpex.html                man-sys-htmlman         
html
 ./usr/share/man/html4/i386/elansc.html         man-sys-htmlman         html
+./usr/share/man/html4/i386/est.html            man-sys-htmlman         html
 ./usr/share/man/html4/i386/fdc.html            man-sys-htmlman         html
 ./usr/share/man/html4/i386/gcscide.html                man-sys-htmlman         
html
 ./usr/share/man/html4/i386/gcscpcib.html       man-sys-htmlman         html
@@ -6143,6 +6145,7 @@
 ./usr/share/man/man4/i386/elanpar.4            man-sys-man             .man
 ./usr/share/man/man4/i386/elanpex.4            man-sys-man             .man
 ./usr/share/man/man4/i386/elansc.4             man-sys-man             .man
+./usr/share/man/man4/i386/est.4                        man-sys-man             
.man
 ./usr/share/man/man4/i386/fdc.4                        man-sys-man             
.man
 ./usr/share/man/man4/i386/gcscide.4            man-sys-man             .man
 ./usr/share/man/man4/i386/gcscpcib.4           man-sys-man             .man