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>

Public constructor for this type with various validations.

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

• addr is a null-pointer
• addr isn’t 8-byte aligned
• the magic value of the header is not present
• the checksum field is invalid

Safety

This function may produce undefined behaviour, if the provided addr is not a valid Multiboot2 header pointer.

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<Option<(&[u8], u32)>, LoadError>

Find the header in a given slice.

If it succeeds, it returns a tuple consisting of the subslice containing just the header and the index of the header in the given slice. If it fails (either because the header is not properly 64-bit aligned or because it is truncated), it returns a LoadError. If there is no header, it returns None.

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

Returns a TagIter.

pub const fn verify_checksum(&self) -> bool

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.