efi: Free malloc regions on exit
[grub.git] / include / grub / efi / efi.h
1 /* efi.h - declare variables and functions for EFI support */
2 /*
3  *  GRUB  --  GRand Unified Bootloader
4  *  Copyright (C) 2006,2007,2008,2009  Free Software Foundation, Inc.
5  *
6  *  GRUB is free software: you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation, either version 3 of the License, or
9  *  (at your option) any later version.
10  *
11  *  GRUB is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with GRUB.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef GRUB_EFI_EFI_HEADER
21 #define GRUB_EFI_EFI_HEADER     1
22
23 #include <grub/types.h>
24 #include <grub/dl.h>
25 #include <grub/efi/api.h>
26
27 /* Functions.  */
28 void *EXPORT_FUNC(grub_efi_locate_protocol) (grub_efi_guid_t *protocol,
29                                              void *registration);
30 grub_efi_handle_t *
31 EXPORT_FUNC(grub_efi_locate_handle) (grub_efi_locate_search_type_t search_type,
32                                      grub_efi_guid_t *protocol,
33                                      void *search_key,
34                                      grub_efi_uintn_t *num_handles);
35 void *EXPORT_FUNC(grub_efi_open_protocol) (grub_efi_handle_t handle,
36                                            grub_efi_guid_t *protocol,
37                                            grub_efi_uint32_t attributes);
38 int EXPORT_FUNC(grub_efi_set_text_mode) (int on);
39 void EXPORT_FUNC(grub_efi_stall) (grub_efi_uintn_t microseconds);
40 void *
41 EXPORT_FUNC(grub_efi_allocate_pages_real) (grub_efi_physical_address_t address,
42                                            grub_efi_uintn_t pages,
43                                            grub_efi_allocate_type_t alloctype,
44                                            grub_efi_memory_type_t memtype);
45 void *
46 EXPORT_FUNC(grub_efi_allocate_fixed) (grub_efi_physical_address_t address,
47                                       grub_efi_uintn_t pages);
48 void *
49 EXPORT_FUNC(grub_efi_allocate_any_pages) (grub_efi_uintn_t pages);
50 void EXPORT_FUNC(grub_efi_free_pages) (grub_efi_physical_address_t address,
51                                        grub_efi_uintn_t pages);
52 int
53 EXPORT_FUNC(grub_efi_get_memory_map) (grub_efi_uintn_t *memory_map_size,
54                                       grub_efi_memory_descriptor_t *memory_map,
55                                       grub_efi_uintn_t *map_key,
56                                       grub_efi_uintn_t *descriptor_size,
57                                       grub_efi_uint32_t *descriptor_version);
58 void grub_efi_memory_fini (void);
59 grub_efi_loaded_image_t *EXPORT_FUNC(grub_efi_get_loaded_image) (grub_efi_handle_t image_handle);
60 void EXPORT_FUNC(grub_efi_print_device_path) (grub_efi_device_path_t *dp);
61 char *EXPORT_FUNC(grub_efi_get_filename) (grub_efi_device_path_t *dp);
62 grub_efi_device_path_t *
63 EXPORT_FUNC(grub_efi_get_device_path) (grub_efi_handle_t handle);
64 grub_efi_device_path_t *
65 EXPORT_FUNC(grub_efi_find_last_device_path) (const grub_efi_device_path_t *dp);
66 grub_efi_device_path_t *
67 EXPORT_FUNC(grub_efi_duplicate_device_path) (const grub_efi_device_path_t *dp);
68 grub_err_t EXPORT_FUNC (grub_efi_finish_boot_services) (grub_efi_uintn_t *outbuf_size, void *outbuf,
69                                                         grub_efi_uintn_t *map_key,
70                                                         grub_efi_uintn_t *efi_desc_size,
71                                                         grub_efi_uint32_t *efi_desc_version);
72 grub_err_t EXPORT_FUNC (grub_efi_set_virtual_address_map) (grub_efi_uintn_t memory_map_size,
73                                                            grub_efi_uintn_t descriptor_size,
74                                                            grub_efi_uint32_t descriptor_version,
75                                                            grub_efi_memory_descriptor_t *virtual_map);
76 void *EXPORT_FUNC (grub_efi_get_variable) (const char *variable,
77                                            const grub_efi_guid_t *guid,
78                                            grub_size_t *datasize_out);
79 grub_err_t
80 EXPORT_FUNC (grub_efi_set_variable) (const char *var,
81                                      const grub_efi_guid_t *guid,
82                                      void *data,
83                                      grub_size_t datasize);
84 int
85 EXPORT_FUNC (grub_efi_compare_device_paths) (const grub_efi_device_path_t *dp1,
86                                              const grub_efi_device_path_t *dp2);
87
88 extern void (*EXPORT_VAR(grub_efi_net_config)) (grub_efi_handle_t hnd, 
89                                                 char **device,
90                                                 char **path);
91
92 #if defined(__arm__) || defined(__aarch64__)
93 void *EXPORT_FUNC(grub_efi_get_firmware_fdt)(void);
94 #endif
95
96 grub_addr_t grub_efi_modules_addr (void);
97
98 void grub_efi_mm_init (void);
99 void grub_efi_mm_fini (void);
100 void grub_efi_init (void);
101 void grub_efi_fini (void);
102 void grub_efi_set_prefix (void);
103
104 /* Variables.  */
105 extern grub_efi_system_table_t *EXPORT_VAR(grub_efi_system_table);
106 extern grub_efi_handle_t EXPORT_VAR(grub_efi_image_handle);
107
108 extern int EXPORT_VAR(grub_efi_is_finished);
109
110 struct grub_net_card;
111
112 grub_efi_handle_t
113 grub_efinet_get_device_handle (struct grub_net_card *card);
114
115 #endif /* ! GRUB_EFI_EFI_HEADER */