CHANGELOG.md

Changelog

uefi - [Unreleased]

Added

• Added PhysicalAddress and VirtualAddress type aliases.
• Added Guid::from_bytes and Guid::to_bytes.
• Added UnalignedSlice for representing a reference to an unaligned slice.
• Added DeviceSubType::MESSAGING_REST_SERVICE and DeviceSubType::MESSAGING_NVME_OF_NAMESPACE.
• Added MemoryAttribute::SPECIAL_PURPOSE, MemoryAttribute::CPU_CRYPTO, MemoryAttribute::ISA_VALID, and MemoryAttribute::ISA_MASK.

Changed

• Fixed the definition of AllocateType so that MaxAddress and Address always take a 64-bit value, regardless of target platform.
• The conversion methods on DevicePathToText and DevicePathFromText now return a uefi::Result instead of an Option.
• Event is now a newtype around NonNull<c_void> instead of *mut c_void.
• Changed SystemTable::firmware_revision to return a u32 instead of a Revision. The firmware revision's format is vendor specific and may not have the same semantics as the UEFI revision.
• Changed Revision to repr(transparent).
• Add Revision::EFI_2_100 constant.
• The Revision type now implements Display with correct formatting for all UEFI versions. The custom Debug impl has been removed and replaced with a derived Debug impl.
• CStr16::from_u16_with_nul_unchecked and cstr16! are now allowed in const contexts.

Removed

• Removed UnalignedCStr16; use UnalignedSlice instead. An UnalignedSlice<u16> can be converted to a string with to_cstr16 or to_cstring16.

uefi-macros - [Unreleased]

Added

• Added a guid! macro. This is similar to Guid::from_values, but takes a more convenient string argument like the unsafe_guid! attribute macro.

uefi-services - [Unreleased]

Changed

• Changed the panic handler log message to use println! instead of error!. This removes an extraneous file name and line number from the log message.

• Added a logger feature which reflects the same feature in uefi. This allows using both crates while disabling logger in uefi, which was previously impossible.

uefi - 0.17.0

Added

