xref: /aosp_15_r20/external/coreboot/util/msrtool/README (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1
2You need to be ROOT or use SUDO to execute MSRTOOL.
3
4Note that you need /dev/cpu/*/msr available to run msrtool in Linux.
5
6
7syntax: msrtool [-hvqrkl] [-c cpu] [-m system] [-t target ...]
8         [-i addr=hi[:]lo] | [-s file] | [-d [:]file] | addr...
9  -h     show this help text
10  -v     be verbose
11  -q     be quiet (overrides -v)
12  -r     include [Reserved] values
13  -k     list all known systems and targets
14  -l     list MSRs and bit fields for current target(s) (-kl for ALL targets!)
15  -c     access MSRs on the specified CPU, default=0
16  -m     force a system, e.g: -m linux
17  -t     force a target, can be used multiple times, e.g: -t geodelx -t cs5536
18  -i     immediate mode
19         decode hex addr=hi:lo for the target without reading hw value
20         e.g: -i 4c00000f=f2f100ff56960004
21  -s     stream mode
22         read one MSR address per line and append current hw value to the line
23         use the filename - for stdin/stdout
24         using -l -s ignores input and will output all MSRs with values
25  -d     diff mode
26         read one address and value per line and compare with current hw value,
27         printing differences to stdout. use the filename - to read from stdin
28         use :file or :- to reverse diff, normally hw values are considered new
29  addr.. direct mode, read and decode values for the given MSR address(es)
30
31
32Examples:
33
34msrtool 0x20000018
35
36./msrtool 0x200000{18,19,1a,1b,1c,1d} 0x4c0000{0f,14}
37