7.9.8.78.GEL_SymbolAddRel()

加载额外符号信息和重定位信息。

句法

GEL_SymbolAddRel( “fileName”, code_start, data_start[, cpuName[, “boardName]] );

参数

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

code_start 指定要在存储器中加载的代码段的起始地址。

data_start 指定要在存储器中加载的数据段的起始地址。

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

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

描述

符号信息可以附加到现有符号表中。此函数从指定符号文件加载符号信息。GEL_SymbolAdd 和 GEL_SymbolAddRel 与 GEL_SymbolLoad 和 GEL_SymbolLoadRel 的不同之处在于,在加载新符号之前,它们不会清除现有符号表的内容。在由重定位信息指定的代码和数据地址加载符号。

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

使用绝对地址指定重定位信息,该地址标识要在存储器中加载区段的位置。

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

同步

从 GEL 同步:否

完全同步:否

示例

GEL_SymbolAddRel(“c:\mydir\myfile.out”, 16, 64, “cpu_a”, “Simulator”);

相关主题

GEL_Load()

GEL_SymbolAdd()

GEL_SymbolLoad()

GEL_SymbolRemove()

GEL_UnloadAllSymbols()