1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
'\" te
.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
.\" Copyright 2015, Joyent, Inc.
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH CPUID 4D "April 9, 2016"
.SH NAME
cpuid \- CPU identification driver
.SH SYNOPSIS
.LP
.nf
\fB/dev/cpu/self/cpuid\fR
.fi
.SH DESCRIPTION
.SS "SPARC and x86 system"
.LP
This device provides implementation-private information via ioctls about
various aspects of the implementation to Solaris libraries and utilities.
.SS "x86 systems only"
.LP
This device also provides a file-like view of the namespace and return values
of the x86 cpuid instruction. The cpuid instruction takes a single 32-bit
integer function code, and returns four 32-bit integer values corresponding to
the input value that describe various aspects of the capabilities and
configuration of the processor.
.LP
The API for the character device consists of using the seek offset to set the
function code value, and using a \fBread\fR(2) or \fBpread\fR(2) of 16 bytes to
fetch the four 32-bit return values of the instruction in the order %\fBeax\fR,
%\fBebx\fR, %\fBecx\fR and %\fBedx\fR.
.LP
No data can be written to the device. Like the \fBcpuid\fR instruction, no
special privileges are required to use the device.
.LP
The device is useful to enable low-level configuration information to be
extracted from the CPU without having to write any assembler code to invoke the
\fBcpuid\fR instruction directly. It also allows the kernel to attempt to
correct any erroneous data returned by the instruction (prompted by occasional
errors in the information exported by various processor implementations over
the years).
.LP
See the processor manufacturers documentation for further information about the
syntax and semantics of the wide variety of information available from this
instruction.
.LP
Some systems can be configured to limit the cpuid opcodes which are accessible.
While illumos handles this condition, other software may malfunction when such
limits are enabled. Those settings are typically manipulated in the BIOS.
.SH EXAMPLE
.LP
This example allows you to determine if the current x86 processor supports
"long mode," which is a necessary (but not sufficient) condition for running
the 64-bit Solaris kernel on the processor.
.sp
.in +2
.nf
/*
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <string.h>
#include <errno.h>
#include <stdio.h>
static const char devname[] = "/dev/cpu/self/cpuid";
/*ARGSUSED*/
int
main(int argc, char *argv[])
{
struct {
uint32_t r_eax, r_ebx, r_ecx, r_edx;
} _r, *rp = &_r;
int d;
char *s;
if ((d = open(devname, O_RDONLY)) == -1) {
perror(devname);
return (1);
}
if (pread(d, rp, sizeof (*rp), 0) != sizeof (*rp)) {
perror(devname);
goto fail;
}
s = (char *)&rp->r_ebx;
if (strncmp(s, "Auth" "cAMD" "enti", 12) != 0 &&
strncmp(s, "Genu" "ntel" "ineI", 12) != 0)
goto fail;
if (pread(d, rp, sizeof (*rp), 0x80000001) == sizeof (*rp)) {
/*
* Read extended feature word; check bit 29
*/
(void) close(d);
if ((rp->r_edx >> 29) & 1) {
(void) printf("processor supports long mode\en");
return (0);
}
}
fail:
(void) close(d);
return (1);
}
.fi
.in -2
.SH ERRORS
.ne 2
.na
\fBENXIO\fR
.ad
.RS 10n
Results from attempting to read data from the device on a system that does not
support the CPU identification interfaces
.RE
.sp
.ne 2
.na
\fBEINVAL\fR
.ad
.RS 10n
Results from reading from an offset larger than UINT_MAX, or attempting to read
with a size that is not multiple of 16 bytes.
.RE
.SH FILES
.ne 2
.na
\fB\fB/dev/cpu/self/cpuid\fR\fR
.ad
.RS 23n
Provides access to CPU identification data.
.RE
.SH ATTRIBUTES
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
_
Interface Stability Evolving
.TE
.SH SEE ALSO
.LP
.BR pread (2),
.BR read (2),
.BR attributes (7),
.BR prtconf (8),
.BR psrinfo (8)
|
