Add RuntimeServices::update_capsule

This allows passing capsules[1] to firmware.

Firmware updates cannot be explicitly tested as it is not supported by OVMF.

[1]:https://uefi.org/specs/UEFI/2.9_A/08_Services_Runtime_Services.html#update-capsule

Author: andre-braga

uefi/CHANGELOG.md

@@ -1,5 +1,8 @@
 # uefi - [Unreleased]
 
+## Added
+- Added `RuntimeServices::update_capsule`.
+
 ## Removed
 - Removed the `panic-on-logger-errors` feature of the `uefi` crate. Logger
   errors are now silently ignored.

uefi/src/table/runtime.rs

@@ -7,10 +7,12 @@ use core::fmt::{self, Debug, Display, Formatter};
 use core::mem::MaybeUninit;
 use core::ptr;
 
+pub use uefi_raw::capsule::{CapsuleBlockDescriptor, CapsuleHeader};
 pub use uefi_raw::table::runtime::{
     ResetType, TimeCapabilities, VariableAttributes, VariableVendor,
 };
 pub use uefi_raw::time::Daylight;
+pub use uefi_raw::PhysicalAddress;
 
 #[cfg(feature = "alloc")]
 use {
@@ -290,6 +292,23 @@ impl RuntimeServices {
     ) -> Status {
         (self.0.set_virtual_address_map)(map_size, desc_size, desc_version, virtual_map)
     }
+
+    /// Passes capsules to the firmware. Capsules are most commonly used to update the firmware
+    /// or for by the operating system to have information persist across a system reset.
+    pub fn update_capsule(
+        &self,
+        capsule_header_array: &[&CapsuleHeader],
+        capsule_block_descriptors: &[CapsuleBlockDescriptor],
+    ) -> Result {
+        unsafe {
+            (self.0.update_capsule)(
+                capsule_header_array.as_ptr().cast(),
+                capsule_header_array.len(),
+                capsule_block_descriptors.as_ptr() as PhysicalAddress,
+            )
+            .to_result()
+        }
+    }
 }
 
 impl super::Table for RuntimeServices {