К основному содержанию
скилл CX Codex

hypervisor-internals — скилл для Claude Code: VMX и установка

Скилл hypervisor-internals для Claude Code объясняет аппаратную виртуализацию Intel VT-x и AMD-V: VMCS, VMCB, EPT/NPT и обработку VMEXIT. Описывает основы создания минимального гипервизора.

MIT 365 установок ★ 298 обновлён 2026-06-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mohitmishra786/low-level-dev-skills --skill hypervisor-internals -a claude-code
Открыть на GitHub

Что делает hypervisor-internals

hypervisor-internals разбирает работу Intel VT-x и AMD-V: вход в VMX или SVM, настройку VMCS и VMCB, запуск гостя через VMLAUNCH, VMRESUME или VMRUN и обработку VMEXIT. Отдельные разделы посвящены EPT/NPT, MSR- и I/O-таблицам перехватов, виртуализации APIC и инъекции виртуальных прерываний.

Скилл связывает аппаратные механизмы с KVM, Hyper-V и VMware, объясняет причины EPT-нарушений, штормов VMEXIT и проблем вложенной виртуализации. Внутри есть путь к учебному гипервизору, примеры интерфейса KVM ioctl и ссылки на SimpleVisor, hvpp, kvmm и barevisor. При сбое VMXON нужно проверить обязательные биты CR0 и CR4 по Intel SDM.

Какие задачи решает

  • разобраться в VMCS и VMCB
  • найти причину шторма VMEXIT
  • настроить EPT/NPT для гостевой памяти
  • объяснить виртуализацию APIC и прерываний
  • собрать план учебного гипервизора

Примеры запросов агенту

  • Объясни путь от VMXON до VMEXIT и роль каждого поля VMCS.
  • Разбери причину EPT-нарушения для адресов GVA, GPA и HPA.
  • Составь план минимального гипервизора с обработкой CPUID, HLT и инъекцией прерываний.

Как установить hypervisor-internals

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill hypervisor-internals -a claude-code

2Вручную: положить файлы

~/.claude/skills/hypervisor-internals/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hypervisor-internals/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hypervisor-internals

Как установить hypervisor-internals в Claude Code?

Выполните npx skills add mohitmishra786/low-level-dev-skills --skill hypervisor-internals -a claude-code, затем проверьте файл ~/.claude/skills/hypervisor-internals/SKILL.md.

Что делает hypervisor-internals?

Скилл помогает разбирать VT-x и AMD-V, включая VMCS, VMCB, VMEXIT, EPT/NPT, MSR bitmap и виртуальные прерывания. Он также подсказывает структуру учебного type-1 гипервизора.

Почему VMXON может завершиться ошибкой?

Причиной могут быть неправильно выставленные обязательные биты CR0 или CR4. Их нужно сверить с требованиями Intel SDM.

Исходный текст

SKILL.md · MIT
---
name: hypervisor-internals
description: Hardware virtualization internals skill for Intel VT-x and AMD-V. Use when studying VMCS/VMCB, EPT/NPT page tables, VMEXIT handling, APIC virtualization, or building minimal hypervisors. Activates on queries about VMX, SVM, VMCS, EPT, NPT, VMEXIT, or type-1 hypervisor.
---

# Hypervisor Internals

## Purpose

