[Contents][Prev]

Index



A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

A

a.out  88
ACTION_TYPE  173
APIs (Tornado)  8-10
see also individual interface entries
graphical user interface  8
OMF reader interface  10
target-server back-end interface  10
target-server core  9, 10
WDB agent interface  6, 10
WTX C  8, 183-191
WTX protocol  147-191
WTX Tcl  9, 165-182
application program interfaces, see APIs
architecture (Tornado)  1-14
directory tree  11-13
loader  93-102
target server  4-6
asynchronous events thread  8


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

B

-B option (target server)  20, 23
back ends (target server)  6, 8, 15-86
see also Back-End Developer's Kit; non-WDB back ends; WDB back ends
attaching  20
functions  26-31
implementing  19-31
initializing  16, 20-26
manager  6
message logging  30-31
non-WDB  18-19, 47-86
and rebooting  28
shutting down  17
tool requests  17
WDB  17-18, 30, 32-47
Back-End Developer's Kit  51-53
background debug mode (BDM)  75
-Bd option (target server)  30
BDM (background debug mode)  75
BKEND_INFO structure  23, 25
initializing  54, 59
BKEND_OBJS  63
bkendEventGet( )  27, 28
bkendEvtPending( )  27, 28
bkendInit( )  39-40
bkendlib  10
bkendlog  10
bkendTgtConnect( )  20
bootstrapping  90
breakpoints  77
browser
display windows, creating  205-216
UNIX  206-211
Windows  212-216
network interface panels, updating  209-211
toolbar buttons, creating  209
byte order (OMF manager)  121-122


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

C

C language
see also WTX C API
Gopher scripts, sending  162
and WTX protocol  183
cache
managing  103, 105
sizing  104
target server memory  104-105
cacheTxtUpdate_m( )  86
CALL_RETURN  156
cexit  174
checksum  34, 35, 48, 51
CLIENT data structure  39, 41, 43
clnt_ops functions (RPC)  43
clnttty_create( )  41
coding conventions
see also VxWorks Programmer's Guide
C Coding Conventions
COFF  88
common symbols  101
context management  75-78
breakpoints  77
singlestepping  78
CONTEXT_TYPE  173
contextCreate_m( )  86
contextKill_m( )  86
conventions
naming  108-110
core files  90, 101
CrossWind (debugger)  82-86
CTX_EXIT  156
CTX_START  155


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

D

DATA_ACCESS  156
debugging
non-WDB back ends  82-86
development tools (host), see tools, host development
-DHOST compiler option  64
directCall_m( )  86
directory tree (Tornado)  11-13
DLL, see dynamically linked libraries
documentation
new applications, creating for  227
-DPORTABLE compiler option  64
$(DYN_LK_FLAGS) compiler option  64
dynamically linked libraries (DLLs)  20
attaching back ends and target servers  20
compiling  64
entry point  39
implementing  107
writing  38-42


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

E

ELF  88
event handling  78-82, 154-157
asynchronous event notification  27, 38, 79
capturing information  79-81
event queue, checking the  172
event strings  155-156, 157
exceptions  81-82
generating  173-175
registering tools  172
retrieving  173-175
synchronous event notification  27, 79
and Tornado tools  171-175
event strings  155-156, 157, 172
parameters  155
EVENT_TYPE  173
eventpoints  173
eventPoll command (Tcl)  178
EXCEPTION  156
exception handling  180-182
executable files  88


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

F

FULL_BKD_OBJS  63
fully linked files  95, 101
funcCall( )  86


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

G

-g compiler option  85
Gopher  2-3, 48, 51, 158-165
result tape  161
scripts
sending to the target agent  161-165
writing  198
graphical user interface (GUI)  8


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

H

hierarchy windows (UNIX browser)  206
HOST  45
host ID  34
-hwtx option (Tcl command)  179


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

I

INCLUDES  44, 63, 219
initialization
back ends  16, 20-26
non-WDB  53-55
WDB  39-42


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

L

