! VxWorksDebug.txt - Debugging at the VxWorks console
! Who needs gdb

To see a summary of these instructions

	dbgHelp

Display functions near an address

	lkAddr address

To find a global unique function
	
	lkup "procName"

To find a non-unique local function in a module

	lkup aNearbyGlobalFunction

	Then backup or go ahead listing nearby functions
	with ldAddr until you find the right function.

Setting a breakpoint

	b address

Clear a breakpoint

	bd address

Clear all breakpoints

	bdall

Show the process state at a breakpoint

	ti

	This will display the registers including the pc.

Show the pc at the current statement

	pc

List instructions

	l pcAddress

	With no parameters, it starts listing at the current
	breakpoint. Subsequent calls continue listing ahead.

Step (into)

	s

Step (over)

	so

Continue execution from a breakpoint

	c

Continue to subrouting return

	cret

Do a stack dump

	tt

List processes

	i

Display memory

	d address

Some PowerPC instruction mnemonics

	br address	! Function call
	blr		! Return from function

PowerPC calling conventions

	The first few parameters (more than a few really)
	are in the registers in order starting with r3.

	The return value of a function is also in r3.

