SourcePoint Intel Help
Table of Contents
- Using Help
- Contacting ASSET InterTech
- Introduction to SourcePoint
- SourcePoint Environment
- SourcePoint Overview
- SourcePoint Parent Window Introduction
- SourcePoint Icon Toolbar
- File Menu
- File Menu - Project Menu Item
- File Menu - Layout Menu Item
- File Menu - Program Menu Item
- File Menu - Macro Menu Item
- File Menu - Print Menu Items
- File Menu - Update Emulator Flash Menu Item
- File Menu - Program Target Device Menu Item
- File Menu - Other Menu Items
- Edit Menu
- View Menu
- Processor Menu
- Options Menu
- Options Menu - Preferences Menu Item
- Options Menu - Target Configuration Menu Item
- Options Menu - Load Target Configuration File Menu Item
- Options Menu - Save Target Configuration File Menu Item
- Options Menu - Emulator Configuration Menu Item
- Options Menu - Emulator Connection Menu Item
- Options Menu - Emulator Reset Menu Item
- Options Menu - Confidence Tests Menu Item
- Window Menu
- Help Menu
- How To -- SourcePoint Environment
- Add Emulator Connections
- Configure Custom Macro Icons
- Configure Autoloading Macros
- Display Text on the Icon Toolbar
- Edit Icon Groups to Customize Your Toolbars
- Modify a Defined Memory Region
- Refresh SourcePoint Windows
- Save a Program
- Start SourcePoint With Command Line Arguments
- Use the New Project Wizard
- Verify Emulator Network Connections
- SourcePoint Overview
- Breakpoints Window
- Breakpoints Window Overview
- How To - Breakpoints
- Code Window
- Command Window
- Command Window Overview
- Confidence Tests Window
- Confidence Tests Window Overview
- Descriptors Tables Window
- Descriptors Tables Window Overview
- How To - Descriptors
- Devices Window
- Devices Window Overview
- How To - Devices Window
- Log Window
- Log Window Overview
- Memory Window
- Memory Window Overview
- How To - Memory Window
- Page Translation Window
- Page Translation Windows Overview
- PCI Devices Window
- PCI Devices Window Overview
- How To - PCI Devices Window
- Registers Window
- Registers Window Overview
- How To - Registers
- Symbols Windows
- Symbols Window Overview
- How To - Symbols Window
- Trace Window
- Trace Window Overview
- How To - Trace Window
- Advanced
- Viewpoint Window
- Viewpoint Window Overview
- Watch Window
- Watch Window Overview
- How To - Watch Window
- Technical Notes
- Descriptor Cache: Revealing Hidden Registers
- UEFI Framework Debugging
- Memory Casting
- Microsoft PE Format Support in SourcePoint
- Multi-Clustering
- Python/CScripts
- OpenIPC Integration, Installation and Usage
- Registers Keyword Table
- SourcePoint Licensing
- Stepping
- Symbols Textsym Format
- Target Configuration
- Using Bookmarks
- Which Processor Is Which
- Getting Started with DbC
- SourcePoint Command Language
- Overview
- Commands and Control Variables
- aadump
- abort
- abs
- acos
- advanced
- asin
- asm
- asmmode
- atan
- atan2
- autoconfigure
- base
- bell (beep)
- bits
- break
- breakall
- cachememory
- cause
- Character Functions
- clock
- continue
- cos
- cpubreak commands
- cpuid_eax
- cpuid_ebx
- cpuid_ecx
- cpuid_edx
- createprocess
- cscfg, local_cscfg
- csr
- ctime
- cwd
- dbgbreak commands
- defaultpath
- #define
- define
- definemacro
- deviceconfigure
- devicelist
- devicescan
- disconnect
- displayflag
- do while
- dos
- dport
- drscan
- edit
- editor
- emubreak, emuremove, emudisable, emuenable
- emulatorstate
- encrypt
- error
- eval
- evalprogramsymbol
- execution point ($)
- exit
- exp
- fc
- fclose
- feof
- fgetc
- fgets
- first_jtag_device
- flist
- flush
- fopen
- for
- forward
- fprintf
- fputc
- fputs
- fread
- fseek
- ftell
- fwrite
- getc
- getchar
- getnearestprogramsymbol
- getprogramsymboladdress
- gets
- globalsourcepath
- go
- halt
- help
- homepath
- idcode
- if
- include
- invd
- irscan
- isdebugsymbol
- isem64t
- isprogramsymbol
- isrunning
- issleeping
- issmm
- itpcompatible
- jtagchain
- jtagconfigure
- jtagdeviceadd
- jtagdeviceclear
- jtagdevices
- jtagscan
- jtagtest
- keys
- last
- last_jtag_device
- left
- libcall
- license
- linear
- list, nolist
- load
- loadbreakpoints
- loadlayout
- loadproject
- loadtarget
- loadwatches
- log, nolog
- log10
- loge
- logmessage
- macropath
- Memory Access
- messagebox
- mid
- msgclose
- msgdata
- msgdelete
- msgdr
- msgdump
- msgir
- msgopen
- msgreturndatasize
- msgscan
- msr
- num_activeprocessors
- num_all_devices
- num_devices
- num_jtag_chains
- num_jtag_devices
- num_processors
- num_uncore_devices
- openipc
- pause
- physical
- port
- pow
- print cycles
- printf
- proc
- processorcontrol
- processorfamily
- processormode
- processors
- processortype
- projectpath
- putchar
- puts
- rand
- readsetting
- reconnect
- Register Access
- reload
- reloadproject
- remove
- reset
- restart
- return
- right
- runcontroltype
- safemode
- save
- savebreakpoints
- savelayout
- savewatches
- selectdirectory
- selectfile
- shell
- show
- sin
- sizeof
- sleep
- softbreak, softremove, softdisable, softenable
- sprintf
- sqrt
- srand
- step
- stop
- strcat
- strchr
- strcmp
- strcpy
- _strdate
- string [ ] (index into string)
- strlen
- _strlwr
- strncat
- strncmp
- strncpy
- strpos
- strstr
- _strtime
- strtod
- strtol
- strtoul
- _strupr
- swbreak
- switch
- swremove
- tabs
- tan
- tapdatashift
- tapstateset
- targpower
- targstatus
- taskattach
- taskbreak, taskremove, taskdisable, taskenable
- taskend
- taskgetpid
- taskstart
- tck
- time
- uncoreconfigure
- uncorescan
- #undef
- unload
- unloadproject
- upload
- use
- verify
- verifydeviceconfiguration
- verifyjtagconfiguration
- version
- viewpoint
- vpalias
- wait
- wbinvd
- while
- windowrefresh
- wport
- writesetting
- yield
- yieldflag
Descriptors Window Introduction
The Descriptors windows are used to examine and modify descriptor table entries. The elements of a Descriptors window include the title bar, data area, and option tabs for selecting the descriptor table type. The Descriptors window can be opened by selecting View|Descriptors on the menu bar or by clicking on the Descriptors icon on the toolbar. The GDT Descriptors table opens automatically.
ย
GDT Descriptors window
Window Structure
Offset Column
The Offset column lists the value of a selector index field within a segment register that points to a descriptor. A selector index is the decimal entry number multiplied by 8 and displayed as a hexadecimal value.
Type Column
The Type column lists the descriptor type. Code and data descriptor types include abbreviations that define the set/not-set state of their status bits.
-
Code descriptor types are listed with abbreviations for Conforming (C), Readable (R), and Accessed (A) status bits. An exclamation mark (!) precedes an abbreviation if the bit is cleared (e.g., !A=Segment has not been accessed).
-
Data descriptor types are listed with abbreviations for Expand-down (E), Writable (W), and Accessed (A) status bits. An exclamation mark (!) precedes an abbreviation if the bit is cleared (e.g., !E=Expand-up segment).
-
Task State Segment (TSS) descriptor types are listed as 16- and 32-bit TSS and with the word Busy when the TSS is not available.
-
Gate descriptor types are listed as 16- or 32-bit call-gates, 16 or 32-bit interrupt-gates, task-gates, and 16- or 32-bit trap-gates.
Note: Status is not defined for LDT, task-gate, call-gate, and IDT descriptor types. TSS types may include a Busy status.
Attributes Column
The Attributes column defines the Descriptor Privilege Level (DPL) and the Present (P) bit for all descriptors. Other attributes, defined for certain descriptor types, are identified below.
-
The Granularity (G) bit is defined for code, data, TSS, and LDT descriptors (i.e., segment limit is G=page granular or !G=byte granular).
-
The operand/address-mode default size is defined for code (D) and data (B) descriptors (i.e., operand/address-mode is D/B=32-bit or !D/B= 16-bit).
-
The Available (Avl) bit is defined for code, data, and TSS descriptors (i.e., segment is Avl=available or !Avl=not available).
-
The Dword (Doubleword) count is defined for call-gate descriptors.
Values Column
The Values column lists the base address and limit for code, data, TSS, and LDT (table) descriptors, or the selector and offset for call, interrupt, and trap-gate descriptors; it lists the selector (only) for task-gate descriptors.
-
Base defines the location of a segment within the 4 Gbytes of physical address space. A base address is displayed as an 8-digit hexadecimal value.
-
Limit is a 20-bit value representing the size of the memory segment. A limit is displayed as a 5-digit hexadecimal value.
-
Interrupt and trap gate descriptors use a 16-bit selector and a 32-bit offset as destination fields that point to the start of an interrupt or trap routine. A selector is displayed as a 4-digit hexadecimal value; offsets are displayed as 8-digit hexadecimal values.
Note: Task gate descriptors use only the selector field to refer to a TSS.
Tabs
The tabs at the bottom of the window are used to select the descriptor tables to display in the window. The title bar changes to reflect the selected descriptor table and shows the base and limit values of that table.
-
Select the GDT tab to view the status of or modify the contents of a Global Descriptor Table (GDT) entry.
-
Select the IDT tab to view the status of or modify the contents of an Interrupt Descriptor Table (IDT) entry.
-
Select the LDT tab to view the status of or modify the contents of a Local Descriptor Table (LDT) entry.
-
Select the LDTR tab to view the status of or modify the contents of a Local Descriptor Table Register (LDTR) entry.
ย The LDT or LDTR option tabs may not be enabled in all situations. The LDTR tab displays the currently active local descriptor table based upon the LDTR register value. The LDT tab is used to display any local descriptor table that is referenced in the GDT. The LDT tab works only when an LDT entry is selected in the GDT display.