User`s guide

Remote Debugging 3–3
Programming Guidelines
Programs that define or install their own interrupt handler must ensure that the
Debug Monitor polls the Ethernet device often enough to receive all the messages
sent to it by Ladebug. An easy way to do this is to use the ladbx_poll function.
When this function is called, the following occurs:
• All frames that have been received on the Ethernet device are read.
• All remote debug frames are processed and acted upon.
• Any Ethernet interrupt is cleared.
The ladbx_poll function is a void function that takes no arguments. It must be
called often enough to allow the Debug Monitor to respond promptly to all received
Ethernet frames. To ensure that this function gets called at the proper time, enable
either Ethernet or timer interrupts (or both) and call it every time an interrupt occurs.
Programs cannot share an Ethernet device with the Debug Monitor. The Debug Mon-
itor can drive a selection of different types of Ethernet devices on ISA or PCI cards,
and an individual Ethernet device can be selected with the Debug Monitor edevice
command.
3.4.3 PALcode Environment
Most programs will be able to use the DIGITAL UNIX compatible PALcode
included with the Debug Monitor; however, for the programs that install their own
PALcode, the following guidelines must be followed:
• For remote debug to work, the following DIGITAL UNIX PALcode calls must
be implemented according to the interface described in the DEC OSF/1 section
of the Alpha AXP Architecture Reference Manual.
IMB
RDUSP
RTI
WPIPL
WRENT
• The interface to the system must conform to the standards described in the
DEC OSF/1 section of the Alpha AXP Architecture Reference Manual.