cpuid

cpuid 包提供了有关当前程序运行的 CPU 的信息。

CPU 特性在启动时被检测,并在应用程序的整个生命周期中保持快速访问。目前支持 x86 / x64 (AMD64/i386) 和 ARM (ARM64),且不使用外部 C (cgo) 代码,这使得该库非常易于使用。

你可以通过访问 cpuid 库的共享 CPU 变量来获取 CPU 信息。

包主页: https://github.com/klauspost/cpuid

安装

使用模块时执行 go get -u github.com/klauspost/cpuid/v2。 其他情况下去掉 v2。

安装二进制文件:

go install github.com/klauspost/cpuid/v2/cmd/cpuid@latest

或从发布页面下载二进制文件: https://github.com/klauspost/cpuid/releases

Homebrew

对于 macOS/Linux 用户,可以通过 brew 安装

$ brew install cpuid

示例

package main

import (
	"fmt"
	"strings"

	. "github.com/klauspost/cpuid/v2"
)

func main() {
	// 打印基本的 CPU 信息:
	fmt.Println("名称:", CPU.BrandName)
	fmt.Println("物理核心数:", CPU.PhysicalCores)
	fmt.Println("每核心线程数:", CPU.ThreadsPerCore)
	fmt.Println("逻辑核心数:", CPU.LogicalCores)
	fmt.Println("系列", CPU.Family, "型号:", CPU.Model, "厂商 ID:", CPU.VendorID)
	fmt.Println("特性:", strings.Join(CPU.FeatureSet(), ","))
	fmt.Println("缓存行大小:", CPU.CacheLine)
	fmt.Println("L1 数据缓存:", CPU.Cache.L1D, "字节")
	fmt.Println("L1 指令缓存:", CPU.Cache.L1I, "字节")
	fmt.Println("L2 缓存:", CPU.Cache.L2, "字节")
	fmt.Println("L3 缓存:", CPU.Cache.L3, "字节")
	fmt.Println("频率", CPU.Hz, "赫兹")

	// 测试是否有这些特定特性:
	if CPU.Supports(SSE, SSE2) {
		fmt.Println("我们有流式 SIMD 2 扩展")
	}
}

示例输出:

>go run main.go
名称: AMD Ryzen 9 3950X 16-Core Processor
物理核心数: 16
每核心线程数: 2
逻辑核心数: 32
系列 23 型号: 113 厂商 ID: AMD
特性: ADX,AESNI,AVX,AVX2,BMI1,BMI2,CLMUL,CMOV,CX16,F16C,FMA3,HTT,HYPERVISOR,LZCNT,MMX,MMXEXT,NX,POPCNT,RDRAND,RDSEED,RDTSCP,SHA,SSE,SSE2,SSE3,SSE4,SSE42,SSE4A,SSSE3
缓存行大小: 64
L1 数据缓存: 32768 字节
L1 指令缓存: 32768 字节
L2 缓存: 524288 字节
L3 缓存: 16777216 字节
频率 0 赫兹
我们有流式 SIMD 2 扩展

使用

cpuid.CPU 提供了对 CPU 特性的访问。使用 cpuid.CPU.Supports() 来检查 CPU 特性。 提供了一个更快的 cpuid.CPU.Has()，通常会被 gc 编译器内联。

要测试大量特性，可以使用 f := CombineFeatures(CMOV, CMPXCHG8, X87, FXSR, MMX, SYSCALL, SSE, SSE2) 等来组合它们。 这可以与 cpuid.CPU.HasAll(f) 一起使用，以快速测试是否支持所有特性。

注意，对于某些 CPU/OS 组合，某些特性可能无法检测到。 amd64 的支持相当好，应该在所有平台上可靠工作。

请注意，虚拟机管理程序可能不会将所有 CPU 特性传递给客户操作系统， 所以即使你的主机支持某个特性，在客户机上也可能看不到。

arm64 特性检测

并非所有操作系统都直接提供 ARM 特性， 对于其他系统，也没有安全的方法来实现这一点。

目前 arm64/linux 和 arm64/freebsd 应该相当可靠。 arm64/darwin 添加了 M1 处理器预期的特性，但仍有许多特性未被检测到。

如果你能控制你的部署环境，可以使用 DetectARM()， 它将检测 CPU 特性，但如果操作系统不拦截调用，可能会崩溃。 可以添加 -cpu.arm 标志来检测不安全的 ARM 特性。详见下文。