launch toolbar (Tornado)
installing new applications (Windows)  225-227
launcher (Tornado)
installing new applications (UNIX)  223-224
ld( )  91
lib directory  11
linkage  88
linking  89-90
see also loader
listEvents command (Tcl)  176, 178
LOAD_ALL_SYMBOLS  92, 100
LOAD_BAL_OPTIM  92
LOAD_BAL_OPTIM (i960)  102
LOAD_COMMON_MATCH_ALL  92, 102
LOAD_COMMON_MATCH_NONE  91, 92, 101
LOAD_COMMON_MATCH_USER  92, 101
LOAD_CORE_FILE  92, 101
LOAD_FILE_OUTPUT  92, 102
LOAD_FULLY_LINKED  92, 101, 102
LOAD_GLOBAL_SYMBOLS  92, 100
LOAD_HIDDEN_MODULE  92, 100
LOAD_LOCAL_SYMBOLS  92, 93, 99
LOAD_NO_SYMBOLS  91, 92, 100
loadCommonManage( )  136
loader thread  7
loader, object-module  5, 87-146
see also object modules
addresses, manipulating  105
architecture  93-102
C programs, calling from  92
core files  101
fully linked files  95, 101
linking  89-90
memory, managing  102
options  99-102
relocatable files  94, 101
shell, using from the  91
symbol types, defining  99
Tcl, accessing with  92
type abstraction  105
unloading  96
and virtual memory  105
loadlib  10
loadOutputToFile( )  117
loadSegmentsAllocate( )  129
loadUndefSymAdd( )  136
LOCAL_CFLAGS  64


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

M

-m cacheSize compiler option  104
magic number  88, 121
malloc( )  104
MAX_TOOL_EVENT_SIZE  155
MEM_HOST  103
MEM_NO_WRITE  103
MEM_NONE  103
MEM_TEXT  103
memBlockGet command (Tcl)  168
memBlockGetString command (Tcl)  176
memBlockWriteFile command (Tcl)  177
memChecksum_m( )  86
memory
alignment  103
managing  102
protecting target  105
memory block handle  168, 169
memScan_m( )  86
message logging
non-WDB back ends  55
WDB back ends  30-31
methods (back end)  51, 58-62, 66-86
see also checksum; Gopher
context management  75-78
event handling  78-82
implementing  58-62
mandatory  67-86
testing  82-86
optional  86
read functions
for memory  67-71
for registers  71-75
testing  82-86
using  66-67
write functions
for memory  67-71
for registers  71-75
MODULE_ID  96-97
msleep command (Tcl)  172


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

N

naming conventions  108-110
network interfaces  196
drivers, writing  46
non-WDB back ends  18-19, 47-86
building  62-64
UNIX  62-64
Windows  64
checksum  51
class library  51-52
coding conventions  50
context management  75-78
designing  48-49
error logging  55
event handling  78-82
Gopher  51
implementing  47, 49-50, 52
initialization routines, writing  53-55
loading  65-66
mandatory functions, implementing  67-86
testing  82-86
message logging  55
methods
implementing  58-62
using  66-67
optional functions  86
performance  86
skeleton, creating  53-62
declaring  56-58
testing  49, 50, 53, 65-67, 82-86
writing  47-86
notify packets  38


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

O

OBJ_LOADED  156
OBJ_UNLOADED  156
object file  88
object module format, see OMF
object module headers  88
alignment problems, resolving  103
processing  122
object module representation  96-97
object modules  88
common symbols  101
fully linked files  95, 101
hiding  100
managing  96-97
MODULE_ID  96-97
relocatable files  94, 101
SEG_INFO  96
target memory, configuring in  94-95
OMF (object module format)  5, 88
byte order  121-122
compiler signature, determining the  128
dynamically linked libraries (DLLs), using  107
errors, logging  146
header processing  122
interface functions  108-120
manager  90
writing a  107-146
memory
allocating for required segments  129
managing  145
object modules, relocating  111-112, 140-144
reader interface  10
relocated modules to target memory, downloading  144-145
segments
reading  130-135
sizing  123-126
shared library manager, installing a  108
symbol table
object-module, reading the  126
target server, processing the  135-140
warnings, logging  146


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

P

pbkendInfo routine  25
performance, back end  86
pTgtOps routine  24


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

R

