relicensing: Rewrite PR "allocator: Use appropriate memory types"

The allocator code has already changed a fair amount since that PR landed, so
only docstrings needed to be rewritten.

This covers these commits:
9dbdfe9
e6803d7

Author: nicholasbishop

uefi/src/allocator.rs

@@ -7,13 +7,12 @@
 //! services are not active, `alloc` will return a null pointer, and `dealloc`
 //! will panic.
 
-use core::alloc::{GlobalAlloc, Layout};
-use core::ptr::{self, NonNull};
-use core::sync::atomic::{AtomicU32, Ordering};
-
 use crate::boot;
 use crate::mem::memory_map::MemoryType;
 use crate::proto::loaded_image::LoadedImage;
+use core::alloc::{GlobalAlloc, Layout};
+use core::ptr::{self, NonNull};
+use core::sync::atomic::{AtomicU32, Ordering};
 
 /// Get the memory type to use for allocation.
 ///
@@ -48,9 +47,11 @@ fn get_memory_type() -> MemoryType {
 pub struct Allocator;
 
 unsafe impl GlobalAlloc for Allocator {
-    /// Allocate memory using [`boot::allocate_pool`]. The allocation is
-    /// of type [`MemoryType::LOADER_DATA`] for UEFI applications, [`MemoryType::BOOT_SERVICES_DATA`]
-    /// for UEFI boot drivers and [`MemoryType::RUNTIME_SERVICES_DATA`] for UEFI runtime drivers.
+    /// Allocate memory using [`boot::allocate_pool`]. The allocation's [memory
+    /// type] matches the current image's [data type].
+    ///
+    /// [memory type]: MemoryType
+    /// [data type]: LoadedImage::data_type
     unsafe fn alloc(&self, layout: Layout) -> *mut u8 {
         if !boot::are_boot_services_active() {
             return ptr::null_mut();

uefi/src/proto/loaded_image.rs

@@ -180,23 +180,13 @@ impl LoadedImage {
         (self.0.image_base, self.0.image_size)
     }
 
-    /// Get the memory type of the image's code sections.
-    ///
-    /// Normally the returned value is one of:
-    ///  - `MemoryType::LOADER_CODE` for UEFI applications
-    ///  - `MemoryType::BOOT_SERVICES_CODE` for UEFI boot drivers
-    ///  - `MemoryType::RUNTIME_SERVICES_CODE` for UEFI runtime drivers
+    /// Returns the memory type that the image's code sections were loaded as.
     #[must_use]
     pub const fn code_type(&self) -> MemoryType {
         self.0.image_code_type
     }
 
-    /// Get the memory type of the image's data sections.
-    ///
-    /// Normally the returned value is one of:
-    ///  - `MemoryType::LOADER_DATA` for UEFI applications
-    ///  - `MemoryType::BOOT_SERVICES_DATA` for UEFI boot drivers
-    ///  - `MemoryType::RUNTIME_SERVICES_DATA` for UEFI runtime drivers
+    /// Returns the memory type that the image's data sections were loaded as.
     #[must_use]
     pub const fn data_type(&self) -> MemoryType {
         self.0.image_data_type