1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef _ASM_X86_BOOTPARAM_H
3 #define _ASM_X86_BOOTPARAM_H
7 #define SETUP_E820_EXT 1
11 #define SETUP_APPLE_PROPERTIES 5
12 #define SETUP_JAILHOUSE 6
15 #define RAMDISK_IMAGE_START_MASK 0x07FF
16 #define RAMDISK_PROMPT_FLAG 0x8000
17 #define RAMDISK_LOAD_FLAG 0x4000
20 #define LOADED_HIGH (1<<0)
21 #define KASLR_FLAG (1<<1)
22 #define QUIET_FLAG (1<<5)
23 #define KEEP_SEGMENTS (1<<6)
24 #define CAN_USE_HEAP (1<<7)
27 #define XLF_KERNEL_64 (1<<0)
28 #define XLF_CAN_BE_LOADED_ABOVE_4G (1<<1)
29 #define XLF_EFI_HANDOVER_32 (1<<2)
30 #define XLF_EFI_HANDOVER_64 (1<<3)
31 #define XLF_EFI_KEXEC (1<<4)
35 #include <linux/types.h>
36 #include <linux/screen_info.h>
37 #include <linux/apm_bios.h>
38 #include <linux/edd.h>
40 #include <video/edid.h>
42 /* extensible setup data list node */
66 __u16 setup_move_size;
70 __u32 bootsect_kludge;
75 __u32 initrd_addr_max;
76 __u32 kernel_alignment;
77 __u8 relocatable_kernel;
81 __u32 hardware_subarch;
82 __u64 hardware_subarch_data;
88 __u32 handover_offset;
89 } __attribute__((packed));
91 struct sys_desc_table {
96 /* Gleaned from OFW's set-parameters in cpu/x86/pc/linux.fth */
97 struct olpc_ofw_header {
98 __u32 ofw_magic; /* OFW signature */
100 __u32 cif_handler; /* callback into OFW */
101 __u32 irq_desc_table;
102 } __attribute__((packed));
105 __u32 efi_loader_signature;
107 __u32 efi_memdesc_size;
108 __u32 efi_memdesc_version;
110 __u32 efi_memmap_size;
116 * This is the maximum number of entries in struct boot_params::e820_table
117 * (the zeropage), which is part of the x86 boot protocol ABI:
119 #define E820_MAX_ENTRIES_ZEROPAGE 128
122 * The E820 memory region entry of the boot protocol ABI:
124 struct boot_e820_entry {
128 } __attribute__((packed));
131 * Smallest compatible version of jailhouse_setup_data required by this kernel.
133 #define JAILHOUSE_SETUP_REQUIRED_VERSION 1
136 * The boot loader is passing platform information via this Jailhouse-specific
137 * setup data structure.
139 struct jailhouse_setup_data {
141 __u16 compatible_version;
142 __u16 pm_timer_address;
144 __u64 pci_mmconfig_base;
147 __u8 standard_ioapic;
149 } __attribute__((packed));
151 /* The so-called "zeropage" */
153 struct screen_info screen_info; /* 0x000 */
154 struct apm_bios_info apm_bios_info; /* 0x040 */
155 __u8 _pad2[4]; /* 0x054 */
156 __u64 tboot_addr; /* 0x058 */
157 struct ist_info ist_info; /* 0x060 */
158 __u64 acpi_rsdp_addr; /* 0x070 */
159 __u8 _pad3[8]; /* 0x078 */
160 __u8 hd0_info[16]; /* obsolete! */ /* 0x080 */
161 __u8 hd1_info[16]; /* obsolete! */ /* 0x090 */
162 struct sys_desc_table sys_desc_table; /* obsolete! */ /* 0x0a0 */
163 struct olpc_ofw_header olpc_ofw_header; /* 0x0b0 */
164 __u32 ext_ramdisk_image; /* 0x0c0 */
165 __u32 ext_ramdisk_size; /* 0x0c4 */
166 __u32 ext_cmd_line_ptr; /* 0x0c8 */
167 __u8 _pad4[116]; /* 0x0cc */
168 struct edid_info edid_info; /* 0x140 */
169 struct efi_info efi_info; /* 0x1c0 */
170 __u32 alt_mem_k; /* 0x1e0 */
171 __u32 scratch; /* Scratch field! */ /* 0x1e4 */
172 __u8 e820_entries; /* 0x1e8 */
173 __u8 eddbuf_entries; /* 0x1e9 */
174 __u8 edd_mbr_sig_buf_entries; /* 0x1ea */
175 __u8 kbd_status; /* 0x1eb */
176 __u8 secure_boot; /* 0x1ec */
177 __u8 _pad5[2]; /* 0x1ed */
179 * The sentinel is set to a nonzero value (0xff) in header.S.
181 * A bootloader is supposed to only take setup_header and put
182 * it into a clean boot_params buffer. If it turns out that
183 * it is clumsy or too generous with the buffer, it most
184 * probably will pick up the sentinel variable too. The fact
185 * that this variable then is still 0xff will let kernel
186 * know that some variables in boot_params are invalid and
187 * kernel should zero out certain portions of boot_params.
189 __u8 sentinel; /* 0x1ef */
190 __u8 _pad6[1]; /* 0x1f0 */
191 struct setup_header hdr; /* setup header */ /* 0x1f1 */
192 __u8 _pad7[0x290-0x1f1-sizeof(struct setup_header)];
193 __u32 edd_mbr_sig_buffer[EDD_MBR_SIG_MAX]; /* 0x290 */
194 struct boot_e820_entry e820_table[E820_MAX_ENTRIES_ZEROPAGE]; /* 0x2d0 */
195 __u8 _pad8[48]; /* 0xcd0 */
196 struct edd_info eddbuf[EDDMAXNR]; /* 0xd00 */
197 __u8 _pad9[276]; /* 0xeec */
198 } __attribute__((packed));
201 * enum x86_hardware_subarch - x86 hardware subarchitecture
203 * The x86 hardware_subarch and hardware_subarch_data were added as of the x86
204 * boot protocol 2.07 to help distinguish and support custom x86 boot
205 * sequences. This enum represents accepted values for the x86
206 * hardware_subarch. Custom x86 boot sequences (not X86_SUBARCH_PC) do not
207 * have or simply *cannot* make use of natural stubs like BIOS or EFI, the
208 * hardware_subarch can be used on the Linux entry path to revector to a
209 * subarchitecture stub when needed. This subarchitecture stub can be used to
210 * set up Linux boot parameters or for special care to account for nonstandard
211 * handling of page tables.
213 * These enums should only ever be used by x86 code, and the code that uses
214 * it should be well contained and compartamentalized.
216 * KVM and Xen HVM do not have a subarch as these are expected to follow
217 * standard x86 boot entries. If there is a genuine need for "hypervisor" type
218 * that should be considered separately in the future. Future guest types
219 * should seriously consider working with standard x86 boot stubs such as
220 * the BIOS or EFI boot stubs.
222 * WARNING: this enum is only used for legacy hacks, for platform features that
223 * are not easily enumerated or discoverable. You should not ever use
224 * this for new features.
226 * @X86_SUBARCH_PC: Should be used if the hardware is enumerable using standard
227 * PC mechanisms (PCI, ACPI) and doesn't need a special boot flow.
228 * @X86_SUBARCH_LGUEST: Used for x86 hypervisor demo, lguest, deprecated
229 * @X86_SUBARCH_XEN: Used for Xen guest types which follow the PV boot path,
230 * which start at asm startup_xen() entry point and later jump to the C
231 * xen_start_kernel() entry point. Both domU and dom0 type of guests are
232 * currently supportd through this PV boot path.
233 * @X86_SUBARCH_INTEL_MID: Used for Intel MID (Mobile Internet Device) platform
234 * systems which do not have the PCI legacy interfaces.
235 * @X86_SUBARCH_CE4100: Used for Intel CE media processor (CE4100) SoC for
236 * for settop boxes and media devices, the use of a subarch for CE4100
237 * is more of a hack...
239 enum x86_hardware_subarch {
243 X86_SUBARCH_INTEL_MID,
248 #endif /* __ASSEMBLY__ */
250 #endif /* _ASM_X86_BOOTPARAM_H */