7.7.8.97. GEL_SymbolDisable()ΒΆ

Disables the debug information from the specified symbol file.

Syntax

GEL_SymbolDisable( "file_name", ["cpu_name"], ["board_name"] );

Parameters

file_name: The filename of the symbol file to be disabled.

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

Disabling a symbol file hides the symbol information in the debugger. When hidden the debugger will act as-if the symbol information was not loaded in the first place. The symbol information can be re-enabled using GEL_SymbolEnable. 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_SymbolDisable("c:\\mydir\\myfile.out");
GEL_SymbolDisable("c:\\mydir\\myfile.out", "cpu_a", "Emulator");

Related Topics

GEL_SymbolAdd

GEL_SymbolEnable

GEL_SymbolLoad