CALL(1spp) RISC/os Reference Manual CALL(1spp)
NAME
call - call a client entry point and display returned value
SYNOPSIS
call entry [ args ]
DESCRIPTION
The call command is used from dbgmon command mode and
invokes a test program procedure.
For example, the call command invokes test program routines
that perform formatted dumps of the data structures that the
test program uses.
When the test program procedure is invoked, the gp register
is initialized to the current value in registers which the
test program is using, the sp register is initialized to the
current point in the debug monitor's stack, no breakpoints
are installed, and all faults are handled by the debug moni-
tor and not passed to the client's fault handlers. A max-
imum of eight arguments can be passed to the test program
routine. Call does not affect the contents of the registers
that the test program is using. The called test routine can
overflow the debug monitors stack if it uses extensive
amounts of stack space. Also any side-effects that the
called procedure has on the test program's global data will
persist after the call.
Printed 1/6/92 Page 1