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