bootparam_x86.h 8.3 KB

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