1 /****************************************************************************** 2 * platform.h 3 * 4 * Hardware platform operations. Intended for use by domain-0 kernel. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a copy 7 * of this software and associated documentation files (the "Software"), to 8 * deal in the Software without restriction, including without limitation the 9 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 10 * sell copies of the Software, and to permit persons to whom the Software is 11 * furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice shall be included in 14 * all copies or substantial portions of the Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 22 * DEALINGS IN THE SOFTWARE. 23 * 24 * Copyright (c) 2002-2006, K Fraser 25 */ 26 27 #ifndef __XEN_PUBLIC_PLATFORM_H__ 28 #define __XEN_PUBLIC_PLATFORM_H__ 29 30 #include "xen.h" 31 32 #define XENPF_INTERFACE_VERSION 0x03000001 33 34 /* 35 * Set clock such that it would read <secs,nsecs> after 00:00:00 UTC, 36 * 1 January, 1970 if the current system time was <system_time>. 37 */ 38 #define XENPF_settime 17 39 struct xenpf_settime { 40 /* IN variables. */ 41 uint32_t secs; 42 uint32_t nsecs; 43 uint64_t system_time; 44 }; 45 typedef struct xenpf_settime xenpf_settime_t; 46 DEFINE_XEN_GUEST_HANDLE(xenpf_settime_t); 47 48 /* 49 * Request memory range (@mfn, @mfn+@nr_mfns-1) to have type @type. 50 * On x86, @type is an architecture-defined MTRR memory type. 51 * On success, returns the MTRR that was used (@reg) and a handle that can 52 * be passed to XENPF_DEL_MEMTYPE to accurately tear down the new setting. 53 * (x86-specific). 54 */ 55 #define XENPF_add_memtype 31 56 struct xenpf_add_memtype { 57 /* IN variables. */ 58 xen_pfn_t mfn; 59 uint64_t nr_mfns; 60 uint32_t type; 61 /* OUT variables. */ 62 uint32_t handle; 63 uint32_t reg; 64 }; 65 typedef struct xenpf_add_memtype xenpf_add_memtype_t; 66 DEFINE_XEN_GUEST_HANDLE(xenpf_add_memtype_t); 67 68 /* 69 * Tear down an existing memory-range type. If @handle is remembered then it 70 * should be passed in to accurately tear down the correct setting (in case 71 * of overlapping memory regions with differing types). If it is not known 72 * then @handle should be set to zero. In all cases @reg must be set. 73 * (x86-specific). 74 */ 75 #define XENPF_del_memtype 32 76 struct xenpf_del_memtype { 77 /* IN variables. */ 78 uint32_t handle; 79 uint32_t reg; 80 }; 81 typedef struct xenpf_del_memtype xenpf_del_memtype_t; 82 DEFINE_XEN_GUEST_HANDLE(xenpf_del_memtype_t); 83 84 /* Read current type of an MTRR (x86-specific). */ 85 #define XENPF_read_memtype 33 86 struct xenpf_read_memtype { 87 /* IN variables. */ 88 uint32_t reg; 89 /* OUT variables. */ 90 xen_pfn_t mfn; 91 uint64_t nr_mfns; 92 uint32_t type; 93 }; 94 typedef struct xenpf_read_memtype xenpf_read_memtype_t; 95 DEFINE_XEN_GUEST_HANDLE(xenpf_read_memtype_t); 96 97 #define XENPF_microcode_update 35 98 struct xenpf_microcode_update { 99 /* IN variables. */ 100 XEN_GUEST_HANDLE(void) data; /* Pointer to microcode data */ 101 uint32_t length; /* Length of microcode data. */ 102 }; 103 typedef struct xenpf_microcode_update xenpf_microcode_update_t; 104 DEFINE_XEN_GUEST_HANDLE(xenpf_microcode_update_t); 105 106 #define XENPF_platform_quirk 39 107 #define QUIRK_NOIRQBALANCING 1 /* Do not restrict IO-APIC RTE targets */ 108 #define QUIRK_IOAPIC_BAD_REGSEL 2 /* IO-APIC REGSEL forgets its value */ 109 #define QUIRK_IOAPIC_GOOD_REGSEL 3 /* IO-APIC REGSEL behaves properly */ 110 struct xenpf_platform_quirk { 111 /* IN variables. */ 112 uint32_t quirk_id; 113 }; 114 typedef struct xenpf_platform_quirk xenpf_platform_quirk_t; 115 DEFINE_XEN_GUEST_HANDLE(xenpf_platform_quirk_t); 116 117 #define XENPF_firmware_info 50 118 #define XEN_FW_DISK_INFO 1 /* from int 13 AH=08/41/48 */ 119 #define XEN_FW_DISK_MBR_SIGNATURE 2 /* from MBR offset 0x1b8 */ 120 #define XEN_FW_VBEDDC_INFO 3 /* from int 10 AX=4f15 */ 121 struct xenpf_firmware_info { 122 /* IN variables. */ 123 uint32_t type; 124 uint32_t index; 125 /* OUT variables. */ 126 union { 127 struct { 128 /* Int13, Fn48: Check Extensions Present. */ 129 uint8_t device; /* %dl: bios device number */ 130 uint8_t version; /* %ah: major version */ 131 uint16_t interface_support; /* %cx: support bitmap */ 132 /* Int13, Fn08: Legacy Get Device Parameters. */ 133 uint16_t legacy_max_cylinder; /* %cl[7:6]:%ch: max cyl # */ 134 uint8_t legacy_max_head; /* %dh: max head # */ 135 uint8_t legacy_sectors_per_track; /* %cl[5:0]: max sector # */ 136 /* Int13, Fn41: Get Device Parameters (as filled into %ds:%esi). */ 137 /* NB. First uint16_t of buffer must be set to buffer size. */ 138 XEN_GUEST_HANDLE(void) edd_params; 139 } disk_info; /* XEN_FW_DISK_INFO */ 140 struct { 141 uint8_t device; /* bios device number */ 142 uint32_t mbr_signature; /* offset 0x1b8 in mbr */ 143 } disk_mbr_signature; /* XEN_FW_DISK_MBR_SIGNATURE */ 144 struct { 145 /* Int10, AX=4F15: Get EDID info. */ 146 uint8_t capabilities; 147 uint8_t edid_transfer_time; 148 /* must refer to 128-byte buffer */ 149 XEN_GUEST_HANDLE(uint8_t) edid; 150 } vbeddc_info; /* XEN_FW_VBEDDC_INFO */ 151 } u; 152 }; 153 typedef struct xenpf_firmware_info xenpf_firmware_info_t; 154 DEFINE_XEN_GUEST_HANDLE(xenpf_firmware_info_t); 155 156 #define XENPF_panic_init 40 157 struct xenpf_panic_init { 158 unsigned long panic_addr; 159 }; 160 typedef struct xenpf_panic_init xenpf_panic_init_t; 161 DEFINE_XEN_GUEST_HANDLE(xenpf_panic_init_t); 162 163 struct xen_platform_op { 164 uint32_t cmd; 165 uint32_t interface_version; /* XENPF_INTERFACE_VERSION */ 166 union { 167 struct xenpf_settime settime; 168 struct xenpf_add_memtype add_memtype; 169 struct xenpf_del_memtype del_memtype; 170 struct xenpf_read_memtype read_memtype; 171 struct xenpf_microcode_update microcode; 172 struct xenpf_platform_quirk platform_quirk; 173 struct xenpf_firmware_info firmware_info; 174 struct xenpf_panic_init panic_init; 175 uint8_t pad[128]; 176 } u; 177 }; 178 typedef struct xen_platform_op xen_platform_op_t; 179 DEFINE_XEN_GUEST_HANDLE(xen_platform_op_t); 180 181 #endif /* __XEN_PUBLIC_PLATFORM_H__ */ 182 183 /* 184 * Local variables: 185 * mode: C 186 * c-set-style: "BSD" 187 * c-basic-offset: 4 188 * tab-width: 4 189 * indent-tabs-mode: nil 190 * End: 191 */ 192