// Copyright 2020 Arm Limited (or its affiliates). All rights reserved. // Copyright © 2020, Oracle and/or its affiliates. // // Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. // SPDX-License-Identifier: Apache-2.0 #![allow( clippy::unreadable_literal, clippy::redundant_static_lifetimes, clippy::cast_lossless, clippy::transmute_ptr_to_ptr, clippy::cast_ptr_alignment )] extern crate byteorder; extern crate kvm_bindings; extern crate libc; #[cfg(feature = "acpi")] extern crate acpi_tables; extern crate arch_gen; extern crate kvm_ioctls; extern crate linux_loader; extern crate vm_memory; use kvm_ioctls::*; use std::result; #[derive(Debug)] pub enum Error { #[cfg(target_arch = "x86_64")] /// X86_64 specific error triggered during system configuration. X86_64Setup(x86_64::Error), #[cfg(target_arch = "aarch64")] /// AArch64 specific error triggered during system configuration. AArch64Setup(aarch64::Error), /// The zero page extends past the end of guest_mem. ZeroPagePastRamEnd, /// Error writing the zero page of guest memory. ZeroPageSetup(vm_memory::GuestMemoryError), /// The memory map table extends past the end of guest memory. MemmapTablePastRamEnd, /// Error writing memory map table to guest memory. MemmapTableSetup, /// The hvm_start_info structure extends past the end of guest memory. StartInfoPastRamEnd, /// Error writing hvm_start_info to guest memory. StartInfoSetup, /// Failed to compute initramfs address. InitramfsAddress, /// Error writing module entry to guest memory. ModlistSetup(vm_memory::GuestMemoryError), /// RSDP Beyond Guest Memory RSDPPastRamEnd, /// Capability missing CapabilityMissing(Cap), } pub type Result = result::Result; #[derive(PartialEq)] pub enum RegionType { /// RAM type Ram, /// SubRegion memory region. /// A SubRegion is a memory region sub-region, allowing for a region /// to be split into sub regions managed separately. /// For example, the x86 32-bit memory hole is a SubRegion. SubRegion, /// Reserved type. /// A Reserved memory region is one that should not be used for memory /// allocation. This type can be used to prevent the VMM from allocating /// memory ranges in a specific address range. Reserved, } #[cfg(target_arch = "aarch64")] pub mod aarch64; #[cfg(target_arch = "aarch64")] pub use aarch64::{ arch_memory_regions, check_required_kvm_extensions, configure_system, configure_vcpu, get_host_cpu_phys_bits, get_reserved_mem_addr, layout, layout::CMDLINE_MAX_SIZE, layout::IRQ_BASE, layout::IRQ_MAX, EntryPoint, }; #[cfg(target_arch = "x86_64")] pub mod x86_64; #[cfg(target_arch = "x86_64")] pub use x86_64::{ arch_memory_regions, check_required_kvm_extensions, configure_system, configure_vcpu, get_host_cpu_phys_bits, initramfs_load_addr, layout, layout::CMDLINE_MAX_SIZE, layout::CMDLINE_START, regs, BootProtocol, CpuidPatch, CpuidReg, EntryPoint, }; /// Safe wrapper for `sysconf(_SC_PAGESIZE)`. #[cfg(target_arch = "x86_64")] #[inline(always)] fn pagesize() -> usize { // Trivially safe unsafe { libc::sysconf(libc::_SC_PAGESIZE) as usize } } /// Type for passing information about the initramfs in the guest memory. pub struct InitramfsConfig { /// Load address of initramfs in guest memory pub address: vm_memory::GuestAddress, /// Size of initramfs in guest memory pub size: usize, }