Explain hardware virtualization internals for agents: Intel VT-x (VMXON, VMCS, VMLAUNCH/VMRESUME, VMEXIT reasons), AMD SVM (VMCB, #VMEXIT), Extended/Nested Page Tables (EPT/NPT), APIC virtualization, MSR bitmaps, virtual interrupt injection, and references for building minimal type-1 hypervisors.

## When to Use

- Understanding how KVM, Hyper-V, or VMware map to hardware features
- Debugging VMEXIT storms or EPT violations
- Studying hypervisor security research (CVE triage)
- Building educational hypervisors (SimpleVisor, hvpp)
- Tuning nested virtualization performance
- Analyzing VM escape or side-channel mitigations

## Workflow

### 1. Virtualization types

```
Type 1 (bare metal)     Type 2 (hosted)
├── Hyper-V             ├── KVM + QEMU
├── Xen                 ├── VirtualBox
├── VMware ESXi         └── Parallels
└── Runs directly on HW     Runs on host OS
```

### 2. Intel VT-x overview

```
VMX operation
├── VMXON — enter VMX root mode
├── VMCS setup — guest/host state fields
├── VMLAUNCH / VMRESUME — enter guest
├── Guest runs until VMEXIT
└── VMXOFF — exit VMX operation
```

Key structures:
- **VMCS** (Virtual Machine Control Structure) — guest/host state, control fields
- **VMEXIT** — forced exit to hypervisor (I/O, MSR, EPT fault, interrupt)

```c
// Simplified VMX enable check (kernel/driver context)
#include <linux/cpufeature.h>
if (boot_cpu_has(X86_FEATURE_VMX))
    // VT-x supported
```

### 3. VMCS fields (conceptual)

| Category | Examples |
|----------|----------|
| Guest state | GPRs, CR0/3/4, segment selectors, RIP, RSP |
| Host state | Host RIP (VMEXIT handler), host CR3 |
| Control | Pin-based, proc-based, VMEXIT/entry controls |
| Exit info | Exit reason, qualification, guest-linear-address |

VMEXIT reasons (common):

```
Exit reason codes (Intel)
├── 10 — CPUID
├── 28 — CR access
├── 30 — I/O instruction
├── 48 — EPT violation
├── 0  — External interrupt
└── 1  — Triple fault
```

### 4. AMD SVM (AMD-V)

```
SVM operation
├── EFER.SVME = 1
├── VMCB setup — guest save area + control area
├── VMRUN — enter guest
├── #VMEXIT — exit to host handler
└── Guest state in VMCB
```

VMCB control area: intercept vectors (CPUID, MSR, IO), nested paging enable, ASID.

| Intel | AMD |
|-------|-----|
| VMCS | VMCB |
| VMXON/VMXOFF | EFER.SVME |
| VMLAUNCH/VMRESUME | VMRUN |
| EPT | NPT (Nested Page Tables) |

### 5. EPT / NPT — second-level paging

```
Guest virtual (GVA) → Guest physical (GPA) [guest page tables]
GPA → Host physical (HPA) [EPT/NPT, managed by hypervisor]
```

EPT violation VMEXIT: guest accessed unmapped GPA or violated permissions.

```bash
# KVM EPT stats (if available)
# Nested virtualization adds second EPT walk — perf cost
```

Mitigations for side channels: flush L1D on VMEXIT (MDS), cache partitioning.

### 6. MSR and I/O bitmaps

```
MSR bitmap (4KB)
├── Per-MSR read/write intercept control
└── Avoid VMEXIT on common MSRs for performance

I/O bitmap
├── Intercept specific port I/O
└── Pass-through unlisted ports
```

Hypervisors intercept `MSR_IA32_FEATURE_CONTROL`, `MSR_IA32_EFER`, etc.

### 7. APIC virtualization

```
APIC virtualization
├── Virtual interrupt delivery — reduce VMEXIT on EOI
├── Posted interrupts — hardware-assisted injection
└── TPR shadowing — avoid exit on priority changes
```

Reduces overhead for interrupt-heavy guests (network I/O).

### 8. Virtual interrupt injection

Intel: inject via VM-entry interruption-information field.
AMD: V_IRQ, V_INTR_PRIO in VMCB.

```
Device interrupt → host IRQ handler → hypervisor
    → inject virtual IRQ to guest IDT
    → guest ISR runs
```

### 9. Minimal hypervisor references

| Project | Platform | Notes |
|---------|----------|-------|
| SimpleVisor | Windows | Educational, few thousand lines |
| hvpp | Windows | C++ hypervisor library |
| kvmm | Linux | Minimal KVM study |
| barevisor | x86_64 | Rust/ASM educational |

Study path:
1. CPUID detection and VMX enable
2. Allocate VMCS, set host/guest state
3. Handle VMEXIT for CPUID and HLT
4. Add EPT with identity map
5. Inject interrupts

### 10. KVM ioctl interface (practical)

```c
// Userspace KVM (how QEMU talks to KVM)
int kvm = open("/dev/kvm", O_RDWR);
int vm = ioctl(kvm, KVM_CREATE_VM, 0);
int vcpu = ioctl(vm, KVM_CREATE_VCPU, 0);
ioctl(vcpu, KVM_RUN, 0);  // runs until VMEXIT
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| VMEXIT storm on MSR | MSR bitmap intercepts all | Fine-tune bitmap; pass-through safe MSRs |
| EPT misconfiguration | Mismatched GPA→HPA | Verify EPT PTE permissions |
| Nested virt slow | Double page walk | Hardware assist; limit nesting depth |
| VMXON fails | CR0/CR4 fixed bits | Set required CR bits per Intel SDM |
| Guest triple fault | Bad IDT or unhandled exception | Check guest interrupt setup |
| I/O intercept overhead | All ports trapped | Shrink I/O bitmap |

## Related Skills

- `skills/virtualization/qemu-kvm` — practical KVM/QEMU usage
- `skills/virtualization/containers-internals` — lighter isolation without full VM
- `skills/kernel/kernel-internals` — host kernel scheduler/memory
- `skills/kernel/os-dev-scratch` — guest OS development context
- `skills/security/kernel-security` — hypervisor CVE mitigations
- `skills/platform/riscv-privileged` — RISC-V H-extension virtualization

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

Похожие скиллы

Все скиллы по теме «Безопасность» →
tanstack-virtual tanstack-skills Скилл подсказывает агенту, как подключить TanStack Virtual и рисовать только видимые строки в больших списках, таблицах и сетках. CX Codex +1 2 600установок Proximo — the Proxmox MCP you can hand the keys john-broadway Proximo — the Proxmox MCP you can hand the keys — MCP-сервер для управления Proxmox VE, PBS, PMG и PDM через языковые модели: показывает план и радиус изменений до выполнения команды. CX Codex +1 ★ 96звёзд репо proxmox-admin github.com/bastos Скилл proxmox-admin для работы с Proxmox VE из терминала: создаёт ВМ через qm, контейнеры через pct, настраивает хранилища и кластеры. CX Codex +1 886установок sandbox Vercel Inc. Запускает изолированные MicroVM на Linux через Vercel Sandbox SDK для безопасного выполнения чужого кода и тестов. CX Codex +1 689установок ProxmoxMCP-Plus RekklesNA MCP-сервер ProxmoxMCP-Plus для Claude Code и других платформ. Даёт агенту доступ к Proxmox VE: управление виртуалками, LXC, снапшоты, бэкапы, ISO и кластер через чат. CX Codex +1 ★ 664звёзд репо mcp-proxmox antonio-mello-ai MCP-сервер mcp-proxmox подключает Claude Code к Proxmox VE для управления виртуальными машинами, контейнерами, хранилищами и снапшотами. Инфраструктурой можно управлять через запросы. CX Codex +1 ★ 17звёзд репо

Из того же набора140

Весь набор →
numa-programming Скилл numa-programming учит агента работать с NUMA-топологией: определять узлы через numactl и lstopo, привязывать процессы к локальной памяти, использовать libnuma API и строить структуры данных с учётом сокетов. CX Codex +1 369установок dpdk Скилл для работы с DPDK — инициализация EAL, настройка poll-mode драйверов, mbuf-пулы, rte_ring, huge pages, RSS и проверка через testpmd. CX Codex +1 369установок timers-pwm-baremetal Скилл timers-pwm-baremetal для настройки таймеров микроконтроллера без ОС: ШИМ для управления яркостью и скоростью, захват входных импульсов, периодические прерывания через SysTick. Работает на STM32 и других платформах с голым железом. CX Codex +1 367установок mlir Скилл для работы с MLIR — инфраструктурой компиляторов, где каждый уровень абстракции живёт в своём диалекте. Пригодится при разработке специализированных компиляторов и оптимизаторов. CX Codex +1 366установок hip-rocm Скилл hip-rocm для Claude Code помогает писать HIP-ядра и переносить CUDA-код на AMD GPU. Он включается при запросах о HIP, ROCm, HIPIFY и профилировании. CX Codex +1 364установок io-uring Скилл для работы с io_uring — новым API асинхронного ввода-вывода Linux. Пригодится при разработке высоконагруженных серверов, если нужно снизить количество системных вызовов и использовать передачу данных без копирования. CX Codex +1 361установок arm-sve Скилл arm-sve для работы со Scalable Vector Extension — расширением SIMD на процессорах ARM. Помогает писать код, который адаптируется к разной длине векторов на Graviton, Apple M4 и других AArch64 серверах. CX Codex +1 361установок af-xdp Настраивает сокеты AF_XDP и память UMEM для скоростной обработки сетевых пакетов в userspace. Пригодится при написании фильтров трафика и балансировщиков. CX Codex +1 359установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой