UEFI shell - 标准应用程序的编译和加载过程

一、标准应用工程编译

首先了解下,应用程序是怎么被编译成.efi文件:

  1. UefiMain.c首先被编译成目标文件UefiMain.obj
  2. 连接器将目标文件UefiMain.obj和其他库连接成UefiMain.dll
  3. GenFw工具将UefiMain.dll转换成UefiMain.efi

说明:连接器在生成UefiMain.dll时使用了/dll/entry:_ModuleEntryPoint..efi是遵循PE32格式的二进制文件,_ModuleEntryPoint是这个二进制的入口函数

模块入口函数一般为UefiMain,但在inf工程文件里面可以更改

ENTRY_POINT                    = UefiMain

那么_ModuleEntryPoint跟UefiMain有什么关系呢?

让我们带着这个疑问来看应用程序的加载过程

二、标准应用程序加载

2.1将UefiMain.efi加载到内存

在shell下执行UefiMain.c时,shell执行的大致步骤:

  1. 首先用gBS->LoadImage()将UefiMain.efi文件加载到内存生成Image对象
  2. 然后调用gBS->StartImage(Image)启动这个对象.
    代码清单如下:
edk2/ShellPkg/Application/Shell/ShellProtocol.c
EFI_STATUS
InternalShellExecuteDevicePath(IN CONST EFI_HANDLE               *ParentImageHandle, //正在执行命令行的句柄IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath, //UefiMain.efi的设备路径IN CONST CHAR16                   *CommandLine OPTIONAL, //应用程序所需的命令行参数IN CONST CHAR16                   **Environment OPTIONAL, //UEFI环境变量OUT EFI_STATUS                    *StartImageStatus OPTIONAL  //程序UefiMain.efi的返回值)
{
...//第一步:将UefiMain.efi文件加载到内存, 生成Image对象,NewHandle是这个对象的句柄Status = gBS->LoadImage(FALSE,*ParentImageHandle,(EFI_DEVICE_PATH_PROTOCOL*)DevicePath,NULL,0,&NewHandle);if (EFI_ERROR(Status)) {if (NewHandle != NULL) {gBS->UnloadImage(NewHandle);}FreePool (NewCmdLine);return (Status);}//第二步:取得命令行参数,并将命令行参数交给UefiMain.efi的Image对象,即NewHandleStatus = gBS->OpenProtocol(NewHandle,&gEfiLoadedImageProtocolGuid,(VOID**)&LoadedImage,gImageHandle,NULL,EFI_OPEN_PROTOCOL_GET_PROTOCOL);if (!EFI_ERROR(Status)) {ASSERT(LoadedImage->LoadOptionsSize == 0);if (NewCmdLine != NULL) {LoadedImage->LoadOptionsSize  = (UINT32)StrSize(NewCmdLine);LoadedImage->LoadOptions      = (VOID*)NewCmdLine;}
...省略
//第三步:启动所加载的Imageif (!EFI_ERROR(Status)) {StartStatus      = gBS->StartImage(NewHandle,0,NULL);if (StartImageStatus != NULL) {*StartImageStatus = StartStatus;}}

加载应用程序最重要的一步,就是gBS->StartImage(NewHandle, 0,NULL)。StartImage主要作用就是找出可执行映象(Image)的入口函数并执行找到的入口函数。gBS-》StartImage是一个函数指针,它实际指向CoreStartImage函数

2.2进入映象的入口函数

CoreStartImage的主要作用调用映象的入口函数。CoreStartImage如下:

edk2/MdeModulePkg/Core/Dxe/Image/Image.c
/**Transfer control to a loaded image's entry point.@param  ImageHandle             Handle of image to be started.@param  ExitDataSize            Pointer of the size to ExitData@param  ExitData                Pointer to a pointer to a data buffer thatincludes a Null-terminated string,optionally followed by additional binary data.The string is a description that the caller mayuse to further indicate the reason for theimage's exit.@retval EFI_INVALID_PARAMETER   Invalid parameter@retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate@retval EFI_SECURITY_VIOLATION  The current platform policy specifies that the image should not be started.@retval EFI_SUCCESS             Successfully transfer control to the image'sentry point.**/
EFI_STATUS
EFIAPI
CoreStartImage (IN EFI_HANDLE  ImageHandle,OUT UINTN      *ExitDataSize,OUT CHAR16     **ExitData  OPTIONAL)
{
...省略
//设置LongJump,用于退出此程序Image->JumpBuffer = AllocatePool (sizeof (BASE_LIBRARY_JUMP_BUFFER) + BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT);if (Image->JumpBuffer == NULL) {...return EFI_OUT_OF_RESOURCES;}Image->JumpContext = ALIGN_POINTER (Image->JumpBuffer, BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT);SetJumpFlag = SetJump (Image->JumpContext);//首次调用SetJump()返回0。通过LongJump(Image->JumpContext)跳转到此处时返回非零值if (SetJumpFlag == 0) {RegisterMemoryProfileImage (Image, (Image->ImageContext.ImageType == EFI_IMAGE_SUBSYSTEM_EFI_APPLICATION ? EFI_FV_FILETYPE_APPLICATION : EFI_FV_FILETYPE_DRIVER));//调用Image的入口函数Image->Started = TRUE;Image->Status = Image->EntryPoint (ImageHandle, Image->Info.SystemTable);//设置执行后的状态,然后通过LongJump跳到应用程序退出点CoreExit (ImageHandle, Image->Status, 0, NULL);}
//此处是应用程序退出点
//程序通过LongJump跳转到此处,然后根据Image->进行错误处理
...
}

在gBS->StartImge中,SetJump/LongJump为应用程序提供了一种错误处理机制,如下:
在这里插入图片描述
gBS->StartImge的核心是Image->EntryPoint(),它就是程序映象的入口函数,对应用程序来说,就是_ModuleEntryPoint后,控制权才转交给应用程序(此处就是我们的UefiMain.efi),_ModuleEntryPoint代码如下:

edk2/MdePkg/Library/UefiApplicationEntryPoint/ApplicationEntryPoint.c
/**Entry point to UEFI Application.This function is the entry point for a UEFI Application. This function must callProcessLibraryConstructorList(), ProcessModuleEntryPointList(), and ProcessLibraryDestructorList().The return value from ProcessModuleEntryPointList() is returned.If _gUefiDriverRevision is not zero and SystemTable->Hdr.Revision is less than _gUefiDriverRevison,then return EFI_INCOMPATIBLE_VERSION.@param  ImageHandle                The image handle of the UEFI Application.@param  SystemTable                A pointer to the EFI System Table.@retval  EFI_SUCCESS               The UEFI Application exited normally.@retval  EFI_INCOMPATIBLE_VERSION  _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.@retval  Other                     Return value from ProcessModuleEntryPointList().**/
EFI_STATUS
EFIAPI
_ModuleEntryPoint (IN EFI_HANDLE        ImageHandle,IN EFI_SYSTEM_TABLE  *SystemTable)
{EFI_STATUS                 Status;if (_gUefiDriverRevision != 0) {//确保系统平台的UEFI版本号大于或者等于ImageHandle的UEFI版本号if (SystemTable->Hdr.Revision < _gUefiDriverRevision) {return EFI_INCOMPATIBLE_VERSION;}}//所有将被使用的库的构造函数ProcessLibraryConstructorList (ImageHandle, SystemTable);//调用Image的入口函数Status = ProcessModuleEntryPointList (ImageHandle, SystemTable);//所有库的析构函数ProcessLibraryDestructorList (ImageHandle, SystemTable);// Return the return status code from the driver entry pointreturn Status;
}

_ModuleEntryPoint主要处理三个事情:

  1. 初始化:在初始化函数ProcessLibraryConstructorList中会调用一系列的构造函数
  2. 调用本模块的入口函数:在ProcessModuleEntryPointList中会调用应用程序模块的真正入口函数(即我们在inf文件定义的入口函数UefiMain)
  3. 析构:在析构函数ProcessLibraryDestructorList中会调用一系列析构函数

那么上面这三个函数是在哪里定义的呢?

在执行build命令的时候,build命令会解析模块的工程文件(即inf文件),然后生成AutoGen.h和AutoGen.c,这三个函数就是在AutoGen.c中定义的。
一般而言,在inf文件的 [LibraryClasses] 段声明了某个库后,如果这个库有构造函数,AutoGen便会在ProcessLibraryConstructorList中加入这个库的构造函数,另外,ProcessLibraryConstructorList还会加入启动服务和运行时服务的构造函数。
这里看一个例子:
inf PATH:

edk2/MdeModulePkg/Application/HelloWorld/HelloWorld.inf

把该工程加到OvmfPkg中编译,找到它编译生成的AutoGen.c:

edk2/Build/OvmfX64/DEBUG_GCC5/X64/MdeModulePkg/Application/HelloWorld/HelloWorld/DEBUG/AutoGen.c
...省略//库构造
VOID
EFIAPI
ProcessLibraryConstructorList (IN EFI_HANDLE        ImageHandle,IN EFI_SYSTEM_TABLE  *SystemTable)
{EFI_STATUS  Status;Status = PlatformDebugLibIoPortConstructor ();ASSERT_RETURN_ERROR (Status);//初始化全局变量gBS、gST和gImageHandleStatus = UefiBootServicesTableLibConstructor (ImageHandle, SystemTable);ASSERT_EFI_ERROR (Status);//初始化全局变量gRTStatus = UefiRuntimeServicesTableLibConstructor (ImageHandle, SystemTable);ASSERT_EFI_ERROR (Status);Status = DevicePathLibConstructor (ImageHandle, SystemTable);ASSERT_EFI_ERROR (Status);//初始化UefiLib,Print函数就是在UefiLib中实现的Status = UefiLibConstructor (ImageHandle, SystemTable);ASSERT_EFI_ERROR (Status);}//析构
VOID
EFIAPI
ProcessLibraryDestructorList (IN EFI_HANDLE        ImageHandle,IN EFI_SYSTEM_TABLE  *SystemTable)
{}//入口
EFI_STATUS
EFIAPI
ProcessModuleEntryPointList (IN EFI_HANDLE        ImageHandle,IN EFI_SYSTEM_TABLE  *SystemTable){//工程入口函数return UefiMain (ImageHandle, SystemTable);
}...省略

gBS指向启动服务表,gST指向系统表(System Table),gImageHandle指向正在执行的驱动或者服务程序,gRT指向运行时服务表,这几个全局变量在开发应用程序和驱动程序是会经常用到。使用gBS、gST、gImageHandle钱需加 #include <Library/UefiBootServicesTableLib.h>。使用gRT之前需加 #include <Library/UefiRuntimeServicesTableLib.h>

与构造函数相似,AutoGen会在ProcessLibraryDestructorList调用相应的析构函数。在这里里面是空的,是因为UefiBootServiceTableLib、UefiRuntimeServicesTableLib、UefiLib这三个Library都没有析构函数。

最后在ProcessModuleEntryPointList中调用应用程序工程模块的真正入口函数UefiMain

回顾下标准应用程序工程模块的调用过程:
LoadImage -> StartImage -> _ModuleEntryPoint -> ProcessModuleEntryPointList -> UefiMain

本文来源:
《UEFI原理与编程》戴正华著

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://xiahunao.cn/news/354182.html

如若内容造成侵权/违法违规/事实不符,请联系瞎胡闹网进行投诉反馈,一经查实,立即删除!

相关文章

UEFI开发,记录第一场胜利——调用一个自己编写的protocol

本文参考BIOS/UEFI基础——Protocol介绍 大四第一个签三方的工作&#xff0c;BIOS的开发&#xff0c;第一次接触这个领域&#xff0c;在实习之前很好奇&#xff0c;也很有兴趣&#xff0c;但是学习BIOS在一开始注定要碰多次碰壁&#xff0c;实习第三周第二天&#xff0c;终于写…

linux系统nohob安装,Linux启动详解1

一、固件运行 本部分主要参考 戴正华 著《UEFI原理与编程》 CPU在加电后会进入16位实模式状态运行&#xff0c;同时CPU的逻辑电路设计为加电瞬间将CS的值设置为 0xF000、IP的值置为0xFFF0&#xff0c;这样CS&#xff1a;IP就指向0xFFFF0这个地址位置。然后开始执行固件 固件的执…

《UEFI原理与编程》读书笔记

《UEFI原理与编程》读书笔记 读书笔记仅摘取对个人有用的部分&#xff0c;详细内容请阅读原著 目前更新至第七章&#xff0c;因个人仅需要引导程序&#xff0c;故其余部分未介绍&#xff0c;详细内容请阅读原著 书及其资料均已放置在本人资源中&#xff0c;如需下载请移步资源模…

UEFI简介

前言 大多数人接触UEFI都是在PC的应用场景上&#xff0c;有在PC上安装过多操作系统的经历的同学&#xff0c;通常会进入UEFI界面设置操作系统引导顺序、CPU虚拟化等设置。UEFI诞生之初也确实是作为BIOS的替代者&#xff0c;主要应用在PC电脑上。随着手机/平板等移动设备的发展&…

10月书讯(上) | 小长假我读这些新书

华章科技提前祝大家国庆快乐 7天小长假&#xff0c;正是读书好时节 又到上新季&#xff0c;读书与休假更配哦 10月书讯&#xff08;上&#xff09;请查收 快来看看哪本书最属你心意 参与文末赠书活动&#xff0c;好书就要抢先读 — 新书速览 — 1、《计算机系统解密&#xff1a…

UEFI启动流程浅析

BIOS启动流程 SEC&#xff08;Security Phase&#xff0c;安全阶段&#xff09;阶段 SEC阶段是平台初始话的第一个阶段&#xff0c;计算机系统加电后首先进入这个阶段。 CPU上电之后&#xff0c;首先会进行硬件初始化&#xff08;hard reset&#xff09; 其次会进行可选的自检…

UEFI规范实现EDKII项目学习笔记绪论[0]

UEFI规范实现EDKII项目学习笔记绪论[0] 2015-07-10 北京海淀区 张俊浩 这段时间在学习UEFI( Unified Extensible Firmware Interface,统一的可扩展固件接口)&#xff0c;熟悉EDKII&#xff08;EFI Developer KitII&#xff0c;EFI开发工具包&#xff09;项目&#xff0c;…

3.UEFI-edk2 增加中文显示

UEFI-edk2源码中默认只有英文和法文的字库&#xff0c;在UI界面上或者shell终端打印中文字符串&#xff0c;则无法显示。例如&#xff0c;上一篇博客中的TestoneApp.cpp中&#xff0c;增加一行带中文字符串的打印&#xff1a; Print(L"Hello, world!\r\n");Print(L&…

UEFI原理与编程(一)

第一章 UEFI概述(Unified Extensible Firmware Interface 统一的可扩展固件接口) 常见缩写及描述&#xff1a; 缩略词全名描述UEFIUnified Extensible Firmware Interface统一的可扩展固件接口BSBoot Services启动服务RTRuntime Service运行时服务BIOSBasic Input Output Sys…

UEFI学习——事件函数WaitForEvent和CreateEvent/CreateEventEx

本文参考戴正华《UEFI原理与编程》 1.等待事件的服务WaitForEvent 启动服务中的WaitForEvent服务的函数原型&#xff1a; /**等待Event数组内任一事件被触发retval EFI_SUCCESS 下表为*index的事件被触发retval EFI_UNSUPPORTED 当前的TPL不是TPL_AP…

开宗明义—UEFI介绍 (二)

UEFI介绍 声明 上一篇介绍了UEFI的发展历史&#xff0c;以及对UEFI在ARM嵌入式领域的生态状况做了简单的调研。本篇旨在对UEFI规范和PI规范的内容以及二者之间的关系做一个简单的梳理。 本篇参考内容主要来源于以下3方面&#xff1a; (1) 微信公众号“ Wolf UEFI社区 ”系列文章…

UEFI学习——使用gRT->GetVariable读取Setup选项值

先列出代码&#xff0c;程序的解释在后面。 代码&#xff1a; #include <Uefi.h> #include <Library/UefiBootServicesTableLib.h> #include <Library/UefiRuntimeServicesTableLib.h> #include <Library/DebugLib.h> #include <Universal\DriverS…

2.1 对称量量化和非对称量化

前言 int8的数据范围可以表示为-128到127之间的整数 uint8的数据范围可以表示为0到255之间的整数 注释&#xff1a;int8就是用8个比特位来保存整数&#xff0c;第一位用来表示符号。uint8表示无符号整数&#xff0c;没有符号位&#xff0c;8个比特位全部用来表示整数。 1.问题…

Zinx框架学习 - 连接管理

Zinx - V0.9 连接管理 每个服务器的能够处理的最大IO数量是有限的&#xff0c;根据当前服务器能开辟的IO数量决定&#xff0c;最终决定权是内存大小现在我们要为Zinx框架增加链接个数的限定&#xff0c;如果超过⼀定量的客户端个数&#xff0c;Zinx为了保证后端的及时响应&…

澳网:公茂鑫/张择创历史 中国男网夺大满贯首胜

资料图&#xff1a;张择在比赛中。 中新网1月16日电 16日&#xff0c;2019年澳大利亚网球公开赛男双第一轮展开争夺&#xff0c;中国组合张择/公茂鑫苦战3盘战胜马特沃斯基/克里赞&#xff0c;收获中国男网在大满贯正赛的首场胜利&#xff0c;创造历史。 首盘比赛&#xff0c…

吴易昺,创造历史

中国网坛历史性一刻图片 当地时间2月12日 在ATP250达拉斯男单决赛中 中国球员吴易昺&#xff08;bǐng&#xff09;延续出色状态 顶住对手44记ACE的猛烈冲击&#xff0c;化解四个赛点后&#xff0c;以6-7(4)、7-6(3)、7-6(12)击败伊斯内尔&#xff0c;夺得个人以及中国大陆男网…

百合网“免费”革命 一场饮鸩止渴的大戏

在线婚恋市场一直以来都是有风乍起&#xff0c;吹乱一池春水的同时&#xff0c;也往往会带来自身的迷茫。 刚宣布融了15亿资的百合网计划下一步登陆A股&#xff0c; 于是推出了免费沟通的杀手锏&#xff0c;更是号称要彻底颠覆婚恋行业——果然是腰包鼓了&#xff0c;说话都财大…

澳网见证三巨头书写伟大时代 中国军团多点开花

中新网客户端北京1月28日电(记者 岳川) 随着排名世界第一的德约科维奇在男单决赛中直落三盘击败老对手纳达尔&#xff0c;2019年度澳大利亚网球公开赛大幕落下。这是一届注定会在未来被时常提起的赛事&#xff0c;罗德-拉沃尔球场见证了女单新霸主的诞生&#xff0c;见证了德约…

全球最大同性交友平台骚操作

文章目录 搜索快捷键高亮显示插件 github作为全球最大代码库&#xff0c;日常学习or工作都离不开她&#xff0c;这里介绍一些平时使用方面的技巧。 搜索 比如我们需要搜索spring boot相关的项目&#xff0c;如果直接搜索spring boot&#xff0c;结果如下&#xff1a; 可以看到…

RSA加密算法解析

目录 RSA加密 数学原理 证明: 欧拉函数 欧拉定理 模反元素 模运算 指数运算 同余 欧几里德算法GCD 填充(padding) 对称加密的应用工作流程 非对称加密的应用工作流程 1&#xff09;加密过程 2&#xff09;解密过程 代码实现 密码学知识扩展 加密体制 如何破解…