Index

agent, see target agent

address(es), memory

current, setting 250

add-symbol-file command (debugger) 347

agentModeShow( ) 233

displaying information about 97

ALT+F (open recently-used file) 65

ALT+F t (print) 70

ALT+F3 (find) 68

ALT+Fa (save as) 66

ANSI C

function prototypes 149

header files 150

-ansi compiler option 156

application files

adding 96

closing 98

creating 96

linking files with 96

application I/O (debugger) 349

application modules 148-163

see online loadLib; unldLib

compiling with Diab

compiling with GNU

CPU type, defining

displaying information about (browser) 311-314

loading during debugging 348

option flags 352

make variables 182-186

makefiles

include files, using 186

module IDs 162

unloading

command line, from the 163

workspace, from the 330

application wizard

custom VxWorks images, creating 107

downloadable applications, creating 91

applications

adding source code 82

architecture-independent 84

creating new source code 83

custom build rules, using 83

linking to VxSim 199

VxSim, building 198

VxWorks for, configuring 84

architecture-independent development 84

architecture-specific development

CPU type

Diab, defining for 158

GNU, defining for 154

Diab compiler invocations 159

GNU compiler invocations 155

VxSim, simulated target 193-213

arp command 58

Arrange Icons command 53

arrays (WindSh) 253

assignments (WindSh) 250

Attach command (ALT+F6) (Debug menu) 337

attach system command (debugger) 355

Attribute Pane checkbox (Options window) 394

attribute panes 63

authorizations, see security

auto scaling 125

AUTOREGISTER_COCLASS 389

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

B

-B option (target server) 290

b( ) 233

system mode, in 239

back ends, communications 282

Back Trace command (ALT+7) (Debug menu) 343

backplane

installing boards in 24

processor number 45

bd( ) 232

bdall( ) 232

bh( ) 233

BINHEX 438

board support packages (BSP) 164-167

boot media 22

building projects from 191

creating 80

creating projects 109

definition 76

documentation 166

header file (config.h) 168

initialization modules 166

make variables 182-186

parameter variables 184

pre-existing, using

project facility, outside the 80

project facility, with 80

simulator, using 80

system library 165

third-party 79

Tornado 1.0.1, using 79

Tornado 2.0, using 79

Tornado 2.2, using 79

virtual memory mapping 166

boards, see target board

boot images 143

boot media 22

boot programs

boot parameters, configuring 142

building 143

configuring 142-144

creating new 48

serial connection, configuring for 28

TSFS, for 143

boot ROMs

see also NetROM ROM emulator

compression 191

custom, building 145

emulators, substituting ROM 23

installing 22

makefile ROM-resident system images 173

system image (VxWorks), building a new 483

BOOT_EXTRA 438

bootable applications 187-191

auto scaling 125

creating 125

definition 75

initialization routines, adding application 125

linking 187

size of 188

Bootable System icon 78

bootChange( ) 233

BOOTCONFIG 437

booting 40-50

@ command 46

commands 43

display, boot 46

networks, initializing 495

parameters 42-46

command-line format 48

displaying current, at boot time 42

nonvolatile RAM, effect of 48

BOOTINIT 437

bootrom 176

bootrom_res 176

bootrom_res_high 173

bootrom_uncmp 176

bootrom_uncmp.hex 188

CTRL+BREAK (interrupt) 242

break thread command (debugger) 357-358

breakpoints

multiple, setting 331

setting 333

shell commands for 233

temporary, setting 333

threads, setting in 357-358

Breakpoints command (Debug menu) 331

browse( ) 234

browser (HTML)

specifying 415

browser (Tornado) 297-322

Browser command (Tools menu) 298

Browser Configuration dialog box 300

browser.tcl 322

BSP, see board support packages

bsp2prj target 192

bss segment 489

Build dialog box 123

Build menu

adding/removing custom commands 412-414

Build Output command (Window menu) 53

Build Output window 104

Build Specification icon 78

build specifications 126-134

assembler options, specifying 131

changing 127

compiler options, specifying 129

creating new 133

current build, selecting for 133

downloadable application 100

link order, specifying 131

linker options, specifying 132

makefile macros, specifying 129

makefile rules, working with 128

pre-set build macros 102

property sheets, working with 127-132

Build toolbar

building

build rules, custom 83

COM/DCOM projects 387

custom VxWorks 122

command line, using a 124

downloadable applications 98-106

VxSim applications 198

built-in functions 156

buttons

Build toolbar 105

Tornado Launch toolbar 52

WindView event triggering 52

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

C

-c compiler option 155

C interpreter (WindSh) 243-260

c( ) 232

current task, using 250

system mode, in 239

C++ support 260-263

compiling application modules

Diab, using 160

GNU, using 156

demangling function names 262

host and target strategies, using different 234

overloaded function names, reconciling 261

shell commands for 234

C++_COMPILER 183

C++_WARNINGS 183

C++FLAGS 183

cables, connecting 25

cache

initializing 489

call command (debugger) 349

CAPS LOCK key 52

Cascade command 53

