DEBUG(1spp)         RISC/os Reference Manual          DEBUG(1spp)



NAME
     debug - enter remote debugging mode

SYNOPSIS
     debug [ -r ] console_device

DESCRIPTION
     The debug command causes the debug monitor to enter a mode
     where it expects remote debugging requests over the serial
     port indicated by console_device.  The symbolic debugger dbx
     communicates with dbgmon using this protocol.  The protocol
     used by the debug command is a machine to machine protocol,
     so the debug command can only establish communication with
     remote debuggers.

     You can exit debug mode by entering a Control-z to the con-
     sole of the system running dbgmon. Dbgmon then re-enters
     command mode and a system state that can not be examined
     remotely.  For example, TLB contents can be displayed.  You
     can resume debug mode by entering the debug command with the
     -r option.  The -r flag causes dbgmon to re-enter debug mode
     without resetting its protocol sequence counters.  If you
     intend to resume debug mode with a remote debugger, then
     exit debug mode by entering a Control-z when the client pro-
     cess is stopped and the remote debugger is waiting for com-
     mand input.

     Debug mode can be aborted at any time with a Control-c.

SEE ALSO
     debug(5spp), dbx(1), slp(5spp)
























                         Printed 1/6/92                    Page 1