multiboot.h revision 294417
1/* multiboot.h - Multiboot header file. */ 2/* Copyright (C) 1999,2003,2007,2008,2009 Free Software Foundation, Inc. 3* 4* Permission is hereby granted, free of charge, to any person obtaining a copy 5* of this software and associated documentation files (the "Software"), to 6* deal in the Software without restriction, including without limitation the 7* rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 8* sell copies of the Software, and to permit persons to whom the Software is 9* furnished to do so, subject to the following conditions: 10* 11* The above copyright notice and this permission notice shall be included in 12* all copies or substantial portions of the Software. 13* 14* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 15* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL ANY 17* DEVELOPER OR DISTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 18* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR 19* IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 20* 21* $FreeBSD: stable/10/sys/boot/i386/libi386/multiboot.h 294417 2016-01-20 13:23:02Z royger $ 22*/ 23 24#ifndef MULTIBOOT_HEADER 25#define MULTIBOOT_HEADER 1 26 27/* How many bytes from the start of the file we search for the header. */ 28#define MULTIBOOT_SEARCH 8192 29 30/* The magic field should contain this. */ 31#define MULTIBOOT_HEADER_MAGIC 0x1BADB002 32 33/* This should be in %eax. */ 34#define MULTIBOOT_BOOTLOADER_MAGIC 0x2BADB002 35 36/* The bits in the required part of flags field we don't support. */ 37#define MULTIBOOT_UNSUPPORTED 0x0000fffc 38 39/* Alignment of multiboot modules. */ 40#define MULTIBOOT_MOD_ALIGN 0x00001000 41 42/* Alignment of the multiboot info structure. */ 43#define MULTIBOOT_INFO_ALIGN 0x00000004 44 45/* Flags set in the 'flags' member of the multiboot header. */ 46 47/* Align all boot modules on i386 page (4KB) boundaries. */ 48#define MULTIBOOT_PAGE_ALIGN 0x00000001 49 50/* Must pass memory information to OS. */ 51#define MULTIBOOT_MEMORY_INFO 0x00000002 52 53/* Must pass video information to OS. */ 54#define MULTIBOOT_VIDEO_MODE 0x00000004 55 56/* This flag indicates the use of the address fields in the header. */ 57#define MULTIBOOT_AOUT_KLUDGE 0x00010000 58 59/* Flags to be set in the 'flags' member of the multiboot info structure. */ 60 61/* is there basic lower/upper memory information? */ 62#define MULTIBOOT_INFO_MEMORY 0x00000001 63/* is there a boot device set? */ 64#define MULTIBOOT_INFO_BOOTDEV 0x00000002 65/* is the command-line defined? */ 66#define MULTIBOOT_INFO_CMDLINE 0x00000004 67/* are there modules to do something with? */ 68#define MULTIBOOT_INFO_MODS 0x00000008 69 70/* These next two are mutually exclusive */ 71 72/* is there a symbol table loaded? */ 73#define MULTIBOOT_INFO_AOUT_SYMS 0x00000010 74/* is there an ELF section header table? */ 75#define MULTIBOOT_INFO_ELF_SHDR 0X00000020 76 77/* is there a full memory map? */ 78#define MULTIBOOT_INFO_MEM_MAP 0x00000040 79 80/* Is there drive info? */ 81#define MULTIBOOT_INFO_DRIVE_INFO 0x00000080 82 83/* Is there a config table? */ 84#define MULTIBOOT_INFO_CONFIG_TABLE 0x00000100 85 86/* Is there a boot loader name? */ 87#define MULTIBOOT_INFO_BOOT_LOADER_NAME 0x00000200 88 89/* Is there a APM table? */ 90#define MULTIBOOT_INFO_APM_TABLE 0x00000400 91 92/* Is there video information? */ 93#define MULTIBOOT_INFO_VIDEO_INFO 0x00000800 94 95#ifndef ASM_FILE 96 97typedef unsigned short multiboot_uint16_t; 98typedef unsigned int multiboot_uint32_t; 99typedef unsigned long long multiboot_uint64_t; 100 101struct multiboot_header 102{ 103/* Must be MULTIBOOT_MAGIC - see above. */ 104 multiboot_uint32_t magic; 105 106/* Feature flags. */ 107 multiboot_uint32_t flags; 108 109/* The above fields plus this one must equal 0 mod 2^32. */ 110 multiboot_uint32_t checksum; 111 112/* These are only valid if MULTIBOOT_AOUT_KLUDGE is set. */ 113 multiboot_uint32_t header_addr; 114 multiboot_uint32_t load_addr; 115 multiboot_uint32_t load_end_addr; 116 multiboot_uint32_t bss_end_addr; 117 multiboot_uint32_t entry_addr; 118 119/* These are only valid if MULTIBOOT_VIDEO_MODE is set. */ 120 multiboot_uint32_t mode_type; 121 multiboot_uint32_t width; 122 multiboot_uint32_t height; 123 multiboot_uint32_t depth; 124}; 125 126/* The symbol table for a.out. */ 127struct multiboot_aout_symbol_table 128{ 129 multiboot_uint32_t tabsize; 130 multiboot_uint32_t strsize; 131 multiboot_uint32_t addr; 132 multiboot_uint32_t reserved; 133}; 134typedef struct multiboot_aout_symbol_table multiboot_aout_symbol_table_t; 135 136/* The section header table for ELF. */ 137struct multiboot_elf_section_header_table 138{ 139 multiboot_uint32_t num; 140 multiboot_uint32_t size; 141 multiboot_uint32_t addr; 142 multiboot_uint32_t shndx; 143}; 144typedef struct multiboot_elf_section_header_table multiboot_elf_section_header_table_t; 145 146struct multiboot_info 147{ 148/* Multiboot info version number */ 149 multiboot_uint32_t flags; 150 151/* Available memory from BIOS */ 152 multiboot_uint32_t mem_lower; 153 multiboot_uint32_t mem_upper; 154 155/* "root" partition */ 156 multiboot_uint32_t boot_device; 157 158/* Kernel command line */ 159 multiboot_uint32_t cmdline; 160 161/* Boot-Module list */ 162 multiboot_uint32_t mods_count; 163 multiboot_uint32_t mods_addr; 164 165 union 166 { 167 multiboot_aout_symbol_table_t aout_sym; 168 multiboot_elf_section_header_table_t elf_sec; 169 } u; 170 171/* Memory Mapping buffer */ 172 multiboot_uint32_t mmap_length; 173 multiboot_uint32_t mmap_addr; 174 175/* Drive Info buffer */ 176 multiboot_uint32_t drives_length; 177 multiboot_uint32_t drives_addr; 178 179/* ROM configuration table */ 180 multiboot_uint32_t config_table; 181 182/* Boot Loader Name */ 183 multiboot_uint32_t boot_loader_name; 184 185/* APM table */ 186 multiboot_uint32_t apm_table; 187 188/* Video */ 189 multiboot_uint32_t vbe_control_info; 190 multiboot_uint32_t vbe_mode_info; 191 multiboot_uint16_t vbe_mode; 192 multiboot_uint16_t vbe_interface_seg; 193 multiboot_uint16_t vbe_interface_off; 194 multiboot_uint16_t vbe_interface_len; 195}; 196typedef struct multiboot_info multiboot_info_t; 197 198struct multiboot_mmap_entry 199{ 200 multiboot_uint32_t size; 201 multiboot_uint64_t addr; 202 multiboot_uint64_t len; 203#define MULTIBOOT_MEMORY_AVAILABLE 1 204#define MULTIBOOT_MEMORY_RESERVED 2 205 multiboot_uint32_t type; 206} __attribute__((packed)); 207typedef struct multiboot_mmap_entry multiboot_memory_map_t; 208 209struct multiboot_mod_list 210{ 211/* the memory used goes from bytes 'mod_start' to 'mod_end-1' inclusive */ 212 multiboot_uint32_t mod_start; 213 multiboot_uint32_t mod_end; 214 215/* Module command line */ 216 multiboot_uint32_t cmdline; 217 218/* padding to take it to 16 bytes (must be zero) */ 219 multiboot_uint32_t pad; 220}; 221typedef struct multiboot_mod_list multiboot_module_t; 222 223#endif /* ! ASM_FILE */ 224 225#endif /* ! MULTIBOOT_HEADER */ 226