CC_COMPILER 183

CC_DEFINES 184

CC_INCLUDE 184

CC_OPTIM 184

CC_WARNINGS 183

cd( ) 229

CFLAGS 183

Diab compiler 158

GNU compiler 154

character arrays, see strings

characters, control, see control characters

checkStack( ) 227

classes (kernel objects)

displaying information about (browser) 310

classShow( ) 234

clocks

system 497

Close All command 53

Close command (File menu) 66

code

unsupported, directory for 430

code examples

debugger extensions 369-370

makefiles

sample (mv147) 181

skeleton for application modules 186

NetROM startup file 32

system mode debugging 240

coding conventions 447-480

colors, changing window 400-402

COM

authenticating servers 390

building projects 387

creating applications 372

proxy and stub code, linking 387

registering

proxy DLLs (Windows) 388

servers 389

type library 388

support for, adding 373

Win32 clients, building 387

COM 374

COM wizard 375-384

automation datatypes 377

clients, choosing 381

generated files 383

COM_CORE 373

COM_SHOW 374

command-line parameters 48

commands, built-in (WindSh)

C++ support 234

debugging 232

network information, displaying 236

system information, reporting 228

system, modifying the 232

target routines, differentiating from 255

task information, reporting 226

tasks, managing 225

VxWorks objects, displaying 234

comments (WindSh) 251

compiler environment

VxSim 198

compiler options

see also specific compiler options

build specifications, and 129

debugging and optimization, problems with 130

Diab 159

conflicts among, identifying 119

compiling

C modules

GNU, using 155

C++ modules

Diab, using 160

GNU, using 156

make variables 183

Component folder icon 78

Component icon 78

component tree (VxWorks view) 114

components, VxWorks 75

configuring 113-120

dependencies, calculating 116

parameters, changing 120

size of, estimating image 120

compress tool 191

COMPRESSION 438

compression, boot ROM 191

config target directory 422

config.h 168

config.h

VxSim 201

CONFIG_ALL 185, 437

CONFIG_ALL_H 437

configAll.h 168

see also configuration

configuration header files 168

configuration management, see version control

Configure Target Servers dialog box 279-288

authorizations, setting 281

Change Property drop down list 281

options, specifying 281-288

reserving target servers 296

configuring

alternatives 170

command-line 147-192

directory and files 422

FTP server (Windows 95) 484

host-target communication 14-37

jumpers 24

module (usrConfig.c) 169

NetROM ROM emulator 31-34

network software, host 21-22

option dependencies 171

options (INCLUDE constants) 169

project facility for, using 148

standalone PCs 27

target 20

target hardware 22-25

target server 278-290

VxSim for networking 208

WFTPD (Windows 95) 484

console devices 493

CONSOLE_BAUD_RATE 493

CONSOLE_TTY 493

context-sensitive help

workspace, in 77

Continue command (F5) (Debug menu) 335

control characters (WindSh) 256

conventions

Makefile macros 434

copy character (CTRL+C)

cross-development 3-11, 148-192

Copy command (Edit menu) 67

cplusCtors( ) 234

cplusDtors( ) 234

cplusStratShow( ) 234

cplusXtorSet( ) 234

CPU type, defining

Diab, for 158

GNU, for 154

VxSim 199

Create Project window 91

cret( ) 232

commands

Diab 157

GNU 153

CrossWind 323-370

crosswind.tcl 366

CTRL+A (select all) 67

CTRL+BREAK (interrupt) 242

CTRL+C

copy character

completing symbol and path names 220

interrupt (console) 242

CTRL+D

function synopsis, printing 221

quitting 218

CTRL+F4 (close file) 66

CTRL+G (go to) 68

CTRL+H (delete) 257

CTRL+N (new file) 63

CTRL+O (open file) 65

CTRL+P (print) 70

CTRL+S (save file) 66

CTRL+SHIFT+X (reboot) 238

CTRL+U (delete line) 257

CTRL+V (paste)

customizing Tornado 391-415

CTRL+W (function reference page) 221

CTRL+X

cut 67

reboot 49

CTRL+X (reboot)

VxSim 196

CTRL+Z (undo edit) 67

cursor, text 66

navigating 68

Customize Tools dialog box 405-411

macros, using 407

customizing VxWorks 107-125

see also components

building VxWorks 122

command line, using a 124

components, configuring 113-120

image type, selecting 121

project files, creating 110

projects, creating 107

Cut command (Edit menu) 67

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

D

-D arch compiler option 159

d( ) 230

current address, using 250

data types 243

data variables 246

DATASEGPAD 437

DCOM 374

DCOM (VxDCOM option)

authenticating servers 390

building projects 387

creating applications 372

demo, supporting the 374

proxy and stub code, linking 387

registering

proxy DLLs (Windows) 388

servers 389

type library 388

support for, adding 373

Win32 clients, building 387

DCOM wizard 375-384

automation datatypes 377

generated files 383

DCOM_OPC 374

DCOM_PROXY 374

DCOM_SHOW 374

-DCPU compiler option

