]> code.delx.au - refind/blob - refind/global.h
584b108105551a07477ec11256cd7d8c162256e4
[refind] / refind / global.h
1 /*
2 * refit/global.h
3 * Global header file
4 *
5 * Copyright (c) 2006-2009 Christoph Pfisterer
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
10 * met:
11 *
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 *
15 * * Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the
18 * distribution.
19 *
20 * * Neither the name of Christoph Pfisterer nor the names of the
21 * contributors may be used to endorse or promote products derived
22 * from this software without specific prior written permission.
23 *
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
27 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
28 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
29 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 */
36 /*
37 * Modifications copyright (c) 2012-2015 Roderick W. Smith
38 *
39 * Modifications distributed under the terms of the GNU General Public
40 * License (GPL) version 3 (GPLv3), a copy of which must be distributed
41 * with this source code or binaries made from it.
42 *
43 */
44
45 #ifndef __GLOBAL_H_
46 #define __GLOBAL_H_
47
48 #ifdef __MAKEWITH_GNUEFI
49 #include <efi.h>
50 #include <efilib.h>
51 #else
52 #include "../include/tiano_includes.h"
53 #endif
54 #include "../EfiLib/GenericBdsLib.h"
55
56 #include "libeg.h"
57
58 #define REFIT_DEBUG (0)
59
60 // Tag classifications; used in various ways.
61 #define TAG_ABOUT (1)
62 #define TAG_REBOOT (2)
63 #define TAG_SHUTDOWN (3)
64 #define TAG_TOOL (4)
65 #define TAG_LOADER (5)
66 #define TAG_LEGACY (6)
67 #define TAG_EXIT (7)
68 #define TAG_SHELL (8)
69 #define TAG_GPTSYNC (9)
70 #define TAG_LEGACY_UEFI (10)
71 #define TAG_APPLE_RECOVERY (11)
72 #define TAG_WINDOWS_RECOVERY (12)
73 #define TAG_MOK_TOOL (13)
74 #define TAG_FIRMWARE (14)
75 #define TAG_MEMTEST (15)
76 #define TAG_GDISK (16)
77 #define TAG_NETBOOT (17)
78 #define NUM_TOOLS (18)
79
80 #define NUM_SCAN_OPTIONS 10
81
82 #define DEFAULT_ICONS_DIR L"icons"
83
84 // OS bit codes; used in GlobalConfig.GraphicsOn
85 #define GRAPHICS_FOR_OSX 1
86 #define GRAPHICS_FOR_LINUX 2
87 #define GRAPHICS_FOR_ELILO 4
88 #define GRAPHICS_FOR_GRUB 8
89 #define GRAPHICS_FOR_WINDOWS 16
90
91 // Load types
92 #define TYPE_EFI 1
93 #define TYPE_LEGACY 2
94
95 // Type of legacy (BIOS) boot support detected
96 #define LEGACY_TYPE_NONE 0
97 #define LEGACY_TYPE_MAC 1
98 #define LEGACY_TYPE_UEFI 2
99
100 #ifdef __MAKEWITH_GNUEFI
101 //
102 // define BBS Device Types
103 //
104 #define BBS_FLOPPY 0x01
105 #define BBS_HARDDISK 0x02
106 #define BBS_CDROM 0x03
107 #define BBS_PCMCIA 0x04
108 #define BBS_USB 0x05
109 #define BBS_EMBED_NETWORK 0x06
110 #define BBS_BEV_DEVICE 0x80
111 #define BBS_UNKNOWN 0xff
112 #endif
113
114 // BIOS Boot Specification (BBS) device types, as returned in DevicePath->Type field
115 #define DEVICE_TYPE_HW 0x01
116 #define DEVICE_TYPE_ACPI 0x02 /* returned by UEFI boot loader on USB */
117 #define DEVICE_TYPE_MESSAGING 0x03
118 #define DEVICE_TYPE_MEDIA 0x04 /* returned by EFI boot loaders on hard disk */
119 #define DEVICE_TYPE_BIOS 0x05 /* returned by legacy (BIOS) boot loaders */
120 #define DEVICE_TYPE_END 0x75 /* end of path */
121
122 // Filesystem type identifiers. Not all are yet used....
123 #define FS_TYPE_UNKNOWN 0
124 #define FS_TYPE_FAT 1
125 #define FS_TYPE_EXT2 2
126 #define FS_TYPE_EXT3 3
127 #define FS_TYPE_EXT4 4
128 #define FS_TYPE_HFSPLUS 5
129 #define FS_TYPE_REISERFS 6
130 #define FS_TYPE_BTRFS 7
131 #define FS_TYPE_ISO9660 8
132
133 // How to scale banner images
134 #define BANNER_NOSCALE 0
135 #define BANNER_FILLSCREEN 1
136
137 // Sizes of the default icons; badges are 1/4 the big icon size
138 #define DEFAULT_SMALL_ICON_SIZE 48
139 #define DEFAULT_BIG_ICON_SIZE 128
140
141 // Codes for types of icon sizes; used for indexing into GlobalConfig.IconSizes[]
142 #define ICON_SIZE_BADGE 0
143 #define ICON_SIZE_SMALL 1
144 #define ICON_SIZE_BIG 2
145
146 // Names of binaries that can manage MOKs....
147 #define MOK_NAMES L"MokManager.efi,HashTool.efi,HashTool-signed.efi"
148 // Directories to search for these MOK-managing programs. Note that SelfDir is
149 // searched in addition to these locations....
150 #define MOK_LOCATIONS L"\\,EFI\\tools,EFI\\fedora,EFI\\redhat,EFI\\ubuntu,EFI\\suse,EFI\\opensuse,EFI\\altlinux"
151 // Directories to search for memtest86....
152 #define MEMTEST_LOCATIONS L"EFI\\tools,EFI\\tools\\memtest86,EFI\\tools\\memtest,EFI\\memtest86,EFI\\memtest"
153 // Files that may be Windows recovery files
154 #define WINDOWS_RECOVERY_FILES L"EFI\\Microsoft\\Boot\\LrsBootmgr.efi,Recovery:\\EFI\\BOOT\\bootx64.efi,Recovery:\\EFI\\BOOT\\bootia32.efi"
155
156 // Definitions for the "hideui" option in refind.conf
157 #define HIDEUI_FLAG_NONE (0x0000)
158 #define HIDEUI_FLAG_BANNER (0x0001)
159 #define HIDEUI_FLAG_LABEL (0x0002)
160 #define HIDEUI_FLAG_SINGLEUSER (0x0004)
161 #define HIDEUI_FLAG_HWTEST (0x0008)
162 #define HIDEUI_FLAG_ARROWS (0x0010)
163 #define HIDEUI_FLAG_HINTS (0x0020)
164 #define HIDEUI_FLAG_EDITOR (0x0040)
165 #define HIDEUI_FLAG_SAFEMODE (0x0080)
166 #define HIDEUI_FLAG_BADGES (0x0100)
167 #define HIDEUI_FLAG_ALL ((0xffff))
168
169 // Default hint text for program-launch submenus
170 #define SUBSCREEN_HINT1 L"Use arrow keys to move cursor; Enter to boot;"
171 #define SUBSCREEN_HINT2 L"Insert or F2 to edit options; Esc to return to main menu"
172 #define SUBSCREEN_HINT2_NO_EDITOR L"Esc to return to main menu"
173
174 #define NULL_GUID_VALUE { 0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00} };
175 #define REFIND_GUID_VALUE { 0x36D08FA7, 0xCF0B, 0x42F5, {0x8F, 0x14, 0x68, 0xDF, 0x73, 0xED, 0x37, 0x40} };
176
177 //
178 // global definitions
179 //
180
181 // global types
182
183 typedef struct {
184 UINT8 Flags;
185 UINT8 StartCHS1;
186 UINT8 StartCHS2;
187 UINT8 StartCHS3;
188 UINT8 Type;
189 UINT8 EndCHS1;
190 UINT8 EndCHS2;
191 UINT8 EndCHS3;
192 UINT32 StartLBA;
193 UINT32 Size;
194 } MBR_PARTITION_INFO;
195
196 typedef struct {
197 EFI_DEVICE_PATH *DevicePath;
198 EFI_HANDLE DeviceHandle;
199 EFI_FILE *RootDir;
200 CHAR16 *VolName;
201 CHAR16 *PartName;
202 EFI_GUID VolUuid;
203 EFI_GUID PartGuid;
204 UINTN VolNumber;
205 EG_IMAGE *VolIconImage;
206 EG_IMAGE *VolBadgeImage;
207 UINTN DiskKind;
208 BOOLEAN IsAppleLegacy;
209 BOOLEAN HasBootCode;
210 CHAR16 *OSIconName;
211 CHAR16 *OSName;
212 BOOLEAN IsMbrPartition;
213 UINTN MbrPartitionIndex;
214 EFI_BLOCK_IO *BlockIO;
215 UINT64 BlockIOOffset;
216 EFI_BLOCK_IO *WholeDiskBlockIO;
217 EFI_DEVICE_PATH *WholeDiskDevicePath;
218 MBR_PARTITION_INFO *MbrPartitionTable;
219 BOOLEAN IsReadable;
220 UINT32 FSType;
221 } REFIT_VOLUME;
222
223 typedef struct _refit_menu_entry {
224 CHAR16 *Title;
225 UINTN Tag;
226 UINTN Row;
227 CHAR16 ShortcutDigit;
228 CHAR16 ShortcutLetter;
229 EG_IMAGE *Image;
230 EG_IMAGE *BadgeImage;
231 struct _refit_menu_screen *SubScreen;
232 } REFIT_MENU_ENTRY;
233
234 typedef struct _refit_menu_screen {
235 CHAR16 *Title;
236 EG_IMAGE *TitleImage;
237 UINTN InfoLineCount;
238 CHAR16 **InfoLines;
239 UINTN EntryCount; // total number of entries registered
240 REFIT_MENU_ENTRY **Entries;
241 UINTN TimeoutSeconds;
242 CHAR16 *TimeoutText;
243 CHAR16 *Hint1;
244 CHAR16 *Hint2;
245 } REFIT_MENU_SCREEN;
246
247 typedef struct {
248 REFIT_MENU_ENTRY me;
249 CHAR16 *Title;
250 CHAR16 *LoaderPath;
251 CHAR16 *VolName;
252 EFI_DEVICE_PATH *DevicePath;
253 BOOLEAN UseGraphicsMode;
254 BOOLEAN Enabled;
255 CHAR16 *LoadOptions;
256 CHAR16 *InitrdPath; // Linux stub loader only
257 CHAR8 OSType;
258 } LOADER_ENTRY;
259
260 typedef struct {
261 REFIT_MENU_ENTRY me;
262 REFIT_VOLUME *Volume;
263 BDS_COMMON_OPTION *BdsOption;
264 CHAR16 *LoadOptions;
265 BOOLEAN Enabled;
266 } LEGACY_ENTRY;
267
268 typedef struct {
269 BOOLEAN TextOnly;
270 BOOLEAN ScanAllLinux;
271 BOOLEAN DeepLegacyScan;
272 BOOLEAN EnableAndLockVMX;
273 UINTN RequestedScreenWidth;
274 UINTN RequestedScreenHeight;
275 UINTN BannerBottomEdge;
276 UINTN RequestedTextMode;
277 UINTN Timeout;
278 UINTN HideUIFlags;
279 UINTN MaxTags; // max. number of OS entries to show simultaneously in graphics mode
280 UINTN GraphicsFor;
281 UINTN LegacyType;
282 UINTN ScanDelay;
283 UINTN ScreensaverTime;
284 UINTN IconSizes[3];
285 UINTN BannerScale;
286 CHAR16 *BannerFileName;
287 EG_IMAGE *ScreenBackground;
288 CHAR16 *ConfigFilename;
289 CHAR16 *SelectionSmallFileName;
290 CHAR16 *SelectionBigFileName;
291 CHAR16 *DefaultSelection;
292 CHAR16 *AlsoScan;
293 CHAR16 *DontScanVolumes;
294 CHAR16 *DontScanDirs;
295 CHAR16 *DontScanFiles;
296 CHAR16 *WindowsRecoveryFiles;
297 CHAR16 *DriverDirs;
298 CHAR16 *IconsDir;
299 UINTN ShowTools[NUM_TOOLS];
300 CHAR8 ScanFor[NUM_SCAN_OPTIONS]; // codes of types of loaders for which to scan
301 } REFIT_CONFIG;
302
303 // Global variables
304
305 extern EFI_HANDLE SelfImageHandle;
306 extern EFI_LOADED_IMAGE *SelfLoadedImage;
307 extern EFI_FILE *SelfRootDir;
308 extern EFI_FILE *SelfDir;
309 extern CHAR16 *SelfDirPath;
310
311 extern REFIT_VOLUME *SelfVolume;
312 extern REFIT_VOLUME **Volumes;
313 extern UINTN VolumesCount;
314
315 extern REFIT_CONFIG GlobalConfig;
316
317 extern EFI_GUID gEfiLegacyBootProtocolGuid;
318 extern EFI_GUID gEfiGlobalVariableGuid;
319
320 EFI_STATUS StartEFIImageList(IN EFI_DEVICE_PATH **DevicePaths,
321 IN CHAR16 *LoadOptions, IN UINTN LoaderType,
322 IN CHAR16 *ImageTitle, IN CHAR8 OSType,
323 OUT UINTN *ErrorInStep,
324 IN BOOLEAN Verbose,
325 IN BOOLEAN IsDriver);
326 LOADER_ENTRY *InitializeLoaderEntry(IN LOADER_ENTRY *Entry);
327 REFIT_MENU_SCREEN *InitializeSubScreen(IN LOADER_ENTRY *Entry);
328 VOID GenerateSubScreen(LOADER_ENTRY *Entry, IN REFIT_VOLUME *Volume);
329 EG_IMAGE * GetDiskBadge(IN UINTN DiskType);
330 LOADER_ENTRY * MakeGenericLoaderEntry(VOID);
331 LOADER_ENTRY * AddLoaderEntry(IN CHAR16 *LoaderPath, IN CHAR16 *LoaderTitle, IN REFIT_VOLUME *Volume);
332 VOID SetLoaderDefaults(LOADER_ENTRY *Entry, CHAR16 *LoaderPath, IN REFIT_VOLUME *Volume);
333 LOADER_ENTRY * AddPreparedLoaderEntry(LOADER_ENTRY *Entry);
334 VOID StoreLoaderName(IN CHAR16 *Name);
335
336 #endif
337
338 /* EOF */