注意，目前在 ARM 上只检测特性， 目前没有其他额外信息可用。

标志

可以添加影响 CPU 检测的标志。

为此提供了 Flags() 命令。

这必须在 flag.Parse() 之前调用，并且在解析标志后必须调用 Detect()。

这意味着在 init() 函数中使用的任何检测都不会包含这些标志。

示例:

package main

import (
	"flag"
	"fmt"
	"strings"

	"github.com/klauspost/cpuid/v2"
)

func main() {
	cpuid.Flags()
	flag.Parse()
	cpuid.Detect()

	// 测试是否有这些特定特性:
	if cpuid.CPU.Supports(cpuid.SSE, cpuid.SSE2) {
		fmt.Println("我们有流式 SIMD 2 扩展")
	}
}

命令行

从以下地址下载二进制文件: https://github.com/klauspost/cpuid/releases

从源代码安装:

go install github.com/klauspost/cpuid/v2/cmd/cpuid@latest

示例

λ cpuid
名称：AMD Ryzen 9 3950X 16核处理器
厂商字符串：AuthenticAMD
厂商ID：AMD
物理核心数：16
每核心线程数：2
逻辑核心数：32
CPU系列23 型号：113
功能：ADX,AESNI,AVX,AVX2,BMI1,BMI2,CLMUL,CLZERO,CMOV,CMPXCHG8,CPBOOST,CX16,F16C,FMA3,FXSR,FXSROPT,HTT,HYPERVISOR,LAHF,LZCNT,MCAOVERFLOW,MMX,MMXEXT,MOVBE,NX,OSXSAVE,POPCNT,RDRAND,RDSEED,RDTSCP,SCE,SHA,SSE,SSE2,SSE3,SSE4,SSE42,SSE4A,SSSE3,SUCCOR,X87,XSAVE
微架构等级：3
缓存行大小：64字节
一级指令缓存：32768字节
一级数据缓存：32768字节
二级缓存：524288字节
三级缓存：16777216字节

JSON输出：

λ cpuid --json
{
  "品牌名称": "AMD Ryzen 9 3950X 16核处理器",
  "厂商ID": 2,
  "厂商字符串": "AuthenticAMD",
  "物理核心数": 16,
  "每核心线程数": 2,
  "逻辑核心数": 32,
  "系列": 23,
  "型号": 113,
  "缓存行": 64,
  "频率": 0,
  "加速频率": 0,
  "缓存": {
    "一级指令": 32768,
    "一级数据": 32768,
    "二级": 524288,
    "三级": 16777216
  },
  "SGX": {
    "可用": false,
    "启动控制": false,
    "支持SGX1": false,
    "支持SGX2": false,
    "非64位最大飞地大小": 0,
    "64位最大飞地大小": 0,
    "EPC区段": null
  },
  "功能": [
    "ADX",
    "AESNI",
    "AVX",
    "AVX2",
    "BMI1",
    "BMI2",
    "CLMUL",
    "CLZERO",
    "CMOV",
    "CMPXCHG8",
    "CPBOOST",
    "CX16",
    "F16C",
    "FMA3",
    "FXSR",
    "FXSROPT",
    "HTT",
    "HYPERVISOR",
    "LAHF",
    "LZCNT",
    "MCAOVERFLOW",
    "MMX",
    "MMXEXT",
    "MOVBE",
    "NX",
    "OSXSAVE",
    "POPCNT",
    "RDRAND",
    "RDSEED",
    "RDTSCP",
    "SCE",
    "SHA",
    "SSE",
    "SSE2",
    "SSE3",
    "SSE4",
    "SSE42",
    "SSE4A",
    "SSSE3",
    "SUCCOR",
    "X87",
    "XSAVE"
  ],
  "X64等级": 3
}

检查CPU微架构等级

λ cpuid --check-level=3
2022/03/18 17:04:40 AMD Ryzen 9 3950X 16核处理器
2022/03/18 17:04:40 支持微架构等级3。最高等级为3。
退出代码 0

λ cpuid --check-level=4
2022/03/18 17:06:18 AMD Ryzen 9 3950X 16核处理器
2022/03/18 17:06:18 不支持微架构等级4。最高等级为3。
退出代码 1

可用标志

x86 & amd64

ARM 特性：

许可证

本代码以 MIT 许可证发布。有关更多信息，请参阅 LICENSE 文件。