debugger (CrossWind) 323-370

Debug menu 325

Add Symbols command 369

Attach command 337

Back Trace command 343

Breakpoints command 331

Continue command 335

Detach command 338

Download command 352

Interrupt Debugger command 331

Memory command 344

Registers command 342

Run command 330

Source Search Path command 329

Step Into command 335

Step Out command 335

Step Over command 336

Stop Debugging command 328

Toggle Breakpoint command 333

Toggle Temp. Breakpoint command 333

Variables command 341

Watch command 340

application I/O 349

auto-attaching to tasks 403

behavior, controlling 352-353

buttons 325-327

command-line interface 346-353

console window 346-353

customizing 402

Tcl, using 366-370

code examples 369-370

GDB Tcl interpreter 359-366

commands, submitting 359-360

expressions, evaluating 362

GDB command line, using 360

GDB facilities, invoking 362-364

GUI Tcl interpreter, switching to 368

I/O file descriptors, closing 363

linked lists, traversing 364-366

list of Tcl elements, returning 363

redirecting I/O 363

routine names, returning 364

scripts, debugging GDB-based 361

symbolic addresses 364

symbols

returning local 363

testing for 364

verbose error printing 361

.gdbinit, disabling 352

GUI 323-327

GUI Tcl interpreter 366-370

extensions, creating 369-370

code examples 369-370

GDB Tcl interpreter, switching to 368

hexadecimal, displaying 402

initialization files 347

customizing GUI 366-368

internal parameters, changing 352-353

menu commands 325-327

quitting 328

redirecting I/O 349

source search path, setting 329

starting 328

toolbar 325-327

unloading modules 330

application modules

breakpoints

multiple, setting 331

setting 333

temporary, setting 333

using 331-336

calling sequences, inspecting 343

command-line 346-353

Tcl procedures, defining 360

examining data 338-344

exit status, reporting 352

expressions, evaluating 349

local variable values, displaying 341

naming session 353

object files, specifying 347

primitives for, shell 351

relative paths, translating 352

shell, from the 216

single-stepping 335

source code, displaying 345-346

source search path 329

stack frame summaries, displaying 350

stack size, setting 353

subroutines

executing while debugging 349

symbol values

monitoring 340

system mode 353-359

code example 240

shell, from the 238-242

target memory, displaying 344

target register values, displaying 342

targets, connecting to 351

task mode 354

tasks

attaching 337

interrupting 331

priority, setting 353

releasing 338

restarting 335

running 330

threads, working with 354-359

timeout, download 353

WTX protocol requests, sending 351

defs.bsp include file 182

DEL key (delete) 67

delete character

BACKSPACE 257

CTRL+H 257

Delete command (Edit menu) 67

DELETE key

projects, removing 106

delete-line character (CTRL+U) 257

demangling, see name demangling

demo host directory 428

depend.bspname file

generating 433

dependencies

component 116

makefile 99

Dependencies dialog box 99

Detach command (Debug menu) 338

development environment 2-11, 167

devs( ) 228

Diab tools

downloadable applications, and 103

directory tree 419-430

disassembling (l( )) 230

Disassembly command (View menu) 345

docs directory 419

see also online documentation

documentation

online reference pages (on host) 166

documentation guidelines

conventions

C format 463-468

Domain Name Service (DNS) 21

dosFs file systems

downloadable applications 74

dosFsDevInit( ) 494

dosFsInit( ) 495

Download command (Debug menu)

option flags 352

download options 392

Downloadable Application icon 78

building 98-105

errors and messages, displaying 104

specifications, providing 100

creating 91-106

Diab tools, and 103

downloading 106

project files, creating 95

projects, creating new 91

downtcl command (debugger) 368

drivers

installing 494

DSM_HEX_MOD 224

-DTOOL compiler option

-DTOOL_FAMILY compiler option

edit mode, shell (WindSh) 263-265

dual mode 15

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

E

-e _romInit entry point option 190

Edit menu 67-69

Copy command 67

Cut command 67

Delete command 67

Find command 68

Find Next command 68

Find Previous command 68

Go To command 68

Next Error/Tag command 68

Paste command 67

Previous Error/Tag command 68

Replace command 68

Select All command 67

Undo command 67

input mode, toggling to 257

editor (external)

alternate

Tools menu command for, creating (example) 410

specifying 395

editor (Tornado) 61-71

preferences, setting 394-396

undo levels, setting 395

undoing edits 67

-ei compiler option 159

Enhanced Network Driver (END) 26

ROM-based VxWorks 190, 500

environment variables, host 167

HOME 430

shell behavior, controlling 223

Windows 167

environment, see cross-development; development environment; host environment; target environment

errorInfo global variable (debugger) 361

errors

Tcl 446

unwinding 446

ESC key (edit/input mode toggle) 257

event triggering, starting 52

-ew compiler opton 159

exception handling

initializing 493

excInit( ) 494

excTask( ) 494

excVecInit( ) 489

exit( ) 218

expressions, C language (WindSh) 245-250

External Dependencies folder

