/* * QEMU S390 bootmap interpreter -- declarations * * Copyright 2014 IBM Corp. * Author(s): Eugene (jno) Dvurechenski * * This work is licensed under the terms of the GNU GPL, version 2 or (at * your option) any later version. See the COPYING file in the top-level * directory. */ #ifndef _PC_BIOS_S390_CCW_BOOTMAP_H #define _PC_BIOS_S390_CCW_BOOTMAP_H #include "s390-ccw.h" #include "virtio.h" typedef uint64_t block_number_t; #define NULL_BLOCK_NR 0xffffffffffffffffULL #define FREE_SPACE_FILLER '\xAA' typedef struct ScsiBlockPtr { uint64_t blockno; uint16_t size; uint16_t blockct; uint8_t reserved[4]; } __attribute__ ((packed)) ScsiBlockPtr; typedef struct FbaBlockPtr { uint32_t blockno; uint16_t size; uint16_t blockct; } __attribute__ ((packed)) FbaBlockPtr; typedef struct EckdCHS { uint16_t cylinder; uint16_t head; uint8_t sector; } __attribute__ ((packed)) EckdCHS; typedef struct EckdBlockPtr { EckdCHS chs; /* cylinder/head/sector is an address of the block */ uint16_t size; uint8_t count; /* (size_in_blocks-1); * it's 0 for TablePtr, ScriptPtr, and SectionPtr */ } __attribute__ ((packed)) EckdBlockPtr; typedef struct ExtEckdBlockPtr { EckdBlockPtr bptr; uint8_t reserved[8]; } __attribute__ ((packed)) ExtEckdBlockPtr; typedef union BootMapPointer { ScsiBlockPtr scsi; FbaBlockPtr fba; EckdBlockPtr eckd; ExtEckdBlockPtr xeckd; } __attribute__ ((packed)) BootMapPointer; #define MAX_TABLE_ENTRIES 30 /* aka Program Table */ typedef struct BootMapTable { uint8_t magic[4]; uint8_t reserved[12]; BootMapPointer entry[]; } __attribute__ ((packed)) BootMapTable; typedef struct ComponentEntry { ScsiBlockPtr data; uint8_t pad[7]; uint8_t component_type; uint64_t load_address; } __attribute((packed)) ComponentEntry; typedef struct ComponentHeader { uint8_t magic[4]; /* == "zIPL" */ uint8_t type; /* == ZIPL_COMP_HEADER_* */ uint8_t reserved[27]; } __attribute((packed)) ComponentHeader; typedef struct ScsiMbr { uint8_t magic[4]; uint32_t version_id; uint8_t reserved[8]; ScsiBlockPtr pt; /* block pointer to program table */ } __attribute__ ((packed)) ScsiMbr; #define ZIPL_MAGIC "zIPL" #define IPL1_MAGIC "\xc9\xd7\xd3\xf1" /* == "IPL1" in EBCDIC */ #define IPL2_MAGIC "\xc9\xd7\xd3\xf2" /* == "IPL2" in EBCDIC */ #define VOL1_MAGIC "\xe5\xd6\xd3\xf1" /* == "VOL1" in EBCDIC */ #define LNX1_MAGIC "\xd3\xd5\xe7\xf1" /* == "LNX1" in EBCDIC */ #define CMS1_MAGIC "\xc3\xd4\xe2\xf1" /* == "CMS1" in EBCDIC */ #define LDL1_VERSION '\x40' /* == ' ' in EBCDIC */ #define LDL2_VERSION '\xf2' /* == '2' in EBCDIC */ #define ZIPL_COMP_HEADER_IPL 0x00 #define ZIPL_COMP_HEADER_DUMP 0x01 #define ZIPL_COMP_ENTRY_LOAD 0x02 #define ZIPL_COMP_ENTRY_EXEC 0x01 typedef struct XEckdMbr { uint8_t magic[4]; /* == "xIPL" */ uint8_t version; uint8_t bp_type; uint8_t dev_type; /* == DEV_TYPE_* */ #define DEV_TYPE_ECKD 0x00 #define DEV_TYPE_FBA 0x01 uint8_t flags; BootMapPointer blockptr; uint8_t reserved[8]; } __attribute__ ((packed)) XEckdMbr; /* see also BootInfo */ typedef struct BootMapScriptEntry { BootMapPointer blkptr; uint8_t pad[7]; uint8_t type; /* == BOOT_SCRIPT_* */ #define BOOT_SCRIPT_EXEC 0x01 #define BOOT_SCRIPT_LOAD 0x02 union { uint64_t load_address; uint64_t load_psw; } address; } __attribute__ ((packed)) BootMapScriptEntry; typedef struct BootMapScriptHeader { uint32_t magic; uint8_t type; #define BOOT_SCRIPT_HDR_IPL 0x00 uint8_t reserved[27]; } __attribute__ ((packed)) BootMapScriptHeader; typedef struct BootMapScript { BootMapScriptHeader header; BootMapScriptEntry entry[0]; } __attribute__ ((packed)) BootMapScript; /* * These aren't real VTOCs, but referred to this way in some docs. * They are "volume labels" actually. * * Some structures looks similar to described above, but left * separate as there is no indication that they are the same. * So, the value definitions are left separate too. */ typedef struct LDL_VTOC { /* @ rec.3 cyl.0 trk.0 for ECKD */ char magic[4]; /* "LNX1", EBCDIC */ char volser[6]; /* volser, EBCDIC */ uint8_t reserved[69]; /* reserved, 0x40 */ uint8_t LDL_version; /* 0x40 or 0xF2 */ uint64_t formatted_blocks; /* if LDL_version >= 0xF2 */ } __attribute__ ((packed)) LDL_VTOC; typedef struct format_date { uint8_t YY; uint8_t MM; uint8_t DD; uint8_t hh; uint8_t mm; uint8_t ss; } __attribute__ ((packed)) format_date_t; typedef struct CMS_VTOC { /* @ rec.3 cyl.0 trk.0 for ECKD */ /* @ blk.1 (zero based) for FBA */ char magic[4]; /* 'CMS1', EBCDIC */ char volser[6]; /* volser, EBCDIC */ uint16_t version; /* = 0 */ uint32_t block_size; /* = 512, 1024, 2048, or 4096 */ uint32_t disk_origin; /* = 4 or 5 */ uint32_t blocks; /* Number of usable cyls/blocks */ uint32_t formatted; /* Max number of fmtd cyls/blks */ uint32_t CMS_blocks; /* disk size in CMS blocks */ uint32_t CMS_used; /* Number of CMS blocks in use */ uint32_t FST_size; /* = 64, bytes */ uint32_t FST_per_CMS_blk; /* */ format_date_t format_date; /* YYMMDDhhmmss as 6 bytes */ uint8_t reserved1[2]; /* = 0 */ uint32_t offset; /* disk offset when reserved */ uint32_t next_hole; /* block nr */ uint32_t HBLK_hole_offset; /* >> HBLK data of next hole */ uint32_t alloc_map_usr_off; /* >> user part of Alloc map */ uint8_t reserved2[4]; /* = 0 */ char shared_seg_name[8]; /* */ } __attribute__ ((packed)) CMS_VTOC; /* from zipl/include/boot.h */ typedef struct BootInfoBpIpl { union { ExtEckdBlockPtr eckd; ScsiBlockPtr linr; } bm_ptr; uint8_t unused[16]; } __attribute__ ((packed)) BootInfoBpIpl; typedef struct EckdDumpParam { uint32_t start_blk; uint32_t end_blk; uint16_t blocksize; uint8_t num_heads; uint8_t bpt; char reserved[4]; } __attribute((packed, may_alias)) EckdDumpParam; typedef struct FbaDumpParam { uint64_t start_blk; uint64_t blockct; } __attribute((packed)) FbaDumpParam; typedef struct BootInfoBpDump { union { EckdDumpParam eckd; FbaDumpParam fba; } param; uint8_t unused[16]; } __attribute__ ((packed)) BootInfoBpDump; typedef struct BootInfo { /* @ 0x70, record #0 */ unsigned char magic[4]; /* = 'zIPL', ASCII */ uint8_t version; /* = 1 */ #define BOOT_INFO_VERSION 1 uint8_t bp_type; /* = 0 */ #define BOOT_INFO_BP_TYPE_IPL 0x00 #define BOOT_INFO_BP_TYPE_DUMP 0x01 uint8_t dev_type; /* = 0 */ #define BOOT_INFO_DEV_TYPE_ECKD 0x00 #define BOOT_INFO_DEV_TYPE_FBA 0x01 uint8_t flags; /* = 1 */ #ifdef __s390x__ #define BOOT_INFO_FLAGS_ARCH 0x01 #else #define BOOT_INFO_FLAGS_ARCH 0x00 #endif union { BootInfoBpDump dump; BootInfoBpIpl ipl; } bp; } __attribute__ ((packed)) BootInfo; /* see also XEckdMbr */ /* * Structs for IPL */ #define STAGE2_BLK_CNT_MAX 24 /* Stage 1b can load up to 24 blocks */ typedef struct EckdCdlIpl1 { uint8_t key[4]; /* == "IPL1" */ uint8_t data[24]; } __attribute__((packed)) EckdCdlIpl1; typedef struct EckdCdlIpl2 { uint8_t key[4]; /* == "IPL2" */ uint8_t reserved0[88]; XEckdMbr mbr; uint8_t reserved[24]; } __attribute__((packed)) EckdCdlIpl2; typedef struct EckdLdlIpl1 { uint8_t reserved[112]; BootInfo bip; /* BootInfo is MBR for LDL */ } __attribute__((packed)) EckdLdlIpl1; typedef struct IplVolumeLabel { unsigned char key[4]; /* == "VOL1" */ union { unsigned char data[80]; struct { unsigned char key[4]; /* == "VOL1" */ unsigned char volser[6]; unsigned char reserved[6]; } f; }; } __attribute__((packed)) IplVolumeLabel; typedef enum { ECKD_NO_IPL, ECKD_CMS, ECKD_LDL, ECKD_LDL_UNLABELED, } ECKD_IPL_mode_t; /* utility code below */ static inline void print_volser(const void *volser) { char ascii[8]; ebcdic_to_ascii((char *)volser, ascii, 6); ascii[6] = '\0'; sclp_print("VOLSER=["); sclp_print(ascii); sclp_print("]\n"); } static inline bool unused_space(const void *p, size_t size) { size_t i; const unsigned char *m = p; for (i = 0; i < size; i++) { if (m[i] != FREE_SPACE_FILLER) { return false; } } return true; } static inline bool is_null_block_number(block_number_t x) { return x == NULL_BLOCK_NR; } static inline void read_block(block_number_t blockno, void *buffer, const char *errmsg) { IPL_assert(virtio_read(blockno, buffer) == 0, errmsg); } static inline bool block_size_ok(uint32_t block_size) { return block_size == virtio_get_block_size(); } static inline bool magic_match(const void *data, const void *magic) { return *((uint32_t *)data) == *((uint32_t *)magic); } static inline int _memcmp(const void *s1, const void *s2, size_t n) { int i; const uint8_t *p1 = s1, *p2 = s2; for (i = 0; i < n; i++) { if (p1[i] != p2[i]) { return p1[i] > p2[i] ? 1 : -1; } } return 0; } static inline uint32_t iso_733_to_u32(uint64_t x) { return (uint32_t)x; } #define ISO_SECTOR_SIZE 2048 /* El Torito specifies boot image size in 512 byte blocks */ #define ET_SECTOR_SHIFT 2 #define KERN_IMAGE_START 0x010000UL #define PSW_MASK_64 0x0000000100000000ULL #define PSW_MASK_32 0x0000000080000000ULL #define IPL_PSW_MASK (PSW_MASK_32 | PSW_MASK_64) #define ISO_PRIMARY_VD_SECTOR 16 static inline void read_iso_sector(uint32_t block_offset, void *buf, const char *errmsg) { IPL_assert(virtio_read_many(block_offset, buf, 1) == 0, errmsg); } static inline void read_iso_boot_image(uint32_t block_offset, void *load_addr, uint32_t blks_to_load) { IPL_assert(virtio_read_many(block_offset, load_addr, blks_to_load) == 0, "Failed to read boot image!"); } const uint8_t el_torito_magic[] = "EL TORITO SPECIFICATION" "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"; #define ISO9660_MAX_DIR_DEPTH 8 typedef struct IsoDirHdr { uint8_t dr_len; uint8_t ear_len; uint64_t ext_loc; uint64_t data_len; uint8_t recording_datetime[7]; uint8_t file_flags; uint8_t file_unit_size; uint8_t gap_size; uint32_t vol_seqnum; uint8_t fileid_len; } __attribute__((packed)) IsoDirHdr; typedef struct IsoVdElTorito { uint8_t el_torito[32]; /* must contain el_torito_magic value */ uint8_t unused0[32]; uint32_t bc_offset; uint8_t unused1[1974]; } __attribute__((packed)) IsoVdElTorito; typedef struct IsoVdPrimary { uint8_t unused1; uint8_t sys_id[32]; uint8_t vol_id[32]; uint8_t unused2[8]; uint64_t vol_space_size; uint8_t unused3[32]; uint32_t vol_set_size; uint32_t vol_seqnum; uint32_t log_block_size; uint64_t path_table_size; uint32_t l_path_table; uint32_t opt_l_path_table; uint32_t m_path_table; uint32_t opt_m_path_table; IsoDirHdr rootdir; uint8_t root_null; uint8_t reserved2[1858]; } __attribute__((packed)) IsoVdPrimary; typedef struct IsoVolDesc { uint8_t type; uint8_t ident[5]; uint8_t version; union { IsoVdElTorito boot; IsoVdPrimary primary; } vd; } __attribute__((packed)) IsoVolDesc; const uint8_t vol_desc_magic[] = "CD001"; #define VOL_DESC_TYPE_BOOT 0 #define VOL_DESC_TYPE_PRIMARY 1 #define VOL_DESC_TYPE_SUPPLEMENT 2 #define VOL_DESC_TYPE_PARTITION 3 #define VOL_DESC_TERMINATOR 255 static inline bool is_iso_vd_valid(IsoVolDesc *vd) { return !_memcmp(&vd->ident[0], vol_desc_magic, 5) && vd->version == 0x1 && vd->type <= VOL_DESC_TYPE_PARTITION; } typedef struct IsoBcValid { uint8_t platform_id; uint16_t reserved; uint8_t id[24]; uint16_t checksum; uint8_t key[2]; } __attribute__((packed)) IsoBcValid; typedef struct IsoBcSection { uint8_t boot_type; uint16_t load_segment; uint8_t sys_type; uint8_t unused; uint16_t sector_count; uint32_t load_rba; uint8_t selection[20]; } __attribute__((packed)) IsoBcSection; typedef struct IsoBcHdr { uint8_t platform_id; uint16_t sect_num; uint8_t id[28]; } __attribute__((packed)) IsoBcHdr; /* * Match two CCWs located after PSW and eight filler bytes. * From libmagic and arch/s390/kernel/head.S. */ const uint8_t linux_s390_magic[] = "\x02\x00\x00\x18\x60\x00\x00\x50\x02\x00" "\x00\x68\x60\x00\x00\x50\x40\x40\x40\x40" "\x40\x40\x40\x40"; typedef struct IsoBcEntry { uint8_t id; union { IsoBcValid valid; /* id == 0x01 */ IsoBcSection sect; /* id == 0x88 || id == 0x0 */ IsoBcHdr hdr; /* id == 0x90 || id == 0x91 */ } body; } __attribute__((packed)) IsoBcEntry; #define ISO_BC_ENTRY_PER_SECTOR (ISO_SECTOR_SIZE / sizeof(IsoBcEntry)) #define ISO_BC_HDR_VALIDATION 0x01 #define ISO_BC_BOOTABLE_SECTION 0x88 #define ISO_BC_MAGIC_55 0x55 #define ISO_BC_MAGIC_AA 0xaa #define ISO_BC_PLATFORM_X86 0x0 #define ISO_BC_PLATFORM_PPC 0x1 #define ISO_BC_PLATFORM_MAC 0x2 static inline bool is_iso_bc_valid(IsoBcEntry *e) { IsoBcValid *v = &e->body.valid; if (e->id != ISO_BC_HDR_VALIDATION) { return false; } if (v->platform_id != ISO_BC_PLATFORM_X86 && v->platform_id != ISO_BC_PLATFORM_PPC && v->platform_id != ISO_BC_PLATFORM_MAC) { return false; } return v->key[0] == ISO_BC_MAGIC_55 && v->key[1] == ISO_BC_MAGIC_AA && v->reserved == 0x0; } #endif /* _PC_BIOS_S390_CCW_BOOTMAP_H */