2 Provide boot option support for Application "BootMaint"
4 Include file system navigation, system handle selection
6 Boot option manipulation
8 Copyright (c) 2004 - 2010, Intel Corporation. All rights reserved.<BR>
9 This program and the accompanying materials
10 are licensed and made available under the terms and conditions of the BSD License
11 which accompanies this distribution. The full text of the license may be found at
12 http://opensource.org/licenses/bsd-license.php
14 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
15 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
19 #include "BootMaint.h"
20 #include "BBSsupport.h"
23 Create a menu entry by given menu type.
25 @param MenuType The Menu type to be created.
27 @retval NULL If failed to create the menu.
28 @return the new menu entry.
32 BOpt_CreateMenuEntry (
36 BM_MENU_ENTRY
*MenuEntry
;
40 // Get context size according to menu type
43 case BM_LOAD_CONTEXT_SELECT
:
44 ContextSize
= sizeof (BM_LOAD_CONTEXT
);
47 case BM_FILE_CONTEXT_SELECT
:
48 ContextSize
= sizeof (BM_FILE_CONTEXT
);
51 case BM_CONSOLE_CONTEXT_SELECT
:
52 ContextSize
= sizeof (BM_CONSOLE_CONTEXT
);
55 case BM_TERMINAL_CONTEXT_SELECT
:
56 ContextSize
= sizeof (BM_TERMINAL_CONTEXT
);
59 case BM_HANDLE_CONTEXT_SELECT
:
60 ContextSize
= sizeof (BM_HANDLE_CONTEXT
);
63 case BM_LEGACY_DEV_CONTEXT_SELECT
:
64 ContextSize
= sizeof (BM_LEGACY_DEVICE_CONTEXT
);
72 if (ContextSize
== 0) {
77 // Create new menu entry
79 MenuEntry
= AllocateZeroPool (sizeof (BM_MENU_ENTRY
));
80 if (MenuEntry
== NULL
) {
84 MenuEntry
->VariableContext
= AllocateZeroPool (ContextSize
);
85 if (MenuEntry
->VariableContext
== NULL
) {
90 MenuEntry
->Signature
= BM_MENU_ENTRY_SIGNATURE
;
91 MenuEntry
->ContextSelection
= MenuType
;
96 Free up all resource allocated for a BM_MENU_ENTRY.
98 @param MenuEntry A pointer to BM_MENU_ENTRY.
102 BOpt_DestroyMenuEntry (
103 BM_MENU_ENTRY
*MenuEntry
106 BM_LOAD_CONTEXT
*LoadContext
;
107 BM_FILE_CONTEXT
*FileContext
;
108 BM_CONSOLE_CONTEXT
*ConsoleContext
;
109 BM_TERMINAL_CONTEXT
*TerminalContext
;
110 BM_HANDLE_CONTEXT
*HandleContext
;
111 BM_LEGACY_DEVICE_CONTEXT
*LegacyDevContext
;
114 // Select by the type in Menu entry for current context type
116 switch (MenuEntry
->ContextSelection
) {
117 case BM_LOAD_CONTEXT_SELECT
:
118 LoadContext
= (BM_LOAD_CONTEXT
*) MenuEntry
->VariableContext
;
119 FreePool (LoadContext
->FilePathList
);
120 FreePool (LoadContext
->LoadOption
);
121 if (LoadContext
->OptionalData
!= NULL
) {
122 FreePool (LoadContext
->OptionalData
);
124 FreePool (LoadContext
);
127 case BM_FILE_CONTEXT_SELECT
:
128 FileContext
= (BM_FILE_CONTEXT
*) MenuEntry
->VariableContext
;
130 if (!FileContext
->IsRoot
) {
131 FreePool (FileContext
->DevicePath
);
133 if (FileContext
->FHandle
!= NULL
) {
134 FileContext
->FHandle
->Close (FileContext
->FHandle
);
138 if (FileContext
->FileName
!= NULL
) {
139 FreePool (FileContext
->FileName
);
141 if (FileContext
->Info
!= NULL
) {
142 FreePool (FileContext
->Info
);
144 FreePool (FileContext
);
147 case BM_CONSOLE_CONTEXT_SELECT
:
148 ConsoleContext
= (BM_CONSOLE_CONTEXT
*) MenuEntry
->VariableContext
;
149 FreePool (ConsoleContext
->DevicePath
);
150 FreePool (ConsoleContext
);
153 case BM_TERMINAL_CONTEXT_SELECT
:
154 TerminalContext
= (BM_TERMINAL_CONTEXT
*) MenuEntry
->VariableContext
;
155 FreePool (TerminalContext
->DevicePath
);
156 FreePool (TerminalContext
);
159 case BM_HANDLE_CONTEXT_SELECT
:
160 HandleContext
= (BM_HANDLE_CONTEXT
*) MenuEntry
->VariableContext
;
161 FreePool (HandleContext
);
164 case BM_LEGACY_DEV_CONTEXT_SELECT
:
165 LegacyDevContext
= (BM_LEGACY_DEVICE_CONTEXT
*) MenuEntry
->VariableContext
;
166 FreePool (LegacyDevContext
);
172 FreePool (MenuEntry
->DisplayString
);
173 if (MenuEntry
->HelpString
!= NULL
) {
174 FreePool (MenuEntry
->HelpString
);
177 FreePool (MenuEntry
);
181 Get the Menu Entry from the list in Menu Entry List.
183 If MenuNumber is great or equal to the number of Menu
184 Entry in the list, then ASSERT.
186 @param MenuOption The Menu Entry List to read the menu entry.
187 @param MenuNumber The index of Menu Entry.
189 @return The Menu Entry.
194 BM_MENU_OPTION
*MenuOption
,
198 BM_MENU_ENTRY
*NewMenuEntry
;
202 ASSERT (MenuNumber
< MenuOption
->MenuNumber
);
204 List
= MenuOption
->Head
.ForwardLink
;
205 for (Index
= 0; Index
< MenuNumber
; Index
++) {
206 List
= List
->ForwardLink
;
209 NewMenuEntry
= CR (List
, BM_MENU_ENTRY
, Link
, BM_MENU_ENTRY_SIGNATURE
);
215 This function build the FsOptionMenu list which records all
216 available file system in the system. They includes all instances
217 of EFI_SIMPLE_FILE_SYSTEM_PROTOCOL, all instances of EFI_LOAD_FILE_SYSTEM
218 and all type of legacy boot device.
220 @param CallbackData BMM context data
222 @retval EFI_SUCCESS Success find the file system
223 @retval EFI_OUT_OF_RESOURCES Can not create menu entry
227 BOpt_FindFileSystem (
228 IN BMM_CALLBACK_DATA
*CallbackData
231 UINTN NoBlkIoHandles
;
232 UINTN NoSimpleFsHandles
;
233 UINTN NoLoadFileHandles
;
234 EFI_HANDLE
*BlkIoHandle
;
235 EFI_HANDLE
*SimpleFsHandle
;
236 EFI_HANDLE
*LoadFileHandle
;
238 EFI_BLOCK_IO_PROTOCOL
*BlkIo
;
241 BM_MENU_ENTRY
*MenuEntry
;
242 BM_FILE_CONTEXT
*FileContext
;
246 EFI_LEGACY_BIOS_PROTOCOL
*LegacyBios
;
248 BBS_BBS_DEVICE_PATH BbsDevicePathNode
;
249 EFI_DEVICE_PATH_PROTOCOL
*DevicePath
;
250 BOOLEAN RemovableMedia
;
253 NoSimpleFsHandles
= 0;
254 NoLoadFileHandles
= 0;
256 InitializeListHead (&FsOptionMenu
.Head
);
259 // Locate Handles that support BlockIo protocol
261 Status
= gBS
->LocateHandleBuffer (
263 &gEfiBlockIoProtocolGuid
,
268 if (!EFI_ERROR (Status
)) {
270 for (Index
= 0; Index
< NoBlkIoHandles
; Index
++) {
271 Status
= gBS
->HandleProtocol (
273 &gEfiBlockIoProtocolGuid
,
277 if (EFI_ERROR (Status
)) {
282 // Issue a dummy read to trigger reinstall of BlockIo protocol for removable media
284 if (BlkIo
->Media
->RemovableMedia
) {
285 Buffer
= AllocateZeroPool (BlkIo
->Media
->BlockSize
);
286 if (NULL
== Buffer
) {
287 FreePool (BlkIoHandle
);
288 return EFI_OUT_OF_RESOURCES
;
293 BlkIo
->Media
->MediaId
,
295 BlkIo
->Media
->BlockSize
,
301 FreePool (BlkIoHandle
);
305 // Locate Handles that support Simple File System protocol
307 Status
= gBS
->LocateHandleBuffer (
309 &gEfiSimpleFileSystemProtocolGuid
,
314 if (!EFI_ERROR (Status
)) {
316 // Find all the instances of the File System prototocol
318 for (Index
= 0; Index
< NoSimpleFsHandles
; Index
++) {
319 Status
= gBS
->HandleProtocol (
320 SimpleFsHandle
[Index
],
321 &gEfiBlockIoProtocolGuid
,
324 if (EFI_ERROR (Status
)) {
326 // If no block IO exists assume it's NOT a removable media
328 RemovableMedia
= FALSE
;
331 // If block IO exists check to see if it's remobable media
333 RemovableMedia
= BlkIo
->Media
->RemovableMedia
;
337 // Allocate pool for this load option
339 MenuEntry
= BOpt_CreateMenuEntry (BM_FILE_CONTEXT_SELECT
);
340 if (NULL
== MenuEntry
) {
341 FreePool (SimpleFsHandle
);
342 return EFI_OUT_OF_RESOURCES
;
345 FileContext
= (BM_FILE_CONTEXT
*) MenuEntry
->VariableContext
;
347 FileContext
->Handle
= SimpleFsHandle
[Index
];
348 MenuEntry
->OptionNumber
= Index
;
349 FileContext
->FHandle
= EfiLibOpenRoot (FileContext
->Handle
);
350 if (FileContext
->FHandle
== NULL
) {
351 BOpt_DestroyMenuEntry (MenuEntry
);
355 MenuEntry
->HelpString
= DevicePathToStr (DevicePathFromHandle (FileContext
->Handle
));
356 FileContext
->Info
= EfiLibFileSystemVolumeLabelInfo (FileContext
->FHandle
);
357 FileContext
->FileName
= EfiStrDuplicate (L
"\\");
358 FileContext
->DevicePath
= FileDevicePath (
360 FileContext
->FileName
362 FileContext
->IsDir
= TRUE
;
363 FileContext
->IsRoot
= TRUE
;
364 FileContext
->IsRemovableMedia
= RemovableMedia
;
365 FileContext
->IsLoadFile
= FALSE
;
368 // Get current file system's Volume Label
370 if (FileContext
->Info
== NULL
) {
371 VolumeLabel
= L
"NO FILE SYSTEM INFO";
373 if (FileContext
->Info
->VolumeLabel
== NULL
) {
374 VolumeLabel
= L
"NULL VOLUME LABEL";
376 VolumeLabel
= FileContext
->Info
->VolumeLabel
;
377 if (*VolumeLabel
== 0x0000) {
378 VolumeLabel
= L
"NO VOLUME LABEL";
383 TempStr
= MenuEntry
->HelpString
;
384 MenuEntry
->DisplayString
= AllocateZeroPool (MAX_CHAR
);
385 ASSERT (MenuEntry
->DisplayString
!= NULL
);
387 MenuEntry
->DisplayString
,
394 InsertTailList (&FsOptionMenu
.Head
, &MenuEntry
->Link
);
398 if (NoSimpleFsHandles
!= 0) {
399 FreePool (SimpleFsHandle
);
402 // Searching for handles that support Load File protocol
404 Status
= gBS
->LocateHandleBuffer (
406 &gEfiLoadFileProtocolGuid
,
412 if (!EFI_ERROR (Status
)) {
413 for (Index
= 0; Index
< NoLoadFileHandles
; Index
++) {
414 MenuEntry
= BOpt_CreateMenuEntry (BM_FILE_CONTEXT_SELECT
);
415 if (NULL
== MenuEntry
) {
416 FreePool (LoadFileHandle
);
417 return EFI_OUT_OF_RESOURCES
;
420 FileContext
= (BM_FILE_CONTEXT
*) MenuEntry
->VariableContext
;
421 FileContext
->IsRemovableMedia
= FALSE
;
422 FileContext
->IsLoadFile
= TRUE
;
423 FileContext
->Handle
= LoadFileHandle
[Index
];
424 FileContext
->IsRoot
= TRUE
;
426 FileContext
->DevicePath
= DevicePathFromHandle (FileContext
->Handle
);
427 FileContext
->FileName
= DevicePathToStr (FileContext
->DevicePath
);
429 MenuEntry
->HelpString
= DevicePathToStr (FileContext
->DevicePath
);
431 TempStr
= MenuEntry
->HelpString
;
432 MenuEntry
->DisplayString
= AllocateZeroPool (MAX_CHAR
);
433 ASSERT (MenuEntry
->DisplayString
!= NULL
);
435 MenuEntry
->DisplayString
,
441 MenuEntry
->OptionNumber
= OptionNumber
;
443 InsertTailList (&FsOptionMenu
.Head
, &MenuEntry
->Link
);
447 if (NoLoadFileHandles
!= 0) {
448 FreePool (LoadFileHandle
);
452 // Add Legacy Boot Option Support Here
454 Status
= gBS
->LocateProtocol (
455 &gEfiLegacyBiosProtocolGuid
,
457 (VOID
**) &LegacyBios
459 if (!EFI_ERROR (Status
)) {
461 for (Index
= BBS_TYPE_FLOPPY
; Index
<= BBS_TYPE_EMBEDDED_NETWORK
; Index
++) {
462 MenuEntry
= BOpt_CreateMenuEntry (BM_FILE_CONTEXT_SELECT
);
463 if (NULL
== MenuEntry
) {
464 return EFI_OUT_OF_RESOURCES
;
467 FileContext
= (BM_FILE_CONTEXT
*) MenuEntry
->VariableContext
;
469 FileContext
->IsRemovableMedia
= FALSE
;
470 FileContext
->IsLoadFile
= TRUE
;
471 FileContext
->IsBootLegacy
= TRUE
;
472 DeviceType
= (UINT16
) Index
;
473 BbsDevicePathNode
.Header
.Type
= BBS_DEVICE_PATH
;
474 BbsDevicePathNode
.Header
.SubType
= BBS_BBS_DP
;
475 SetDevicePathNodeLength (
476 &BbsDevicePathNode
.Header
,
477 sizeof (BBS_BBS_DEVICE_PATH
)
479 BbsDevicePathNode
.DeviceType
= DeviceType
;
480 BbsDevicePathNode
.StatusFlag
= 0;
481 BbsDevicePathNode
.String
[0] = 0;
482 DevicePath
= AppendDevicePathNode (
484 (EFI_DEVICE_PATH_PROTOCOL
*) &BbsDevicePathNode
487 FileContext
->DevicePath
= DevicePath
;
488 MenuEntry
->HelpString
= DevicePathToStr (FileContext
->DevicePath
);
490 TempStr
= MenuEntry
->HelpString
;
491 MenuEntry
->DisplayString
= AllocateZeroPool (MAX_CHAR
);
492 ASSERT (MenuEntry
->DisplayString
!= NULL
);
494 MenuEntry
->DisplayString
,
499 MenuEntry
->OptionNumber
= OptionNumber
;
501 InsertTailList (&FsOptionMenu
.Head
, &MenuEntry
->Link
);
505 // Remember how many file system options are here
507 FsOptionMenu
.MenuNumber
= OptionNumber
;
512 Free resources allocated in Allocate Rountine.
514 @param FreeMenu Menu to be freed
518 BM_MENU_OPTION
*FreeMenu
521 BM_MENU_ENTRY
*MenuEntry
;
522 while (!IsListEmpty (&FreeMenu
->Head
)) {
524 FreeMenu
->Head
.ForwardLink
,
527 BM_MENU_ENTRY_SIGNATURE
529 RemoveEntryList (&MenuEntry
->Link
);
530 BOpt_DestroyMenuEntry (MenuEntry
);
535 Find files under current directory
536 All files and sub-directories in current directory
537 will be stored in DirectoryMenu for future use.
539 @param CallbackData The BMM context data.
540 @param MenuEntry The Menu Entry.
542 @retval EFI_SUCCESS Get files from current dir successfully.
543 @return Other value if can't get files from current dir.
548 IN BMM_CALLBACK_DATA
*CallbackData
,
549 IN BM_MENU_ENTRY
*MenuEntry
552 EFI_FILE_HANDLE NewDir
;
554 EFI_FILE_INFO
*DirInfo
;
557 BM_MENU_ENTRY
*NewMenuEntry
;
558 BM_FILE_CONTEXT
*FileContext
;
559 BM_FILE_CONTEXT
*NewFileContext
;
564 FileContext
= (BM_FILE_CONTEXT
*) MenuEntry
->VariableContext
;
565 Dir
= FileContext
->FHandle
;
568 // Open current directory to get files from it
573 FileContext
->FileName
,
577 if (!FileContext
->IsRoot
) {
581 if (EFI_ERROR (Status
)) {
585 DirInfo
= EfiLibFileInfo (NewDir
);
586 if (DirInfo
== NULL
) {
587 return EFI_NOT_FOUND
;
590 if ((DirInfo
->Attribute
& EFI_FILE_DIRECTORY
) == 0) {
591 return EFI_INVALID_PARAMETER
;
594 FileContext
->DevicePath
= FileDevicePath (
596 FileContext
->FileName
599 DirBufferSize
= sizeof (EFI_FILE_INFO
) + 1024;
600 DirInfo
= AllocateZeroPool (DirBufferSize
);
601 if (DirInfo
== NULL
) {
602 return EFI_OUT_OF_RESOURCES
;
605 // Get all files in current directory
606 // Pass 1 to get Directories
607 // Pass 2 to get files that are EFI images
609 for (Pass
= 1; Pass
<= 2; Pass
++) {
610 NewDir
->SetPosition (NewDir
, 0);
612 BufferSize
= DirBufferSize
;
613 Status
= NewDir
->Read (NewDir
, &BufferSize
, DirInfo
);
614 if (EFI_ERROR (Status
) || BufferSize
== 0) {
618 if (((DirInfo
->Attribute
& EFI_FILE_DIRECTORY
) != 0 && Pass
== 2) ||
619 ((DirInfo
->Attribute
& EFI_FILE_DIRECTORY
) == 0 && Pass
== 1)
622 // Pass 1 is for Directories
623 // Pass 2 is for file names
628 if (!(BOpt_IsEfiImageName (DirInfo
->FileName
) || (DirInfo
->Attribute
& EFI_FILE_DIRECTORY
) != 0)) {
630 // Slip file unless it is a directory entry or a .EFI file
635 NewMenuEntry
= BOpt_CreateMenuEntry (BM_FILE_CONTEXT_SELECT
);
636 if (NULL
== NewMenuEntry
) {
637 return EFI_OUT_OF_RESOURCES
;
640 NewFileContext
= (BM_FILE_CONTEXT
*) NewMenuEntry
->VariableContext
;
641 NewFileContext
->Handle
= FileContext
->Handle
;
642 NewFileContext
->FileName
= BOpt_AppendFileName (
643 FileContext
->FileName
,
646 NewFileContext
->FHandle
= NewDir
;
647 NewFileContext
->DevicePath
= FileDevicePath (
648 NewFileContext
->Handle
,
649 NewFileContext
->FileName
651 NewMenuEntry
->HelpString
= NULL
;
653 MenuEntry
->DisplayStringToken
= GetStringTokenFromDepository (
655 FileOptionStrDepository
658 NewFileContext
->IsDir
= (BOOLEAN
) ((DirInfo
->Attribute
& EFI_FILE_DIRECTORY
) == EFI_FILE_DIRECTORY
);
660 if (NewFileContext
->IsDir
) {
661 BufferSize
= StrLen (DirInfo
->FileName
) * 2 + 6;
662 NewMenuEntry
->DisplayString
= AllocateZeroPool (BufferSize
);
665 NewMenuEntry
->DisplayString
,
672 NewMenuEntry
->DisplayString
= EfiStrDuplicate (DirInfo
->FileName
);
675 NewFileContext
->IsRoot
= FALSE
;
676 NewFileContext
->IsLoadFile
= FALSE
;
677 NewFileContext
->IsRemovableMedia
= FALSE
;
679 NewMenuEntry
->OptionNumber
= OptionNumber
;
681 InsertTailList (&DirectoryMenu
.Head
, &NewMenuEntry
->Link
);
685 DirectoryMenu
.MenuNumber
= OptionNumber
;
691 Build the LegacyFDMenu LegacyHDMenu LegacyCDMenu according to LegacyBios.GetBbsInfo().
693 @retval EFI_SUCCESS The function complete successfully.
694 @retval EFI_OUT_OF_RESOURCES No enough memory to complete this function.
698 BOpt_GetLegacyOptions (
702 BM_MENU_ENTRY
*NewMenuEntry
;
703 BM_LEGACY_DEVICE_CONTEXT
*NewLegacyDevContext
;
705 EFI_LEGACY_BIOS_PROTOCOL
*LegacyBios
;
711 CHAR16 DescString
[100];
724 // Initialize Bbs Table Context from BBS info data
726 InitializeListHead (&LegacyFDMenu
.Head
);
727 InitializeListHead (&LegacyHDMenu
.Head
);
728 InitializeListHead (&LegacyCDMenu
.Head
);
729 InitializeListHead (&LegacyNETMenu
.Head
);
730 InitializeListHead (&LegacyBEVMenu
.Head
);
732 Status
= gBS
->LocateProtocol (
733 &gEfiLegacyBiosProtocolGuid
,
735 (VOID
**) &LegacyBios
737 if (!EFI_ERROR (Status
)) {
738 Status
= LegacyBios
->GetBbsInfo (
745 if (EFI_ERROR (Status
)) {
756 for (Index
= 0; Index
< BbsCount
; Index
++) {
757 if ((BBS_IGNORE_ENTRY
== BbsTable
[Index
].BootPriority
) ||
758 (BBS_DO_NOT_BOOT_FROM
== BbsTable
[Index
].BootPriority
)
763 NewMenuEntry
= BOpt_CreateMenuEntry (BM_LEGACY_DEV_CONTEXT_SELECT
);
764 if (NULL
== NewMenuEntry
) {
768 NewLegacyDevContext
= (BM_LEGACY_DEVICE_CONTEXT
*) NewMenuEntry
->VariableContext
;
769 NewLegacyDevContext
->BbsTable
= &BbsTable
[Index
];
770 NewLegacyDevContext
->Index
= Index
;
771 NewLegacyDevContext
->BbsCount
= BbsCount
;
772 BdsBuildLegacyDevNameString (
778 NewLegacyDevContext
->Description
= AllocateZeroPool (StrSize (DescString
));
779 if (NULL
== NewLegacyDevContext
->Description
) {
783 CopyMem (NewLegacyDevContext
->Description
, DescString
, StrSize (DescString
));
784 NewMenuEntry
->DisplayString
= NewLegacyDevContext
->Description
;
785 NewMenuEntry
->HelpString
= NULL
;
787 switch (BbsTable
[Index
].DeviceType
) {
789 InsertTailList (&LegacyFDMenu
.Head
, &NewMenuEntry
->Link
);
794 InsertTailList (&LegacyHDMenu
.Head
, &NewMenuEntry
->Link
);
799 InsertTailList (&LegacyCDMenu
.Head
, &NewMenuEntry
->Link
);
803 case BBS_EMBED_NETWORK
:
804 InsertTailList (&LegacyNETMenu
.Head
, &NewMenuEntry
->Link
);
809 InsertTailList (&LegacyBEVMenu
.Head
, &NewMenuEntry
->Link
);
815 if (Index
!= BbsCount
) {
816 BOpt_FreeLegacyOptions ();
817 return EFI_OUT_OF_RESOURCES
;
820 LegacyFDMenu
.MenuNumber
= FDNum
;
821 LegacyHDMenu
.MenuNumber
= HDNum
;
822 LegacyCDMenu
.MenuNumber
= CDNum
;
823 LegacyNETMenu
.MenuNumber
= NETNum
;
824 LegacyBEVMenu
.MenuNumber
= BEVNum
;
829 Free out resouce allocated from Legacy Boot Options.
833 BOpt_FreeLegacyOptions (
837 BOpt_FreeMenu (&LegacyFDMenu
);
838 BOpt_FreeMenu (&LegacyHDMenu
);
839 BOpt_FreeMenu (&LegacyCDMenu
);
840 BOpt_FreeMenu (&LegacyNETMenu
);
841 BOpt_FreeMenu (&LegacyBEVMenu
);
846 Build the BootOptionMenu according to BootOrder Variable.
847 This Routine will access the Boot#### to get EFI_LOAD_OPTION.
849 @param CallbackData The BMM context data.
851 @return EFI_NOT_FOUND Fail to find "BootOrder" variable.
852 @return EFI_SUCESS Success build boot option menu.
856 BOpt_GetBootOptions (
857 IN BMM_CALLBACK_DATA
*CallbackData
861 UINT16 BootString
[10];
862 UINT8
*LoadOptionFromVar
;
864 UINTN BootOptionSize
;
865 BOOLEAN BootNextFlag
;
866 UINT16
*BootOrderList
;
867 UINTN BootOrderListSize
;
870 BM_MENU_ENTRY
*NewMenuEntry
;
871 BM_LOAD_CONTEXT
*NewLoadContext
;
872 UINT8
*LoadOptionPtr
;
874 UINTN OptionalDataSize
;
875 UINT8
*LoadOptionEnd
;
876 EFI_DEVICE_PATH_PROTOCOL
*DevicePath
;
881 BootOrderListSize
= 0;
883 BootOrderList
= NULL
;
885 LoadOptionFromVar
= NULL
;
886 BOpt_FreeMenu (&BootOptionMenu
);
887 InitializeListHead (&BootOptionMenu
.Head
);
890 // Get the BootOrder from the Var
892 BootOrderList
= BdsLibGetVariableAndSize (
894 &gEfiGlobalVariableGuid
,
897 if (BootOrderList
== NULL
) {
898 return EFI_NOT_FOUND
;
902 // Get the BootNext from the Var
904 BootNext
= BdsLibGetVariableAndSize (
906 &gEfiGlobalVariableGuid
,
910 if (BootNext
!= NULL
) {
911 if (BootNextSize
!= sizeof (UINT16
)) {
917 for (Index
= 0; Index
< BootOrderListSize
/ sizeof (UINT16
); Index
++) {
918 UnicodeSPrint (BootString
, sizeof (BootString
), L
"Boot%04x", BootOrderList
[Index
]);
920 // Get all loadoptions from the VAR
922 LoadOptionFromVar
= BdsLibGetVariableAndSize (
924 &gEfiGlobalVariableGuid
,
927 if (LoadOptionFromVar
== NULL
) {
931 LoadOption
= AllocateZeroPool (BootOptionSize
);
932 if (LoadOption
== NULL
) {
936 CopyMem (LoadOption
, LoadOptionFromVar
, BootOptionSize
);
937 FreePool (LoadOptionFromVar
);
939 if (BootNext
!= NULL
) {
940 BootNextFlag
= (BOOLEAN
) (*BootNext
== BootOrderList
[Index
]);
942 BootNextFlag
= FALSE
;
945 if (0 == (*((UINT32
*) LoadOption
) & LOAD_OPTION_ACTIVE
)) {
946 FreePool (LoadOption
);
950 // BUGBUG: could not return EFI_OUT_OF_RESOURCES here directly.
951 // the buffer allocated already should be freed before returning.
953 NewMenuEntry
= BOpt_CreateMenuEntry (BM_LOAD_CONTEXT_SELECT
);
954 if (NULL
== NewMenuEntry
) {
955 return EFI_OUT_OF_RESOURCES
;
958 NewLoadContext
= (BM_LOAD_CONTEXT
*) NewMenuEntry
->VariableContext
;
960 LoadOptionPtr
= LoadOption
;
961 LoadOptionEnd
= LoadOption
+ BootOptionSize
;
963 NewMenuEntry
->OptionNumber
= BootOrderList
[Index
];
964 NewLoadContext
->LoadOptionModified
= FALSE
;
965 NewLoadContext
->Deleted
= FALSE
;
966 NewLoadContext
->IsBootNext
= BootNextFlag
;
969 // Is a Legacy Device?
971 Ptr
= (UINT8
*) LoadOption
;
974 // Attribute = *(UINT32 *)Ptr;
976 Ptr
+= sizeof (UINT32
);
979 // FilePathSize = *(UINT16 *)Ptr;
981 Ptr
+= sizeof (UINT16
);
984 // Description = (CHAR16 *)Ptr;
986 Ptr
+= StrSize ((CHAR16
*) Ptr
);
989 // Now Ptr point to Device Path
991 DevicePath
= (EFI_DEVICE_PATH_PROTOCOL
*) Ptr
;
992 if ((BBS_DEVICE_PATH
== DevicePath
->Type
) && (BBS_BBS_DP
== DevicePath
->SubType
)) {
993 NewLoadContext
->IsLegacy
= TRUE
;
995 NewLoadContext
->IsLegacy
= FALSE
;
998 // LoadOption is a pointer type of UINT8
999 // for easy use with following LOAD_OPTION
1000 // embedded in this struct
1002 NewLoadContext
->LoadOption
= LoadOption
;
1003 NewLoadContext
->LoadOptionSize
= BootOptionSize
;
1005 NewLoadContext
->Attributes
= *(UINT32
*) LoadOptionPtr
;
1006 NewLoadContext
->IsActive
= (BOOLEAN
) (NewLoadContext
->Attributes
& LOAD_OPTION_ACTIVE
);
1008 NewLoadContext
->ForceReconnect
= (BOOLEAN
) (NewLoadContext
->Attributes
& LOAD_OPTION_FORCE_RECONNECT
);
1010 LoadOptionPtr
+= sizeof (UINT32
);
1012 NewLoadContext
->FilePathListLength
= *(UINT16
*) LoadOptionPtr
;
1013 LoadOptionPtr
+= sizeof (UINT16
);
1015 StringSize
= StrSize((UINT16
*)LoadOptionPtr
);
1017 NewLoadContext
->Description
= AllocateZeroPool (StrSize((UINT16
*)LoadOptionPtr
));
1018 ASSERT (NewLoadContext
->Description
!= NULL
);
1019 StrCpy (NewLoadContext
->Description
, (UINT16
*)LoadOptionPtr
);
1021 ASSERT (NewLoadContext
->Description
!= NULL
);
1022 NewMenuEntry
->DisplayString
= NewLoadContext
->Description
;
1024 LoadOptionPtr
+= StringSize
;
1026 NewLoadContext
->FilePathList
= AllocateZeroPool (NewLoadContext
->FilePathListLength
);
1027 ASSERT (NewLoadContext
->FilePathList
!= NULL
);
1029 NewLoadContext
->FilePathList
,
1030 (EFI_DEVICE_PATH_PROTOCOL
*) LoadOptionPtr
,
1031 NewLoadContext
->FilePathListLength
1034 NewMenuEntry
->HelpString
= DevicePathToStr (NewLoadContext
->FilePathList
);
1035 NewMenuEntry
->DisplayStringToken
= GetStringTokenFromDepository (
1037 BootOptionStrDepository
1039 NewMenuEntry
->HelpStringToken
= GetStringTokenFromDepository (
1041 BootOptionHelpStrDepository
1043 LoadOptionPtr
+= NewLoadContext
->FilePathListLength
;
1045 if (LoadOptionPtr
< LoadOptionEnd
) {
1046 OptionalDataSize
= BootOptionSize
-
1050 NewLoadContext
->FilePathListLength
;
1052 NewLoadContext
->OptionalData
= AllocateZeroPool (OptionalDataSize
);
1053 ASSERT (NewLoadContext
->OptionalData
!= NULL
);
1055 NewLoadContext
->OptionalData
,
1060 NewLoadContext
->OptionalDataSize
= OptionalDataSize
;
1063 InsertTailList (&BootOptionMenu
.Head
, &NewMenuEntry
->Link
);
1067 if (BootNext
!= NULL
) {
1068 FreePool (BootNext
);
1070 if (BootOrderList
!= NULL
) {
1071 FreePool (BootOrderList
);
1073 BootOptionMenu
.MenuNumber
= MenuCount
;
1079 Append file name to existing file name.
1081 @param Str1 The existing file name
1082 @param Str2 The file name to be appended
1084 @return Allocate a new string to hold the appended result.
1085 Caller is responsible to free the returned string.
1089 BOpt_AppendFileName (
1101 Size1
= StrSize (Str1
);
1102 Size2
= StrSize (Str2
);
1103 Str
= AllocateZeroPool (Size1
+ Size2
+ sizeof (CHAR16
));
1104 ASSERT (Str
!= NULL
);
1106 TmpStr
= AllocateZeroPool (Size1
+ Size2
+ sizeof (CHAR16
));
1107 ASSERT (TmpStr
!= NULL
);
1110 if (!((*Str
== '\\') && (*(Str
+ 1) == 0))) {
1111 StrCat (Str
, L
"\\");
1119 if (*Ptr
== '\\' && *(Ptr
+ 1) == '.' && *(Ptr
+ 2) == '.' && *(Ptr
+ 3) == L
'\\') {
1121 // Convert "\Name\..\" to "\"
1122 // DO NOT convert the .. if it is at the end of the string. This will
1123 // break the .. behavior in changing directories.
1127 // Use TmpStr as a backup, as StrCpy in BaseLib does not handle copy of two strings
1130 StrCpy (TmpStr
, Ptr
+ 3);
1131 StrCpy (LastSlash
, TmpStr
);
1133 } else if (*Ptr
== '\\' && *(Ptr
+ 1) == '.' && *(Ptr
+ 2) == '\\') {
1135 // Convert a "\.\" to a "\"
1139 // Use TmpStr as a backup, as StrCpy in BaseLib does not handle copy of two strings
1142 StrCpy (TmpStr
, Ptr
+ 2);
1143 StrCpy (Ptr
, TmpStr
);
1145 } else if (*Ptr
== '\\') {
1159 Check whether current FileName point to a valid
1162 @param FileName File need to be checked.
1164 @retval TRUE Is Efi Image
1165 @retval FALSE Not a valid Efi Image
1169 BOpt_IsEfiImageName (
1174 // Search for ".efi" extension
1176 while (*FileName
!= L
'\0') {
1177 if (FileName
[0] == '.') {
1178 if (FileName
[1] == 'e' || FileName
[1] == 'E') {
1179 if (FileName
[2] == 'f' || FileName
[2] == 'F') {
1180 if (FileName
[3] == 'i' || FileName
[3] == 'I') {
1182 } else if (FileName
[3] == 0x0000) {
1185 } else if (FileName
[2] == 0x0000) {
1188 } else if (FileName
[1] == 0x0000) {
1201 Check whether current FileName point to a valid Efi Application
1203 @param Dir Pointer to current Directory
1204 @param FileName Pointer to current File name.
1206 @retval TRUE Is a valid Efi Application
1207 @retval FALSE not a valid Efi Application
1212 IN EFI_FILE_HANDLE Dir
,
1217 EFI_IMAGE_DOS_HEADER DosHdr
;
1219 EFI_FILE_HANDLE File
;
1221 EFI_IMAGE_OPTIONAL_HEADER_UNION PeHdr
;
1223 Status
= Dir
->Open (Dir
, &File
, FileName
, EFI_FILE_MODE_READ
, 0);
1225 if (EFI_ERROR (Status
)) {
1229 BufferSize
= sizeof (EFI_IMAGE_DOS_HEADER
);
1230 File
->Read (File
, &BufferSize
, &DosHdr
);
1231 if (DosHdr
.e_magic
!= EFI_IMAGE_DOS_SIGNATURE
) {
1236 File
->SetPosition (File
, DosHdr
.e_lfanew
);
1237 BufferSize
= sizeof (EFI_IMAGE_OPTIONAL_HEADER_UNION
);
1238 File
->Read (File
, &BufferSize
, &PeHdr
);
1239 if (PeHdr
.Pe32
.Signature
!= EFI_IMAGE_NT_SIGNATURE
) {
1244 // Determine PE type and read subsytem
1246 if (PeHdr
.Pe32
.OptionalHeader
.Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1247 Subsystem
= PeHdr
.Pe32
.OptionalHeader
.Subsystem
;
1248 } else if (PeHdr
.Pe32
.OptionalHeader
.Magic
== EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
) {
1249 Subsystem
= PeHdr
.Pe32Plus
.OptionalHeader
.Subsystem
;
1254 if (Subsystem
== EFI_IMAGE_SUBSYSTEM_EFI_APPLICATION
) {
1265 Find drivers that will be added as Driver#### variables from handles
1266 in current system environment
1267 All valid handles in the system except those consume SimpleFs, LoadFile
1268 are stored in DriverMenu for future use.
1270 @retval EFI_SUCCESS The function complets successfully.
1271 @return Other value if failed to build the DriverMenu.
1279 UINTN NoDevicePathHandles
;
1280 EFI_HANDLE
*DevicePathHandle
;
1283 BM_MENU_ENTRY
*NewMenuEntry
;
1284 BM_HANDLE_CONTEXT
*NewHandleContext
;
1285 EFI_HANDLE CurHandle
;
1287 EFI_SIMPLE_FILE_SYSTEM_PROTOCOL
*SimpleFs
;
1288 EFI_LOAD_FILE_PROTOCOL
*LoadFile
;
1293 InitializeListHead (&DriverMenu
.Head
);
1296 // At first, get all handles that support Device Path
1297 // protocol which is the basic requirement for
1300 Status
= gBS
->LocateHandleBuffer (
1302 &gEfiDevicePathProtocolGuid
,
1304 &NoDevicePathHandles
,
1307 if (EFI_ERROR (Status
)) {
1312 for (Index
= 0; Index
< NoDevicePathHandles
; Index
++) {
1313 CurHandle
= DevicePathHandle
[Index
];
1315 Status
= gBS
->HandleProtocol (
1317 &gEfiSimpleFileSystemProtocolGuid
,
1320 if (Status
== EFI_SUCCESS
) {
1324 Status
= gBS
->HandleProtocol (
1326 &gEfiLoadFileProtocolGuid
,
1329 if (Status
== EFI_SUCCESS
) {
1333 NewMenuEntry
= BOpt_CreateMenuEntry (BM_HANDLE_CONTEXT_SELECT
);
1334 if (NULL
== NewMenuEntry
) {
1335 FreePool (DevicePathHandle
);
1336 return EFI_OUT_OF_RESOURCES
;
1339 NewHandleContext
= (BM_HANDLE_CONTEXT
*) NewMenuEntry
->VariableContext
;
1340 NewHandleContext
->Handle
= CurHandle
;
1341 NewHandleContext
->DevicePath
= DevicePathFromHandle (CurHandle
);
1342 NewMenuEntry
->DisplayString
= DevicePathToStr (NewHandleContext
->DevicePath
);
1343 NewMenuEntry
->HelpString
= NULL
;
1344 NewMenuEntry
->OptionNumber
= OptionNumber
;
1346 InsertTailList (&DriverMenu
.Head
, &NewMenuEntry
->Link
);
1350 if (DevicePathHandle
!= NULL
) {
1351 FreePool (DevicePathHandle
);
1354 DriverMenu
.MenuNumber
= OptionNumber
;
1360 Get the Option Number that has not been allocated for use.
1362 @param Type The type of Option.
1364 @return The available Option Number.
1368 BOpt_GetOptionNumber (
1373 UINTN OrderListSize
;
1376 UINT16
*OptionBuffer
;
1377 UINT16 OptionNumber
;
1384 UnicodeSPrint (StrTemp
, sizeof (StrTemp
), L
"%sOrder", Type
);
1386 OrderList
= BdsLibGetVariableAndSize (
1388 &gEfiGlobalVariableGuid
,
1391 for (OptionNumber
= 0; ; OptionNumber
++) {
1392 for (Index
= 0; Index
< OrderListSize
/ sizeof (UINT16
); Index
++) {
1393 if (OptionNumber
== OrderList
[Index
]) {
1398 if (Index
< OrderListSize
/ sizeof (UINT16
)) {
1400 // The OptionNumber occurs in the OrderList, continue to use next one
1404 UnicodeSPrint (StrTemp
, sizeof (StrTemp
), L
"%s%04x", Type
, (UINTN
) OptionNumber
);
1405 DEBUG((EFI_D_ERROR
,"Option = %s\n", StrTemp
));
1406 OptionBuffer
= BdsLibGetVariableAndSize (
1408 &gEfiGlobalVariableGuid
,
1411 if (NULL
== OptionBuffer
) {
1413 // The Boot[OptionNumber] / Driver[OptionNumber] NOT occurs, we found it
1419 return OptionNumber
;
1424 Get the Option Number for Boot#### that does not used.
1426 @return The available Option Number.
1430 BOpt_GetBootOptionNumber (
1434 return BOpt_GetOptionNumber (L
"Boot");
1439 Get the Option Number for Driver#### that does not used.
1441 @return The unused Option Number.
1445 BOpt_GetDriverOptionNumber (
1449 return BOpt_GetOptionNumber (L
"Driver");
1454 Build up all DriverOptionMenu
1456 @param CallbackData The BMM context data.
1458 @retval EFI_SUCESS The functin completes successfully.
1459 @retval EFI_OUT_OF_RESOURCES Not enough memory to compete the operation.
1460 @retval EFI_NOT_FOUND Fail to get "DriverOrder" variable.
1464 BOpt_GetDriverOptions (
1465 IN BMM_CALLBACK_DATA
*CallbackData
1469 UINT16 DriverString
[12];
1470 UINT8
*LoadOptionFromVar
;
1472 UINTN DriverOptionSize
;
1474 UINT16
*DriverOrderList
;
1475 UINTN DriverOrderListSize
;
1476 BM_MENU_ENTRY
*NewMenuEntry
;
1477 BM_LOAD_CONTEXT
*NewLoadContext
;
1478 UINT8
*LoadOptionPtr
;
1480 UINTN OptionalDataSize
;
1481 UINT8
*LoadOptionEnd
;
1483 DriverOrderListSize
= 0;
1484 DriverOrderList
= NULL
;
1485 DriverOptionSize
= 0;
1486 LoadOptionFromVar
= NULL
;
1487 BOpt_FreeMenu (&DriverOptionMenu
);
1488 InitializeListHead (&DriverOptionMenu
.Head
);
1490 // Get the DriverOrder from the Var
1492 DriverOrderList
= BdsLibGetVariableAndSize (
1494 &gEfiGlobalVariableGuid
,
1495 &DriverOrderListSize
1497 if (DriverOrderList
== NULL
) {
1498 return EFI_NOT_FOUND
;
1501 for (Index
= 0; Index
< DriverOrderListSize
/ sizeof (UINT16
); Index
++) {
1504 sizeof (DriverString
),
1506 DriverOrderList
[Index
]
1509 // Get all loadoptions from the VAR
1511 LoadOptionFromVar
= BdsLibGetVariableAndSize (
1513 &gEfiGlobalVariableGuid
,
1516 if (LoadOptionFromVar
== NULL
) {
1520 LoadOption
= AllocateZeroPool (DriverOptionSize
);
1521 if (LoadOption
== NULL
) {
1525 CopyMem (LoadOption
, LoadOptionFromVar
, DriverOptionSize
);
1526 FreePool (LoadOptionFromVar
);
1528 NewMenuEntry
= BOpt_CreateMenuEntry (BM_LOAD_CONTEXT_SELECT
);
1529 if (NULL
== NewMenuEntry
) {
1530 return EFI_OUT_OF_RESOURCES
;
1533 NewLoadContext
= (BM_LOAD_CONTEXT
*) NewMenuEntry
->VariableContext
;
1534 LoadOptionPtr
= LoadOption
;
1535 LoadOptionEnd
= LoadOption
+ DriverOptionSize
;
1536 NewMenuEntry
->OptionNumber
= DriverOrderList
[Index
];
1537 NewLoadContext
->LoadOptionModified
= FALSE
;
1538 NewLoadContext
->Deleted
= FALSE
;
1539 NewLoadContext
->IsLegacy
= FALSE
;
1542 // LoadOption is a pointer type of UINT8
1543 // for easy use with following LOAD_OPTION
1544 // embedded in this struct
1546 NewLoadContext
->LoadOption
= LoadOption
;
1547 NewLoadContext
->LoadOptionSize
= DriverOptionSize
;
1549 NewLoadContext
->Attributes
= *(UINT32
*) LoadOptionPtr
;
1550 NewLoadContext
->IsActive
= (BOOLEAN
) (NewLoadContext
->Attributes
& LOAD_OPTION_ACTIVE
);
1552 NewLoadContext
->ForceReconnect
= (BOOLEAN
) (NewLoadContext
->Attributes
& LOAD_OPTION_FORCE_RECONNECT
);
1554 LoadOptionPtr
+= sizeof (UINT32
);
1556 NewLoadContext
->FilePathListLength
= *(UINT16
*) LoadOptionPtr
;
1557 LoadOptionPtr
+= sizeof (UINT16
);
1559 StringSize
= StrSize ((UINT16
*) LoadOptionPtr
);
1560 NewLoadContext
->Description
= AllocateZeroPool (StringSize
);
1561 ASSERT (NewLoadContext
->Description
!= NULL
);
1563 NewLoadContext
->Description
,
1564 (UINT16
*) LoadOptionPtr
,
1567 NewMenuEntry
->DisplayString
= NewLoadContext
->Description
;
1569 LoadOptionPtr
+= StringSize
;
1571 NewLoadContext
->FilePathList
= AllocateZeroPool (NewLoadContext
->FilePathListLength
);
1572 ASSERT (NewLoadContext
->FilePathList
!= NULL
);
1574 NewLoadContext
->FilePathList
,
1575 (EFI_DEVICE_PATH_PROTOCOL
*) LoadOptionPtr
,
1576 NewLoadContext
->FilePathListLength
1579 NewMenuEntry
->HelpString
= DevicePathToStr (NewLoadContext
->FilePathList
);
1580 NewMenuEntry
->DisplayStringToken
= GetStringTokenFromDepository (
1582 DriverOptionStrDepository
1584 NewMenuEntry
->HelpStringToken
= GetStringTokenFromDepository (
1586 DriverOptionHelpStrDepository
1588 LoadOptionPtr
+= NewLoadContext
->FilePathListLength
;
1590 if (LoadOptionPtr
< LoadOptionEnd
) {
1591 OptionalDataSize
= DriverOptionSize
-
1595 NewLoadContext
->FilePathListLength
;
1597 NewLoadContext
->OptionalData
= AllocateZeroPool (OptionalDataSize
);
1598 ASSERT (NewLoadContext
->OptionalData
!= NULL
);
1600 NewLoadContext
->OptionalData
,
1605 NewLoadContext
->OptionalDataSize
= OptionalDataSize
;
1608 InsertTailList (&DriverOptionMenu
.Head
, &NewMenuEntry
->Link
);
1612 if (DriverOrderList
!= NULL
) {
1613 FreePool (DriverOrderList
);
1615 DriverOptionMenu
.MenuNumber
= Index
;