makefile dependencies, listing 99

External Dependencies folder 95

external mode, see system mode

EXTRA_DEFINE 186, 435

EXTRA_DOC_FLAGS 438

EXTRA_INCLUDE 186, 435

EXTRA_MODULES 102

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

F

F3 (find next) 68

F4 (next error) 68

File menu 63

Add Project to Workspace command 106

Close command 66

Open command 65

Page Setup command 70

Print command 70

Save As command 66

Save command 66

file tree 419-430

files

see also editor; navigation

attribute panes 63

closing 66

configuration header 168

Find command (Edit menu) 68

Find dialog box 68

Find Next command (Edit menu) 68

Find Object dialog box 114

Find Previous command (Edit menu) 68

flags, see compiler options

floating-point support

initializing 495

floatInit( ) 495

-fno-builtin compiler option 156

fonts, changing screen 400-402

frame command (debugger) 350

Free Software Foundation (FSF) 152

see also GNU ToolKit User's Guide

FTP (File Transfer Protocol)

password, user (boot parameter) 45

server (WFTPD) (Windows 95) 483-485

configuring 484

starting 484

ftp password 484

function calls (WindSh) 247

parentheses, omitting 249

reference page, displaying HTML 221

synopses, printing 221

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

G

-g compiler option

Diab 159

see also debugger; debugging

GDB (GNU debugger)

customizing with Tcl 347

initialization files 347

gdb command (debugger) 362

gdb.tcl 347

gdbEvalScalar command (debugger) 362

gdbFileAddrInfo command (debugger) 363

gdbFileLineInfo command (debugger) 363

.gdbinit 347

gdbIOClose command (debugger) 363

gdbIORedirect command (debugger) 363

gdbLocalsTags command (debugger) 363

gdbStackFrameTags command (debugger) 364

gdbSymbol command (debugger) 364

gdbSymbolExists command (debugger) 364

General Public License (GNU) 152

GNU binary utilities, working with 411

GNU ToolKit 6, 152

General Public License 152

Go To command (Edit menu) 68

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

H

h target directory 424

h( ) 229

hardware

initializing 489

header files 149-152

ANSI 150

function prototypes 149

CPU type

Diab, defining for 158

GNU, defining for 154

hiding internal details 152

help

context-sensitive

workspace, in 77

online

reference documentation 114

Help menu

About Tornado command 63

help set command (debugger) 352

help( ) 229

HEX_FLAGS 438

history facility, shell 263

HOME host environment variable 430

host

communication modes 14

directory and file tree 420-421

network software

configuring 21-22

initializing 21

system names and addresses, establishing 22

setting up 17-19

host directory 420-421

host shell, see shell

host-os host directory 420

hosts file (Windows) 22

hostShow( ) 236

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

I

-I compiler option 150

see also specific constants

i( ) 227

system mode, in 239

icmpstatShow( ) 236

icons, Workspace 78

ifShow( ) 236

INCLUDE constants 169

include files

see also header files

configuration headers 163

make facility 182

include host directory 420

INCLUDE_COM 374

INCLUDE_COM_SHOW 374

INCLUDE_CPLUS 496

INCLUDE_DOSFS 494

INCLUDE_EXC_HANDLING 494

INCLUDE_EXC_TASK 494

INCLUDE_FLOATING_POINT 495

INCLUDE_HW_FP 495

INCLUDE_INSTRUMENTATION 496

INCLUDE_IO_SYSTEM 492

INCLUDE_LOGGING 494

INCLUDE_MMU_BASIC 496

INCLUDE_MMU_FULL 496

INCLUDE_NET_INIT 495

INCLUDE_NTPASSFS 198

INCLUDE_PIPE 494

INCLUDE_PROTECT_TEXT 496

INCLUDE_PROTECT_VEC_TABLE 496

INCLUDE_RAWFS 494

INCLUDE_RT11FS 494

INCLUDE_SIGNALS 494

INCLUDE_SM_OBJ 496

INCLUDE_SPY 495

INCLUDE_STARTUP_SCRIPT 497

INCLUDE_STDIO 494

INCLUDE_SW_FP 495

INCLUDE_TIMEX 495

INCLUDE_TSFS_BOOT_VIO_CONSOLE 144

INCLUDE_TTY_DEV 493

INCLUDE_USER_APPL 187

INCLUDE_WDB 497

INCLUDE_WDB_BANNER 139

INCLUDE_WDB_COMM_PIPE 197

INCLUDE_WDB_START_NOTIFY 139

INCLUDE_WDB_TTY_TEST 139

INCLUDE_WDB_USER_EVENT 139

INCLUDE_WDB_VIO 139

info threads command (debugger) 356

inhibit-gdbinit (debugger) 352

initialization 487-500

initialization files 430

input mode (WindSh) 257

INSERT key 67

installing

VxSim optional product 204-207

Interface Definition Language (IDL) 382-383

editing files 382

Interrupt Debugger command (ALT+SHIFT+F5) (Debug menu) 331

interrupt key

console (CTRL+C) 242

