| 1 |
.\" Copyright 2009, Intel Corp. |
| 2 |
.\" Copyright, the authors of the Linux man-pages project |
| 3 |
.\" |
| 4 |
.\" SPDX-License-Identifier: Linux-man-pages-copyleft |
| 5 |
.\" |
| 6 |
.TH msr 4 2026-02-08 "Linux man-pages 6.18" |
| 7 |
.SH NAME |
| 8 |
msr \- x86 CPU MSR access device |
| 9 |
.SH DESCRIPTION |
| 10 |
.I /dev/cpu/CPUNUM/msr |
| 11 |
provides an interface to read and write the model-specific |
| 12 |
registers (MSRs) of an x86 CPU. |
| 13 |
.I CPUNUM |
| 14 |
is the number of the CPU to access as listed in |
| 15 |
.IR /proc/cpuinfo . |
| 16 |
.P |
| 17 |
The register access is done by opening the file and seeking |
| 18 |
to the MSR number as offset in the file, and then |
| 19 |
reading or writing in chunks of 8 bytes. |
| 20 |
An I/O transfer of more than 8 bytes means multiple reads or writes |
| 21 |
of the same register. |
| 22 |
.P |
| 23 |
This file is protected so that it can be read and written only by the user |
| 24 |
.IR root , |
| 25 |
or members of the group |
| 26 |
.IR root . |
| 27 |
.SH NOTES |
| 28 |
The |
| 29 |
.I msr |
| 30 |
driver is not auto-loaded. |
| 31 |
On modular kernels you might need to use the following command |
| 32 |
to load it explicitly before use: |
| 33 |
.P |
| 34 |
.in +4n |
| 35 |
.EX |
| 36 |
$ modprobe msr |
| 37 |
.EE |
| 38 |
.in |
| 39 |
.SH SEE ALSO |
| 40 |
Intel Corporation Intel 64 and IA-32 Architectures |
| 41 |
Software Developer's Manual Volume 3B Appendix B, |
| 42 |
for an overview of the Intel CPU MSRs. |