Hyper-V Detection Tool

A simple Go program that detects whether the current Windows system is running inside a Hyper-V virtual machine environment(Guest) using CPUID instruction.

Install

go install github.com/gmh5225/Go-Detection-Hyper-v@v0.0.5

Uninstall

where/which Go-Detection-Hyper-v

Clean module cache

go clean -modcache

How It Works

The program uses the CPUID instruction to:

1. Check for the Hyper-V vendor string ("Microsoft Hv")
2. Verify specific feature flags that indicate a Hyper-V environment

Project Structure

• main.go - Main program logic and Hyper-V detection implementation
• cpuid_amd64.s - Assembly code for CPUID instruction

Technical Details

The detection is performed by:

1. Using CPUID with leaf 0x40000000 to check for Hyper-V vendor signature
2. Using CPUID with leaf 0x40000003 to verify specific feature flags

Output

The program will output one of two messages:

• "Running in Hyper-V environment(Guest)"
• "Not running in Hyper-V environment(Guest)"

Thanks

• https://x.com/sixtyvividtails/status/1850373100665282775
• https://x.com/sixtyvividtails/status/1850396353765019739