Implement guest page size policy

Signed-off-by: Michael Jarrett <1077485+EmeraldShift@users.noreply.github.com>

Author: EmeraldShift

src/mmap.rs

@@ -70,6 +70,17 @@ pub enum Error {
     UnsortedMemoryRegions,
 }
 
+/// Page configuration types for controlling allocation size and behavior
+#[derive(Debug, Copy, Clone, PartialEq)]
+pub enum PageSizePolicy {
+    /// Base pages are the smallest page-size unit available on the system.
+    BasePages,
+    /// Transparent hugepages, if available, are managed by the host operating system.
+    TransparentHugepages,
+    /// Explicit hugepages swear a lot. Especially if the addresses aren't aligned.
+    ExplicitHugepages,
+}
+
 impl fmt::Display for Error {
     fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
         match self {
@@ -426,16 +437,44 @@ impl GuestMemoryMmap {
     ///
     /// Valid memory regions are specified as a slice of (Address, Size) tuples sorted by Address.
     pub fn from_ranges(ranges: &[(GuestAddress, usize)]) -> result::Result<Self, Error> {
-        Self::from_ranges_with_files(ranges.iter().map(|r| (r.0, r.1, None)))
+        Self::from_ranges_with_options(
+            ranges
+                .iter()
+                .map(|r| (r.0, r.1, PageSizePolicy::BasePages, None)),
+        )
+    }
+
+    /// Creates a container and allocates anonymous memory for guest memory regions.
+    ///
+    /// Valid memory regions are specified as asequence of (Address, Size, PageSizePolicy)
+    /// tuples sorted by Address.
+    pub fn from_ranges_with_policy(
+        ranges: &[(GuestAddress, usize, PageSizePolicy)],
+    ) -> result::Result<Self, Error> {
+        Self::from_ranges_with_options(ranges.iter().map(|r| (r.0, r.1, r.2, None)))
+    }
+
+    /// Creates a container and allocates anonymous memory for guest memory regions.
+    ///
+    /// Valid memory regions are specified as a sequence of (Address, Size, Option<FileOffset>)
+    /// tuples sorted by Address.
+    pub fn from_ranges_with_files<A, T>(
+        ranges: &[(GuestAddress, usize, Option<FileOffset>)],
+    ) -> result::Result<Self, Error> {
+        Self::from_ranges_with_options(
+            ranges
+                .iter()
+                .map(|r| (r.0, r.1, PageSizePolicy::BasePages, r.2.clone())),
+        )
     }
 
     /// Creates a container and allocates anonymous memory for guest memory regions.
     ///
     /// Valid memory regions are specified as a sequence of (Address, Size, Option<FileOffset>)
     /// tuples sorted by Address.
-    pub fn from_ranges_with_files<A, T>(ranges: T) -> result::Result<Self, Error>
+    pub fn from_ranges_with_options<A, T>(ranges: T) -> result::Result<Self, Error>
     where
-        A: Borrow<(GuestAddress, usize, Option<FileOffset>)>,
+        A: Borrow<(GuestAddress, usize, PageSizePolicy, Option<FileOffset>)>,
         T: IntoIterator<Item = A>,
     {
         Self::from_regions(
@@ -444,11 +483,12 @@ impl GuestMemoryMmap {
                 .map(|x| {
                     let guest_base = x.borrow().0;
                     let size = x.borrow().1;
+                    let policy = x.borrow().2;
 
-                    if let Some(ref f_off) = x.borrow().2 {
-                        MmapRegion::from_file(f_off.clone(), size)
+                    if let Some(ref f_off) = x.borrow().3 {
+                        MmapRegion::from_file(f_off.clone(), size, policy)
                     } else {
-                        MmapRegion::new(size)
+                        MmapRegion::new(size, policy)
                     }
                     .map_err(Error::MmapRegion)
                     .and_then(|r| GuestRegionMmap::new(r, guest_base))

src/mmap_unix.rs

@@ -18,7 +18,7 @@ use std::ptr::null_mut;
 use std::result;
 
 use crate::guest_memory::FileOffset;
-use crate::mmap::{check_file_offset, AsSlice};
+use crate::mmap::{check_file_offset, AsSlice, PageSizePolicy};
 use crate::volatile_memory::{self, compute_offset, VolatileMemory, VolatileSlice};
 
 /// Error conditions that may arise when creating a new `MmapRegion` object.
@@ -90,6 +90,7 @@ pub struct MmapRegion {
     prot: i32,
     flags: i32,
     owned: bool,
+    policy: PageSizePolicy,
 }
 
 // Send and Sync aren't automatically inherited for the raw address pointer.
@@ -104,12 +105,13 @@ impl MmapRegion {
     ///
     /// # Arguments
     /// * `size` - The size of the memory region in bytes.
-    pub fn new(size: usize) -> Result<Self> {
+    pub fn new(size: usize, policy: PageSizePolicy) -> Result<Self> {
         Self::build(
             None,
             size,
             libc::PROT_READ | libc::PROT_WRITE,
             libc::MAP_ANONYMOUS | libc::MAP_NORESERVE | libc::MAP_PRIVATE,
+            policy,
         )
     }
 
@@ -119,12 +121,13 @@ impl MmapRegion {
     /// * `file_offset` - The mapping will be created at offset `file_offset.start` in the file
     ///                   referred to by `file_offset.file`.
     /// * `size` - The size of the memory region in bytes.
-    pub fn from_file(file_offset: FileOffset, size: usize) -> Result<Self> {
+    pub fn from_file(file_offset: FileOffset, size: usize, policy: PageSizePolicy) -> Result<Self> {
         Self::build(
             Some(file_offset),
             size,
             libc::PROT_READ | libc::PROT_WRITE,
             libc::MAP_NORESERVE | libc::MAP_SHARED,
+            policy,
         )
     }
 
@@ -143,6 +146,7 @@ impl MmapRegion {
         size: usize,
         prot: i32,
         flags: i32,
+        policy: PageSizePolicy,
     ) -> Result<Self> {
         // Forbid MAP_FIXED, as it doesn't make sense in this context, and is pretty dangerous
         // in general.
@@ -157,6 +161,13 @@ impl MmapRegion {
             (-1, 0)
         };
 
+        // Support explicit (pre-reserved) hugepages if requested
+        let flags = if policy == PageSizePolicy::ExplicitHugepages {
+            flags | libc::MAP_HUGETLB
+        } else {
+            flags
+        };
+
         // This is safe because we're not allowing MAP_FIXED, and invalid parameters cannot break
         // Rust safety guarantees (things may change if we're mapping /dev/mem or some wacky file).
         let addr = unsafe { libc::mmap(null_mut(), size, prot, flags, fd, offset as libc::off_t) };
@@ -165,13 +176,21 @@ impl MmapRegion {
             return Err(Error::Mmap(io::Error::last_os_error()));
         }
 
+        // Support transparent hugepages if requested
+        if policy == PageSizePolicy::TransparentHugepages {
+            unsafe {
+                libc::madvise(addr, size, libc::MADV_HUGEPAGE);
+            };
+        }
+
         Ok(Self {
             addr: addr as *mut u8,
             size,
             file_offset,
             prot,
             flags,
             owned: true,
+            policy,
         })
     }
 
@@ -213,6 +232,7 @@ impl MmapRegion {
             prot,
             flags,
             owned: false,
+            policy: PageSizePolicy::BasePages,
         })
     }
 
@@ -248,6 +268,11 @@ impl MmapRegion {
         self.owned
     }
 
+    /// Returns information regarding the page size policy backing this region.
+    pub fn policy(&self) -> PageSizePolicy {
+        self.policy
+    }
+
     /// Checks whether this region and `other` are backed by overlapping
     /// [`FileOffset`](struct.FileOffset.html) objects.
     ///

src/mmap_windows.rs

@@ -13,7 +13,7 @@ use libc::{c_void, size_t};
 use winapi::um::errhandlingapi::GetLastError;
 
 use crate::guest_memory::FileOffset;
-use crate::mmap::AsSlice;
+use crate::mmap::{AsSlice, PageSizePolicy};
 use crate::volatile_memory::{self, compute_offset, VolatileMemory, VolatileSlice};
 
 #[allow(non_snake_case)]
@@ -88,7 +88,8 @@ impl MmapRegion {
     ///
     /// # Arguments
     /// * `size` - The size of the memory region in bytes.
-    pub fn new(size: usize) -> io::Result<Self> {
+    /// * `policy` - Unimplemented on Windows platforms.
+    pub fn new(size: usize, _policy: PageSizePolicy) -> io::Result<Self> {
         if (size == 0) || (size > MM_HIGHEST_VAD_ADDRESS as usize) {
             return Err(io::Error::from_raw_os_error(libc::EINVAL));
         }
@@ -111,7 +112,12 @@ impl MmapRegion {
     /// * `file_offset` - The mapping will be created at offset `file_offset.start` in the file
     ///                   referred to by `file_offset.file`.
     /// * `size` - The size of the memory region in bytes.
-    pub fn from_file(file_offset: FileOffset, size: usize) -> io::Result<Self> {
+    /// * `policy` - Unimplemented on Windows platforms.
+    pub fn from_file(
+        file_offset: FileOffset,
+        size: usize,
+        _policy: PageSizePolicy,
+    ) -> io::Result<Self> {
         let handle = file_offset.file().as_raw_handle();
         if handle == INVALID_HANDLE_VALUE {
             return Err(io::Error::from_raw_os_error(libc::EBADF));