Tornado (CTRL+BREAK) 242

interrupt/exception vector table 316

interrupts

thrashing 492

vectored

initializing 489

VxSim

Windows 201

intLockLevelSet( ) 490

intUnlock( )

WindView, and 203

intVecBaseSet( ) 489

intVecShow( ) 236

I/O

redirecting

C interpreter 257-260

debugging, during 349

shConfig, using 219

virtual 11

I/O system

initializing 492

standard input/output/error 493

standard I/O

ioGlobalStdSet( ) 493

iosDevShow( ) 235

iosDrvShow( ) 235

iosFdShow( ) 235

iosInit( ) 492

ipstatShow( ) 236

iStrict( ) 226

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

J

jumpers 24

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

K

kernel 4

excluding facilities 170

execution, start of 488

initializing 490-491

kernelInit( ) 490-491

keyboard settings 52

keyboard shortcuts

ALT+3 (display symbol values) 340

ALT+4 (display local variables) 341

ALT+5 (display register values) 342

ALT+6 (target memory) 344

ALT+7 (back trace) 343

ALT+D h (source search path) 329

ALT+F (open recently-used file) 65

ALT+F t (print) 70

ALT+F3 (find) 68

ALT+F6 (attach debugging) 337

ALT+Fa (save as) 66

ALT+SHIFT+F5 (interrupt) 331

BACKSPACE (delete) 257

CTRL+A (select all) 67

CTRL+BREAK (interrupt) 242

CTRL+C

copy

completing symbol and path names 220

interrupt (console) 242

CTRL+D

function synopsis, printing 221

quitting 218

CTRL+F4 (close file) 66

CTRL+F5 (step over) 336

CTRL+G (go to) 68

CTRL+H (delete) 257

CTRL+N (new file) 63

CTRL+O (open file) 65

CTRL+P (print) 70

CTRL+S (save file) 66

CTRL+SHIFT+X (reboot) 238

CTRL+U (delete line) 257

CTRL+V (paste)

line editing, shell (WindSh) 263-265

CTRL+W (function reference page) 221

CTRL+X

cut 67

reboot 49

CTRL+Z (undo edit) 67

DEL (delete) 67

ESC key (input/edit mode toggle) 257

F10 (step into) 335

F3 (find next) 68

F4 (next error) 68

F5 (continue debugging) 335

F6 (run task) 330

F8 (temporary breakpoint) 333

F9 (toggle breakpoint) 333

navigation, for file 68

SHIFT+F3 (find previous) 68

SHIFT+F4 (previous error) 68

SHIFT+F5 (step out) 335

kill, see stopping

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

L

l( ) 230

current address, using 250

Launch Browser dialog box 298

Launch Shell dialog box 217

ld( ) 161-163, 219

path name orthography 253

LD_CALL_XTORS 223

LD_COMMON_MATCH_ALL 224

LD_PATH 224

LD_SEND_MODULES 224

LD_SEND_MODULES facility 162

ldarch linker

flags 178

LDFLAGS 185

lib target directory 425

LIB_EXTRA 185, 435

LIBS 102

LICENSE.TXT 420

linking

application modules 160

bootable 187

dynamic 219

system image, VxWorks 178

flags 179

object modules, additional 180

VxSim, and 199

linkSyms.c 111

list (Tcl) 441

literals (WindSh) 246

see also strings

lkAddr( ) 228

lkup( ) 229

load command (debugger) 161-163, 348

LOCAL_MEM_LOCAL_ADRS 174

Lock on Startup button (Configure Target Servers dialog box) 296

locking (target server) 296

Log Console window (target server) 291

logging facilities

initializing 493

logInit( ) 494

logTask( ) 494

ls( ) 229

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

M

m( ) 233

MACH_EXTRA 434

adding object modules 180

compile-time macros, specifying 435

make facility (GNU) 176

Makefile 433-438

customizing 433-438

macros 434-438

bootConfig.c file, alternate 437

bootInit.c file, alternate 437

compression program 438

configAll.h file, alternate 437

configuration files, modifying 437

conventions 434

dataSegPad.s file, alternate 437

defining without modifying source code 436

header directory locations, adding 435

host object-format-to-hex program 438

library archives, including 435

object modules, adding 434

linked to compressed ROM images 438

without touching source 436

preprocessor flags, adding 438

target directory tree 437

usrConfig.c file, alternate 437

Makefile (VxWorks) 176

linking system images 178

VxSim 201

Makefile file 112

makefile rules, custom 128

makefiles 181-187

bootable applications, modifying for 187

code examples

sample (mv147) 181

skeleton for application modules 186

creating 181

dependencies, calculating 99

include files 182

application modules, and 186

rebuilding VxWorks 176

ROM-resident system images 173

variables, include file 182-186

BSP parameters, for 184

compiling, for 183

customizing run-time, for 185

makeSymTbl tool 189

malloc( ) 491

Manage command (Tools>Target Server menu) 293-296

Manage Target Servers dialog box 293-296

authorizations, setting 296

Select Action drop-down list 294

mangling, see name demangling

