man4/msr.4

   1 .\" Copyright (c) 2009 Intel Corporation, Author Andi Kleen
   2 .\" Some sentences copied from comments in arch/x86/kernel/msr.c
   3 .\"
   4 .\" %%%LICENSE_START(VERBATIM)
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one.
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\" %%%LICENSE_END
  25 .\"
  26 .TH MSR 4 2021-03-22 "Linux" "Linux Programmer's Manual"
  27 .SH NAME
  28 msr \- x86 CPU MSR access device
  29 .SH DESCRIPTION
  30 .I /dev/cpu/CPUNUM/msr
  31 provides an interface to read and write the model-specific
  32 registers (MSRs) of an x86 CPU.
  33 .I CPUNUM
  34 is the number of the CPU to access as listed in
  35 .IR /proc/cpuinfo .
  36 .PP
  37 The register access is done by opening the file and seeking
  38 to the MSR number as offset in the file, and then
  39 reading or writing in chunks of 8 bytes.
  40 An I/O transfer of more than 8 bytes means multiple reads or writes
  41 of the same register.
  42 .PP
  43 This file is protected so that it can be read and written only by the user
  44 .IR root ,
  45 or members of the group
  46 .IR root .
  47 .SH NOTES
  48 The
  49 .I msr
  50 driver is not auto-loaded.
  51 On modular kernels you might need to use the following command
  52 to load it explicitly before use:
  53 .PP
  54 .in +4n
  55 .EX
  56 $ modprobe msr
  57 .EE
  58 .in
  59 .SH SEE ALSO
  60 Intel Corporation Intel 64 and IA-32 Architectures
  61 Software Developer's Manual Volume 3B Appendix B,
  62 for an overview of the Intel CPU MSRs.