【UEFI实战】Protocol和Handle的简单调试

绝地灬酷狼 2024-02-19 18:46 9阅读 0赞

## 说明 ##

在[【UEFI基础】Protocol介绍][UEFI_Protocol]中介绍了Protocol的基本内容。

本文主要介绍如何在Shell下查看各类Protocol以及相关的Handle，从而根据它来解决一些实际的问题。

## Shell下相关命令介绍 ##

下面简单介绍下Shell下会使用到的调试命令。

### dh ###

首先是dh命令：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70][]

该条命令显示BIOS启动过程中创建的所有的Handle。下面是命令执行之后的一个结果（非全部）：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 1][]

以上是dh命令不加参数时的显示结果。当加上参数时，可以更加明确显示内容：

handle：它是一个十六进制的值，就是上图中每一行的第一个数字，它就是一个Index，仅用于指定所有安装的Handles中的一个，下面是加入handle参数之后的显示结果：

![20190309162705567.png][]

这时的显示是很简单的，为了显示更多的内容，可以增加-d参数。

\-d：它将显示Handle上的Protocol对应的驱动的信息，下面是一个例子：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 2][]

其中第一个行显示在Index之后的是真正的Handle的值（不过其实意义不大），之后显示的就是对应Protocol相关的驱动信息。

还有一种方式是直接寻找安装了某个Protocol的所有Handles，这时需要使用参数-p：

\-p xxx：xxx可以是Protocol名称或者对应的GUID，下面是一个例子：

![20190309163632904.png][]

这里需要注意，Protocol名称和GUID的对应关系是函数GetStringNameFromGuid()来获取的，而真正的对应关系位于ShellPkg\\Library\\UefiHandleParsingLib\\UefiHandleParsingLib.c，其中维护了很大的一张表。从这里也可以看出来，由于存在某些Protocol没有在该表有对应关系，就导致了某些显示只能是GUID，比如下面的例子：

![20190309164129676.png][]

此时在使用-p的时候就要指定GUID了：

![20190309164303903.png][]

其它还有几个参数，重要性不是很大，有空再研究。

### devices/devtree ###

这两个命令用来显示的是UEFI Drivers这类特定的驱动以及相关的Handles。

关于这两个函数没有特别的参数需要介绍，直接使用即可，下面是相关的例子。

devices：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 3][]

这里各列的意义如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 4][]

devtree：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 5][]

### openinfo ###

openinfo指定一个参数，这个参数就是前面提到的Handle的Index，然后显示在这个Handle上打开的Protocol。下面是一个例子：

![20190309170123879.png][]

它显示了当前Handle使用的Protocols。

它也没有特别的参数需要介绍。

[UEFI_Protocol]: https://blog.csdn.net/jiangwei0512/article/details/86996846
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/ef69825db9d640db9f14826e6e89fc77.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/89102a1122884039902769b9c04747d3.png
[20190309162705567.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/2673dddeb94b44e3b9c8c57f11673171.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/cd570f405692427b9c4c5e4680c2dd06.png
[20190309163632904.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/cb1bdfac84144c61b872cc8aea8abb31.png
[20190309164129676.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/1687a753c8e94ec0a65f583b6d6dc4ab.png
[20190309164303903.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/cdd8e25c68424f67b43fd9d6db728326.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/91a29590895f45d29fe03ac97cbb6833.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/ff959aa2d05f4341a7f3db2c833ed499.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYW5nd2VpMDUxMg_size_16_color_FFFFFF_t_70 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/d347703c1340411bbc22a0fa4b9a7545.png
[20190309170123879.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/3d248483402045eab8e1f221bd1edf64.png