efilib.h 22 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072
  1. #ifndef _EFILIB_INCLUDE_
  2. #define _EFILIB_INCLUDE_
  3. /*++
  4. Copyright (c) 2000 Intel Corporation
  5. Module Name:
  6. efilib.h
  7. Abstract:
  8. EFI library functions
  9. Revision History
  10. --*/
  11. #include "efidebug.h"
  12. #include "efipart.h"
  13. #if defined(_M_X64) || defined(__x86_64__) || defined(__amd64__)
  14. #include "x86_64/efilibplat.h"
  15. #elif defined(_M_IX86) || defined(__i386__)
  16. #include "ia32/efilibplat.h"
  17. #elif defined(_M_IA64) || defined(__ia64__)
  18. #include "ia64/efilibplat.h"
  19. #elif defined (_M_ARM64) || defined(__aarch64__)
  20. #include "aarch64/efilibplat.h"
  21. #elif defined (_M_ARM) || defined(__arm__)
  22. #include "arm/efilibplat.h"
  23. #elif defined (_M_MIPS64) || defined(__mips64__)
  24. #include "mips64el/efilibplat.h"
  25. #elif defined (__riscv) && __riscv_xlen == 64
  26. #include "riscv64/efilibplat.h"
  27. #endif
  28. #include "efilink.h"
  29. #include "efirtlib.h"
  30. #include "efistdarg.h"
  31. #include "pci22.h"
  32. #include "libsmbios.h"
  33. //
  34. // Public read-only data in the EFI library
  35. //
  36. extern EFI_SYSTEM_TABLE *ST;
  37. #define gST ST
  38. extern EFI_BOOT_SERVICES *BS;
  39. #define gBS BS
  40. extern EFI_RUNTIME_SERVICES *RT;
  41. #define gRT RT
  42. extern EFI_GUID gEfiDevicePathProtocolGuid;
  43. #define DevicePathProtocol gEfiDevicePathProtocolGuid
  44. extern EFI_GUID gEfiDevicePathToTextProtocolGuid;
  45. #define DevicePathToTextProtocol gEfiDevicePathToTextProtocolGuid
  46. extern EFI_GUID gEfiDevicePathFromTextProtocolGuid;
  47. #define DevicePathFromTextProtocol gEfiDevicePathFromTextProtocolGuid
  48. extern EFI_GUID gEfiLoadedImageProtocolGuid;
  49. #define LoadedImageProtocol gEfiLoadedImageProtocolGuid
  50. extern EFI_GUID gEfiSimpleTextInProtocolGuid;
  51. #define TextInProtocol gEfiSimpleTextInProtocolGuid
  52. extern EFI_GUID gEfiSimpleTextOutProtocolGuid;
  53. #define TextOutProtocol gEfiSimpleTextOutProtocolGuid
  54. extern EFI_GUID gEfiGraphicsOutputProtocolGuid;
  55. #define GraphicsOutputProtocol gEfiGraphicsOutputProtocolGuid
  56. extern EFI_GUID gEfiEdidDiscoveredProtocolGuid;
  57. #define EdidDiscoveredProtocol gEfiEdidDiscoveredProtocolGuid
  58. extern EFI_GUID gEfiEdidActiveProtocolGuid;
  59. #define EdidActiveProtocol gEfiEdidActiveProtocolGuid
  60. extern EFI_GUID gEfiEdidOverrideProtocolGuid;
  61. #define EdidOverrideProtocol gEfiEdidOverrideProtocolGuid
  62. extern EFI_GUID gEfiBlockIoProtocolGuid;
  63. #define BlockIoProtocol gEfiBlockIoProtocolGuid
  64. extern EFI_GUID gEfiBlockIo2ProtocolGuid;
  65. #define BlockIo2Protocol gEfiBlockIo2ProtocolGuid
  66. extern EFI_GUID gEfiDiskIoProtocolGuid;
  67. #define DiskIoProtocol gEfiDiskIoProtocolGuid
  68. extern EFI_GUID gEfiDiskIo2ProtocolGuid;
  69. #define DiskIo2Protocol gEfiDiskIo2ProtocolGuid
  70. extern EFI_GUID gEfiSimpleFileSystemProtocolGuid;
  71. #define FileSystemProtocol gEfiSimpleFileSystemProtocolGuid
  72. extern EFI_GUID gEfiLoadFileProtocolGuid;
  73. #define LoadFileProtocol gEfiLoadFileProtocolGuid
  74. extern EFI_GUID gEfiDeviceIoProtocolGuid;
  75. #define DeviceIoProtocol gEfiDeviceIoProtocolGuid
  76. extern EFI_GUID VariableStoreProtocol;
  77. extern EFI_GUID LegacyBootProtocol;
  78. extern EFI_GUID gEfiUnicodeCollationProtocolGuid;
  79. #define UnicodeCollationProtocol gEfiUnicodeCollationProtocolGuid
  80. extern EFI_GUID gEfiSerialIoProtocolGuid;
  81. #define SerialIoProtocol gEfiSerialIoProtocolGuid
  82. extern EFI_GUID VgaClassProtocol;
  83. extern EFI_GUID TextOutSpliterProtocol;
  84. extern EFI_GUID ErrorOutSpliterProtocol;
  85. extern EFI_GUID TextInSpliterProtocol;
  86. extern EFI_GUID gEfiSimpleNetworkProtocolGuid;
  87. #define SimpleNetworkProtocol gEfiSimpleNetworkProtocolGuid
  88. extern EFI_GUID gEfiPxeBaseCodeProtocolGuid;
  89. #define PxeBaseCodeProtocol gEfiPxeBaseCodeProtocolGuid
  90. extern EFI_GUID gEfiPxeBaseCodeCallbackProtocolGuid;
  91. #define PxeCallbackProtocol gEfiPxeBaseCodeCallbackProtocolGuid
  92. extern EFI_GUID gEfiNetworkInterfaceIdentifierProtocolGuid;
  93. #define NetworkInterfaceIdentifierProtocol gEfiNetworkInterfaceIdentifierProtocolGuid
  94. extern EFI_GUID gEFiUiInterfaceProtocolGuid;
  95. #define UiProtocol gEFiUiInterfaceProtocolGuid
  96. extern EFI_GUID InternalShellProtocol;
  97. extern EFI_GUID gEfiPciIoProtocolGuid;
  98. #define PciIoProtocol gEfiPciIoProtocolGuid
  99. extern EFI_GUID gEfiPciRootBridgeIoProtocolGuid;
  100. extern EFI_GUID gEfiDriverBindingProtocolGuid;
  101. #define DriverBindingProtocol gEfiDriverBindingProtocolGuid
  102. extern EFI_GUID gEfiComponentNameProtocolGuid;
  103. #define ComponentNameProtocol gEfiComponentNameProtocolGuid
  104. extern EFI_GUID gEfiComponentName2ProtocolGuid;
  105. #define ComponentName2Protocol gEfiComponentName2ProtocolGuid
  106. extern EFI_GUID gEfiHashProtocolGuid;
  107. #define HashProtocol gEfiHashProtocolGuid
  108. extern EFI_GUID gEfiPlatformDriverOverrideProtocolGuid;
  109. #define PlatformDriverOverrideProtocol gEfiPlatformDriverOverrideProtocolGuid
  110. extern EFI_GUID gEfiBusSpecificDriverOverrideProtocolGuid;
  111. #define BusSpecificDriverOverrideProtocol gEfiBusSpecificDriverOverrideProtocolGuid
  112. extern EFI_GUID gEfiDriverFamilyOverrideProtocolGuid;
  113. #define DriverFamilyOverrideProtocol gEfiDriverFamilyOverrideProtocolGuid
  114. extern EFI_GUID gEfiEbcProtocolGuid;
  115. extern EFI_GUID gEfiGlobalVariableGuid;
  116. #define EfiGlobalVariable gEfiGlobalVariableGuid
  117. extern EFI_GUID gEfiFileInfoGuid;
  118. #define GenericFileInfo gEfiFileInfoGuid
  119. extern EFI_GUID gEfiFileSystemInfoGuid;
  120. #define FileSystemInfo gEfiFileSystemInfoGuid
  121. extern EFI_GUID gEfiFileSystemVolumeLabelInfoIdGuid;
  122. #define FileSystemVolumeLabelInfo gEfiFileSystemVolumeLabelInfoIdGuid
  123. extern EFI_GUID gEfiPcAnsiGuid;
  124. #define PcAnsiProtocol gEfiPcAnsiGuid
  125. extern EFI_GUID gEfiVT100Guid;
  126. #define Vt100Protocol gEfiVT100Guid
  127. extern EFI_GUID gEfiVT100PlusGuid;
  128. extern EFI_GUID gEfiVTUTF8Guid;
  129. extern EFI_GUID NullGuid;
  130. extern EFI_GUID UnknownDevice;
  131. extern EFI_GUID EfiPartTypeSystemPartitionGuid;
  132. extern EFI_GUID EfiPartTypeLegacyMbrGuid;
  133. extern EFI_GUID MpsTableGuid;
  134. extern EFI_GUID AcpiTableGuid;
  135. extern EFI_GUID SMBIOSTableGuid;
  136. extern EFI_GUID SMBIOS3TableGuid;
  137. extern EFI_GUID SalSystemTableGuid;
  138. extern EFI_GUID SimplePointerProtocol;
  139. extern EFI_GUID AbsolutePointerProtocol;
  140. extern EFI_GUID gEfiDebugImageInfoTableGuid;
  141. extern EFI_GUID gEfiDebugSupportProtocolGuid;
  142. extern EFI_GUID SimpleTextInputExProtocol;
  143. //
  144. // EFI Variable strings
  145. //
  146. #define LOAD_OPTION_ACTIVE 0x00000001
  147. #define VarLanguageCodes L"LangCodes"
  148. #define VarLanguage L"Lang"
  149. #define VarTimeout L"Timeout"
  150. #define VarConsoleInp L"ConIn"
  151. #define VarConsoleOut L"ConOut"
  152. #define VarErrorOut L"ErrOut"
  153. #define VarBootOption L"Boot%04x"
  154. #define VarBootOrder L"BootOrder"
  155. #define VarBootNext L"BootNext"
  156. #define VarBootCurrent L"BootCurrent"
  157. #define VarDriverOption L"Driver%04x"
  158. #define VarDriverOrder L"DriverOrder"
  159. #define VarConsoleInpDev L"ConInDev"
  160. #define VarConsoleOutDev L"ConOutDev"
  161. #define VarErrorOutDev L"ErrOutDev"
  162. #define LanguageCodeEnglish "eng"
  163. extern EFI_DEVICE_PATH RootDevicePath[];
  164. extern EFI_DEVICE_PATH EndDevicePath[];
  165. extern EFI_DEVICE_PATH EndInstanceDevicePath[];
  166. //
  167. // Other public data in the EFI library
  168. //
  169. extern EFI_MEMORY_TYPE PoolAllocationType;
  170. //
  171. // STATIC - Name is internal to the module
  172. // INTERNAL - Name is internal to the component (i.e., directory)
  173. // BOOTSERVCE - Name of a boot service function
  174. //
  175. #define STATIC
  176. #define INTERNAL
  177. #define BOOTSERVICE
  178. //
  179. // Prototypes
  180. //
  181. VOID
  182. InitializeLib (
  183. IN EFI_HANDLE ImageHandle,
  184. IN EFI_SYSTEM_TABLE *SystemTable
  185. );
  186. VOID
  187. InitializeUnicodeSupport (
  188. CHAR8 *LangCode
  189. );
  190. VOID
  191. EFIDebugVariable (
  192. VOID
  193. );
  194. VOID
  195. Exit(
  196. IN EFI_STATUS ExitStatus,
  197. IN UINTN ExitDataSize,
  198. IN CHAR16 *ExitData OPTIONAL
  199. );
  200. INTN
  201. GetShellArgcArgv(
  202. EFI_HANDLE ImageHandle,
  203. CHAR16 **Argv[] /* Statically allocated */
  204. );
  205. VOID
  206. SetCrc (
  207. IN OUT EFI_TABLE_HEADER *Hdr
  208. );
  209. VOID
  210. SetCrcAltSize (
  211. IN UINTN Size,
  212. IN OUT EFI_TABLE_HEADER *Hdr
  213. );
  214. BOOLEAN
  215. CheckCrc (
  216. IN UINTN MaxSize,
  217. IN OUT EFI_TABLE_HEADER *Hdr
  218. );
  219. BOOLEAN
  220. CheckCrcAltSize (
  221. IN UINTN MaxSize,
  222. IN UINTN Size,
  223. IN OUT EFI_TABLE_HEADER *Hdr
  224. );
  225. UINT32
  226. CalculateCrc (
  227. UINT8 *pt,
  228. UINTN Size
  229. );
  230. VOID
  231. ZeroMem (
  232. IN VOID *Buffer,
  233. IN UINTN Size
  234. );
  235. VOID
  236. SetMem (
  237. IN VOID *Buffer,
  238. IN UINTN Size,
  239. IN UINT8 Value
  240. );
  241. VOID
  242. CopyMem (
  243. IN VOID *Dest,
  244. IN CONST VOID *Src,
  245. IN UINTN len
  246. );
  247. INTN
  248. CompareMem (
  249. IN CONST VOID *Dest,
  250. IN CONST VOID *Src,
  251. IN UINTN len
  252. );
  253. INTN
  254. StrCmp (
  255. IN CONST CHAR16 *s1,
  256. IN CONST CHAR16 *s2
  257. );
  258. INTN
  259. StrnCmp (
  260. IN CONST CHAR16 *s1,
  261. IN CONST CHAR16 *s2,
  262. IN UINTN len
  263. );
  264. INTN
  265. StriCmp (
  266. IN CONST CHAR16 *s1,
  267. IN CONST CHAR16 *s2
  268. );
  269. VOID
  270. StrLwr (
  271. IN CHAR16 *Str
  272. );
  273. VOID
  274. StrUpr (
  275. IN CHAR16 *Str
  276. );
  277. VOID
  278. StrCpy (
  279. IN CHAR16 *Dest,
  280. IN CONST CHAR16 *Src
  281. );
  282. VOID
  283. StrnCpy (
  284. IN CHAR16 *Dest,
  285. IN CONST CHAR16 *Src,
  286. IN UINTN Len
  287. );
  288. CHAR16 *
  289. StpCpy (
  290. IN CHAR16 *Dest,
  291. IN CONST CHAR16 *Src
  292. );
  293. CHAR16 *
  294. StpnCpy (
  295. IN CHAR16 *Dest,
  296. IN CONST CHAR16 *Src,
  297. IN UINTN Len
  298. );
  299. VOID
  300. StrCat (
  301. IN CHAR16 *Dest,
  302. IN CONST CHAR16 *Src
  303. );
  304. VOID
  305. StrnCat (
  306. IN CHAR16 *Dest,
  307. IN CONST CHAR16 *Src,
  308. IN UINTN Len
  309. );
  310. UINTN
  311. StrLen (
  312. IN CONST CHAR16 *s1
  313. );
  314. UINTN
  315. StrnLen (
  316. IN CONST CHAR16 *s1,
  317. IN UINTN Len
  318. );
  319. UINTN
  320. StrSize (
  321. IN CONST CHAR16 *s1
  322. );
  323. CHAR16 *
  324. StrDuplicate (
  325. IN CONST CHAR16 *Src
  326. );
  327. UINTN
  328. strlena (
  329. IN CONST CHAR8 *s1
  330. );
  331. UINTN
  332. strcmpa (
  333. IN CONST CHAR8 *s1,
  334. IN CONST CHAR8 *s2
  335. );
  336. UINTN
  337. strncmpa (
  338. IN CONST CHAR8 *s1,
  339. IN CONST CHAR8 *s2,
  340. IN UINTN len
  341. );
  342. UINTN
  343. xtoi (
  344. CONST CHAR16 *str
  345. );
  346. UINTN
  347. Atoi (
  348. CONST CHAR16 *str
  349. );
  350. BOOLEAN
  351. MetaMatch (
  352. IN CHAR16 *String,
  353. IN CHAR16 *Pattern
  354. );
  355. BOOLEAN
  356. MetaiMatch (
  357. IN CHAR16 *String,
  358. IN CHAR16 *Pattern
  359. );
  360. UINT64
  361. LShiftU64 (
  362. IN UINT64 Operand,
  363. IN UINTN Count
  364. );
  365. UINT64
  366. RShiftU64 (
  367. IN UINT64 Operand,
  368. IN UINTN Count
  369. );
  370. UINT64
  371. MultU64x32 (
  372. IN UINT64 Multiplicand,
  373. IN UINTN Multiplier
  374. );
  375. UINT64
  376. DivU64x32 (
  377. IN UINT64 Dividend,
  378. IN UINTN Divisor,
  379. OUT UINTN *Remainder OPTIONAL
  380. );
  381. VOID
  382. InitializeLock (
  383. IN OUT FLOCK *Lock,
  384. IN EFI_TPL Priority
  385. );
  386. VOID
  387. AcquireLock (
  388. IN FLOCK *Lock
  389. );
  390. VOID
  391. ReleaseLock (
  392. IN FLOCK *Lock
  393. );
  394. INTN
  395. CompareGuid(
  396. IN EFI_GUID *Guid1,
  397. IN EFI_GUID *Guid2
  398. );
  399. VOID *
  400. AllocatePool (
  401. IN UINTN Size
  402. );
  403. VOID *
  404. AllocateZeroPool (
  405. IN UINTN Size
  406. );
  407. VOID *
  408. ReallocatePool (
  409. IN VOID *OldPool,
  410. IN UINTN OldSize,
  411. IN UINTN NewSize
  412. );
  413. VOID
  414. FreePool (
  415. IN VOID *p
  416. );
  417. VOID
  418. Output (
  419. IN CHAR16 *Str
  420. );
  421. VOID
  422. Input (
  423. IN CHAR16 *Prompt OPTIONAL,
  424. OUT CHAR16 *InStr,
  425. IN UINTN StrLen
  426. );
  427. VOID
  428. IInput (
  429. IN SIMPLE_TEXT_OUTPUT_INTERFACE *ConOut,
  430. IN SIMPLE_INPUT_INTERFACE *ConIn,
  431. IN CHAR16 *Prompt OPTIONAL,
  432. OUT CHAR16 *InStr,
  433. IN UINTN StrLen
  434. );
  435. UINTN
  436. Print (
  437. IN CONST CHAR16 *fmt,
  438. ...
  439. );
  440. UINTN
  441. VPrint (
  442. IN CONST CHAR16 *fmt,
  443. va_list args
  444. );
  445. UINTN
  446. UnicodeSPrint (
  447. OUT CHAR16 *Str,
  448. IN UINTN StrSize,
  449. IN CONST CHAR16 *fmt,
  450. ...
  451. );
  452. UINTN
  453. UnicodeVSPrint (
  454. OUT CHAR16 *Str,
  455. IN UINTN StrSize,
  456. IN CONST CHAR16 *fmt,
  457. va_list args
  458. );
  459. CHAR16 *
  460. VPoolPrint (
  461. IN CONST CHAR16 *fmt,
  462. va_list args
  463. );
  464. CHAR16 *
  465. PoolPrint (
  466. IN CONST CHAR16 *fmt,
  467. ...
  468. );
  469. typedef struct {
  470. CHAR16 *str;
  471. UINTN len;
  472. UINTN maxlen;
  473. } POOL_PRINT;
  474. CHAR16 *
  475. CatPrint (
  476. IN OUT POOL_PRINT *Str,
  477. IN CONST CHAR16 *fmt,
  478. ...
  479. );
  480. UINTN
  481. PrintAt (
  482. IN UINTN Column,
  483. IN UINTN Row,
  484. IN CONST CHAR16 *fmt,
  485. ...
  486. );
  487. UINTN
  488. IPrint (
  489. IN SIMPLE_TEXT_OUTPUT_INTERFACE *Out,
  490. IN CONST CHAR16 *fmt,
  491. ...
  492. );
  493. UINTN
  494. IPrintAt (
  495. IN SIMPLE_TEXT_OUTPUT_INTERFACE *Out,
  496. IN UINTN Column,
  497. IN UINTN Row,
  498. IN CONST CHAR16 *fmt,
  499. ...
  500. );
  501. UINTN
  502. AsciiPrint (
  503. IN CONST CHAR8 *fmt,
  504. ...
  505. );
  506. UINTN
  507. AsciiVSPrint(
  508. OUT CHAR8 *Str,
  509. IN UINTN StrSize,
  510. IN CONST CHAR8 *fmt,
  511. va_list args
  512. );
  513. //
  514. // For compatibility with previous gnu-efi versions
  515. //
  516. #define SPrint UnicodeSPrint
  517. #define VSPrint UnicodeVSPrint
  518. #define APrint AsciiPrint
  519. VOID
  520. ValueToHex (
  521. IN CHAR16 *Buffer,
  522. IN UINT64 v
  523. );
  524. VOID
  525. ValueToString (
  526. IN CHAR16 *Buffer,
  527. IN BOOLEAN Comma,
  528. IN INT64 v
  529. );
  530. VOID
  531. FloatToString (
  532. IN CHAR16 *Buffer,
  533. IN BOOLEAN Comma,
  534. IN double v
  535. );
  536. VOID
  537. TimeToString (
  538. OUT CHAR16 *Buffer,
  539. IN EFI_TIME *Time
  540. );
  541. VOID
  542. GuidToString (
  543. OUT CHAR16 *Buffer,
  544. IN EFI_GUID *Guid
  545. );
  546. VOID
  547. StatusToString (
  548. OUT CHAR16 *Buffer,
  549. EFI_STATUS Status
  550. );
  551. VOID
  552. DumpHex (
  553. IN UINTN Indent,
  554. IN UINTN Offset,
  555. IN UINTN DataSize,
  556. IN VOID *UserData
  557. );
  558. BOOLEAN
  559. GrowBuffer(
  560. IN OUT EFI_STATUS *Status,
  561. IN OUT VOID **Buffer,
  562. IN UINTN BufferSize
  563. );
  564. EFI_MEMORY_DESCRIPTOR *
  565. LibMemoryMap (
  566. OUT UINTN *NoEntries,
  567. OUT UINTN *MapKey,
  568. OUT UINTN *DescriptorSize,
  569. OUT UINT32 *DescriptorVersion
  570. );
  571. VOID *
  572. LibGetVariable (
  573. IN CHAR16 *Name,
  574. IN EFI_GUID *VendorGuid
  575. );
  576. VOID *
  577. LibGetVariableAndSize (
  578. IN CHAR16 *Name,
  579. IN EFI_GUID *VendorGuid,
  580. OUT UINTN *VarSize
  581. );
  582. EFI_STATUS
  583. LibDeleteVariable (
  584. IN CHAR16 *VarName,
  585. IN EFI_GUID *VarGuid
  586. );
  587. EFI_STATUS
  588. LibSetNVVariable (
  589. IN CHAR16 *VarName,
  590. IN EFI_GUID *VarGuid,
  591. IN UINTN DataSize,
  592. IN VOID *Data
  593. );
  594. EFI_STATUS
  595. LibSetVariable (
  596. IN CHAR16 *VarName,
  597. IN EFI_GUID *VarGuid,
  598. IN UINTN DataSize,
  599. IN VOID *Data
  600. );
  601. EFI_STATUS
  602. LibInsertToTailOfBootOrder (
  603. IN UINT16 BootOption,
  604. IN BOOLEAN OnlyInsertIfEmpty
  605. );
  606. EFI_STATUS
  607. LibLocateProtocol (
  608. IN EFI_GUID *ProtocolGuid,
  609. OUT VOID **Interface
  610. );
  611. EFI_STATUS
  612. LibLocateHandle (
  613. IN EFI_LOCATE_SEARCH_TYPE SearchType,
  614. IN EFI_GUID *Protocol OPTIONAL,
  615. IN VOID *SearchKey OPTIONAL,
  616. IN OUT UINTN *NoHandles,
  617. OUT EFI_HANDLE **Buffer
  618. );
  619. EFI_STATUS
  620. LibLocateHandleByDiskSignature (
  621. IN UINT8 MBRType,
  622. IN UINT8 SignatureType,
  623. IN VOID *Signature,
  624. IN OUT UINTN *NoHandles,
  625. OUT EFI_HANDLE **Buffer
  626. );
  627. EFI_STATUS
  628. LibInstallProtocolInterfaces (
  629. IN OUT EFI_HANDLE *Handle,
  630. ...
  631. );
  632. VOID
  633. LibUninstallProtocolInterfaces (
  634. IN EFI_HANDLE Handle,
  635. ...
  636. );
  637. EFI_STATUS
  638. LibReinstallProtocolInterfaces (
  639. IN OUT EFI_HANDLE *Handle,
  640. ...
  641. );
  642. EFI_EVENT
  643. LibCreateProtocolNotifyEvent (
  644. IN EFI_GUID *ProtocolGuid,
  645. IN EFI_TPL NotifyTpl,
  646. IN EFI_EVENT_NOTIFY NotifyFunction,
  647. IN VOID *NotifyContext,
  648. OUT VOID *Registration
  649. );
  650. EFI_STATUS
  651. WaitForSingleEvent (
  652. IN EFI_EVENT Event,
  653. IN UINT64 Timeout OPTIONAL
  654. );
  655. VOID
  656. WaitForEventWithTimeout (
  657. IN EFI_EVENT Event,
  658. IN UINTN Timeout,
  659. IN UINTN Row,
  660. IN UINTN Column,
  661. IN CHAR16 *String,
  662. IN EFI_INPUT_KEY TimeoutKey,
  663. OUT EFI_INPUT_KEY *Key
  664. );
  665. EFI_FILE_HANDLE
  666. LibOpenRoot (
  667. IN EFI_HANDLE DeviceHandle
  668. );
  669. EFI_FILE_INFO *
  670. LibFileInfo (
  671. IN EFI_FILE_HANDLE FHand
  672. );
  673. EFI_FILE_SYSTEM_INFO *
  674. LibFileSystemInfo (
  675. IN EFI_FILE_HANDLE FHand
  676. );
  677. EFI_FILE_SYSTEM_VOLUME_LABEL_INFO *
  678. LibFileSystemVolumeLabelInfo (
  679. IN EFI_FILE_HANDLE FHand
  680. );
  681. BOOLEAN
  682. ValidMBR(
  683. IN MASTER_BOOT_RECORD *Mbr,
  684. IN EFI_BLOCK_IO *BlkIo
  685. );
  686. BOOLEAN
  687. LibMatchDevicePaths (
  688. IN EFI_DEVICE_PATH *Multi,
  689. IN EFI_DEVICE_PATH *Single
  690. );
  691. EFI_DEVICE_PATH *
  692. LibDuplicateDevicePathInstance (
  693. IN EFI_DEVICE_PATH *DevPath
  694. );
  695. EFI_DEVICE_PATH *
  696. DevicePathFromHandle (
  697. IN EFI_HANDLE Handle
  698. );
  699. EFI_DEVICE_PATH *
  700. DevicePathInstance (
  701. IN OUT EFI_DEVICE_PATH **DevicePath,
  702. OUT UINTN *Size
  703. );
  704. UINTN
  705. DevicePathInstanceCount (
  706. IN EFI_DEVICE_PATH *DevicePath
  707. );
  708. EFI_DEVICE_PATH *
  709. AppendDevicePath (
  710. IN EFI_DEVICE_PATH *Src1,
  711. IN EFI_DEVICE_PATH *Src2
  712. );
  713. EFI_DEVICE_PATH *
  714. AppendDevicePathNode (
  715. IN EFI_DEVICE_PATH *Src1,
  716. IN EFI_DEVICE_PATH *Src2
  717. );
  718. EFI_DEVICE_PATH*
  719. AppendDevicePathInstance (
  720. IN EFI_DEVICE_PATH *Src,
  721. IN EFI_DEVICE_PATH *Instance
  722. );
  723. EFI_DEVICE_PATH *
  724. FileDevicePath (
  725. IN EFI_HANDLE Device OPTIONAL,
  726. IN CHAR16 *FileName
  727. );
  728. UINTN
  729. DevicePathSize (
  730. IN EFI_DEVICE_PATH *DevPath
  731. );
  732. EFI_DEVICE_PATH *
  733. DuplicateDevicePath (
  734. IN EFI_DEVICE_PATH *DevPath
  735. );
  736. EFI_DEVICE_PATH *
  737. UnpackDevicePath (
  738. IN EFI_DEVICE_PATH *DevPath
  739. );
  740. EFI_STATUS
  741. LibDevicePathToInterface (
  742. IN EFI_GUID *Protocol,
  743. IN EFI_DEVICE_PATH *FilePath,
  744. OUT VOID **Interface
  745. );
  746. CHAR16 *
  747. DevicePathToStr (
  748. EFI_DEVICE_PATH *DevPath
  749. );
  750. //
  751. // BugBug: I need my own include files
  752. //
  753. typedef struct {
  754. UINT8 Register;
  755. UINT8 Function;
  756. UINT8 Device;
  757. UINT8 Bus;
  758. UINT32 Reserved;
  759. } EFI_ADDRESS;
  760. typedef union {
  761. UINT64 Address;
  762. EFI_ADDRESS EfiAddress;
  763. } EFI_PCI_ADDRESS_UNION;
  764. EFI_STATUS
  765. PciFindDeviceClass (
  766. IN OUT EFI_PCI_ADDRESS_UNION *Address,
  767. IN UINT8 BaseClass,
  768. IN UINT8 SubClass
  769. );
  770. EFI_STATUS
  771. PciFindDevice (
  772. IN OUT EFI_PCI_ADDRESS_UNION *DeviceAddress,
  773. IN UINT16 VendorId,
  774. IN UINT16 DeviceId,
  775. IN OUT PCI_TYPE00 *Pci
  776. );
  777. //
  778. // SIMPLE_READ_FILE object used to access files
  779. //
  780. typedef VOID *SIMPLE_READ_FILE;
  781. EFI_STATUS
  782. OpenSimpleReadFile (
  783. IN BOOLEAN BootPolicy,
  784. IN VOID *SourceBuffer OPTIONAL,
  785. IN UINTN SourceSize,
  786. IN OUT EFI_DEVICE_PATH **FilePath,
  787. OUT EFI_HANDLE *DeviceHandle,
  788. OUT SIMPLE_READ_FILE *SimpleReadHandle
  789. );
  790. EFI_STATUS
  791. ReadSimpleReadFile (
  792. IN SIMPLE_READ_FILE SimpleReadHandle,
  793. IN UINTN Offset,
  794. IN OUT UINTN *ReadSize,
  795. OUT VOID *Buffer
  796. );
  797. VOID
  798. CloseSimpleReadFile (
  799. IN SIMPLE_READ_FILE SimpleReadHandle
  800. );
  801. VOID
  802. InitializeGuid (
  803. VOID
  804. );
  805. UINT8
  806. DecimaltoBCD(
  807. IN UINT8 DecValue
  808. );
  809. UINT8
  810. BCDtoDecimal(
  811. IN UINT8 BcdValue
  812. );
  813. EFI_STATUS
  814. LibGetSystemConfigurationTable(
  815. IN EFI_GUID *TableGuid,
  816. IN OUT VOID **Table
  817. );
  818. BOOLEAN
  819. LibIsValidTextGraphics (
  820. IN CHAR16 Graphic,
  821. OUT CHAR8 *PcAnsi, OPTIONAL
  822. OUT CHAR8 *Ascii OPTIONAL
  823. );
  824. BOOLEAN
  825. IsValidAscii (
  826. IN CHAR16 Ascii
  827. );
  828. BOOLEAN
  829. IsValidEfiCntlChar (
  830. IN CHAR16 c
  831. );
  832. CHAR16 *
  833. LibGetUiString (
  834. IN EFI_HANDLE Handle,
  835. IN UI_STRING_TYPE StringType,
  836. IN ISO_639_2 *LangCode,
  837. IN BOOLEAN ReturnDevicePathStrOnMismatch
  838. );
  839. CHAR8*
  840. LibGetSmbiosString (
  841. IN SMBIOS_STRUCTURE_POINTER *Smbios,
  842. IN UINT16 StringNumber
  843. );
  844. EFI_STATUS
  845. LibGetSmbiosSystemGuidAndSerialNumber (
  846. IN EFI_GUID *SystemGuid,
  847. OUT CHAR8 **SystemSerialNumber
  848. );
  849. EFI_STATUS
  850. InitializeGlobalIoDevice (
  851. IN EFI_DEVICE_PATH *DevicePath,
  852. IN EFI_GUID *Protocol,
  853. IN CHAR8 *ErrorStr,
  854. OUT EFI_DEVICE_IO_INTERFACE **GlobalIoFncs
  855. );
  856. UINT32
  857. ReadPort (
  858. IN EFI_DEVICE_IO_INTERFACE *GlobalIoFncs,
  859. IN EFI_IO_WIDTH Width,
  860. IN UINTN Port
  861. );
  862. UINT32
  863. WritePort (
  864. IN EFI_DEVICE_IO_INTERFACE *GlobalIoFncs,
  865. IN EFI_IO_WIDTH Width,
  866. IN UINTN Port,
  867. IN UINTN Data
  868. );
  869. UINT32
  870. ReadPciConfig (
  871. IN EFI_DEVICE_IO_INTERFACE *GlobalIoFncs,
  872. IN EFI_IO_WIDTH Width,
  873. IN UINTN Port
  874. );
  875. UINT32
  876. WritePciConfig (
  877. IN EFI_DEVICE_IO_INTERFACE *GlobalIoFncs,
  878. IN EFI_IO_WIDTH Width,
  879. IN UINTN Port,
  880. IN UINTN Data
  881. );
  882. VOID
  883. Pause (
  884. VOID
  885. );
  886. extern EFI_DEVICE_IO_INTERFACE *GlobalIoFncs;
  887. #define outp(_Port, _DataByte) (UINT8)WritePort(GlobalIoFncs, IO_UINT8, (UINTN)_Port, (UINTN)_DataByte)
  888. #define inp(_Port) (UINT8)ReadPort(GlobalIoFncs, IO_UINT8, (UINTN)_Port)
  889. #define outpw(_Port, _DataByte) (UINT16)WritePort(GlobalIoFncs, IO_UINT16, (UINTN)_Port, (UINTN)_DataByte)
  890. #define inpw(_Port) (UINT16)ReadPort(GlobalIoFncs, IO_UINT16, (UINTN)_Port)
  891. #define outpd(_Port, _DataByte) (UINT32)WritePort(GlobalIoFncs, IO_UINT32, (UINTN)_Port, (UINTN)_DataByte)
  892. #define inpd(_Port) (UINT32)ReadPort(GlobalIoFncs, IO_UINT32, (UINTN)_Port)
  893. #define writepci8(_Addr, _DataByte) (UINT8)WritePciConfig(GlobalIoFncs, IO_UINT8, (UINTN)_Addr, (UINTN)_DataByte)
  894. #define readpci8(_Addr) (UINT8)ReadPciConfig(GlobalIoFncs, IO_UINT8, (UINTN)_Addr)
  895. #define writepci16(_Addr, _DataByte) (UINT16)WritePciConfig(GlobalIoFncs, IO_UINT16, (UINTN)_Addr, (UINTN)_DataByte)
  896. #define readpci16(_Addr) (UINT16)ReadPciConfig(GlobalIoFncs, IO_UINT16, (UINTN)_Addr)
  897. #define writepci32(_Addr, _DataByte) (UINT32)WritePciConfig(GlobalIoFncs, IO_UINT32, (UINTN)_Addr, (UINTN)_DataByte)
  898. #define readpci32(_Addr) (UINT32)ReadPciConfig(GlobalIoFncs, IO_UINT32, (UINTN)_Addr)
  899. #define Port80(_PostCode) GlobalIoFncs->Io.Write (GlobalIoFncs, IO_UINT16, (UINT64)0x80, 1, &(_PostCode))
  900. #endif