tools/arch/x86/include/uapi/asm/kvm.h
Source file repositories/reference/linux-study-clean/tools/arch/x86/include/uapi/asm/kvm.h
File Facts
- System
- Linux kernel
- Corpus path
tools/arch/x86/include/uapi/asm/kvm.h- Extension
.h- Size
- 24295 bytes
- Lines
- 1052
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: implementation source
- Status
- source implementation candidate
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Touches IRQ or DMA behavior; this matters for the representative real-device path.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/const.hlinux/bits.hlinux/types.hlinux/ioctl.hlinux/stddef.h
Detected Declarations
struct kvm_pic_statestruct kvm_ioapic_statestruct kvm_regsstruct kvm_lapic_statestruct kvm_segmentstruct kvm_dtablestruct kvm_sregsstruct kvm_sregs2struct kvm_fpustruct kvm_msr_entrystruct kvm_msrsstruct kvm_msr_liststruct kvm_msr_filter_rangestruct kvm_msr_filterstruct kvm_cpuid_entrystruct kvm_cpuidstruct kvm_cpuid_entry2struct kvm_cpuid2struct kvm_pit_channel_statestruct kvm_debug_exit_archstruct kvm_guest_debug_archstruct kvm_pit_statestruct kvm_pit_state2struct kvm_reinject_controlstruct kvm_vcpu_eventsstruct kvm_debugregsstruct kvm_xsavestruct kvm_xcrstruct kvm_xcrsstruct kvm_sync_regsstruct kvm_vmx_nested_state_datastruct kvm_vmx_nested_state_hdrstruct kvm_svm_nested_state_datastruct kvm_svm_nested_state_hdrstruct kvm_nested_statestruct kvm_pmu_event_filterstruct kvm_x86_mcestruct kvm_xen_hvm_configstruct kvm_xen_hvm_attrstruct kvm_xen_vcpu_attrstruct kvm_sev_cmdstruct kvm_sev_initstruct kvm_sev_launch_startstruct kvm_sev_launch_update_datastruct kvm_sev_launch_secretstruct kvm_sev_launch_measurestruct kvm_sev_guest_statusstruct kvm_sev_dbg
Annotated Snippet
struct kvm_pic_state {
__u8 last_irr; /* edge detection */
__u8 irr; /* interrupt request register */
__u8 imr; /* interrupt mask register */
__u8 isr; /* interrupt service register */
__u8 priority_add; /* highest irq priority */
__u8 irq_base;
__u8 read_reg_select;
__u8 poll;
__u8 special_mask;
__u8 init_state;
__u8 auto_eoi;
__u8 rotate_on_auto_eoi;
__u8 special_fully_nested_mode;
__u8 init4; /* true if 4 byte init */
__u8 elcr; /* PIIX edge/trigger selection */
__u8 elcr_mask;
};
#define KVM_IOAPIC_NUM_PINS 24
struct kvm_ioapic_state {
__u64 base_address;
__u32 ioregsel;
__u32 id;
__u32 irr;
__u32 pad;
union {
__u64 bits;
struct {
__u8 vector;
__u8 delivery_mode:3;
__u8 dest_mode:1;
__u8 delivery_status:1;
__u8 polarity:1;
__u8 remote_irr:1;
__u8 trig_mode:1;
__u8 mask:1;
__u8 reserve:7;
__u8 reserved[4];
__u8 dest_id;
} fields;
} redirtbl[KVM_IOAPIC_NUM_PINS];
};
#define KVM_IRQCHIP_PIC_MASTER 0
#define KVM_IRQCHIP_PIC_SLAVE 1
#define KVM_IRQCHIP_IOAPIC 2
#define KVM_NR_IRQCHIPS 3
#define KVM_RUN_X86_SMM (1 << 0)
#define KVM_RUN_X86_BUS_LOCK (1 << 1)
#define KVM_RUN_X86_GUEST_MODE (1 << 2)
/* for KVM_GET_REGS and KVM_SET_REGS */
struct kvm_regs {
/* out (KVM_GET_REGS) / in (KVM_SET_REGS) */
__u64 rax, rbx, rcx, rdx;
__u64 rsi, rdi, rsp, rbp;
__u64 r8, r9, r10, r11;
__u64 r12, r13, r14, r15;
__u64 rip, rflags;
};
/* for KVM_GET_LAPIC and KVM_SET_LAPIC */
#define KVM_APIC_REG_SIZE 0x400
struct kvm_lapic_state {
char regs[KVM_APIC_REG_SIZE];
};
struct kvm_segment {
__u64 base;
__u32 limit;
__u16 selector;
__u8 type;
__u8 present, dpl, db, s, l, g, avl;
__u8 unusable;
__u8 padding;
};
struct kvm_dtable {
__u64 base;
__u16 limit;
__u16 padding[3];
};
/* for KVM_GET_SREGS and KVM_SET_SREGS */
struct kvm_sregs {
/* out (KVM_GET_SREGS) / in (KVM_SET_SREGS) */
struct kvm_segment cs, ds, es, fs, gs, ss;
Annotation
- Immediate include surface: `linux/const.h`, `linux/bits.h`, `linux/types.h`, `linux/ioctl.h`, `linux/stddef.h`.
- Detected declarations: `struct kvm_pic_state`, `struct kvm_ioapic_state`, `struct kvm_regs`, `struct kvm_lapic_state`, `struct kvm_segment`, `struct kvm_dtable`, `struct kvm_sregs`, `struct kvm_sregs2`, `struct kvm_fpu`, `struct kvm_msr_entry`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: source implementation candidate.
- IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.