arch/riscv/include/asm/kvm_vcpu_insn.h

File Facts

System

Linux kernel

Corpus path

arch/riscv/include/asm/kvm_vcpu_insn.h

Extension

.h

Size

1234 bytes

Lines

49

Domain

Architecture Layer

Bucket

arch/riscv

Inferred role

Architecture Layer: implementation source

Status

source implementation candidate

Why This File Exists

CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.

• CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• No C-style include directives detected by the generator.

Detected Declarations

• struct kvm_vcpu
• struct kvm_run
• struct kvm_cpu_trap
• struct kvm_mmio_decode
• struct kvm_csr_decode
• enum kvm_insn_return

Annotated Snippet

struct kvm_mmio_decode {
	unsigned long insn;
	int insn_len;
	int len;
	int shift;
	int return_handled;
};

struct kvm_csr_decode {
	unsigned long insn;
	int return_handled;
};

/* Return values used by function emulating a particular instruction */
enum kvm_insn_return {
	KVM_INSN_EXIT_TO_USER_SPACE = 0,
	KVM_INSN_CONTINUE_NEXT_SEPC,
	KVM_INSN_CONTINUE_SAME_SEPC,
	KVM_INSN_ILLEGAL_TRAP,
	KVM_INSN_VIRTUAL_TRAP
};

void kvm_riscv_vcpu_wfi(struct kvm_vcpu *vcpu);
int kvm_riscv_vcpu_csr_return(struct kvm_vcpu *vcpu, struct kvm_run *run);
int kvm_riscv_vcpu_virtual_insn(struct kvm_vcpu *vcpu, struct kvm_run *run,
				struct kvm_cpu_trap *trap);

int kvm_riscv_vcpu_mmio_load(struct kvm_vcpu *vcpu, struct kvm_run *run,
			     unsigned long fault_addr,
			     unsigned long htinst);
int kvm_riscv_vcpu_mmio_store(struct kvm_vcpu *vcpu, struct kvm_run *run,
			      unsigned long fault_addr,
			      unsigned long htinst);
int kvm_riscv_vcpu_mmio_return(struct kvm_vcpu *vcpu, struct kvm_run *run);

#endif

Annotation

• Detected declarations: `struct kvm_vcpu`, `struct kvm_run`, `struct kvm_cpu_trap`, `struct kvm_mmio_decode`, `struct kvm_csr_decode`, `enum kvm_insn_return`.
• Atlas domain: Architecture Layer / arch/riscv.
• Implementation status: source implementation candidate.

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.