plan9fox/sys/man/8/cpuid
2017-06-13 14:19:42 +00:00

78 lines
1.7 KiB
Text

.TH CPUID 8
.SH NAME
cpuid, icanhasvmx \- print processor information
.SH SYNOPSIS
.B aux/cpuid
[
.B -ar
]
.B aux/icanhasvmx
[
.B -r
]
.SH DESCRIPTION
Intel and compatible processors since the
.SM Pentium™
(or late 486) provide the
.SM CPUID
instruction that returns information about the chip. The
.I cpuid
program enumerates and prints this information in a simple
textual format. The output consists of multiple lines prefixed
with a keyword describing the information that follows.
.PP
With the
.B -r
option, the format changes to raw hexadecimal output with the
keyword being the
.BR AX
input register to the
.SM CPUID
instruction followed by 4 colums with the output registers
.BR AX ,
.BR BX ,
.BR CX
and
.BR DX .
.PP
The
.B -a
option prints enumerated items in raw format if no
keyword is known instead of omitting it (default).
.PP
The keywords supported so far are:
.TP
.B vendor
Processor vendor string
.TP
.B procmodel, extmodel
Processor model, hexadecimal model / family id
.TP
.B features, extfeatures
Feature bits, a variable list of feature acronyms
.TP
.B procname
Processor name string
.TP
.B physbits, virtbits, guestbits
Address lines, decimal in bits
.PP
.I Icanhasvmx
queries the virtual machine extension (VMX) capabilities.
If
.B -r
is specified, it prints the results in raw hexadecimal; otherwise it produces a human-readable format.
In any case it prints a summary on fd 2.
.SH EXAMPLE
.EX
term% aux/cpuid
vendor GenuineIntel
procmodel 000006b4 / 00000006
features fpu vme de pse tsc msr pae mce cx8 sep mtrr pge mca cmov pat pse36
features mmx fxsr sse
extmodel 00000000 / 00000000
procname Mobile Intel(R) Pentium(R) III CPU - M 1133MHz
.EE
.SH SOURCE
.B /sys/src/cmd/aux/cpuid.c