(sim_resume): Clarify use of SIGGNAL.

(sim_stop_reason): Clarify meaning of sim_signalled.
This commit is contained in:
Andrew Cagney 2000-02-09 07:44:03 +00:00
parent 7fc5b5adca
commit c1a8de50ed
2 changed files with 32 additions and 7 deletions

View file

@ -1,3 +1,8 @@
Tue Feb 8 17:01:13 2000 Andrew Cagney <cagney@b1.cygnus.com>
* remote-sim.h (sim_resume): Clarify use of SIGGNAL.
(sim_stop_reason): Clarify meaning of sim_signalled.
2000-02-03 Timothy Wall <twall@redhat.com>
* dis-asm.h (struct disassemble_info): Added octets_per_byte

View file

@ -211,7 +211,27 @@ int sim_store_register PARAMS ((SIM_DESC sd, int regno, unsigned char *buf, int
void sim_info PARAMS ((SIM_DESC sd, int verbose));
/* Run (or resume) the simulated program. */
/* Run (or resume) the simulated program.
STEP, when non-zero indicates that only a single simulator cycle
should be emulated.
SIGGNAL, if non-zero is a (HOST) SIGRC value indicating the type of
event (hardware interrupt, signal) to be delivered to the simulated
program.
Hardware simulator: If the SIGRC value returned by
sim_stop_reason() is passed back to the simulator via SIGGNAL then
the hardware simulator shall correctly deliver the hardware event
indicated by that signal. If a value of zero is passed in then the
simulation will continue as if there were no outstanding signal.
The effect of any other SIGGNAL value is is implementation
dependant.
Process simulator: If SIGRC is non-zero then the corresponding
signal is delivered to the simulated program and execution is then
continued. A zero SIGRC value indicates that the program should
continue as normal. */
void sim_resume PARAMS ((SIM_DESC sd, int step, int siggnal));
@ -234,13 +254,13 @@ int sim_stop PARAMS ((SIM_DESC sd));
(SIGTRAP); a completed single step (SIGTRAP); an internal error
condition (SIGABRT); an illegal instruction (SIGILL); Access to an
undefined memory region (SIGSEGV); Mis-aligned memory access
(SIGBUS).
(SIGBUS). For some signals information in addition to the signal
number may be retained by the simulator (e.g. offending address),
that information is not directly accessable via this interface.
SIM_SIGNALLED: The program has stopped. The simulator has
encountered target code that requires the (HOST) signal SIGRC to be
delivered to the simulated program. Ex: `kill (getpid (),
TARGET_SIGxxx)'. Where TARGET_SIGxxx has been translated into a
host signal. FIXME: This is not always possible..
SIM_SIGNALLED: The program has been terminated by a signal. The
simulator has encountered target code that causes the the program
to exit with signal SIGRC.
SIM_RUNNING, SIM_POLLING: The return of one of these values
indicates a problem internal to the simulator. */