axvm 0.5.0

Virtual Machine resource management crate for ArceOS's hypervisor variant.
Documentation
// Copyright 2025 The Axvisor Team
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use memory_addr::{PAGE_SIZE_4K, PhysAddr, VirtAddr};
use page_table_multiarch::PagingHandler;

pub struct PagingHandlerImpl;

impl PagingHandler for PagingHandlerImpl {
    fn alloc_frames(num: usize, align: usize) -> Option<PhysAddr> {
        let align_frames = if align.is_multiple_of(PAGE_SIZE_4K) {
            align / PAGE_SIZE_4K
        } else {
            panic!("align must be multiple of PAGE_SIZE_4K")
        };

        let align_frames_pow2 = if align_frames.is_power_of_two() {
            align_frames.trailing_zeros()
        } else {
            panic!("align must be a power of 2")
        };

        axvisor_api::memory::alloc_contiguous_frames(num, align_frames_pow2 as _)
    }

    fn dealloc_frames(paddr: PhysAddr, num: usize) {
        axvisor_api::memory::dealloc_contiguous_frames(paddr, num);
    }

    fn alloc_frame() -> Option<PhysAddr> {
        axvisor_api::memory::alloc_frame()
    }

    fn dealloc_frame(paddr: PhysAddr) {
        axvisor_api::memory::dealloc_frame(paddr)
    }

    fn phys_to_virt(paddr: PhysAddr) -> VirtAddr {
        axvisor_api::memory::phys_to_virt(paddr)
    }
}