嵌入式崩溃栈的符号化与源码定位方法及电子设备与流程

摘要: 本公开涉及嵌入式软件调试,特别涉及嵌入式崩溃栈的符号化与源码定位技术。背景技术:1、本部分所作的描述仅旨在为本公开的实施方式提供背景信息,不应被理解为承认或暗示...
嵌入式崩溃栈的符号化与源码定位方法及电子设备与流程

本公开涉及嵌入式软件调试,特别涉及嵌入式崩溃栈的符号化与源码定位技术。

背景技术:

1、本部分所作的描述仅旨在为本公开的实施方式提供背景信息,不应被理解为承认或暗示其已构成现有技术。

2、嵌入式设备通常采用arm架构的处理器,其软件编译为携带调试信息的固件映像文件。当设备上的软件发生空指针访问、栈溢出等崩溃时,系统会输出包含函数调用栈地址的回溯信息并保存为回溯文件,开发者需要借助固件映像文件中的调试信息将其中的地址转换为函数名、源文件路径与行号,才能分析崩溃原因。目前,开发者通常在linux环境下使用工具链中的addr2line等命令行工具执行符号化,在命令行窗口中逐条查看输出的文本,再凭记忆或手动搜索在本地源代码中寻找对应的文件与行号。这一过程依赖linux平台,与多数嵌入式应用开发者的桌面开发环境割裂;命令行输出分散且不直观;固件映像文件中记录的是编译机上的源代码绝对路径,与开发者本地的路径往往不一致,解析出的路径无法直接用于打开源代码;符号化结果与代码编辑器之间也缺乏联动。现有的在线调试插件需要调试器实时连接设备,面向实时调试而非对已生成的回溯文件进行离线解析。

技术实现思路

1、本公开提供了一种嵌入式崩溃栈的符号化与源码定位方法及电子设备,可以解决的一个技术问题是:如何在开发者的计算机设备上高效、准确地将嵌入式设备崩溃时生成的回溯文件中的调用栈地址定位到本地源代码的对应代码行。

2、根据本公开的一个方面,提供了一种嵌入式崩溃栈的符号化与源码定位方法,应用于计算机设备,所述计算机设备上安装有符号化工具以及代码编辑器,所述符号化工具用于依据调试信息将程序地址转换为函数名、源文件路径以及行号,所述方法包括:

3、获取嵌入式设备发生崩溃时生成的回溯文件、所述嵌入式设备的包含所述调试信息的固件映像文件的存储路径以及配置的本地源代码根目录;

4、从所述回溯文件中识别包含调用栈地址的回溯行,并从所述回溯行中提取所述调用栈地址;

5、根据所述固件映像文件的存储路径以及所述调用栈地址构建符号化命令;

6、在所述计算机设备上调用所述符号化工具执行所述符号化命令,并捕获所述符号化工具输出的符号化文本;

7、解析所述符号化文本,得到包含所述调用栈地址、所述函数名、所述源文件路径以及所述行号的结构化条目,并将所述结构化条目展示于结果列表;

8、按照预设路径映射规则,基于所述本地源代码根目录将所述结构化条目中的所述源文件路径由编译时路径转换为指向所述计算机设备上本地源代码文件的本地源码路径;

9、响应于对所述结果列表中目标条目的选中操作,生成包含所述目标条目的所述本地源码路径以及所述行号的编辑器调用命令,并执行所述编辑器调用命令,以调起所述代码编辑器打开所述本地源码路径对应的本地源代码文件并定位至所述行号对应的代码行。

10、在一个优选例中,所述从所述回溯文件中识别包含调用栈地址的回溯行,包括:

11、逐行扫描所述回溯文件,将行首出现预设回溯关键词或者行中出现所述预设回溯关键词的行判定为所述回溯行,将其余的行判定为非回溯行;

12、将所述回溯行与所述非回溯行分类展示,并以区别于所述非回溯行的显示方式标记所述回溯行。

