7.9.8.80.GEL_SymbolLoad()

仅加载符号信息。

句法

GEL_SymbolLoad(“fileName [, “cpuName [, “boardName]] );

参数

fileName 为包含符号信息的符号文件命名。fileName 必须括在引号内。符号文件可以是标准 COFF 输出文件 (*.out) 或在构建过程中获取的特定符号文件。

cpuName(可选)是用于加载符号信息的 CPU 的名称(在多处理器环境中很有用)。cpuName 必须括在引号内。

boardName(可选)是用于加载符号信息的电路板的名称。如果未指定,请使用执行此 GEL 函数的处理器的电路板名称。boardName 必须括在引号内。

描述

若要在调试器不能或不需要加载目标代码的调试环境(例如,当代码在 ROM 中)工作时仅加载符号信息,此函数很有用。此函数从指定符号文件加载符号信息。

调试器首先从在主机上维护的符号表中删除任何之前加载的符号。然后将符号文件中的符号加载到符号表。在符号文件中指定的代码和数据地址加载符号。此命令不会修改存储器或设置程序入口点。

如果文件不在当前目录中,请在字符串内提供完整路径名称。需要使用双反斜杠转义序列,以确保在 fileName 条目中添加反斜杠。

cpuName 和 boardName 必须与多处理器设置中配置的处理器名称和电路板名称相匹配。在单处理器系统中,用户无需填写这些字段。

同步

从 GEL 同步:否

完全同步:否

示例

GEL_SymbolLoad(“c:\mydir\myfile.out”, “cpu_a”, “Emulator”);

相关主题

GEL_Load()

GEL_SymbolAdd()

GEL_SymbolAddRel()

GEL_SymbolLoadRel()

GEL_SymbolAddRel()

GEL_SymbolRemove()

GEL_SymbolShowSection()

GEL_UnloadAllSymbols()