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 1M
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
23 The
24 .Nm
25 command can be used to read a value out of one or more x86 MSRs, as defined by
26 the Intel and AMD CPU specifications.
27 The integer MSR number should be given (typically in 0x-prefixed hexadecimal).
28 It is the command-line equivalent of the
29 .Fn rdmsr
30 instruction).
31 .Pp
32 The read is done on the current CPU, which may change arbitrarily
33 between MSR reads: to read from a particular CPU,
34 .Xr pbind 1M
35 can be used to execute this utility.
36 .Sh EXIT STATUS
37 The
38 .Nm
39 utility exits 0 on success, or 1 if an error occurs, or at least one MSR
40 could not be read.
41 .Sh SEE ALSO
42 Intel 64 and IA-32 Architectures Software Developer's Manual Volume 4:
43 Model-Specific Registers