13、在一个优选例中,所述在所述计算机设备上调用所述符号化工具执行所述符号化命令,并捕获所述符号化工具输出的符号化文本,包括:

14、创建匿名管道,并将用于运行所述符号化工具的子进程的标准输出和标准错误重定向至所述匿名管道;

15、以隐藏命令行窗口的方式创建所述子进程,由所述子进程执行所述符号化命令;

16、从所述匿名管道中读取所述子进程输出的所述符号化文本。

17、在一个优选例中,所述解析所述符号化文本,包括:

18、将所述符号化文本按行分割为待解析行;

19、在所述待解析行中,依据地址分隔符切分得到所述调用栈地址,依据预设连接关键字切分得到所述函数名,通过反向查找所述待解析行中最后一个行号分隔符,将位于所述预设连接关键字之后、所述行号分隔符之前的部分切分为所述源文件路径,将位于所述行号分隔符之后的部分切分为所述行号;

20、去除所述待解析行中位于所述行号之后的附加调试信息。

21、在一个优选例中,所述按照预设路径映射规则,基于所述本地源代码根目录将所述结构化条目中的所述源文件路径由编译时路径转换为指向所述计算机设备上本地源代码文件的本地源码路径,包括:

22、在所述源文件路径中定位预设的锚点目录;

23、将所述源文件路径中位于所述锚点目录之前的路径部分替换为所述本地源代码根目录,并保留所述源文件路径中自所述锚点目录起的路径部分,得到所述本地源码路径。

24、在一个优选例中,所述生成包含所述目标条目的所述本地源码路径以及所述行号的编辑器调用命令,包括:

25、将所述本地源码路径与所述行号以预设定位分隔符拼接为定位参数;

26、将所述定位参数作为命令行参数与所述代码编辑器的启动指令组合,得到所述编辑器调用命令。

27、在一个优选例中,所述回溯行包括记录所述嵌入式设备崩溃时处理器寄存器值的寄存器记录行,所述回溯文件还包括记录崩溃时栈内存内容的栈转储行,所述调用栈地址包括从所述寄存器记录行中提取的程序计数器值与链接寄存器值,所述符号化工具包括工具链中的调试器;

28、所述方法还包括:

29、从所述寄存器记录行中提取包括所述链接寄存器值、异常返回值、主栈指针以及进程栈指针在内的寄存器集合,并将所述栈转储行按其起始地址与连续字拼接为内存映像;

30、在所述寄存器集合中的链接寄存器值为异常返回值时,根据所述异常返回值的预设位确定异常发生前所使用的栈指针以及异常帧长度,从所述内存映像中位于所确定的栈指针处的异常帧读取硬件压栈的寄存器值,得到异常发生前的寄存器组,并在读取到的链接寄存器值仍为异常返回值时重复上述读取,得到对应于嵌套的多层异常的多个寄存器组,由所述寄存器集合与所述多个寄存器组构成层级列表;

31、在所述计算机设备上创建伪调试目标,所述伪调试目标响应于所述调试器的寄存器读取请求,返回所述层级列表中与所述调试器当前选中的线程对应的寄存器组,并响应于所述调试器的内存读取请求,在请求地址落在所述内存映像内时返回所述内存映像中的字节,在请求地址落在所述固件映像文件的可加载段内时按该可加载段的文件偏移从所述固件映像文件中读取字节返回;

32、所述根据所述固件映像文件的存储路径以及所述调用栈地址构建符号化命令,包括:构建包含加载所述固件映像文件的命令、连接所述伪调试目标的命令以及栈展开命令的所述符号化命令,其中所述调用栈地址包含于所述寄存器组中并经由所述伪调试目标提供给所述调试器;所述符号化文本为所述调试器执行所述栈展开命令后基于所述寄存器组与所述内存映像输出的帧信息;

33、在所述帧信息指示栈展开提前中断时,将所述内存映像中位于最后一帧的栈指针之后的字逐一作为候选返回地址进行校验,校验条件包括所述候选返回地址落在所述固件映像文件的可执行段内、以及所述候选返回地址之前的指令为调用指令,将通过校验的候选返回地址对应的帧作为推断帧补充至所述结构化条目,并在所述结果列表中将所述推断帧与由所述帧信息得到的帧以不同的来源标注区分展示。

