SourcePoint AMD Help

Table of Contents

Symbolic Text Format (Textsym)

This file format is a simple text file to specify symbolic debug information.

File Format

Field Separator

Each field is separated by the vertical bar ('|') character. White space around the bar is optional. All leading and trailing white spaces between fields are ignored.

Signature

The first line of this text file contains a signature and version information. The "TEXTSYM format" string and version number must be as shown. White space will be ignored. If a valid signature is not found, the load will abort.

ย TEXTSYM format | V1.1 <eol>

Debug Information

Debug information for each symbol is specified on a separate line as specified below:

ย 

GLOBAL/LOCAL

Offset Value

CODE/DATA

Symbol Name

Object_____Size

Where:

ย 

GLOBAL/LOCAL

Usage is tool dependent. If symbol is specified as GLOBAL, then it must be unique within this module - no duplication is allowed. Some tools may ignore symbols marked as LOCAL.

Offset Value

64-bit hex value treated as an unsigned number. The offset value is added to the address where the symbol file is loaded.

CODE/DATA

A required keyword. When the debug tool forms an IA-64 symbolic address, this field is used to determine whether the resulting symbol has a data address or an execution address. This field is ignored when reading IA-32 symbols.

Symbol Name

ย 

A contiguous ASCII string of characters that are legal to identify a variable/function name in C/C++. Symbol names are case sensitive. Length is not restricted but limited by the debug tool that consumes it.

Object Size

The size of a data object in bytes. This field is optional. It is in bytes for code and data symbols.
ย *This field is not allowed in version 1.0 and is optional in version 1.1. Both versions 1.0 and 1.1 are currently supported.

High-level source display is not possible in the absence of line numbers. All the symbols are treated as if they are public symbols. The file name will be used as the module name to associate the symbol. De-referencing of symbols is not supported.

Example

TEXTSYM format | V1.0 <eol>

ย 

GLOBAL

| 0000000c00000000

| CODE

| ENTER_RESET <eol>

ย 

GLOBAL

| 0000000000000430

| DATA

| OSTypeFound <eol>

ย 

LOCAL

| 0000000000001234

| CODE

| BAR <eol>

ย 

GLOBAL

| 0000000000001238

| DATA

| FOO

ย | 4 <eol>

ย