* top.c (execute_command): Remove redundant comment.

[deliverable/binutils-gdb.git] / gdb / target.h

diff --git a/gdb/target.h b/gdb/target.h
index 94750bbd9c354e2c434877ba245512c6ca637673..2c743e93fcc9f0826097c09d422a1bd7432c39c4 100644 (file)
--- a/gdb/target.h
+++ b/gdb/target.h
@@ -65,7 +65,8 @@ enum strata
     core_stratum,              /* Core dump files */
     process_stratum,           /* Executing processes */
     thread_stratum,            /* Executing threads */
-    record_stratum             /* Support record debugging */
+    record_stratum,            /* Support record debugging */
+    arch_stratum               /* Architecture overrides */
   };
 
 enum thread_control_capabilities
@@ -305,7 +306,8 @@ extern char *target_read_stralloc (struct target_ops *ops,
 extern void get_target_memory (struct target_ops *ops, CORE_ADDR addr,
                               gdb_byte *buf, LONGEST len);
 extern ULONGEST get_target_memory_unsigned (struct target_ops *ops,
-                                           CORE_ADDR addr, int len);
+                                           CORE_ADDR addr, int len,
+                                           enum bfd_endian byte_order);
 \f
 struct thread_info;            /* fwd decl for parameter list below: */
 
@@ -542,7 +544,16 @@ struct target_ops
        simultaneously?  */
     int (*to_supports_multi_process) (void);
 
-    /* Determine current architecture of thread PTID.  */
+    /* Determine current architecture of thread PTID.
+
+       The target is supposed to determine the architecture of the code where
+       the target is currently stopped at (on Cell, if a target is in spu_run,
+       to_thread_architecture would return SPU, otherwise PPC32 or PPC64).
+       This is architecture used to perform decr_pc_after_break adjustment,
+       and also determines the frame architecture of the innermost frame.
+       ptrace operations need to operate according to target_gdbarch.
+
+       The default implementation always returns target_gdbarch.  */
     struct gdbarch *(*to_thread_architecture) (struct target_ops *, ptid_t);
 
     int to_magic;
@@ -1042,7 +1053,7 @@ extern char *normal_pid_to_str (ptid_t ptid);
 #define target_pid_to_exec_file(pid) \
      (current_target.to_pid_to_exec_file) (pid)
 
-/* Determine current architecture of thread PTID.  */
+/* See the to_thread_architecture description in struct target_ops.  */
 
 #define target_thread_architecture(ptid) \
      (current_target.to_thread_architecture (&current_target, ptid))