multiboot.h

Go to the documentation of this file.

 
// Do not inc here in boot.s.
 
#pragma once
 
#include "stdint.h"
 
#define MULTIBOOT_HEADER_MAGIC     0x1BADB002U 
#define MULTIBOOT_BOOTLOADER_MAGIC 0x2BADB002U 
 
#define MULTIBOOT_FLAG_MEM              0x00000001U 
#define MULTIBOOT_FLAG_DEVICE           0x00000002U 
#define MULTIBOOT_FLAG_CMDLINE          0x00000004U 
#define MULTIBOOT_FLAG_MODS             0x00000008U 
#define MULTIBOOT_FLAG_AOUT             0x00000010U 
#define MULTIBOOT_FLAG_ELF              0x00000020U 
#define MULTIBOOT_FLAG_MMAP             0x00000040U 
#define MULTIBOOT_FLAG_DRIVE_INFO       0x00000080U 
#define MULTIBOOT_FLAG_CONFIG_TABLE     0x00000100U 
#define MULTIBOOT_FLAG_BOOT_LOADER_NAME 0x00000200U 
#define MULTIBOOT_FLAG_APM_TABLE        0x00000400U 
#define MULTIBOOT_FLAG_VBE_INFO         0x00000800U 
#define MULTIBOOT_FLAG_FRAMEBUFFER_INFO 0x00001000U 
 
#define MULTIBOOT_MEMORY_AVAILABLE 1 
#define MULTIBOOT_MEMORY_RESERVED  2 
 
//            +-------------------+
//    0       | flags             |    (required)
//            +-------------------+
//    4       | mem_lower         |    (present if flags[0] is set)
//    8       | mem_upper         |    (present if flags[0] is set)
//            +-------------------+
//    12      | boot_device       |    (present if flags[1] is set)
//            +-------------------+
//    16      | cmdline           |    (present if flags[2] is set)
//            +-------------------+
//    20      | mods_count        |    (present if flags[3] is set)
//    24      | mods_addr         |    (present if flags[3] is set)
//            +-------------------+
//    28 - 40 | syms              |    (present if flags[4] or
//            |                   |                flags[5] is set)
//            +-------------------+
//    44      | mmap_length       |    (present if flags[6] is set)
//    48      | mmap_addr         |    (present if flags[6] is set)
//            +-------------------+
//    52      | drives_length     |    (present if flags[7] is set)
//    56      | drives_addr       |    (present if flags[7] is set)
//            +-------------------+
//    60      | config_table      |    (present if flags[8] is set)
//            +-------------------+
//    64      | boot_loader_name  |    (present if flags[9] is set)
//            +-------------------+
//    68      | apm_table         |    (present if flags[10] is set)
//            +-------------------+
//    72      | vbe_control_info  |    (present if flags[11] is set)
//    76      | vbe_mode_info     |
//    80      | vbe_mode          |
//    82      | vbe_interface_seg |
//    84      | vbe_interface_off |
//    86      | vbe_interface_len |
//            +-------------------+
//    88      | framebuffer_addr  |    (present if flags[12] is set)
//    96      | framebuffer_pitch |
//    100     | framebuffer_width |
//    104     | framebuffer_height|
//    108     | framebuffer_bpp   |
//    109     | framebuffer_type  |
//    110-115 | color_info        |
//            +-------------------+
 
typedef struct multiboot_aout_symbol_table_t {
    uint32_t tabsize;
    uint32_t strsize;
    uint32_t addr;
    uint32_t reserved;
} multiboot_aout_symbol_table_t;
 
typedef struct multiboot_elf_section_header_table_t {
    uint32_t num;
    uint32_t size;
    uint32_t addr;
    uint32_t shndx;
} multiboot_elf_section_header_table_t;
 
typedef struct multiboot_module_t {
    // The memory used goes from bytes 'mod_start' to 'mod_end-1' inclusive.
    uint32_t mod_start;
    uint32_t mod_end;
    uint32_t cmdline;
    uint32_t pad;
} multiboot_module_t;
 
typedef struct multiboot_memory_map_t {
    uint32_t size;
    uint32_t base_addr_low;
    uint32_t base_addr_high;
    uint32_t length_low;
    uint32_t length_high;
    uint32_t type;
} multiboot_memory_map_t;
 
typedef struct multiboot_info_t {
    uint32_t flags;
    uint32_t mem_lower;
    uint32_t mem_upper;
    uint32_t boot_device;
    uint32_t cmdline;
    uint32_t mods_count;
    uint32_t mods_addr;
    union {
        multiboot_aout_symbol_table_t aout_sym;
        multiboot_elf_section_header_table_t elf_sec;
    } u;
    uint32_t mmap_length;
    uint32_t mmap_addr;
    uint32_t drives_length;
    uint32_t drives_addr;
    uint32_t config_table;
    uint32_t boot_loader_name;
    uint32_t apm_table;
    uint32_t vbe_control_info;
    uint32_t vbe_mode_info;
    uint32_t vbe_mode;
    uint32_t vbe_interface_seg;
    uint32_t vbe_interface_off;
    uint32_t vbe_interface_len;
    uint32_t framebuffer_addr;
    uint32_t framebuffer_pitch;
    uint32_t framebuffer_width;
    uint32_t framebuffer_height;
    uint32_t framebuffer_bpp;
    uint32_t framebuffer_type;
    union {
        struct {
            uint32_t framebuffer_palette_addr;
            uint16_t framebuffer_palette_num_colors;
        } palette_field;
        struct {
            uint8_t framebuffer_red_field_position;
            uint8_t framebuffer_red_mask_size;
            uint8_t framebuffer_green_field_position;
            uint8_t framebuffer_green_mask_size;
            uint8_t framebuffer_blue_field_position;
            uint8_t framebuffer_blue_mask_size;
        } rgb_field;
    } framebuffer_info;
} multiboot_info_t;
 
multiboot_memory_map_t *mmap_first_entry(multiboot_info_t *info);
 
multiboot_memory_map_t *mmap_first_entry_of_type(multiboot_info_t *info, uint32_t type);
 
multiboot_memory_map_t *mmap_next_entry(multiboot_info_t *info, multiboot_memory_map_t *entry);
 
multiboot_memory_map_t *mmap_next_entry_of_type(multiboot_info_t *info, multiboot_memory_map_t *entry, uint32_t type);
 
char *mmap_type_name(multiboot_memory_map_t *entry);
 
multiboot_module_t *first_module(multiboot_info_t *info);
 
multiboot_module_t *next_module(multiboot_info_t *info, multiboot_module_t *mod);
 
void dump_multiboot(multiboot_info_t *mboot_ptr);