7.7.8.98. GEL_SymbolEnable()ΒΆ
Re-enables the debug information from the specified symbol file.
Syntax
GEL_SymbolEnable( "file_name", ["cpu_name"], ["board_name"] );
Parameters
file_name: The filename of the symbol file to be re-enabled.
cpu_name (optional): names the CPU on which to load the file (useful in a multiprocessor environment). The cpuName must be enclosed in quotation marks.
board_name (optional): is the text string specified as the Board Name in the target configuration. The boardName must be enclosed in quotation marks.
Description
This function can only be used to re-enable symbol information that was disabled using GEL_SymbolDisable. This function will not load symbols from a file that has not been loaded before. To load symbols from a file use GEL_SymbolLoad or GEL_SymbolAdd. This command does not modify memory or set the program entry point.
If the file is not in the current directory, provide a full path name within the string. A double backslash escape sequence is required to ensure that you get a backslash into the fileName.
The cpu_name must match the CPU name as configured in the multiprocessor setup. In a single processor system, you do not need to fill this field.
Synchronous
Synchronous from GEL: Yes
Completely synchronous: Yes
Example
GEL_SymbolEnable("c:\\mydir\\myfile.out");
GEL_SymbolEnable("c:\\mydir\\myfile.out", "cpu_a", "Emulator");
Related Topics