arch: Add SubRegion memory type

We want to be able to differentiate between memory regions that must be
managed separately from the main address space (e.g. the 32-bit memory
hole) and ones that are reserved (i.e. from which we don't want to allow
the VMM to allocate address ranges.

We are going to use a reserved memory region for restricting the 32-bit
memory hole from expanding beyond the IOAPIC and TSS addresses.

Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>

arch/src/lib.rs

@@ -37,8 +37,17 @@ pub type Result<T> = result::Result<T, Error>;
 pub enum RegionType {
     /// RAM type
     Ram,
-    /// Reserved type. Designate a region which should not be considered as
-    /// RAM. Useful to specify a PCI hole for instance.
+
+    /// 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,
 }
 

arch/src/x86_64/mod.rs

@@ -77,11 +77,11 @@ pub fn arch_memory_regions(size: GuestUsize) -> Vec<(GuestAddress, usize, Region
         ));
     }
 
-    // Add the 32 bits hole as a "reserved" region.
+    // Add the 32 bits hole as a sub region.
     regions.push((
         memory_gap_start,
         MEM_32BIT_GAP_SIZE as usize,
-        RegionType::Reserved,
+        RegionType::SubRegion,
     ));
 
     regions