Module handoff

BootHandoff structure.

Data passed from UEFI boot phase to bare-metal phase. Populated before ExitBootServices, consumed after.

Layout

All fields are explicitly sized and aligned for ABI stability. The structure is #[repr(C)] to ensure predictable memory layout across Rust/ASM boundary.

Reference

NETWORK_IMPL_GUIDE.md §7.2

Structs

• BootHandoff
  Data passed from UEFI boot phase to bare-metal phase.
• TscCalibration
  TSC calibration result.

Enums

• HandoffError
  Errors during handoff validation.

Constants

• BLK_TYPE_AHCI
  AHCI/SATA device (future)
• BLK_TYPE_NONE
  No block device
• BLK_TYPE_NVME
  NVMe device (future)
• BLK_TYPE_VIRTIO
  VirtIO-blk device
• HANDOFF_MAGIC
  Magic number: “MORPHEUS” in ASCII (little-endian)
• HANDOFF_VERSION
  Current structure version
• MAX_TSC_FREQ
  Maximum TSC frequency (10 GHz - sanity check)
• MIN_DMA_SIZE
  Minimum DMA region size (2MB)
• MIN_STACK_SIZE
  Minimum stack size (64KB)
• MIN_TSC_FREQ
  Minimum TSC frequency (1 GHz - sanity check)
• NIC_TYPE_BROADCOM
  Broadcom BCM57xx
• NIC_TYPE_INTEL
  Intel e1000/i210/i225
• NIC_TYPE_NONE
  No NIC detected
• NIC_TYPE_REALTEK
  Realtek RTL8168/8111
• NIC_TYPE_VIRTIO
  VirtIO-net device
• TRANSPORT_MMIO
  VirtIO MMIO transport
• TRANSPORT_PCI_LEGACY
  VirtIO PCI Legacy transport (I/O ports)
• TRANSPORT_PCI_MODERN
  VirtIO PCI Modern transport (capability-based)

Functions

• has_invariant_tsc
  Check if CPU has invariant TSC via CPUID.
• read_tsc_raw
  Read TSC value directly (used for calibration).