mathHardInit( ) 495

mathSoftInit( ) 495

memAddToPool( ) 491

memDesc.c 166

memory

allocation 491

availability of, determining 491

cache size, changing target server 285

fragmentation, troubleshooting 318

leaks, troubleshooting 317

target, manipulating 233

usage, displaying data about 304

Memory command (ALT+6) (Debug menu) 344

memory partitions

displaying information about (browser) 309

memory pool

adding to 491

initializing 491

memPartLib 491

memPartShow( ) 235

memShow( ) 235

message queues

displaying information about (browser) 308

migrating

files between projects 84

MIPS

ROM-resident images 173

Mixed Source and Disassembly command (View menu) 345

MMU

see also application modules; tasks

moduleIdFigure( ) 236

modules

optional (INCLUDE constants) 169

moduleShow( ) 235

mqPxShow( ) 235

mRegs( ) 232

msgQShow( ) 235

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

N

name demangling (C++) 262

navigating 68

Go To command 68

netLibInit( ) 495

NetROM ROM emulator 23

back end connection, as 30-37

code example 32

configuring 31-34

target agent for, configuring 31

target server, starting 34

troubleshooting 35-37

netstat command 58

netstatShow( ) 236

networks

configuring simple 21-22

excluding from VxWorks 171

initializing 495

target-server back end connection, as 26

VxSim 203-213

New command (File menu) 63

Next Error/Tag command (Edit menu) 68

NUM LOCK key 53

NUM_TTY 493

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

O

-O compiler option 156

-O2 compiler option 156

Object folder icon 78

Object Modules folder 95

object modules, see application modules

online documentation

function reference pages, displaying 221

reference pages (on host) 166

OPC interfaces (DCOM)

non-automation types 382

Open command (File menu) 65

operators (WindSh) 247

using < and > 257

OPT_TERMINAL 493

optional VxWorks features (INCLUDE constants) 169

optional VxWorks products

VxMP 4

VxSim, target simulator 8, 193

VxVMI 4

WindView 8

Options command (Tools menu) 392

Options window 392-404

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

P

Page Setup command (File menu) 70

Page Setup dialog box 70

passFs (VxSim) 197

paste character (CTRL+V)

shell and target server 266

Paste command (Edit menu) 67

path names

typing conventions 252

performance monitoring

tools for, including 495

period( ) 225

PHYS_MEM_DESC 166

see also sysPhysMemDesc[ ]

ping command 58

pipeDevCreate( ) 494

pipeDrv( ) 494

pipes

bootable applications, creating 125

pointers (WindSh) 253

arithmetic, handling 254

POST_BUILD_RULE 102

PowerPC

ROM-resident images 173

Previous Error/Tag command (Edit menu) 68

primitives (WindSh)

debugging 351

Print command (File menu) 70

Print dialog box 70

printErrno( ) 228

printLogo( ) 229

priority inversion

troubleshooting 320

prj_default target 191

prj_diab target 192

prj_diab_def target 192

prj_gnu target 192

prj_gnu_def target 192

PRJ_LIBS 96

prjComps.h 112

prjConfig.c 112

prjParams.h 112

processor number (boot parameter) 45

project facility 73-142

BSPs with, using pre-existing 80

customizing VxWorks 107-125

downloadable applications, creating 91-106

GUI 76

makefile dependencies, calculating 99

manual configuration, versus 74, 164

target-host communication interface, configuring 134-142

terminology 74

project files, see application files

projectName.wpj 112

projects 73-145

Properties: Build specification window 100

Macros tab 102

makefile macros, viewing 129

Rules tab 101

pwd( ) 229

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

Q

quit( ) 218

quitting

see also stopping

debugger 328

shell sessions 218

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

R

-r linker option 161

RAM_HIGH_ADRS 184

RAM_LOW_ADRS 184

rawFs file systems

rebuilding VxWorks image 176

rawFsDevInit( ) 494

rawFsInit( ) 495

README.TXT 420

reboot character (CTRL+X) 49

reboot character (CTRL+X)

VxSim 196

reboot( ) 238

rebooting 49

shell, from the 238

redirection, I/O (WindSh) 257-260

scripts, using 258

shConfig, using 219

reference entries

conventions, writing 463

refgen tool (Wind River) 463

Registers command (ALT+5) (Debug menu) 342

registry, Tornado 17

changing 18

customizing 404

repeat( ) 225

Replace command (Edit menu) 68

Replace dialog box 69

resource host directory 421

ROM

VxWorks in 172

ROM, see boot ROMs; NetROM ROM emulator

ROM_LDFLAGS 185

ROM_SIZE 184

system images, creating 190

ROM_TEXT_ADRS 184

romInit( ) 500

romInit.o 190

romInit.s 112, 166

romStart( ) 500

romStart.c 112

routestatShow( ) 236

routines

conventions

C layout 451

documentation 465

naming 459

routines, see function calls; commands, built-in

RPC (Remote Procedure Calls)

excluding from VxWorks 171

rt11Fs file systems

target server authorizations 295