34、在一个优选例中,所述获取所述嵌入式设备的包含所述调试信息的固件映像文件的存储路径,包括:从所述回溯文件中提取所述嵌入式设备的固件的至少一个构建标识,在符号仓库中查找构建标识与所提取的构建标识相匹配的一个或多个固件映像文件,并将查找到的各固件映像文件的存储路径作为所述固件映像文件的存储路径;在所述回溯文件中不含所述构建标识或未查找到相匹配的固件映像文件时,将所述回溯文件中打印的函数名与以候选固件映像文件符号化得到的函数名逐帧比对并计算一致率,选取一致率最高的候选固件映像文件,并在所述一致率低于预设阈值时判定为所述构建标识不匹配;其中,所述符号仓库中存储有至少一个固件映像文件以及镜像清单,所述镜像清单记录各固件映像文件的构建标识、链接基址、可执行段地址区间以及源代码提交标识;

35、所述根据所述固件映像文件的存储路径以及所述调用栈地址构建符号化命令,包括:根据所述可执行段地址区间确定所述调用栈地址所属的固件映像文件,将所述调用栈地址减去所属的固件映像文件的地址校正量得到校正后地址,并根据所属的固件映像文件的存储路径以及所述校正后地址构建所述符号化命令;其中,所述地址校正量为所述固件在所述嵌入式设备上的运行基址与所述链接基址之差,所述运行基址取自所述回溯文件,或者,在所述回溯文件未记录所述运行基址时,从预设的候选校正量集合中选取使得校正后的调用栈地址之前的指令为调用指令的比例最高的候选校正量作为所述地址校正量;

36、所述预设路径映射规则包括:依据所述镜像清单中的源代码提交标识,在所述本地源代码根目录对应的版本库中检出与所述固件编译时一致的源代码工作树,并将所述编译时路径转换为指向所述源代码工作树中对应文件的所述本地源码路径;或者,所述方法还包括:依据所述源代码提交标识对应的源代码文件与所述本地源代码文件之间的差异块,将所述结构化条目中的所述行号换算为所述本地源代码文件中的对应行号;

37、所述方法还包括:根据所述构建标识是否匹配、所述校正后地址是否落在所属的固件映像文件的可执行段内、以及所述本地源代码文件相对于所述源代码提交标识是否被修改,确定所述结构化条目的可信度等级,将所述可信度等级展示于所述结果列表,并在所述可信度等级为不可信时,在所述结果列表中禁用对相应结构化条目的选中操作并展示未通过的核验环节。

38、根据本公开的另一方面,提供了一种电子设备,包括存储器和处理器,所述存储器中存储有计算机程序,所述处理器执行所述计算机程序时实现前文描述的嵌入式崩溃栈的符号化与源码定位方法。

39、根据本公开的另一方面,提供了一种计算机可读存储介质,所述计算机可读存储介质中存储有计算机程序,所述计算机程序被处理器执行时实现前文描述的嵌入式崩溃栈的符号化与源码定位方法。

40、本公开的实施例中,通过获取回溯文件、固件映像文件的存储路径与本地源代码根目录,从回溯文件中识别回溯行并提取调用栈地址,据此构建符号化命令并在计算机设备上调用符号化工具执行、捕获符号化文本,将符号化文本解析为包含调用栈地址、函数名、源文件路径与行号的结构化条目并展示于结果列表,按预设路径映射规则将源文件路径由编译时路径转换为本地源码路径,再响应于对目标条目的选中操作生成并执行包含本地源码路径与行号的编辑器调用命令以调起代码编辑器定位至对应代码行,可以在开发者日常使用的计算机设备上直接完成崩溃栈的离线符号化,无需切换到其它操作系统;可以将原本分散的命令行文本转换为结构化的列表信息,便于开发者直观查看崩溃调用栈;可以自动消除固件映像文件中的编译时路径与开发者本地路径不一致所带来的定位障碍;可以由一次选中操作完成从崩溃地址到源代码行的跳转,省去在源代码中人工查找的过程,从而提高崩溃分析的效率并减少人为差错,同时由于基于工具链与代码编辑器已有的接口实现,无需修改底层工具,便于部署。

