From owner-freebsd-current@FreeBSD.ORG Wed Jun 13 03:10:02 2012 Return-Path: Delivered-To: freebsd-current@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E5606106566C for ; Wed, 13 Jun 2012 03:10:02 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id 166468FC0A for ; Wed, 13 Jun 2012 03:09:59 +0000 (UTC) Received: from alph.allbsd.org (p4242-ipbf1504funabasi.chiba.ocn.ne.jp [118.7.211.242]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id q5D39bPY051219; Wed, 13 Jun 2012 12:09:49 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [IPv6:::1]) (authenticated bits=0) by alph.allbsd.org (8.14.4/8.14.4) with ESMTP id q5D39Z7g082235; Wed, 13 Jun 2012 12:09:36 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Wed, 13 Jun 2012 12:06:00 +0900 (JST) Message-Id: <20120613.120600.2188772873180778735.hrs@allbsd.org> To: seanbru@yahoo-inc.com From: Hiroki Sato In-Reply-To: <1339531057.42366.2.camel@powernoodle.corp.yahoo.com> References: <1338922510.10539.8.camel@powernoodle-l7.corp.yahoo.com> <1338930799.10539.12.camel@powernoodle-l7.corp.yahoo.com> <1339531057.42366.2.camel@powernoodle.corp.yahoo.com> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 23.4 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart0(Wed_Jun_13_12_06_00_2012_124)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Wed, 13 Jun 2012 12:09:50 +0900 (JST) X-Spam-Status: No, score=-98.8 required=13.0 tests=CONTENT_TYPE_PRESENT, RCVD_IN_RP_RNBL,USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org Cc: freebsd-current@FreeBSD.org Subject: Re: est man page X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 13 Jun 2012 03:10:03 -0000 ----Security_Multipart0(Wed_Jun_13_12_06_00_2012_124)-- Content-Type: Multipart/Mixed; boundary="--Next_Part(Wed_Jun_13_12_06_00_2012_134)--" Content-Transfer-Encoding: 7bit ----Next_Part(Wed_Jun_13_12_06_00_2012_134)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sean Bruno wrote in <1339531057.42366.2.camel@powernoodle.corp.yahoo.com>: se> On Tue, 2012-06-05 at 14:13 -0700, Sean Bruno wrote: se> > On Tue, 2012-06-05 at 11:55 -0700, Sean Bruno wrote: se> se> se> se> allrighty, after some doc reviews by Glen, I've thwacked together a se> quick and dirty est(4). se> se> Any objections? se> se> http://people.freebsd.org/~sbruno/est_man.txt Looks good. Attached a diff for some small fixes. se> view via: se> groff -S -P-h -Wall -mtty-char -man -Tascii est_man.txt | less % man $PWD/est_man.txt may be easier :) -- Hiroki ----Next_Part(Wed_Jun_13_12_06_00_2012_134)-- Content-Type: Text/X-Patch; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="est_man.txt.diff" --- est_man.txt.orig 2012-06-13 11:06:23.000000000 +0900 +++ est_man.txt 2012-06-13 11:39:12.000000000 +0900 @@ -23,6 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" $FreeBSD$ .\" .Dd June 12, 2012 .Dt EST 4 @@ -36,7 +37,7 @@ configuration file: .Bd -ragged -offset indent .Cd "device cpufreq" -.Ep +.Ed .Sh DESCRIPTION The .Nm @@ -72,12 +73,12 @@ .Sh DIAGNOSTICS .Bl -diag .It "est%d: on cpu%d" -.It \& +.Pp Indicates normal startup of this interface. .It "est: CPU supports Enhanced Speedstep, but is not recognized." .It "est: cpu_vendor GenuineIntel, msr 471c471c0600471c" .It "device_attach: est2 attach returned 6" -.It \& +.Pp Indicates all attempts to attach to this interface have failed. This usually indicates and improper BIOS setting restricting O/S control of the CPU speeds. Consult your BIOS documentation for @@ -87,12 +88,13 @@ .Nm is only found on supported Intel CPUs. .Sh SEE ALSO -.Xr cpufreq 4 , +.Xr cpufreq 4 .Sh SUPPORT For general information and support, go to the Intel 64 and IA-32 Architectures Software Developer Manuals site. .Pa http://www.intel.com/content/www/us/en/processors/architectures-software-developer-manuals.html +.Sh AUTHORS .Pp This manual page was written by .An Sean Bruno Aq sbruno@FreeBSD.org . ----Next_Part(Wed_Jun_13_12_06_00_2012_134)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="est_man.txt" .\" .\" Copyright (c) 2012 Sean Bruno .\" 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 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 AUTHOR 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. .\" .\" $FreeBSD$ .\" .Dd June 12, 2012 .Dt EST 4 .Os .Sh NAME .Nm est .Nd Enhanced Speedstep Technology .Sh SYNOPSIS To compile this capability into your kernel place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device cpufreq" .Ed .Sh DESCRIPTION The .Nm interface that provides support for the Intel Enhanced Speedstep Technology .Pp Note that the .Nm driver is automatically loaded by the .Xr cpufreq 4 driver. .Sh LOADER TUNABLES The .Nm interface is intended to allow .Xr cpufreq 4 to access and implement Intel Enhanced SpeedStep Technology via .Xr acpi 4 and the acpi_perf interface accessors. If the default settings are not optimal, the following sysctls can be used to modify or monitor .Nm behavior. .Bl -tag -width indent .It hw.est.msr_info Attempt to infer information from direct probing of the msr. Should only be used in diagnostic cases. .Pq default 0 .It hw.est.strict Do not allow different cpus to be set to different frequencies. It appears that this will only work on i386 systems. .Pq default 0 .El .Sh DIAGNOSTICS .Bl -diag .It "est%d: on cpu%d" .Pp Indicates normal startup of this interface. .It "est: CPU supports Enhanced Speedstep, but is not recognized." .It "est: cpu_vendor GenuineIntel, msr 471c471c0600471c" .It "device_attach: est2 attach returned 6" .Pp Indicates all attempts to attach to this interface have failed. This usually indicates and improper BIOS setting restricting O/S control of the CPU speeds. Consult your BIOS documentation for more details. .El .Sh COMPATIBILITY .Nm is only found on supported Intel CPUs. .Sh SEE ALSO .Xr cpufreq 4 .Sh SUPPORT For general information and support, go to the Intel 64 and IA-32 Architectures Software Developer Manuals site. .Pa http://www.intel.com/content/www/us/en/processors/architectures-software-developer-manuals.html .Sh AUTHORS .Pp This manual page was written by .An Sean Bruno Aq sbruno@FreeBSD.org . ----Next_Part(Wed_Jun_13_12_06_00_2012_134)---- ----Security_Multipart0(Wed_Jun_13_12_06_00_2012_124)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (FreeBSD) iEYEABECAAYFAk/YA5gACgkQTyzT2CeTzy2f+QCeK647IyzT3zPflyWR7RHxd5zy 7J8AoNVXPQ7UpA4fhiqkQ49AJVAXf99z =HuMn -----END PGP SIGNATURE----- ----Security_Multipart0(Wed_Jun_13_12_06_00_2012_124)----