arch/arm64/kvm/hyp/nvhe/hyp-main.c
Source file repositories/reference/linux-study-clean/arch/arm64/kvm/hyp/nvhe/hyp-main.c
File Facts
- System
- Linux kernel
- Corpus path
arch/arm64/kvm/hyp/nvhe/hyp-main.c- Extension
.c- Size
- 26503 bytes
- Lines
- 944
- Domain
- Architecture Layer
- Bucket
- arch/arm64
- 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
hyp/adjust_pc.hhyp/switch.hasm/pgtable-types.hasm/kvm_asm.hasm/kvm_emulate.hasm/kvm_host.hasm/kvm_hyp.hasm/kvm_hypevents.hasm/kvm_mmu.hnvhe/ffa.hnvhe/mem_protect.hnvhe/mm.hnvhe/pkvm.hnvhe/trace.hnvhe/trap_handler.h
Detected Declarations
function __hyp_sve_save_guestfunction __hyp_sve_restore_hostfunction fpsimd_sve_flushfunction fpsimd_sve_syncfunction flush_debug_statefunction sync_debug_statefunction flush_hyp_vcpufunction sync_hyp_vcpufunction handle___pkvm_vcpu_loadfunction handle___pkvm_vcpu_putfunction handle___kvm_vcpu_runfunction KVMfunction pkvm_refill_memcachefunction handle___pkvm_host_donate_guestfunction handle___pkvm_host_share_guestfunction handle___pkvm_host_unshare_guestfunction handle___pkvm_host_relax_perms_guestfunction handle___pkvm_host_wrprotect_guestfunction handle___pkvm_host_test_clear_young_guestfunction handle___pkvm_host_mkyoung_guestfunction handle___kvm_adjust_pcfunction handle___kvm_flush_vm_contextfunction handle___kvm_tlb_flush_vmid_ipafunction handle___kvm_tlb_flush_vmid_ipa_nshfunction handle___kvm_tlb_flush_vmid_rangefunction handle___kvm_tlb_flush_vmidfunction handle___pkvm_tlb_flush_vmidfunction handle___kvm_flush_cpu_contextfunction handle___kvm_timer_set_cntvofffunction handle___kvm_enable_ssbsfunction handle___vgic_v3_get_gic_configfunction handle___vgic_v3_init_lrsfunction handle___vgic_v3_save_aprsfunction handle___vgic_v3_restore_vmcr_aprsfunction handle___pkvm_initfunction handle___pkvm_cpu_set_vectorfunction handle___pkvm_host_share_hypfunction handle___pkvm_host_unshare_hypfunction handle___pkvm_create_private_mappingfunction handle___pkvm_prot_finalizefunction handle___pkvm_reserve_vmfunction handle___pkvm_unreserve_vmfunction handle___pkvm_init_vmfunction handle___pkvm_init_vcpufunction handle___pkvm_vcpu_in_poison_faultfunction handle___pkvm_force_reclaim_guest_pagefunction handle___pkvm_reclaim_dying_guest_pagefunction handle___pkvm_start_teardown_vm
Annotated Snippet
if (unlikely(system_supports_sme() && read_sysreg_s(SYS_SVCR))) {
ret = -EINVAL;
goto out;
}
if (!hyp_vcpu) {
ret = -EINVAL;
goto out;
}
flush_hyp_vcpu(hyp_vcpu);
ret = __kvm_vcpu_run(&hyp_vcpu->vcpu);
sync_hyp_vcpu(hyp_vcpu);
} else {
struct kvm_vcpu *vcpu = kern_hyp_va(host_vcpu);
/* The host is fully trusted, run its vCPU directly. */
fpsimd_lazy_switch_to_guest(vcpu);
ret = __kvm_vcpu_run(vcpu);
fpsimd_lazy_switch_to_host(vcpu);
}
out:
cpu_reg(host_ctxt, 1) = ret;
}
static int pkvm_refill_memcache(struct pkvm_hyp_vcpu *hyp_vcpu)
{
struct kvm_vcpu *host_vcpu = hyp_vcpu->host_vcpu;
return refill_memcache(&hyp_vcpu->vcpu.arch.pkvm_memcache,
host_vcpu->arch.pkvm_memcache.nr_pages,
&host_vcpu->arch.pkvm_memcache);
}
static void handle___pkvm_host_donate_guest(struct kvm_cpu_context *host_ctxt)
{
DECLARE_REG(u64, pfn, host_ctxt, 1);
DECLARE_REG(u64, gfn, host_ctxt, 2);
struct pkvm_hyp_vcpu *hyp_vcpu;
int ret = -EINVAL;
hyp_vcpu = pkvm_get_loaded_hyp_vcpu();
if (!hyp_vcpu || !pkvm_hyp_vcpu_is_protected(hyp_vcpu))
goto out;
ret = pkvm_refill_memcache(hyp_vcpu);
if (ret)
goto out;
ret = __pkvm_host_donate_guest(pfn, gfn, hyp_vcpu);
out:
cpu_reg(host_ctxt, 1) = ret;
}
static void handle___pkvm_host_share_guest(struct kvm_cpu_context *host_ctxt)
{
DECLARE_REG(u64, pfn, host_ctxt, 1);
DECLARE_REG(u64, gfn, host_ctxt, 2);
DECLARE_REG(u64, nr_pages, host_ctxt, 3);
DECLARE_REG(enum kvm_pgtable_prot, prot, host_ctxt, 4);
struct pkvm_hyp_vcpu *hyp_vcpu;
int ret = -EINVAL;
hyp_vcpu = pkvm_get_loaded_hyp_vcpu();
if (!hyp_vcpu || pkvm_hyp_vcpu_is_protected(hyp_vcpu))
goto out;
ret = pkvm_refill_memcache(hyp_vcpu);
if (ret)
goto out;
ret = __pkvm_host_share_guest(pfn, gfn, nr_pages, hyp_vcpu, prot);
out:
cpu_reg(host_ctxt, 1) = ret;
}
static void handle___pkvm_host_unshare_guest(struct kvm_cpu_context *host_ctxt)
{
DECLARE_REG(pkvm_handle_t, handle, host_ctxt, 1);
DECLARE_REG(u64, gfn, host_ctxt, 2);
DECLARE_REG(u64, nr_pages, host_ctxt, 3);
struct pkvm_hyp_vm *hyp_vm;
int ret = -EINVAL;
hyp_vm = get_np_pkvm_hyp_vm(handle);
if (!hyp_vm)
goto out;
Annotation
- Immediate include surface: `hyp/adjust_pc.h`, `hyp/switch.h`, `asm/pgtable-types.h`, `asm/kvm_asm.h`, `asm/kvm_emulate.h`, `asm/kvm_host.h`, `asm/kvm_hyp.h`, `asm/kvm_hypevents.h`.
- Detected declarations: `function __hyp_sve_save_guest`, `function __hyp_sve_restore_host`, `function fpsimd_sve_flush`, `function fpsimd_sve_sync`, `function flush_debug_state`, `function sync_debug_state`, `function flush_hyp_vcpu`, `function sync_hyp_vcpu`, `function handle___pkvm_vcpu_load`, `function handle___pkvm_vcpu_put`.
- Atlas domain: Architecture Layer / arch/arm64.
- 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.