plan9fox/sys/man/8/cpuid

79 lines
1.7 KiB
Plaintext
Raw Normal View History

2012-09-29 01:57:59 +00:00
.TH CPUID 8
.SH NAME
2017-06-13 14:19:42 +00:00
cpuid, icanhasvmx \- print processor information
2012-09-29 01:57:59 +00:00
.SH SYNOPSIS
.B aux/cpuid
[
.B -ar
]
2017-06-13 14:19:42 +00:00
.B aux/icanhasvmx
[
.B -r
]
2012-09-29 01:57:59 +00:00
.SH DESCRIPTION
2012-09-29 02:12:42 +00:00
Intel and compatible processors since the
2012-09-29 01:57:59 +00:00
.SM Pentium™
2012-09-29 02:12:42 +00:00
(or late 486) provide the
2012-09-29 01:57:59 +00:00
.SM CPUID
2012-09-29 02:12:42 +00:00
instruction that returns information about the chip. The
2012-09-29 01:57:59 +00:00
.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 ,
2012-09-29 02:12:42 +00:00
.BR CX
2012-09-29 01:57:59 +00:00
and
.BR DX .
.PP
The
.B -a
option prints enumerated items in raw format if no
2012-09-29 02:49:12 +00:00
keyword is known instead of omitting it (default).
2012-09-29 01:57:59 +00:00
.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
2017-06-13 14:19:42 +00:00
.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.
2012-09-29 01:57:59 +00:00
.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