xref: /illumos-gate/usr/src/man/man8/rdmsr.8 (revision bbf21555)
112596538SJohn Levon.\"
212596538SJohn Levon.\" This file and its contents are supplied under the terms of the
312596538SJohn Levon.\" Common Development and Distribution License ("CDDL"), version 1.0.
412596538SJohn Levon.\" You may only use this file in accordance with the terms of version
512596538SJohn Levon.\" 1.0 of the CDDL.
612596538SJohn Levon.\"
712596538SJohn Levon.\" A full copy of the text of the CDDL should have accompanied this
812596538SJohn Levon.\" source.  A copy of the CDDL is also available via the Internet at
912596538SJohn Levon.\" http://www.illumos.org/license/CDDL.
1012596538SJohn Levon.\"
1112596538SJohn Levon.\" Copyright 2019 Joyent, Inc.
1212596538SJohn Levon.\"
1312596538SJohn Levon.Dd October 14, 2019
14*bbf21555SRichard Lowe.Dt RDMSR 8
1512596538SJohn Levon.Os
1612596538SJohn Levon.Sh NAME
1712596538SJohn Levon.Nm rdmsr
1812596538SJohn Levon.Nd Read Model-Specific Register
1912596538SJohn Levon.Sh SYNOPSIS
2012596538SJohn Levon.Nm
2112596538SJohn Levon.Ar [0x<msrnr>]...
2212596538SJohn Levon.Sh DESCRIPTION
2312596538SJohn LevonThe
2412596538SJohn Levon.Nm
2512596538SJohn Levoncommand can be used to read a value out of one or more x86 MSRs, as defined by
2612596538SJohn Levonthe Intel and AMD CPU specifications.
2712596538SJohn LevonThe integer MSR number should be given (typically in 0x-prefixed hexadecimal).
2812596538SJohn LevonIt is the command-line equivalent of the
2912596538SJohn Levon.Fn rdmsr
3012596538SJohn Levoninstruction).
3112596538SJohn Levon.Pp
3212596538SJohn LevonThe read is done on the current CPU, which may change arbitrarily
3312596538SJohn Levonbetween MSR reads: to read from a particular CPU,
34*bbf21555SRichard Lowe.Xr pbind 8
3512596538SJohn Levoncan be used to execute this utility.
3612596538SJohn Levon.Sh EXIT STATUS
3712596538SJohn LevonThe
3812596538SJohn Levon.Nm
3912596538SJohn Levonutility exits 0 on success, or 1 if an error occurs, or at least one MSR
4012596538SJohn Levoncould not be read.
4112596538SJohn Levon.Sh SEE ALSO
4212596538SJohn LevonIntel 64 and IA-32 Architectures Software Developer's Manual Volume 4:
4312596538SJohn LevonModel-Specific Registers
44