From: jmc <jmc@openbsd.org>
Date: Sat, 11 May 2024 20:35:13 +0000 (+0000)
Subject: sync the cpu(4) pages for i386/amd64:
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=95218b4ed6abede86e161101874341a8c70247af;p=openbsd

sync the cpu(4) pages for i386/amd64:

- remove section headers. in a document little over one screenful in size,
three section headers within DESCRIPTION seems greedy
- mark up sysctl names
- use the more general hw.sensors sysctl name to show cpu temp. the previously
suggested hw.sensors.cpu*.temp0 is no longer universal
---

diff --git a/share/man/man4/man4.amd64/cpu.4 b/share/man/man4/man4.amd64/cpu.4
index e8d1e89c08b..9806f229efd 100644
--- a/share/man/man4/man4.amd64/cpu.4
+++ b/share/man/man4/man4.amd64/cpu.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cpu.4,v 1.8 2018/07/15 18:04:37 fcambus Exp $
+.\"	$OpenBSD: cpu.4,v 1.9 2024/05/11 20:35:13 jmc Exp $
 .\"
 .\" Copyright (c) 2004 Ted Unangst
 .\" All rights reserved.
@@ -23,7 +23,7 @@
 .\" (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 $Mdocdate: July 15 2018 $
+.Dd $Mdocdate: May 11 2024 $
 .Dt CPU 4 amd64
 .Os
 .Sh NAME
@@ -35,15 +35,19 @@
 .Sh DESCRIPTION
 Several processor models have additional features that extend their base
 functionality, such as power and frequency control or thermal monitoring.
-.Sh FREQUENCY CONTROL
+.Pp
 The
 .Xr sysctl 2
-hw.cpuspeed returns the current operating frequency of the processor,
+.Va hw.cpuspeed
+returns the current operating frequency of the processor,
 though on some processors this value may be only an approximation.
-If possible, speed may be adjusted by altering hw.setperf from 0 to 100,
+If possible, speed may be adjusted by altering
+.Va hw.setperf
+from 0 to 100,
 representing percentage of maximum speed.
-There are several possible implementations for setperf, all transparent
-to the user:
+.Pp
+There are several possible implementations for speed adjustment,
+all transparent to the user:
 .Bl -tag -width tenletters
 .It EST
 Enhanced SpeedStep found on Intel and VIA processors,
@@ -52,20 +56,19 @@ offering frequency scaling with numerous positions.
 Found on various AMD processors.
 It currently only supports a limited set of models in the K8 families.
 .El
-.Sh INSTRUCTION SET EXTENSIONS
-The presence of extended instruction sets can be determined by the
-sysctl machdep.
+.Pp
+The presence of extended instruction sets can be determined by the sysctl
+.Va machdep :
 .Bl -tag -width "tenletters"
 .It xcrypt
 Supports the VIA AES encryption instruction set.
 If this is supported,
 the libcrypto EVP AES functions automatically use this support.
 .El
-.Sh THERMAL MONITORING
-The
-.Xr sysctl 2
-hw.sensors.cpu*.temp0 returns the current temperature reported by the
-processor.
+.Pp
+The sysctl
+.Va hw.sensors
+returns the current temperature reported by the processor.
 .Sh SEE ALSO
 .Xr sysctl 8
 .Sh BUGS
diff --git a/share/man/man4/man4.i386/cpu.4 b/share/man/man4/man4.i386/cpu.4
index 131e7e41932..65ec7a88677 100644
--- a/share/man/man4/man4.i386/cpu.4
+++ b/share/man/man4/man4.i386/cpu.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cpu.4,v 1.18 2018/01/12 04:36:44 deraadt Exp $
+.\"	$OpenBSD: cpu.4,v 1.19 2024/05/11 20:35:13 jmc Exp $
 .\"
 .\" Copyright (c) 2004 Ted Unangst
 .\" All rights reserved.
@@ -23,7 +23,7 @@
 .\" (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 $Mdocdate: January 12 2018 $
+.Dd $Mdocdate: May 11 2024 $
 .Dt CPU 4 i386
 .Os
 .Sh NAME
@@ -35,15 +35,19 @@
 .Sh DESCRIPTION
 Several processor models have additional features that extend their base
 functionality, such as power and frequency control or thermal monitoring.
-.Sh FREQUENCY CONTROL
+.Pp
 The
 .Xr sysctl 2
-hw.cpuspeed returns the current operating frequency of the processor,
+.Va hw.cpuspeed
+returns the current operating frequency of the processor,
 though on some processors this value may be only an approximation.
-If possible, speed may be adjusted by altering hw.setperf from 0 to 100,
+If possible, speed may be adjusted by altering
+.Va hw.setperf
+from 0 to 100,
 representing percentage of maximum speed.
-There are several possible implementations for setperf, all transparent
-to the user.
+.Pp
+There are several possible implementations for speed adjustment,
+all transparent to the user.
 In systems with more than one control capability, they are preferred in the
 order given:
 .Bl -tag -width tenletters
@@ -67,9 +71,9 @@ Found on various AMD processors.
 It currently only supports a limited set of models
 in the K6, K7, and K8 families.
 .El
-.Sh INSTRUCTION SET EXTENSIONS
-The presence of extended instruction sets can be determined by the
-sysctl machdep.
+.Pp
+The presence of extended instruction sets can be determined by the sysctl
+.Va machdep :
 .Bl -tag -width "tenletters"
 .It osfxsr
 Supports the fxsave instruction.
@@ -82,11 +86,10 @@ Supports the VIA AES encryption instruction set.
 If this is supported,
 the libcrypto EVP AES functions automatically use this support.
 .El
-.Sh THERMAL MONITORING
-The
-.Xr sysctl 2
-hw.sensors.cpu*.temp0 returns the current temperature reported by the
-processor.
+.Pp
+The sysctl
+.Va hw.sensors
+returns the current temperature reported by the processor.
 .Sh SEE ALSO
 .Xr sysctl 8
 .Sh BUGS