raw data  88
read functions (back end)
for memory  67-71
for registers  71-75
rebooting (target)  28
registry (Tornado)  29, 152
see also wtxregd
relocatable files  88, 94, 101
symbol tables  97
relocation entries  89
relocation unit (RU)  90
interface  111-112
resource directory  12-13
RPC (Remote Procedure Calls)  18, 33
CLIENT data structure  39
core  38, 41
networks, communicating over unsupported  43
reply errors  36-38
rpccore library  38, 42
rpcCoreInit( )  40, 41, 42


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

S

SEG_INFO  96, 117, 145
SEG_WRITE_PROTECTION  145
serviceCall_m( )  86
SH_BKEND_OBJS  64
shared libraries, see dynamically linked libraries (DLLs)
shell (Tornado)
extensions, installing  202-205
loader, using the  91, 92
show routines  158
state management  75-77
stepping  78
string table  89
SWAB_16  121
SWAB_16_IF  121
SWAB_32  121
SWAB_32_IF  121
SYM_ABS  93, 99
SYM_ADDED  156
SYM_ADRS  105, 136
SYM_BSS  93, 99
SYM_COMM  99
SYM_DATA  93, 99
SYM_GLOBAL  93, 99
SYM_LOCAL  93, 99
SYM_REMOVED  156
SYM_TEXT  93, 99
SYM_TYPE  99
SYM_UNDEF  99
symbol command (Tcl)  169
symbol entries  89
symbol tables
common symbols  98, 101
defined symbols  97
external symbols  89, 98
loading  91
managing  97-99
target-server  5, 20, 21, 22, 90, 91, 97-99, 154
undefined symbols  97
symbols, see symbol tables
symFindByNameAndType( )  136
symlib  10


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

T

tacc  174
target servers  3-6, 16-17
see also back ends; symbol tables
architecture  4-6
-B option  20
back-end manager  6
-Bd option  30
cache, managing  103, 104-105
core  5, 17
event notification  27, 38
exiting  17
front ends  4
generic loader support library  106
rebooting targets  28
symbol table  5, 90, 91, 97-99, 154
target memory cache  6
target memory manager  5, 6
-V option  55
WTX protocol dispatch  4
target-server back-end interface API  10
target-server core API  9, 10
target-server memory pool  102
sizing  104
targetServerRestart( )  28
Tcl (tool command language)  8
see also wtxtcl tool; WTX Tcl API
Gopher scripts, sending  162
interpreter, see wtxtcl tool
loader, using the  92
unwinding  180
and WTX protocol  148
tcl directory  13
text section protection  153
TEXT_ACCESS  156
TGT_OPS structure  23-25, 39, 42
initializing  54, 59
TGT_RESET  156
tgtCacheTextUpdate( )  105, 145
tgtlib  10
tgtmem  10
tgtMemCacheSet( )  103, 144
tgtMemProtect( )  105
tgtMemRead( )  103
tgtMemWrite( )  103, 142
tgtMemWriteByte( )  142
tgtMemWriteShort( )  142
tgtTextProtect( )  145
threads (target server)  7-8
timeouts
changing for debugger  83
handling  179
TOOL_ATTACH  156
TOOL_DETACH  156
TOOL_MSG  156
tools, host development
see also browser; CrossWind; launch toolbar; launcher; shell; wtxtcl tool
adding  217-227
building an application  218-220
compiling an application
UNIX  220
Windows  220-221
creating an application  217-222
directories and files, naming  218
documenting  227
installing an application
UNIX  223-224
Windows  225-227
man pages, creating (UNIX)  222
testing an application
UNIX  221
Windows  222
event strings  156
and events  171-175
extending  193-216
registering for event notification  172
requests, sending  17
Tools.h++  63
Tornado registry, see registry
type abstractions  105


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

U

UDP (User Datagram Protocol)  33
UDP/IP interpreter  45
UNKNOWN  156
unloader, object-module, see loader
UNPACK_16  126
UNPACK_32  126
unwinding  180
USER  156


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

V

-V option (target server)  55
VIO_WRITE  156
vioFd symbol  176
virtual I/O (VIO)  154, 175-178
virtual I/O thread  8
Visual C++  44, 64
void * type  105
VxVMI (optional product)  105, 153


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

W

