Struct Multiboot2Header 

pub struct Multiboot2Header<'a>(/* private fields */);

Wrapper type around a pointer to the Multiboot2 header.

The Multiboot2 header is the Multiboot2BasicHeader followed by all tags (see crate::tags::HeaderTagType). Use this if you get a pointer to the header and just want to parse it. If you want to construct the type by yourself, please look at HeaderBuilder (requires the builder feature).

Implementations

impl<'a> Multiboot2Header<'a>

pub unsafe fn load(ptr: *const Multiboot2BasicHeader) -> Result<Self, LoadError>

Loads the Multiboot2Header from a pointer.

If the header is invalid, it returns a LoadError. This may be because:

• ptr is a null pointer
• ptr is not 8-byte aligned
• the reported total size is invalid
• the magic value of the header is not present
• the checksum field is invalid
• the tag sequence is incomplete or malformed
• the mandatory end tag is missing

Safety

• ptr must be valid for reading the complete reported header size. Otherwise, this function might cause invalid machine state or crash your binary.
• The memory at ptr must not be modified after calling load or the program may observe unsynchronized mutation.

Examples found in repository

examples/minimal.rs (line 32)

fn main() {
    // We create a Multiboot2 header during runtime here. A more practical
    // example, however, would be that you parse the header from kernel binary
    // at runtime.
    let mb2_hdr_bytes = Builder::new(HeaderTagISA::I386)
        .relocatable_tag(RelocatableHeaderTag::new(
            HeaderTagFlag::Required,
            0x1337,
            0xdeadbeef,
            4096,
            RelocatableHeaderTagPreference::None,
        ))
        .information_request_tag(InformationRequestHeaderTag::new(
            HeaderTagFlag::Required,
            &[
                MbiTagType::Cmdline.into(),
                MbiTagType::BootLoaderName.into(),
            ],
        ))
        .build();

    // Cast bytes in vector to Multiboot2 information structure
    let ptr = mb2_hdr_bytes.as_bytes().as_ptr();
    let mb2_hdr = unsafe { Multiboot2Header::load(ptr.cast()) };
    let mb2_hdr = mb2_hdr.unwrap();
    println!("{mb2_hdr:#?}");
}

pub fn find_header(buffer: &[u8]) -> Result<(Self, usize), LoadError>

Tries finding a Multiboot2 header in a given slice of binary data.

Performs basic checks, such as length checks and a checksum match.

The Multiboot2 header must be contained completely within the first HEADER_SEARCH_LIMIT bytes of the OS image, and must be 64-bit aligned.

On success, it returns the parsed header and an index into the original buffer pointing to where the header starts.

Parameter

• buffer: 64-bit aligned buffer describing the first HEADER_SEARCH_LIMIT bytes of a potential Multiboot2 kernel image.

pub fn iter(&self) -> TagIter<'_>

Returns a TagIter.

pub const fn verify_checksum(&self) -> Result<(), (u32, u32)>

Wrapper around Multiboot2BasicHeader::verify_checksum.

pub const fn header_magic(&self) -> u32

Wrapper around Multiboot2BasicHeader::header_magic.

pub const fn arch(&self) -> HeaderTagISA

Wrapper around Multiboot2BasicHeader::arch.

pub const fn length(&self) -> u32

Wrapper around Multiboot2BasicHeader::length.

pub const fn checksum(&self) -> u32

Wrapper around Multiboot2BasicHeader::checksum.

pub const fn calc_checksum(magic: u32, arch: HeaderTagISA, length: u32) -> u32

Wrapper around Multiboot2BasicHeader::calc_checksum.

pub fn information_request_tag(&self) -> Option<&InformationRequestHeaderTag>

Search for the InformationRequestHeaderTag header tag.

pub fn address_tag(&self) -> Option<&AddressHeaderTag>

Search for the AddressHeaderTag header tag.

pub fn entry_address_tag(&self) -> Option<&EntryAddressHeaderTag>

Search for the EntryAddressHeaderTag header tag.

pub fn entry_address_efi32_tag(&self) -> Option<&EntryEfi32HeaderTag>

Search for the EntryEfi32HeaderTag header tag.

pub fn entry_address_efi64_tag(&self) -> Option<&EntryEfi64HeaderTag>

Search for the EntryEfi64HeaderTag header tag.

pub fn console_flags_tag(&self) -> Option<&ConsoleHeaderTag>

Search for the ConsoleHeaderTag header tag.

pub fn framebuffer_tag(&self) -> Option<&FramebufferHeaderTag>

Search for the FramebufferHeaderTag header tag.

pub fn module_align_tag(&self) -> Option<&ModuleAlignHeaderTag>

Search for the ModuleAlignHeaderTag header tag.

pub fn efi_boot_services_tag(&self) -> Option<&EfiBootServiceHeaderTag>

Search for the EfiBootServiceHeaderTag header tag.

pub fn relocatable_tag(&self) -> Option<&RelocatableHeaderTag>

Search for the RelocatableHeaderTag header tag.

Trait Implementations

impl Debug for Multiboot2Header<'_>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Eq for Multiboot2Header<'a>

impl<'a> PartialEq for Multiboot2Header<'a>

fn eq(&self, other: &Multiboot2Header<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> StructuralPartialEq for Multiboot2Header<'a>