xref: /illumos-gate/usr/src/man/man8/rdmsr.8 (revision 8119dad84d6416f13557b0ba8e2aaf9064cbcfd3)
1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\" Copyright 2019 Joyent, Inc.
12.\"
13.Dd October 14, 2019
14.Dt RDMSR 8
15.Os
16.Sh NAME
17.Nm rdmsr
18.Nd Read Model-Specific Register
19.Sh SYNOPSIS
20.Nm
21.Ar [0x<msrnr>]...
22.Sh DESCRIPTION
23The
24.Nm
25command can be used to read a value out of one or more x86 MSRs, as defined by
26the Intel and AMD CPU specifications.
27The integer MSR number should be given (typically in 0x-prefixed hexadecimal).
28It is the command-line equivalent of the
29.Fn rdmsr
30instruction).
31.Pp
32The read is done on the current CPU, which may change arbitrarily
33between MSR reads: to read from a particular CPU,
34.Xr pbind 8
35can be used to execute this utility.
36.Sh EXIT STATUS
37The
38.Nm
39utility exits 0 on success, or 1 if an error occurs, or at least one MSR
40could not be read.
41.Sh SEE ALSO
42Intel 64 and IA-32 Architectures Software Developer's Manual Volume 4:
43Model-Specific Registers
44