User`s guide

3–4 Remote Debugging
Ladebug Command Line Options
• The debug server uses the DBGSTOP PAL call to implement breakpoints. The
program must contain an identical implementation of the DBGSTOP PAL call.
This PAL call, rather than the BPT PAL call, is used because complex programs
(such as operating systems) are likely to reset the EntIF system entry point dur-
ing initialization.
• The program reset PALcode routine must preserve the address of the debug entry
point through the installation of the new PALcode. For the motherboard
PALcode, this address is held in the PAL temporary register with symbolic name
ptEntDbg. The user-defined PALcode must also either preserve the address of
the interrupt entry point (ptEntInt) or set the IPL to a level that prevents all
interrupts until the program sets up its own interrupt handler containing a call to
ladbx_poll.
3.5 Ladebug Command Line Options
Versions 1.3 or later of Ladebug provide the following command line options to
support remote debugging.
(Sheet 1 of 2)
Command Line Option Description
-rn node_name Specifies IP node name of the target node. Required for
remote debug. No default.
-pid process_id Specifies the process id of the process to be debugged. The
Ladebug software debugs a running process rather than
loading a new process.
-rfn arbitrary string Specifies the file name (or other identifier) of the image to
be loaded on a remote system. Defaults to the local object
file name. Passed to the remote system uninterrupted. Will
often have to be quoted to avoid shell command line
interpretation on the local system. Can be used only with
-rn; do not combine with -pid.