rt11FsDevInit( ) 494

rt11FsInit( ) 495

rules.bsp include file 182

run command (debugger) 349

resetting I/O 349

system mode, not in 354

Run command (F6) (Debug menu) 330

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

S

s( ) 233

current task, using 250

system mode, in 240

Save As command (File menu) 66

Save command (File menu) 66

scalability 170-172

VxWorks features 169

scripts, startup 497

SCROLL LOCK key 53

searching 68

security

Select All command (Edit menu) 67

Selection folder icon 78

semaphores

displaying information about (browser) 307

semPxShow( ) 235

semShow( ) 235

serial lines

target-server back end connection, as 27-30

testing 28

servutil.exe service utility (Windows NT) 481-482

set command (debugger) 352-353

SetTimer( ) 202

SETUP directory 419

setup, see configuration

setup.log log file 420

SH_GET_TASK_IO 223

share directory 419

shared-memory objects (VxMP option)

shell environment variables, setting 223

shConfig (Tcl)

redirecting I/O 219

shell (WindSh) 215-275

C control structures 254

C interpreter 243-260

C++ support 260-263

calculating in 222

commands, built-in 225-237

differentiating from target routines 225

list of 255

components 273

control characters 256

data conversion 222

debugging from 216

edit mode 263-265

input mode, toggling to 257

environment variables, setting 223

function synopsis, printing 221

history facility 263

input mode 257

interpretation, layers of 274

path names

preprocessor macros 255

system mode debugging 238-242

target from host, controlling 271

target routines from, running 237

target symbol names, typing 220

Tcl interpreter 267-271

initializing with 270

starting 267

types, compound and derived 254

Shell command (Tools menu) 217

shellHistory( ) 229

shellPromptSet( ) 229

SHIFT+F3 (find previous) 68

SHIFT+F4 (previous error) 68

show command (debugger) 352

show routines (shell) 234

show( ) 234

shParse utility (Tcl) 269

sigInit( ) 494

simulator, see VxSim

simulator, target (VxSim) 8

starting 52

single-stepping

shell commands for 233

smMemPartShow( ) 235

smMemShow( ) 235

so( ) 232

source code (VxWorks)

customizing 177

source code directories (VxWorks) 425

Source command (View menu) 345

source control, see version control

Source File icon 78

Source folder icon 78

source search path 329

Source Search Path command (ALT+D h) (Debug menu) 329

sp( ) 225

system mode, in 240

sps( ) 225

spy utility 495

spy utility (browser) 314

see also spyLib(1)

reporting mode, selecting 314

src target directory 425

src/demo host directory 428

stacks

overflow, troubleshooting 318

usage, checking (browser) 315

STANDALONE flag 189

standalone systems, using 27

standalone VxWorks systems 189

STANDALONE_NET 189

standard file headings 448

standard I/O

standard input/output/error 493

standard toolbar 62

starting

browser, Tornado 52

debugger 52

event triggering (WindView) 52

shell, Tornado 52

target servers 54

Tornado 50-53

VxSim target simulator 52

WindView 52

startup

see also initialization

VxWorks, sequence of events 487-500

ROM-based 190

scripts 497

ROM-based 500-501

state-information files 431

statements (WindSh) 245

status line (Tornado) 52

_ _STDC_ _ 149

Step Into command (F10) (Debug menu) 335

Step Out command (SHIFT+F5) (Debug menu) 335

Step Over command (CTRL+F5) (Debug menu) 336

Stop Debugging command (Debug menu) 328

stopping

absolute paths, avoiding 88

subroutines, see function calls; commands, built-in

subroutines, see routines

symbol table

creating VxWorks system 180

group numbers, module 162

standalone systems, in VxWorks 189

synchronizing 285

target server, configuring 284

symbols

VxSim 197

sysALib.s 112, 166

sysClkConnect( ) 492

sysClkRateSet( ) 492

sysHwInit( ) 489

sysHwInit2( ) 492

sysInit( ) 488

sysLib.c 112, 165

VxSim 201

sysMemTop( ) 491

sysPhysMemDesc[ ] 166

sysResume( ) 233

sysStatusShow( ) 233

sysSuspend( ) 233

boot ROMs, building with 483

system image

VxWorks

system images 107

see also customizing VxWorks

boot ROM

creating

excluding facilities 170-172

linking 178

makefiles, ROM-resident in 173

size of, considering 82

Tornado

VxWorks

creating custom 107-125

shell, from the 238-242

threads, managing 355-359

shell commands, using 239

target agent 9

system mode debugging

VxSim 197

networking, and 209

system modules, see system image

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

T

-T option (Tcl) 267

target

see also browser (Tornado)

communication modes 14

configuring 20

ROM emulation 31

directory and file tree 422-430

information about, displaying (browser) 301

monitoring state of (browser) 297-322

target agent 9

communication modes 14

END drivers, configuring 135

exception hooks, configuring for 140

initializing 497

kernel, starting before 140

NetROM, configuring for 31

macros, specifying 136

networks, configuring for 137

scaling 139

