From fc00c656c96528112d05cf0edf8631bd5eaea446 Mon Sep 17 00:00:00 2001
From: Kacper <kacper@mail.openlinux.dev>
Date: Sun, 7 Dec 2025 20:10:31 +0100
Subject: Add build system scaffolding and libc headers

---
 include/arch/x86_64/asm/bootparam.h | 216 ++++++++++++++++++++++++++++++++++++
 1 file changed, 216 insertions(+)
 create mode 100644 include/arch/x86_64/asm/bootparam.h

(limited to 'include/arch/x86_64/asm/bootparam.h')

diff --git a/include/arch/x86_64/asm/bootparam.h b/include/arch/x86_64/asm/bootparam.h
new file mode 100644
index 00000000..ad10c79f
--- /dev/null
+++ b/include/arch/x86_64/asm/bootparam.h
@@ -0,0 +1,216 @@
+/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
+#ifndef _ASM_X86_BOOTPARAM_H
+#define _ASM_X86_BOOTPARAM_H
+
+#include <asm/setup_data.h>
+
+/* ram_size flags */
+#define RAMDISK_IMAGE_START_MASK 0x07FF
+#define RAMDISK_PROMPT_FLAG	 0x8000
+#define RAMDISK_LOAD_FLAG	 0x4000
+
+/* loadflags */
+#define LOADED_HIGH   (1 << 0)
+#define KASLR_FLAG    (1 << 1)
+#define QUIET_FLAG    (1 << 5)
+#define KEEP_SEGMENTS (1 << 6)
+#define CAN_USE_HEAP  (1 << 7)
+
+/* xloadflags */
+#define XLF_KERNEL_64		   (1 << 0)
+#define XLF_CAN_BE_LOADED_ABOVE_4G (1 << 1)
+#define XLF_EFI_HANDOVER_32	   (1 << 2)
+#define XLF_EFI_HANDOVER_64	   (1 << 3)
+#define XLF_EFI_KEXEC		   (1 << 4)
+#define XLF_5LEVEL		   (1 << 5)
+#define XLF_5LEVEL_ENABLED	   (1 << 6)
+#define XLF_MEM_ENCRYPTION	   (1 << 7)
+
+#ifndef __ASSEMBLER__
+
+#include <linux/types.h>
+#include <linux/screen_info.h>
+#include <linux/apm_bios.h>
+#include <linux/edd.h>
+#include <asm/ist.h>
+#include <video/edid.h>
+
+struct setup_header {
+	__u8 setup_sects;
+	__u16 root_flags;
+	__u32 syssize;
+	__u16 ram_size;
+	__u16 vid_mode;
+	__u16 root_dev;
+	__u16 boot_flag;
+	__u16 jump;
+	__u32 header;
+	__u16 version;
+	__u32 realmode_swtch;
+	__u16 start_sys_seg;
+	__u16 kernel_version;
+	__u8 type_of_loader;
+	__u8 loadflags;
+	__u16 setup_move_size;
+	__u32 code32_start;
+	__u32 ramdisk_image;
+	__u32 ramdisk_size;
+	__u32 bootsect_kludge;
+	__u16 heap_end_ptr;
+	__u8 ext_loader_ver;
+	__u8 ext_loader_type;
+	__u32 cmd_line_ptr;
+	__u32 initrd_addr_max;
+	__u32 kernel_alignment;
+	__u8 relocatable_kernel;
+	__u8 min_alignment;
+	__u16 xloadflags;
+	__u32 cmdline_size;
+	__u32 hardware_subarch;
+	__u64 hardware_subarch_data;
+	__u32 payload_offset;
+	__u32 payload_length;
+	__u64 setup_data;
+	__u64 pref_address;
+	__u32 init_size;
+	__u32 handover_offset;
+	__u32 kernel_info_offset;
+} __attribute__((packed));
+
+struct sys_desc_table {
+	__u16 length;
+	__u8 table[14];
+};
+
+/* Gleaned from OFW's set-parameters in cpu/x86/pc/linux.fth */
+struct olpc_ofw_header {
+	__u32 ofw_magic; /* OFW signature */
+	__u32 ofw_version;
+	__u32 cif_handler; /* callback into OFW */
+	__u32 irq_desc_table;
+} __attribute__((packed));
+
+struct efi_info {
+	__u32 efi_loader_signature;
+	__u32 efi_systab;
+	__u32 efi_memdesc_size;
+	__u32 efi_memdesc_version;
+	__u32 efi_memmap;
+	__u32 efi_memmap_size;
+	__u32 efi_systab_hi;
+	__u32 efi_memmap_hi;
+};
+
+/*
+ * This is the maximum number of entries in struct boot_params::e820_table
+ * (the zeropage), which is part of the x86 boot protocol ABI:
+ */
+#define E820_MAX_ENTRIES_ZEROPAGE 128
+
+/*
+ * Smallest compatible version of jailhouse_setup_data required by this kernel.
+ */
+#define JAILHOUSE_SETUP_REQUIRED_VERSION 1
+
+/* The so-called "zeropage" */
+struct boot_params {
+	struct screen_info screen_info;			      /* 0x000 */
+	struct apm_bios_info apm_bios_info;		      /* 0x040 */
+	__u8 _pad2[4];					      /* 0x054 */
+	__u64 tboot_addr;				      /* 0x058 */
+	struct ist_info ist_info;			      /* 0x060 */
+	__u64 acpi_rsdp_addr;				      /* 0x070 */
+	__u8 _pad3[8];					      /* 0x078 */
+	__u8 hd0_info[16]; /* obsolete! */		      /* 0x080 */
+	__u8 hd1_info[16]; /* obsolete! */		      /* 0x090 */
+	struct sys_desc_table sys_desc_table; /* obsolete! */ /* 0x0a0 */
+	struct olpc_ofw_header olpc_ofw_header;		      /* 0x0b0 */
+	__u32 ext_ramdisk_image;			      /* 0x0c0 */
+	__u32 ext_ramdisk_size;				      /* 0x0c4 */
+	__u32 ext_cmd_line_ptr;				      /* 0x0c8 */
+	__u8 _pad4[112];				      /* 0x0cc */
+	__u32 cc_blob_address;				      /* 0x13c */
+	struct edid_info edid_info;			      /* 0x140 */
+	struct efi_info efi_info;			      /* 0x1c0 */
+	__u32 alt_mem_k;				      /* 0x1e0 */
+	__u32 scratch; /* Scratch field! */		      /* 0x1e4 */
+	__u8 e820_entries;				      /* 0x1e8 */
+	__u8 eddbuf_entries;				      /* 0x1e9 */
+	__u8 edd_mbr_sig_buf_entries;			      /* 0x1ea */
+	__u8 kbd_status;				      /* 0x1eb */
+	__u8 secure_boot;				      /* 0x1ec */
+	__u8 _pad5[2];					      /* 0x1ed */
+	/*
+	 * The sentinel is set to a nonzero value (0xff) in header.S.
+	 *
+	 * A bootloader is supposed to only take setup_header and put
+	 * it into a clean boot_params buffer. If it turns out that
+	 * it is clumsy or too generous with the buffer, it most
+	 * probably will pick up the sentinel variable too. The fact
+	 * that this variable then is still 0xff will let kernel
+	 * know that some variables in boot_params are invalid and
+	 * kernel should zero out certain portions of boot_params.
+	 */
+	__u8 sentinel;				    /* 0x1ef */
+	__u8 _pad6[1];				    /* 0x1f0 */
+	struct setup_header hdr; /* setup header */ /* 0x1f1 */
+	__u8 _pad7[0x290 - 0x1f1 - sizeof(struct setup_header)];
+	__u32 edd_mbr_sig_buffer[EDD_MBR_SIG_MAX]; /* 0x290 */
+	struct boot_e820_entry e820_table[E820_MAX_ENTRIES_ZEROPAGE]; /* 0x2d0
+								       */
+	__u8 _pad8[48];			  /* 0xcd0 */
+	struct edd_info eddbuf[EDDMAXNR]; /* 0xd00 */
+	__u8 _pad9[276];		  /* 0xeec */
+} __attribute__((packed));
+
+/**
+ * enum x86_hardware_subarch - x86 hardware subarchitecture
+ *
+ * The x86 hardware_subarch and hardware_subarch_data were added as of the x86
+ * boot protocol 2.07 to help distinguish and support custom x86 boot
+ * sequences. This enum represents accepted values for the x86
+ * hardware_subarch.  Custom x86 boot sequences (not X86_SUBARCH_PC) do not
+ * have or simply *cannot* make use of natural stubs like BIOS or EFI, the
+ * hardware_subarch can be used on the Linux entry path to revector to a
+ * subarchitecture stub when needed. This subarchitecture stub can be used to
+ * set up Linux boot parameters or for special care to account for nonstandard
+ * handling of page tables.
+ *
+ * These enums should only ever be used by x86 code, and the code that uses
+ * it should be well contained and compartmentalized.
+ *
+ * KVM and Xen HVM do not have a subarch as these are expected to follow
+ * standard x86 boot entries. If there is a genuine need for "hypervisor" type
+ * that should be considered separately in the future. Future guest types
+ * should seriously consider working with standard x86 boot stubs such as
+ * the BIOS or EFI boot stubs.
+ *
+ * WARNING: this enum is only used for legacy hacks, for platform features that
+ *	    are not easily enumerated or discoverable. You should not ever use
+ *	    this for new features.
+ *
+ * @X86_SUBARCH_PC: Should be used if the hardware is enumerable using standard
+ *	PC mechanisms (PCI, ACPI) and doesn't need a special boot flow.
+ * @X86_SUBARCH_LGUEST: Used for x86 hypervisor demo, lguest, deprecated
+ * @X86_SUBARCH_XEN: Used for Xen guest types which follow the PV boot path,
+ * 	which start at __asm__ startup_xen() entry point and later jump to the C
+ * 	xen_start_kernel() entry point. Both domU and dom0 type of guests are
+ * 	currently supported through this PV boot path.
+ * @X86_SUBARCH_INTEL_MID: Used for Intel MID (Mobile Internet Device) platform
+ *	systems which do not have the PCI legacy interfaces.
+ * @X86_SUBARCH_CE4100: Used for Intel CE media processor (CE4100) SoC
+ * 	for settop boxes and media devices, the use of a subarch for CE4100
+ * 	is more of a hack...
+ */
+enum x86_hardware_subarch {
+	X86_SUBARCH_PC = 0,
+	X86_SUBARCH_LGUEST,
+	X86_SUBARCH_XEN,
+	X86_SUBARCH_INTEL_MID,
+	X86_SUBARCH_CE4100,
+	X86_NR_SUBARCHS,
+};
+
+#endif /* __ASSEMBLER__ */
+
+#endif /* _ASM_X86_BOOTPARAM_H */
-- 
cgit v1.2.3