[src/trunk]: src Note briefly what MSRs are. Requested by wiz@.

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

details:   https://anonhg.NetBSD.org/src/rev/f734d4be52d0
branches:  trunk
changeset: 770662:f734d4be52d0
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Fri Oct 28 07:23:16 2011 +0000

description:
Note briefly what MSRs are. Requested by wiz@.

diffstat:

 distrib/sets/lists/comp/mi       |   5 ++++-
 share/man/man9/man9.x86/Makefile |   5 +++--
 share/man/man9/man9.x86/rdmsr.9  |  12 +++++++++---
 3 files changed, 16 insertions(+), 6 deletions(-)

diffs (91 lines):

diff -r 7cd671fe842a -r f734d4be52d0 distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Fri Oct 28 07:20:03 2011 +0000
+++ b/distrib/sets/lists/comp/mi        Fri Oct 28 07:23:16 2011 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: mi,v 1.1698 2011/10/25 05:41:33 jruoho Exp $
+#      $NetBSD: mi,v 1.1699 2011/10/28 07:23:16 jruoho Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -10854,6 +10854,7 @@
 ./usr/share/man/cat9/wsmouse.0                 comp-sys-catman         .cat
 ./usr/share/man/cat9/wsmouse_input.0           comp-sys-catman         .cat
 ./usr/share/man/cat9/wsmousedevprint.0         comp-sys-catman         .cat
+./usr/share/man/cat9/x86/msr.0                 comp-sys-catman         .cat
 ./usr/share/man/cat9/x86/nmi.0                 comp-sys-catman         .cat
 ./usr/share/man/cat9/x86/nmi_disestablish.0    comp-sys-catman         .cat
 ./usr/share/man/cat9/x86/nmi_establish.0       comp-sys-catman         .cat
@@ -16903,6 +16904,7 @@
 ./usr/share/man/html9/wsmouse.html             comp-sys-htmlman        html
 ./usr/share/man/html9/wsmouse_input.html       comp-sys-htmlman        html
 ./usr/share/man/html9/wsmousedevprint.html     comp-sys-htmlman        html
+./usr/share/man/html9/x86/msr.html             comp-sys-htmlman        html
 ./usr/share/man/html9/x86/nmi.html             comp-sys-htmlman        html
 ./usr/share/man/html9/x86/nmi_disestablish.html        comp-sys-htmlman        html
 ./usr/share/man/html9/x86/nmi_establish.html   comp-sys-htmlman        html
@@ -23209,6 +23211,7 @@
 ./usr/share/man/man9/wsmouse.9                 comp-sys-man            .man
 ./usr/share/man/man9/wsmouse_input.9           comp-sys-man            .man
 ./usr/share/man/man9/wsmousedevprint.9         comp-sys-man            .man
+./usr/share/man/man9/x86/msr.9                 comp-sys-man            .man
 ./usr/share/man/man9/x86/nmi.9                 comp-sys-man            .man
 ./usr/share/man/man9/x86/nmi_disestablish.9    comp-sys-man            .man
 ./usr/share/man/man9/x86/nmi_establish.9       comp-sys-man            .man
diff -r 7cd671fe842a -r f734d4be52d0 share/man/man9/man9.x86/Makefile
--- a/share/man/man9/man9.x86/Makefile  Fri Oct 28 07:20:03 2011 +0000
+++ b/share/man/man9/man9.x86/Makefile  Fri Oct 28 07:23:16 2011 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.5 2011/10/25 05:41:35 jruoho Exp $
+#      $NetBSD: Makefile,v 1.6 2011/10/28 07:23:18 jruoho Exp $
 
 MAN=   nmi.9 rdmsr.9 tsc.9 x86_msr_xcall.9
 
@@ -7,7 +7,8 @@
 MLINKS+=nmi.9 nmi_establish.9 \
        nmi.9 nmi_disestablish.9
 
-MLINKS+=rdmsr.9 rdmsr_safe.9 \
+MLINKS+=rdmsr.9 msr.9 \
+       rdmsr.9 rdmsr_safe.9 \
        rdmsr.9 wrmsr.9
 
 MLINKS+=tsc.9 rdtsc.9 \
diff -r 7cd671fe842a -r f734d4be52d0 share/man/man9/man9.x86/rdmsr.9
--- a/share/man/man9/man9.x86/rdmsr.9   Fri Oct 28 07:20:03 2011 +0000
+++ b/share/man/man9/man9.x86/rdmsr.9   Fri Oct 28 07:23:16 2011 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: rdmsr.9,v 1.2 2011/10/25 05:41:35 jruoho Exp $
+.\" $NetBSD: rdmsr.9,v 1.3 2011/10/28 07:23:18 jruoho Exp $
 .\"
 .\" Copyright (c) 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,14 +27,15 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 25, 2011
+.Dd October 28, 2011
 .Dt RDMSR 9 x86
 .Os
 .Sh NAME
+.Nm msr ,
 .Nm rdmsr ,
 .Nm rdmsr_safe ,
 .Nm wrmsr
-.Nd functions for x86 model-specific registers
+.Nd functions for x86 MSRs
 .Sh SYNOPSIS
 .In x86/cpufunc.h
 .Ft uint64_t
@@ -65,6 +66,11 @@
 .Fn wrmsr
 functions are used to access
 .Dv MSRs .
+The header
+.In x86/specialreg.h
+includes definitions for some of the commonly used MSRs,
+that is, control registers that are present
+in some x86 processor models but unavailable in others.
 .Sh FUNCTIONS
 .Bl -tag -width abcd
 .It Fn rdmsr "msr"