1 /* Select target systems and architectures at runtime for GDB.
3 Copyright (C) 1990-2013 Free Software Foundation, Inc.
5 Contributed by Cygnus Support.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 #include "gdb_string.h"
35 #include "gdb_assert.h"
37 #include "exceptions.h"
38 #include "target-descriptions.h"
39 #include "gdbthread.h"
42 #include "inline-frame.h"
43 #include "tracepoint.h"
44 #include "gdb/fileio.h"
47 static void target_info (char *, int);
49 static void default_terminal_info (const char *, int);
51 static int default_watchpoint_addr_within_range (struct target_ops *,
52 CORE_ADDR, CORE_ADDR, int);
54 static int default_region_ok_for_hw_watchpoint (CORE_ADDR, int);
56 static void tcomplain (void) ATTRIBUTE_NORETURN;
58 static int nomemory (CORE_ADDR, char *, int, int, struct target_ops *);
60 static int return_zero (void);
62 static int return_one (void);
64 static int return_minus_one (void);
66 void target_ignore (void);
68 static void target_command (char *, int);
70 static struct target_ops *find_default_run_target (char *);
72 static LONGEST default_xfer_partial (struct target_ops *ops,
73 enum target_object object,
74 const char *annex, gdb_byte *readbuf,
75 const gdb_byte *writebuf,
76 ULONGEST offset, LONGEST len);
78 static LONGEST current_xfer_partial (struct target_ops *ops,
79 enum target_object object,
80 const char *annex, gdb_byte *readbuf,
81 const gdb_byte *writebuf,
82 ULONGEST offset, LONGEST len);
84 static struct gdbarch *default_thread_architecture (struct target_ops *ops,
87 static void init_dummy_target (void);
89 static struct target_ops debug_target;
91 static void debug_to_open (char *, int);
93 static void debug_to_prepare_to_store (struct regcache *);
95 static void debug_to_files_info (struct target_ops *);
97 static int debug_to_insert_breakpoint (struct gdbarch *,
98 struct bp_target_info *);
100 static int debug_to_remove_breakpoint (struct gdbarch *,
101 struct bp_target_info *);
103 static int debug_to_can_use_hw_breakpoint (int, int, int);
105 static int debug_to_insert_hw_breakpoint (struct gdbarch *,
106 struct bp_target_info *);
108 static int debug_to_remove_hw_breakpoint (struct gdbarch *,
109 struct bp_target_info *);
111 static int debug_to_insert_watchpoint (CORE_ADDR, int, int,
112 struct expression *);
114 static int debug_to_remove_watchpoint (CORE_ADDR, int, int,
115 struct expression *);
117 static int debug_to_stopped_by_watchpoint (void);
119 static int debug_to_stopped_data_address (struct target_ops *, CORE_ADDR *);
121 static int debug_to_watchpoint_addr_within_range (struct target_ops *,
122 CORE_ADDR, CORE_ADDR, int);
124 static int debug_to_region_ok_for_hw_watchpoint (CORE_ADDR, int);
126 static int debug_to_can_accel_watchpoint_condition (CORE_ADDR, int, int,
127 struct expression *);
129 static void debug_to_terminal_init (void);
131 static void debug_to_terminal_inferior (void);
133 static void debug_to_terminal_ours_for_output (void);
135 static void debug_to_terminal_save_ours (void);
137 static void debug_to_terminal_ours (void);
139 static void debug_to_load (char *, int);
141 static int debug_to_can_run (void);
143 static void debug_to_stop (ptid_t);
145 /* Pointer to array of target architecture structures; the size of the
146 array; the current index into the array; the allocated size of the
148 struct target_ops **target_structs;
149 unsigned target_struct_size;
150 unsigned target_struct_allocsize;
151 #define DEFAULT_ALLOCSIZE 10
153 /* The initial current target, so that there is always a semi-valid
156 static struct target_ops dummy_target;
158 /* Top of target stack. */
160 static struct target_ops *target_stack;
162 /* The target structure we are currently using to talk to a process
163 or file or whatever "inferior" we have. */
165 struct target_ops current_target;
167 /* Command list for target. */
169 static struct cmd_list_element *targetlist = NULL;
171 /* Nonzero if we should trust readonly sections from the
172 executable when reading memory. */
174 static int trust_readonly = 0;
176 /* Nonzero if we should show true memory content including
177 memory breakpoint inserted by gdb. */
179 static int show_memory_breakpoints = 0;
181 /* These globals control whether GDB attempts to perform these
182 operations; they are useful for targets that need to prevent
183 inadvertant disruption, such as in non-stop mode. */
185 int may_write_registers = 1;
187 int may_write_memory = 1;
189 int may_insert_breakpoints = 1;
191 int may_insert_tracepoints = 1;
193 int may_insert_fast_tracepoints = 1;
197 /* Non-zero if we want to see trace of target level stuff. */
199 static unsigned int targetdebug = 0;
201 show_targetdebug (struct ui_file *file, int from_tty,
202 struct cmd_list_element *c, const char *value)
204 fprintf_filtered (file, _("Target debugging is %s.\n"), value);
207 static void setup_target_debug (void);
209 /* The option sets this. */
210 static int stack_cache_enabled_p_1 = 1;
211 /* And set_stack_cache_enabled_p updates this.
212 The reason for the separation is so that we don't flush the cache for
213 on->on transitions. */
214 static int stack_cache_enabled_p = 1;
216 /* This is called *after* the stack-cache has been set.
217 Flush the cache for off->on and on->off transitions.
218 There's no real need to flush the cache for on->off transitions,
219 except cleanliness. */
222 set_stack_cache_enabled_p (char *args, int from_tty,
223 struct cmd_list_element *c)
225 if (stack_cache_enabled_p != stack_cache_enabled_p_1)
226 target_dcache_invalidate ();
228 stack_cache_enabled_p = stack_cache_enabled_p_1;
232 show_stack_cache_enabled_p (struct ui_file *file, int from_tty,
233 struct cmd_list_element *c, const char *value)
235 fprintf_filtered (file, _("Cache use for stack accesses is %s.\n"), value);
238 /* Cache of memory operations, to speed up remote access. */
239 static DCACHE *target_dcache;
241 /* Invalidate the target dcache. */
244 target_dcache_invalidate (void)
246 dcache_invalidate (target_dcache);
249 /* The user just typed 'target' without the name of a target. */
252 target_command (char *arg, int from_tty)
254 fputs_filtered ("Argument required (target name). Try `help target'\n",
258 /* Default target_has_* methods for process_stratum targets. */
261 default_child_has_all_memory (struct target_ops *ops)
263 /* If no inferior selected, then we can't read memory here. */
264 if (ptid_equal (inferior_ptid, null_ptid))
271 default_child_has_memory (struct target_ops *ops)
273 /* If no inferior selected, then we can't read memory here. */
274 if (ptid_equal (inferior_ptid, null_ptid))
281 default_child_has_stack (struct target_ops *ops)
283 /* If no inferior selected, there's no stack. */
284 if (ptid_equal (inferior_ptid, null_ptid))
291 default_child_has_registers (struct target_ops *ops)
293 /* Can't read registers from no inferior. */
294 if (ptid_equal (inferior_ptid, null_ptid))
301 default_child_has_execution (struct target_ops *ops, ptid_t the_ptid)
303 /* If there's no thread selected, then we can't make it run through
305 if (ptid_equal (the_ptid, null_ptid))
313 target_has_all_memory_1 (void)
315 struct target_ops *t;
317 for (t = current_target.beneath; t != NULL; t = t->beneath)
318 if (t->to_has_all_memory (t))
325 target_has_memory_1 (void)
327 struct target_ops *t;
329 for (t = current_target.beneath; t != NULL; t = t->beneath)
330 if (t->to_has_memory (t))
337 target_has_stack_1 (void)
339 struct target_ops *t;
341 for (t = current_target.beneath; t != NULL; t = t->beneath)
342 if (t->to_has_stack (t))
349 target_has_registers_1 (void)
351 struct target_ops *t;
353 for (t = current_target.beneath; t != NULL; t = t->beneath)
354 if (t->to_has_registers (t))
361 target_has_execution_1 (ptid_t the_ptid)
363 struct target_ops *t;
365 for (t = current_target.beneath; t != NULL; t = t->beneath)
366 if (t->to_has_execution (t, the_ptid))
373 target_has_execution_current (void)
375 return target_has_execution_1 (inferior_ptid);
378 /* Complete initialization of T. This ensures that various fields in
379 T are set, if needed by the target implementation. */
382 complete_target_initialization (struct target_ops *t)
384 /* Provide default values for all "must have" methods. */
385 if (t->to_xfer_partial == NULL)
386 t->to_xfer_partial = default_xfer_partial;
388 if (t->to_has_all_memory == NULL)
389 t->to_has_all_memory = (int (*) (struct target_ops *)) return_zero;
391 if (t->to_has_memory == NULL)
392 t->to_has_memory = (int (*) (struct target_ops *)) return_zero;
394 if (t->to_has_stack == NULL)
395 t->to_has_stack = (int (*) (struct target_ops *)) return_zero;
397 if (t->to_has_registers == NULL)
398 t->to_has_registers = (int (*) (struct target_ops *)) return_zero;
400 if (t->to_has_execution == NULL)
401 t->to_has_execution = (int (*) (struct target_ops *, ptid_t)) return_zero;
404 /* Add possible target architecture T to the list and add a new
405 command 'target T->to_shortname'. Set COMPLETER as the command's
406 completer if not NULL. */
409 add_target_with_completer (struct target_ops *t,
410 completer_ftype *completer)
412 struct cmd_list_element *c;
414 complete_target_initialization (t);
418 target_struct_allocsize = DEFAULT_ALLOCSIZE;
419 target_structs = (struct target_ops **) xmalloc
420 (target_struct_allocsize * sizeof (*target_structs));
422 if (target_struct_size >= target_struct_allocsize)
424 target_struct_allocsize *= 2;
425 target_structs = (struct target_ops **)
426 xrealloc ((char *) target_structs,
427 target_struct_allocsize * sizeof (*target_structs));
429 target_structs[target_struct_size++] = t;
431 if (targetlist == NULL)
432 add_prefix_cmd ("target", class_run, target_command, _("\
433 Connect to a target machine or process.\n\
434 The first argument is the type or protocol of the target machine.\n\
435 Remaining arguments are interpreted by the target protocol. For more\n\
436 information on the arguments for a particular protocol, type\n\
437 `help target ' followed by the protocol name."),
438 &targetlist, "target ", 0, &cmdlist);
439 c = add_cmd (t->to_shortname, no_class, t->to_open, t->to_doc,
441 if (completer != NULL)
442 set_cmd_completer (c, completer);
445 /* Add a possible target architecture to the list. */
448 add_target (struct target_ops *t)
450 add_target_with_completer (t, NULL);
456 add_deprecated_target_alias (struct target_ops *t, char *alias)
458 struct cmd_list_element *c;
461 /* If we use add_alias_cmd, here, we do not get the deprecated warning,
463 c = add_cmd (alias, no_class, t->to_open, t->to_doc, &targetlist);
464 alt = xstrprintf ("target %s", t->to_shortname);
465 deprecate_cmd (c, alt);
478 struct target_ops *t;
480 for (t = current_target.beneath; t != NULL; t = t->beneath)
481 if (t->to_kill != NULL)
484 fprintf_unfiltered (gdb_stdlog, "target_kill ()\n");
494 target_load (char *arg, int from_tty)
496 target_dcache_invalidate ();
497 (*current_target.to_load) (arg, from_tty);
501 target_create_inferior (char *exec_file, char *args,
502 char **env, int from_tty)
504 struct target_ops *t;
506 for (t = current_target.beneath; t != NULL; t = t->beneath)
508 if (t->to_create_inferior != NULL)
510 t->to_create_inferior (t, exec_file, args, env, from_tty);
512 fprintf_unfiltered (gdb_stdlog,
513 "target_create_inferior (%s, %s, xxx, %d)\n",
514 exec_file, args, from_tty);
519 internal_error (__FILE__, __LINE__,
520 _("could not find a target to create inferior"));
524 target_terminal_inferior (void)
526 /* A background resume (``run&'') should leave GDB in control of the
527 terminal. Use target_can_async_p, not target_is_async_p, since at
528 this point the target is not async yet. However, if sync_execution
529 is not set, we know it will become async prior to resume. */
530 if (target_can_async_p () && !sync_execution)
533 /* If GDB is resuming the inferior in the foreground, install
534 inferior's terminal modes. */
535 (*current_target.to_terminal_inferior) ();
539 nomemory (CORE_ADDR memaddr, char *myaddr, int len, int write,
540 struct target_ops *t)
542 errno = EIO; /* Can't read/write this location. */
543 return 0; /* No bytes handled. */
549 error (_("You can't do that when your target is `%s'"),
550 current_target.to_shortname);
556 error (_("You can't do that without a process to debug."));
560 default_terminal_info (const char *args, int from_tty)
562 printf_unfiltered (_("No saved terminal information.\n"));
565 /* A default implementation for the to_get_ada_task_ptid target method.
567 This function builds the PTID by using both LWP and TID as part of
568 the PTID lwp and tid elements. The pid used is the pid of the
572 default_get_ada_task_ptid (long lwp, long tid)
574 return ptid_build (ptid_get_pid (inferior_ptid), lwp, tid);
577 static enum exec_direction_kind
578 default_execution_direction (void)
580 if (!target_can_execute_reverse)
582 else if (!target_can_async_p ())
585 gdb_assert_not_reached ("\
586 to_execution_direction must be implemented for reverse async");
589 /* Go through the target stack from top to bottom, copying over zero
590 entries in current_target, then filling in still empty entries. In
591 effect, we are doing class inheritance through the pushed target
594 NOTE: cagney/2003-10-17: The problem with this inheritance, as it
595 is currently implemented, is that it discards any knowledge of
596 which target an inherited method originally belonged to.
597 Consequently, new new target methods should instead explicitly and
598 locally search the target stack for the target that can handle the
602 update_current_target (void)
604 struct target_ops *t;
606 /* First, reset current's contents. */
607 memset (¤t_target, 0, sizeof (current_target));
609 #define INHERIT(FIELD, TARGET) \
610 if (!current_target.FIELD) \
611 current_target.FIELD = (TARGET)->FIELD
613 for (t = target_stack; t; t = t->beneath)
615 INHERIT (to_shortname, t);
616 INHERIT (to_longname, t);
618 /* Do not inherit to_open. */
619 /* Do not inherit to_close. */
620 /* Do not inherit to_attach. */
621 INHERIT (to_post_attach, t);
622 INHERIT (to_attach_no_wait, t);
623 /* Do not inherit to_detach. */
624 /* Do not inherit to_disconnect. */
625 /* Do not inherit to_resume. */
626 /* Do not inherit to_wait. */
627 /* Do not inherit to_fetch_registers. */
628 /* Do not inherit to_store_registers. */
629 INHERIT (to_prepare_to_store, t);
630 INHERIT (deprecated_xfer_memory, t);
631 INHERIT (to_files_info, t);
632 INHERIT (to_insert_breakpoint, t);
633 INHERIT (to_remove_breakpoint, t);
634 INHERIT (to_can_use_hw_breakpoint, t);
635 INHERIT (to_insert_hw_breakpoint, t);
636 INHERIT (to_remove_hw_breakpoint, t);
637 /* Do not inherit to_ranged_break_num_registers. */
638 INHERIT (to_insert_watchpoint, t);
639 INHERIT (to_remove_watchpoint, t);
640 /* Do not inherit to_insert_mask_watchpoint. */
641 /* Do not inherit to_remove_mask_watchpoint. */
642 INHERIT (to_stopped_data_address, t);
643 INHERIT (to_have_steppable_watchpoint, t);
644 INHERIT (to_have_continuable_watchpoint, t);
645 INHERIT (to_stopped_by_watchpoint, t);
646 INHERIT (to_watchpoint_addr_within_range, t);
647 INHERIT (to_region_ok_for_hw_watchpoint, t);
648 INHERIT (to_can_accel_watchpoint_condition, t);
649 /* Do not inherit to_masked_watch_num_registers. */
650 INHERIT (to_terminal_init, t);
651 INHERIT (to_terminal_inferior, t);
652 INHERIT (to_terminal_ours_for_output, t);
653 INHERIT (to_terminal_ours, t);
654 INHERIT (to_terminal_save_ours, t);
655 INHERIT (to_terminal_info, t);
656 /* Do not inherit to_kill. */
657 INHERIT (to_load, t);
658 /* Do no inherit to_create_inferior. */
659 INHERIT (to_post_startup_inferior, t);
660 INHERIT (to_insert_fork_catchpoint, t);
661 INHERIT (to_remove_fork_catchpoint, t);
662 INHERIT (to_insert_vfork_catchpoint, t);
663 INHERIT (to_remove_vfork_catchpoint, t);
664 /* Do not inherit to_follow_fork. */
665 INHERIT (to_insert_exec_catchpoint, t);
666 INHERIT (to_remove_exec_catchpoint, t);
667 INHERIT (to_set_syscall_catchpoint, t);
668 INHERIT (to_has_exited, t);
669 /* Do not inherit to_mourn_inferior. */
670 INHERIT (to_can_run, t);
671 /* Do not inherit to_pass_signals. */
672 /* Do not inherit to_program_signals. */
673 /* Do not inherit to_thread_alive. */
674 /* Do not inherit to_find_new_threads. */
675 /* Do not inherit to_pid_to_str. */
676 INHERIT (to_extra_thread_info, t);
677 INHERIT (to_thread_name, t);
678 INHERIT (to_stop, t);
679 /* Do not inherit to_xfer_partial. */
680 INHERIT (to_rcmd, t);
681 INHERIT (to_pid_to_exec_file, t);
682 INHERIT (to_log_command, t);
683 INHERIT (to_stratum, t);
684 /* Do not inherit to_has_all_memory. */
685 /* Do not inherit to_has_memory. */
686 /* Do not inherit to_has_stack. */
687 /* Do not inherit to_has_registers. */
688 /* Do not inherit to_has_execution. */
689 INHERIT (to_has_thread_control, t);
690 INHERIT (to_can_async_p, t);
691 INHERIT (to_is_async_p, t);
692 INHERIT (to_async, t);
693 INHERIT (to_find_memory_regions, t);
694 INHERIT (to_make_corefile_notes, t);
695 INHERIT (to_get_bookmark, t);
696 INHERIT (to_goto_bookmark, t);
697 /* Do not inherit to_get_thread_local_address. */
698 INHERIT (to_can_execute_reverse, t);
699 INHERIT (to_execution_direction, t);
700 INHERIT (to_thread_architecture, t);
701 /* Do not inherit to_read_description. */
702 INHERIT (to_get_ada_task_ptid, t);
703 /* Do not inherit to_search_memory. */
704 INHERIT (to_supports_multi_process, t);
705 INHERIT (to_supports_enable_disable_tracepoint, t);
706 INHERIT (to_supports_string_tracing, t);
707 INHERIT (to_trace_init, t);
708 INHERIT (to_download_tracepoint, t);
709 INHERIT (to_can_download_tracepoint, t);
710 INHERIT (to_download_trace_state_variable, t);
711 INHERIT (to_enable_tracepoint, t);
712 INHERIT (to_disable_tracepoint, t);
713 INHERIT (to_trace_set_readonly_regions, t);
714 INHERIT (to_trace_start, t);
715 INHERIT (to_get_trace_status, t);
716 INHERIT (to_get_tracepoint_status, t);
717 INHERIT (to_trace_stop, t);
718 INHERIT (to_trace_find, t);
719 INHERIT (to_get_trace_state_variable_value, t);
720 INHERIT (to_save_trace_data, t);
721 INHERIT (to_upload_tracepoints, t);
722 INHERIT (to_upload_trace_state_variables, t);
723 INHERIT (to_get_raw_trace_data, t);
724 INHERIT (to_get_min_fast_tracepoint_insn_len, t);
725 INHERIT (to_set_disconnected_tracing, t);
726 INHERIT (to_set_circular_trace_buffer, t);
727 INHERIT (to_set_trace_buffer_size, t);
728 INHERIT (to_set_trace_notes, t);
729 INHERIT (to_get_tib_address, t);
730 INHERIT (to_set_permissions, t);
731 INHERIT (to_static_tracepoint_marker_at, t);
732 INHERIT (to_static_tracepoint_markers_by_strid, t);
733 INHERIT (to_traceframe_info, t);
734 INHERIT (to_use_agent, t);
735 INHERIT (to_can_use_agent, t);
736 INHERIT (to_augmented_libraries_svr4_read, t);
737 INHERIT (to_magic, t);
738 INHERIT (to_supports_evaluation_of_breakpoint_conditions, t);
739 INHERIT (to_can_run_breakpoint_commands, t);
740 /* Do not inherit to_memory_map. */
741 /* Do not inherit to_flash_erase. */
742 /* Do not inherit to_flash_done. */
746 /* Clean up a target struct so it no longer has any zero pointers in
747 it. Some entries are defaulted to a method that print an error,
748 others are hard-wired to a standard recursive default. */
750 #define de_fault(field, value) \
751 if (!current_target.field) \
752 current_target.field = value
755 (void (*) (char *, int))
760 de_fault (to_post_attach,
763 de_fault (to_prepare_to_store,
764 (void (*) (struct regcache *))
766 de_fault (deprecated_xfer_memory,
767 (int (*) (CORE_ADDR, gdb_byte *, int, int,
768 struct mem_attrib *, struct target_ops *))
770 de_fault (to_files_info,
771 (void (*) (struct target_ops *))
773 de_fault (to_insert_breakpoint,
774 memory_insert_breakpoint);
775 de_fault (to_remove_breakpoint,
776 memory_remove_breakpoint);
777 de_fault (to_can_use_hw_breakpoint,
778 (int (*) (int, int, int))
780 de_fault (to_insert_hw_breakpoint,
781 (int (*) (struct gdbarch *, struct bp_target_info *))
783 de_fault (to_remove_hw_breakpoint,
784 (int (*) (struct gdbarch *, struct bp_target_info *))
786 de_fault (to_insert_watchpoint,
787 (int (*) (CORE_ADDR, int, int, struct expression *))
789 de_fault (to_remove_watchpoint,
790 (int (*) (CORE_ADDR, int, int, struct expression *))
792 de_fault (to_stopped_by_watchpoint,
795 de_fault (to_stopped_data_address,
796 (int (*) (struct target_ops *, CORE_ADDR *))
798 de_fault (to_watchpoint_addr_within_range,
799 default_watchpoint_addr_within_range);
800 de_fault (to_region_ok_for_hw_watchpoint,
801 default_region_ok_for_hw_watchpoint);
802 de_fault (to_can_accel_watchpoint_condition,
803 (int (*) (CORE_ADDR, int, int, struct expression *))
805 de_fault (to_terminal_init,
808 de_fault (to_terminal_inferior,
811 de_fault (to_terminal_ours_for_output,
814 de_fault (to_terminal_ours,
817 de_fault (to_terminal_save_ours,
820 de_fault (to_terminal_info,
821 default_terminal_info);
823 (void (*) (char *, int))
825 de_fault (to_post_startup_inferior,
828 de_fault (to_insert_fork_catchpoint,
831 de_fault (to_remove_fork_catchpoint,
834 de_fault (to_insert_vfork_catchpoint,
837 de_fault (to_remove_vfork_catchpoint,
840 de_fault (to_insert_exec_catchpoint,
843 de_fault (to_remove_exec_catchpoint,
846 de_fault (to_set_syscall_catchpoint,
847 (int (*) (int, int, int, int, int *))
849 de_fault (to_has_exited,
850 (int (*) (int, int, int *))
852 de_fault (to_can_run,
854 de_fault (to_extra_thread_info,
855 (char *(*) (struct thread_info *))
857 de_fault (to_thread_name,
858 (char *(*) (struct thread_info *))
863 current_target.to_xfer_partial = current_xfer_partial;
865 (void (*) (char *, struct ui_file *))
867 de_fault (to_pid_to_exec_file,
871 (void (*) (void (*) (enum inferior_event_type, void*), void*))
873 de_fault (to_thread_architecture,
874 default_thread_architecture);
875 current_target.to_read_description = NULL;
876 de_fault (to_get_ada_task_ptid,
877 (ptid_t (*) (long, long))
878 default_get_ada_task_ptid);
879 de_fault (to_supports_multi_process,
882 de_fault (to_supports_enable_disable_tracepoint,
885 de_fault (to_supports_string_tracing,
888 de_fault (to_trace_init,
891 de_fault (to_download_tracepoint,
892 (void (*) (struct bp_location *))
894 de_fault (to_can_download_tracepoint,
897 de_fault (to_download_trace_state_variable,
898 (void (*) (struct trace_state_variable *))
900 de_fault (to_enable_tracepoint,
901 (void (*) (struct bp_location *))
903 de_fault (to_disable_tracepoint,
904 (void (*) (struct bp_location *))
906 de_fault (to_trace_set_readonly_regions,
909 de_fault (to_trace_start,
912 de_fault (to_get_trace_status,
913 (int (*) (struct trace_status *))
915 de_fault (to_get_tracepoint_status,
916 (void (*) (struct breakpoint *, struct uploaded_tp *))
918 de_fault (to_trace_stop,
921 de_fault (to_trace_find,
922 (int (*) (enum trace_find_type, int, CORE_ADDR, CORE_ADDR, int *))
924 de_fault (to_get_trace_state_variable_value,
925 (int (*) (int, LONGEST *))
927 de_fault (to_save_trace_data,
928 (int (*) (const char *))
930 de_fault (to_upload_tracepoints,
931 (int (*) (struct uploaded_tp **))
933 de_fault (to_upload_trace_state_variables,
934 (int (*) (struct uploaded_tsv **))
936 de_fault (to_get_raw_trace_data,
937 (LONGEST (*) (gdb_byte *, ULONGEST, LONGEST))
939 de_fault (to_get_min_fast_tracepoint_insn_len,
942 de_fault (to_set_disconnected_tracing,
945 de_fault (to_set_circular_trace_buffer,
948 de_fault (to_set_trace_buffer_size,
951 de_fault (to_set_trace_notes,
952 (int (*) (const char *, const char *, const char *))
954 de_fault (to_get_tib_address,
955 (int (*) (ptid_t, CORE_ADDR *))
957 de_fault (to_set_permissions,
960 de_fault (to_static_tracepoint_marker_at,
961 (int (*) (CORE_ADDR, struct static_tracepoint_marker *))
963 de_fault (to_static_tracepoint_markers_by_strid,
964 (VEC(static_tracepoint_marker_p) * (*) (const char *))
966 de_fault (to_traceframe_info,
967 (struct traceframe_info * (*) (void))
969 de_fault (to_supports_evaluation_of_breakpoint_conditions,
972 de_fault (to_can_run_breakpoint_commands,
975 de_fault (to_use_agent,
978 de_fault (to_can_use_agent,
981 de_fault (to_augmented_libraries_svr4_read,
984 de_fault (to_execution_direction, default_execution_direction);
988 /* Finally, position the target-stack beneath the squashed
989 "current_target". That way code looking for a non-inherited
990 target method can quickly and simply find it. */
991 current_target.beneath = target_stack;
994 setup_target_debug ();
997 /* Push a new target type into the stack of the existing target accessors,
998 possibly superseding some of the existing accessors.
1000 Rather than allow an empty stack, we always have the dummy target at
1001 the bottom stratum, so we can call the function vectors without
1005 push_target (struct target_ops *t)
1007 struct target_ops **cur;
1009 /* Check magic number. If wrong, it probably means someone changed
1010 the struct definition, but not all the places that initialize one. */
1011 if (t->to_magic != OPS_MAGIC)
1013 fprintf_unfiltered (gdb_stderr,
1014 "Magic number of %s target struct wrong\n",
1016 internal_error (__FILE__, __LINE__,
1017 _("failed internal consistency check"));
1020 /* Find the proper stratum to install this target in. */
1021 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
1023 if ((int) (t->to_stratum) >= (int) (*cur)->to_stratum)
1027 /* If there's already targets at this stratum, remove them. */
1028 /* FIXME: cagney/2003-10-15: I think this should be popping all
1029 targets to CUR, and not just those at this stratum level. */
1030 while ((*cur) != NULL && t->to_stratum == (*cur)->to_stratum)
1032 /* There's already something at this stratum level. Close it,
1033 and un-hook it from the stack. */
1034 struct target_ops *tmp = (*cur);
1036 (*cur) = (*cur)->beneath;
1037 tmp->beneath = NULL;
1041 /* We have removed all targets in our stratum, now add the new one. */
1042 t->beneath = (*cur);
1045 update_current_target ();
1048 /* Remove a target_ops vector from the stack, wherever it may be.
1049 Return how many times it was removed (0 or 1). */
1052 unpush_target (struct target_ops *t)
1054 struct target_ops **cur;
1055 struct target_ops *tmp;
1057 if (t->to_stratum == dummy_stratum)
1058 internal_error (__FILE__, __LINE__,
1059 _("Attempt to unpush the dummy target"));
1061 /* Look for the specified target. Note that we assume that a target
1062 can only occur once in the target stack. */
1064 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
1070 /* If we don't find target_ops, quit. Only open targets should be
1075 /* Unchain the target. */
1077 (*cur) = (*cur)->beneath;
1078 tmp->beneath = NULL;
1080 update_current_target ();
1082 /* Finally close the target. Note we do this after unchaining, so
1083 any target method calls from within the target_close
1084 implementation don't end up in T anymore. */
1091 pop_all_targets_above (enum strata above_stratum)
1093 while ((int) (current_target.to_stratum) > (int) above_stratum)
1095 if (!unpush_target (target_stack))
1097 fprintf_unfiltered (gdb_stderr,
1098 "pop_all_targets couldn't find target %s\n",
1099 target_stack->to_shortname);
1100 internal_error (__FILE__, __LINE__,
1101 _("failed internal consistency check"));
1108 pop_all_targets (void)
1110 pop_all_targets_above (dummy_stratum);
1113 /* Return 1 if T is now pushed in the target stack. Return 0 otherwise. */
1116 target_is_pushed (struct target_ops *t)
1118 struct target_ops **cur;
1120 /* Check magic number. If wrong, it probably means someone changed
1121 the struct definition, but not all the places that initialize one. */
1122 if (t->to_magic != OPS_MAGIC)
1124 fprintf_unfiltered (gdb_stderr,
1125 "Magic number of %s target struct wrong\n",
1127 internal_error (__FILE__, __LINE__,
1128 _("failed internal consistency check"));
1131 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
1138 /* Using the objfile specified in OBJFILE, find the address for the
1139 current thread's thread-local storage with offset OFFSET. */
1141 target_translate_tls_address (struct objfile *objfile, CORE_ADDR offset)
1143 volatile CORE_ADDR addr = 0;
1144 struct target_ops *target;
1146 for (target = current_target.beneath;
1148 target = target->beneath)
1150 if (target->to_get_thread_local_address != NULL)
1155 && gdbarch_fetch_tls_load_module_address_p (target_gdbarch ()))
1157 ptid_t ptid = inferior_ptid;
1158 volatile struct gdb_exception ex;
1160 TRY_CATCH (ex, RETURN_MASK_ALL)
1164 /* Fetch the load module address for this objfile. */
1165 lm_addr = gdbarch_fetch_tls_load_module_address (target_gdbarch (),
1167 /* If it's 0, throw the appropriate exception. */
1169 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR,
1170 _("TLS load module not found"));
1172 addr = target->to_get_thread_local_address (target, ptid,
1175 /* If an error occurred, print TLS related messages here. Otherwise,
1176 throw the error to some higher catcher. */
1179 int objfile_is_library = (objfile->flags & OBJF_SHARED);
1183 case TLS_NO_LIBRARY_SUPPORT_ERROR:
1184 error (_("Cannot find thread-local variables "
1185 "in this thread library."));
1187 case TLS_LOAD_MODULE_NOT_FOUND_ERROR:
1188 if (objfile_is_library)
1189 error (_("Cannot find shared library `%s' in dynamic"
1190 " linker's load module list"), objfile_name (objfile));
1192 error (_("Cannot find executable file `%s' in dynamic"
1193 " linker's load module list"), objfile_name (objfile));
1195 case TLS_NOT_ALLOCATED_YET_ERROR:
1196 if (objfile_is_library)
1197 error (_("The inferior has not yet allocated storage for"
1198 " thread-local variables in\n"
1199 "the shared library `%s'\n"
1201 objfile_name (objfile), target_pid_to_str (ptid));
1203 error (_("The inferior has not yet allocated storage for"
1204 " thread-local variables in\n"
1205 "the executable `%s'\n"
1207 objfile_name (objfile), target_pid_to_str (ptid));
1209 case TLS_GENERIC_ERROR:
1210 if (objfile_is_library)
1211 error (_("Cannot find thread-local storage for %s, "
1212 "shared library %s:\n%s"),
1213 target_pid_to_str (ptid),
1214 objfile_name (objfile), ex.message);
1216 error (_("Cannot find thread-local storage for %s, "
1217 "executable file %s:\n%s"),
1218 target_pid_to_str (ptid),
1219 objfile_name (objfile), ex.message);
1222 throw_exception (ex);
1227 /* It wouldn't be wrong here to try a gdbarch method, too; finding
1228 TLS is an ABI-specific thing. But we don't do that yet. */
1230 error (_("Cannot find thread-local variables on this target"));
1236 target_xfer_error_to_string (enum target_xfer_error err)
1238 #define CASE(X) case X: return #X
1241 CASE(TARGET_XFER_E_IO);
1242 CASE(TARGET_XFER_E_UNAVAILABLE);
1251 #define MIN(A, B) (((A) <= (B)) ? (A) : (B))
1253 /* target_read_string -- read a null terminated string, up to LEN bytes,
1254 from MEMADDR in target. Set *ERRNOP to the errno code, or 0 if successful.
1255 Set *STRING to a pointer to malloc'd memory containing the data; the caller
1256 is responsible for freeing it. Return the number of bytes successfully
1260 target_read_string (CORE_ADDR memaddr, char **string, int len, int *errnop)
1262 int tlen, offset, i;
1266 int buffer_allocated;
1268 unsigned int nbytes_read = 0;
1270 gdb_assert (string);
1272 /* Small for testing. */
1273 buffer_allocated = 4;
1274 buffer = xmalloc (buffer_allocated);
1279 tlen = MIN (len, 4 - (memaddr & 3));
1280 offset = memaddr & 3;
1282 errcode = target_read_memory (memaddr & ~3, buf, sizeof buf);
1285 /* The transfer request might have crossed the boundary to an
1286 unallocated region of memory. Retry the transfer, requesting
1290 errcode = target_read_memory (memaddr, buf, 1);
1295 if (bufptr - buffer + tlen > buffer_allocated)
1299 bytes = bufptr - buffer;
1300 buffer_allocated *= 2;
1301 buffer = xrealloc (buffer, buffer_allocated);
1302 bufptr = buffer + bytes;
1305 for (i = 0; i < tlen; i++)
1307 *bufptr++ = buf[i + offset];
1308 if (buf[i + offset] == '\000')
1310 nbytes_read += i + 1;
1317 nbytes_read += tlen;
1326 struct target_section_table *
1327 target_get_section_table (struct target_ops *target)
1329 struct target_ops *t;
1332 fprintf_unfiltered (gdb_stdlog, "target_get_section_table ()\n");
1334 for (t = target; t != NULL; t = t->beneath)
1335 if (t->to_get_section_table != NULL)
1336 return (*t->to_get_section_table) (t);
1341 /* Find a section containing ADDR. */
1343 struct target_section *
1344 target_section_by_addr (struct target_ops *target, CORE_ADDR addr)
1346 struct target_section_table *table = target_get_section_table (target);
1347 struct target_section *secp;
1352 for (secp = table->sections; secp < table->sections_end; secp++)
1354 if (addr >= secp->addr && addr < secp->endaddr)
1360 /* Read memory from the live target, even if currently inspecting a
1361 traceframe. The return is the same as that of target_read. */
1364 target_read_live_memory (enum target_object object,
1365 ULONGEST memaddr, gdb_byte *myaddr, LONGEST len)
1368 struct cleanup *cleanup;
1370 /* Switch momentarily out of tfind mode so to access live memory.
1371 Note that this must not clear global state, such as the frame
1372 cache, which must still remain valid for the previous traceframe.
1373 We may be _building_ the frame cache at this point. */
1374 cleanup = make_cleanup_restore_traceframe_number ();
1375 set_traceframe_number (-1);
1377 ret = target_read (current_target.beneath, object, NULL,
1378 myaddr, memaddr, len);
1380 do_cleanups (cleanup);
1384 /* Using the set of read-only target sections of OPS, read live
1385 read-only memory. Note that the actual reads start from the
1386 top-most target again.
1388 For interface/parameters/return description see target.h,
1392 memory_xfer_live_readonly_partial (struct target_ops *ops,
1393 enum target_object object,
1394 gdb_byte *readbuf, ULONGEST memaddr,
1397 struct target_section *secp;
1398 struct target_section_table *table;
1400 secp = target_section_by_addr (ops, memaddr);
1402 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1403 secp->the_bfd_section)
1406 struct target_section *p;
1407 ULONGEST memend = memaddr + len;
1409 table = target_get_section_table (ops);
1411 for (p = table->sections; p < table->sections_end; p++)
1413 if (memaddr >= p->addr)
1415 if (memend <= p->endaddr)
1417 /* Entire transfer is within this section. */
1418 return target_read_live_memory (object, memaddr,
1421 else if (memaddr >= p->endaddr)
1423 /* This section ends before the transfer starts. */
1428 /* This section overlaps the transfer. Just do half. */
1429 len = p->endaddr - memaddr;
1430 return target_read_live_memory (object, memaddr,
1440 /* Perform a partial memory transfer.
1441 For docs see target.h, to_xfer_partial. */
1444 memory_xfer_partial_1 (struct target_ops *ops, enum target_object object,
1445 void *readbuf, const void *writebuf, ULONGEST memaddr,
1450 struct mem_region *region;
1451 struct inferior *inf;
1453 /* For accesses to unmapped overlay sections, read directly from
1454 files. Must do this first, as MEMADDR may need adjustment. */
1455 if (readbuf != NULL && overlay_debugging)
1457 struct obj_section *section = find_pc_overlay (memaddr);
1459 if (pc_in_unmapped_range (memaddr, section))
1461 struct target_section_table *table
1462 = target_get_section_table (ops);
1463 const char *section_name = section->the_bfd_section->name;
1465 memaddr = overlay_mapped_address (memaddr, section);
1466 return section_table_xfer_memory_partial (readbuf, writebuf,
1469 table->sections_end,
1474 /* Try the executable files, if "trust-readonly-sections" is set. */
1475 if (readbuf != NULL && trust_readonly)
1477 struct target_section *secp;
1478 struct target_section_table *table;
1480 secp = target_section_by_addr (ops, memaddr);
1482 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1483 secp->the_bfd_section)
1486 table = target_get_section_table (ops);
1487 return section_table_xfer_memory_partial (readbuf, writebuf,
1490 table->sections_end,
1495 /* If reading unavailable memory in the context of traceframes, and
1496 this address falls within a read-only section, fallback to
1497 reading from live memory. */
1498 if (readbuf != NULL && get_traceframe_number () != -1)
1500 VEC(mem_range_s) *available;
1502 /* If we fail to get the set of available memory, then the
1503 target does not support querying traceframe info, and so we
1504 attempt reading from the traceframe anyway (assuming the
1505 target implements the old QTro packet then). */
1506 if (traceframe_available_memory (&available, memaddr, len))
1508 struct cleanup *old_chain;
1510 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
1512 if (VEC_empty (mem_range_s, available)
1513 || VEC_index (mem_range_s, available, 0)->start != memaddr)
1515 /* Don't read into the traceframe's available
1517 if (!VEC_empty (mem_range_s, available))
1519 LONGEST oldlen = len;
1521 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
1522 gdb_assert (len <= oldlen);
1525 do_cleanups (old_chain);
1527 /* This goes through the topmost target again. */
1528 res = memory_xfer_live_readonly_partial (ops, object,
1529 readbuf, memaddr, len);
1533 /* No use trying further, we know some memory starting
1534 at MEMADDR isn't available. */
1535 return TARGET_XFER_E_UNAVAILABLE;
1538 /* Don't try to read more than how much is available, in
1539 case the target implements the deprecated QTro packet to
1540 cater for older GDBs (the target's knowledge of read-only
1541 sections may be outdated by now). */
1542 len = VEC_index (mem_range_s, available, 0)->length;
1544 do_cleanups (old_chain);
1548 /* Try GDB's internal data cache. */
1549 region = lookup_mem_region (memaddr);
1550 /* region->hi == 0 means there's no upper bound. */
1551 if (memaddr + len < region->hi || region->hi == 0)
1554 reg_len = region->hi - memaddr;
1556 switch (region->attrib.mode)
1559 if (writebuf != NULL)
1564 if (readbuf != NULL)
1569 /* We only support writing to flash during "load" for now. */
1570 if (writebuf != NULL)
1571 error (_("Writing to flash memory forbidden in this context"));
1578 if (!ptid_equal (inferior_ptid, null_ptid))
1579 inf = find_inferior_pid (ptid_get_pid (inferior_ptid));
1584 /* The dcache reads whole cache lines; that doesn't play well
1585 with reading from a trace buffer, because reading outside of
1586 the collected memory range fails. */
1587 && get_traceframe_number () == -1
1588 && (region->attrib.cache
1589 || (stack_cache_enabled_p && object == TARGET_OBJECT_STACK_MEMORY)))
1591 if (readbuf != NULL)
1592 res = dcache_xfer_memory (ops, target_dcache, memaddr, readbuf,
1595 /* FIXME drow/2006-08-09: If we're going to preserve const
1596 correctness dcache_xfer_memory should take readbuf and
1598 res = dcache_xfer_memory (ops, target_dcache, memaddr,
1607 /* If none of those methods found the memory we wanted, fall back
1608 to a target partial transfer. Normally a single call to
1609 to_xfer_partial is enough; if it doesn't recognize an object
1610 it will call the to_xfer_partial of the next target down.
1611 But for memory this won't do. Memory is the only target
1612 object which can be read from more than one valid target.
1613 A core file, for instance, could have some of memory but
1614 delegate other bits to the target below it. So, we must
1615 manually try all targets. */
1619 res = ops->to_xfer_partial (ops, TARGET_OBJECT_MEMORY, NULL,
1620 readbuf, writebuf, memaddr, reg_len);
1624 /* We want to continue past core files to executables, but not
1625 past a running target's memory. */
1626 if (ops->to_has_all_memory (ops))
1631 while (ops != NULL);
1633 /* Make sure the cache gets updated no matter what - if we are writing
1634 to the stack. Even if this write is not tagged as such, we still need
1635 to update the cache. */
1640 && !region->attrib.cache
1641 && stack_cache_enabled_p
1642 && object != TARGET_OBJECT_STACK_MEMORY)
1644 dcache_update (target_dcache, memaddr, (void *) writebuf, res);
1647 /* If we still haven't got anything, return the last error. We
1652 /* Perform a partial memory transfer. For docs see target.h,
1656 memory_xfer_partial (struct target_ops *ops, enum target_object object,
1657 void *readbuf, const void *writebuf, ULONGEST memaddr,
1662 /* Zero length requests are ok and require no work. */
1666 /* Fill in READBUF with breakpoint shadows, or WRITEBUF with
1667 breakpoint insns, thus hiding out from higher layers whether
1668 there are software breakpoints inserted in the code stream. */
1669 if (readbuf != NULL)
1671 res = memory_xfer_partial_1 (ops, object, readbuf, NULL, memaddr, len);
1673 if (res > 0 && !show_memory_breakpoints)
1674 breakpoint_xfer_memory (readbuf, NULL, NULL, memaddr, res);
1679 struct cleanup *old_chain;
1681 /* A large write request is likely to be partially satisfied
1682 by memory_xfer_partial_1. We will continually malloc
1683 and free a copy of the entire write request for breakpoint
1684 shadow handling even though we only end up writing a small
1685 subset of it. Cap writes to 4KB to mitigate this. */
1686 len = min (4096, len);
1688 buf = xmalloc (len);
1689 old_chain = make_cleanup (xfree, buf);
1690 memcpy (buf, writebuf, len);
1692 breakpoint_xfer_memory (NULL, buf, writebuf, memaddr, len);
1693 res = memory_xfer_partial_1 (ops, object, NULL, buf, memaddr, len);
1695 do_cleanups (old_chain);
1702 restore_show_memory_breakpoints (void *arg)
1704 show_memory_breakpoints = (uintptr_t) arg;
1708 make_show_memory_breakpoints_cleanup (int show)
1710 int current = show_memory_breakpoints;
1712 show_memory_breakpoints = show;
1713 return make_cleanup (restore_show_memory_breakpoints,
1714 (void *) (uintptr_t) current);
1717 /* For docs see target.h, to_xfer_partial. */
1720 target_xfer_partial (struct target_ops *ops,
1721 enum target_object object, const char *annex,
1722 void *readbuf, const void *writebuf,
1723 ULONGEST offset, LONGEST len)
1727 gdb_assert (ops->to_xfer_partial != NULL);
1729 if (writebuf && !may_write_memory)
1730 error (_("Writing to memory is not allowed (addr %s, len %s)"),
1731 core_addr_to_string_nz (offset), plongest (len));
1733 /* If this is a memory transfer, let the memory-specific code
1734 have a look at it instead. Memory transfers are more
1736 if (object == TARGET_OBJECT_MEMORY || object == TARGET_OBJECT_STACK_MEMORY)
1737 retval = memory_xfer_partial (ops, object, readbuf,
1738 writebuf, offset, len);
1741 enum target_object raw_object = object;
1743 /* If this is a raw memory transfer, request the normal
1744 memory object from other layers. */
1745 if (raw_object == TARGET_OBJECT_RAW_MEMORY)
1746 raw_object = TARGET_OBJECT_MEMORY;
1748 retval = ops->to_xfer_partial (ops, raw_object, annex, readbuf,
1749 writebuf, offset, len);
1754 const unsigned char *myaddr = NULL;
1756 fprintf_unfiltered (gdb_stdlog,
1757 "%s:target_xfer_partial "
1758 "(%d, %s, %s, %s, %s, %s) = %s",
1761 (annex ? annex : "(null)"),
1762 host_address_to_string (readbuf),
1763 host_address_to_string (writebuf),
1764 core_addr_to_string_nz (offset),
1765 plongest (len), plongest (retval));
1771 if (retval > 0 && myaddr != NULL)
1775 fputs_unfiltered (", bytes =", gdb_stdlog);
1776 for (i = 0; i < retval; i++)
1778 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
1780 if (targetdebug < 2 && i > 0)
1782 fprintf_unfiltered (gdb_stdlog, " ...");
1785 fprintf_unfiltered (gdb_stdlog, "\n");
1788 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
1792 fputc_unfiltered ('\n', gdb_stdlog);
1797 /* Read LEN bytes of target memory at address MEMADDR, placing the
1798 results in GDB's memory at MYADDR. Returns either 0 for success or
1799 a target_xfer_error value if any error occurs.
1801 If an error occurs, no guarantee is made about the contents of the data at
1802 MYADDR. In particular, the caller should not depend upon partial reads
1803 filling the buffer with good data. There is no way for the caller to know
1804 how much good data might have been transfered anyway. Callers that can
1805 deal with partial reads should call target_read (which will retry until
1806 it makes no progress, and then return how much was transferred). */
1809 target_read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1811 /* Dispatch to the topmost target, not the flattened current_target.
1812 Memory accesses check target->to_has_(all_)memory, and the
1813 flattened target doesn't inherit those. */
1814 if (target_read (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1815 myaddr, memaddr, len) == len)
1818 return TARGET_XFER_E_IO;
1821 /* Like target_read_memory, but specify explicitly that this is a read from
1822 the target's stack. This may trigger different cache behavior. */
1825 target_read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1827 /* Dispatch to the topmost target, not the flattened current_target.
1828 Memory accesses check target->to_has_(all_)memory, and the
1829 flattened target doesn't inherit those. */
1831 if (target_read (current_target.beneath, TARGET_OBJECT_STACK_MEMORY, NULL,
1832 myaddr, memaddr, len) == len)
1835 return TARGET_XFER_E_IO;
1838 /* Write LEN bytes from MYADDR to target memory at address MEMADDR.
1839 Returns either 0 for success or a target_xfer_error value if any
1840 error occurs. If an error occurs, no guarantee is made about how
1841 much data got written. Callers that can deal with partial writes
1842 should call target_write. */
1845 target_write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1847 /* Dispatch to the topmost target, not the flattened current_target.
1848 Memory accesses check target->to_has_(all_)memory, and the
1849 flattened target doesn't inherit those. */
1850 if (target_write (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1851 myaddr, memaddr, len) == len)
1854 return TARGET_XFER_E_IO;
1857 /* Write LEN bytes from MYADDR to target raw memory at address
1858 MEMADDR. Returns either 0 for success or a target_xfer_error value
1859 if any error occurs. If an error occurs, no guarantee is made
1860 about how much data got written. Callers that can deal with
1861 partial writes should call target_write. */
1864 target_write_raw_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1866 /* Dispatch to the topmost target, not the flattened current_target.
1867 Memory accesses check target->to_has_(all_)memory, and the
1868 flattened target doesn't inherit those. */
1869 if (target_write (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1870 myaddr, memaddr, len) == len)
1873 return TARGET_XFER_E_IO;
1876 /* Fetch the target's memory map. */
1879 target_memory_map (void)
1881 VEC(mem_region_s) *result;
1882 struct mem_region *last_one, *this_one;
1884 struct target_ops *t;
1887 fprintf_unfiltered (gdb_stdlog, "target_memory_map ()\n");
1889 for (t = current_target.beneath; t != NULL; t = t->beneath)
1890 if (t->to_memory_map != NULL)
1896 result = t->to_memory_map (t);
1900 qsort (VEC_address (mem_region_s, result),
1901 VEC_length (mem_region_s, result),
1902 sizeof (struct mem_region), mem_region_cmp);
1904 /* Check that regions do not overlap. Simultaneously assign
1905 a numbering for the "mem" commands to use to refer to
1908 for (ix = 0; VEC_iterate (mem_region_s, result, ix, this_one); ix++)
1910 this_one->number = ix;
1912 if (last_one && last_one->hi > this_one->lo)
1914 warning (_("Overlapping regions in memory map: ignoring"));
1915 VEC_free (mem_region_s, result);
1918 last_one = this_one;
1925 target_flash_erase (ULONGEST address, LONGEST length)
1927 struct target_ops *t;
1929 for (t = current_target.beneath; t != NULL; t = t->beneath)
1930 if (t->to_flash_erase != NULL)
1933 fprintf_unfiltered (gdb_stdlog, "target_flash_erase (%s, %s)\n",
1934 hex_string (address), phex (length, 0));
1935 t->to_flash_erase (t, address, length);
1943 target_flash_done (void)
1945 struct target_ops *t;
1947 for (t = current_target.beneath; t != NULL; t = t->beneath)
1948 if (t->to_flash_done != NULL)
1951 fprintf_unfiltered (gdb_stdlog, "target_flash_done\n");
1952 t->to_flash_done (t);
1960 show_trust_readonly (struct ui_file *file, int from_tty,
1961 struct cmd_list_element *c, const char *value)
1963 fprintf_filtered (file,
1964 _("Mode for reading from readonly sections is %s.\n"),
1968 /* More generic transfers. */
1971 default_xfer_partial (struct target_ops *ops, enum target_object object,
1972 const char *annex, gdb_byte *readbuf,
1973 const gdb_byte *writebuf, ULONGEST offset, LONGEST len)
1975 if (object == TARGET_OBJECT_MEMORY
1976 && ops->deprecated_xfer_memory != NULL)
1977 /* If available, fall back to the target's
1978 "deprecated_xfer_memory" method. */
1983 if (writebuf != NULL)
1985 void *buffer = xmalloc (len);
1986 struct cleanup *cleanup = make_cleanup (xfree, buffer);
1988 memcpy (buffer, writebuf, len);
1989 xfered = ops->deprecated_xfer_memory (offset, buffer, len,
1990 1/*write*/, NULL, ops);
1991 do_cleanups (cleanup);
1993 if (readbuf != NULL)
1994 xfered = ops->deprecated_xfer_memory (offset, readbuf, len,
1995 0/*read*/, NULL, ops);
1998 else if (xfered == 0 && errno == 0)
1999 /* "deprecated_xfer_memory" uses 0, cross checked against
2000 ERRNO as one indication of an error. */
2005 else if (ops->beneath != NULL)
2006 return ops->beneath->to_xfer_partial (ops->beneath, object, annex,
2007 readbuf, writebuf, offset, len);
2012 /* The xfer_partial handler for the topmost target. Unlike the default,
2013 it does not need to handle memory specially; it just passes all
2014 requests down the stack. */
2017 current_xfer_partial (struct target_ops *ops, enum target_object object,
2018 const char *annex, gdb_byte *readbuf,
2019 const gdb_byte *writebuf, ULONGEST offset, LONGEST len)
2021 if (ops->beneath != NULL)
2022 return ops->beneath->to_xfer_partial (ops->beneath, object, annex,
2023 readbuf, writebuf, offset, len);
2028 /* Target vector read/write partial wrapper functions. */
2031 target_read_partial (struct target_ops *ops,
2032 enum target_object object,
2033 const char *annex, gdb_byte *buf,
2034 ULONGEST offset, LONGEST len)
2036 return target_xfer_partial (ops, object, annex, buf, NULL, offset, len);
2040 target_write_partial (struct target_ops *ops,
2041 enum target_object object,
2042 const char *annex, const gdb_byte *buf,
2043 ULONGEST offset, LONGEST len)
2045 return target_xfer_partial (ops, object, annex, NULL, buf, offset, len);
2048 /* Wrappers to perform the full transfer. */
2050 /* For docs on target_read see target.h. */
2053 target_read (struct target_ops *ops,
2054 enum target_object object,
2055 const char *annex, gdb_byte *buf,
2056 ULONGEST offset, LONGEST len)
2060 while (xfered < len)
2062 LONGEST xfer = target_read_partial (ops, object, annex,
2063 (gdb_byte *) buf + xfered,
2064 offset + xfered, len - xfered);
2066 /* Call an observer, notifying them of the xfer progress? */
2077 /* Assuming that the entire [begin, end) range of memory cannot be
2078 read, try to read whatever subrange is possible to read.
2080 The function returns, in RESULT, either zero or one memory block.
2081 If there's a readable subrange at the beginning, it is completely
2082 read and returned. Any further readable subrange will not be read.
2083 Otherwise, if there's a readable subrange at the end, it will be
2084 completely read and returned. Any readable subranges before it
2085 (obviously, not starting at the beginning), will be ignored. In
2086 other cases -- either no readable subrange, or readable subrange(s)
2087 that is neither at the beginning, or end, nothing is returned.
2089 The purpose of this function is to handle a read across a boundary
2090 of accessible memory in a case when memory map is not available.
2091 The above restrictions are fine for this case, but will give
2092 incorrect results if the memory is 'patchy'. However, supporting
2093 'patchy' memory would require trying to read every single byte,
2094 and it seems unacceptable solution. Explicit memory map is
2095 recommended for this case -- and target_read_memory_robust will
2096 take care of reading multiple ranges then. */
2099 read_whatever_is_readable (struct target_ops *ops,
2100 ULONGEST begin, ULONGEST end,
2101 VEC(memory_read_result_s) **result)
2103 gdb_byte *buf = xmalloc (end - begin);
2104 ULONGEST current_begin = begin;
2105 ULONGEST current_end = end;
2107 memory_read_result_s r;
2109 /* If we previously failed to read 1 byte, nothing can be done here. */
2110 if (end - begin <= 1)
2116 /* Check that either first or the last byte is readable, and give up
2117 if not. This heuristic is meant to permit reading accessible memory
2118 at the boundary of accessible region. */
2119 if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
2120 buf, begin, 1) == 1)
2125 else if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
2126 buf + (end-begin) - 1, end - 1, 1) == 1)
2137 /* Loop invariant is that the [current_begin, current_end) was previously
2138 found to be not readable as a whole.
2140 Note loop condition -- if the range has 1 byte, we can't divide the range
2141 so there's no point trying further. */
2142 while (current_end - current_begin > 1)
2144 ULONGEST first_half_begin, first_half_end;
2145 ULONGEST second_half_begin, second_half_end;
2147 ULONGEST middle = current_begin + (current_end - current_begin)/2;
2151 first_half_begin = current_begin;
2152 first_half_end = middle;
2153 second_half_begin = middle;
2154 second_half_end = current_end;
2158 first_half_begin = middle;
2159 first_half_end = current_end;
2160 second_half_begin = current_begin;
2161 second_half_end = middle;
2164 xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2165 buf + (first_half_begin - begin),
2167 first_half_end - first_half_begin);
2169 if (xfer == first_half_end - first_half_begin)
2171 /* This half reads up fine. So, the error must be in the
2173 current_begin = second_half_begin;
2174 current_end = second_half_end;
2178 /* This half is not readable. Because we've tried one byte, we
2179 know some part of this half if actually redable. Go to the next
2180 iteration to divide again and try to read.
2182 We don't handle the other half, because this function only tries
2183 to read a single readable subrange. */
2184 current_begin = first_half_begin;
2185 current_end = first_half_end;
2191 /* The [begin, current_begin) range has been read. */
2193 r.end = current_begin;
2198 /* The [current_end, end) range has been read. */
2199 LONGEST rlen = end - current_end;
2201 r.data = xmalloc (rlen);
2202 memcpy (r.data, buf + current_end - begin, rlen);
2203 r.begin = current_end;
2207 VEC_safe_push(memory_read_result_s, (*result), &r);
2211 free_memory_read_result_vector (void *x)
2213 VEC(memory_read_result_s) *v = x;
2214 memory_read_result_s *current;
2217 for (ix = 0; VEC_iterate (memory_read_result_s, v, ix, current); ++ix)
2219 xfree (current->data);
2221 VEC_free (memory_read_result_s, v);
2224 VEC(memory_read_result_s) *
2225 read_memory_robust (struct target_ops *ops, ULONGEST offset, LONGEST len)
2227 VEC(memory_read_result_s) *result = 0;
2230 while (xfered < len)
2232 struct mem_region *region = lookup_mem_region (offset + xfered);
2235 /* If there is no explicit region, a fake one should be created. */
2236 gdb_assert (region);
2238 if (region->hi == 0)
2239 rlen = len - xfered;
2241 rlen = region->hi - offset;
2243 if (region->attrib.mode == MEM_NONE || region->attrib.mode == MEM_WO)
2245 /* Cannot read this region. Note that we can end up here only
2246 if the region is explicitly marked inaccessible, or
2247 'inaccessible-by-default' is in effect. */
2252 LONGEST to_read = min (len - xfered, rlen);
2253 gdb_byte *buffer = (gdb_byte *)xmalloc (to_read);
2255 LONGEST xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2256 (gdb_byte *) buffer,
2257 offset + xfered, to_read);
2258 /* Call an observer, notifying them of the xfer progress? */
2261 /* Got an error reading full chunk. See if maybe we can read
2264 read_whatever_is_readable (ops, offset + xfered,
2265 offset + xfered + to_read, &result);
2270 struct memory_read_result r;
2272 r.begin = offset + xfered;
2273 r.end = r.begin + xfer;
2274 VEC_safe_push (memory_read_result_s, result, &r);
2284 /* An alternative to target_write with progress callbacks. */
2287 target_write_with_progress (struct target_ops *ops,
2288 enum target_object object,
2289 const char *annex, const gdb_byte *buf,
2290 ULONGEST offset, LONGEST len,
2291 void (*progress) (ULONGEST, void *), void *baton)
2295 /* Give the progress callback a chance to set up. */
2297 (*progress) (0, baton);
2299 while (xfered < len)
2301 LONGEST xfer = target_write_partial (ops, object, annex,
2302 (gdb_byte *) buf + xfered,
2303 offset + xfered, len - xfered);
2311 (*progress) (xfer, baton);
2319 /* For docs on target_write see target.h. */
2322 target_write (struct target_ops *ops,
2323 enum target_object object,
2324 const char *annex, const gdb_byte *buf,
2325 ULONGEST offset, LONGEST len)
2327 return target_write_with_progress (ops, object, annex, buf, offset, len,
2331 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
2332 the size of the transferred data. PADDING additional bytes are
2333 available in *BUF_P. This is a helper function for
2334 target_read_alloc; see the declaration of that function for more
2338 target_read_alloc_1 (struct target_ops *ops, enum target_object object,
2339 const char *annex, gdb_byte **buf_p, int padding)
2341 size_t buf_alloc, buf_pos;
2345 /* This function does not have a length parameter; it reads the
2346 entire OBJECT). Also, it doesn't support objects fetched partly
2347 from one target and partly from another (in a different stratum,
2348 e.g. a core file and an executable). Both reasons make it
2349 unsuitable for reading memory. */
2350 gdb_assert (object != TARGET_OBJECT_MEMORY);
2352 /* Start by reading up to 4K at a time. The target will throttle
2353 this number down if necessary. */
2355 buf = xmalloc (buf_alloc);
2359 n = target_read_partial (ops, object, annex, &buf[buf_pos],
2360 buf_pos, buf_alloc - buf_pos - padding);
2363 /* An error occurred. */
2369 /* Read all there was. */
2379 /* If the buffer is filling up, expand it. */
2380 if (buf_alloc < buf_pos * 2)
2383 buf = xrealloc (buf, buf_alloc);
2390 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
2391 the size of the transferred data. See the declaration in "target.h"
2392 function for more information about the return value. */
2395 target_read_alloc (struct target_ops *ops, enum target_object object,
2396 const char *annex, gdb_byte **buf_p)
2398 return target_read_alloc_1 (ops, object, annex, buf_p, 0);
2401 /* Read OBJECT/ANNEX using OPS. The result is NUL-terminated and
2402 returned as a string, allocated using xmalloc. If an error occurs
2403 or the transfer is unsupported, NULL is returned. Empty objects
2404 are returned as allocated but empty strings. A warning is issued
2405 if the result contains any embedded NUL bytes. */
2408 target_read_stralloc (struct target_ops *ops, enum target_object object,
2413 LONGEST i, transferred;
2415 transferred = target_read_alloc_1 (ops, object, annex, &buffer, 1);
2416 bufstr = (char *) buffer;
2418 if (transferred < 0)
2421 if (transferred == 0)
2422 return xstrdup ("");
2424 bufstr[transferred] = 0;
2426 /* Check for embedded NUL bytes; but allow trailing NULs. */
2427 for (i = strlen (bufstr); i < transferred; i++)
2430 warning (_("target object %d, annex %s, "
2431 "contained unexpected null characters"),
2432 (int) object, annex ? annex : "(none)");
2439 /* Memory transfer methods. */
2442 get_target_memory (struct target_ops *ops, CORE_ADDR addr, gdb_byte *buf,
2445 /* This method is used to read from an alternate, non-current
2446 target. This read must bypass the overlay support (as symbols
2447 don't match this target), and GDB's internal cache (wrong cache
2448 for this target). */
2449 if (target_read (ops, TARGET_OBJECT_RAW_MEMORY, NULL, buf, addr, len)
2451 memory_error (TARGET_XFER_E_IO, addr);
2455 get_target_memory_unsigned (struct target_ops *ops, CORE_ADDR addr,
2456 int len, enum bfd_endian byte_order)
2458 gdb_byte buf[sizeof (ULONGEST)];
2460 gdb_assert (len <= sizeof (buf));
2461 get_target_memory (ops, addr, buf, len);
2462 return extract_unsigned_integer (buf, len, byte_order);
2466 target_insert_breakpoint (struct gdbarch *gdbarch,
2467 struct bp_target_info *bp_tgt)
2469 if (!may_insert_breakpoints)
2471 warning (_("May not insert breakpoints"));
2475 return (*current_target.to_insert_breakpoint) (gdbarch, bp_tgt);
2479 target_remove_breakpoint (struct gdbarch *gdbarch,
2480 struct bp_target_info *bp_tgt)
2482 /* This is kind of a weird case to handle, but the permission might
2483 have been changed after breakpoints were inserted - in which case
2484 we should just take the user literally and assume that any
2485 breakpoints should be left in place. */
2486 if (!may_insert_breakpoints)
2488 warning (_("May not remove breakpoints"));
2492 return (*current_target.to_remove_breakpoint) (gdbarch, bp_tgt);
2496 target_info (char *args, int from_tty)
2498 struct target_ops *t;
2499 int has_all_mem = 0;
2501 if (symfile_objfile != NULL)
2502 printf_unfiltered (_("Symbols from \"%s\".\n"),
2503 objfile_name (symfile_objfile));
2505 for (t = target_stack; t != NULL; t = t->beneath)
2507 if (!(*t->to_has_memory) (t))
2510 if ((int) (t->to_stratum) <= (int) dummy_stratum)
2513 printf_unfiltered (_("\tWhile running this, "
2514 "GDB does not access memory from...\n"));
2515 printf_unfiltered ("%s:\n", t->to_longname);
2516 (t->to_files_info) (t);
2517 has_all_mem = (*t->to_has_all_memory) (t);
2521 /* This function is called before any new inferior is created, e.g.
2522 by running a program, attaching, or connecting to a target.
2523 It cleans up any state from previous invocations which might
2524 change between runs. This is a subset of what target_preopen
2525 resets (things which might change between targets). */
2528 target_pre_inferior (int from_tty)
2530 /* Clear out solib state. Otherwise the solib state of the previous
2531 inferior might have survived and is entirely wrong for the new
2532 target. This has been observed on GNU/Linux using glibc 2.3. How
2544 Cannot access memory at address 0xdeadbeef
2547 /* In some OSs, the shared library list is the same/global/shared
2548 across inferiors. If code is shared between processes, so are
2549 memory regions and features. */
2550 if (!gdbarch_has_global_solist (target_gdbarch ()))
2552 no_shared_libraries (NULL, from_tty);
2554 invalidate_target_mem_regions ();
2556 target_clear_description ();
2559 agent_capability_invalidate ();
2562 /* Callback for iterate_over_inferiors. Gets rid of the given
2566 dispose_inferior (struct inferior *inf, void *args)
2568 struct thread_info *thread;
2570 thread = any_thread_of_process (inf->pid);
2573 switch_to_thread (thread->ptid);
2575 /* Core inferiors actually should be detached, not killed. */
2576 if (target_has_execution)
2579 target_detach (NULL, 0);
2585 /* This is to be called by the open routine before it does
2589 target_preopen (int from_tty)
2593 if (have_inferiors ())
2596 || !have_live_inferiors ()
2597 || query (_("A program is being debugged already. Kill it? ")))
2598 iterate_over_inferiors (dispose_inferior, NULL);
2600 error (_("Program not killed."));
2603 /* Calling target_kill may remove the target from the stack. But if
2604 it doesn't (which seems like a win for UDI), remove it now. */
2605 /* Leave the exec target, though. The user may be switching from a
2606 live process to a core of the same program. */
2607 pop_all_targets_above (file_stratum);
2609 target_pre_inferior (from_tty);
2612 /* Detach a target after doing deferred register stores. */
2615 target_detach (const char *args, int from_tty)
2617 struct target_ops* t;
2619 if (gdbarch_has_global_breakpoints (target_gdbarch ()))
2620 /* Don't remove global breakpoints here. They're removed on
2621 disconnection from the target. */
2624 /* If we're in breakpoints-always-inserted mode, have to remove
2625 them before detaching. */
2626 remove_breakpoints_pid (ptid_get_pid (inferior_ptid));
2628 prepare_for_detach ();
2630 for (t = current_target.beneath; t != NULL; t = t->beneath)
2632 if (t->to_detach != NULL)
2634 t->to_detach (t, args, from_tty);
2636 fprintf_unfiltered (gdb_stdlog, "target_detach (%s, %d)\n",
2642 internal_error (__FILE__, __LINE__, _("could not find a target to detach"));
2646 target_disconnect (char *args, int from_tty)
2648 struct target_ops *t;
2650 /* If we're in breakpoints-always-inserted mode or if breakpoints
2651 are global across processes, we have to remove them before
2653 remove_breakpoints ();
2655 for (t = current_target.beneath; t != NULL; t = t->beneath)
2656 if (t->to_disconnect != NULL)
2659 fprintf_unfiltered (gdb_stdlog, "target_disconnect (%s, %d)\n",
2661 t->to_disconnect (t, args, from_tty);
2669 target_wait (ptid_t ptid, struct target_waitstatus *status, int options)
2671 struct target_ops *t;
2673 for (t = current_target.beneath; t != NULL; t = t->beneath)
2675 if (t->to_wait != NULL)
2677 ptid_t retval = (*t->to_wait) (t, ptid, status, options);
2681 char *status_string;
2682 char *options_string;
2684 status_string = target_waitstatus_to_string (status);
2685 options_string = target_options_to_string (options);
2686 fprintf_unfiltered (gdb_stdlog,
2687 "target_wait (%d, status, options={%s})"
2689 ptid_get_pid (ptid), options_string,
2690 ptid_get_pid (retval), status_string);
2691 xfree (status_string);
2692 xfree (options_string);
2703 target_pid_to_str (ptid_t ptid)
2705 struct target_ops *t;
2707 for (t = current_target.beneath; t != NULL; t = t->beneath)
2709 if (t->to_pid_to_str != NULL)
2710 return (*t->to_pid_to_str) (t, ptid);
2713 return normal_pid_to_str (ptid);
2717 target_thread_name (struct thread_info *info)
2719 struct target_ops *t;
2721 for (t = current_target.beneath; t != NULL; t = t->beneath)
2723 if (t->to_thread_name != NULL)
2724 return (*t->to_thread_name) (info);
2731 target_resume (ptid_t ptid, int step, enum gdb_signal signal)
2733 struct target_ops *t;
2735 target_dcache_invalidate ();
2737 for (t = current_target.beneath; t != NULL; t = t->beneath)
2739 if (t->to_resume != NULL)
2741 t->to_resume (t, ptid, step, signal);
2743 fprintf_unfiltered (gdb_stdlog, "target_resume (%d, %s, %s)\n",
2744 ptid_get_pid (ptid),
2745 step ? "step" : "continue",
2746 gdb_signal_to_name (signal));
2748 registers_changed_ptid (ptid);
2749 set_executing (ptid, 1);
2750 set_running (ptid, 1);
2751 clear_inline_frame_state (ptid);
2760 target_pass_signals (int numsigs, unsigned char *pass_signals)
2762 struct target_ops *t;
2764 for (t = current_target.beneath; t != NULL; t = t->beneath)
2766 if (t->to_pass_signals != NULL)
2772 fprintf_unfiltered (gdb_stdlog, "target_pass_signals (%d, {",
2775 for (i = 0; i < numsigs; i++)
2776 if (pass_signals[i])
2777 fprintf_unfiltered (gdb_stdlog, " %s",
2778 gdb_signal_to_name (i));
2780 fprintf_unfiltered (gdb_stdlog, " })\n");
2783 (*t->to_pass_signals) (numsigs, pass_signals);
2790 target_program_signals (int numsigs, unsigned char *program_signals)
2792 struct target_ops *t;
2794 for (t = current_target.beneath; t != NULL; t = t->beneath)
2796 if (t->to_program_signals != NULL)
2802 fprintf_unfiltered (gdb_stdlog, "target_program_signals (%d, {",
2805 for (i = 0; i < numsigs; i++)
2806 if (program_signals[i])
2807 fprintf_unfiltered (gdb_stdlog, " %s",
2808 gdb_signal_to_name (i));
2810 fprintf_unfiltered (gdb_stdlog, " })\n");
2813 (*t->to_program_signals) (numsigs, program_signals);
2819 /* Look through the list of possible targets for a target that can
2823 target_follow_fork (int follow_child, int detach_fork)
2825 struct target_ops *t;
2827 for (t = current_target.beneath; t != NULL; t = t->beneath)
2829 if (t->to_follow_fork != NULL)
2831 int retval = t->to_follow_fork (t, follow_child, detach_fork);
2834 fprintf_unfiltered (gdb_stdlog,
2835 "target_follow_fork (%d, %d) = %d\n",
2836 follow_child, detach_fork, retval);
2841 /* Some target returned a fork event, but did not know how to follow it. */
2842 internal_error (__FILE__, __LINE__,
2843 _("could not find a target to follow fork"));
2847 target_mourn_inferior (void)
2849 struct target_ops *t;
2851 for (t = current_target.beneath; t != NULL; t = t->beneath)
2853 if (t->to_mourn_inferior != NULL)
2855 t->to_mourn_inferior (t);
2857 fprintf_unfiltered (gdb_stdlog, "target_mourn_inferior ()\n");
2859 /* We no longer need to keep handles on any of the object files.
2860 Make sure to release them to avoid unnecessarily locking any
2861 of them while we're not actually debugging. */
2862 bfd_cache_close_all ();
2868 internal_error (__FILE__, __LINE__,
2869 _("could not find a target to follow mourn inferior"));
2872 /* Look for a target which can describe architectural features, starting
2873 from TARGET. If we find one, return its description. */
2875 const struct target_desc *
2876 target_read_description (struct target_ops *target)
2878 struct target_ops *t;
2880 for (t = target; t != NULL; t = t->beneath)
2881 if (t->to_read_description != NULL)
2883 const struct target_desc *tdesc;
2885 tdesc = t->to_read_description (t);
2893 /* The default implementation of to_search_memory.
2894 This implements a basic search of memory, reading target memory and
2895 performing the search here (as opposed to performing the search in on the
2896 target side with, for example, gdbserver). */
2899 simple_search_memory (struct target_ops *ops,
2900 CORE_ADDR start_addr, ULONGEST search_space_len,
2901 const gdb_byte *pattern, ULONGEST pattern_len,
2902 CORE_ADDR *found_addrp)
2904 /* NOTE: also defined in find.c testcase. */
2905 #define SEARCH_CHUNK_SIZE 16000
2906 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
2907 /* Buffer to hold memory contents for searching. */
2908 gdb_byte *search_buf;
2909 unsigned search_buf_size;
2910 struct cleanup *old_cleanups;
2912 search_buf_size = chunk_size + pattern_len - 1;
2914 /* No point in trying to allocate a buffer larger than the search space. */
2915 if (search_space_len < search_buf_size)
2916 search_buf_size = search_space_len;
2918 search_buf = malloc (search_buf_size);
2919 if (search_buf == NULL)
2920 error (_("Unable to allocate memory to perform the search."));
2921 old_cleanups = make_cleanup (free_current_contents, &search_buf);
2923 /* Prime the search buffer. */
2925 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2926 search_buf, start_addr, search_buf_size) != search_buf_size)
2928 warning (_("Unable to access %s bytes of target "
2929 "memory at %s, halting search."),
2930 pulongest (search_buf_size), hex_string (start_addr));
2931 do_cleanups (old_cleanups);
2935 /* Perform the search.
2937 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
2938 When we've scanned N bytes we copy the trailing bytes to the start and
2939 read in another N bytes. */
2941 while (search_space_len >= pattern_len)
2943 gdb_byte *found_ptr;
2944 unsigned nr_search_bytes = min (search_space_len, search_buf_size);
2946 found_ptr = memmem (search_buf, nr_search_bytes,
2947 pattern, pattern_len);
2949 if (found_ptr != NULL)
2951 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
2953 *found_addrp = found_addr;
2954 do_cleanups (old_cleanups);
2958 /* Not found in this chunk, skip to next chunk. */
2960 /* Don't let search_space_len wrap here, it's unsigned. */
2961 if (search_space_len >= chunk_size)
2962 search_space_len -= chunk_size;
2964 search_space_len = 0;
2966 if (search_space_len >= pattern_len)
2968 unsigned keep_len = search_buf_size - chunk_size;
2969 CORE_ADDR read_addr = start_addr + chunk_size + keep_len;
2972 /* Copy the trailing part of the previous iteration to the front
2973 of the buffer for the next iteration. */
2974 gdb_assert (keep_len == pattern_len - 1);
2975 memcpy (search_buf, search_buf + chunk_size, keep_len);
2977 nr_to_read = min (search_space_len - keep_len, chunk_size);
2979 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2980 search_buf + keep_len, read_addr,
2981 nr_to_read) != nr_to_read)
2983 warning (_("Unable to access %s bytes of target "
2984 "memory at %s, halting search."),
2985 plongest (nr_to_read),
2986 hex_string (read_addr));
2987 do_cleanups (old_cleanups);
2991 start_addr += chunk_size;
2997 do_cleanups (old_cleanups);
3001 /* Search SEARCH_SPACE_LEN bytes beginning at START_ADDR for the
3002 sequence of bytes in PATTERN with length PATTERN_LEN.
3004 The result is 1 if found, 0 if not found, and -1 if there was an error
3005 requiring halting of the search (e.g. memory read error).
3006 If the pattern is found the address is recorded in FOUND_ADDRP. */
3009 target_search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
3010 const gdb_byte *pattern, ULONGEST pattern_len,
3011 CORE_ADDR *found_addrp)
3013 struct target_ops *t;
3016 /* We don't use INHERIT to set current_target.to_search_memory,
3017 so we have to scan the target stack and handle targetdebug
3021 fprintf_unfiltered (gdb_stdlog, "target_search_memory (%s, ...)\n",
3022 hex_string (start_addr));
3024 for (t = current_target.beneath; t != NULL; t = t->beneath)
3025 if (t->to_search_memory != NULL)
3030 found = t->to_search_memory (t, start_addr, search_space_len,
3031 pattern, pattern_len, found_addrp);
3035 /* If a special version of to_search_memory isn't available, use the
3037 found = simple_search_memory (current_target.beneath,
3038 start_addr, search_space_len,
3039 pattern, pattern_len, found_addrp);
3043 fprintf_unfiltered (gdb_stdlog, " = %d\n", found);
3048 /* Look through the currently pushed targets. If none of them will
3049 be able to restart the currently running process, issue an error
3053 target_require_runnable (void)
3055 struct target_ops *t;
3057 for (t = target_stack; t != NULL; t = t->beneath)
3059 /* If this target knows how to create a new program, then
3060 assume we will still be able to after killing the current
3061 one. Either killing and mourning will not pop T, or else
3062 find_default_run_target will find it again. */
3063 if (t->to_create_inferior != NULL)
3066 /* Do not worry about thread_stratum targets that can not
3067 create inferiors. Assume they will be pushed again if
3068 necessary, and continue to the process_stratum. */
3069 if (t->to_stratum == thread_stratum
3070 || t->to_stratum == arch_stratum)
3073 error (_("The \"%s\" target does not support \"run\". "
3074 "Try \"help target\" or \"continue\"."),
3078 /* This function is only called if the target is running. In that
3079 case there should have been a process_stratum target and it
3080 should either know how to create inferiors, or not... */
3081 internal_error (__FILE__, __LINE__, _("No targets found"));
3084 /* Look through the list of possible targets for a target that can
3085 execute a run or attach command without any other data. This is
3086 used to locate the default process stratum.
3088 If DO_MESG is not NULL, the result is always valid (error() is
3089 called for errors); else, return NULL on error. */
3091 static struct target_ops *
3092 find_default_run_target (char *do_mesg)
3094 struct target_ops **t;
3095 struct target_ops *runable = NULL;
3100 for (t = target_structs; t < target_structs + target_struct_size;
3103 if ((*t)->to_can_run && target_can_run (*t))
3113 error (_("Don't know how to %s. Try \"help target\"."), do_mesg);
3122 find_default_attach (struct target_ops *ops, char *args, int from_tty)
3124 struct target_ops *t;
3126 t = find_default_run_target ("attach");
3127 (t->to_attach) (t, args, from_tty);
3132 find_default_create_inferior (struct target_ops *ops,
3133 char *exec_file, char *allargs, char **env,
3136 struct target_ops *t;
3138 t = find_default_run_target ("run");
3139 (t->to_create_inferior) (t, exec_file, allargs, env, from_tty);
3144 find_default_can_async_p (void)
3146 struct target_ops *t;
3148 /* This may be called before the target is pushed on the stack;
3149 look for the default process stratum. If there's none, gdb isn't
3150 configured with a native debugger, and target remote isn't
3152 t = find_default_run_target (NULL);
3153 if (t && t->to_can_async_p)
3154 return (t->to_can_async_p) ();
3159 find_default_is_async_p (void)
3161 struct target_ops *t;
3163 /* This may be called before the target is pushed on the stack;
3164 look for the default process stratum. If there's none, gdb isn't
3165 configured with a native debugger, and target remote isn't
3167 t = find_default_run_target (NULL);
3168 if (t && t->to_is_async_p)
3169 return (t->to_is_async_p) ();
3174 find_default_supports_non_stop (void)
3176 struct target_ops *t;
3178 t = find_default_run_target (NULL);
3179 if (t && t->to_supports_non_stop)
3180 return (t->to_supports_non_stop) ();
3185 target_supports_non_stop (void)
3187 struct target_ops *t;
3189 for (t = ¤t_target; t != NULL; t = t->beneath)
3190 if (t->to_supports_non_stop)
3191 return t->to_supports_non_stop ();
3196 /* Implement the "info proc" command. */
3199 target_info_proc (char *args, enum info_proc_what what)
3201 struct target_ops *t;
3203 /* If we're already connected to something that can get us OS
3204 related data, use it. Otherwise, try using the native
3206 if (current_target.to_stratum >= process_stratum)
3207 t = current_target.beneath;
3209 t = find_default_run_target (NULL);
3211 for (; t != NULL; t = t->beneath)
3213 if (t->to_info_proc != NULL)
3215 t->to_info_proc (t, args, what);
3218 fprintf_unfiltered (gdb_stdlog,
3219 "target_info_proc (\"%s\", %d)\n", args, what);
3229 find_default_supports_disable_randomization (void)
3231 struct target_ops *t;
3233 t = find_default_run_target (NULL);
3234 if (t && t->to_supports_disable_randomization)
3235 return (t->to_supports_disable_randomization) ();
3240 target_supports_disable_randomization (void)
3242 struct target_ops *t;
3244 for (t = ¤t_target; t != NULL; t = t->beneath)
3245 if (t->to_supports_disable_randomization)
3246 return t->to_supports_disable_randomization ();
3252 target_get_osdata (const char *type)
3254 struct target_ops *t;
3256 /* If we're already connected to something that can get us OS
3257 related data, use it. Otherwise, try using the native
3259 if (current_target.to_stratum >= process_stratum)
3260 t = current_target.beneath;
3262 t = find_default_run_target ("get OS data");
3267 return target_read_stralloc (t, TARGET_OBJECT_OSDATA, type);
3270 /* Determine the current address space of thread PTID. */
3272 struct address_space *
3273 target_thread_address_space (ptid_t ptid)
3275 struct address_space *aspace;
3276 struct inferior *inf;
3277 struct target_ops *t;
3279 for (t = current_target.beneath; t != NULL; t = t->beneath)
3281 if (t->to_thread_address_space != NULL)
3283 aspace = t->to_thread_address_space (t, ptid);
3284 gdb_assert (aspace);
3287 fprintf_unfiltered (gdb_stdlog,
3288 "target_thread_address_space (%s) = %d\n",
3289 target_pid_to_str (ptid),
3290 address_space_num (aspace));
3295 /* Fall-back to the "main" address space of the inferior. */
3296 inf = find_inferior_pid (ptid_get_pid (ptid));
3298 if (inf == NULL || inf->aspace == NULL)
3299 internal_error (__FILE__, __LINE__,
3300 _("Can't determine the current "
3301 "address space of thread %s\n"),
3302 target_pid_to_str (ptid));
3308 /* Target file operations. */
3310 static struct target_ops *
3311 default_fileio_target (void)
3313 /* If we're already connected to something that can perform
3314 file I/O, use it. Otherwise, try using the native target. */
3315 if (current_target.to_stratum >= process_stratum)
3316 return current_target.beneath;
3318 return find_default_run_target ("file I/O");
3321 /* Open FILENAME on the target, using FLAGS and MODE. Return a
3322 target file descriptor, or -1 if an error occurs (and set
3325 target_fileio_open (const char *filename, int flags, int mode,
3328 struct target_ops *t;
3330 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3332 if (t->to_fileio_open != NULL)
3334 int fd = t->to_fileio_open (filename, flags, mode, target_errno);
3337 fprintf_unfiltered (gdb_stdlog,
3338 "target_fileio_open (%s,0x%x,0%o) = %d (%d)\n",
3339 filename, flags, mode,
3340 fd, fd != -1 ? 0 : *target_errno);
3345 *target_errno = FILEIO_ENOSYS;
3349 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
3350 Return the number of bytes written, or -1 if an error occurs
3351 (and set *TARGET_ERRNO). */
3353 target_fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
3354 ULONGEST offset, int *target_errno)
3356 struct target_ops *t;
3358 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3360 if (t->to_fileio_pwrite != NULL)
3362 int ret = t->to_fileio_pwrite (fd, write_buf, len, offset,
3366 fprintf_unfiltered (gdb_stdlog,
3367 "target_fileio_pwrite (%d,...,%d,%s) "
3369 fd, len, pulongest (offset),
3370 ret, ret != -1 ? 0 : *target_errno);
3375 *target_errno = FILEIO_ENOSYS;
3379 /* Read up to LEN bytes FD on the target into READ_BUF.
3380 Return the number of bytes read, or -1 if an error occurs
3381 (and set *TARGET_ERRNO). */
3383 target_fileio_pread (int fd, gdb_byte *read_buf, int len,
3384 ULONGEST offset, int *target_errno)
3386 struct target_ops *t;
3388 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3390 if (t->to_fileio_pread != NULL)
3392 int ret = t->to_fileio_pread (fd, read_buf, len, offset,
3396 fprintf_unfiltered (gdb_stdlog,
3397 "target_fileio_pread (%d,...,%d,%s) "
3399 fd, len, pulongest (offset),
3400 ret, ret != -1 ? 0 : *target_errno);
3405 *target_errno = FILEIO_ENOSYS;
3409 /* Close FD on the target. Return 0, or -1 if an error occurs
3410 (and set *TARGET_ERRNO). */
3412 target_fileio_close (int fd, int *target_errno)
3414 struct target_ops *t;
3416 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3418 if (t->to_fileio_close != NULL)
3420 int ret = t->to_fileio_close (fd, target_errno);
3423 fprintf_unfiltered (gdb_stdlog,
3424 "target_fileio_close (%d) = %d (%d)\n",
3425 fd, ret, ret != -1 ? 0 : *target_errno);
3430 *target_errno = FILEIO_ENOSYS;
3434 /* Unlink FILENAME on the target. Return 0, or -1 if an error
3435 occurs (and set *TARGET_ERRNO). */
3437 target_fileio_unlink (const char *filename, int *target_errno)
3439 struct target_ops *t;
3441 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3443 if (t->to_fileio_unlink != NULL)
3445 int ret = t->to_fileio_unlink (filename, target_errno);
3448 fprintf_unfiltered (gdb_stdlog,
3449 "target_fileio_unlink (%s) = %d (%d)\n",
3450 filename, ret, ret != -1 ? 0 : *target_errno);
3455 *target_errno = FILEIO_ENOSYS;
3459 /* Read value of symbolic link FILENAME on the target. Return a
3460 null-terminated string allocated via xmalloc, or NULL if an error
3461 occurs (and set *TARGET_ERRNO). */
3463 target_fileio_readlink (const char *filename, int *target_errno)
3465 struct target_ops *t;
3467 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3469 if (t->to_fileio_readlink != NULL)
3471 char *ret = t->to_fileio_readlink (filename, target_errno);
3474 fprintf_unfiltered (gdb_stdlog,
3475 "target_fileio_readlink (%s) = %s (%d)\n",
3476 filename, ret? ret : "(nil)",
3477 ret? 0 : *target_errno);
3482 *target_errno = FILEIO_ENOSYS;
3487 target_fileio_close_cleanup (void *opaque)
3489 int fd = *(int *) opaque;
3492 target_fileio_close (fd, &target_errno);
3495 /* Read target file FILENAME. Store the result in *BUF_P and
3496 return the size of the transferred data. PADDING additional bytes are
3497 available in *BUF_P. This is a helper function for
3498 target_fileio_read_alloc; see the declaration of that function for more
3502 target_fileio_read_alloc_1 (const char *filename,
3503 gdb_byte **buf_p, int padding)
3505 struct cleanup *close_cleanup;
3506 size_t buf_alloc, buf_pos;
3512 fd = target_fileio_open (filename, FILEIO_O_RDONLY, 0700, &target_errno);
3516 close_cleanup = make_cleanup (target_fileio_close_cleanup, &fd);
3518 /* Start by reading up to 4K at a time. The target will throttle
3519 this number down if necessary. */
3521 buf = xmalloc (buf_alloc);
3525 n = target_fileio_pread (fd, &buf[buf_pos],
3526 buf_alloc - buf_pos - padding, buf_pos,
3530 /* An error occurred. */
3531 do_cleanups (close_cleanup);
3537 /* Read all there was. */
3538 do_cleanups (close_cleanup);
3548 /* If the buffer is filling up, expand it. */
3549 if (buf_alloc < buf_pos * 2)
3552 buf = xrealloc (buf, buf_alloc);
3559 /* Read target file FILENAME. Store the result in *BUF_P and return
3560 the size of the transferred data. See the declaration in "target.h"
3561 function for more information about the return value. */
3564 target_fileio_read_alloc (const char *filename, gdb_byte **buf_p)
3566 return target_fileio_read_alloc_1 (filename, buf_p, 0);
3569 /* Read target file FILENAME. The result is NUL-terminated and
3570 returned as a string, allocated using xmalloc. If an error occurs
3571 or the transfer is unsupported, NULL is returned. Empty objects
3572 are returned as allocated but empty strings. A warning is issued
3573 if the result contains any embedded NUL bytes. */
3576 target_fileio_read_stralloc (const char *filename)
3580 LONGEST i, transferred;
3582 transferred = target_fileio_read_alloc_1 (filename, &buffer, 1);
3583 bufstr = (char *) buffer;
3585 if (transferred < 0)
3588 if (transferred == 0)
3589 return xstrdup ("");
3591 bufstr[transferred] = 0;
3593 /* Check for embedded NUL bytes; but allow trailing NULs. */
3594 for (i = strlen (bufstr); i < transferred; i++)
3597 warning (_("target file %s "
3598 "contained unexpected null characters"),
3608 default_region_ok_for_hw_watchpoint (CORE_ADDR addr, int len)
3610 return (len <= gdbarch_ptr_bit (target_gdbarch ()) / TARGET_CHAR_BIT);
3614 default_watchpoint_addr_within_range (struct target_ops *target,
3616 CORE_ADDR start, int length)
3618 return addr >= start && addr < start + length;
3621 static struct gdbarch *
3622 default_thread_architecture (struct target_ops *ops, ptid_t ptid)
3624 return target_gdbarch ();
3640 return_minus_one (void)
3646 * Find the next target down the stack from the specified target.
3650 find_target_beneath (struct target_ops *t)
3656 /* The inferior process has died. Long live the inferior! */
3659 generic_mourn_inferior (void)
3663 ptid = inferior_ptid;
3664 inferior_ptid = null_ptid;
3666 /* Mark breakpoints uninserted in case something tries to delete a
3667 breakpoint while we delete the inferior's threads (which would
3668 fail, since the inferior is long gone). */
3669 mark_breakpoints_out ();
3671 if (!ptid_equal (ptid, null_ptid))
3673 int pid = ptid_get_pid (ptid);
3674 exit_inferior (pid);
3677 /* Note this wipes step-resume breakpoints, so needs to be done
3678 after exit_inferior, which ends up referencing the step-resume
3679 breakpoints through clear_thread_inferior_resources. */
3680 breakpoint_init_inferior (inf_exited);
3682 registers_changed ();
3684 reopen_exec_file ();
3685 reinit_frame_cache ();
3687 if (deprecated_detach_hook)
3688 deprecated_detach_hook ();
3691 /* Convert a normal process ID to a string. Returns the string in a
3695 normal_pid_to_str (ptid_t ptid)
3697 static char buf[32];
3699 xsnprintf (buf, sizeof buf, "process %d", ptid_get_pid (ptid));
3704 dummy_pid_to_str (struct target_ops *ops, ptid_t ptid)
3706 return normal_pid_to_str (ptid);
3709 /* Error-catcher for target_find_memory_regions. */
3711 dummy_find_memory_regions (find_memory_region_ftype ignore1, void *ignore2)
3713 error (_("Command not implemented for this target."));
3717 /* Error-catcher for target_make_corefile_notes. */
3719 dummy_make_corefile_notes (bfd *ignore1, int *ignore2)
3721 error (_("Command not implemented for this target."));
3725 /* Error-catcher for target_get_bookmark. */
3727 dummy_get_bookmark (char *ignore1, int ignore2)
3733 /* Error-catcher for target_goto_bookmark. */
3735 dummy_goto_bookmark (gdb_byte *ignore, int from_tty)
3740 /* Set up the handful of non-empty slots needed by the dummy target
3744 init_dummy_target (void)
3746 dummy_target.to_shortname = "None";
3747 dummy_target.to_longname = "None";
3748 dummy_target.to_doc = "";
3749 dummy_target.to_attach = find_default_attach;
3750 dummy_target.to_detach =
3751 (void (*)(struct target_ops *, const char *, int))target_ignore;
3752 dummy_target.to_create_inferior = find_default_create_inferior;
3753 dummy_target.to_can_async_p = find_default_can_async_p;
3754 dummy_target.to_is_async_p = find_default_is_async_p;
3755 dummy_target.to_supports_non_stop = find_default_supports_non_stop;
3756 dummy_target.to_supports_disable_randomization
3757 = find_default_supports_disable_randomization;
3758 dummy_target.to_pid_to_str = dummy_pid_to_str;
3759 dummy_target.to_stratum = dummy_stratum;
3760 dummy_target.to_find_memory_regions = dummy_find_memory_regions;
3761 dummy_target.to_make_corefile_notes = dummy_make_corefile_notes;
3762 dummy_target.to_get_bookmark = dummy_get_bookmark;
3763 dummy_target.to_goto_bookmark = dummy_goto_bookmark;
3764 dummy_target.to_xfer_partial = default_xfer_partial;
3765 dummy_target.to_has_all_memory = (int (*) (struct target_ops *)) return_zero;
3766 dummy_target.to_has_memory = (int (*) (struct target_ops *)) return_zero;
3767 dummy_target.to_has_stack = (int (*) (struct target_ops *)) return_zero;
3768 dummy_target.to_has_registers = (int (*) (struct target_ops *)) return_zero;
3769 dummy_target.to_has_execution
3770 = (int (*) (struct target_ops *, ptid_t)) return_zero;
3771 dummy_target.to_stopped_by_watchpoint = return_zero;
3772 dummy_target.to_stopped_data_address =
3773 (int (*) (struct target_ops *, CORE_ADDR *)) return_zero;
3774 dummy_target.to_magic = OPS_MAGIC;
3778 debug_to_open (char *args, int from_tty)
3780 debug_target.to_open (args, from_tty);
3782 fprintf_unfiltered (gdb_stdlog, "target_open (%s, %d)\n", args, from_tty);
3786 target_close (struct target_ops *targ)
3788 gdb_assert (!target_is_pushed (targ));
3790 if (targ->to_xclose != NULL)
3791 targ->to_xclose (targ);
3792 else if (targ->to_close != NULL)
3796 fprintf_unfiltered (gdb_stdlog, "target_close ()\n");
3800 target_attach (char *args, int from_tty)
3802 struct target_ops *t;
3804 for (t = current_target.beneath; t != NULL; t = t->beneath)
3806 if (t->to_attach != NULL)
3808 t->to_attach (t, args, from_tty);
3810 fprintf_unfiltered (gdb_stdlog, "target_attach (%s, %d)\n",
3816 internal_error (__FILE__, __LINE__,
3817 _("could not find a target to attach"));
3821 target_thread_alive (ptid_t ptid)
3823 struct target_ops *t;
3825 for (t = current_target.beneath; t != NULL; t = t->beneath)
3827 if (t->to_thread_alive != NULL)
3831 retval = t->to_thread_alive (t, ptid);
3833 fprintf_unfiltered (gdb_stdlog, "target_thread_alive (%d) = %d\n",
3834 ptid_get_pid (ptid), retval);
3844 target_find_new_threads (void)
3846 struct target_ops *t;
3848 for (t = current_target.beneath; t != NULL; t = t->beneath)
3850 if (t->to_find_new_threads != NULL)
3852 t->to_find_new_threads (t);
3854 fprintf_unfiltered (gdb_stdlog, "target_find_new_threads ()\n");
3862 target_stop (ptid_t ptid)
3866 warning (_("May not interrupt or stop the target, ignoring attempt"));
3870 (*current_target.to_stop) (ptid);
3874 debug_to_post_attach (int pid)
3876 debug_target.to_post_attach (pid);
3878 fprintf_unfiltered (gdb_stdlog, "target_post_attach (%d)\n", pid);
3881 /* Concatenate ELEM to LIST, a comma separate list, and return the
3882 result. The LIST incoming argument is released. */
3885 str_comma_list_concat_elem (char *list, const char *elem)
3888 return xstrdup (elem);
3890 return reconcat (list, list, ", ", elem, (char *) NULL);
3893 /* Helper for target_options_to_string. If OPT is present in
3894 TARGET_OPTIONS, append the OPT_STR (string version of OPT) in RET.
3895 Returns the new resulting string. OPT is removed from
3899 do_option (int *target_options, char *ret,
3900 int opt, char *opt_str)
3902 if ((*target_options & opt) != 0)
3904 ret = str_comma_list_concat_elem (ret, opt_str);
3905 *target_options &= ~opt;
3912 target_options_to_string (int target_options)
3916 #define DO_TARG_OPTION(OPT) \
3917 ret = do_option (&target_options, ret, OPT, #OPT)
3919 DO_TARG_OPTION (TARGET_WNOHANG);
3921 if (target_options != 0)
3922 ret = str_comma_list_concat_elem (ret, "unknown???");
3930 debug_print_register (const char * func,
3931 struct regcache *regcache, int regno)
3933 struct gdbarch *gdbarch = get_regcache_arch (regcache);
3935 fprintf_unfiltered (gdb_stdlog, "%s ", func);
3936 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch)
3937 && gdbarch_register_name (gdbarch, regno) != NULL
3938 && gdbarch_register_name (gdbarch, regno)[0] != '\0')
3939 fprintf_unfiltered (gdb_stdlog, "(%s)",
3940 gdbarch_register_name (gdbarch, regno));
3942 fprintf_unfiltered (gdb_stdlog, "(%d)", regno);
3943 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch))
3945 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
3946 int i, size = register_size (gdbarch, regno);
3947 gdb_byte buf[MAX_REGISTER_SIZE];
3949 regcache_raw_collect (regcache, regno, buf);
3950 fprintf_unfiltered (gdb_stdlog, " = ");
3951 for (i = 0; i < size; i++)
3953 fprintf_unfiltered (gdb_stdlog, "%02x", buf[i]);
3955 if (size <= sizeof (LONGEST))
3957 ULONGEST val = extract_unsigned_integer (buf, size, byte_order);
3959 fprintf_unfiltered (gdb_stdlog, " %s %s",
3960 core_addr_to_string_nz (val), plongest (val));
3963 fprintf_unfiltered (gdb_stdlog, "\n");
3967 target_fetch_registers (struct regcache *regcache, int regno)
3969 struct target_ops *t;
3971 for (t = current_target.beneath; t != NULL; t = t->beneath)
3973 if (t->to_fetch_registers != NULL)
3975 t->to_fetch_registers (t, regcache, regno);
3977 debug_print_register ("target_fetch_registers", regcache, regno);
3984 target_store_registers (struct regcache *regcache, int regno)
3986 struct target_ops *t;
3988 if (!may_write_registers)
3989 error (_("Writing to registers is not allowed (regno %d)"), regno);
3991 for (t = current_target.beneath; t != NULL; t = t->beneath)
3993 if (t->to_store_registers != NULL)
3995 t->to_store_registers (t, regcache, regno);
3998 debug_print_register ("target_store_registers", regcache, regno);
4008 target_core_of_thread (ptid_t ptid)
4010 struct target_ops *t;
4012 for (t = current_target.beneath; t != NULL; t = t->beneath)
4014 if (t->to_core_of_thread != NULL)
4016 int retval = t->to_core_of_thread (t, ptid);
4019 fprintf_unfiltered (gdb_stdlog,
4020 "target_core_of_thread (%d) = %d\n",
4021 ptid_get_pid (ptid), retval);
4030 target_verify_memory (const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
4032 struct target_ops *t;
4034 for (t = current_target.beneath; t != NULL; t = t->beneath)
4036 if (t->to_verify_memory != NULL)
4038 int retval = t->to_verify_memory (t, data, memaddr, size);
4041 fprintf_unfiltered (gdb_stdlog,
4042 "target_verify_memory (%s, %s) = %d\n",
4043 paddress (target_gdbarch (), memaddr),
4053 /* The documentation for this function is in its prototype declaration in
4057 target_insert_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
4059 struct target_ops *t;
4061 for (t = current_target.beneath; t != NULL; t = t->beneath)
4062 if (t->to_insert_mask_watchpoint != NULL)
4066 ret = t->to_insert_mask_watchpoint (t, addr, mask, rw);
4069 fprintf_unfiltered (gdb_stdlog, "\
4070 target_insert_mask_watchpoint (%s, %s, %d) = %d\n",
4071 core_addr_to_string (addr),
4072 core_addr_to_string (mask), rw, ret);
4080 /* The documentation for this function is in its prototype declaration in
4084 target_remove_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
4086 struct target_ops *t;
4088 for (t = current_target.beneath; t != NULL; t = t->beneath)
4089 if (t->to_remove_mask_watchpoint != NULL)
4093 ret = t->to_remove_mask_watchpoint (t, addr, mask, rw);
4096 fprintf_unfiltered (gdb_stdlog, "\
4097 target_remove_mask_watchpoint (%s, %s, %d) = %d\n",
4098 core_addr_to_string (addr),
4099 core_addr_to_string (mask), rw, ret);
4107 /* The documentation for this function is in its prototype declaration
4111 target_masked_watch_num_registers (CORE_ADDR addr, CORE_ADDR mask)
4113 struct target_ops *t;
4115 for (t = current_target.beneath; t != NULL; t = t->beneath)
4116 if (t->to_masked_watch_num_registers != NULL)
4117 return t->to_masked_watch_num_registers (t, addr, mask);
4122 /* The documentation for this function is in its prototype declaration
4126 target_ranged_break_num_registers (void)
4128 struct target_ops *t;
4130 for (t = current_target.beneath; t != NULL; t = t->beneath)
4131 if (t->to_ranged_break_num_registers != NULL)
4132 return t->to_ranged_break_num_registers (t);
4140 target_supports_btrace (void)
4142 struct target_ops *t;
4144 for (t = current_target.beneath; t != NULL; t = t->beneath)
4145 if (t->to_supports_btrace != NULL)
4146 return t->to_supports_btrace ();
4153 struct btrace_target_info *
4154 target_enable_btrace (ptid_t ptid)
4156 struct target_ops *t;
4158 for (t = current_target.beneath; t != NULL; t = t->beneath)
4159 if (t->to_enable_btrace != NULL)
4160 return t->to_enable_btrace (ptid);
4169 target_disable_btrace (struct btrace_target_info *btinfo)
4171 struct target_ops *t;
4173 for (t = current_target.beneath; t != NULL; t = t->beneath)
4174 if (t->to_disable_btrace != NULL)
4176 t->to_disable_btrace (btinfo);
4186 target_teardown_btrace (struct btrace_target_info *btinfo)
4188 struct target_ops *t;
4190 for (t = current_target.beneath; t != NULL; t = t->beneath)
4191 if (t->to_teardown_btrace != NULL)
4193 t->to_teardown_btrace (btinfo);
4202 VEC (btrace_block_s) *
4203 target_read_btrace (struct btrace_target_info *btinfo,
4204 enum btrace_read_type type)
4206 struct target_ops *t;
4208 for (t = current_target.beneath; t != NULL; t = t->beneath)
4209 if (t->to_read_btrace != NULL)
4210 return t->to_read_btrace (btinfo, type);
4219 target_stop_recording (void)
4221 struct target_ops *t;
4223 for (t = current_target.beneath; t != NULL; t = t->beneath)
4224 if (t->to_stop_recording != NULL)
4226 t->to_stop_recording ();
4230 /* This is optional. */
4236 target_info_record (void)
4238 struct target_ops *t;
4240 for (t = current_target.beneath; t != NULL; t = t->beneath)
4241 if (t->to_info_record != NULL)
4243 t->to_info_record ();
4253 target_save_record (const char *filename)
4255 struct target_ops *t;
4257 for (t = current_target.beneath; t != NULL; t = t->beneath)
4258 if (t->to_save_record != NULL)
4260 t->to_save_record (filename);
4270 target_supports_delete_record (void)
4272 struct target_ops *t;
4274 for (t = current_target.beneath; t != NULL; t = t->beneath)
4275 if (t->to_delete_record != NULL)
4284 target_delete_record (void)
4286 struct target_ops *t;
4288 for (t = current_target.beneath; t != NULL; t = t->beneath)
4289 if (t->to_delete_record != NULL)
4291 t->to_delete_record ();
4301 target_record_is_replaying (void)
4303 struct target_ops *t;
4305 for (t = current_target.beneath; t != NULL; t = t->beneath)
4306 if (t->to_record_is_replaying != NULL)
4307 return t->to_record_is_replaying ();
4315 target_goto_record_begin (void)
4317 struct target_ops *t;
4319 for (t = current_target.beneath; t != NULL; t = t->beneath)
4320 if (t->to_goto_record_begin != NULL)
4322 t->to_goto_record_begin ();
4332 target_goto_record_end (void)
4334 struct target_ops *t;
4336 for (t = current_target.beneath; t != NULL; t = t->beneath)
4337 if (t->to_goto_record_end != NULL)
4339 t->to_goto_record_end ();
4349 target_goto_record (ULONGEST insn)
4351 struct target_ops *t;
4353 for (t = current_target.beneath; t != NULL; t = t->beneath)
4354 if (t->to_goto_record != NULL)
4356 t->to_goto_record (insn);
4366 target_insn_history (int size, int flags)
4368 struct target_ops *t;
4370 for (t = current_target.beneath; t != NULL; t = t->beneath)
4371 if (t->to_insn_history != NULL)
4373 t->to_insn_history (size, flags);
4383 target_insn_history_from (ULONGEST from, int size, int flags)
4385 struct target_ops *t;
4387 for (t = current_target.beneath; t != NULL; t = t->beneath)
4388 if (t->to_insn_history_from != NULL)
4390 t->to_insn_history_from (from, size, flags);
4400 target_insn_history_range (ULONGEST begin, ULONGEST end, int flags)
4402 struct target_ops *t;
4404 for (t = current_target.beneath; t != NULL; t = t->beneath)
4405 if (t->to_insn_history_range != NULL)
4407 t->to_insn_history_range (begin, end, flags);
4417 target_call_history (int size, int flags)
4419 struct target_ops *t;
4421 for (t = current_target.beneath; t != NULL; t = t->beneath)
4422 if (t->to_call_history != NULL)
4424 t->to_call_history (size, flags);
4434 target_call_history_from (ULONGEST begin, int size, int flags)
4436 struct target_ops *t;
4438 for (t = current_target.beneath; t != NULL; t = t->beneath)
4439 if (t->to_call_history_from != NULL)
4441 t->to_call_history_from (begin, size, flags);
4451 target_call_history_range (ULONGEST begin, ULONGEST end, int flags)
4453 struct target_ops *t;
4455 for (t = current_target.beneath; t != NULL; t = t->beneath)
4456 if (t->to_call_history_range != NULL)
4458 t->to_call_history_range (begin, end, flags);
4466 debug_to_prepare_to_store (struct regcache *regcache)
4468 debug_target.to_prepare_to_store (regcache);
4470 fprintf_unfiltered (gdb_stdlog, "target_prepare_to_store ()\n");
4474 deprecated_debug_xfer_memory (CORE_ADDR memaddr, bfd_byte *myaddr, int len,
4475 int write, struct mem_attrib *attrib,
4476 struct target_ops *target)
4480 retval = debug_target.deprecated_xfer_memory (memaddr, myaddr, len, write,
4483 fprintf_unfiltered (gdb_stdlog,
4484 "target_xfer_memory (%s, xxx, %d, %s, xxx) = %d",
4485 paddress (target_gdbarch (), memaddr), len,
4486 write ? "write" : "read", retval);
4492 fputs_unfiltered (", bytes =", gdb_stdlog);
4493 for (i = 0; i < retval; i++)
4495 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
4497 if (targetdebug < 2 && i > 0)
4499 fprintf_unfiltered (gdb_stdlog, " ...");
4502 fprintf_unfiltered (gdb_stdlog, "\n");
4505 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
4509 fputc_unfiltered ('\n', gdb_stdlog);
4515 debug_to_files_info (struct target_ops *target)
4517 debug_target.to_files_info (target);
4519 fprintf_unfiltered (gdb_stdlog, "target_files_info (xxx)\n");
4523 debug_to_insert_breakpoint (struct gdbarch *gdbarch,
4524 struct bp_target_info *bp_tgt)
4528 retval = debug_target.to_insert_breakpoint (gdbarch, bp_tgt);
4530 fprintf_unfiltered (gdb_stdlog,
4531 "target_insert_breakpoint (%s, xxx) = %ld\n",
4532 core_addr_to_string (bp_tgt->placed_address),
4533 (unsigned long) retval);
4538 debug_to_remove_breakpoint (struct gdbarch *gdbarch,
4539 struct bp_target_info *bp_tgt)
4543 retval = debug_target.to_remove_breakpoint (gdbarch, bp_tgt);
4545 fprintf_unfiltered (gdb_stdlog,
4546 "target_remove_breakpoint (%s, xxx) = %ld\n",
4547 core_addr_to_string (bp_tgt->placed_address),
4548 (unsigned long) retval);
4553 debug_to_can_use_hw_breakpoint (int type, int cnt, int from_tty)
4557 retval = debug_target.to_can_use_hw_breakpoint (type, cnt, from_tty);
4559 fprintf_unfiltered (gdb_stdlog,
4560 "target_can_use_hw_breakpoint (%ld, %ld, %ld) = %ld\n",
4561 (unsigned long) type,
4562 (unsigned long) cnt,
4563 (unsigned long) from_tty,
4564 (unsigned long) retval);
4569 debug_to_region_ok_for_hw_watchpoint (CORE_ADDR addr, int len)
4573 retval = debug_target.to_region_ok_for_hw_watchpoint (addr, len);
4575 fprintf_unfiltered (gdb_stdlog,
4576 "target_region_ok_for_hw_watchpoint (%s, %ld) = %s\n",
4577 core_addr_to_string (addr), (unsigned long) len,
4578 core_addr_to_string (retval));
4583 debug_to_can_accel_watchpoint_condition (CORE_ADDR addr, int len, int rw,
4584 struct expression *cond)
4588 retval = debug_target.to_can_accel_watchpoint_condition (addr, len,
4591 fprintf_unfiltered (gdb_stdlog,
4592 "target_can_accel_watchpoint_condition "
4593 "(%s, %d, %d, %s) = %ld\n",
4594 core_addr_to_string (addr), len, rw,
4595 host_address_to_string (cond), (unsigned long) retval);
4600 debug_to_stopped_by_watchpoint (void)
4604 retval = debug_target.to_stopped_by_watchpoint ();
4606 fprintf_unfiltered (gdb_stdlog,
4607 "target_stopped_by_watchpoint () = %ld\n",
4608 (unsigned long) retval);
4613 debug_to_stopped_data_address (struct target_ops *target, CORE_ADDR *addr)
4617 retval = debug_target.to_stopped_data_address (target, addr);
4619 fprintf_unfiltered (gdb_stdlog,
4620 "target_stopped_data_address ([%s]) = %ld\n",
4621 core_addr_to_string (*addr),
4622 (unsigned long)retval);
4627 debug_to_watchpoint_addr_within_range (struct target_ops *target,
4629 CORE_ADDR start, int length)
4633 retval = debug_target.to_watchpoint_addr_within_range (target, addr,
4636 fprintf_filtered (gdb_stdlog,
4637 "target_watchpoint_addr_within_range (%s, %s, %d) = %d\n",
4638 core_addr_to_string (addr), core_addr_to_string (start),
4644 debug_to_insert_hw_breakpoint (struct gdbarch *gdbarch,
4645 struct bp_target_info *bp_tgt)
4649 retval = debug_target.to_insert_hw_breakpoint (gdbarch, bp_tgt);
4651 fprintf_unfiltered (gdb_stdlog,
4652 "target_insert_hw_breakpoint (%s, xxx) = %ld\n",
4653 core_addr_to_string (bp_tgt->placed_address),
4654 (unsigned long) retval);
4659 debug_to_remove_hw_breakpoint (struct gdbarch *gdbarch,
4660 struct bp_target_info *bp_tgt)
4664 retval = debug_target.to_remove_hw_breakpoint (gdbarch, bp_tgt);
4666 fprintf_unfiltered (gdb_stdlog,
4667 "target_remove_hw_breakpoint (%s, xxx) = %ld\n",
4668 core_addr_to_string (bp_tgt->placed_address),
4669 (unsigned long) retval);
4674 debug_to_insert_watchpoint (CORE_ADDR addr, int len, int type,
4675 struct expression *cond)
4679 retval = debug_target.to_insert_watchpoint (addr, len, type, cond);
4681 fprintf_unfiltered (gdb_stdlog,
4682 "target_insert_watchpoint (%s, %d, %d, %s) = %ld\n",
4683 core_addr_to_string (addr), len, type,
4684 host_address_to_string (cond), (unsigned long) retval);
4689 debug_to_remove_watchpoint (CORE_ADDR addr, int len, int type,
4690 struct expression *cond)
4694 retval = debug_target.to_remove_watchpoint (addr, len, type, cond);
4696 fprintf_unfiltered (gdb_stdlog,
4697 "target_remove_watchpoint (%s, %d, %d, %s) = %ld\n",
4698 core_addr_to_string (addr), len, type,
4699 host_address_to_string (cond), (unsigned long) retval);
4704 debug_to_terminal_init (void)
4706 debug_target.to_terminal_init ();
4708 fprintf_unfiltered (gdb_stdlog, "target_terminal_init ()\n");
4712 debug_to_terminal_inferior (void)
4714 debug_target.to_terminal_inferior ();
4716 fprintf_unfiltered (gdb_stdlog, "target_terminal_inferior ()\n");
4720 debug_to_terminal_ours_for_output (void)
4722 debug_target.to_terminal_ours_for_output ();
4724 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours_for_output ()\n");
4728 debug_to_terminal_ours (void)
4730 debug_target.to_terminal_ours ();
4732 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours ()\n");
4736 debug_to_terminal_save_ours (void)
4738 debug_target.to_terminal_save_ours ();
4740 fprintf_unfiltered (gdb_stdlog, "target_terminal_save_ours ()\n");
4744 debug_to_terminal_info (const char *arg, int from_tty)
4746 debug_target.to_terminal_info (arg, from_tty);
4748 fprintf_unfiltered (gdb_stdlog, "target_terminal_info (%s, %d)\n", arg,
4753 debug_to_load (char *args, int from_tty)
4755 debug_target.to_load (args, from_tty);
4757 fprintf_unfiltered (gdb_stdlog, "target_load (%s, %d)\n", args, from_tty);
4761 debug_to_post_startup_inferior (ptid_t ptid)
4763 debug_target.to_post_startup_inferior (ptid);
4765 fprintf_unfiltered (gdb_stdlog, "target_post_startup_inferior (%d)\n",
4766 ptid_get_pid (ptid));
4770 debug_to_insert_fork_catchpoint (int pid)
4774 retval = debug_target.to_insert_fork_catchpoint (pid);
4776 fprintf_unfiltered (gdb_stdlog, "target_insert_fork_catchpoint (%d) = %d\n",
4783 debug_to_remove_fork_catchpoint (int pid)
4787 retval = debug_target.to_remove_fork_catchpoint (pid);
4789 fprintf_unfiltered (gdb_stdlog, "target_remove_fork_catchpoint (%d) = %d\n",
4796 debug_to_insert_vfork_catchpoint (int pid)
4800 retval = debug_target.to_insert_vfork_catchpoint (pid);
4802 fprintf_unfiltered (gdb_stdlog, "target_insert_vfork_catchpoint (%d) = %d\n",
4809 debug_to_remove_vfork_catchpoint (int pid)
4813 retval = debug_target.to_remove_vfork_catchpoint (pid);
4815 fprintf_unfiltered (gdb_stdlog, "target_remove_vfork_catchpoint (%d) = %d\n",
4822 debug_to_insert_exec_catchpoint (int pid)
4826 retval = debug_target.to_insert_exec_catchpoint (pid);
4828 fprintf_unfiltered (gdb_stdlog, "target_insert_exec_catchpoint (%d) = %d\n",
4835 debug_to_remove_exec_catchpoint (int pid)
4839 retval = debug_target.to_remove_exec_catchpoint (pid);
4841 fprintf_unfiltered (gdb_stdlog, "target_remove_exec_catchpoint (%d) = %d\n",
4848 debug_to_has_exited (int pid, int wait_status, int *exit_status)
4852 has_exited = debug_target.to_has_exited (pid, wait_status, exit_status);
4854 fprintf_unfiltered (gdb_stdlog, "target_has_exited (%d, %d, %d) = %d\n",
4855 pid, wait_status, *exit_status, has_exited);
4861 debug_to_can_run (void)
4865 retval = debug_target.to_can_run ();
4867 fprintf_unfiltered (gdb_stdlog, "target_can_run () = %d\n", retval);
4872 static struct gdbarch *
4873 debug_to_thread_architecture (struct target_ops *ops, ptid_t ptid)
4875 struct gdbarch *retval;
4877 retval = debug_target.to_thread_architecture (ops, ptid);
4879 fprintf_unfiltered (gdb_stdlog,
4880 "target_thread_architecture (%s) = %s [%s]\n",
4881 target_pid_to_str (ptid),
4882 host_address_to_string (retval),
4883 gdbarch_bfd_arch_info (retval)->printable_name);
4888 debug_to_stop (ptid_t ptid)
4890 debug_target.to_stop (ptid);
4892 fprintf_unfiltered (gdb_stdlog, "target_stop (%s)\n",
4893 target_pid_to_str (ptid));
4897 debug_to_rcmd (char *command,
4898 struct ui_file *outbuf)
4900 debug_target.to_rcmd (command, outbuf);
4901 fprintf_unfiltered (gdb_stdlog, "target_rcmd (%s, ...)\n", command);
4905 debug_to_pid_to_exec_file (int pid)
4909 exec_file = debug_target.to_pid_to_exec_file (pid);
4911 fprintf_unfiltered (gdb_stdlog, "target_pid_to_exec_file (%d) = %s\n",
4918 setup_target_debug (void)
4920 memcpy (&debug_target, ¤t_target, sizeof debug_target);
4922 current_target.to_open = debug_to_open;
4923 current_target.to_post_attach = debug_to_post_attach;
4924 current_target.to_prepare_to_store = debug_to_prepare_to_store;
4925 current_target.deprecated_xfer_memory = deprecated_debug_xfer_memory;
4926 current_target.to_files_info = debug_to_files_info;
4927 current_target.to_insert_breakpoint = debug_to_insert_breakpoint;
4928 current_target.to_remove_breakpoint = debug_to_remove_breakpoint;
4929 current_target.to_can_use_hw_breakpoint = debug_to_can_use_hw_breakpoint;
4930 current_target.to_insert_hw_breakpoint = debug_to_insert_hw_breakpoint;
4931 current_target.to_remove_hw_breakpoint = debug_to_remove_hw_breakpoint;
4932 current_target.to_insert_watchpoint = debug_to_insert_watchpoint;
4933 current_target.to_remove_watchpoint = debug_to_remove_watchpoint;
4934 current_target.to_stopped_by_watchpoint = debug_to_stopped_by_watchpoint;
4935 current_target.to_stopped_data_address = debug_to_stopped_data_address;
4936 current_target.to_watchpoint_addr_within_range
4937 = debug_to_watchpoint_addr_within_range;
4938 current_target.to_region_ok_for_hw_watchpoint
4939 = debug_to_region_ok_for_hw_watchpoint;
4940 current_target.to_can_accel_watchpoint_condition
4941 = debug_to_can_accel_watchpoint_condition;
4942 current_target.to_terminal_init = debug_to_terminal_init;
4943 current_target.to_terminal_inferior = debug_to_terminal_inferior;
4944 current_target.to_terminal_ours_for_output
4945 = debug_to_terminal_ours_for_output;
4946 current_target.to_terminal_ours = debug_to_terminal_ours;
4947 current_target.to_terminal_save_ours = debug_to_terminal_save_ours;
4948 current_target.to_terminal_info = debug_to_terminal_info;
4949 current_target.to_load = debug_to_load;
4950 current_target.to_post_startup_inferior = debug_to_post_startup_inferior;
4951 current_target.to_insert_fork_catchpoint = debug_to_insert_fork_catchpoint;
4952 current_target.to_remove_fork_catchpoint = debug_to_remove_fork_catchpoint;
4953 current_target.to_insert_vfork_catchpoint = debug_to_insert_vfork_catchpoint;
4954 current_target.to_remove_vfork_catchpoint = debug_to_remove_vfork_catchpoint;
4955 current_target.to_insert_exec_catchpoint = debug_to_insert_exec_catchpoint;
4956 current_target.to_remove_exec_catchpoint = debug_to_remove_exec_catchpoint;
4957 current_target.to_has_exited = debug_to_has_exited;
4958 current_target.to_can_run = debug_to_can_run;
4959 current_target.to_stop = debug_to_stop;
4960 current_target.to_rcmd = debug_to_rcmd;
4961 current_target.to_pid_to_exec_file = debug_to_pid_to_exec_file;
4962 current_target.to_thread_architecture = debug_to_thread_architecture;
4966 static char targ_desc[] =
4967 "Names of targets and files being debugged.\nShows the entire \
4968 stack of targets currently in use (including the exec-file,\n\
4969 core-file, and process, if any), as well as the symbol file name.";
4972 do_monitor_command (char *cmd,
4975 if ((current_target.to_rcmd
4976 == (void (*) (char *, struct ui_file *)) tcomplain)
4977 || (current_target.to_rcmd == debug_to_rcmd
4978 && (debug_target.to_rcmd
4979 == (void (*) (char *, struct ui_file *)) tcomplain)))
4980 error (_("\"monitor\" command not supported by this target."));
4981 target_rcmd (cmd, gdb_stdtarg);
4984 /* Print the name of each layers of our target stack. */
4987 maintenance_print_target_stack (char *cmd, int from_tty)
4989 struct target_ops *t;
4991 printf_filtered (_("The current target stack is:\n"));
4993 for (t = target_stack; t != NULL; t = t->beneath)
4995 printf_filtered (" - %s (%s)\n", t->to_shortname, t->to_longname);
4999 /* Controls if async mode is permitted. */
5000 int target_async_permitted = 0;
5002 /* The set command writes to this variable. If the inferior is
5003 executing, target_async_permitted is *not* updated. */
5004 static int target_async_permitted_1 = 0;
5007 set_target_async_command (char *args, int from_tty,
5008 struct cmd_list_element *c)
5010 if (have_live_inferiors ())
5012 target_async_permitted_1 = target_async_permitted;
5013 error (_("Cannot change this setting while the inferior is running."));
5016 target_async_permitted = target_async_permitted_1;
5020 show_target_async_command (struct ui_file *file, int from_tty,
5021 struct cmd_list_element *c,
5024 fprintf_filtered (file,
5025 _("Controlling the inferior in "
5026 "asynchronous mode is %s.\n"), value);
5029 /* Temporary copies of permission settings. */
5031 static int may_write_registers_1 = 1;
5032 static int may_write_memory_1 = 1;
5033 static int may_insert_breakpoints_1 = 1;
5034 static int may_insert_tracepoints_1 = 1;
5035 static int may_insert_fast_tracepoints_1 = 1;
5036 static int may_stop_1 = 1;
5038 /* Make the user-set values match the real values again. */
5041 update_target_permissions (void)
5043 may_write_registers_1 = may_write_registers;
5044 may_write_memory_1 = may_write_memory;
5045 may_insert_breakpoints_1 = may_insert_breakpoints;
5046 may_insert_tracepoints_1 = may_insert_tracepoints;
5047 may_insert_fast_tracepoints_1 = may_insert_fast_tracepoints;
5048 may_stop_1 = may_stop;
5051 /* The one function handles (most of) the permission flags in the same
5055 set_target_permissions (char *args, int from_tty,
5056 struct cmd_list_element *c)
5058 if (target_has_execution)
5060 update_target_permissions ();
5061 error (_("Cannot change this setting while the inferior is running."));
5064 /* Make the real values match the user-changed values. */
5065 may_write_registers = may_write_registers_1;
5066 may_insert_breakpoints = may_insert_breakpoints_1;
5067 may_insert_tracepoints = may_insert_tracepoints_1;
5068 may_insert_fast_tracepoints = may_insert_fast_tracepoints_1;
5069 may_stop = may_stop_1;
5070 update_observer_mode ();
5073 /* Set memory write permission independently of observer mode. */
5076 set_write_memory_permission (char *args, int from_tty,
5077 struct cmd_list_element *c)
5079 /* Make the real values match the user-changed values. */
5080 may_write_memory = may_write_memory_1;
5081 update_observer_mode ();
5086 initialize_targets (void)
5088 init_dummy_target ();
5089 push_target (&dummy_target);
5091 add_info ("target", target_info, targ_desc);
5092 add_info ("files", target_info, targ_desc);
5094 add_setshow_zuinteger_cmd ("target", class_maintenance, &targetdebug, _("\
5095 Set target debugging."), _("\
5096 Show target debugging."), _("\
5097 When non-zero, target debugging is enabled. Higher numbers are more\n\
5098 verbose. Changes do not take effect until the next \"run\" or \"target\"\n\
5102 &setdebuglist, &showdebuglist);
5104 add_setshow_boolean_cmd ("trust-readonly-sections", class_support,
5105 &trust_readonly, _("\
5106 Set mode for reading from readonly sections."), _("\
5107 Show mode for reading from readonly sections."), _("\
5108 When this mode is on, memory reads from readonly sections (such as .text)\n\
5109 will be read from the object file instead of from the target. This will\n\
5110 result in significant performance improvement for remote targets."),
5112 show_trust_readonly,
5113 &setlist, &showlist);
5115 add_com ("monitor", class_obscure, do_monitor_command,
5116 _("Send a command to the remote monitor (remote targets only)."));
5118 add_cmd ("target-stack", class_maintenance, maintenance_print_target_stack,
5119 _("Print the name of each layer of the internal target stack."),
5120 &maintenanceprintlist);
5122 add_setshow_boolean_cmd ("target-async", no_class,
5123 &target_async_permitted_1, _("\
5124 Set whether gdb controls the inferior in asynchronous mode."), _("\
5125 Show whether gdb controls the inferior in asynchronous mode."), _("\
5126 Tells gdb whether to control the inferior in asynchronous mode."),
5127 set_target_async_command,
5128 show_target_async_command,
5132 add_setshow_boolean_cmd ("stack-cache", class_support,
5133 &stack_cache_enabled_p_1, _("\
5134 Set cache use for stack access."), _("\
5135 Show cache use for stack access."), _("\
5136 When on, use the data cache for all stack access, regardless of any\n\
5137 configured memory regions. This improves remote performance significantly.\n\
5138 By default, caching for stack access is on."),
5139 set_stack_cache_enabled_p,
5140 show_stack_cache_enabled_p,
5141 &setlist, &showlist);
5143 add_setshow_boolean_cmd ("may-write-registers", class_support,
5144 &may_write_registers_1, _("\
5145 Set permission to write into registers."), _("\
5146 Show permission to write into registers."), _("\
5147 When this permission is on, GDB may write into the target's registers.\n\
5148 Otherwise, any sort of write attempt will result in an error."),
5149 set_target_permissions, NULL,
5150 &setlist, &showlist);
5152 add_setshow_boolean_cmd ("may-write-memory", class_support,
5153 &may_write_memory_1, _("\
5154 Set permission to write into target memory."), _("\
5155 Show permission to write into target memory."), _("\
5156 When this permission is on, GDB may write into the target's memory.\n\
5157 Otherwise, any sort of write attempt will result in an error."),
5158 set_write_memory_permission, NULL,
5159 &setlist, &showlist);
5161 add_setshow_boolean_cmd ("may-insert-breakpoints", class_support,
5162 &may_insert_breakpoints_1, _("\
5163 Set permission to insert breakpoints in the target."), _("\
5164 Show permission to insert breakpoints in the target."), _("\
5165 When this permission is on, GDB may insert breakpoints in the program.\n\
5166 Otherwise, any sort of insertion attempt will result in an error."),
5167 set_target_permissions, NULL,
5168 &setlist, &showlist);
5170 add_setshow_boolean_cmd ("may-insert-tracepoints", class_support,
5171 &may_insert_tracepoints_1, _("\
5172 Set permission to insert tracepoints in the target."), _("\
5173 Show permission to insert tracepoints in the target."), _("\
5174 When this permission is on, GDB may insert tracepoints in the program.\n\
5175 Otherwise, any sort of insertion attempt will result in an error."),
5176 set_target_permissions, NULL,
5177 &setlist, &showlist);
5179 add_setshow_boolean_cmd ("may-insert-fast-tracepoints", class_support,
5180 &may_insert_fast_tracepoints_1, _("\
5181 Set permission to insert fast tracepoints in the target."), _("\
5182 Show permission to insert fast tracepoints in the target."), _("\
5183 When this permission is on, GDB may insert fast tracepoints.\n\
5184 Otherwise, any sort of insertion attempt will result in an error."),
5185 set_target_permissions, NULL,
5186 &setlist, &showlist);
5188 add_setshow_boolean_cmd ("may-interrupt", class_support,
5190 Set permission to interrupt or signal the target."), _("\
5191 Show permission to interrupt or signal the target."), _("\
5192 When this permission is on, GDB may interrupt/stop the target's execution.\n\
5193 Otherwise, any attempt to interrupt or stop will be ignored."),
5194 set_target_permissions, NULL,
5195 &setlist, &showlist);
5198 target_dcache = dcache_init ();