Home | History | Annotate | Line # | Download | only in include
multiboot.h revision 1.1
      1 /*	$NetBSD: multiboot.h,v 1.1 2006/02/03 11:08:24 jmmv Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 2005, 2006 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Julio M. Merino Vidal.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *	This product includes software developed by the NetBSD
     21  *	Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 #if defined(_KERNEL)
     40 
     41 #include "opt_multiboot.h"
     42 
     43 #if defined(MULTIBOOT)
     44 
     45 /* --------------------------------------------------------------------- */
     46 
     47 /*
     48  * Space reserved after the kernel image to stick the symbol table.
     49  * The boot loader will leave this memory untouched (it will be treated
     50  * as if it was part of the BSS section).
     51  */
     52 #if !defined(MULTIBOOT_SYMTAB_SPACE)
     53 #  define MULTIBOOT_SYMTAB_SPACE 1048576
     54 #endif
     55 
     56 /* --------------------------------------------------------------------- */
     57 
     58 /*
     59  * Multiboot header structure.
     60  */
     61 #define MULTIBOOT_HEADER_MAGIC		0x1BADB002
     62 #define MULTIBOOT_HEADER_MODS_ALIGNED	0x00000001
     63 #define MULTIBOOT_HEADER_WANT_MEMORY	0x00000002
     64 #define MULTIBOOT_HEADER_HAS_VBE	0x00000004
     65 #define MULTIBOOT_HEADER_HAS_ADDR	0x00010000
     66 
     67 #if !defined(_LOCORE)
     68 struct multiboot_header {
     69 	uint32_t	mh_magic;
     70 	uint32_t	mh_flags;
     71 	uint32_t	mh_checksum;
     72 
     73 	/* Valid if mh_flags sets MULTIBOOT_HEADER_HAS_ADDR. */
     74 	paddr_t		mh_header_addr;
     75 	paddr_t		mh_load_addr;
     76 	paddr_t		mh_load_end_addr;
     77 	paddr_t		mh_bss_end_addr;
     78 	paddr_t		mh_entry_addr;
     79 
     80 	/* Valid if mh_flags sets MULTIBOOT_HEADER_HAS_VBE. */
     81 	uint32_t	mh_mode_type;
     82 	uint32_t	mh_width;
     83 	uint32_t	mh_height;
     84 	uint32_t	mh_depth;
     85 };
     86 #endif /* !defined(_LOCORE) */
     87 
     88 /*
     89  * Symbols defined in locore.S.
     90  */
     91 #if !defined(_LOCORE)
     92 extern struct multiboot_header *Multiboot_Header;
     93 #endif /* !defined(_LOCORE) */
     94 
     95 /* --------------------------------------------------------------------- */
     96 
     97 /*
     98  * Multiboot information structure.
     99  */
    100 #define MULTIBOOT_INFO_MAGIC		0x2BADB002
    101 #define MULTIBOOT_INFO_HAS_MEMORY	0x00000001
    102 #define MULTIBOOT_INFO_HAS_BOOT_DEVICE	0x00000002
    103 #define MULTIBOOT_INFO_HAS_CMDLINE	0x00000004
    104 #define MULTIBOOT_INFO_HAS_MODS		0x00000008
    105 #define MULTIBOOT_INFO_HAS_AOUT_SYMS	0x00000010
    106 #define MULTIBOOT_INFO_HAS_ELF_SYMS	0x00000020
    107 #define MULTIBOOT_INFO_HAS_MMAP		0x00000040
    108 #define MULTIBOOT_INFO_HAS_DRIVES	0x00000080
    109 #define MULTIBOOT_INFO_HAS_CONFIG_TABLE	0x00000100
    110 #define MULTIBOOT_INFO_HAS_LOADER_NAME	0x00000200
    111 #define MULTIBOOT_INFO_HAS_APM_TABLE	0x00000400
    112 #define MULTIBOOT_INFO_HAS_VBE		0x00000800
    113 
    114 #if !defined(_LOCORE)
    115 struct multiboot_info {
    116 	uint32_t	mi_flags;
    117 
    118 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_MEMORY. */
    119 	uint32_t	mi_mem_lower;
    120 	uint32_t	mi_mem_upper;
    121 
    122 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_BOOT_DEVICE. */
    123 	uint8_t		mi_boot_device_part3;
    124 	uint8_t		mi_boot_device_part2;
    125 	uint8_t		mi_boot_device_part1;
    126 	uint8_t		mi_boot_device_drive;
    127 
    128 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_CMDLINE. */
    129 	char *		mi_cmdline;
    130 
    131 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_MODS. */
    132 	uint32_t	unused_mi_mods_count;
    133 	vaddr_t		unused_mi_mods_addr;
    134 
    135 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_{AOUT,ELF}_SYMS. */
    136 	uint32_t	mi_elfshdr_num;
    137 	uint32_t	mi_elfshdr_size;
    138 	vaddr_t		mi_elfshdr_addr;
    139 	uint32_t	mi_elfshdr_shndx;
    140 
    141 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_MMAP. */
    142 	uint32_t	mi_mmap_length;
    143 	vaddr_t		mi_mmap_addr;
    144 
    145 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_DRIVES. */
    146 	uint32_t	mi_drives_length;
    147 	vaddr_t		mi_drives_addr;
    148 
    149 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_CONFIG_TABLE. */
    150 	void *		unused_mi_config_table;
    151 
    152 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_LOADER_NAME. */
    153 	char *		mi_loader_name;
    154 
    155 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_APM. */
    156 	void *		unused_mi_apm_table;
    157 
    158 	/* Valid if mi_flags sets MULTIBOOT_INFO_HAS_VBE. */
    159 	void *		unused_mi_vbe_control_info;
    160 	void *		unused_mi_vbe_mode_info;
    161 	paddr_t		unused_mi_vbe_interface_seg;
    162 	paddr_t		unused_mi_vbe_interface_off;
    163 	uint32_t	unused_mi_vbe_interface_len;
    164 };
    165 
    166 /* --------------------------------------------------------------------- */
    167 
    168 /*
    169  * Drive information.  This describes an entry in the drives table as
    170  * pointed to by mi_drives_addr.
    171  */
    172 struct multiboot_drive {
    173 	uint32_t	md_length;
    174 	uint8_t		md_number;
    175 	uint8_t		md_mode;
    176 	uint16_t	md_cylinders;
    177 	uint8_t		md_heads;
    178 	uint8_t		md_sectors;
    179 
    180 	/* The variable-sized 'ports' field comes here, so this structure
    181 	 * can be longer. */
    182 };
    183 
    184 /* --------------------------------------------------------------------- */
    185 
    186 /*
    187  * Memory mapping.  This describes an entry in the memory mappings table
    188  * as pointed to by mi_mmap_addr.
    189  *
    190  * Be aware that mm_size specifies the size of all other fields *except*
    191  * for mm_size.  In order to jump between two different entries, you
    192  * have to count mm_size + 4 bytes.
    193  */
    194 struct multiboot_mmap {
    195 	uint32_t	mm_size;
    196 	uint64_t	mm_base_addr;
    197 	uint64_t	mm_length;
    198 	uint32_t	mm_type;
    199 };
    200 
    201 #endif /* !defined(_LOCORE) */
    202 
    203 /* --------------------------------------------------------------------- */
    204 
    205 /*
    206  * Prototypes for public functions defined in multiboot.c.
    207  */
    208 #if !defined(_LOCORE)
    209 void		multiboot_pre_reloc(struct multiboot_info *);
    210 void		multiboot_post_reloc(void);
    211 void		multiboot_print_info(void);
    212 #endif /* !defined(_LOCORE) */
    213 
    214 /* --------------------------------------------------------------------- */
    215 
    216 #endif /* defined(MULTIBOOT) */
    217 
    218 #endif /* defined(_KERNEL) */
    219