summaryrefslogtreecommitdiff
path: root/lsmsr.8
blob: 03b80d9382143176d8208f9c38888d70efcad976 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
.\" Copyright (C) 2008 Advanced Micro Devices, Inc.
'\"! tbl | mmdoc 
'\"macro stdmacro 
.nr X
.TH lsmsr 8 "July 2008" "x86utils"
.SH NAME
lsmsr \- show MSR information for x86 CPUs

.SH SYNOPSIS
.B lsmsr
.RB [ \-hv ]
.RB [ \-a
.RB [ \-c
.IR cpu_nr ]
.RB [ \-f
.IR family ]
.RB [ \-l]
.RB [ \-r
.IR name|address ]
.RB [\-V
.IR verbosity]
.IR [MSR]

.SH DESCRIPTION
.PP
.B lsmsr
is a tool to display information for machine specific registers
of x86 CPUs. Following CPUs are supported:
AMD family 0xf and family 0x10. For Intel and other AMD CPUs just
a some common MSRs is supported.
.SH OPTIONS
.TP
.B -a, --all
Show information for all MSRs known to the tool for that CPU family.
.TP
.B -c cpu_nr, --cpu  cpu_nr
Select CPU (by number) for which MSR information should be displayed
(default: 0).
.TP
.B -f fam, --family fam
Specify CPU family. Normally CPU family is auto-detected. You can
use this option to disable auto-detection, e.g. for debugging
purposes.
.TP
.B -l, --list
Show definition (address, field description) of selected MSR(s).
.TP
.B -r name|address, --register name|address
Specify MSR  (by name or address in hex) for which MSR information
should be displayed.
.TP
.B -V num, --verbosity num
Select verbosity of output format (between 0 and 4, default: 0)
.TP
.B -h, --help
Print help message and exit.
.TP
.B -v, --version
Display version info and exit.
.SH Examples
.IP "" 0
Show all MSRs beginning with 'MTRR' and force CPU family  to 0x10
.IP "" 2
# lsmsr -l -f 0x10 MTRR
 MTRRcap             : 0x000000fe
 MTRRphysBase0       : 0x00000200
 MTRRphysMask0       : 0x00000201
 MTRRphysBase1       : 0x00000202
 MTRRphysMask1       : 0x00000203
 MTRRphysBase2       : 0x00000204
 MTRRphysMask2       : 0x00000205
 MTRRphysBase3       : 0x00000206
 MTRRphysMask3       : 0x00000207
 MTRRphysBase4       : 0x00000208
 MTRRphysMask4       : 0x00000209
 MTRRphysBase5       : 0x0000020a
 MTRRphysMask5       : 0x0000020b
 MTRRphysBase6       : 0x0000020c
 MTRRphysMask6       : 0x0000020d
 MTRRphysBase7       : 0x0000020e
 MTRRphysMask7       : 0x0000020f
 MTRRfix64K_00000    : 0x00000250
 MTRRfix16K_80000    : 0x00000258
 MTRRfix16K_A0000    : 0x00000259
 MTRRfix4K_C0000     : 0x00000268
 MTRRfix4K_C8000     : 0x00000269
 MTRRfix4K_D0000     : 0x0000026a
 MTRRfix4K_D8000     : 0x0000026b
 MTRRfix4K_E0000     : 0x0000026c
 MTRRfix4K_E8000     : 0x0000026d
 MTRRfix4K_F0000     : 0x0000026e
 MTRRfix4K_F8000     : 0x0000026f
 MTRRdefType         : 0x000002ff
.IP ""0
Show 'MTRRcap MSR in verbose one-line mode
.IP "" 2
# lsmsr -r MTRRcap -V 1   
 MTRRcap = 0x0000000000000508 (MtrrCapVCnt=0x8,  MtrrCapFix=0x1,  MtrrCapWc=0x1)
.IP "" 0
Show 'MTRRdefType' in verbose multi-line mode 
.IP "" 2
# lsmsr -r MTRRdefType -V 3 
 MTRRdefType          = 0x0000000000000c00
   MtrrDefMemType=0
   MtrrDefTypeFixEn=0x1
   MtrrDefTypeEn=0x1
.IP "" 0
Show definition of MSR 0x200 in verbose multi-line mode (including reserved fields)
.IP "" 2
# lsmsr -r 0x200 -V 4 -l
 MTRRphysBase0: 0x00000200
   0-7:Type
   8-11:res
   12-39:PhyBase
   40-63:res
.IP "" 0
List all known MSRs for family 0xf
.IP "" 2
# lsmsr  -f 0xf -l -a 
 TSC                 : 0x00000010; time-stamp counter
 APIC_BASE           : 0x0000001b; APIC base address

 ...

 MTRRphysBase0       : 0x00000200; base of variable MTRR (0)
 MTRRphysMask0       : 0x00000201; mask of variable MTRR (0)
 MTRRphysBase1       : 0x00000202; base of variable MTRR (1)
 MTRRphysMask1       : 0x00000203; mask of variable MTRR (1)

 ...

 MTRRfix4K_F0000     : 0x0000026e
 MTRRfix4K_F8000     : 0x0000026f
 PAT                 : 0x00000277; page attribute table
 MTRRdefType         : 0x000002ff


.SH Author
.B lsmsr
and this manual page was written by Andreas Herrmann <andreas.herrman3@amd.com>.
.PP
Permission is granted to copy, distribute and/or modify this 
document under the terms of the GNU General Public License version 2.

.SH REPORTING BUGS
Please send bug reports to <andreas.herrmann3@amd.com>.