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 #define ELEMENTSOF(x) (sizeof(x)/sizeof((x)[0]))
   8 #define OFFSETOF(x,y) __builtin_offsetof(x,y)
   9
  10 static inline UINTN ALIGN_TO(UINTN l, UINTN ali) {
  11         return ((l + ali - 1) & ~(ali - 1));
  12 }
  13
  14 static inline const CHAR16 *yes_no(BOOLEAN b) {
  15         return b ? L"yes" : L"no";
  16 }
  17
  18 EFI_STATUS parse_boolean(const CHAR8 *v, BOOLEAN *b);
  19
  20 UINT64 ticks_read(void);
  21 UINT64 ticks_freq(void);
  22 UINT64 time_usec(void);
  23
  24 EFI_STATUS efivar_set(const EFI_GUID *vendor, const CHAR16 *name, const CHAR16 *value, BOOLEAN persistent);
  25 EFI_STATUS efivar_set_raw(const EFI_GUID *vendor, const CHAR16 *name, const VOID *buf, UINTN size, BOOLEAN persistent);
  26 EFI_STATUS efivar_set_uint_string(const EFI_GUID *vendor, CHAR16 *name, UINTN i, BOOLEAN persistent);
  27 VOID efivar_set_time_usec(const EFI_GUID *vendor, CHAR16 *name, UINT64 usec);
  28
  29 EFI_STATUS efivar_get(const EFI_GUID *vendor, const CHAR16 *name, CHAR16 **value);
  30 EFI_STATUS efivar_get_raw(const EFI_GUID *vendor, const CHAR16 *name, CHAR8 **buffer, UINTN *size);
  31 EFI_STATUS efivar_get_uint_string(const EFI_GUID *vendor, const CHAR16 *name, UINTN *i);
  32 EFI_STATUS efivar_get_boolean_u8(const EFI_GUID *vendor, const CHAR16 *name, BOOLEAN *ret);
  33
  34 CHAR8 *strchra(CHAR8 *s, CHAR8 c);
  35 CHAR16 *stra_to_path(CHAR8 *stra);
  36 CHAR16 *stra_to_str(CHAR8 *stra);
  37
  38 EFI_STATUS file_read(EFI_FILE_HANDLE dir, const CHAR16 *name, UINTN off, UINTN size, CHAR8 **content, UINTN *content_size);
  39
  40 static inline void FreePoolp(void *p) {
  41         void *q = *(void**) p;
  42
  43         if (!q)
  44                 return;
  45
  46         FreePool(q);
  47 }
  48
  49 #define _cleanup_(x) __attribute__((__cleanup__(x)))
  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 #define TAKE_PTR(ptr)                           \
  72         ({                                      \
  73                 typeof(ptr) _ptr_ = (ptr);      \
  74                 (ptr) = NULL;                   \
  75                 _ptr_;                          \
  76         })
  77
  78 EFI_STATUS log_oom(void);