cpuid.h

Go to the documentation of this file.

#ifndef _IPXE_CPUID_H
#define _IPXE_CPUID_H
 
/** @file
 *
 * x86 CPU feature detection
 *
 */
 
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );
 
#include <stdint.h>
 
/** An x86 CPU feature register set */
struct x86_feature_registers {
        /** Features returned via %ecx */
        uint32_t ecx;
        /** Features returned via %edx */
        uint32_t edx;
};
 
/** x86 CPU features */
struct x86_features {
        /** Intel-defined features (%eax=0x00000001) */
        struct x86_feature_registers intel;
        /** AMD-defined features (%eax=0x80000001) */
        struct x86_feature_registers amd;
};
 
/** CPUID support flag */
#define CPUID_FLAG 0x00200000UL
 
/** CPUID extended function */
#define CPUID_EXTENDED 0x80000000UL
 
/** CPUID hypervisor function */
#define CPUID_HYPERVISOR 0x40000000UL
 
/** Get vendor ID and largest standard function */
#define CPUID_VENDOR_ID 0x00000000UL
 
/** Get standard features */
#define CPUID_FEATURES 0x00000001UL
 
/** RDRAND instruction is supported */
#define CPUID_FEATURES_INTEL_ECX_RDRAND 0x40000000UL
 
/** Hypervisor is present */
#define CPUID_FEATURES_INTEL_ECX_HYPERVISOR 0x80000000UL
 
/** TSC is present */
#define CPUID_FEATURES_INTEL_EDX_TSC 0x00000010UL
 
/** FXSAVE and FXRSTOR are supported */
#define CPUID_FEATURES_INTEL_EDX_FXSR 0x01000000UL
 
/** Get largest extended function */
#define CPUID_AMD_MAX_FN 0x80000000UL
 
/** Extended function existence check */
#define CPUID_AMD_CHECK 0x80000000UL
 
/** Extended function existence check mask */
#define CPUID_AMD_CHECK_MASK 0xffff0000UL
 
/** Get extended features */
#define CPUID_AMD_FEATURES 0x80000001UL
 
/** Get CPU model */
#define CPUID_MODEL 0x80000002UL
 
/** Get APM information */
#define CPUID_APM 0x80000007UL
 
/** Invariant TSC */
#define CPUID_APM_EDX_TSC_INVARIANT 0x00000100UL
 
/**
 * Issue CPUID instruction
 *
 * @v function          CPUID function (input via %eax)
 * @v subfunction       CPUID subfunction (input via %ecx)
 * @v eax               Output via %eax
 * @v ebx               Output via %ebx
 * @v ecx               Output via %ecx
 * @v edx               Output via %edx
 */
static inline __attribute__ (( always_inline )) void
cpuid ( uint32_t function, uint32_t subfunction, uint32_t *eax, uint32_t *ebx,
        uint32_t *ecx, uint32_t *edx ) {
 
        __asm__ ( "cpuid"
                  : "=a" ( *eax ), "=b" ( *ebx ), "=c" ( *ecx ), "=d" ( *edx )
                  : "0" ( function ), "2" ( subfunction ) );
}
 
extern int cpuid_supported ( uint32_t function );
extern void x86_features ( struct x86_features *features );
 
#endif /* _IPXE_CPUID_H */