src/boot/efi/util.h

   1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
   2 #pragma once
   3
   4 #include <efi.h>
   5 #include <efilib.h>
   6
   7 #include "string-util-fundamental.h"
   8
   9 #define OFFSETOF(x,y) __builtin_offsetof(x,y)
  10
  11 static inline UINTN ALIGN_TO(UINTN l, UINTN ali) {
  12         return ((l + ali - 1) & ~(ali - 1));
  13 }
  14
  15 EFI_STATUS parse_boolean(const CHAR8 *v, BOOLEAN *b);
  16
  17 UINT64 ticks_read(void);
  18 UINT64 ticks_freq(void);
  19 UINT64 time_usec(void);
  20
  21 EFI_STATUS efivar_set(const EFI_GUID *vendor, const CHAR16 *name, const CHAR16 *value, UINT32 flags);
  22 EFI_STATUS efivar_set_raw(const EFI_GUID *vendor, const CHAR16 *name, const VOID *buf, UINTN size, UINT32 flags);
  23 EFI_STATUS efivar_set_uint_string(const EFI_GUID *vendor, CHAR16 *name, UINTN i, UINT32 flags);
  24 EFI_STATUS efivar_set_uint32_le(const EFI_GUID *vendor, CHAR16 *NAME, UINT32 value, UINT32 flags);
  25 EFI_STATUS efivar_set_uint64_le(const EFI_GUID *vendor, CHAR16 *name, UINT64 value, UINT32 flags);
  26 VOID efivar_set_time_usec(const EFI_GUID *vendor, CHAR16 *name, UINT64 usec);
  27
  28 EFI_STATUS efivar_get(const EFI_GUID *vendor, const CHAR16 *name, CHAR16 **value);
  29 EFI_STATUS efivar_get_raw(const EFI_GUID *vendor, const CHAR16 *name, CHAR8 **buffer, UINTN *size);
  30 EFI_STATUS efivar_get_uint_string(const EFI_GUID *vendor, const CHAR16 *name, UINTN *i);
  31 EFI_STATUS efivar_get_uint32_le(const EFI_GUID *vendor, const CHAR16 *name, UINT32 *ret);
  32 EFI_STATUS efivar_get_uint64_le(const EFI_GUID *vendor, const CHAR16 *name, UINT64 *ret);
  33 EFI_STATUS efivar_get_boolean_u8(const EFI_GUID *vendor, const CHAR16 *name, BOOLEAN *ret);
  34
  35 CHAR8 *strchra(CHAR8 *s, CHAR8 c);
  36 CHAR16 *stra_to_path(CHAR8 *stra);
  37 CHAR16 *stra_to_str(CHAR8 *stra);
  38
  39 EFI_STATUS file_read(EFI_FILE_HANDLE dir, const CHAR16 *name, UINTN off, UINTN size, CHAR8 **content, UINTN *content_size);
  40
  41 static inline void FreePoolp(void *p) {
  42         void *q = *(void**) p;
  43
  44         if (!q)
  45                 return;
  46
  47         FreePool(q);
  48 }
  49
  50 #define _cleanup_freepool_ _cleanup_(FreePoolp)
  51
  52 static inline void FileHandleClosep(EFI_FILE_HANDLE *handle) {
  53         if (!*handle)
  54                 return;
  55
  56         uefi_call_wrapper((*handle)->Close, 1, *handle);
  57 }
  58
  59 /*
  60  * Allocated random UUID, intended to be shared across tools that implement
  61  * the (ESP)\loader\entries\<vendor>-<revision>.conf convention and the
  62  * associated EFI variables.
  63  */
  64 #define LOADER_GUID \
  65         &(const EFI_GUID) { 0x4a67b082, 0x0a4c, 0x41cf, { 0xb6, 0xc7, 0x44, 0x0b, 0x29, 0xbb, 0x8c, 0x4f } }
  66 #define EFI_GLOBAL_GUID &(const EFI_GUID) EFI_GLOBAL_VARIABLE
  67
  68 #define UINTN_MAX (~(UINTN)0)
  69 #define INTN_MAX ((INTN)(UINTN_MAX>>1))
  70
  71 EFI_STATUS log_oom(void);