serial connections, configuring for 138

simulators, configuring integrated target 136

system mode 9

task mode 9

tyCoDrv connections, configuring 139

target board

backplane, installing boards in 24

cables, connecting 25

configuration header for 168

target directory 422-430

target environment 4-5

Target Information window 301

target name (tn) (boot parameter) 46

target server 277-296

Target Server File System (TSFS) 286

boot program for, configuring 143

target wtx command (debugger) 351

target.nr 166

TARGET_DIR 184

target-specific development

VxSim, simulated target 193-213

task mode 14

debugging 354

target agent 9

taskCreateHookShow( ) 235

taskDeleteHookShow( ) 235

taskIdDefault( ) 226

taskIdFigure( ) 227

taskRegsShow( ) 235

tasks

see also threads

CPU utilization, reporting 314

current, setting 250

debugging 355-359

displaying information about (browser) 306

IDs 249

interrupting 331

listing (browser) 303

names 249

referencing 249

shell commands for managing 225-228

stack checks, displaying (browser) 315

taskShow( ) 234

taskSwitchHookShow( ) 235

taskWaitShow( ) 235

Tcl (tool command language) 439-446

tcl command (debugger) 359-360

tcl host directory 421

Tcl_CreateCommand( ) 446

tcldebug command (debugger) 361

tclerror command (debugger) 361

-Tclmode option (Tcl) 267

tclproc command (debugger) 360

TCP/IP

Tornado tools, for 18

tcpstatShow( ) 236

td( ) 225

terminal characters, see control characters

terminating, see stopping

text cursor 66

navigating 68

tftpInfoShow( ) 236

TGT_DIR 437

tgtsvr.exe program 290

options, setting 290

this menu command (debugger: C++) 370

code example 370

thrashing 492

thread command (debugger) 357

thread IDs 355

breakpoints and system context 358

threads 354

breakpoints, setting 357-358

managing 355-359

summary information, displaying 356

switching

explicitly 357

implicitly 358-359

ti( ) 226

current task, using 250

tickAnnounce( ) 497

Tile command 53

timeout

NetROM 37

resetting

target server 238

wtx-load-timeout (CrossWind) 353

wtxTimeout (WindSh) 219

target server 283

timers

subroutine execution 495

Tk graphics library (Tcl) 439

Toggle Breakpoint command (F9) (Debug menu) 333

Toggle Temp. Breakpoint command (F8) (Debug menu) 333

Debug 325-327

Tornado Launch 51

Tools menu

adding/removing custom commands 405-411

Browser command 298

Customize command 405

customizing 405-411

alternate editor, for 410

binary utilities, for 411

version control, for 409

Web link to Wind River, for 411

Debugger command 328

No Custom Tools placeholder 405

Options command 392

Shell command 217

Target Server submenu

Manage command 293-296

target server, selecting a 292

tools, development 4-8

adding/removing Tools menu commands 405-411

communications, managing 277

Diab 157

GNU 153

TCP/IP, using 18

Tornado settings, changing 392-404

using, guidelines for 4

Tornado 1.0.1 compatibility 397

Tornado Launch toolbar 51

Browser button 298

buttons 52

debugger, starting 328

shell, starting a 217

Tornado Registry icon 17

Tornado Registry window 17

Tornado.tcl 415

torVars.bat 290

-tPPC403FS:vxworks55 compiler option 159

tr( ) 225

troubleshooting 56-60

booting problems 57

hardware configuration 56

memory fragmentation 318

memory leaks 317

NetROM ROM emulator connection 35-37

priority inversion 320

stack overflow 318

target-server problems 59

ts( ) 225

TSFS, see Target Server File System

tt( ) 227

tty command (debugger) 350

ttyDevCreate( ) 493

ttyDrv( ) 493

tw( ) 227

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

U

udpstatShow( ) 236

ULIP

installing

VxSim/Windows, for 204

#undef 170

Undo command (Edit menu) 67

uninstalling

VxSim optional product 207

unld( ) 163, 232

unload command (debugger) 348

unloading modules

see online unldLib

command line, from the 163

workspace, from the 330

unsupported target directory 430

unwinding (Tcl) 446

uptcl command (debugger) 368

USER_APPL_INIT 187

userAppInit.c 112

initialization calls, adding 125

usrClock( ) 497

USRCONFIG 437

usrConfig.c 169

usrDepend.c 171

usrInit( ) 488-490

usrKernelInit( ) 490

usrMmuInit( ) 496

usrNetInit( ) 495

usrRoot( ) 491-497

usrSmObjInit( ) (VxMP option) 496

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

V

-V option (target server) 290

variables

uninitialized 489

Variables command (ALT+4) (Debug menu) 341

variables, see data variables; environment variables, host; Tcl variables

version control 398

Uncheckout command, creating (example) 409

version number, displaying Tornado 63

version( ) 229

View menu

Disassembly command 345

Mixed Source and Disassembly command 345

Source command 345

virtual console 287

virtual I/O 11

consoles, creating dedicated 287

virtual memory

VxVMI option