WDB
see also WDB agent; WDB back ends; WDB protocol
packet drivers  46
reply packets  35-36
request packets  33-35
WDB agent  2-3
Gopher  2-3
interface  6, 10
reply errors  36-38
reply packets  35-36
sending and receiving datagrams  45-47
target-side code  45-46
WDB back ends  17-18, 30, 32-47
building
UNIX  43-44
Windows  44-45
host-side support, creating  38-45
initializing  39-42
RPC client-side transport, initializing  41-42
RPC communication, enabling  41, 43
target link type, defining  42
writing  32-47
WDB protocol  1, 2-3, 33-38
WDB_EVENT_GET  38
WDB_EVT_DATA  79
WDB_MEM_REGION  67
WDB_MEM_XFER  67, 69
WDB_POOL_SIZE  105
WDB_TARGET_CONNECT  35
WDB_TARGET_PING  35
WDB_TGT_INFO  61
wdbserialInit( )  40-42
WIN32 macro (Windows only)  45
Wind DeBug protocol, see WDB protocol
Wind River tool exchange protocol, see WTX protocol
wpwrLogErr( )  146
wpwrLogWarn( )  146
wpwrutil  10
wpwrutil library  55
write functions (back end)
for memory  67-71
for registers  71-75
WTX C API  8, 183-191
see also C language
archive (libwpwr.a)  183
initializing a session  183
target server
attaching to a  184
information about, getting  184
Tcl API, using with the  190
using  185-190
WTX protocol  1, 2, 3-6, 147-191
creating a Tornado application  217-222
dispatch  4
errors, handling  180-182
Gopher support  158-165
language support  148
message format  150
requests
events, managing  154-157
object module, managing  153
sessions, managing  151
symbolic debugging facilities  152
symbols, managing  154
target memory access  152, 153
target servers, attaching to  152
tasks, managing  154
virtual I/O  154
timeouts, handling  179
virtual I/O  175-178
WTX_CORE  150
WTX registry, see wtxregd
WTX Tcl API  9, 165-182
see also Tcl
C API, using with the  190
enumerated constant types  173
errors, handling  180-182
events, working with  171-175
memory, handling  168-169
object modules, working with  170
target functions, calling  178
target server
attaching to a  166-167
information about, getting  167
multiple connections, working with  179
symbol table, working with the  169-170
tasks, working with  171
Tcl interpreters, using with other  191
timeouts, handling  179
virtual I/O, working with  175-178
wtxtcl session, starting a  166
WTX Tcl handle  167
WTX thread  7
WTX_CORE  150
WTX_EVENT_CTX_EXIT  174
WTX_EVENT_TEXT_ACCESS  174
WTX_GOPHER_EVAL  153
WTX_MEM_ALLOC  152, 153
WTX_MEM_FREE  152
WTX_MEM_READ  152
WTX_OBJ_MODULE_LOAD  153
wtxErrorGet( )  183
wtxEventGet command (Tcl)  172, 178
wtxEventpointAdd command (Tcl)  173
wtxEventPoll command (Tcl)  172
wtxFuncCall command (Tcl)  178
wtxGopherEval( )  162
wtxHandle command (Tcl)  179
wtxInfo( )  184
wtxInfoQ command (Tcl)  166
wtxInfoQ( )  184
wtxInitialize( )  183
wtxMemAlloc command (Tcl)  168
wtxMemRead command (Tcl)  168, 169
wtxObjModuleInfo command (Tcl)  170
wtxObjModuleList command (Tcl)  170
wtxObjModuleLoad command (Tcl)  92, 170
wtxregd (WTX registry)  16, 152
cleaning up  29
shutting down target servers  17
wtxRegisterForEvent command (Tcl)  82, 172
wtxSymFind( )  162
wtxSymListGet command (Tcl)  169, 170
wtxtcl tool  49, 50, 66-67, 82, 166
loader, using the  92
wtxTclHandle( )  191
wtxTclHandleGrant( )  191
wtxTclHandleRevoke( )  191
wtxTclInit( )  191
wtxtest tool  47
wtxToolAttach command (Tcl)  179, 191
wtxToolAttach( )  184, 191
wtxTsInfoGet command (Tcl)  167
wtxTsInfoGet( )  184


A  B  C  D  E  F  G  H  I  L  M  N  O  P  R  S  T  U  V  W  X 

X

XDR streams  34, 35
xdr_WDB_PARAM_WRAPPER  35
xdr_WDB_REPLY_WRAPPER  37

[Contents][Prev]