SourcePoint AMD Help

Using Help
- Welcome to On-Line Help
- How To - HTML Help
Contacting ASSET InterTech
- Contacting ASSET InterTech
Introduction to SourcePoint
- What's New in SourcePoint for AMD 1.0
SourcePoint Environment
- SourcePoint Overview
- How To -- SourcePoint Environment
Breakpoints Window
- Breakpoints Window Overview
- How To - Breakpoints
  - Set Breakpoints From Other SourcePoint Windows
Code Window
- Code Window Overview
- How To - Code Window
Command Window
- Command Window Overview
  - Introduction
Confidence Tests Window
- Confidence Tests Window Overview
Descriptors Tables Window
- Descriptors Tables Window Overview
  - Descriptors Window Introduction
  - Descriptors Window Menu
- How To - Descriptors
  - Replace a Descriptor Entry
Devices Window
- Devices Window Overview
- How To - Devices Window
  - Create Simple Devices Window
Log Window
- Log Window Overview
Memory Window
- Memory Window Overview
- How To - Memory Window
Page Translation Window
- Page Translation Windows Overview
  - Page Translation Windows Introduction
PCI Devices Window
- PCI Devices Window Overview
  - PCI Devices Window Introduction
  - PCI Devices Window Menu
- How To - PCI Devices Window
  - Open the Registers Window From the PCI Devices Window
  - Refresh a PCI Devices Dialog Box
Registers Window
- Registers Window Overview
  - Registers Window Introduction
- How To - Registers
  - Customize the Registers Window
  - Print a Register List
Symbols Windows
- Symbols Window Overview
- How To - Symbols Window
  - Change Values in the Symbols Window
Viewpoint Window
- Viewpoint Window Overview
  - Viewpoint Window Introduction
  - Viewpoint Window Menu
Watch Window
- Watch Window Overview
  - Watch Window Introduction
  - Watch Window Menu
- How To - Watch Window
  - Add and Expand Registers in a Watch View
  - Add Symbols to a Watch or Quick Watch View
Technical Notes
- Descriptor Cache: Revealing Hidden Registers
- UEFI Framework Debugging
- Memory Casting
- Microsoft PE Format Support in SourcePoint
- Registers Keyword Table
- SourcePoint Licensing
- Stepping
- Symbols Textsym Format
- Target Configuration
- Using Bookmarks
- Which Processor Is Which
SourcePoint Command Language
- Overview
- Commands and Control Variables

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>