• Added Deref and DerefMut trait implementations to ScopedProtocol. This eliminates the need to explicitly access the interface field, which is now marked as deprecated.
• Implemented core::fmt::Write for the Serial protocol.
• Added the MemoryProtection protocol.
• Added BootServices::get_handle_for_protocol.
• Added trait EqStrUntilNul and implemented it for CStr8, CStr16, and CString16 (CString8 doesn't exist yet). Now you can compare everything that is AsRef<str> (such as String and str from the standard library) to UEFI strings. Please head to the documentation of EqStrUntilNul to find out limitations and further information.
• Added BootServices::image_handle to get the handle of the executing image. The image is set automatically by the #[entry] macro; if a program does not use that macro then it should call BootServices::set_image_handle.
• Added BootServices::open_protocol_exclusive. This provides a safe and convenient subset of open_protocol that can be used whenever a resource doesn't need to be shared. In same cases sharing is useful (e.g. you might want to draw to the screen using the graphics protocol, but still allow stdout output to go to the screen as well), and in those cases open_protocol can still be used.
• Added DiskIo and DiskIo2 protocols.
• Added HardDriveMediaDevicePath and related types.
• Added PartialOrd and Ord to the traits derived by Guid.
• The File trait now knows the methods is_regular_file and is_directory. Developers profit from this on the struct FileHandle, for example.

Changed

• Marked BootServices::handle_protocol as unsafe. (This method is also deprecated -- use open_protocol_exclusive or open_protocol instead.)
• Deprecated BootServices::locate_protocol and marked it unsafe. Use BootServices::get_handle_for_protocol and BootServices::open_protocol_exclusive (or BootServices::open_protocol) instead.
• Renamed feature ignore-logger-errors to panic-on-logger-errors so that it is additive. It is now a default feature.
• Corrected the name of BlockIOMedia::is_media_preset to is_media_present.

Removed

• Removed the exts::allocate_buffer function. This function could cause undefined behavior when called with a Layout with an alignment other than 1. A safe alternative is to use Vec::into_boxed_slice.
• Removed From conversions from ucs2::Error to Status and Error.
• Removed use of the unstable try_trait_v2 feature, which allowed ? to be used with Status in a function returning uefi::Result. This can be replaced by calling status.into(), or Result::from(status) in cases where the compiler needs a type hint.

uefi-macros - 0.8.0

Changed

• The #[entry] macro now calls BootServices::set_image_handle to set the global image handle. Due to this change, the two arguments to main must both be named (e.g. image: Handle and _image: Handle are both OK, but not _: Handle).

uefi-services - 0.14.0

Added

• Added print! and println! macros.

Changed

• The no_panic_handler feature has been replaced with an additive panic_handler feature. The new feature is enabled by default.

uefi - 0.16.1

Added

• Added EFI revision constants to Revision.

Fixed

• The table Header struct's Debug impl now prints the correct signature.
• The BootServices::create_event_ex and RuntimeServices::query_variable_info methods now check the table version to make sure it's 2.0 or higher before calling the associated function pointers. This prevents potential invalid pointer access.
• Fixed an incorrect pointer cast in the Rng protocol that could cause undefined behavior.

Changed

• Relaxed the version requirements for the bitflags and log dependencies to allow earlier patch versions.
• Enabled doc_auto_cfg on docs.rs to show badges on items that are gated behind a feature.

uefi-macros - 0.7.1

Changed

• Relaxed the version requirements for the proc-macro2, quote, and sync dependencies to allow earlier patch versions.

uefi-services - 0.13.1

Changed

• Relaxed the version requirements for the log dependency to allow earlier patch versions.

uefi - 0.16.0

Added

• Added FileHandle::into_directory and FileHandle::into_regular_file.
• Added TimeParams, Time::invalid, and Time::is_invalid.
• Added RuntimeServices::query_variable_info and VariableStorageInfo.
• Added DevicePathToText and DevicePathFromText.
• Added LoadedImage::file_path
• Implemented TryFrom<Vec<u16>> for CString16.
• Added UnalignedCStr16.
• Added FilePathMediaDevicePath.
• Added DevicePath::as_acpi_device_path and DevicePath::as_file_path_media_device_path.
• Included cstr8 and cstr16 macros from uefi-macros in the prelude.
• Added DevicePathInstance, DevicePathNode, and FfiDevicePath.

Changed

• Time::new now takes a single TimeParams argument so that date and time fields can be explicitly named at the call site.
• The file info types now derive PartialEq and Eq.
• The FileAttributes type is now repr(transparent).
• DevicePath is now a DST that represents an entire device path. The DevicePathInstance and DevicePathNode provide views of path instances and nodes, respectively.
• The methods of Revision are now const.

Fixed

• Fixed undefined behavior in proto::media::file::File::get_boxed_info.

uefi-macros - 0.7.0

Added

• Added cstr8 and cstr16 macros for creating CStr8/CStr16 string literals at compile time.

uefi-services - 0.13.0

Changed

• Bumped uefi dependency to latest version.

uefi - 0.15.2

Added

• Added PartialEq impls for CStr16 == CStr16, &CStr16 == CString, and CString == &CStr16.
• Added Display impl for CString16.
• Added Handle::from_ptr and SystemTable<View>::from_ptr, which are unsafe methods for initializing from a raw pointer.
• Added CStr16::as_slice_with_nul to provide immutable access to the underlying slice.
• Added LoadedImage::load_options_as_bytes and LoadedImage::load_options_as_cstr16.
• Added Align::offset_up_to_alignment, Align::round_up_to_alignment, and Align::align_buf.
• Added BootServices::connect_controller and BootServices::disconnect_controller.
• Added BootServices::load_image and LoadImageSource. Together these replace BootServices::load_image_from_buffer and also allow an image to be loaded via the SimpleFileSystem protocol.
• Added Rng protocol.
• Added GptPartitionAttributes struct and associated constants.
• Added Output::output_string_lossy.
• Added ResultExt::handle_warning.

Changed

• Updated to the 2021 edition.
• File::open now takes the filename as &CStr16 instead of &str, avoiding an implicit string conversion.
• FileInfo::new, FileSystemInfo::new, and FileSystemVolumeLabel::new now take their name parameter as &CStr16 instead of &str, avoiding an implicit string conversion. Additionally, an unaligned storage buffer is now allowed as long as it is big enough to provide an aligned subslice.
• LoadImage::set_load_options now takes a u8 pointer instead of Char16.
• The Error type is now public.
• The type of GptPartitionEntry.attributes is now GptPartitionAttributes.
• The uefi::Result type now treats UEFI warnings as errors by default. The uefi::Result::Ok variant no longer contains a Completion, so the type behaves more like a regular Rust Result type.

Removed

• Removed CStr16::as_string method. Use ToString instead.
• Removed FileInfoCreationError::InvalidChar. This error type is no longer needed due to the removal of implicit string conversions in file info types.
• Removed LoadedImage::load_options, use LoadedImage::load_options_as_bytes or LoadedImage::load_options_as_cstr16 instead.
• Removed NamedFileProtocolInfo, FileInfoHeader, FileSystemInfoHeader, and FileSystemVolumeLabelHeader. Use FileInfo, FileSystemInfo, and FileSystemVolumeLabel instead.
• Removed BootServices::load_image_from_buffer. Use BootServices::load_image instead.
• Removed Completion type. Warnings are now treated as errors.
• Removed many ResultExt methods, for most of them the standard Result methods can be used instead. Use unwrap instead of unwrap_success, expect instead of expect_success, expect_err instead of expect_error, and map instead of map_inner. The log_warning method has also been removed, use the new ResultExt::handle_warning method instead.

Fixed

• Fixed compilation with Rust 1.60 by no longer enabling the vec_spare_capacity feature, which has been stabilized.
• Fixed the header size calculated by FileInfo::new and FileSystemInfo::new.
• Fixed incorrect alignment of the volume label field in FileSystemInfo. This caused the beginning of the string to be truncated and could result in out-of-bounds reads.
• Fixed size check for file info types so that alignment padding is taken into account. This fixes potential out-of-bounds writes.

uefi-macros - 0.6.1

Changed

• Updated to the 2021 edition.

uefi-services - 0.12.1

Changed

• Updated to the 2021 edition.