xref: /openbmc/linux/arch/x86/include/uapi/asm/bootparam.h (revision 8730046c)
1 #ifndef _ASM_X86_BOOTPARAM_H
2 #define _ASM_X86_BOOTPARAM_H
3 
4 /* setup_data types */
5 #define SETUP_NONE			0
6 #define SETUP_E820_EXT			1
7 #define SETUP_DTB			2
8 #define SETUP_PCI			3
9 #define SETUP_EFI			4
10 #define SETUP_APPLE_PROPERTIES		5
11 
12 /* ram_size flags */
13 #define RAMDISK_IMAGE_START_MASK	0x07FF
14 #define RAMDISK_PROMPT_FLAG		0x8000
15 #define RAMDISK_LOAD_FLAG		0x4000
16 
17 /* loadflags */
18 #define LOADED_HIGH	(1<<0)
19 #define KASLR_FLAG	(1<<1)
20 #define QUIET_FLAG	(1<<5)
21 #define KEEP_SEGMENTS	(1<<6)
22 #define CAN_USE_HEAP	(1<<7)
23 
24 /* xloadflags */
25 #define XLF_KERNEL_64			(1<<0)
26 #define XLF_CAN_BE_LOADED_ABOVE_4G	(1<<1)
27 #define XLF_EFI_HANDOVER_32		(1<<2)
28 #define XLF_EFI_HANDOVER_64		(1<<3)
29 #define XLF_EFI_KEXEC			(1<<4)
30 
31 #ifndef __ASSEMBLY__
32 
33 #include <linux/types.h>
34 #include <linux/screen_info.h>
35 #include <linux/apm_bios.h>
36 #include <linux/edd.h>
37 #include <asm/e820.h>
38 #include <asm/ist.h>
39 #include <video/edid.h>
40 
41 /* extensible setup data list node */
42 struct setup_data {
43 	__u64 next;
44 	__u32 type;
45 	__u32 len;
46 	__u8 data[0];
47 };
48 
49 struct setup_header {
50 	__u8	setup_sects;
51 	__u16	root_flags;
52 	__u32	syssize;
53 	__u16	ram_size;
54 	__u16	vid_mode;
55 	__u16	root_dev;
56 	__u16	boot_flag;
57 	__u16	jump;
58 	__u32	header;
59 	__u16	version;
60 	__u32	realmode_swtch;
61 	__u16	start_sys;
62 	__u16	kernel_version;
63 	__u8	type_of_loader;
64 	__u8	loadflags;
65 	__u16	setup_move_size;
66 	__u32	code32_start;
67 	__u32	ramdisk_image;
68 	__u32	ramdisk_size;
69 	__u32	bootsect_kludge;
70 	__u16	heap_end_ptr;
71 	__u8	ext_loader_ver;
72 	__u8	ext_loader_type;
73 	__u32	cmd_line_ptr;
74 	__u32	initrd_addr_max;
75 	__u32	kernel_alignment;
76 	__u8	relocatable_kernel;
77 	__u8	min_alignment;
78 	__u16	xloadflags;
79 	__u32	cmdline_size;
80 	__u32	hardware_subarch;
81 	__u64	hardware_subarch_data;
82 	__u32	payload_offset;
83 	__u32	payload_length;
84 	__u64	setup_data;
85 	__u64	pref_address;
86 	__u32	init_size;
87 	__u32	handover_offset;
88 } __attribute__((packed));
89 
90 struct sys_desc_table {
91 	__u16 length;
92 	__u8  table[14];
93 };
94 
95 /* Gleaned from OFW's set-parameters in cpu/x86/pc/linux.fth */
96 struct olpc_ofw_header {
97 	__u32 ofw_magic;	/* OFW signature */
98 	__u32 ofw_version;
99 	__u32 cif_handler;	/* callback into OFW */
100 	__u32 irq_desc_table;
101 } __attribute__((packed));
102 
103 struct efi_info {
104 	__u32 efi_loader_signature;
105 	__u32 efi_systab;
106 	__u32 efi_memdesc_size;
107 	__u32 efi_memdesc_version;
108 	__u32 efi_memmap;
109 	__u32 efi_memmap_size;
110 	__u32 efi_systab_hi;
111 	__u32 efi_memmap_hi;
112 };
113 
114 /* The so-called "zeropage" */
115 struct boot_params {
116 	struct screen_info screen_info;			/* 0x000 */
117 	struct apm_bios_info apm_bios_info;		/* 0x040 */
118 	__u8  _pad2[4];					/* 0x054 */
119 	__u64  tboot_addr;				/* 0x058 */
120 	struct ist_info ist_info;			/* 0x060 */
121 	__u8  _pad3[16];				/* 0x070 */
122 	__u8  hd0_info[16];	/* obsolete! */		/* 0x080 */
123 	__u8  hd1_info[16];	/* obsolete! */		/* 0x090 */
124 	struct sys_desc_table sys_desc_table; /* obsolete! */	/* 0x0a0 */
125 	struct olpc_ofw_header olpc_ofw_header;		/* 0x0b0 */
126 	__u32 ext_ramdisk_image;			/* 0x0c0 */
127 	__u32 ext_ramdisk_size;				/* 0x0c4 */
128 	__u32 ext_cmd_line_ptr;				/* 0x0c8 */
129 	__u8  _pad4[116];				/* 0x0cc */
130 	struct edid_info edid_info;			/* 0x140 */
131 	struct efi_info efi_info;			/* 0x1c0 */
132 	__u32 alt_mem_k;				/* 0x1e0 */
133 	__u32 scratch;		/* Scratch field! */	/* 0x1e4 */
134 	__u8  e820_entries;				/* 0x1e8 */
135 	__u8  eddbuf_entries;				/* 0x1e9 */
136 	__u8  edd_mbr_sig_buf_entries;			/* 0x1ea */
137 	__u8  kbd_status;				/* 0x1eb */
138 	__u8  _pad5[3];					/* 0x1ec */
139 	/*
140 	 * The sentinel is set to a nonzero value (0xff) in header.S.
141 	 *
142 	 * A bootloader is supposed to only take setup_header and put
143 	 * it into a clean boot_params buffer. If it turns out that
144 	 * it is clumsy or too generous with the buffer, it most
145 	 * probably will pick up the sentinel variable too. The fact
146 	 * that this variable then is still 0xff will let kernel
147 	 * know that some variables in boot_params are invalid and
148 	 * kernel should zero out certain portions of boot_params.
149 	 */
150 	__u8  sentinel;					/* 0x1ef */
151 	__u8  _pad6[1];					/* 0x1f0 */
152 	struct setup_header hdr;    /* setup header */	/* 0x1f1 */
153 	__u8  _pad7[0x290-0x1f1-sizeof(struct setup_header)];
154 	__u32 edd_mbr_sig_buffer[EDD_MBR_SIG_MAX];	/* 0x290 */
155 	struct e820entry e820_map[E820MAX];		/* 0x2d0 */
156 	__u8  _pad8[48];				/* 0xcd0 */
157 	struct edd_info eddbuf[EDDMAXNR];		/* 0xd00 */
158 	__u8  _pad9[276];				/* 0xeec */
159 } __attribute__((packed));
160 
161 /**
162  * enum x86_hardware_subarch - x86 hardware subarchitecture
163  *
164  * The x86 hardware_subarch and hardware_subarch_data were added as of the x86
165  * boot protocol 2.07 to help distinguish and support custom x86 boot
166  * sequences. This enum represents accepted values for the x86
167  * hardware_subarch.  Custom x86 boot sequences (not X86_SUBARCH_PC) do not
168  * have or simply *cannot* make use of natural stubs like BIOS or EFI, the
169  * hardware_subarch can be used on the Linux entry path to revector to a
170  * subarchitecture stub when needed. This subarchitecture stub can be used to
171  * set up Linux boot parameters or for special care to account for nonstandard
172  * handling of page tables.
173  *
174  * These enums should only ever be used by x86 code, and the code that uses
175  * it should be well contained and compartamentalized.
176  *
177  * KVM and Xen HVM do not have a subarch as these are expected to follow
178  * standard x86 boot entries. If there is a genuine need for "hypervisor" type
179  * that should be considered separately in the future. Future guest types
180  * should seriously consider working with standard x86 boot stubs such as
181  * the BIOS or EFI boot stubs.
182  *
183  * WARNING: this enum is only used for legacy hacks, for platform features that
184  *	    are not easily enumerated or discoverable. You should not ever use
185  *	    this for new features.
186  *
187  * @X86_SUBARCH_PC: Should be used if the hardware is enumerable using standard
188  *	PC mechanisms (PCI, ACPI) and doesn't need a special boot flow.
189  * @X86_SUBARCH_LGUEST: Used for x86 hypervisor demo, lguest
190  * @X86_SUBARCH_XEN: Used for Xen guest types which follow the PV boot path,
191  * 	which start at asm startup_xen() entry point and later jump to the C
192  * 	xen_start_kernel() entry point. Both domU and dom0 type of guests are
193  * 	currently supportd through this PV boot path.
194  * @X86_SUBARCH_INTEL_MID: Used for Intel MID (Mobile Internet Device) platform
195  *	systems which do not have the PCI legacy interfaces.
196  * @X86_SUBARCH_CE4100: Used for Intel CE media processor (CE4100) SoC for
197  * 	for settop boxes and media devices, the use of a subarch for CE4100
198  * 	is more of a hack...
199  */
200 enum x86_hardware_subarch {
201 	X86_SUBARCH_PC = 0,
202 	X86_SUBARCH_LGUEST,
203 	X86_SUBARCH_XEN,
204 	X86_SUBARCH_INTEL_MID,
205 	X86_SUBARCH_CE4100,
206 	X86_NR_SUBARCHS,
207 };
208 
209 #endif /* __ASSEMBLY__ */
210 
211 #endif /* _ASM_X86_BOOTPARAM_H */
212