Skip to main content

hyperlight_common/arch/amd64/
layout.rs

1// SPDX-License-Identifier: Apache-2.0
2// Copyright 2025 The Hyperlight Authors.
3
4// The addresses in this file should be coordinated with
5// src/hyperlight_guest/src/arch/amd64/layout.rs and
6// src/hyperlight_guest_bin/src/arch/amd64/layout.rs
7
8/// We have this the top of the page below the top of memory in order
9/// to make working with start/end ptrs in a few places more
10/// convenient (not needing to worry about overflow)
11pub const SCRATCH_TOP_GVA: usize = 0xffff_ffff_ffff_efff;
12pub const SNAPSHOT_PT_GVA_MIN: usize = 0xffff_8000_0000_0000;
13pub const SNAPSHOT_PT_GVA_MAX: usize = 0xffff_80ff_ffff_ffff;
14pub const VIRTQ_BUFFER_GVA_START: u64 = 0xffff_fc00_0000_0000;
15pub const VIRTQ_BUFFER_GVA_END: u64 = 0xffff_fd00_0000_0000;
16
17/// We assume 36-bit IPAs for now, since every amd64 processor
18/// supports at least 36 bits.  Almost all of them support at least 40
19/// bits, so we could consider bumping this in the future if we were
20/// ever memory-constrained.
21pub const SCRATCH_TOP_GPA: usize = 0x0000_000f_ffff_ffff;
22
23const _: () = {
24    assert!(VIRTQ_BUFFER_GVA_START >> 47 == 0x1ffff);
25    assert!((VIRTQ_BUFFER_GVA_END - 1) >> 47 == 0x1ffff);
26};
27
28pub fn io_page() -> Option<(u64, u64)> {
29    None
30}
31
32/// On amd64, this is:
33/// - Two pages for the TSS and IDT
34/// - (up to) 4 pages for the PTEs for mapping that (including CoW'ing the root PT)
35/// - A page for the smallest possible non-exception stack
36/// - (up to) 3 pages for mapping that
37/// - The exception stack and metadata reservation
38pub(super) fn min_scratch_size() -> Option<usize> {
39    (10 + super::SCRATCH_TOP_RESERVED_PAGES).checked_mul(crate::vmem::PAGE_SIZE)
40}