pSOSystem System Calls - Read

pROBE+ and ESp System Calls db_input
db_input Prompts and gets input from the high-level debugger.
long db_input (
char *inbuf, /* user input buffer */
unsigned long inbuf_len, /* user input buffer length */
char *prompt, /* prompt string */
unsigned long prompt_len, /* prompt string length */
unsigned long *nbytes /* number of bytes written */
)
Description
Arguments
Target
Return Value
This system call passes the string prompt to the high-level debugger (HLD) to be
printed on the output screen and waits for input back from the HLD. Upon receipt
of the input, it copies up to inbuf_len bytes into inbuf and writes inbuf’s length
into nbytes.
inbuf Points to the buffer in which db_input() writes input
from the HLD.
inbuf_len Specifies the number of bytes of input data to be written
in inbuf.
prompt Points to the string to be passed to the HLD as a prompt.
prompt_len Specifies the number of characters in prompt.
nbytes Points to the buffer in which db_input() writes the
actual length of inbuf.
68K MRI
For 68K processors with MRI host tools, this system call is not
supported.
This call returns 0 on success and an error code on failure.
pSOSystem System Calls 6-3
6