From: Andrew Cagney <cagney@redhat.com>
Date: Tue, 14 Oct 1997 09:33:18 +0000 (+0000)
Subject: remote-sim.h: Clarify sim_read, sim_write MEM argument.
X-Git-Url: http://drtracing.org/?a=commitdiff_plain;h=5ccb90201f6d1a69c22e1ae79306301a36c0f173;p=deliverable%2Fbinutils-gdb.git

remote-sim.h: Clarify sim_read, sim_write MEM argument.
---

diff --git a/include/ChangeLog b/include/ChangeLog
index 9ec1e766b5..c6bdee6c70 100644
--- a/include/ChangeLog
+++ b/include/ChangeLog
@@ -1,3 +1,18 @@
+Mon Oct 13 10:17:15 1997  Andrew Cagney  <cagney@b1.cygnus.com>
+
+	* remote-sim.h: Clarify sim_read, sim_write MEM argument.
+
+Wed Sep 24 18:03:10 1997  Stu Grossman  <grossman@babylon-5.cygnus.com>
+
+	* remote-sim.h (SIM_RC):  Add a bunch of new return codes for
+	breakpoint stuff.
+	* Add functions to tell the simulator to set/clear/enable/disable
+	intrinsic breakpoints.
+
+Thu Aug 28 19:41:42 1997  Andrew Cagney  <cagney@b1.cygnus.com>
+
+	* libiberty.h (dupargv): Add prototype.
+
 Tue Aug 26 12:25:49 1997  Andrew Cagney  <cagney@b1.cygnus.com>
 
 	* remote-sim.h (sim_create_inferior): Add ABFD arg. Document.
diff --git a/include/remote-sim.h b/include/remote-sim.h
index 837f365578..dc4997032b 100644
--- a/include/remote-sim.h
+++ b/include/remote-sim.h
@@ -155,14 +155,16 @@ SIM_RC sim_load PARAMS ((SIM_DESC sd, char *prog, struct _bfd *abfd, int from_tt
 SIM_RC sim_create_inferior PARAMS ((SIM_DESC sd, struct _bfd *abfd, char **argv, char **env));
 
 
-/* Read LENGTH bytes of the simulated program's memory and store in
-   BUF.  Result is number of bytes read, or zero if error.  */
+/* Fetch LENGTH bytes of the simulated program's memory.  Start fetch
+   at virtual address MEM and store in BUF.  Result is number of bytes
+   read, or zero if error.  */
 
 int sim_read PARAMS ((SIM_DESC sd, SIM_ADDR mem, unsigned char *buf, int length));
 
 
-/* Store LENGTH bytes from BUF in the simulated program's memory.
-   Result is number of bytes write, or zero if error.  */
+/* Store LENGTH bytes from BUF into the simulated program's
+   memory. Store bytes starting at virtual address MEM. Result is
+   number of bytes write, or zero if error.  */
 
 int sim_write PARAMS ((SIM_DESC sd, SIM_ADDR mem, unsigned char *buf, int length));
 
@@ -202,10 +204,13 @@ int sim_stop PARAMS ((SIM_DESC sd));
    SIM_EXITED: The program has terminated. SIGRC indicates the target
    dependant exit status.
 
-   SIM_STOPPED: The program has stopped.  SIGRC indicates the reason:
-   program interrupted by user via a sim_stop request (SIGINT); a
-   breakpoint instruction (SIGTRAP); a completed step (SIGTRAP); an
-   internal error condition (SIGABRT).
+   SIM_STOPPED: The program has stopped.  SIGRC uses the host's signal
+   numbering as a way of identifying the reaon: program interrupted by
+   user via a sim_stop request (SIGINT); a breakpoint instruction
+   (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).
 
    SIM_SIGNALLED: The simulator encountered target code that requires
    the signal SIGRC to be delivered to the simulated program.