41、进一步地,通过以预设回溯关键词出现在行首或行中作为判定条件区分回溯行与非回溯行,并将二者分类展示且以区别方式标记回溯行,可以从包含大量无关内容的回溯文件中自动、可靠地提取崩溃调用栈,使开发者能够迅速定位到崩溃记录。

42、进一步地,通过创建匿名管道并将运行符号化工具的子进程的标准输出和标准错误重定向至该管道,以隐藏命令行窗口的方式创建子进程并从管道中读取符号化文本,可以在不弹出命令行窗口的情况下静默完成符号化,避免打断用户的图形界面操作,并能够一并捕获符号化工具的告警信息。

43、进一步地,通过将符号化文本按行分割,依据地址分隔符、预设连接关键字以及反向查找的最后一个行号分隔符依次切分出调用栈地址、函数名、源文件路径与行号,并去除行号之后的附加调试信息,可以在源文件路径本身含有分隔符或输出中带有附加信息的情况下仍准确解析各字段,兼容符号化工具的多种输出格式。

44、进一步地,通过在源文件路径中定位锚点目录,将锚点目录之前的路径部分替换为本地源代码根目录并保留自锚点目录起的路径部分,可以仅凭一个本地源代码根目录的配置完成路径映射,且不受编译机上工作区位置变化的影响,配置简单、适应性强。

45、进一步地,通过将本地源码路径与行号以预设定位分隔符拼接为定位参数,再与代码编辑器的启动指令组合得到编辑器调用命令,可以仅通过更换定位分隔符与启动指令即可适配不同的代码编辑器,提高方案的通用性。

46、进一步地,通过从寄存器记录行与栈转储行中提取寄存器集合并拼接内存映像,依据异常返回值的预设位逐层读取异常帧以重建嵌套异常前的多个寄存器组,在计算机设备上创建向调试器提供寄存器组、内存映像及固件映像文件内容的伪调试目标,以包含加载固件映像文件、连接伪调试目标与栈展开的命令作为符号化命令由调试器输出帧信息,并在栈展开提前中断时以落在可执行段内且前一指令为调用指令为条件校验候选返回地址、将通过校验的推断帧以不同来源标注补充展示,可以在回溯文件仅记录寄存器与栈转储而不含完整调用栈的情况下,在计算机设备上离线恢复出完整的调用链,区分异常处理链与被中断的任务链以避免误判根因,并在栈内容被破坏时给出有依据且来源可辨的修复结果,而无需嵌入式设备增加记录负担。

47、进一步地,通过从回溯文件中提取构建标识并在存储有镜像清单的符号仓库中查找匹配的固件映像文件,依据可执行段地址区间确定调用栈地址所属的固件映像文件并以运行基址与链接基址之差或按调用指令比例自动选取的地址校正量对调用栈地址进行校正,依据源代码提交标识检出与编译时一致的源代码工作树或依据差异块换算行号,并根据构建标识匹配、校正后地址落在可执行段内以及本地源代码是否被修改三项核验确定可信度等级、在不可信时禁用选中操作并展示未通过的核验环节,可以避免因固件映像文件版本错配、加载偏移未校正或本地源代码已修改而导致的看似合理却错误的符号化结果,将原本静默的错误定位转变为明确的提示,减少开发者在错误位置上耗费的分析时间。

48、应当理解的是,以上的一般性描述和后文的细节描述仅是示例性和解释性的,并不能限制本公开。本公开的各个方面和实施例可以以不同的方式进行组合。本公开的这个部分不旨在确定所要求保护的主题的关键特征或必要特征,也不旨在用于辅助确定所要求保护的主题的范围。