[src/trunk]: src Add odcm(4).

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/47fb11050274
branches:  trunk
changeset: 762872:47fb11050274
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Fri Mar 04 05:56:49 2011 +0000

description:
Add odcm(4).

diffstat:

 distrib/sets/lists/man/mi        |   5 ++-
 share/man/man4/man4.x86/Makefile |   4 +-
 share/man/man4/man4.x86/odcm.4   |  73 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 79 insertions(+), 3 deletions(-)

diffs (123 lines):

diff -r 2ad9403f61ee -r 47fb11050274 distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Fri Mar 04 05:02:47 2011 +0000
+++ b/distrib/sets/lists/man/mi Fri Mar 04 05:56:49 2011 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1298 2011/03/02 22:25:54 tron Exp $
+# $NetBSD: mi,v 1.1299 2011/03/04 05:56:49 jruoho Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -1793,6 +1793,7 @@
 ./usr/share/man/cat4/x86/hpet.0                        man-sys-catman          .cat
 ./usr/share/man/cat4/x86/ichlpcib.0            man-sys-catman          .cat
 ./usr/share/man/cat4/x86/ioapic.0              man-sys-catman          .cat
+./usr/share/man/cat4/x86/odcm.0                        man-sys-catman          .cat
 ./usr/share/man/cat4/x86/powernow.0            man-sys-catman          .cat
 ./usr/share/man/cat4/xbd.0                     man-sys-catman          .cat
 ./usr/share/man/cat4/xbdback.0                 man-sys-catman          .cat
@@ -4485,6 +4486,7 @@
 ./usr/share/man/html4/x86/hpet.html            man-sys-htmlman         html
 ./usr/share/man/html4/x86/ichlpcib.html                man-sys-htmlman         html
 ./usr/share/man/html4/x86/ioapic.html          man-sys-htmlman         html
+./usr/share/man/html4/x86/odcm.html            man-sys-htmlman         html
 ./usr/share/man/html4/x86/powernow.html                man-sys-htmlman         html
 ./usr/share/man/html4/xbd.html                 man-sys-htmlman         html
 ./usr/share/man/html4/xbdback.html             man-sys-htmlman         html
@@ -7112,6 +7114,7 @@
 ./usr/share/man/man4/x86/hpet.4                        man-sys-man             .man
 ./usr/share/man/man4/x86/ichlpcib.4            man-sys-man             .man
 ./usr/share/man/man4/x86/ioapic.4              man-sys-man             .man
+./usr/share/man/man4/x86/odcm.4                        man-sys-man             .man
 ./usr/share/man/man4/x86/powernow.4            man-sys-man             .man
 ./usr/share/man/man4/xbd.4                     man-sys-man             .man
 ./usr/share/man/man4/xbdback.4                 man-sys-man             .man
diff -r 2ad9403f61ee -r 47fb11050274 share/man/man4/man4.x86/Makefile
--- a/share/man/man4/man4.x86/Makefile  Fri Mar 04 05:02:47 2011 +0000
+++ b/share/man/man4/man4.x86/Makefile  Fri Mar 04 05:56:49 2011 +0000
@@ -1,7 +1,7 @@
-#      $NetBSD: Makefile,v 1.8 2011/02/24 11:29:46 jruoho Exp $
+#      $NetBSD: Makefile,v 1.9 2011/03/04 05:56:49 jruoho Exp $
 
 MAN=   amdpcib.4 balloon.4 coretemp.4 est.4 \
-       fwhrng.4 hpet.4 ichlpcib.4 ioapic.4 powernow.4
+       fwhrng.4 hpet.4 ichlpcib.4 ioapic.4 odcm.4 powernow.4
 
 MANSUBDIR=/x86
 
diff -r 2ad9403f61ee -r 47fb11050274 share/man/man4/man4.x86/odcm.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.x86/odcm.4    Fri Mar 04 05:56:49 2011 +0000
@@ -0,0 +1,73 @@
+.\" $NetBSD: odcm.4,v 1.1 2011/03/04 05:56:49 jruoho Exp $
+.\"
+.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen%iki.fi@localhost>
+.\" 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. Neither the name of the author nor the names of any
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 March 4, 2011
+.Dt ODCM 4
+.Os
+.Sh NAME
+.Nm odcm
+.Nd On-demand Clock Modulation
+.Sh SYNOPSIS
+.Cd "odcm0 at cpu0"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for changing the duty cycle of a
+.Tn CPU .
+This is sometimes known as
+.Dq on-demand clock modulation
+.Pq Tn ODCM .
+Refer to
+.Xr acpicpu 4
+for additional details about
+.Tn ODCM .
+.Pp
+The following
+.Xr sysctl 8
+variables are available with
+.Nm :
+.Bl -tag -width "machdep.clockmod.available " -offset indent
+.It Ic machdep.clockmod.target
+The target duty cycle of all
+.Tn CPUs .
+The values range from 7 (100 %) to 1 (approximately 13 %).
+.It Ic machdep.clockmod.current
+The current duty cycle of
+.Tn CPUs .
+.It Ic machdep.clockmod.available
+A list of available duty cycles.
+.El
+.Sh SEE ALSO
+.Xr acpicpu 4 ,
+.Xr est 4 ,
+.Xr powernow 4
+.Sh CAVEATS
+.Tn ODCM
+is meant for short-term thermal management, not power management.
+There is usually no reason for a system administrator
+to change the values manually.
+Lowering the duty cycle may dramatically decrease
+performance and responsiveness of the system.