efi_api.h 65 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * Extensible Firmware Interface
  4. * Based on 'Extensible Firmware Interface Specification' version 0.9,
  5. * April 30, 1999
  6. *
  7. * Copyright (C) 1999 VA Linux Systems
  8. * Copyright (C) 1999 Walt Drummond <drummond@valinux.com>
  9. * Copyright (C) 1999, 2002-2003 Hewlett-Packard Co.
  10. * David Mosberger-Tang <davidm@hpl.hp.com>
  11. * Stephane Eranian <eranian@hpl.hp.com>
  12. *
  13. * From include/linux/efi.h in kernel 4.1 with some additions/subtractions
  14. */
  15. #ifndef _EFI_API_H
  16. #define _EFI_API_H
  17. #include <efi.h>
  18. #include <charset.h>
  19. #include <pe.h>
  20. /* UEFI spec version 2.9 */
  21. #define EFI_SPECIFICATION_VERSION (2 << 16 | 90)
  22. /* Types and defines for EFI CreateEvent */
  23. enum efi_timer_delay {
  24. EFI_TIMER_STOP = 0,
  25. EFI_TIMER_PERIODIC = 1,
  26. EFI_TIMER_RELATIVE = 2
  27. };
  28. typedef void *efi_hii_handle_t;
  29. typedef u16 *efi_string_t;
  30. typedef u16 efi_string_id_t;
  31. typedef u32 efi_hii_font_style_t;
  32. typedef u16 efi_question_id_t;
  33. typedef u16 efi_image_id_t;
  34. typedef u16 efi_form_id_t;
  35. #define EVT_TIMER 0x80000000
  36. #define EVT_RUNTIME 0x40000000
  37. #define EVT_NOTIFY_WAIT 0x00000100
  38. #define EVT_NOTIFY_SIGNAL 0x00000200
  39. #define EVT_SIGNAL_EXIT_BOOT_SERVICES 0x00000201
  40. #define EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE 0x60000202
  41. #define TPL_APPLICATION 0x04
  42. #define TPL_CALLBACK 0x08
  43. #define TPL_NOTIFY 0x10
  44. #define TPL_HIGH_LEVEL 0x1F
  45. struct efi_event;
  46. /* OsIndicationsSupported flags */
  47. #define EFI_OS_INDICATIONS_BOOT_TO_FW_UI 0x0000000000000001
  48. #define EFI_OS_INDICATIONS_TIMESTAMP_REVOCATION 0x0000000000000002
  49. #define EFI_OS_INDICATIONS_FILE_CAPSULE_DELIVERY_SUPPORTED 0x0000000000000004
  50. #define EFI_OS_INDICATIONS_FMP_CAPSULE_SUPPORTED 0x0000000000000008
  51. #define EFI_OS_INDICATIONS_CAPSULE_RESULT_VAR_SUPPORTED 0x0000000000000010
  52. #define EFI_OS_INDICATIONS_START_OS_RECOVERY 0x0000000000000020
  53. #define EFI_OS_INDICATIONS_START_PLATFORM_RECOVERY 0x0000000000000040
  54. #define EFI_OS_INDICATIONS_JSON_CONFIG_DATA_REFRESH 0x0000000000000080
  55. /* EFI Boot Services table */
  56. #define EFI_BOOT_SERVICES_SIGNATURE 0x56524553544f4f42
  57. struct efi_boot_services {
  58. struct efi_table_hdr hdr;
  59. efi_status_t (EFIAPI *raise_tpl)(efi_uintn_t new_tpl);
  60. void (EFIAPI *restore_tpl)(efi_uintn_t old_tpl);
  61. efi_status_t (EFIAPI *allocate_pages)(int, int, efi_uintn_t,
  62. efi_physical_addr_t *);
  63. efi_status_t (EFIAPI *free_pages)(efi_physical_addr_t, efi_uintn_t);
  64. efi_status_t (EFIAPI *get_memory_map)(efi_uintn_t *memory_map_size,
  65. struct efi_mem_desc *desc,
  66. efi_uintn_t *key,
  67. efi_uintn_t *desc_size,
  68. u32 *desc_version);
  69. efi_status_t (EFIAPI *allocate_pool)(int, efi_uintn_t, void **);
  70. efi_status_t (EFIAPI *free_pool)(void *);
  71. efi_status_t (EFIAPI *create_event)(uint32_t type,
  72. efi_uintn_t notify_tpl,
  73. void (EFIAPI *notify_function) (
  74. struct efi_event *event,
  75. void *context),
  76. void *notify_context, struct efi_event **event);
  77. efi_status_t (EFIAPI *set_timer)(struct efi_event *event,
  78. enum efi_timer_delay type,
  79. uint64_t trigger_time);
  80. efi_status_t (EFIAPI *wait_for_event)(efi_uintn_t number_of_events,
  81. struct efi_event **event,
  82. efi_uintn_t *index);
  83. efi_status_t (EFIAPI *signal_event)(struct efi_event *event);
  84. efi_status_t (EFIAPI *close_event)(struct efi_event *event);
  85. efi_status_t (EFIAPI *check_event)(struct efi_event *event);
  86. #define EFI_NATIVE_INTERFACE 0x00000000
  87. efi_status_t (EFIAPI *install_protocol_interface)(
  88. efi_handle_t *handle, const efi_guid_t *protocol,
  89. int protocol_interface_type, void *protocol_interface);
  90. efi_status_t (EFIAPI *reinstall_protocol_interface)(
  91. efi_handle_t handle, const efi_guid_t *protocol,
  92. void *old_interface, void *new_interface);
  93. efi_status_t (EFIAPI *uninstall_protocol_interface)(
  94. efi_handle_t handle, const efi_guid_t *protocol,
  95. void *protocol_interface);
  96. efi_status_t (EFIAPI *handle_protocol)(
  97. efi_handle_t handle, const efi_guid_t *protocol,
  98. void **protocol_interface);
  99. void *reserved;
  100. efi_status_t (EFIAPI *register_protocol_notify)(
  101. const efi_guid_t *protocol, struct efi_event *event,
  102. void **registration);
  103. efi_status_t (EFIAPI *locate_handle)(
  104. enum efi_locate_search_type search_type,
  105. const efi_guid_t *protocol, void *search_key,
  106. efi_uintn_t *buffer_size, efi_handle_t *buffer);
  107. efi_status_t (EFIAPI *locate_device_path)(const efi_guid_t *protocol,
  108. struct efi_device_path **device_path,
  109. efi_handle_t *device);
  110. efi_status_t (EFIAPI *install_configuration_table)(
  111. const efi_guid_t *guid, void *table);
  112. efi_status_t (EFIAPI *load_image)(bool boot_policiy,
  113. efi_handle_t parent_image,
  114. struct efi_device_path *file_path, void *source_buffer,
  115. efi_uintn_t source_size, efi_handle_t *image);
  116. efi_status_t (EFIAPI *start_image)(efi_handle_t handle,
  117. efi_uintn_t *exitdata_size,
  118. u16 **exitdata);
  119. efi_status_t (EFIAPI *exit)(efi_handle_t handle,
  120. efi_status_t exit_status,
  121. efi_uintn_t exitdata_size, u16 *exitdata);
  122. efi_status_t (EFIAPI *unload_image)(efi_handle_t image_handle);
  123. efi_status_t (EFIAPI *exit_boot_services)(efi_handle_t image_handle,
  124. efi_uintn_t map_key);
  125. efi_status_t (EFIAPI *get_next_monotonic_count)(u64 *count);
  126. efi_status_t (EFIAPI *stall)(unsigned long usecs);
  127. efi_status_t (EFIAPI *set_watchdog_timer)(unsigned long timeout,
  128. uint64_t watchdog_code, unsigned long data_size,
  129. uint16_t *watchdog_data);
  130. efi_status_t(EFIAPI *connect_controller)(efi_handle_t controller_handle,
  131. efi_handle_t *driver_image_handle,
  132. struct efi_device_path *remaining_device_path,
  133. bool recursive);
  134. efi_status_t (EFIAPI *disconnect_controller)(
  135. efi_handle_t controller_handle,
  136. efi_handle_t driver_image_handle,
  137. efi_handle_t child_handle);
  138. #define EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL 0x00000001
  139. #define EFI_OPEN_PROTOCOL_GET_PROTOCOL 0x00000002
  140. #define EFI_OPEN_PROTOCOL_TEST_PROTOCOL 0x00000004
  141. #define EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER 0x00000008
  142. #define EFI_OPEN_PROTOCOL_BY_DRIVER 0x00000010
  143. #define EFI_OPEN_PROTOCOL_EXCLUSIVE 0x00000020
  144. efi_status_t (EFIAPI *open_protocol)(efi_handle_t handle,
  145. const efi_guid_t *protocol, void **interface,
  146. efi_handle_t agent_handle,
  147. efi_handle_t controller_handle, u32 attributes);
  148. efi_status_t (EFIAPI *close_protocol)(
  149. efi_handle_t handle, const efi_guid_t *protocol,
  150. efi_handle_t agent_handle,
  151. efi_handle_t controller_handle);
  152. efi_status_t(EFIAPI *open_protocol_information)(efi_handle_t handle,
  153. const efi_guid_t *protocol,
  154. struct efi_open_protocol_info_entry **entry_buffer,
  155. efi_uintn_t *entry_count);
  156. efi_status_t (EFIAPI *protocols_per_handle)(efi_handle_t handle,
  157. efi_guid_t ***protocol_buffer,
  158. efi_uintn_t *protocols_buffer_count);
  159. efi_status_t (EFIAPI *locate_handle_buffer) (
  160. enum efi_locate_search_type search_type,
  161. const efi_guid_t *protocol, void *search_key,
  162. efi_uintn_t *no_handles, efi_handle_t **buffer);
  163. efi_status_t (EFIAPI *locate_protocol)(const efi_guid_t *protocol,
  164. void *registration, void **protocol_interface);
  165. efi_status_t (EFIAPI *install_multiple_protocol_interfaces)(
  166. efi_handle_t *handle, ...);
  167. efi_status_t (EFIAPI *uninstall_multiple_protocol_interfaces)(
  168. efi_handle_t handle, ...);
  169. efi_status_t (EFIAPI *calculate_crc32)(const void *data,
  170. efi_uintn_t data_size,
  171. u32 *crc32);
  172. void (EFIAPI *copy_mem)(void *destination, const void *source,
  173. size_t length);
  174. void (EFIAPI *set_mem)(void *buffer, size_t size, uint8_t value);
  175. efi_status_t (EFIAPI *create_event_ex)(
  176. uint32_t type, efi_uintn_t notify_tpl,
  177. void (EFIAPI *notify_function) (
  178. struct efi_event *event,
  179. void *context),
  180. void *notify_context,
  181. efi_guid_t *event_group,
  182. struct efi_event **event);
  183. };
  184. /* Types and defines for EFI ResetSystem */
  185. enum efi_reset_type {
  186. EFI_RESET_COLD = 0,
  187. EFI_RESET_WARM = 1,
  188. EFI_RESET_SHUTDOWN = 2,
  189. EFI_RESET_PLATFORM_SPECIFIC = 3,
  190. };
  191. /* EFI Runtime Services table */
  192. #define EFI_RUNTIME_SERVICES_SIGNATURE 0x56524553544e5552ULL
  193. #define CAPSULE_FLAGS_PERSIST_ACROSS_RESET 0x00010000
  194. #define CAPSULE_FLAGS_POPULATE_SYSTEM_TABLE 0x00020000
  195. #define CAPSULE_FLAGS_INITIATE_RESET 0x00040000
  196. #define CAPSULE_SUPPORT_AUTHENTICATION 0x0000000000000001
  197. #define CAPSULE_SUPPORT_DEPENDENCY 0x0000000000000002
  198. #define EFI_CAPSULE_REPORT_GUID \
  199. EFI_GUID(0x39b68c46, 0xf7fb, 0x441b, 0xb6, 0xec, \
  200. 0x16, 0xb0, 0xf6, 0x98, 0x21, 0xf3)
  201. #define EFI_MEMORY_RANGE_CAPSULE_GUID \
  202. EFI_GUID(0xde9f0ec, 0x88b6, 0x428f, 0x97, 0x7a, \
  203. 0x25, 0x8f, 0x1d, 0xe, 0x5e, 0x72)
  204. #define EFI_FIRMWARE_MANAGEMENT_CAPSULE_ID_GUID \
  205. EFI_GUID(0x6dcbd5ed, 0xe82d, 0x4c44, 0xbd, 0xa1, \
  206. 0x71, 0x94, 0x19, 0x9a, 0xd9, 0x2a)
  207. struct efi_capsule_header {
  208. efi_guid_t capsule_guid;
  209. u32 header_size;
  210. u32 flags;
  211. u32 capsule_image_size;
  212. } __packed;
  213. struct efi_capsule_result_variable_header {
  214. u32 variable_total_size;
  215. u32 reserved;
  216. efi_guid_t capsule_guid;
  217. struct efi_time capsule_processed;
  218. efi_status_t capsule_status;
  219. } __packed;
  220. struct efi_memory_range {
  221. efi_physical_addr_t address;
  222. u64 length;
  223. };
  224. struct efi_memory_range_capsule {
  225. struct efi_capsule_header *header;
  226. /* EFI_MEMORY_TYPE: 0x80000000-0xFFFFFFFF */
  227. enum efi_memory_type os_requested_memory_type;
  228. u64 number_of_memory_ranges;
  229. struct efi_memory_range memory_ranges[];
  230. } __packed;
  231. struct efi_firmware_management_capsule_header {
  232. u32 version;
  233. u16 embedded_driver_count;
  234. u16 payload_item_count;
  235. u64 item_offset_list[];
  236. } __packed;
  237. struct efi_firmware_management_capsule_image_header {
  238. u32 version;
  239. efi_guid_t update_image_type_id;
  240. u8 update_image_index;
  241. u8 reserved[3];
  242. u32 update_image_size;
  243. u32 update_vendor_code_size;
  244. u64 update_hardware_instance;
  245. u64 image_capsule_support;
  246. } __packed;
  247. struct efi_capsule_result_variable_fmp {
  248. u16 version;
  249. u8 payload_index;
  250. u8 update_image_index;
  251. efi_guid_t update_image_type_id;
  252. // u16 capsule_file_name[];
  253. // u16 capsule_target[];
  254. } __packed;
  255. #define EFI_RT_SUPPORTED_GET_TIME 0x0001
  256. #define EFI_RT_SUPPORTED_SET_TIME 0x0002
  257. #define EFI_RT_SUPPORTED_GET_WAKEUP_TIME 0x0004
  258. #define EFI_RT_SUPPORTED_SET_WAKEUP_TIME 0x0008
  259. #define EFI_RT_SUPPORTED_GET_VARIABLE 0x0010
  260. #define EFI_RT_SUPPORTED_GET_NEXT_VARIABLE_NAME 0x0020
  261. #define EFI_RT_SUPPORTED_SET_VARIABLE 0x0040
  262. #define EFI_RT_SUPPORTED_SET_VIRTUAL_ADDRESS_MAP 0x0080
  263. #define EFI_RT_SUPPORTED_CONVERT_POINTER 0x0100
  264. #define EFI_RT_SUPPORTED_GET_NEXT_HIGH_MONOTONIC_COUNT 0x0200
  265. #define EFI_RT_SUPPORTED_RESET_SYSTEM 0x0400
  266. #define EFI_RT_SUPPORTED_UPDATE_CAPSULE 0x0800
  267. #define EFI_RT_SUPPORTED_QUERY_CAPSULE_CAPABILITIES 0x1000
  268. #define EFI_RT_SUPPORTED_QUERY_VARIABLE_INFO 0x2000
  269. #define EFI_RT_PROPERTIES_TABLE_GUID \
  270. EFI_GUID(0xeb66918a, 0x7eef, 0x402a, 0x84, 0x2e, \
  271. 0x93, 0x1d, 0x21, 0xc3, 0x8a, 0xe9)
  272. #define EFI_RT_PROPERTIES_TABLE_VERSION 0x1
  273. struct efi_rt_properties_table {
  274. u16 version;
  275. u16 length;
  276. u32 runtime_services_supported;
  277. };
  278. #define EFI_OPTIONAL_PTR 0x00000001
  279. struct efi_runtime_services {
  280. struct efi_table_hdr hdr;
  281. efi_status_t (EFIAPI *get_time)(struct efi_time *time,
  282. struct efi_time_cap *capabilities);
  283. efi_status_t (EFIAPI *set_time)(struct efi_time *time);
  284. efi_status_t (EFIAPI *get_wakeup_time)(char *enabled, char *pending,
  285. struct efi_time *time);
  286. efi_status_t (EFIAPI *set_wakeup_time)(char enabled,
  287. struct efi_time *time);
  288. efi_status_t (EFIAPI *set_virtual_address_map)(
  289. efi_uintn_t memory_map_size,
  290. efi_uintn_t descriptor_size,
  291. uint32_t descriptor_version,
  292. struct efi_mem_desc *virtmap);
  293. efi_status_t (EFIAPI *convert_pointer)(
  294. efi_uintn_t debug_disposition, void **address);
  295. efi_status_t (EFIAPI *get_variable)(u16 *variable_name,
  296. const efi_guid_t *vendor,
  297. u32 *attributes,
  298. efi_uintn_t *data_size, void *data);
  299. efi_status_t (EFIAPI *get_next_variable_name)(
  300. efi_uintn_t *variable_name_size,
  301. u16 *variable_name, efi_guid_t *vendor);
  302. efi_status_t (EFIAPI *set_variable)(u16 *variable_name,
  303. const efi_guid_t *vendor,
  304. u32 attributes,
  305. efi_uintn_t data_size,
  306. const void *data);
  307. efi_status_t (EFIAPI *get_next_high_mono_count)(
  308. uint32_t *high_count);
  309. void (EFIAPI *reset_system)(enum efi_reset_type reset_type,
  310. efi_status_t reset_status,
  311. unsigned long data_size, void *reset_data);
  312. efi_status_t (EFIAPI *update_capsule)(
  313. struct efi_capsule_header **capsule_header_array,
  314. efi_uintn_t capsule_count,
  315. u64 scatter_gather_list);
  316. efi_status_t (EFIAPI *query_capsule_caps)(
  317. struct efi_capsule_header **capsule_header_array,
  318. efi_uintn_t capsule_count,
  319. u64 *maximum_capsule_size,
  320. u32 *reset_type);
  321. efi_status_t (EFIAPI *query_variable_info)(
  322. u32 attributes,
  323. u64 *maximum_variable_storage_size,
  324. u64 *remaining_variable_storage_size,
  325. u64 *maximum_variable_size);
  326. };
  327. /* EFI event group GUID definitions */
  328. #define EFI_EVENT_GROUP_EXIT_BOOT_SERVICES \
  329. EFI_GUID(0x27abf055, 0xb1b8, 0x4c26, 0x80, 0x48, \
  330. 0x74, 0x8f, 0x37, 0xba, 0xa2, 0xdf)
  331. #define EFI_EVENT_GROUP_BEFORE_EXIT_BOOT_SERVICES \
  332. EFI_GUID(0x8be0e274, 0x3970, 0x4b44, 0x80, 0xc5, \
  333. 0x1a, 0xb9, 0x50, 0x2f, 0x3b, 0xfc)
  334. #define EFI_EVENT_GROUP_VIRTUAL_ADDRESS_CHANGE \
  335. EFI_GUID(0x13fa7698, 0xc831, 0x49c7, 0x87, 0xea, \
  336. 0x8f, 0x43, 0xfc, 0xc2, 0x51, 0x96)
  337. #define EFI_EVENT_GROUP_MEMORY_MAP_CHANGE \
  338. EFI_GUID(0x78bee926, 0x692f, 0x48fd, 0x9e, 0xdb, \
  339. 0x01, 0x42, 0x2e, 0xf0, 0xd7, 0xab)
  340. #define EFI_EVENT_GROUP_READY_TO_BOOT \
  341. EFI_GUID(0x7ce88fb3, 0x4bd7, 0x4679, 0x87, 0xa8, \
  342. 0xa8, 0xd8, 0xde, 0xe5, 0x0d, 0x2b)
  343. #define EFI_EVENT_GROUP_AFTER_READY_TO_BOOT \
  344. EFI_GUID(0x3a2a00ad, 0x98b9, 0x4cdf, 0xa4, 0x78, \
  345. 0x70, 0x27, 0x77, 0xf1, 0xc1, 0xb)
  346. #define EFI_EVENT_GROUP_RESET_SYSTEM \
  347. EFI_GUID(0x62da6a56, 0x13fb, 0x485a, 0xa8, 0xda, \
  348. 0xa3, 0xdd, 0x79, 0x12, 0xcb, 0x6b)
  349. /* EFI Configuration Table and GUID definitions */
  350. #define NULL_GUID \
  351. EFI_GUID(0x00000000, 0x0000, 0x0000, 0x00, 0x00, \
  352. 0x00, 0x00, 0x00, 0x00, 0x00, 0x00)
  353. #define EFI_GLOBAL_VARIABLE_GUID \
  354. EFI_GUID(0x8be4df61, 0x93ca, 0x11d2, 0xaa, 0x0d, \
  355. 0x00, 0xe0, 0x98, 0x03, 0x2b, 0x8c)
  356. #define EFI_IMAGE_SECURITY_DATABASE_GUID \
  357. EFI_GUID(0xd719b2cb, 0x3d3a, 0x4596, 0xa3, 0xbc, \
  358. 0xda, 0xd0, 0x0e, 0x67, 0x65, 0x6f)
  359. #define EFI_FDT_GUID \
  360. EFI_GUID(0xb1b621d5, 0xf19c, 0x41a5, \
  361. 0x83, 0x0b, 0xd9, 0x15, 0x2c, 0x69, 0xaa, 0xe0)
  362. #define EFI_ACPI_TABLE_GUID \
  363. EFI_GUID(0x8868e871, 0xe4f1, 0x11d3, \
  364. 0xbc, 0x22, 0x00, 0x80, 0xc7, 0x3c, 0x88, 0x81)
  365. #define SMBIOS_TABLE_GUID \
  366. EFI_GUID(0xeb9d2d31, 0x2d88, 0x11d3, \
  367. 0x9a, 0x16, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
  368. #define EFI_LOAD_FILE_PROTOCOL_GUID \
  369. EFI_GUID(0x56ec3091, 0x954c, 0x11d2, \
  370. 0x8e, 0x3f, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  371. #define EFI_LOAD_FILE2_PROTOCOL_GUID \
  372. EFI_GUID(0x4006c0c1, 0xfcb3, 0x403e, \
  373. 0x99, 0x6d, 0x4a, 0x6c, 0x87, 0x24, 0xe0, 0x6d)
  374. #define EFI_TCG2_FINAL_EVENTS_TABLE_GUID \
  375. EFI_GUID(0x1e2ed096, 0x30e2, 0x4254, 0xbd, \
  376. 0x89, 0x86, 0x3b, 0xbe, 0xf8, 0x23, 0x25)
  377. #define EFI_RNG_PROTOCOL_GUID \
  378. EFI_GUID(0x3152bca5, 0xeade, 0x433d, 0x86, 0x2e, \
  379. 0xc0, 0x1c, 0xdc, 0x29, 0x1f, 0x44)
  380. #define EFI_DT_FIXUP_PROTOCOL_GUID \
  381. EFI_GUID(0xe617d64c, 0xfe08, 0x46da, 0xf4, 0xdc, \
  382. 0xbb, 0xd5, 0x87, 0x0c, 0x73, 0x00)
  383. #define EFI_TCG2_PROTOCOL_GUID \
  384. EFI_GUID(0x607f766c, 0x7455, 0x42be, 0x93, \
  385. 0x0b, 0xe4, 0xd7, 0x6d, 0xb2, 0x72, 0x0f)
  386. /**
  387. * struct efi_configuration_table - EFI Configuration Table
  388. *
  389. * This table contains a set of GUID/pointer pairs.
  390. * The EFI Configuration Table may contain at most one instance of each table type.
  391. *
  392. * @guid: GUID that uniquely identifies the system configuration table
  393. * @table: A pointer to the table associated with guid
  394. */
  395. struct efi_configuration_table {
  396. efi_guid_t guid;
  397. void *table;
  398. } __packed;
  399. #define EFI_SYSTEM_TABLE_SIGNATURE ((u64)0x5453595320494249ULL)
  400. /**
  401. * struct efi_system_table - EFI System Table
  402. *
  403. * EFI System Table contains pointers to the runtime and boot services tables.
  404. *
  405. * @hdr: The table header for the EFI System Table
  406. * @fw_vendor: A pointer to a null terminated string that identifies the vendor
  407. * that produces the system firmware
  408. * @fw_revision: The revision of the system firmware
  409. * @con_in_handle: The handle for the active console input device
  410. * @con_in: A pointer to the EFI_SIMPLE_TEXT_INPUT_PROTOCOL interface
  411. * that is associated with con_in_handle
  412. * @con_out_handle: The handle for the active console output device
  413. * @con_out: A pointer to the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL interface
  414. * that is associated with con_out_handle
  415. * @stderr_handle: The handle for the active standard error console device
  416. * @std_err: A pointer to the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL interface
  417. * that is associated with stderr_handle
  418. * @runtime: A pointer to the EFI Runtime Services Table
  419. * @boottime: A pointer to the EFI Boot Services Table
  420. * @nr_tables: The number of system configuration tables
  421. * @tables: A pointer to the system configuration tables
  422. */
  423. struct efi_system_table {
  424. struct efi_table_hdr hdr;
  425. u16 *fw_vendor; /* physical addr of wchar_t vendor string */
  426. u32 fw_revision;
  427. efi_handle_t con_in_handle;
  428. struct efi_simple_text_input_protocol *con_in;
  429. efi_handle_t con_out_handle;
  430. struct efi_simple_text_output_protocol *con_out;
  431. efi_handle_t stderr_handle;
  432. struct efi_simple_text_output_protocol *std_err;
  433. struct efi_runtime_services *runtime;
  434. struct efi_boot_services *boottime;
  435. efi_uintn_t nr_tables;
  436. struct efi_configuration_table *tables;
  437. };
  438. #define EFI_LOADED_IMAGE_PROTOCOL_GUID \
  439. EFI_GUID(0x5b1b31a1, 0x9562, 0x11d2, \
  440. 0x8e, 0x3f, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  441. #define EFI_LOADED_IMAGE_DEVICE_PATH_PROTOCOL_GUID \
  442. EFI_GUID(0xbc62157e, 0x3e33, 0x4fec, \
  443. 0x99, 0x20, 0x2d, 0x3b, 0x36, 0xd7, 0x50, 0xdf)
  444. #define EFI_LOADED_IMAGE_PROTOCOL_REVISION 0x1000
  445. struct efi_loaded_image {
  446. u32 revision;
  447. void *parent_handle;
  448. struct efi_system_table *system_table;
  449. efi_handle_t device_handle;
  450. struct efi_device_path *file_path;
  451. void *reserved;
  452. u32 load_options_size;
  453. void *load_options;
  454. void *image_base;
  455. aligned_u64 image_size;
  456. unsigned int image_code_type;
  457. unsigned int image_data_type;
  458. efi_status_t (EFIAPI *unload)(efi_handle_t image_handle);
  459. };
  460. #define EFI_DEVICE_PATH_PROTOCOL_GUID \
  461. EFI_GUID(0x09576e91, 0x6d3f, 0x11d2, \
  462. 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  463. #define DEVICE_PATH_TYPE_END 0x7f
  464. # define DEVICE_PATH_SUB_TYPE_INSTANCE_END 0x01
  465. # define DEVICE_PATH_SUB_TYPE_END 0xff
  466. struct efi_device_path {
  467. u8 type;
  468. u8 sub_type;
  469. u16 length;
  470. } __packed;
  471. struct efi_mac_addr {
  472. u8 addr[32];
  473. } __packed;
  474. #define DEVICE_PATH_TYPE_HARDWARE_DEVICE 0x01
  475. # define DEVICE_PATH_SUB_TYPE_MEMORY 0x03
  476. # define DEVICE_PATH_SUB_TYPE_VENDOR 0x04
  477. struct efi_device_path_memory {
  478. struct efi_device_path dp;
  479. u32 memory_type;
  480. u64 start_address;
  481. u64 end_address;
  482. } __packed;
  483. struct efi_device_path_vendor {
  484. struct efi_device_path dp;
  485. efi_guid_t guid;
  486. u8 vendor_data[];
  487. } __packed;
  488. #define DEVICE_PATH_TYPE_ACPI_DEVICE 0x02
  489. # define DEVICE_PATH_SUB_TYPE_ACPI_DEVICE 0x01
  490. #define EFI_PNP_ID(ID) (u32)(((ID) << 16) | 0x41D0)
  491. #define EISA_PNP_ID(ID) EFI_PNP_ID(ID)
  492. #define EISA_PNP_NUM(ID) ((ID) >> 16)
  493. struct efi_device_path_acpi_path {
  494. struct efi_device_path dp;
  495. u32 hid;
  496. u32 uid;
  497. } __packed;
  498. #define DEVICE_PATH_TYPE_MESSAGING_DEVICE 0x03
  499. # define DEVICE_PATH_SUB_TYPE_MSG_ATAPI 0x01
  500. # define DEVICE_PATH_SUB_TYPE_MSG_SCSI 0x02
  501. # define DEVICE_PATH_SUB_TYPE_MSG_USB 0x05
  502. # define DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR 0x0b
  503. # define DEVICE_PATH_SUB_TYPE_MSG_UART 0x0e
  504. # define DEVICE_PATH_SUB_TYPE_MSG_USB_CLASS 0x0f
  505. # define DEVICE_PATH_SUB_TYPE_MSG_SATA 0x12
  506. # define DEVICE_PATH_SUB_TYPE_MSG_NVME 0x17
  507. # define DEVICE_PATH_SUB_TYPE_MSG_URI 0x18
  508. # define DEVICE_PATH_SUB_TYPE_MSG_SD 0x1a
  509. # define DEVICE_PATH_SUB_TYPE_MSG_MMC 0x1d
  510. struct efi_device_path_atapi {
  511. struct efi_device_path dp;
  512. u8 primary_secondary;
  513. u8 slave_master;
  514. u16 logical_unit_number;
  515. } __packed;
  516. struct efi_device_path_scsi {
  517. struct efi_device_path dp;
  518. u16 target_id;
  519. u16 logical_unit_number;
  520. } __packed;
  521. struct efi_device_path_uart {
  522. struct efi_device_path dp;
  523. u32 reserved;
  524. u64 baud_rate;
  525. u8 data_bits;
  526. u8 parity;
  527. u8 stop_bits;
  528. } __packed;
  529. struct efi_device_path_usb {
  530. struct efi_device_path dp;
  531. u8 parent_port_number;
  532. u8 usb_interface;
  533. } __packed;
  534. struct efi_device_path_sata {
  535. struct efi_device_path dp;
  536. u16 hba_port;
  537. u16 port_multiplier_port;
  538. u16 logical_unit_number;
  539. } __packed;
  540. struct efi_device_path_mac_addr {
  541. struct efi_device_path dp;
  542. struct efi_mac_addr mac;
  543. u8 if_type;
  544. } __packed;
  545. struct efi_device_path_usb_class {
  546. struct efi_device_path dp;
  547. u16 vendor_id;
  548. u16 product_id;
  549. u8 device_class;
  550. u8 device_subclass;
  551. u8 device_protocol;
  552. } __packed;
  553. struct efi_device_path_sd_mmc_path {
  554. struct efi_device_path dp;
  555. u8 slot_number;
  556. } __packed;
  557. struct efi_device_path_nvme {
  558. struct efi_device_path dp;
  559. u32 ns_id;
  560. u8 eui64[8];
  561. } __packed;
  562. struct efi_device_path_uri {
  563. struct efi_device_path dp;
  564. u8 uri[];
  565. } __packed;
  566. #define DEVICE_PATH_TYPE_MEDIA_DEVICE 0x04
  567. # define DEVICE_PATH_SUB_TYPE_HARD_DRIVE_PATH 0x01
  568. # define DEVICE_PATH_SUB_TYPE_CDROM_PATH 0x02
  569. # define DEVICE_PATH_SUB_TYPE_VENDOR_PATH 0x03
  570. # define DEVICE_PATH_SUB_TYPE_FILE_PATH 0x04
  571. struct efi_device_path_hard_drive_path {
  572. struct efi_device_path dp;
  573. u32 partition_number;
  574. u64 partition_start;
  575. u64 partition_end;
  576. u8 partition_signature[16];
  577. u8 partmap_type;
  578. u8 signature_type;
  579. } __packed;
  580. struct efi_device_path_cdrom_path {
  581. struct efi_device_path dp;
  582. u32 boot_entry;
  583. u64 partition_start;
  584. u64 partition_size;
  585. } __packed;
  586. struct efi_device_path_file_path {
  587. struct efi_device_path dp;
  588. u16 str[];
  589. } __packed;
  590. #define EFI_BLOCK_IO_PROTOCOL_GUID \
  591. EFI_GUID(0x964e5b21, 0x6459, 0x11d2, \
  592. 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  593. struct efi_block_io_media {
  594. u32 media_id;
  595. char removable_media;
  596. char media_present;
  597. char logical_partition;
  598. char read_only;
  599. char write_caching;
  600. u8 pad[3];
  601. u32 block_size;
  602. u32 io_align;
  603. u8 pad2[4];
  604. u64 last_block;
  605. /* Added in revision 2 of the protocol */
  606. u64 lowest_aligned_lba;
  607. u32 logical_blocks_per_physical_block;
  608. /* Added in revision 3 of the protocol */
  609. u32 optimal_transfer_length_granualarity;
  610. };
  611. #define EFI_BLOCK_IO_PROTOCOL_REVISION2 0x00020001
  612. #define EFI_BLOCK_IO_PROTOCOL_REVISION3 0x0002001f
  613. struct efi_block_io {
  614. u64 revision;
  615. struct efi_block_io_media *media;
  616. efi_status_t (EFIAPI *reset)(struct efi_block_io *this,
  617. char extended_verification);
  618. efi_status_t (EFIAPI *read_blocks)(struct efi_block_io *this,
  619. u32 media_id, u64 lba, efi_uintn_t buffer_size,
  620. void *buffer);
  621. efi_status_t (EFIAPI *write_blocks)(struct efi_block_io *this,
  622. u32 media_id, u64 lba, efi_uintn_t buffer_size,
  623. void *buffer);
  624. efi_status_t (EFIAPI *flush_blocks)(struct efi_block_io *this);
  625. };
  626. struct simple_text_output_mode {
  627. s32 max_mode;
  628. s32 mode;
  629. s32 attribute;
  630. s32 cursor_column;
  631. s32 cursor_row;
  632. bool cursor_visible;
  633. };
  634. #define EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL_GUID \
  635. EFI_GUID(0x387477c2, 0x69c7, 0x11d2, \
  636. 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  637. #define EFI_BLACK 0x00
  638. #define EFI_BLUE 0x01
  639. #define EFI_GREEN 0x02
  640. #define EFI_CYAN 0x03
  641. #define EFI_RED 0x04
  642. #define EFI_MAGENTA 0x05
  643. #define EFI_BROWN 0x06
  644. #define EFI_LIGHTGRAY 0x07
  645. #define EFI_BRIGHT 0x08
  646. #define EFI_DARKGRAY 0x08
  647. #define EFI_LIGHTBLUE 0x09
  648. #define EFI_LIGHTGREEN 0x0a
  649. #define EFI_LIGHTCYAN 0x0b
  650. #define EFI_LIGHTRED 0x0c
  651. #define EFI_LIGHTMAGENTA 0x0d
  652. #define EFI_YELLOW 0x0e
  653. #define EFI_WHITE 0x0f
  654. #define EFI_BACKGROUND_BLACK 0x00
  655. #define EFI_BACKGROUND_BLUE 0x10
  656. #define EFI_BACKGROUND_GREEN 0x20
  657. #define EFI_BACKGROUND_CYAN 0x30
  658. #define EFI_BACKGROUND_RED 0x40
  659. #define EFI_BACKGROUND_MAGENTA 0x50
  660. #define EFI_BACKGROUND_BROWN 0x60
  661. #define EFI_BACKGROUND_LIGHTGRAY 0x70
  662. /* extract foreground color from EFI attribute */
  663. #define EFI_ATTR_FG(attr) ((attr) & 0x07)
  664. /* treat high bit of FG as bright/bold (similar to edk2) */
  665. #define EFI_ATTR_BOLD(attr) (((attr) >> 3) & 0x01)
  666. /* extract background color from EFI attribute */
  667. #define EFI_ATTR_BG(attr) (((attr) >> 4) & 0x7)
  668. struct efi_simple_text_output_protocol {
  669. efi_status_t (EFIAPI *reset)(
  670. struct efi_simple_text_output_protocol *this,
  671. char extended_verification);
  672. efi_status_t (EFIAPI *output_string)(
  673. struct efi_simple_text_output_protocol *this,
  674. const u16 *str);
  675. efi_status_t (EFIAPI *test_string)(
  676. struct efi_simple_text_output_protocol *this,
  677. const u16 *str);
  678. efi_status_t(EFIAPI *query_mode)(
  679. struct efi_simple_text_output_protocol *this,
  680. unsigned long mode_number, unsigned long *columns,
  681. unsigned long *rows);
  682. efi_status_t(EFIAPI *set_mode)(
  683. struct efi_simple_text_output_protocol *this,
  684. unsigned long mode_number);
  685. efi_status_t(EFIAPI *set_attribute)(
  686. struct efi_simple_text_output_protocol *this,
  687. unsigned long attribute);
  688. efi_status_t(EFIAPI *clear_screen) (
  689. struct efi_simple_text_output_protocol *this);
  690. efi_status_t(EFIAPI *set_cursor_position) (
  691. struct efi_simple_text_output_protocol *this,
  692. unsigned long column, unsigned long row);
  693. efi_status_t(EFIAPI *enable_cursor)(
  694. struct efi_simple_text_output_protocol *this,
  695. bool enable);
  696. struct simple_text_output_mode *mode;
  697. };
  698. #define EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL_GUID \
  699. EFI_GUID(0xdd9e7534, 0x7762, 0x4698, \
  700. 0x8c, 0x14, 0xf5, 0x85, 0x17, 0xa6, 0x25, 0xaa)
  701. struct efi_input_key {
  702. u16 scan_code;
  703. s16 unicode_char;
  704. };
  705. #define EFI_SHIFT_STATE_INVALID 0x00000000
  706. #define EFI_RIGHT_SHIFT_PRESSED 0x00000001
  707. #define EFI_LEFT_SHIFT_PRESSED 0x00000002
  708. #define EFI_RIGHT_CONTROL_PRESSED 0x00000004
  709. #define EFI_LEFT_CONTROL_PRESSED 0x00000008
  710. #define EFI_RIGHT_ALT_PRESSED 0x00000010
  711. #define EFI_LEFT_ALT_PRESSED 0x00000020
  712. #define EFI_RIGHT_LOGO_PRESSED 0x00000040
  713. #define EFI_LEFT_LOGO_PRESSED 0x00000080
  714. #define EFI_MENU_KEY_PRESSED 0x00000100
  715. #define EFI_SYS_REQ_PRESSED 0x00000200
  716. #define EFI_SHIFT_STATE_VALID 0x80000000
  717. #define EFI_TOGGLE_STATE_INVALID 0x00
  718. #define EFI_SCROLL_LOCK_ACTIVE 0x01
  719. #define EFI_NUM_LOCK_ACTIVE 0x02
  720. #define EFI_CAPS_LOCK_ACTIVE 0x04
  721. #define EFI_KEY_STATE_EXPOSED 0x40
  722. #define EFI_TOGGLE_STATE_VALID 0x80
  723. struct efi_key_state {
  724. u32 key_shift_state;
  725. u8 key_toggle_state;
  726. };
  727. struct efi_key_data {
  728. struct efi_input_key key;
  729. struct efi_key_state key_state;
  730. };
  731. struct efi_simple_text_input_ex_protocol {
  732. efi_status_t (EFIAPI *reset) (
  733. struct efi_simple_text_input_ex_protocol *this,
  734. bool extended_verification);
  735. efi_status_t (EFIAPI *read_key_stroke_ex) (
  736. struct efi_simple_text_input_ex_protocol *this,
  737. struct efi_key_data *key_data);
  738. struct efi_event *wait_for_key_ex;
  739. efi_status_t (EFIAPI *set_state) (
  740. struct efi_simple_text_input_ex_protocol *this,
  741. u8 *key_toggle_state);
  742. efi_status_t (EFIAPI *register_key_notify) (
  743. struct efi_simple_text_input_ex_protocol *this,
  744. struct efi_key_data *key_data,
  745. efi_status_t (EFIAPI *key_notify_function)(
  746. struct efi_key_data *key_data),
  747. void **notify_handle);
  748. efi_status_t (EFIAPI *unregister_key_notify) (
  749. struct efi_simple_text_input_ex_protocol *this,
  750. void *notification_handle);
  751. };
  752. #define EFI_SIMPLE_TEXT_INPUT_PROTOCOL_GUID \
  753. EFI_GUID(0x387477c1, 0x69c7, 0x11d2, \
  754. 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  755. struct efi_simple_text_input_protocol {
  756. efi_status_t(EFIAPI *reset)(struct efi_simple_text_input_protocol *this,
  757. bool extended_verification);
  758. efi_status_t(EFIAPI *read_key_stroke)(
  759. struct efi_simple_text_input_protocol *this,
  760. struct efi_input_key *key);
  761. struct efi_event *wait_for_key;
  762. };
  763. #define EFI_DEVICE_PATH_TO_TEXT_PROTOCOL_GUID \
  764. EFI_GUID(0x8b843e20, 0x8132, 0x4852, \
  765. 0x90, 0xcc, 0x55, 0x1a, 0x4e, 0x4a, 0x7f, 0x1c)
  766. struct efi_device_path_to_text_protocol {
  767. uint16_t *(EFIAPI *convert_device_node_to_text)(
  768. struct efi_device_path *device_node,
  769. bool display_only,
  770. bool allow_shortcuts);
  771. uint16_t *(EFIAPI *convert_device_path_to_text)(
  772. struct efi_device_path *device_path,
  773. bool display_only,
  774. bool allow_shortcuts);
  775. };
  776. #define EFI_DEVICE_PATH_UTILITIES_PROTOCOL_GUID \
  777. EFI_GUID(0x0379be4e, 0xd706, 0x437d, \
  778. 0xb0, 0x37, 0xed, 0xb8, 0x2f, 0xb7, 0x72, 0xa4)
  779. struct efi_device_path_utilities_protocol {
  780. efi_uintn_t (EFIAPI *get_device_path_size)(
  781. const struct efi_device_path *device_path);
  782. struct efi_device_path *(EFIAPI *duplicate_device_path)(
  783. const struct efi_device_path *device_path);
  784. struct efi_device_path *(EFIAPI *append_device_path)(
  785. const struct efi_device_path *src1,
  786. const struct efi_device_path *src2);
  787. struct efi_device_path *(EFIAPI *append_device_node)(
  788. const struct efi_device_path *device_path,
  789. const struct efi_device_path *device_node);
  790. struct efi_device_path *(EFIAPI *append_device_path_instance)(
  791. const struct efi_device_path *device_path,
  792. const struct efi_device_path *device_path_instance);
  793. struct efi_device_path *(EFIAPI *get_next_device_path_instance)(
  794. struct efi_device_path **device_path_instance,
  795. efi_uintn_t *device_path_instance_size);
  796. bool (EFIAPI *is_device_path_multi_instance)(
  797. const struct efi_device_path *device_path);
  798. struct efi_device_path *(EFIAPI *create_device_node)(
  799. uint8_t node_type,
  800. uint8_t node_sub_type,
  801. uint16_t node_length);
  802. };
  803. /*
  804. * Human Interface Infrastructure (HII)
  805. */
  806. struct efi_hii_package_list_header {
  807. efi_guid_t package_list_guid;
  808. u32 package_length;
  809. } __packed;
  810. /**
  811. * struct efi_hii_package_header - EFI HII package header
  812. *
  813. * @fields: 'fields' replaces the bit-fields defined in the EFI
  814. * specification to to avoid possible compiler incompatibilities::
  815. *
  816. * u32 length:24;
  817. * u32 type:8;
  818. */
  819. struct efi_hii_package_header {
  820. u32 fields;
  821. } __packed;
  822. #define __EFI_HII_PACKAGE_LEN_SHIFT 0
  823. #define __EFI_HII_PACKAGE_TYPE_SHIFT 24
  824. #define __EFI_HII_PACKAGE_LEN_MASK 0xffffff
  825. #define __EFI_HII_PACKAGE_TYPE_MASK 0xff
  826. #define EFI_HII_PACKAGE_TYPE_ALL 0x00
  827. #define EFI_HII_PACKAGE_TYPE_GUID 0x01
  828. #define EFI_HII_PACKAGE_FORMS 0x02
  829. #define EFI_HII_PACKAGE_STRINGS 0x04
  830. #define EFI_HII_PACKAGE_FONTS 0x05
  831. #define EFI_HII_PACKAGE_IMAGES 0x06
  832. #define EFI_HII_PACKAGE_SIMPLE_FONTS 0x07
  833. #define EFI_HII_PACKAGE_DEVICE_PATH 0x08
  834. #define EFI_HII_PACKAGE_KEYBOARD_LAYOUT 0x09
  835. #define EFI_HII_PACKAGE_ANIMATIONS 0x0A
  836. #define EFI_HII_PACKAGE_END 0xDF
  837. #define EFI_HII_PACKAGE_TYPE_SYSTEM_BEGIN 0xE0
  838. #define EFI_HII_PACKAGE_TYPE_SYSTEM_END 0xFF
  839. /*
  840. * HII GUID package
  841. */
  842. struct efi_hii_guid_package {
  843. struct efi_hii_package_header header;
  844. efi_guid_t guid;
  845. char data[];
  846. } __packed;
  847. /*
  848. * HII string package
  849. */
  850. struct efi_hii_strings_package {
  851. struct efi_hii_package_header header;
  852. u32 header_size;
  853. u32 string_info_offset;
  854. u16 language_window[16];
  855. efi_string_id_t language_name;
  856. u8 language[];
  857. } __packed;
  858. struct efi_hii_string_block {
  859. u8 block_type;
  860. /* u8 block_body[]; */
  861. } __packed;
  862. #define EFI_HII_SIBT_END 0x00
  863. #define EFI_HII_SIBT_STRING_SCSU 0x10
  864. #define EFI_HII_SIBT_STRING_SCSU_FONT 0x11
  865. #define EFI_HII_SIBT_STRINGS_SCSU 0x12
  866. #define EFI_HII_SIBT_STRINGS_SCSU_FONT 0x13
  867. #define EFI_HII_SIBT_STRING_UCS2 0x14
  868. #define EFI_HII_SIBT_STRING_UCS2_FONT 0x15
  869. #define EFI_HII_SIBT_STRINGS_UCS2 0x16
  870. #define EFI_HII_SIBT_STRINGS_UCS2_FONT 0x17
  871. #define EFI_HII_SIBT_DUPLICATE 0x20
  872. #define EFI_HII_SIBT_SKIP2 0x21
  873. #define EFI_HII_SIBT_SKIP1 0x22
  874. #define EFI_HII_SIBT_EXT1 0x30
  875. #define EFI_HII_SIBT_EXT2 0x31
  876. #define EFI_HII_SIBT_EXT4 0x32
  877. #define EFI_HII_SIBT_FONT 0x40
  878. struct efi_hii_sibt_string_ucs2_block {
  879. struct efi_hii_string_block header;
  880. u16 string_text[];
  881. } __packed;
  882. static inline struct efi_hii_string_block *
  883. efi_hii_sibt_string_ucs2_block_next(struct efi_hii_sibt_string_ucs2_block *blk)
  884. {
  885. return ((void *)blk) + sizeof(*blk) +
  886. (u16_strlen(blk->string_text) + 1) * 2;
  887. }
  888. /*
  889. * HII forms package
  890. * TODO: full scope of definitions
  891. */
  892. struct efi_hii_time {
  893. u8 hour;
  894. u8 minute;
  895. u8 second;
  896. };
  897. struct efi_hii_date {
  898. u16 year;
  899. u8 month;
  900. u8 day;
  901. };
  902. struct efi_hii_ref {
  903. efi_question_id_t question_id;
  904. efi_form_id_t form_id;
  905. efi_guid_t form_set_guid;
  906. efi_string_id_t device_path;
  907. };
  908. union efi_ifr_type_value {
  909. u8 u8; // EFI_IFR_TYPE_NUM_SIZE_8
  910. u16 u16; // EFI_IFR_TYPE_NUM_SIZE_16
  911. u32 u32; // EFI_IFR_TYPE_NUM_SIZE_32
  912. u64 u64; // EFI_IFR_TYPE_NUM_SIZE_64
  913. bool b; // EFI_IFR_TYPE_BOOLEAN
  914. struct efi_hii_time time; // EFI_IFR_TYPE_TIME
  915. struct efi_hii_date date; // EFI_IFR_TYPE_DATE
  916. efi_string_id_t string; // EFI_IFR_TYPE_STRING, EFI_IFR_TYPE_ACTION
  917. struct efi_hii_ref ref; // EFI_IFR_TYPE_REF
  918. // u8 buffer[]; // EFI_IFR_TYPE_BUFFER
  919. };
  920. #define EFI_IFR_TYPE_NUM_SIZE_8 0x00
  921. #define EFI_IFR_TYPE_NUM_SIZE_16 0x01
  922. #define EFI_IFR_TYPE_NUM_SIZE_32 0x02
  923. #define EFI_IFR_TYPE_NUM_SIZE_64 0x03
  924. #define EFI_IFR_TYPE_BOOLEAN 0x04
  925. #define EFI_IFR_TYPE_TIME 0x05
  926. #define EFI_IFR_TYPE_DATE 0x06
  927. #define EFI_IFR_TYPE_STRING 0x07
  928. #define EFI_IFR_TYPE_OTHER 0x08
  929. #define EFI_IFR_TYPE_UNDEFINED 0x09
  930. #define EFI_IFR_TYPE_ACTION 0x0A
  931. #define EFI_IFR_TYPE_BUFFER 0x0B
  932. #define EFI_IFR_TYPE_REF 0x0C
  933. #define EFI_IFR_OPTION_DEFAULT 0x10
  934. #define EFI_IFR_OPTION_DEFAULT_MFG 0x20
  935. #define EFI_IFR_ONE_OF_OPTION_OP 0x09
  936. struct efi_ifr_op_header {
  937. u8 opCode;
  938. u8 length:7;
  939. u8 scope:1;
  940. };
  941. struct efi_ifr_one_of_option {
  942. struct efi_ifr_op_header header;
  943. efi_string_id_t option;
  944. u8 flags;
  945. u8 type;
  946. union efi_ifr_type_value value;
  947. };
  948. typedef efi_uintn_t efi_browser_action_t;
  949. #define EFI_BROWSER_ACTION_REQUEST_NONE 0
  950. #define EFI_BROWSER_ACTION_REQUEST_RESET 1
  951. #define EFI_BROWSER_ACTION_REQUEST_SUBMIT 2
  952. #define EFI_BROWSER_ACTION_REQUEST_EXIT 3
  953. #define EFI_BROWSER_ACTION_REQUEST_FORM_SUBMIT_EXIT 4
  954. #define EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD_EXIT 5
  955. #define EFI_BROWSER_ACTION_REQUEST_FORM_APPLY 6
  956. #define EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD 7
  957. #define EFI_BROWSER_ACTION_REQUEST_RECONNECT 8
  958. typedef efi_uintn_t efi_browser_action_request_t;
  959. #define EFI_BROWSER_ACTION_CHANGING 0
  960. #define EFI_BROWSER_ACTION_CHANGED 1
  961. #define EFI_BROWSER_ACTION_RETRIEVE 2
  962. #define EFI_BROWSER_ACTION_FORM_OPEN 3
  963. #define EFI_BROWSER_ACTION_FORM_CLOSE 4
  964. #define EFI_BROWSER_ACTION_SUBMITTED 5
  965. #define EFI_BROWSER_ACTION_DEFAULT_STANDARD 0x1000
  966. #define EFI_BROWSER_ACTION_DEFAULT_MANUFACTURING 0x1001
  967. #define EFI_BROWSER_ACTION_DEFAULT_SAFE 0x1002
  968. #define EFI_BROWSER_ACTION_DEFAULT_PLATFORM 0x2000
  969. #define EFI_BROWSER_ACTION_DEFAULT_HARDWARE 0x3000
  970. #define EFI_BROWSER_ACTION_DEFAULT_FIRMWARE 0x4000
  971. /*
  972. * HII keyboard package
  973. */
  974. typedef enum {
  975. EFI_KEY_LCTRL, EFI_KEY_A0, EFI_KEY_LALT, EFI_KEY_SPACE_BAR,
  976. EFI_KEY_A2, EFI_KEY_A3, EFI_KEY_A4, EFI_KEY_RCTRL, EFI_KEY_LEFT_ARROW,
  977. EFI_KEY_DOWN_ARROW, EFI_KEY_RIGHT_ARROW, EFI_KEY_ZERO,
  978. EFI_KEY_PERIOD, EFI_KEY_ENTER, EFI_KEY_LSHIFT, EFI_KEY_B0,
  979. EFI_KEY_B1, EFI_KEY_B2, EFI_KEY_B3, EFI_KEY_B4, EFI_KEY_B5, EFI_KEY_B6,
  980. EFI_KEY_B7, EFI_KEY_B8, EFI_KEY_B9, EFI_KEY_B10, EFI_KEY_RSHIFT,
  981. EFI_KEY_UP_ARROW, EFI_KEY_ONE, EFI_KEY_TWO, EFI_KEY_THREE,
  982. EFI_KEY_CAPS_LOCK, EFI_KEY_C1, EFI_KEY_C2, EFI_KEY_C3, EFI_KEY_C4,
  983. EFI_KEY_C5, EFI_KEY_C6, EFI_KEY_C7, EFI_KEY_C8, EFI_KEY_C9,
  984. EFI_KEY_C10, EFI_KEY_C11, EFI_KEY_C12, EFI_KEY_FOUR, EFI_KEY_FIVE,
  985. EFI_KEY_SIX, EFI_KEY_PLUS, EFI_KEY_TAB, EFI_KEY_D1, EFI_KEY_D2,
  986. EFI_KEY_D3, EFI_KEY_D4, EFI_KEY_D5, EFI_KEY_D6, EFI_KEY_D7, EFI_KEY_D8,
  987. EFI_KEY_D9, EFI_KEY_D10, EFI_KEY_D11, EFI_KEY_D12, EFI_KEY_D13,
  988. EFI_KEY_DEL, EFI_KEY_END, EFI_KEY_PG_DN, EFI_KEY_SEVEN, EFI_KEY_EIGHT,
  989. EFI_KEY_NINE, EFI_KEY_E0, EFI_KEY_E1, EFI_KEY_E2, EFI_KEY_E3,
  990. EFI_KEY_E4, EFI_KEY_E5, EFI_KEY_E6, EFI_KEY_E7, EFI_KEY_E8, EFI_KEY_E9,
  991. EFI_KEY_E10, EFI_KEY_E11, EFI_KEY_E12, EFI_KEY_BACK_SPACE,
  992. EFI_KEY_INS, EFI_KEY_HOME, EFI_KEY_PG_UP, EFI_KEY_NLCK, EFI_KEY_SLASH,
  993. EFI_KEY_ASTERISK, EFI_KEY_MINUS, EFI_KEY_ESC, EFI_KEY_F1, EFI_KEY_F2,
  994. EFI_KEY_F3, EFI_KEY_F4, EFI_KEY_F5, EFI_KEY_F6, EFI_KEY_F7, EFI_KEY_F8,
  995. EFI_KEY_F9, EFI_KEY_F10, EFI_KEY_F11, EFI_KEY_F12, EFI_KEY_PRINT,
  996. EFI_KEY_SLCK, EFI_KEY_PAUSE,
  997. } efi_key;
  998. struct efi_key_descriptor {
  999. u32 key;
  1000. u16 unicode;
  1001. u16 shifted_unicode;
  1002. u16 alt_gr_unicode;
  1003. u16 shifted_alt_gr_unicode;
  1004. u16 modifier;
  1005. u16 affected_attribute;
  1006. } __packed;
  1007. struct efi_hii_keyboard_layout {
  1008. u16 layout_length;
  1009. efi_guid_t guid;
  1010. u32 layout_descriptor_string_offset;
  1011. u8 descriptor_count;
  1012. struct efi_key_descriptor descriptors[];
  1013. } __packed;
  1014. struct efi_hii_keyboard_package {
  1015. struct efi_hii_package_header header;
  1016. u16 layout_count;
  1017. struct efi_hii_keyboard_layout layout[];
  1018. } __packed;
  1019. /*
  1020. * HII protocols
  1021. */
  1022. #define EFI_HII_STRING_PROTOCOL_GUID \
  1023. EFI_GUID(0x0fd96974, 0x23aa, 0x4cdc, \
  1024. 0xb9, 0xcb, 0x98, 0xd1, 0x77, 0x50, 0x32, 0x2a)
  1025. struct efi_font_info {
  1026. efi_hii_font_style_t font_style;
  1027. u16 font_size;
  1028. u16 font_name[1];
  1029. };
  1030. struct efi_hii_string_protocol {
  1031. efi_status_t(EFIAPI *new_string)(
  1032. const struct efi_hii_string_protocol *this,
  1033. efi_hii_handle_t package_list,
  1034. efi_string_id_t *string_id,
  1035. const u8 *language,
  1036. const u16 *language_name,
  1037. const efi_string_t string,
  1038. const struct efi_font_info *string_font_info);
  1039. efi_status_t(EFIAPI *get_string)(
  1040. const struct efi_hii_string_protocol *this,
  1041. const u8 *language,
  1042. efi_hii_handle_t package_list,
  1043. efi_string_id_t string_id,
  1044. efi_string_t string,
  1045. efi_uintn_t *string_size,
  1046. struct efi_font_info **string_font_info);
  1047. efi_status_t(EFIAPI *set_string)(
  1048. const struct efi_hii_string_protocol *this,
  1049. efi_hii_handle_t package_list,
  1050. efi_string_id_t string_id,
  1051. const u8 *language,
  1052. const efi_string_t string,
  1053. const struct efi_font_info *string_font_info);
  1054. efi_status_t(EFIAPI *get_languages)(
  1055. const struct efi_hii_string_protocol *this,
  1056. efi_hii_handle_t package_list,
  1057. u8 *languages,
  1058. efi_uintn_t *languages_size);
  1059. efi_status_t(EFIAPI *get_secondary_languages)(
  1060. const struct efi_hii_string_protocol *this,
  1061. efi_hii_handle_t package_list,
  1062. const u8 *primary_language,
  1063. u8 *secondary_languages,
  1064. efi_uintn_t *secondary_languages_size);
  1065. };
  1066. #define EFI_HII_DATABASE_PROTOCOL_GUID \
  1067. EFI_GUID(0xef9fc172, 0xa1b2, 0x4693, \
  1068. 0xb3, 0x27, 0x6d, 0x32, 0xfc, 0x41, 0x60, 0x42)
  1069. struct efi_hii_database_protocol {
  1070. efi_status_t(EFIAPI *new_package_list)(
  1071. const struct efi_hii_database_protocol *this,
  1072. const struct efi_hii_package_list_header *package_list,
  1073. const efi_handle_t driver_handle,
  1074. efi_hii_handle_t *handle);
  1075. efi_status_t(EFIAPI *remove_package_list)(
  1076. const struct efi_hii_database_protocol *this,
  1077. efi_hii_handle_t handle);
  1078. efi_status_t(EFIAPI *update_package_list)(
  1079. const struct efi_hii_database_protocol *this,
  1080. efi_hii_handle_t handle,
  1081. const struct efi_hii_package_list_header *package_list);
  1082. efi_status_t(EFIAPI *list_package_lists)(
  1083. const struct efi_hii_database_protocol *this,
  1084. u8 package_type,
  1085. const efi_guid_t *package_guid,
  1086. efi_uintn_t *handle_buffer_length,
  1087. efi_hii_handle_t *handle);
  1088. efi_status_t(EFIAPI *export_package_lists)(
  1089. const struct efi_hii_database_protocol *this,
  1090. efi_hii_handle_t handle,
  1091. efi_uintn_t *buffer_size,
  1092. struct efi_hii_package_list_header *buffer);
  1093. efi_status_t(EFIAPI *register_package_notify)(
  1094. const struct efi_hii_database_protocol *this,
  1095. u8 package_type,
  1096. const efi_guid_t *package_guid,
  1097. const void *package_notify_fn,
  1098. efi_uintn_t notify_type,
  1099. efi_handle_t *notify_handle);
  1100. efi_status_t(EFIAPI *unregister_package_notify)(
  1101. const struct efi_hii_database_protocol *this,
  1102. efi_handle_t notification_handle
  1103. );
  1104. efi_status_t(EFIAPI *find_keyboard_layouts)(
  1105. const struct efi_hii_database_protocol *this,
  1106. u16 *key_guid_buffer_length,
  1107. efi_guid_t *key_guid_buffer);
  1108. efi_status_t(EFIAPI *get_keyboard_layout)(
  1109. const struct efi_hii_database_protocol *this,
  1110. efi_guid_t *key_guid,
  1111. u16 *keyboard_layout_length,
  1112. struct efi_hii_keyboard_layout *keyboard_layout);
  1113. efi_status_t(EFIAPI *set_keyboard_layout)(
  1114. const struct efi_hii_database_protocol *this,
  1115. efi_guid_t *key_guid);
  1116. efi_status_t(EFIAPI *get_package_list_handle)(
  1117. const struct efi_hii_database_protocol *this,
  1118. efi_hii_handle_t package_list_handle,
  1119. efi_handle_t *driver_handle);
  1120. };
  1121. #define EFI_HII_CONFIG_ROUTING_PROTOCOL_GUID \
  1122. EFI_GUID(0x587e72d7, 0xcc50, 0x4f79, \
  1123. 0x82, 0x09, 0xca, 0x29, 0x1f, 0xc1, 0xa1, 0x0f)
  1124. struct efi_hii_config_routing_protocol {
  1125. efi_status_t(EFIAPI *extract_config)(
  1126. const struct efi_hii_config_routing_protocol *this,
  1127. const efi_string_t request,
  1128. efi_string_t *progress,
  1129. efi_string_t *results);
  1130. efi_status_t(EFIAPI *export_config)(
  1131. const struct efi_hii_config_routing_protocol *this,
  1132. efi_string_t *results);
  1133. efi_status_t(EFIAPI *route_config)(
  1134. const struct efi_hii_config_routing_protocol *this,
  1135. const efi_string_t configuration,
  1136. efi_string_t *progress);
  1137. efi_status_t(EFIAPI *block_to_config)(
  1138. const struct efi_hii_config_routing_protocol *this,
  1139. const efi_string_t config_request,
  1140. const uint8_t *block,
  1141. const efi_uintn_t block_size,
  1142. efi_string_t *config,
  1143. efi_string_t *progress);
  1144. efi_status_t(EFIAPI *config_to_block)(
  1145. const struct efi_hii_config_routing_protocol *this,
  1146. const efi_string_t config_resp,
  1147. const uint8_t *block,
  1148. const efi_uintn_t *block_size,
  1149. efi_string_t *progress);
  1150. efi_status_t(EFIAPI *get_alt_config)(
  1151. const struct efi_hii_config_routing_protocol *this,
  1152. const efi_string_t config_resp,
  1153. const efi_guid_t *guid,
  1154. const efi_string_t name,
  1155. const struct efi_device_path *device_path,
  1156. const efi_string_t alt_cfg_id,
  1157. efi_string_t *alt_cfg_resp);
  1158. };
  1159. #define EFI_HII_CONFIG_ACCESS_PROTOCOL_GUID \
  1160. EFI_GUID(0x330d4706, 0xf2a0, 0x4e4f, \
  1161. 0xa3, 0x69, 0xb6, 0x6f, 0xa8, 0xd5, 0x43, 0x85)
  1162. struct efi_hii_config_access_protocol {
  1163. efi_status_t(EFIAPI *extract_config_access)(
  1164. const struct efi_hii_config_access_protocol *this,
  1165. const efi_string_t request,
  1166. efi_string_t *progress,
  1167. efi_string_t *results);
  1168. efi_status_t(EFIAPI *route_config_access)(
  1169. const struct efi_hii_config_access_protocol *this,
  1170. const efi_string_t configuration,
  1171. efi_string_t *progress);
  1172. efi_status_t(EFIAPI *form_callback)(
  1173. const struct efi_hii_config_access_protocol *this,
  1174. efi_browser_action_t action,
  1175. efi_question_id_t question_id,
  1176. u8 type,
  1177. union efi_ifr_type_value *value,
  1178. efi_browser_action_request_t *action_request);
  1179. };
  1180. #define EFI_GRAPHICS_OUTPUT_PROTOCOL_GUID \
  1181. EFI_GUID(0x9042a9de, 0x23dc, 0x4a38, \
  1182. 0x96, 0xfb, 0x7a, 0xde, 0xd0, 0x80, 0x51, 0x6a)
  1183. #define EFI_GOT_RGBA8 0
  1184. #define EFI_GOT_BGRA8 1
  1185. #define EFI_GOT_BITMASK 2
  1186. struct efi_gop_mode_info {
  1187. u32 version;
  1188. u32 width;
  1189. u32 height;
  1190. u32 pixel_format;
  1191. u32 pixel_bitmask[4];
  1192. u32 pixels_per_scanline;
  1193. };
  1194. struct efi_gop_mode {
  1195. u32 max_mode;
  1196. u32 mode;
  1197. struct efi_gop_mode_info *info;
  1198. unsigned long info_size;
  1199. efi_physical_addr_t fb_base;
  1200. unsigned long fb_size;
  1201. };
  1202. struct efi_gop_pixel {
  1203. u8 blue;
  1204. u8 green;
  1205. u8 red;
  1206. u8 reserved;
  1207. };
  1208. #define EFI_BLT_VIDEO_FILL 0
  1209. #define EFI_BLT_VIDEO_TO_BLT_BUFFER 1
  1210. #define EFI_BLT_BUFFER_TO_VIDEO 2
  1211. #define EFI_BLT_VIDEO_TO_VIDEO 3
  1212. struct efi_gop {
  1213. efi_status_t (EFIAPI *query_mode)(struct efi_gop *this, u32 mode_number,
  1214. efi_uintn_t *size_of_info,
  1215. struct efi_gop_mode_info **info);
  1216. efi_status_t (EFIAPI *set_mode)(struct efi_gop *this, u32 mode_number);
  1217. efi_status_t (EFIAPI *blt)(struct efi_gop *this,
  1218. struct efi_gop_pixel *buffer,
  1219. u32 operation, efi_uintn_t sx,
  1220. efi_uintn_t sy, efi_uintn_t dx,
  1221. efi_uintn_t dy, efi_uintn_t width,
  1222. efi_uintn_t height, efi_uintn_t delta);
  1223. struct efi_gop_mode *mode;
  1224. };
  1225. #define EFI_SIMPLE_NETWORK_PROTOCOL_GUID \
  1226. EFI_GUID(0xa19832b9, 0xac25, 0x11d3, \
  1227. 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
  1228. struct efi_mac_address {
  1229. char mac_addr[32];
  1230. };
  1231. struct efi_ip_address {
  1232. u8 ip_addr[16];
  1233. } __attribute__((aligned(4)));
  1234. enum efi_simple_network_state {
  1235. EFI_NETWORK_STOPPED,
  1236. EFI_NETWORK_STARTED,
  1237. EFI_NETWORK_INITIALIZED,
  1238. };
  1239. struct efi_simple_network_mode {
  1240. enum efi_simple_network_state state;
  1241. u32 hwaddr_size;
  1242. u32 media_header_size;
  1243. u32 max_packet_size;
  1244. u32 nvram_size;
  1245. u32 nvram_access_size;
  1246. u32 receive_filter_mask;
  1247. u32 receive_filter_setting;
  1248. u32 max_mcast_filter_count;
  1249. u32 mcast_filter_count;
  1250. struct efi_mac_address mcast_filter[16];
  1251. struct efi_mac_address current_address;
  1252. struct efi_mac_address broadcast_address;
  1253. struct efi_mac_address permanent_address;
  1254. u8 if_type;
  1255. u8 mac_changeable;
  1256. u8 multitx_supported;
  1257. u8 media_present_supported;
  1258. u8 media_present;
  1259. };
  1260. /* receive_filters bit mask */
  1261. #define EFI_SIMPLE_NETWORK_RECEIVE_UNICAST 0x01
  1262. #define EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST 0x02
  1263. #define EFI_SIMPLE_NETWORK_RECEIVE_BROADCAST 0x04
  1264. #define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS 0x08
  1265. #define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS_MULTICAST 0x10
  1266. /* interrupt status bit mask */
  1267. #define EFI_SIMPLE_NETWORK_RECEIVE_INTERRUPT 0x01
  1268. #define EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT 0x02
  1269. #define EFI_SIMPLE_NETWORK_COMMAND_INTERRUPT 0x04
  1270. #define EFI_SIMPLE_NETWORK_SOFTWARE_INTERRUPT 0x08
  1271. /* revision of the simple network protocol */
  1272. #define EFI_SIMPLE_NETWORK_PROTOCOL_REVISION 0x00010000
  1273. struct efi_simple_network {
  1274. u64 revision;
  1275. efi_status_t (EFIAPI *start)(struct efi_simple_network *this);
  1276. efi_status_t (EFIAPI *stop)(struct efi_simple_network *this);
  1277. efi_status_t (EFIAPI *initialize)(struct efi_simple_network *this,
  1278. ulong extra_rx, ulong extra_tx);
  1279. efi_status_t (EFIAPI *reset)(struct efi_simple_network *this,
  1280. int extended_verification);
  1281. efi_status_t (EFIAPI *shutdown)(struct efi_simple_network *this);
  1282. efi_status_t (EFIAPI *receive_filters)(struct efi_simple_network *this,
  1283. u32 enable, u32 disable, int reset_mcast_filter,
  1284. ulong mcast_filter_count,
  1285. struct efi_mac_address *mcast_filter);
  1286. efi_status_t (EFIAPI *station_address)(struct efi_simple_network *this,
  1287. int reset, struct efi_mac_address *new_mac);
  1288. efi_status_t (EFIAPI *statistics)(struct efi_simple_network *this,
  1289. int reset, ulong *stat_size, void *stat_table);
  1290. efi_status_t (EFIAPI *mcastiptomac)(struct efi_simple_network *this,
  1291. int ipv6, struct efi_ip_address *ip,
  1292. struct efi_mac_address *mac);
  1293. efi_status_t (EFIAPI *nvdata)(struct efi_simple_network *this,
  1294. int read_write, ulong offset, ulong buffer_size,
  1295. char *buffer);
  1296. efi_status_t (EFIAPI *get_status)(struct efi_simple_network *this,
  1297. u32 *int_status, void **txbuf);
  1298. efi_status_t (EFIAPI *transmit)(struct efi_simple_network *this,
  1299. size_t header_size, size_t buffer_size, void *buffer,
  1300. struct efi_mac_address *src_addr,
  1301. struct efi_mac_address *dest_addr, u16 *protocol);
  1302. efi_status_t (EFIAPI *receive)(struct efi_simple_network *this,
  1303. size_t *header_size, size_t *buffer_size, void *buffer,
  1304. struct efi_mac_address *src_addr,
  1305. struct efi_mac_address *dest_addr, u16 *protocol);
  1306. struct efi_event *wait_for_packet;
  1307. struct efi_simple_network_mode *mode;
  1308. /* private fields */
  1309. u32 int_status;
  1310. };
  1311. #define EFI_PXE_BASE_CODE_PROTOCOL_GUID \
  1312. EFI_GUID(0x03c4e603, 0xac28, 0x11d3, \
  1313. 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
  1314. #define EFI_PXE_BASE_CODE_PROTOCOL_REVISION 0x00010000
  1315. #define EFI_PXE_BASE_CODE_MAX_IPCNT 8
  1316. struct efi_pxe_packet {
  1317. u8 packet[1472];
  1318. };
  1319. struct efi_pxe_mode {
  1320. u8 started;
  1321. u8 ipv6_available;
  1322. u8 ipv6_supported;
  1323. u8 using_ipv6;
  1324. u8 bis_supported;
  1325. u8 bis_detected;
  1326. u8 auto_arp;
  1327. u8 send_guid;
  1328. u8 dhcp_discover_valid;
  1329. u8 dhcp_ack_received;
  1330. u8 proxy_offer_received;
  1331. u8 pxe_discover_valid;
  1332. u8 pxe_reply_received;
  1333. u8 pxe_bis_reply_received;
  1334. u8 icmp_error_received;
  1335. u8 tftp_error_received;
  1336. u8 make_callbacks;
  1337. u8 ttl;
  1338. u8 tos;
  1339. u8 pad;
  1340. struct efi_ip_address station_ip;
  1341. struct efi_ip_address subnet_mask;
  1342. struct efi_pxe_packet dhcp_discover;
  1343. struct efi_pxe_packet dhcp_ack;
  1344. struct efi_pxe_packet proxy_offer;
  1345. struct efi_pxe_packet pxe_discover;
  1346. struct efi_pxe_packet pxe_reply;
  1347. };
  1348. struct efi_pxe_base_code_srvlist {
  1349. u16 type;
  1350. u8 accept_any_response;
  1351. u8 reserved;
  1352. struct efi_ip_address ip_addr;
  1353. };
  1354. struct efi_pxe_base_code_discover_info {
  1355. u8 use_m_cast;
  1356. u8 use_b_cast;
  1357. u8 use_u_cast;
  1358. u8 must_use_list;
  1359. struct efi_ip_address server_m_cast_ip;
  1360. u16 ip_cnt;
  1361. struct efi_pxe_base_code_srvlist srv_list[];
  1362. };
  1363. struct efi_pxe_base_code_mtftp_info {
  1364. struct efi_ip_address m_cast_ip;
  1365. u16 cport;
  1366. u16 sport;
  1367. u16 listen_timeout;
  1368. u16 transit_timeout;
  1369. };
  1370. struct efi_pxe_base_code_filter {
  1371. u8 filters;
  1372. u8 ip_cnt;
  1373. u16 reserved;
  1374. struct efi_ip_address ip_list[EFI_PXE_BASE_CODE_MAX_IPCNT];
  1375. };
  1376. struct efi_pxe_base_code_dhcpv4_packet {
  1377. u8 bootp_op_code;
  1378. u8 bootp_hw_type;
  1379. u8 bootp_addr_len;
  1380. u8 bootp_gate_hops;
  1381. u32 bootp_ident;
  1382. u16 bootp_seconds;
  1383. u16 bootp_flags;
  1384. u8 bootp_ci_addr[4];
  1385. u8 bootp_yi_addr[4];
  1386. u8 bootp_si_addr[4];
  1387. u8 bootp_gi_addr[4];
  1388. u8 bootp_hw_addr[16];
  1389. u8 bootp_srv_name[64];
  1390. u8 bootp_boot_file[128];
  1391. u32 dhcp_magick;
  1392. u8 dhcp_options[56];
  1393. };
  1394. struct efi_pxe_base_code_dhcpv6_packet {
  1395. u8 message_type;
  1396. u8 transaction_id[3];
  1397. u8 dhcp_options[1024];
  1398. };
  1399. typedef union {
  1400. u8 raw[1472];
  1401. struct efi_pxe_base_code_dhcpv4_packet dhcpv4;
  1402. struct efi_pxe_base_code_dhcpv6_packet dhcpv6;
  1403. } EFI_PXE_BASE_CODE_PACKET;
  1404. struct efi_pxe_base_code_protocol {
  1405. u64 revision;
  1406. efi_status_t (EFIAPI *start)(struct efi_pxe_base_code_protocol *this,
  1407. u8 use_ipv6);
  1408. efi_status_t (EFIAPI *stop)(struct efi_pxe_base_code_protocol *this);
  1409. efi_status_t (EFIAPI *dhcp)(struct efi_pxe_base_code_protocol *this,
  1410. u8 sort_offers);
  1411. efi_status_t (EFIAPI *discover)(
  1412. struct efi_pxe_base_code_protocol *this,
  1413. u16 type, u16 *layer, u8 bis,
  1414. struct efi_pxe_base_code_discover_info *info);
  1415. efi_status_t (EFIAPI *mtftp)(
  1416. struct efi_pxe_base_code_protocol *this,
  1417. u32 operation, void *buffer_ptr,
  1418. u8 overwrite, efi_uintn_t *buffer_size,
  1419. struct efi_ip_address server_ip, char *filename,
  1420. struct efi_pxe_base_code_mtftp_info *info,
  1421. u8 dont_use_buffer);
  1422. efi_status_t (EFIAPI *udp_write)(
  1423. struct efi_pxe_base_code_protocol *this,
  1424. u16 op_flags, struct efi_ip_address *dest_ip,
  1425. u16 *dest_port,
  1426. struct efi_ip_address *gateway_ip,
  1427. struct efi_ip_address *src_ip, u16 *src_port,
  1428. efi_uintn_t *header_size, void *header_ptr,
  1429. efi_uintn_t *buffer_size, void *buffer_ptr);
  1430. efi_status_t (EFIAPI *udp_read)(
  1431. struct efi_pxe_base_code_protocol *this,
  1432. u16 op_flags, struct efi_ip_address *dest_ip,
  1433. u16 *dest_port, struct efi_ip_address *src_ip,
  1434. u16 *src_port, efi_uintn_t *header_size,
  1435. void *header_ptr, efi_uintn_t *buffer_size,
  1436. void *buffer_ptr);
  1437. efi_status_t (EFIAPI *set_ip_filter)(
  1438. struct efi_pxe_base_code_protocol *this,
  1439. struct efi_pxe_base_code_filter *new_filter);
  1440. efi_status_t (EFIAPI *arp)(struct efi_pxe_base_code_protocol *this,
  1441. struct efi_ip_address *ip_addr,
  1442. struct efi_mac_address *mac_addr);
  1443. efi_status_t (EFIAPI *set_parameters)(
  1444. struct efi_pxe_base_code_protocol *this,
  1445. u8 *new_auto_arp, u8 *new_send_guid,
  1446. u8 *new_ttl, u8 *new_tos,
  1447. u8 *new_make_callback);
  1448. efi_status_t (EFIAPI *set_station_ip)(
  1449. struct efi_pxe_base_code_protocol *this,
  1450. struct efi_ip_address *new_station_ip,
  1451. struct efi_ip_address *new_subnet_mask);
  1452. efi_status_t (EFIAPI *set_packets)(
  1453. struct efi_pxe_base_code_protocol *this,
  1454. u8 *new_dhcp_discover_valid,
  1455. u8 *new_dhcp_ack_received,
  1456. u8 *new_proxy_offer_received,
  1457. u8 *new_pxe_discover_valid,
  1458. u8 *new_pxe_reply_received,
  1459. u8 *new_pxe_bis_reply_received,
  1460. EFI_PXE_BASE_CODE_PACKET *new_dchp_discover,
  1461. EFI_PXE_BASE_CODE_PACKET *new_dhcp_acc,
  1462. EFI_PXE_BASE_CODE_PACKET *new_proxy_offer,
  1463. EFI_PXE_BASE_CODE_PACKET *new_pxe_discover,
  1464. EFI_PXE_BASE_CODE_PACKET *new_pxe_reply,
  1465. EFI_PXE_BASE_CODE_PACKET *new_pxe_bis_reply);
  1466. struct efi_pxe_mode *mode;
  1467. };
  1468. #define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \
  1469. EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \
  1470. 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  1471. #define EFI_FILE_PROTOCOL_REVISION 0x00010000
  1472. #define EFI_FILE_PROTOCOL_REVISION2 0x00020000
  1473. #define EFI_FILE_PROTOCOL_LATEST_REVISION EFI_FILE_PROTOCOL_REVISION2
  1474. struct efi_file_io_token {
  1475. struct efi_event *event;
  1476. efi_status_t status;
  1477. efi_uintn_t buffer_size;
  1478. void *buffer;};
  1479. struct efi_file_handle {
  1480. u64 rev;
  1481. efi_status_t (EFIAPI *open)(struct efi_file_handle *this,
  1482. struct efi_file_handle **new_handle,
  1483. u16 *file_name, u64 open_mode, u64 attributes);
  1484. efi_status_t (EFIAPI *close)(struct efi_file_handle *this);
  1485. efi_status_t (EFIAPI *delete)(struct efi_file_handle *this);
  1486. efi_status_t (EFIAPI *read)(struct efi_file_handle *this,
  1487. efi_uintn_t *buffer_size, void *buffer);
  1488. efi_status_t (EFIAPI *write)(struct efi_file_handle *this,
  1489. efi_uintn_t *buffer_size, void *buffer);
  1490. efi_status_t (EFIAPI *getpos)(struct efi_file_handle *this,
  1491. u64 *pos);
  1492. efi_status_t (EFIAPI *setpos)(struct efi_file_handle *this,
  1493. u64 pos);
  1494. efi_status_t (EFIAPI *getinfo)(struct efi_file_handle *this,
  1495. const efi_guid_t *info_type, efi_uintn_t *buffer_size,
  1496. void *buffer);
  1497. efi_status_t (EFIAPI *setinfo)(struct efi_file_handle *this,
  1498. const efi_guid_t *info_type, efi_uintn_t buffer_size,
  1499. void *buffer);
  1500. efi_status_t (EFIAPI *flush)(struct efi_file_handle *this);
  1501. efi_status_t (EFIAPI *open_ex)(struct efi_file_handle *this,
  1502. struct efi_file_handle **new_handle,
  1503. u16 *file_name, u64 open_mode, u64 attributes,
  1504. struct efi_file_io_token *token);
  1505. efi_status_t (EFIAPI *read_ex)(struct efi_file_handle *this,
  1506. struct efi_file_io_token *token);
  1507. efi_status_t (EFIAPI *write_ex)(struct efi_file_handle *this,
  1508. struct efi_file_io_token *token);
  1509. efi_status_t (EFIAPI *flush_ex)(struct efi_file_handle *this,
  1510. struct efi_file_io_token *token);
  1511. };
  1512. #define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION 0x00010000
  1513. struct efi_simple_file_system_protocol {
  1514. u64 rev;
  1515. efi_status_t (EFIAPI *open_volume)(struct efi_simple_file_system_protocol *this,
  1516. struct efi_file_handle **root);
  1517. };
  1518. #define EFI_FILE_INFO_GUID \
  1519. EFI_GUID(0x9576e92, 0x6d3f, 0x11d2, \
  1520. 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  1521. #define EFI_FILE_SYSTEM_INFO_GUID \
  1522. EFI_GUID(0x09576e93, 0x6d3f, 0x11d2, \
  1523. 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  1524. #define EFI_FILE_SYSTEM_VOLUME_LABEL_ID \
  1525. EFI_GUID(0xdb47d7d3, 0xfe81, 0x11d3, \
  1526. 0x9a, 0x35, 0x00, 0x90, 0x27, 0x3f, 0xC1, 0x4d)
  1527. #define EFI_FILE_MODE_READ 0x0000000000000001
  1528. #define EFI_FILE_MODE_WRITE 0x0000000000000002
  1529. #define EFI_FILE_MODE_CREATE 0x8000000000000000
  1530. #define EFI_FILE_READ_ONLY 0x0000000000000001
  1531. #define EFI_FILE_HIDDEN 0x0000000000000002
  1532. #define EFI_FILE_SYSTEM 0x0000000000000004
  1533. #define EFI_FILE_RESERVED 0x0000000000000008
  1534. #define EFI_FILE_DIRECTORY 0x0000000000000010
  1535. #define EFI_FILE_ARCHIVE 0x0000000000000020
  1536. #define EFI_FILE_VALID_ATTR 0x0000000000000037
  1537. struct efi_file_info {
  1538. u64 size;
  1539. u64 file_size;
  1540. u64 physical_size;
  1541. struct efi_time create_time;
  1542. struct efi_time last_access_time;
  1543. struct efi_time modification_time;
  1544. u64 attribute;
  1545. u16 file_name[0];
  1546. };
  1547. struct efi_file_system_info {
  1548. u64 size;
  1549. u8 read_only;
  1550. u64 volume_size;
  1551. u64 free_space;
  1552. u32 block_size;
  1553. u16 volume_label[0];
  1554. };
  1555. #define EFI_DRIVER_BINDING_PROTOCOL_GUID \
  1556. EFI_GUID(0x18a031ab, 0xb443, 0x4d1a,\
  1557. 0xa5, 0xc0, 0x0c, 0x09, 0x26, 0x1e, 0x9f, 0x71)
  1558. struct efi_driver_binding_protocol {
  1559. efi_status_t (EFIAPI * supported)(
  1560. struct efi_driver_binding_protocol *this,
  1561. efi_handle_t controller_handle,
  1562. struct efi_device_path *remaining_device_path);
  1563. efi_status_t (EFIAPI * start)(
  1564. struct efi_driver_binding_protocol *this,
  1565. efi_handle_t controller_handle,
  1566. struct efi_device_path *remaining_device_path);
  1567. efi_status_t (EFIAPI * stop)(
  1568. struct efi_driver_binding_protocol *this,
  1569. efi_handle_t controller_handle,
  1570. efi_uintn_t number_of_children,
  1571. efi_handle_t *child_handle_buffer);
  1572. u32 version;
  1573. efi_handle_t image_handle;
  1574. efi_handle_t driver_binding_handle;
  1575. };
  1576. /* Current version of the Unicode collation protocol */
  1577. #define EFI_UNICODE_COLLATION_PROTOCOL2_GUID \
  1578. EFI_GUID(0xa4c751fc, 0x23ae, 0x4c3e, \
  1579. 0x92, 0xe9, 0x49, 0x64, 0xcf, 0x63, 0xf3, 0x49)
  1580. struct efi_unicode_collation_protocol {
  1581. efi_intn_t (EFIAPI *stri_coll)(
  1582. struct efi_unicode_collation_protocol *this, u16 *s1, u16 *s2);
  1583. bool (EFIAPI *metai_match)(struct efi_unicode_collation_protocol *this,
  1584. const u16 *string, const u16 *patter);
  1585. void (EFIAPI *str_lwr)(struct efi_unicode_collation_protocol
  1586. *this, u16 *string);
  1587. void (EFIAPI *str_upr)(struct efi_unicode_collation_protocol *this,
  1588. u16 *string);
  1589. void (EFIAPI *fat_to_str)(struct efi_unicode_collation_protocol *this,
  1590. efi_uintn_t fat_size, char *fat, u16 *string);
  1591. bool (EFIAPI *str_to_fat)(struct efi_unicode_collation_protocol *this,
  1592. const u16 *string, efi_uintn_t fat_size,
  1593. char *fat);
  1594. char *supported_languages;
  1595. };
  1596. struct efi_load_file_protocol {
  1597. efi_status_t (EFIAPI *load_file)(struct efi_load_file_protocol *this,
  1598. struct efi_device_path *file_path,
  1599. bool boot_policy,
  1600. efi_uintn_t *buffer_size,
  1601. void *buffer);
  1602. };
  1603. struct efi_system_resource_entry {
  1604. efi_guid_t fw_class;
  1605. u32 fw_type;
  1606. u32 fw_version;
  1607. u32 lowest_supported_fw_version;
  1608. u32 capsule_flags;
  1609. u32 last_attempt_version;
  1610. u32 last_attempt_status;
  1611. } __packed;
  1612. struct efi_system_resource_table {
  1613. u32 fw_resource_count;
  1614. u32 fw_resource_count_max;
  1615. u64 fw_resource_version;
  1616. struct efi_system_resource_entry entries[];
  1617. } __packed;
  1618. /* Boot manager load options */
  1619. #define LOAD_OPTION_ACTIVE 0x00000001
  1620. #define LOAD_OPTION_FORCE_RECONNECT 0x00000002
  1621. #define LOAD_OPTION_HIDDEN 0x00000008
  1622. /* All values 0x00000200-0x00001F00 are reserved */
  1623. #define LOAD_OPTION_CATEGORY 0x00001F00
  1624. #define LOAD_OPTION_CATEGORY_BOOT 0x00000000
  1625. #define LOAD_OPTION_CATEGORY_APP 0x00000100
  1626. /*
  1627. * System Resource Table
  1628. */
  1629. /* Firmware Type Definitions */
  1630. #define ESRT_FW_TYPE_UNKNOWN 0x00000000
  1631. #define ESRT_FW_TYPE_SYSTEMFIRMWARE 0x00000001
  1632. #define ESRT_FW_TYPE_DEVICEFIRMWARE 0x00000002
  1633. #define ESRT_FW_TYPE_UEFIDRIVER 0x00000003
  1634. #define EFI_SYSTEM_RESOURCE_TABLE_GUID\
  1635. EFI_GUID(0xb122a263, 0x3661, 0x4f68,\
  1636. 0x99, 0x29, 0x78, 0xf8, 0xb0, 0xd6, 0x21, 0x80)
  1637. /* Last Attempt Status Values */
  1638. #define LAST_ATTEMPT_STATUS_SUCCESS 0x00000000
  1639. #define LAST_ATTEMPT_STATUS_ERROR_UNSUCCESSFUL 0x00000001
  1640. #define LAST_ATTEMPT_STATUS_ERROR_INSUFFICIENT_RESOURCES 0x00000002
  1641. #define LAST_ATTEMPT_STATUS_ERROR_INCORRECT_VERSION 0x00000003
  1642. #define LAST_ATTEMPT_STATUS_ERROR_INVALID_FORMAT 0x00000004
  1643. #define LAST_ATTEMPT_STATUS_ERROR_AUTH_ERROR 0x00000005
  1644. #define LAST_ATTEMPT_STATUS_ERROR_PWR_EVT_AC 0x00000006
  1645. #define LAST_ATTEMPT_STATUS_ERROR_PWR_EVT_BATT 0x00000007
  1646. #define LAST_ATTEMPT_STATUS_ERROR_UNSATISFIED_DEPENDENCIES 0x00000008
  1647. /*
  1648. * The LastAttemptStatus values of 0x1000 - 0x4000 are reserved for vendor
  1649. * usage.
  1650. */
  1651. #define LAST_ATTEMPT_STATUS_ERROR_UNSUCCESSFUL_VENDOR_RANGE_MIN 0x00001000
  1652. #define LAST_ATTEMPT_STATUS_ERROR_UNSUCCESSFUL_VENDOR_RANGE_MAX 0x00004000
  1653. /* Certificate types in signature database */
  1654. #define EFI_CERT_SHA256_GUID \
  1655. EFI_GUID(0xc1c41626, 0x504c, 0x4092, 0xac, 0xa9, \
  1656. 0x41, 0xf9, 0x36, 0x93, 0x43, 0x28)
  1657. #define EFI_CERT_RSA2048_GUID \
  1658. EFI_GUID(0x3c5766e8, 0x269c, 0x4e34, 0xaa, 0x14, \
  1659. 0xed, 0x77, 0x6e, 0x85, 0xb3, 0xb6)
  1660. #define EFI_CERT_X509_GUID \
  1661. EFI_GUID(0xa5c059a1, 0x94e4, 0x4aa7, 0x87, 0xb5, \
  1662. 0xab, 0x15, 0x5c, 0x2b, 0xf0, 0x72)
  1663. #define EFI_CERT_X509_SHA256_GUID \
  1664. EFI_GUID(0x3bd2a492, 0x96c0, 0x4079, 0xb4, 0x20, \
  1665. 0xfc, 0xf9, 0x8e, 0xf1, 0x03, 0xed)
  1666. #define EFI_CERT_TYPE_PKCS7_GUID \
  1667. EFI_GUID(0x4aafd29d, 0x68df, 0x49ee, 0x8a, 0xa9, \
  1668. 0x34, 0x7d, 0x37, 0x56, 0x65, 0xa7)
  1669. /**
  1670. * struct win_certificate_uefi_guid - A certificate that encapsulates
  1671. * a GUID-specific signature
  1672. *
  1673. * @hdr: Windows certificate header
  1674. * @cert_type: Certificate type
  1675. * @cert_data: Certificate data
  1676. */
  1677. struct win_certificate_uefi_guid {
  1678. WIN_CERTIFICATE hdr;
  1679. efi_guid_t cert_type;
  1680. u8 cert_data[];
  1681. } __attribute__((__packed__));
  1682. /**
  1683. * struct efi_variable_authentication_2 - A time-based authentication method
  1684. * descriptor
  1685. *
  1686. * This structure describes an authentication information for
  1687. * a variable with EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
  1688. * and should be included as part of a variable's value.
  1689. * Only EFI_CERT_TYPE_PKCS7_GUID is accepted.
  1690. *
  1691. * @time_stamp: Descriptor's time stamp
  1692. * @auth_info: Authentication info
  1693. */
  1694. struct efi_variable_authentication_2 {
  1695. struct efi_time time_stamp;
  1696. struct win_certificate_uefi_guid auth_info;
  1697. } __attribute__((__packed__));
  1698. /**
  1699. * struct efi_firmware_image_authentication - Capsule authentication method
  1700. * descriptor
  1701. *
  1702. * This structure describes an authentication information for
  1703. * a capsule with IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED set
  1704. * and should be included as part of the capsule.
  1705. * Only EFI_CERT_TYPE_PKCS7_GUID is accepted.
  1706. *
  1707. * @monotonic_count: Count to prevent replay
  1708. * @auth_info: Authentication info
  1709. */
  1710. struct efi_firmware_image_authentication {
  1711. uint64_t monotonic_count;
  1712. struct win_certificate_uefi_guid auth_info;
  1713. } __attribute__((__packed__));
  1714. /**
  1715. * struct efi_signature_data - A format of signature
  1716. *
  1717. * This structure describes a single signature in signature database.
  1718. *
  1719. * @signature_owner: Signature owner
  1720. * @signature_data: Signature data
  1721. */
  1722. struct efi_signature_data {
  1723. efi_guid_t signature_owner;
  1724. u8 signature_data[];
  1725. } __attribute__((__packed__));
  1726. /**
  1727. * struct efi_signature_list - A format of signature database
  1728. *
  1729. * This structure describes a list of signatures with the same type.
  1730. * An authenticated variable's value is a concatenation of one or more
  1731. * efi_signature_list's.
  1732. *
  1733. * @signature_type: Signature type
  1734. * @signature_list_size: Size of signature list
  1735. * @signature_header_size: Size of signature header
  1736. * @signature_size: Size of signature
  1737. */
  1738. struct efi_signature_list {
  1739. efi_guid_t signature_type;
  1740. u32 signature_list_size;
  1741. u32 signature_header_size;
  1742. u32 signature_size;
  1743. /* u8 signature_header[signature_header_size]; */
  1744. /* struct efi_signature_data signatures[...][signature_size]; */
  1745. } __attribute__((__packed__));
  1746. /*
  1747. * Firmware management protocol
  1748. */
  1749. #define EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GUID \
  1750. EFI_GUID(0x86c77a67, 0x0b97, 0x4633, 0xa1, 0x87, \
  1751. 0x49, 0x10, 0x4d, 0x06, 0x85, 0xc7)
  1752. #define EFI_FIRMWARE_IMAGE_TYPE_UBOOT_FIT_GUID \
  1753. EFI_GUID(0xae13ff2d, 0x9ad4, 0x4e25, 0x9a, 0xc8, \
  1754. 0x6d, 0x80, 0xb3, 0xb2, 0x21, 0x47)
  1755. #define EFI_FIRMWARE_IMAGE_TYPE_UBOOT_RAW_GUID \
  1756. EFI_GUID(0xe2bb9c06, 0x70e9, 0x4b14, 0x97, 0xa3, \
  1757. 0x5a, 0x79, 0x13, 0x17, 0x6e, 0x3f)
  1758. #define IMAGE_ATTRIBUTE_IMAGE_UPDATABLE 0x0000000000000001
  1759. #define IMAGE_ATTRIBUTE_RESET_REQUIRED 0x0000000000000002
  1760. #define IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED 0x0000000000000004
  1761. #define IMAGE_ATTRIBUTE_IN_USE 0x0000000000000008
  1762. #define IMAGE_ATTRIBUTE_UEFI_IMAGE 0x0000000000000010
  1763. #define IMAGE_ATTRIBUTE_DEPENDENCY 0x0000000000000020
  1764. #define IMAGE_COMPATIBILITY_CHECK_SUPPORTED 0x0000000000000001
  1765. #define IMAGE_UPDATABLE_VALID 0x0000000000000001
  1766. #define IMAGE_UPDATABLE_INVALID 0x0000000000000002
  1767. #define IMAGE_UPDATABLE_INVALID_TYPE 0x0000000000000004
  1768. #define IMAGE_UPDATABLE_INVALID_OLLD 0x0000000000000008
  1769. #define IMAGE_UPDATABLE_VALID_WITH_VENDOR_CODE 0x0000000000000010
  1770. #define PACKAGE_ATTRIBUTE_VERSION_UPDATABLE 0x0000000000000001
  1771. #define PACKAGE_ATTRIBUTE_RESET_REQUIRED 0x0000000000000002
  1772. #define PACKAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED 0x0000000000000004
  1773. #define EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION 4
  1774. typedef struct efi_firmware_image_dependencies {
  1775. u8 dependencies[0];
  1776. } efi_firmware_image_dep_t;
  1777. struct efi_firmware_image_descriptor {
  1778. u8 image_index;
  1779. efi_guid_t image_type_id;
  1780. u64 image_id;
  1781. u16 *image_id_name;
  1782. u32 version;
  1783. u16 *version_name;
  1784. efi_uintn_t size;
  1785. u64 attributes_supported;
  1786. u64 attributes_setting;
  1787. u64 compatibilities;
  1788. u32 lowest_supported_image_version;
  1789. u32 last_attempt_version;
  1790. u32 last_attempt_status;
  1791. u64 hardware_instance;
  1792. efi_firmware_image_dep_t *dependencies;
  1793. };
  1794. struct efi_firmware_management_protocol {
  1795. efi_status_t (EFIAPI *get_image_info)(
  1796. struct efi_firmware_management_protocol *this,
  1797. efi_uintn_t *image_info_size,
  1798. struct efi_firmware_image_descriptor *image_info,
  1799. u32 *descriptor_version,
  1800. u8 *descriptor_count,
  1801. efi_uintn_t *descriptor_size,
  1802. u32 *package_version,
  1803. u16 **package_version_name);
  1804. efi_status_t (EFIAPI *get_image)(
  1805. struct efi_firmware_management_protocol *this,
  1806. u8 image_index,
  1807. void *image,
  1808. efi_uintn_t *image_size);
  1809. efi_status_t (EFIAPI *set_image)(
  1810. struct efi_firmware_management_protocol *this,
  1811. u8 image_index,
  1812. const void *image,
  1813. efi_uintn_t image_size,
  1814. const void *vendor_code,
  1815. efi_status_t (*progress)(efi_uintn_t completion),
  1816. u16 **abort_reason);
  1817. efi_status_t (EFIAPI *check_image)(
  1818. struct efi_firmware_management_protocol *this,
  1819. u8 image_index,
  1820. const void *image,
  1821. efi_uintn_t *image_size,
  1822. u32 *image_updatable);
  1823. efi_status_t (EFIAPI *get_package_info)(
  1824. struct efi_firmware_management_protocol *this,
  1825. u32 *package_version,
  1826. u16 **package_version_name,
  1827. u32 *package_version_name_maxlen,
  1828. u64 *attributes_supported,
  1829. u64 *attributes_setting);
  1830. efi_status_t (EFIAPI *set_package_info)(
  1831. struct efi_firmware_management_protocol *this,
  1832. const void *image,
  1833. efi_uintn_t *image_size,
  1834. const void *vendor_code,
  1835. u32 package_version,
  1836. const u16 *package_version_name);
  1837. };
  1838. #define EFI_DISK_IO_PROTOCOL_GUID \
  1839. EFI_GUID(0xce345171, 0xba0b, 0x11d2, 0x8e, 0x4f, \
  1840. 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
  1841. struct efi_disk {
  1842. u64 revision;
  1843. efi_status_t (EFIAPI *read_disk)(struct efi_disk *this, u32 media_id,
  1844. u64 offset, efi_uintn_t buffer_size,
  1845. void *buffer);
  1846. efi_status_t (EFIAPI *write_disk)(struct efi_disk *this, u32 media_id,
  1847. u64 offset, efi_uintn_t buffer_size,
  1848. void *buffer);
  1849. };
  1850. #endif