12 releases (6 breaking)

Uses old Rust 2015

0.8.0 Apr 25, 2022
0.7.0 Mar 11, 2021
0.6.0 Nov 25, 2020
0.4.0 Jul 14, 2018
0.0.3 Mar 19, 2015

#286 in Operating systems

Download history 478/week @ 2023-12-15 111/week @ 2023-12-22 174/week @ 2023-12-29 425/week @ 2024-01-05 562/week @ 2024-01-12 438/week @ 2024-01-19 559/week @ 2024-01-26 917/week @ 2024-02-02 606/week @ 2024-02-09 831/week @ 2024-02-16 807/week @ 2024-02-23 684/week @ 2024-03-01 617/week @ 2024-03-08 642/week @ 2024-03-15 779/week @ 2024-03-22 481/week @ 2024-03-29

2,636 downloads per month
Used in 2 crates

MIT license

47KB
904 lines

Multiboot Crates.io Build

This is a multiboot (v1) library written entirely in rust. The code depends only on libcore.

How-to use

extern crate core;

use multiboot::information::{MemoryManagement, Multiboot, PAddr};
use core::{slice, mem};

struct Mem;

impl MemoryManagement for Mem {
    unsafe fn paddr_to_slice(&self, addr: PAddr, size: usize) -> Option<&'static [u8]> {
        let ptr = mem::transmute(addr);
        Some(slice::from_raw_parts(ptr, size))
    }
    
    // If you only want to read fields, you can simply return `None`.
    unsafe fn allocate(&mut self, _length: usize) -> Option<(PAddr, &mut [u8])> {
        None
    }
    
    unsafe fn deallocate(&mut self, addr: PAddr) {
        if addr != 0 {
            unimplemented!()
        }
    }
}

static mut MEM: Mem = Mem;

/// mboot_ptr is the initial pointer to the multiboot structure
/// provided in %ebx on start-up.
pub fn use_multiboot(mboot_ptr: PAddr) -> Option<Multiboot<'static, 'static>> {
    unsafe {
        Multiboot::from_ptr(mboot_ptr, &mut MEM)
    }
}

Functionality is still not complete and patches are welcome!

Documentation

Dependencies