1 /* Select target systems and architectures at runtime for GDB.
3 Copyright (C) 1990-2014 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/>. */
26 #include "target-dcache.h"
36 #include "gdb_assert.h"
38 #include "exceptions.h"
39 #include "target-descriptions.h"
40 #include "gdbthread.h"
43 #include "inline-frame.h"
44 #include "tracepoint.h"
45 #include "gdb/fileio.h"
48 static void target_info (char *, int);
50 static void default_terminal_info (struct target_ops *, const char *, int);
52 static int default_watchpoint_addr_within_range (struct target_ops *,
53 CORE_ADDR, CORE_ADDR, int);
55 static int default_region_ok_for_hw_watchpoint (struct target_ops *,
58 static void tcomplain (void) ATTRIBUTE_NORETURN;
60 static int nomemory (CORE_ADDR, char *, int, int, struct target_ops *);
62 static int return_zero (void);
64 static int return_one (void);
66 static int return_minus_one (void);
68 static void *return_null (void);
70 void target_ignore (void);
72 static void target_command (char *, int);
74 static struct target_ops *find_default_run_target (char *);
76 static target_xfer_partial_ftype default_xfer_partial;
78 static struct gdbarch *default_thread_architecture (struct target_ops *ops,
81 static int find_default_can_async_p (struct target_ops *ignore);
83 static int find_default_is_async_p (struct target_ops *ignore);
85 #include "target-delegates.c"
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 target_ops *self,
96 static void debug_to_files_info (struct target_ops *);
98 static int debug_to_insert_breakpoint (struct target_ops *, struct gdbarch *,
99 struct bp_target_info *);
101 static int debug_to_remove_breakpoint (struct target_ops *, struct gdbarch *,
102 struct bp_target_info *);
104 static int debug_to_can_use_hw_breakpoint (struct target_ops *self,
107 static int debug_to_insert_hw_breakpoint (struct target_ops *self,
109 struct bp_target_info *);
111 static int debug_to_remove_hw_breakpoint (struct target_ops *self,
113 struct bp_target_info *);
115 static int debug_to_insert_watchpoint (struct target_ops *self,
117 struct expression *);
119 static int debug_to_remove_watchpoint (struct target_ops *self,
121 struct expression *);
123 static int debug_to_stopped_data_address (struct target_ops *, CORE_ADDR *);
125 static int debug_to_watchpoint_addr_within_range (struct target_ops *,
126 CORE_ADDR, CORE_ADDR, int);
128 static int debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
131 static int debug_to_can_accel_watchpoint_condition (struct target_ops *self,
133 struct expression *);
135 static void debug_to_terminal_init (struct target_ops *self);
137 static void debug_to_terminal_inferior (struct target_ops *self);
139 static void debug_to_terminal_ours_for_output (struct target_ops *self);
141 static void debug_to_terminal_save_ours (struct target_ops *self);
143 static void debug_to_terminal_ours (struct target_ops *self);
145 static void debug_to_load (struct target_ops *self, char *, int);
147 static int debug_to_can_run (struct target_ops *self);
149 static void debug_to_stop (struct target_ops *self, ptid_t);
151 /* Pointer to array of target architecture structures; the size of the
152 array; the current index into the array; the allocated size of the
154 struct target_ops **target_structs;
155 unsigned target_struct_size;
156 unsigned target_struct_allocsize;
157 #define DEFAULT_ALLOCSIZE 10
159 /* The initial current target, so that there is always a semi-valid
162 static struct target_ops dummy_target;
164 /* Top of target stack. */
166 static struct target_ops *target_stack;
168 /* The target structure we are currently using to talk to a process
169 or file or whatever "inferior" we have. */
171 struct target_ops current_target;
173 /* Command list for target. */
175 static struct cmd_list_element *targetlist = NULL;
177 /* Nonzero if we should trust readonly sections from the
178 executable when reading memory. */
180 static int trust_readonly = 0;
182 /* Nonzero if we should show true memory content including
183 memory breakpoint inserted by gdb. */
185 static int show_memory_breakpoints = 0;
187 /* These globals control whether GDB attempts to perform these
188 operations; they are useful for targets that need to prevent
189 inadvertant disruption, such as in non-stop mode. */
191 int may_write_registers = 1;
193 int may_write_memory = 1;
195 int may_insert_breakpoints = 1;
197 int may_insert_tracepoints = 1;
199 int may_insert_fast_tracepoints = 1;
203 /* Non-zero if we want to see trace of target level stuff. */
205 static unsigned int targetdebug = 0;
207 show_targetdebug (struct ui_file *file, int from_tty,
208 struct cmd_list_element *c, const char *value)
210 fprintf_filtered (file, _("Target debugging is %s.\n"), value);
213 static void setup_target_debug (void);
215 /* The user just typed 'target' without the name of a target. */
218 target_command (char *arg, int from_tty)
220 fputs_filtered ("Argument required (target name). Try `help target'\n",
224 /* Default target_has_* methods for process_stratum targets. */
227 default_child_has_all_memory (struct target_ops *ops)
229 /* If no inferior selected, then we can't read memory here. */
230 if (ptid_equal (inferior_ptid, null_ptid))
237 default_child_has_memory (struct target_ops *ops)
239 /* If no inferior selected, then we can't read memory here. */
240 if (ptid_equal (inferior_ptid, null_ptid))
247 default_child_has_stack (struct target_ops *ops)
249 /* If no inferior selected, there's no stack. */
250 if (ptid_equal (inferior_ptid, null_ptid))
257 default_child_has_registers (struct target_ops *ops)
259 /* Can't read registers from no inferior. */
260 if (ptid_equal (inferior_ptid, null_ptid))
267 default_child_has_execution (struct target_ops *ops, ptid_t the_ptid)
269 /* If there's no thread selected, then we can't make it run through
271 if (ptid_equal (the_ptid, null_ptid))
279 target_has_all_memory_1 (void)
281 struct target_ops *t;
283 for (t = current_target.beneath; t != NULL; t = t->beneath)
284 if (t->to_has_all_memory (t))
291 target_has_memory_1 (void)
293 struct target_ops *t;
295 for (t = current_target.beneath; t != NULL; t = t->beneath)
296 if (t->to_has_memory (t))
303 target_has_stack_1 (void)
305 struct target_ops *t;
307 for (t = current_target.beneath; t != NULL; t = t->beneath)
308 if (t->to_has_stack (t))
315 target_has_registers_1 (void)
317 struct target_ops *t;
319 for (t = current_target.beneath; t != NULL; t = t->beneath)
320 if (t->to_has_registers (t))
327 target_has_execution_1 (ptid_t the_ptid)
329 struct target_ops *t;
331 for (t = current_target.beneath; t != NULL; t = t->beneath)
332 if (t->to_has_execution (t, the_ptid))
339 target_has_execution_current (void)
341 return target_has_execution_1 (inferior_ptid);
344 /* Complete initialization of T. This ensures that various fields in
345 T are set, if needed by the target implementation. */
348 complete_target_initialization (struct target_ops *t)
350 /* Provide default values for all "must have" methods. */
351 if (t->to_xfer_partial == NULL)
352 t->to_xfer_partial = default_xfer_partial;
354 if (t->to_has_all_memory == NULL)
355 t->to_has_all_memory = (int (*) (struct target_ops *)) return_zero;
357 if (t->to_has_memory == NULL)
358 t->to_has_memory = (int (*) (struct target_ops *)) return_zero;
360 if (t->to_has_stack == NULL)
361 t->to_has_stack = (int (*) (struct target_ops *)) return_zero;
363 if (t->to_has_registers == NULL)
364 t->to_has_registers = (int (*) (struct target_ops *)) return_zero;
366 if (t->to_has_execution == NULL)
367 t->to_has_execution = (int (*) (struct target_ops *, ptid_t)) return_zero;
369 install_delegators (t);
372 /* Add possible target architecture T to the list and add a new
373 command 'target T->to_shortname'. Set COMPLETER as the command's
374 completer if not NULL. */
377 add_target_with_completer (struct target_ops *t,
378 completer_ftype *completer)
380 struct cmd_list_element *c;
382 complete_target_initialization (t);
386 target_struct_allocsize = DEFAULT_ALLOCSIZE;
387 target_structs = (struct target_ops **) xmalloc
388 (target_struct_allocsize * sizeof (*target_structs));
390 if (target_struct_size >= target_struct_allocsize)
392 target_struct_allocsize *= 2;
393 target_structs = (struct target_ops **)
394 xrealloc ((char *) target_structs,
395 target_struct_allocsize * sizeof (*target_structs));
397 target_structs[target_struct_size++] = t;
399 if (targetlist == NULL)
400 add_prefix_cmd ("target", class_run, target_command, _("\
401 Connect to a target machine or process.\n\
402 The first argument is the type or protocol of the target machine.\n\
403 Remaining arguments are interpreted by the target protocol. For more\n\
404 information on the arguments for a particular protocol, type\n\
405 `help target ' followed by the protocol name."),
406 &targetlist, "target ", 0, &cmdlist);
407 c = add_cmd (t->to_shortname, no_class, t->to_open, t->to_doc,
409 if (completer != NULL)
410 set_cmd_completer (c, completer);
413 /* Add a possible target architecture to the list. */
416 add_target (struct target_ops *t)
418 add_target_with_completer (t, NULL);
424 add_deprecated_target_alias (struct target_ops *t, char *alias)
426 struct cmd_list_element *c;
429 /* If we use add_alias_cmd, here, we do not get the deprecated warning,
431 c = add_cmd (alias, no_class, t->to_open, t->to_doc, &targetlist);
432 alt = xstrprintf ("target %s", t->to_shortname);
433 deprecate_cmd (c, alt);
446 struct target_ops *t;
448 for (t = current_target.beneath; t != NULL; t = t->beneath)
449 if (t->to_kill != NULL)
452 fprintf_unfiltered (gdb_stdlog, "target_kill ()\n");
462 target_load (char *arg, int from_tty)
464 target_dcache_invalidate ();
465 (*current_target.to_load) (¤t_target, arg, from_tty);
469 target_create_inferior (char *exec_file, char *args,
470 char **env, int from_tty)
472 struct target_ops *t;
474 for (t = current_target.beneath; t != NULL; t = t->beneath)
476 if (t->to_create_inferior != NULL)
478 t->to_create_inferior (t, exec_file, args, env, from_tty);
480 fprintf_unfiltered (gdb_stdlog,
481 "target_create_inferior (%s, %s, xxx, %d)\n",
482 exec_file, args, from_tty);
487 internal_error (__FILE__, __LINE__,
488 _("could not find a target to create inferior"));
492 target_terminal_inferior (void)
494 /* A background resume (``run&'') should leave GDB in control of the
495 terminal. Use target_can_async_p, not target_is_async_p, since at
496 this point the target is not async yet. However, if sync_execution
497 is not set, we know it will become async prior to resume. */
498 if (target_can_async_p () && !sync_execution)
501 /* If GDB is resuming the inferior in the foreground, install
502 inferior's terminal modes. */
503 (*current_target.to_terminal_inferior) (¤t_target);
507 nomemory (CORE_ADDR memaddr, char *myaddr, int len, int write,
508 struct target_ops *t)
510 errno = EIO; /* Can't read/write this location. */
511 return 0; /* No bytes handled. */
517 error (_("You can't do that when your target is `%s'"),
518 current_target.to_shortname);
524 error (_("You can't do that without a process to debug."));
528 default_terminal_info (struct target_ops *self, const char *args, int from_tty)
530 printf_unfiltered (_("No saved terminal information.\n"));
533 /* A default implementation for the to_get_ada_task_ptid target method.
535 This function builds the PTID by using both LWP and TID as part of
536 the PTID lwp and tid elements. The pid used is the pid of the
540 default_get_ada_task_ptid (struct target_ops *self, long lwp, long tid)
542 return ptid_build (ptid_get_pid (inferior_ptid), lwp, tid);
545 static enum exec_direction_kind
546 default_execution_direction (struct target_ops *self)
548 if (!target_can_execute_reverse)
550 else if (!target_can_async_p ())
553 gdb_assert_not_reached ("\
554 to_execution_direction must be implemented for reverse async");
557 /* Go through the target stack from top to bottom, copying over zero
558 entries in current_target, then filling in still empty entries. In
559 effect, we are doing class inheritance through the pushed target
562 NOTE: cagney/2003-10-17: The problem with this inheritance, as it
563 is currently implemented, is that it discards any knowledge of
564 which target an inherited method originally belonged to.
565 Consequently, new new target methods should instead explicitly and
566 locally search the target stack for the target that can handle the
570 update_current_target (void)
572 struct target_ops *t;
574 /* First, reset current's contents. */
575 memset (¤t_target, 0, sizeof (current_target));
577 /* Install the delegators. */
578 install_delegators (¤t_target);
580 #define INHERIT(FIELD, TARGET) \
581 if (!current_target.FIELD) \
582 current_target.FIELD = (TARGET)->FIELD
584 for (t = target_stack; t; t = t->beneath)
586 INHERIT (to_shortname, t);
587 INHERIT (to_longname, t);
589 /* Do not inherit to_open. */
590 /* Do not inherit to_close. */
591 /* Do not inherit to_attach. */
592 INHERIT (to_post_attach, t);
593 INHERIT (to_attach_no_wait, t);
594 /* Do not inherit to_detach. */
595 /* Do not inherit to_disconnect. */
596 /* Do not inherit to_resume. */
597 /* Do not inherit to_wait. */
598 /* Do not inherit to_fetch_registers. */
599 /* Do not inherit to_store_registers. */
600 INHERIT (to_prepare_to_store, t);
601 INHERIT (deprecated_xfer_memory, t);
602 INHERIT (to_files_info, t);
603 /* Do not inherit to_insert_breakpoint. */
604 /* Do not inherit to_remove_breakpoint. */
605 INHERIT (to_can_use_hw_breakpoint, t);
606 INHERIT (to_insert_hw_breakpoint, t);
607 INHERIT (to_remove_hw_breakpoint, t);
608 /* Do not inherit to_ranged_break_num_registers. */
609 INHERIT (to_insert_watchpoint, t);
610 INHERIT (to_remove_watchpoint, t);
611 /* Do not inherit to_insert_mask_watchpoint. */
612 /* Do not inherit to_remove_mask_watchpoint. */
613 /* Do not inherit to_stopped_data_address. */
614 INHERIT (to_have_steppable_watchpoint, t);
615 INHERIT (to_have_continuable_watchpoint, t);
616 /* Do not inherit to_stopped_by_watchpoint. */
617 INHERIT (to_watchpoint_addr_within_range, t);
618 INHERIT (to_region_ok_for_hw_watchpoint, t);
619 INHERIT (to_can_accel_watchpoint_condition, t);
620 /* Do not inherit to_masked_watch_num_registers. */
621 INHERIT (to_terminal_init, t);
622 INHERIT (to_terminal_inferior, t);
623 INHERIT (to_terminal_ours_for_output, t);
624 INHERIT (to_terminal_ours, t);
625 INHERIT (to_terminal_save_ours, t);
626 INHERIT (to_terminal_info, t);
627 /* Do not inherit to_kill. */
628 INHERIT (to_load, t);
629 /* Do no inherit to_create_inferior. */
630 INHERIT (to_post_startup_inferior, t);
631 INHERIT (to_insert_fork_catchpoint, t);
632 INHERIT (to_remove_fork_catchpoint, t);
633 INHERIT (to_insert_vfork_catchpoint, t);
634 INHERIT (to_remove_vfork_catchpoint, t);
635 /* Do not inherit to_follow_fork. */
636 INHERIT (to_insert_exec_catchpoint, t);
637 INHERIT (to_remove_exec_catchpoint, t);
638 INHERIT (to_set_syscall_catchpoint, t);
639 INHERIT (to_has_exited, t);
640 /* Do not inherit to_mourn_inferior. */
641 INHERIT (to_can_run, t);
642 /* Do not inherit to_pass_signals. */
643 /* Do not inherit to_program_signals. */
644 /* Do not inherit to_thread_alive. */
645 /* Do not inherit to_find_new_threads. */
646 /* Do not inherit to_pid_to_str. */
647 INHERIT (to_extra_thread_info, t);
648 INHERIT (to_thread_name, t);
649 INHERIT (to_stop, t);
650 /* Do not inherit to_xfer_partial. */
651 INHERIT (to_rcmd, t);
652 INHERIT (to_pid_to_exec_file, t);
653 INHERIT (to_log_command, t);
654 INHERIT (to_stratum, t);
655 /* Do not inherit to_has_all_memory. */
656 /* Do not inherit to_has_memory. */
657 /* Do not inherit to_has_stack. */
658 /* Do not inherit to_has_registers. */
659 /* Do not inherit to_has_execution. */
660 INHERIT (to_has_thread_control, t);
661 /* Do not inherit to_can_async_p. */
662 /* Do not inherit to_is_async_p. */
663 /* Do not inherit to_async. */
664 INHERIT (to_find_memory_regions, t);
665 INHERIT (to_make_corefile_notes, t);
666 INHERIT (to_get_bookmark, t);
667 INHERIT (to_goto_bookmark, t);
668 /* Do not inherit to_get_thread_local_address. */
669 INHERIT (to_can_execute_reverse, t);
670 INHERIT (to_execution_direction, t);
671 INHERIT (to_thread_architecture, t);
672 /* Do not inherit to_read_description. */
673 INHERIT (to_get_ada_task_ptid, t);
674 /* Do not inherit to_search_memory. */
675 INHERIT (to_supports_multi_process, t);
676 INHERIT (to_supports_enable_disable_tracepoint, t);
677 INHERIT (to_supports_string_tracing, t);
678 INHERIT (to_trace_init, t);
679 INHERIT (to_download_tracepoint, t);
680 INHERIT (to_can_download_tracepoint, t);
681 INHERIT (to_download_trace_state_variable, t);
682 INHERIT (to_enable_tracepoint, t);
683 INHERIT (to_disable_tracepoint, t);
684 INHERIT (to_trace_set_readonly_regions, t);
685 INHERIT (to_trace_start, t);
686 INHERIT (to_get_trace_status, t);
687 INHERIT (to_get_tracepoint_status, t);
688 INHERIT (to_trace_stop, t);
689 INHERIT (to_trace_find, t);
690 INHERIT (to_get_trace_state_variable_value, t);
691 INHERIT (to_save_trace_data, t);
692 INHERIT (to_upload_tracepoints, t);
693 INHERIT (to_upload_trace_state_variables, t);
694 INHERIT (to_get_raw_trace_data, t);
695 INHERIT (to_get_min_fast_tracepoint_insn_len, t);
696 INHERIT (to_set_disconnected_tracing, t);
697 INHERIT (to_set_circular_trace_buffer, t);
698 INHERIT (to_set_trace_buffer_size, t);
699 INHERIT (to_set_trace_notes, t);
700 INHERIT (to_get_tib_address, t);
701 INHERIT (to_set_permissions, t);
702 INHERIT (to_static_tracepoint_marker_at, t);
703 INHERIT (to_static_tracepoint_markers_by_strid, t);
704 INHERIT (to_traceframe_info, t);
705 INHERIT (to_use_agent, t);
706 INHERIT (to_can_use_agent, t);
707 INHERIT (to_augmented_libraries_svr4_read, t);
708 INHERIT (to_magic, t);
709 INHERIT (to_supports_evaluation_of_breakpoint_conditions, t);
710 INHERIT (to_can_run_breakpoint_commands, t);
711 /* Do not inherit to_memory_map. */
712 /* Do not inherit to_flash_erase. */
713 /* Do not inherit to_flash_done. */
717 /* Clean up a target struct so it no longer has any zero pointers in
718 it. Some entries are defaulted to a method that print an error,
719 others are hard-wired to a standard recursive default. */
721 #define de_fault(field, value) \
722 if (!current_target.field) \
723 current_target.field = value
726 (void (*) (char *, int))
729 (void (*) (struct target_ops *))
731 de_fault (to_post_attach,
732 (void (*) (struct target_ops *, int))
734 de_fault (to_prepare_to_store,
735 (void (*) (struct target_ops *, struct regcache *))
737 de_fault (deprecated_xfer_memory,
738 (int (*) (CORE_ADDR, gdb_byte *, int, int,
739 struct mem_attrib *, struct target_ops *))
741 de_fault (to_files_info,
742 (void (*) (struct target_ops *))
744 de_fault (to_can_use_hw_breakpoint,
745 (int (*) (struct target_ops *, int, int, int))
747 de_fault (to_insert_hw_breakpoint,
748 (int (*) (struct target_ops *, struct gdbarch *,
749 struct bp_target_info *))
751 de_fault (to_remove_hw_breakpoint,
752 (int (*) (struct target_ops *, struct gdbarch *,
753 struct bp_target_info *))
755 de_fault (to_insert_watchpoint,
756 (int (*) (struct target_ops *, CORE_ADDR, int, int,
757 struct expression *))
759 de_fault (to_remove_watchpoint,
760 (int (*) (struct target_ops *, CORE_ADDR, int, int,
761 struct expression *))
763 de_fault (to_watchpoint_addr_within_range,
764 default_watchpoint_addr_within_range);
765 de_fault (to_region_ok_for_hw_watchpoint,
766 default_region_ok_for_hw_watchpoint);
767 de_fault (to_can_accel_watchpoint_condition,
768 (int (*) (struct target_ops *, CORE_ADDR, int, int,
769 struct expression *))
771 de_fault (to_terminal_init,
772 (void (*) (struct target_ops *))
774 de_fault (to_terminal_inferior,
775 (void (*) (struct target_ops *))
777 de_fault (to_terminal_ours_for_output,
778 (void (*) (struct target_ops *))
780 de_fault (to_terminal_ours,
781 (void (*) (struct target_ops *))
783 de_fault (to_terminal_save_ours,
784 (void (*) (struct target_ops *))
786 de_fault (to_terminal_info,
787 default_terminal_info);
789 (void (*) (struct target_ops *, char *, int))
791 de_fault (to_post_startup_inferior,
792 (void (*) (struct target_ops *, ptid_t))
794 de_fault (to_insert_fork_catchpoint,
795 (int (*) (struct target_ops *, int))
797 de_fault (to_remove_fork_catchpoint,
798 (int (*) (struct target_ops *, int))
800 de_fault (to_insert_vfork_catchpoint,
801 (int (*) (struct target_ops *, int))
803 de_fault (to_remove_vfork_catchpoint,
804 (int (*) (struct target_ops *, int))
806 de_fault (to_insert_exec_catchpoint,
807 (int (*) (struct target_ops *, int))
809 de_fault (to_remove_exec_catchpoint,
810 (int (*) (struct target_ops *, int))
812 de_fault (to_set_syscall_catchpoint,
813 (int (*) (struct target_ops *, int, int, int, int, int *))
815 de_fault (to_has_exited,
816 (int (*) (struct target_ops *, int, int, int *))
818 de_fault (to_can_run,
819 (int (*) (struct target_ops *))
821 de_fault (to_extra_thread_info,
822 (char *(*) (struct target_ops *, struct thread_info *))
824 de_fault (to_thread_name,
825 (char *(*) (struct target_ops *, struct thread_info *))
828 (void (*) (struct target_ops *, ptid_t))
831 (void (*) (struct target_ops *, char *, struct ui_file *))
833 de_fault (to_pid_to_exec_file,
834 (char *(*) (struct target_ops *, int))
836 de_fault (to_thread_architecture,
837 default_thread_architecture);
838 current_target.to_read_description = NULL;
839 de_fault (to_get_ada_task_ptid,
840 (ptid_t (*) (struct target_ops *, long, long))
841 default_get_ada_task_ptid);
842 de_fault (to_supports_multi_process,
843 (int (*) (struct target_ops *))
845 de_fault (to_supports_enable_disable_tracepoint,
846 (int (*) (struct target_ops *))
848 de_fault (to_supports_string_tracing,
849 (int (*) (struct target_ops *))
851 de_fault (to_trace_init,
852 (void (*) (struct target_ops *))
854 de_fault (to_download_tracepoint,
855 (void (*) (struct target_ops *, struct bp_location *))
857 de_fault (to_can_download_tracepoint,
858 (int (*) (struct target_ops *))
860 de_fault (to_download_trace_state_variable,
861 (void (*) (struct target_ops *, struct trace_state_variable *))
863 de_fault (to_enable_tracepoint,
864 (void (*) (struct target_ops *, struct bp_location *))
866 de_fault (to_disable_tracepoint,
867 (void (*) (struct target_ops *, struct bp_location *))
869 de_fault (to_trace_set_readonly_regions,
870 (void (*) (struct target_ops *))
872 de_fault (to_trace_start,
873 (void (*) (struct target_ops *))
875 de_fault (to_get_trace_status,
876 (int (*) (struct target_ops *, struct trace_status *))
878 de_fault (to_get_tracepoint_status,
879 (void (*) (struct target_ops *, struct breakpoint *,
880 struct uploaded_tp *))
882 de_fault (to_trace_stop,
883 (void (*) (struct target_ops *))
885 de_fault (to_trace_find,
886 (int (*) (struct target_ops *,
887 enum trace_find_type, int, CORE_ADDR, CORE_ADDR, int *))
889 de_fault (to_get_trace_state_variable_value,
890 (int (*) (struct target_ops *, int, LONGEST *))
892 de_fault (to_save_trace_data,
893 (int (*) (struct target_ops *, const char *))
895 de_fault (to_upload_tracepoints,
896 (int (*) (struct target_ops *, struct uploaded_tp **))
898 de_fault (to_upload_trace_state_variables,
899 (int (*) (struct target_ops *, struct uploaded_tsv **))
901 de_fault (to_get_raw_trace_data,
902 (LONGEST (*) (struct target_ops *, gdb_byte *, ULONGEST, LONGEST))
904 de_fault (to_get_min_fast_tracepoint_insn_len,
905 (int (*) (struct target_ops *))
907 de_fault (to_set_disconnected_tracing,
908 (void (*) (struct target_ops *, int))
910 de_fault (to_set_circular_trace_buffer,
911 (void (*) (struct target_ops *, int))
913 de_fault (to_set_trace_buffer_size,
914 (void (*) (struct target_ops *, LONGEST))
916 de_fault (to_set_trace_notes,
917 (int (*) (struct target_ops *,
918 const char *, const char *, const char *))
920 de_fault (to_get_tib_address,
921 (int (*) (struct target_ops *, ptid_t, CORE_ADDR *))
923 de_fault (to_set_permissions,
924 (void (*) (struct target_ops *))
926 de_fault (to_static_tracepoint_marker_at,
927 (int (*) (struct target_ops *,
928 CORE_ADDR, struct static_tracepoint_marker *))
930 de_fault (to_static_tracepoint_markers_by_strid,
931 (VEC(static_tracepoint_marker_p) * (*) (struct target_ops *,
934 de_fault (to_traceframe_info,
935 (struct traceframe_info * (*) (struct target_ops *))
937 de_fault (to_supports_evaluation_of_breakpoint_conditions,
938 (int (*) (struct target_ops *))
940 de_fault (to_can_run_breakpoint_commands,
941 (int (*) (struct target_ops *))
943 de_fault (to_use_agent,
944 (int (*) (struct target_ops *, int))
946 de_fault (to_can_use_agent,
947 (int (*) (struct target_ops *))
949 de_fault (to_augmented_libraries_svr4_read,
952 de_fault (to_execution_direction, default_execution_direction);
956 /* Finally, position the target-stack beneath the squashed
957 "current_target". That way code looking for a non-inherited
958 target method can quickly and simply find it. */
959 current_target.beneath = target_stack;
962 setup_target_debug ();
965 /* Push a new target type into the stack of the existing target accessors,
966 possibly superseding some of the existing accessors.
968 Rather than allow an empty stack, we always have the dummy target at
969 the bottom stratum, so we can call the function vectors without
973 push_target (struct target_ops *t)
975 struct target_ops **cur;
977 /* Check magic number. If wrong, it probably means someone changed
978 the struct definition, but not all the places that initialize one. */
979 if (t->to_magic != OPS_MAGIC)
981 fprintf_unfiltered (gdb_stderr,
982 "Magic number of %s target struct wrong\n",
984 internal_error (__FILE__, __LINE__,
985 _("failed internal consistency check"));
988 /* Find the proper stratum to install this target in. */
989 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
991 if ((int) (t->to_stratum) >= (int) (*cur)->to_stratum)
995 /* If there's already targets at this stratum, remove them. */
996 /* FIXME: cagney/2003-10-15: I think this should be popping all
997 targets to CUR, and not just those at this stratum level. */
998 while ((*cur) != NULL && t->to_stratum == (*cur)->to_stratum)
1000 /* There's already something at this stratum level. Close it,
1001 and un-hook it from the stack. */
1002 struct target_ops *tmp = (*cur);
1004 (*cur) = (*cur)->beneath;
1005 tmp->beneath = NULL;
1009 /* We have removed all targets in our stratum, now add the new one. */
1010 t->beneath = (*cur);
1013 update_current_target ();
1016 /* Remove a target_ops vector from the stack, wherever it may be.
1017 Return how many times it was removed (0 or 1). */
1020 unpush_target (struct target_ops *t)
1022 struct target_ops **cur;
1023 struct target_ops *tmp;
1025 if (t->to_stratum == dummy_stratum)
1026 internal_error (__FILE__, __LINE__,
1027 _("Attempt to unpush the dummy target"));
1029 /* Look for the specified target. Note that we assume that a target
1030 can only occur once in the target stack. */
1032 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
1038 /* If we don't find target_ops, quit. Only open targets should be
1043 /* Unchain the target. */
1045 (*cur) = (*cur)->beneath;
1046 tmp->beneath = NULL;
1048 update_current_target ();
1050 /* Finally close the target. Note we do this after unchaining, so
1051 any target method calls from within the target_close
1052 implementation don't end up in T anymore. */
1059 pop_all_targets_above (enum strata above_stratum)
1061 while ((int) (current_target.to_stratum) > (int) above_stratum)
1063 if (!unpush_target (target_stack))
1065 fprintf_unfiltered (gdb_stderr,
1066 "pop_all_targets couldn't find target %s\n",
1067 target_stack->to_shortname);
1068 internal_error (__FILE__, __LINE__,
1069 _("failed internal consistency check"));
1076 pop_all_targets (void)
1078 pop_all_targets_above (dummy_stratum);
1081 /* Return 1 if T is now pushed in the target stack. Return 0 otherwise. */
1084 target_is_pushed (struct target_ops *t)
1086 struct target_ops **cur;
1088 /* Check magic number. If wrong, it probably means someone changed
1089 the struct definition, but not all the places that initialize one. */
1090 if (t->to_magic != OPS_MAGIC)
1092 fprintf_unfiltered (gdb_stderr,
1093 "Magic number of %s target struct wrong\n",
1095 internal_error (__FILE__, __LINE__,
1096 _("failed internal consistency check"));
1099 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
1106 /* Using the objfile specified in OBJFILE, find the address for the
1107 current thread's thread-local storage with offset OFFSET. */
1109 target_translate_tls_address (struct objfile *objfile, CORE_ADDR offset)
1111 volatile CORE_ADDR addr = 0;
1112 struct target_ops *target;
1114 for (target = current_target.beneath;
1116 target = target->beneath)
1118 if (target->to_get_thread_local_address != NULL)
1123 && gdbarch_fetch_tls_load_module_address_p (target_gdbarch ()))
1125 ptid_t ptid = inferior_ptid;
1126 volatile struct gdb_exception ex;
1128 TRY_CATCH (ex, RETURN_MASK_ALL)
1132 /* Fetch the load module address for this objfile. */
1133 lm_addr = gdbarch_fetch_tls_load_module_address (target_gdbarch (),
1135 /* If it's 0, throw the appropriate exception. */
1137 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR,
1138 _("TLS load module not found"));
1140 addr = target->to_get_thread_local_address (target, ptid,
1143 /* If an error occurred, print TLS related messages here. Otherwise,
1144 throw the error to some higher catcher. */
1147 int objfile_is_library = (objfile->flags & OBJF_SHARED);
1151 case TLS_NO_LIBRARY_SUPPORT_ERROR:
1152 error (_("Cannot find thread-local variables "
1153 "in this thread library."));
1155 case TLS_LOAD_MODULE_NOT_FOUND_ERROR:
1156 if (objfile_is_library)
1157 error (_("Cannot find shared library `%s' in dynamic"
1158 " linker's load module list"), objfile_name (objfile));
1160 error (_("Cannot find executable file `%s' in dynamic"
1161 " linker's load module list"), objfile_name (objfile));
1163 case TLS_NOT_ALLOCATED_YET_ERROR:
1164 if (objfile_is_library)
1165 error (_("The inferior has not yet allocated storage for"
1166 " thread-local variables in\n"
1167 "the shared library `%s'\n"
1169 objfile_name (objfile), target_pid_to_str (ptid));
1171 error (_("The inferior has not yet allocated storage for"
1172 " thread-local variables in\n"
1173 "the executable `%s'\n"
1175 objfile_name (objfile), target_pid_to_str (ptid));
1177 case TLS_GENERIC_ERROR:
1178 if (objfile_is_library)
1179 error (_("Cannot find thread-local storage for %s, "
1180 "shared library %s:\n%s"),
1181 target_pid_to_str (ptid),
1182 objfile_name (objfile), ex.message);
1184 error (_("Cannot find thread-local storage for %s, "
1185 "executable file %s:\n%s"),
1186 target_pid_to_str (ptid),
1187 objfile_name (objfile), ex.message);
1190 throw_exception (ex);
1195 /* It wouldn't be wrong here to try a gdbarch method, too; finding
1196 TLS is an ABI-specific thing. But we don't do that yet. */
1198 error (_("Cannot find thread-local variables on this target"));
1204 target_xfer_status_to_string (enum target_xfer_status err)
1206 #define CASE(X) case X: return #X
1209 CASE(TARGET_XFER_E_IO);
1210 CASE(TARGET_XFER_E_UNAVAILABLE);
1219 #define MIN(A, B) (((A) <= (B)) ? (A) : (B))
1221 /* target_read_string -- read a null terminated string, up to LEN bytes,
1222 from MEMADDR in target. Set *ERRNOP to the errno code, or 0 if successful.
1223 Set *STRING to a pointer to malloc'd memory containing the data; the caller
1224 is responsible for freeing it. Return the number of bytes successfully
1228 target_read_string (CORE_ADDR memaddr, char **string, int len, int *errnop)
1230 int tlen, offset, i;
1234 int buffer_allocated;
1236 unsigned int nbytes_read = 0;
1238 gdb_assert (string);
1240 /* Small for testing. */
1241 buffer_allocated = 4;
1242 buffer = xmalloc (buffer_allocated);
1247 tlen = MIN (len, 4 - (memaddr & 3));
1248 offset = memaddr & 3;
1250 errcode = target_read_memory (memaddr & ~3, buf, sizeof buf);
1253 /* The transfer request might have crossed the boundary to an
1254 unallocated region of memory. Retry the transfer, requesting
1258 errcode = target_read_memory (memaddr, buf, 1);
1263 if (bufptr - buffer + tlen > buffer_allocated)
1267 bytes = bufptr - buffer;
1268 buffer_allocated *= 2;
1269 buffer = xrealloc (buffer, buffer_allocated);
1270 bufptr = buffer + bytes;
1273 for (i = 0; i < tlen; i++)
1275 *bufptr++ = buf[i + offset];
1276 if (buf[i + offset] == '\000')
1278 nbytes_read += i + 1;
1285 nbytes_read += tlen;
1294 struct target_section_table *
1295 target_get_section_table (struct target_ops *target)
1297 struct target_ops *t;
1300 fprintf_unfiltered (gdb_stdlog, "target_get_section_table ()\n");
1302 for (t = target; t != NULL; t = t->beneath)
1303 if (t->to_get_section_table != NULL)
1304 return (*t->to_get_section_table) (t);
1309 /* Find a section containing ADDR. */
1311 struct target_section *
1312 target_section_by_addr (struct target_ops *target, CORE_ADDR addr)
1314 struct target_section_table *table = target_get_section_table (target);
1315 struct target_section *secp;
1320 for (secp = table->sections; secp < table->sections_end; secp++)
1322 if (addr >= secp->addr && addr < secp->endaddr)
1328 /* Read memory from the live target, even if currently inspecting a
1329 traceframe. The return is the same as that of target_read. */
1331 static enum target_xfer_status
1332 target_read_live_memory (enum target_object object,
1333 ULONGEST memaddr, gdb_byte *myaddr, ULONGEST len,
1334 ULONGEST *xfered_len)
1336 enum target_xfer_status ret;
1337 struct cleanup *cleanup;
1339 /* Switch momentarily out of tfind mode so to access live memory.
1340 Note that this must not clear global state, such as the frame
1341 cache, which must still remain valid for the previous traceframe.
1342 We may be _building_ the frame cache at this point. */
1343 cleanup = make_cleanup_restore_traceframe_number ();
1344 set_traceframe_number (-1);
1346 ret = target_xfer_partial (current_target.beneath, object, NULL,
1347 myaddr, NULL, memaddr, len, xfered_len);
1349 do_cleanups (cleanup);
1353 /* Using the set of read-only target sections of OPS, read live
1354 read-only memory. Note that the actual reads start from the
1355 top-most target again.
1357 For interface/parameters/return description see target.h,
1360 static enum target_xfer_status
1361 memory_xfer_live_readonly_partial (struct target_ops *ops,
1362 enum target_object object,
1363 gdb_byte *readbuf, ULONGEST memaddr,
1364 ULONGEST len, ULONGEST *xfered_len)
1366 struct target_section *secp;
1367 struct target_section_table *table;
1369 secp = target_section_by_addr (ops, memaddr);
1371 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1372 secp->the_bfd_section)
1375 struct target_section *p;
1376 ULONGEST memend = memaddr + len;
1378 table = target_get_section_table (ops);
1380 for (p = table->sections; p < table->sections_end; p++)
1382 if (memaddr >= p->addr)
1384 if (memend <= p->endaddr)
1386 /* Entire transfer is within this section. */
1387 return target_read_live_memory (object, memaddr,
1388 readbuf, len, xfered_len);
1390 else if (memaddr >= p->endaddr)
1392 /* This section ends before the transfer starts. */
1397 /* This section overlaps the transfer. Just do half. */
1398 len = p->endaddr - memaddr;
1399 return target_read_live_memory (object, memaddr,
1400 readbuf, len, xfered_len);
1406 return TARGET_XFER_EOF;
1409 /* Read memory from more than one valid target. A core file, for
1410 instance, could have some of memory but delegate other bits to
1411 the target below it. So, we must manually try all targets. */
1413 static enum target_xfer_status
1414 raw_memory_xfer_partial (struct target_ops *ops, gdb_byte *readbuf,
1415 const gdb_byte *writebuf, ULONGEST memaddr, LONGEST len,
1416 ULONGEST *xfered_len)
1418 enum target_xfer_status res;
1422 res = ops->to_xfer_partial (ops, TARGET_OBJECT_MEMORY, NULL,
1423 readbuf, writebuf, memaddr, len,
1425 if (res == TARGET_XFER_OK)
1428 /* Stop if the target reports that the memory is not available. */
1429 if (res == TARGET_XFER_E_UNAVAILABLE)
1432 /* We want to continue past core files to executables, but not
1433 past a running target's memory. */
1434 if (ops->to_has_all_memory (ops))
1439 while (ops != NULL);
1444 /* Perform a partial memory transfer.
1445 For docs see target.h, to_xfer_partial. */
1447 static enum target_xfer_status
1448 memory_xfer_partial_1 (struct target_ops *ops, enum target_object object,
1449 gdb_byte *readbuf, const gdb_byte *writebuf, ULONGEST memaddr,
1450 ULONGEST len, ULONGEST *xfered_len)
1452 enum target_xfer_status res;
1454 struct mem_region *region;
1455 struct inferior *inf;
1457 /* For accesses to unmapped overlay sections, read directly from
1458 files. Must do this first, as MEMADDR may need adjustment. */
1459 if (readbuf != NULL && overlay_debugging)
1461 struct obj_section *section = find_pc_overlay (memaddr);
1463 if (pc_in_unmapped_range (memaddr, section))
1465 struct target_section_table *table
1466 = target_get_section_table (ops);
1467 const char *section_name = section->the_bfd_section->name;
1469 memaddr = overlay_mapped_address (memaddr, section);
1470 return section_table_xfer_memory_partial (readbuf, writebuf,
1471 memaddr, len, xfered_len,
1473 table->sections_end,
1478 /* Try the executable files, if "trust-readonly-sections" is set. */
1479 if (readbuf != NULL && trust_readonly)
1481 struct target_section *secp;
1482 struct target_section_table *table;
1484 secp = target_section_by_addr (ops, memaddr);
1486 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1487 secp->the_bfd_section)
1490 table = target_get_section_table (ops);
1491 return section_table_xfer_memory_partial (readbuf, writebuf,
1492 memaddr, len, xfered_len,
1494 table->sections_end,
1499 /* If reading unavailable memory in the context of traceframes, and
1500 this address falls within a read-only section, fallback to
1501 reading from live memory. */
1502 if (readbuf != NULL && get_traceframe_number () != -1)
1504 VEC(mem_range_s) *available;
1506 /* If we fail to get the set of available memory, then the
1507 target does not support querying traceframe info, and so we
1508 attempt reading from the traceframe anyway (assuming the
1509 target implements the old QTro packet then). */
1510 if (traceframe_available_memory (&available, memaddr, len))
1512 struct cleanup *old_chain;
1514 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
1516 if (VEC_empty (mem_range_s, available)
1517 || VEC_index (mem_range_s, available, 0)->start != memaddr)
1519 /* Don't read into the traceframe's available
1521 if (!VEC_empty (mem_range_s, available))
1523 LONGEST oldlen = len;
1525 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
1526 gdb_assert (len <= oldlen);
1529 do_cleanups (old_chain);
1531 /* This goes through the topmost target again. */
1532 res = memory_xfer_live_readonly_partial (ops, object,
1535 if (res == TARGET_XFER_OK)
1536 return TARGET_XFER_OK;
1539 /* No use trying further, we know some memory starting
1540 at MEMADDR isn't available. */
1542 return TARGET_XFER_E_UNAVAILABLE;
1546 /* Don't try to read more than how much is available, in
1547 case the target implements the deprecated QTro packet to
1548 cater for older GDBs (the target's knowledge of read-only
1549 sections may be outdated by now). */
1550 len = VEC_index (mem_range_s, available, 0)->length;
1552 do_cleanups (old_chain);
1556 /* Try GDB's internal data cache. */
1557 region = lookup_mem_region (memaddr);
1558 /* region->hi == 0 means there's no upper bound. */
1559 if (memaddr + len < region->hi || region->hi == 0)
1562 reg_len = region->hi - memaddr;
1564 switch (region->attrib.mode)
1567 if (writebuf != NULL)
1568 return TARGET_XFER_E_IO;
1572 if (readbuf != NULL)
1573 return TARGET_XFER_E_IO;
1577 /* We only support writing to flash during "load" for now. */
1578 if (writebuf != NULL)
1579 error (_("Writing to flash memory forbidden in this context"));
1583 return TARGET_XFER_E_IO;
1586 if (!ptid_equal (inferior_ptid, null_ptid))
1587 inf = find_inferior_pid (ptid_get_pid (inferior_ptid));
1592 /* The dcache reads whole cache lines; that doesn't play well
1593 with reading from a trace buffer, because reading outside of
1594 the collected memory range fails. */
1595 && get_traceframe_number () == -1
1596 && (region->attrib.cache
1597 || (stack_cache_enabled_p () && object == TARGET_OBJECT_STACK_MEMORY)
1598 || (code_cache_enabled_p () && object == TARGET_OBJECT_CODE_MEMORY)))
1600 DCACHE *dcache = target_dcache_get_or_init ();
1603 if (readbuf != NULL)
1604 l = dcache_xfer_memory (ops, dcache, memaddr, readbuf, reg_len, 0);
1606 /* FIXME drow/2006-08-09: If we're going to preserve const
1607 correctness dcache_xfer_memory should take readbuf and
1609 l = dcache_xfer_memory (ops, dcache, memaddr, (void *) writebuf,
1612 return TARGET_XFER_E_IO;
1615 *xfered_len = (ULONGEST) l;
1616 return TARGET_XFER_OK;
1620 /* If none of those methods found the memory we wanted, fall back
1621 to a target partial transfer. Normally a single call to
1622 to_xfer_partial is enough; if it doesn't recognize an object
1623 it will call the to_xfer_partial of the next target down.
1624 But for memory this won't do. Memory is the only target
1625 object which can be read from more than one valid target.
1626 A core file, for instance, could have some of memory but
1627 delegate other bits to the target below it. So, we must
1628 manually try all targets. */
1630 res = raw_memory_xfer_partial (ops, readbuf, writebuf, memaddr, reg_len,
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. */
1637 if (res == TARGET_XFER_OK
1640 && target_dcache_init_p ()
1641 && !region->attrib.cache
1642 && ((stack_cache_enabled_p () && object != TARGET_OBJECT_STACK_MEMORY)
1643 || (code_cache_enabled_p () && object != TARGET_OBJECT_CODE_MEMORY)))
1645 DCACHE *dcache = target_dcache_get ();
1647 dcache_update (dcache, memaddr, (void *) writebuf, reg_len);
1650 /* If we still haven't got anything, return the last error. We
1655 /* Perform a partial memory transfer. For docs see target.h,
1658 static enum target_xfer_status
1659 memory_xfer_partial (struct target_ops *ops, enum target_object object,
1660 gdb_byte *readbuf, const gdb_byte *writebuf,
1661 ULONGEST memaddr, ULONGEST len, ULONGEST *xfered_len)
1663 enum target_xfer_status res;
1665 /* Zero length requests are ok and require no work. */
1667 return TARGET_XFER_EOF;
1669 /* Fill in READBUF with breakpoint shadows, or WRITEBUF with
1670 breakpoint insns, thus hiding out from higher layers whether
1671 there are software breakpoints inserted in the code stream. */
1672 if (readbuf != NULL)
1674 res = memory_xfer_partial_1 (ops, object, readbuf, NULL, memaddr, len,
1677 if (res == TARGET_XFER_OK && !show_memory_breakpoints)
1678 breakpoint_xfer_memory (readbuf, NULL, NULL, memaddr, res);
1683 struct cleanup *old_chain;
1685 /* A large write request is likely to be partially satisfied
1686 by memory_xfer_partial_1. We will continually malloc
1687 and free a copy of the entire write request for breakpoint
1688 shadow handling even though we only end up writing a small
1689 subset of it. Cap writes to 4KB to mitigate this. */
1690 len = min (4096, len);
1692 buf = xmalloc (len);
1693 old_chain = make_cleanup (xfree, buf);
1694 memcpy (buf, writebuf, len);
1696 breakpoint_xfer_memory (NULL, buf, writebuf, memaddr, len);
1697 res = memory_xfer_partial_1 (ops, object, NULL, buf, memaddr, len,
1700 do_cleanups (old_chain);
1707 restore_show_memory_breakpoints (void *arg)
1709 show_memory_breakpoints = (uintptr_t) arg;
1713 make_show_memory_breakpoints_cleanup (int show)
1715 int current = show_memory_breakpoints;
1717 show_memory_breakpoints = show;
1718 return make_cleanup (restore_show_memory_breakpoints,
1719 (void *) (uintptr_t) current);
1722 /* For docs see target.h, to_xfer_partial. */
1724 enum target_xfer_status
1725 target_xfer_partial (struct target_ops *ops,
1726 enum target_object object, const char *annex,
1727 gdb_byte *readbuf, const gdb_byte *writebuf,
1728 ULONGEST offset, ULONGEST len,
1729 ULONGEST *xfered_len)
1731 enum target_xfer_status retval;
1733 gdb_assert (ops->to_xfer_partial != NULL);
1735 /* Transfer is done when LEN is zero. */
1737 return TARGET_XFER_EOF;
1739 if (writebuf && !may_write_memory)
1740 error (_("Writing to memory is not allowed (addr %s, len %s)"),
1741 core_addr_to_string_nz (offset), plongest (len));
1745 /* If this is a memory transfer, let the memory-specific code
1746 have a look at it instead. Memory transfers are more
1748 if (object == TARGET_OBJECT_MEMORY || object == TARGET_OBJECT_STACK_MEMORY
1749 || object == TARGET_OBJECT_CODE_MEMORY)
1750 retval = memory_xfer_partial (ops, object, readbuf,
1751 writebuf, offset, len, xfered_len);
1752 else if (object == TARGET_OBJECT_RAW_MEMORY)
1754 /* Request the normal memory object from other layers. */
1755 retval = raw_memory_xfer_partial (ops, readbuf, writebuf, offset, len,
1759 retval = ops->to_xfer_partial (ops, object, annex, readbuf,
1760 writebuf, offset, len, xfered_len);
1764 const unsigned char *myaddr = NULL;
1766 fprintf_unfiltered (gdb_stdlog,
1767 "%s:target_xfer_partial "
1768 "(%d, %s, %s, %s, %s, %s) = %d, %s",
1771 (annex ? annex : "(null)"),
1772 host_address_to_string (readbuf),
1773 host_address_to_string (writebuf),
1774 core_addr_to_string_nz (offset),
1775 pulongest (len), retval,
1776 pulongest (*xfered_len));
1782 if (retval == TARGET_XFER_OK && myaddr != NULL)
1786 fputs_unfiltered (", bytes =", gdb_stdlog);
1787 for (i = 0; i < *xfered_len; i++)
1789 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
1791 if (targetdebug < 2 && i > 0)
1793 fprintf_unfiltered (gdb_stdlog, " ...");
1796 fprintf_unfiltered (gdb_stdlog, "\n");
1799 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
1803 fputc_unfiltered ('\n', gdb_stdlog);
1806 /* Check implementations of to_xfer_partial update *XFERED_LEN
1807 properly. Do assertion after printing debug messages, so that we
1808 can find more clues on assertion failure from debugging messages. */
1809 if (retval == TARGET_XFER_OK || retval == TARGET_XFER_E_UNAVAILABLE)
1810 gdb_assert (*xfered_len > 0);
1815 /* Read LEN bytes of target memory at address MEMADDR, placing the
1816 results in GDB's memory at MYADDR. Returns either 0 for success or
1817 TARGET_XFER_E_IO if any error occurs.
1819 If an error occurs, no guarantee is made about the contents of the data at
1820 MYADDR. In particular, the caller should not depend upon partial reads
1821 filling the buffer with good data. There is no way for the caller to know
1822 how much good data might have been transfered anyway. Callers that can
1823 deal with partial reads should call target_read (which will retry until
1824 it makes no progress, and then return how much was transferred). */
1827 target_read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1829 /* Dispatch to the topmost target, not the flattened current_target.
1830 Memory accesses check target->to_has_(all_)memory, and the
1831 flattened target doesn't inherit those. */
1832 if (target_read (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1833 myaddr, memaddr, len) == len)
1836 return TARGET_XFER_E_IO;
1839 /* Like target_read_memory, but specify explicitly that this is a read
1840 from the target's raw memory. That is, this read bypasses the
1841 dcache, breakpoint shadowing, etc. */
1844 target_read_raw_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1846 /* See comment in target_read_memory about why the request starts at
1847 current_target.beneath. */
1848 if (target_read (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1849 myaddr, memaddr, len) == len)
1852 return TARGET_XFER_E_IO;
1855 /* Like target_read_memory, but specify explicitly that this is a read from
1856 the target's stack. This may trigger different cache behavior. */
1859 target_read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1861 /* See comment in target_read_memory about why the request starts at
1862 current_target.beneath. */
1863 if (target_read (current_target.beneath, TARGET_OBJECT_STACK_MEMORY, NULL,
1864 myaddr, memaddr, len) == len)
1867 return TARGET_XFER_E_IO;
1870 /* Like target_read_memory, but specify explicitly that this is a read from
1871 the target's code. This may trigger different cache behavior. */
1874 target_read_code (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1876 /* See comment in target_read_memory about why the request starts at
1877 current_target.beneath. */
1878 if (target_read (current_target.beneath, TARGET_OBJECT_CODE_MEMORY, NULL,
1879 myaddr, memaddr, len) == len)
1882 return TARGET_XFER_E_IO;
1885 /* Write LEN bytes from MYADDR to target memory at address MEMADDR.
1886 Returns either 0 for success or TARGET_XFER_E_IO if any
1887 error occurs. If an error occurs, no guarantee is made about how
1888 much data got written. Callers that can deal with partial writes
1889 should call target_write. */
1892 target_write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1894 /* See comment in target_read_memory about why the request starts at
1895 current_target.beneath. */
1896 if (target_write (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1897 myaddr, memaddr, len) == len)
1900 return TARGET_XFER_E_IO;
1903 /* Write LEN bytes from MYADDR to target raw memory at address
1904 MEMADDR. Returns either 0 for success or TARGET_XFER_E_IO
1905 if any error occurs. If an error occurs, no guarantee is made
1906 about how much data got written. Callers that can deal with
1907 partial writes should call target_write. */
1910 target_write_raw_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1912 /* See comment in target_read_memory about why the request starts at
1913 current_target.beneath. */
1914 if (target_write (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1915 myaddr, memaddr, len) == len)
1918 return TARGET_XFER_E_IO;
1921 /* Fetch the target's memory map. */
1924 target_memory_map (void)
1926 VEC(mem_region_s) *result;
1927 struct mem_region *last_one, *this_one;
1929 struct target_ops *t;
1932 fprintf_unfiltered (gdb_stdlog, "target_memory_map ()\n");
1934 for (t = current_target.beneath; t != NULL; t = t->beneath)
1935 if (t->to_memory_map != NULL)
1941 result = t->to_memory_map (t);
1945 qsort (VEC_address (mem_region_s, result),
1946 VEC_length (mem_region_s, result),
1947 sizeof (struct mem_region), mem_region_cmp);
1949 /* Check that regions do not overlap. Simultaneously assign
1950 a numbering for the "mem" commands to use to refer to
1953 for (ix = 0; VEC_iterate (mem_region_s, result, ix, this_one); ix++)
1955 this_one->number = ix;
1957 if (last_one && last_one->hi > this_one->lo)
1959 warning (_("Overlapping regions in memory map: ignoring"));
1960 VEC_free (mem_region_s, result);
1963 last_one = this_one;
1970 target_flash_erase (ULONGEST address, LONGEST length)
1972 struct target_ops *t;
1974 for (t = current_target.beneath; t != NULL; t = t->beneath)
1975 if (t->to_flash_erase != NULL)
1978 fprintf_unfiltered (gdb_stdlog, "target_flash_erase (%s, %s)\n",
1979 hex_string (address), phex (length, 0));
1980 t->to_flash_erase (t, address, length);
1988 target_flash_done (void)
1990 struct target_ops *t;
1992 for (t = current_target.beneath; t != NULL; t = t->beneath)
1993 if (t->to_flash_done != NULL)
1996 fprintf_unfiltered (gdb_stdlog, "target_flash_done\n");
1997 t->to_flash_done (t);
2005 show_trust_readonly (struct ui_file *file, int from_tty,
2006 struct cmd_list_element *c, const char *value)
2008 fprintf_filtered (file,
2009 _("Mode for reading from readonly sections is %s.\n"),
2013 /* More generic transfers. */
2015 static enum target_xfer_status
2016 default_xfer_partial (struct target_ops *ops, enum target_object object,
2017 const char *annex, gdb_byte *readbuf,
2018 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
2019 ULONGEST *xfered_len)
2021 if (object == TARGET_OBJECT_MEMORY
2022 && ops->deprecated_xfer_memory != NULL)
2023 /* If available, fall back to the target's
2024 "deprecated_xfer_memory" method. */
2029 if (writebuf != NULL)
2031 void *buffer = xmalloc (len);
2032 struct cleanup *cleanup = make_cleanup (xfree, buffer);
2034 memcpy (buffer, writebuf, len);
2035 xfered = ops->deprecated_xfer_memory (offset, buffer, len,
2036 1/*write*/, NULL, ops);
2037 do_cleanups (cleanup);
2039 if (readbuf != NULL)
2040 xfered = ops->deprecated_xfer_memory (offset, readbuf, len,
2041 0/*read*/, NULL, ops);
2044 *xfered_len = (ULONGEST) xfered;
2045 return TARGET_XFER_E_IO;
2047 else if (xfered == 0 && errno == 0)
2048 /* "deprecated_xfer_memory" uses 0, cross checked against
2049 ERRNO as one indication of an error. */
2050 return TARGET_XFER_EOF;
2052 return TARGET_XFER_E_IO;
2056 gdb_assert (ops->beneath != NULL);
2057 return ops->beneath->to_xfer_partial (ops->beneath, object, annex,
2058 readbuf, writebuf, offset, len,
2063 /* Target vector read/write partial wrapper functions. */
2065 static enum target_xfer_status
2066 target_read_partial (struct target_ops *ops,
2067 enum target_object object,
2068 const char *annex, gdb_byte *buf,
2069 ULONGEST offset, ULONGEST len,
2070 ULONGEST *xfered_len)
2072 return target_xfer_partial (ops, object, annex, buf, NULL, offset, len,
2076 static enum target_xfer_status
2077 target_write_partial (struct target_ops *ops,
2078 enum target_object object,
2079 const char *annex, const gdb_byte *buf,
2080 ULONGEST offset, LONGEST len, ULONGEST *xfered_len)
2082 return target_xfer_partial (ops, object, annex, NULL, buf, offset, len,
2086 /* Wrappers to perform the full transfer. */
2088 /* For docs on target_read see target.h. */
2091 target_read (struct target_ops *ops,
2092 enum target_object object,
2093 const char *annex, gdb_byte *buf,
2094 ULONGEST offset, LONGEST len)
2098 while (xfered < len)
2100 ULONGEST xfered_len;
2101 enum target_xfer_status status;
2103 status = target_read_partial (ops, object, annex,
2104 (gdb_byte *) buf + xfered,
2105 offset + xfered, len - xfered,
2108 /* Call an observer, notifying them of the xfer progress? */
2109 if (status == TARGET_XFER_EOF)
2111 else if (status == TARGET_XFER_OK)
2113 xfered += xfered_len;
2123 /* Assuming that the entire [begin, end) range of memory cannot be
2124 read, try to read whatever subrange is possible to read.
2126 The function returns, in RESULT, either zero or one memory block.
2127 If there's a readable subrange at the beginning, it is completely
2128 read and returned. Any further readable subrange will not be read.
2129 Otherwise, if there's a readable subrange at the end, it will be
2130 completely read and returned. Any readable subranges before it
2131 (obviously, not starting at the beginning), will be ignored. In
2132 other cases -- either no readable subrange, or readable subrange(s)
2133 that is neither at the beginning, or end, nothing is returned.
2135 The purpose of this function is to handle a read across a boundary
2136 of accessible memory in a case when memory map is not available.
2137 The above restrictions are fine for this case, but will give
2138 incorrect results if the memory is 'patchy'. However, supporting
2139 'patchy' memory would require trying to read every single byte,
2140 and it seems unacceptable solution. Explicit memory map is
2141 recommended for this case -- and target_read_memory_robust will
2142 take care of reading multiple ranges then. */
2145 read_whatever_is_readable (struct target_ops *ops,
2146 ULONGEST begin, ULONGEST end,
2147 VEC(memory_read_result_s) **result)
2149 gdb_byte *buf = xmalloc (end - begin);
2150 ULONGEST current_begin = begin;
2151 ULONGEST current_end = end;
2153 memory_read_result_s r;
2154 ULONGEST xfered_len;
2156 /* If we previously failed to read 1 byte, nothing can be done here. */
2157 if (end - begin <= 1)
2163 /* Check that either first or the last byte is readable, and give up
2164 if not. This heuristic is meant to permit reading accessible memory
2165 at the boundary of accessible region. */
2166 if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
2167 buf, begin, 1, &xfered_len) == TARGET_XFER_OK)
2172 else if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
2173 buf + (end-begin) - 1, end - 1, 1,
2174 &xfered_len) == TARGET_XFER_OK)
2185 /* Loop invariant is that the [current_begin, current_end) was previously
2186 found to be not readable as a whole.
2188 Note loop condition -- if the range has 1 byte, we can't divide the range
2189 so there's no point trying further. */
2190 while (current_end - current_begin > 1)
2192 ULONGEST first_half_begin, first_half_end;
2193 ULONGEST second_half_begin, second_half_end;
2195 ULONGEST middle = current_begin + (current_end - current_begin)/2;
2199 first_half_begin = current_begin;
2200 first_half_end = middle;
2201 second_half_begin = middle;
2202 second_half_end = current_end;
2206 first_half_begin = middle;
2207 first_half_end = current_end;
2208 second_half_begin = current_begin;
2209 second_half_end = middle;
2212 xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2213 buf + (first_half_begin - begin),
2215 first_half_end - first_half_begin);
2217 if (xfer == first_half_end - first_half_begin)
2219 /* This half reads up fine. So, the error must be in the
2221 current_begin = second_half_begin;
2222 current_end = second_half_end;
2226 /* This half is not readable. Because we've tried one byte, we
2227 know some part of this half if actually redable. Go to the next
2228 iteration to divide again and try to read.
2230 We don't handle the other half, because this function only tries
2231 to read a single readable subrange. */
2232 current_begin = first_half_begin;
2233 current_end = first_half_end;
2239 /* The [begin, current_begin) range has been read. */
2241 r.end = current_begin;
2246 /* The [current_end, end) range has been read. */
2247 LONGEST rlen = end - current_end;
2249 r.data = xmalloc (rlen);
2250 memcpy (r.data, buf + current_end - begin, rlen);
2251 r.begin = current_end;
2255 VEC_safe_push(memory_read_result_s, (*result), &r);
2259 free_memory_read_result_vector (void *x)
2261 VEC(memory_read_result_s) *v = x;
2262 memory_read_result_s *current;
2265 for (ix = 0; VEC_iterate (memory_read_result_s, v, ix, current); ++ix)
2267 xfree (current->data);
2269 VEC_free (memory_read_result_s, v);
2272 VEC(memory_read_result_s) *
2273 read_memory_robust (struct target_ops *ops, ULONGEST offset, LONGEST len)
2275 VEC(memory_read_result_s) *result = 0;
2278 while (xfered < len)
2280 struct mem_region *region = lookup_mem_region (offset + xfered);
2283 /* If there is no explicit region, a fake one should be created. */
2284 gdb_assert (region);
2286 if (region->hi == 0)
2287 rlen = len - xfered;
2289 rlen = region->hi - offset;
2291 if (region->attrib.mode == MEM_NONE || region->attrib.mode == MEM_WO)
2293 /* Cannot read this region. Note that we can end up here only
2294 if the region is explicitly marked inaccessible, or
2295 'inaccessible-by-default' is in effect. */
2300 LONGEST to_read = min (len - xfered, rlen);
2301 gdb_byte *buffer = (gdb_byte *)xmalloc (to_read);
2303 LONGEST xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2304 (gdb_byte *) buffer,
2305 offset + xfered, to_read);
2306 /* Call an observer, notifying them of the xfer progress? */
2309 /* Got an error reading full chunk. See if maybe we can read
2312 read_whatever_is_readable (ops, offset + xfered,
2313 offset + xfered + to_read, &result);
2318 struct memory_read_result r;
2320 r.begin = offset + xfered;
2321 r.end = r.begin + xfer;
2322 VEC_safe_push (memory_read_result_s, result, &r);
2332 /* An alternative to target_write with progress callbacks. */
2335 target_write_with_progress (struct target_ops *ops,
2336 enum target_object object,
2337 const char *annex, const gdb_byte *buf,
2338 ULONGEST offset, LONGEST len,
2339 void (*progress) (ULONGEST, void *), void *baton)
2343 /* Give the progress callback a chance to set up. */
2345 (*progress) (0, baton);
2347 while (xfered < len)
2349 ULONGEST xfered_len;
2350 enum target_xfer_status status;
2352 status = target_write_partial (ops, object, annex,
2353 (gdb_byte *) buf + xfered,
2354 offset + xfered, len - xfered,
2357 if (status == TARGET_XFER_EOF)
2359 if (TARGET_XFER_STATUS_ERROR_P (status))
2362 gdb_assert (status == TARGET_XFER_OK);
2364 (*progress) (xfered_len, baton);
2366 xfered += xfered_len;
2372 /* For docs on target_write see target.h. */
2375 target_write (struct target_ops *ops,
2376 enum target_object object,
2377 const char *annex, const gdb_byte *buf,
2378 ULONGEST offset, LONGEST len)
2380 return target_write_with_progress (ops, object, annex, buf, offset, len,
2384 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
2385 the size of the transferred data. PADDING additional bytes are
2386 available in *BUF_P. This is a helper function for
2387 target_read_alloc; see the declaration of that function for more
2391 target_read_alloc_1 (struct target_ops *ops, enum target_object object,
2392 const char *annex, gdb_byte **buf_p, int padding)
2394 size_t buf_alloc, buf_pos;
2397 /* This function does not have a length parameter; it reads the
2398 entire OBJECT). Also, it doesn't support objects fetched partly
2399 from one target and partly from another (in a different stratum,
2400 e.g. a core file and an executable). Both reasons make it
2401 unsuitable for reading memory. */
2402 gdb_assert (object != TARGET_OBJECT_MEMORY);
2404 /* Start by reading up to 4K at a time. The target will throttle
2405 this number down if necessary. */
2407 buf = xmalloc (buf_alloc);
2411 ULONGEST xfered_len;
2412 enum target_xfer_status status;
2414 status = target_read_partial (ops, object, annex, &buf[buf_pos],
2415 buf_pos, buf_alloc - buf_pos - padding,
2418 if (status == TARGET_XFER_EOF)
2420 /* Read all there was. */
2427 else if (status != TARGET_XFER_OK)
2429 /* An error occurred. */
2431 return TARGET_XFER_E_IO;
2434 buf_pos += xfered_len;
2436 /* If the buffer is filling up, expand it. */
2437 if (buf_alloc < buf_pos * 2)
2440 buf = xrealloc (buf, buf_alloc);
2447 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
2448 the size of the transferred data. See the declaration in "target.h"
2449 function for more information about the return value. */
2452 target_read_alloc (struct target_ops *ops, enum target_object object,
2453 const char *annex, gdb_byte **buf_p)
2455 return target_read_alloc_1 (ops, object, annex, buf_p, 0);
2458 /* Read OBJECT/ANNEX using OPS. The result is NUL-terminated and
2459 returned as a string, allocated using xmalloc. If an error occurs
2460 or the transfer is unsupported, NULL is returned. Empty objects
2461 are returned as allocated but empty strings. A warning is issued
2462 if the result contains any embedded NUL bytes. */
2465 target_read_stralloc (struct target_ops *ops, enum target_object object,
2470 LONGEST i, transferred;
2472 transferred = target_read_alloc_1 (ops, object, annex, &buffer, 1);
2473 bufstr = (char *) buffer;
2475 if (transferred < 0)
2478 if (transferred == 0)
2479 return xstrdup ("");
2481 bufstr[transferred] = 0;
2483 /* Check for embedded NUL bytes; but allow trailing NULs. */
2484 for (i = strlen (bufstr); i < transferred; i++)
2487 warning (_("target object %d, annex %s, "
2488 "contained unexpected null characters"),
2489 (int) object, annex ? annex : "(none)");
2496 /* Memory transfer methods. */
2499 get_target_memory (struct target_ops *ops, CORE_ADDR addr, gdb_byte *buf,
2502 /* This method is used to read from an alternate, non-current
2503 target. This read must bypass the overlay support (as symbols
2504 don't match this target), and GDB's internal cache (wrong cache
2505 for this target). */
2506 if (target_read (ops, TARGET_OBJECT_RAW_MEMORY, NULL, buf, addr, len)
2508 memory_error (TARGET_XFER_E_IO, addr);
2512 get_target_memory_unsigned (struct target_ops *ops, CORE_ADDR addr,
2513 int len, enum bfd_endian byte_order)
2515 gdb_byte buf[sizeof (ULONGEST)];
2517 gdb_assert (len <= sizeof (buf));
2518 get_target_memory (ops, addr, buf, len);
2519 return extract_unsigned_integer (buf, len, byte_order);
2525 target_insert_breakpoint (struct gdbarch *gdbarch,
2526 struct bp_target_info *bp_tgt)
2528 if (!may_insert_breakpoints)
2530 warning (_("May not insert breakpoints"));
2534 return current_target.to_insert_breakpoint (¤t_target,
2541 target_remove_breakpoint (struct gdbarch *gdbarch,
2542 struct bp_target_info *bp_tgt)
2544 /* This is kind of a weird case to handle, but the permission might
2545 have been changed after breakpoints were inserted - in which case
2546 we should just take the user literally and assume that any
2547 breakpoints should be left in place. */
2548 if (!may_insert_breakpoints)
2550 warning (_("May not remove breakpoints"));
2554 return current_target.to_remove_breakpoint (¤t_target,
2559 target_info (char *args, int from_tty)
2561 struct target_ops *t;
2562 int has_all_mem = 0;
2564 if (symfile_objfile != NULL)
2565 printf_unfiltered (_("Symbols from \"%s\".\n"),
2566 objfile_name (symfile_objfile));
2568 for (t = target_stack; t != NULL; t = t->beneath)
2570 if (!(*t->to_has_memory) (t))
2573 if ((int) (t->to_stratum) <= (int) dummy_stratum)
2576 printf_unfiltered (_("\tWhile running this, "
2577 "GDB does not access memory from...\n"));
2578 printf_unfiltered ("%s:\n", t->to_longname);
2579 (t->to_files_info) (t);
2580 has_all_mem = (*t->to_has_all_memory) (t);
2584 /* This function is called before any new inferior is created, e.g.
2585 by running a program, attaching, or connecting to a target.
2586 It cleans up any state from previous invocations which might
2587 change between runs. This is a subset of what target_preopen
2588 resets (things which might change between targets). */
2591 target_pre_inferior (int from_tty)
2593 /* Clear out solib state. Otherwise the solib state of the previous
2594 inferior might have survived and is entirely wrong for the new
2595 target. This has been observed on GNU/Linux using glibc 2.3. How
2607 Cannot access memory at address 0xdeadbeef
2610 /* In some OSs, the shared library list is the same/global/shared
2611 across inferiors. If code is shared between processes, so are
2612 memory regions and features. */
2613 if (!gdbarch_has_global_solist (target_gdbarch ()))
2615 no_shared_libraries (NULL, from_tty);
2617 invalidate_target_mem_regions ();
2619 target_clear_description ();
2622 agent_capability_invalidate ();
2625 /* Callback for iterate_over_inferiors. Gets rid of the given
2629 dispose_inferior (struct inferior *inf, void *args)
2631 struct thread_info *thread;
2633 thread = any_thread_of_process (inf->pid);
2636 switch_to_thread (thread->ptid);
2638 /* Core inferiors actually should be detached, not killed. */
2639 if (target_has_execution)
2642 target_detach (NULL, 0);
2648 /* This is to be called by the open routine before it does
2652 target_preopen (int from_tty)
2656 if (have_inferiors ())
2659 || !have_live_inferiors ()
2660 || query (_("A program is being debugged already. Kill it? ")))
2661 iterate_over_inferiors (dispose_inferior, NULL);
2663 error (_("Program not killed."));
2666 /* Calling target_kill may remove the target from the stack. But if
2667 it doesn't (which seems like a win for UDI), remove it now. */
2668 /* Leave the exec target, though. The user may be switching from a
2669 live process to a core of the same program. */
2670 pop_all_targets_above (file_stratum);
2672 target_pre_inferior (from_tty);
2675 /* Detach a target after doing deferred register stores. */
2678 target_detach (const char *args, int from_tty)
2680 struct target_ops* t;
2682 if (gdbarch_has_global_breakpoints (target_gdbarch ()))
2683 /* Don't remove global breakpoints here. They're removed on
2684 disconnection from the target. */
2687 /* If we're in breakpoints-always-inserted mode, have to remove
2688 them before detaching. */
2689 remove_breakpoints_pid (ptid_get_pid (inferior_ptid));
2691 prepare_for_detach ();
2693 for (t = current_target.beneath; t != NULL; t = t->beneath)
2695 if (t->to_detach != NULL)
2697 t->to_detach (t, args, from_tty);
2699 fprintf_unfiltered (gdb_stdlog, "target_detach (%s, %d)\n",
2705 internal_error (__FILE__, __LINE__, _("could not find a target to detach"));
2709 target_disconnect (char *args, int from_tty)
2711 struct target_ops *t;
2713 /* If we're in breakpoints-always-inserted mode or if breakpoints
2714 are global across processes, we have to remove them before
2716 remove_breakpoints ();
2718 for (t = current_target.beneath; t != NULL; t = t->beneath)
2719 if (t->to_disconnect != NULL)
2722 fprintf_unfiltered (gdb_stdlog, "target_disconnect (%s, %d)\n",
2724 t->to_disconnect (t, args, from_tty);
2732 target_wait (ptid_t ptid, struct target_waitstatus *status, int options)
2734 struct target_ops *t;
2735 ptid_t retval = (current_target.to_wait) (¤t_target, ptid,
2740 char *status_string;
2741 char *options_string;
2743 status_string = target_waitstatus_to_string (status);
2744 options_string = target_options_to_string (options);
2745 fprintf_unfiltered (gdb_stdlog,
2746 "target_wait (%d, status, options={%s})"
2748 ptid_get_pid (ptid), options_string,
2749 ptid_get_pid (retval), status_string);
2750 xfree (status_string);
2751 xfree (options_string);
2758 target_pid_to_str (ptid_t ptid)
2760 struct target_ops *t;
2762 for (t = current_target.beneath; t != NULL; t = t->beneath)
2764 if (t->to_pid_to_str != NULL)
2765 return (*t->to_pid_to_str) (t, ptid);
2768 return normal_pid_to_str (ptid);
2772 target_thread_name (struct thread_info *info)
2774 struct target_ops *t;
2776 for (t = current_target.beneath; t != NULL; t = t->beneath)
2778 if (t->to_thread_name != NULL)
2779 return (*t->to_thread_name) (t, info);
2786 target_resume (ptid_t ptid, int step, enum gdb_signal signal)
2788 struct target_ops *t;
2790 target_dcache_invalidate ();
2792 current_target.to_resume (¤t_target, ptid, step, signal);
2794 fprintf_unfiltered (gdb_stdlog, "target_resume (%d, %s, %s)\n",
2795 ptid_get_pid (ptid),
2796 step ? "step" : "continue",
2797 gdb_signal_to_name (signal));
2799 registers_changed_ptid (ptid);
2800 set_executing (ptid, 1);
2801 set_running (ptid, 1);
2802 clear_inline_frame_state (ptid);
2806 target_pass_signals (int numsigs, unsigned char *pass_signals)
2808 struct target_ops *t;
2810 for (t = current_target.beneath; t != NULL; t = t->beneath)
2812 if (t->to_pass_signals != NULL)
2818 fprintf_unfiltered (gdb_stdlog, "target_pass_signals (%d, {",
2821 for (i = 0; i < numsigs; i++)
2822 if (pass_signals[i])
2823 fprintf_unfiltered (gdb_stdlog, " %s",
2824 gdb_signal_to_name (i));
2826 fprintf_unfiltered (gdb_stdlog, " })\n");
2829 (*t->to_pass_signals) (t, numsigs, pass_signals);
2836 target_program_signals (int numsigs, unsigned char *program_signals)
2838 struct target_ops *t;
2840 for (t = current_target.beneath; t != NULL; t = t->beneath)
2842 if (t->to_program_signals != NULL)
2848 fprintf_unfiltered (gdb_stdlog, "target_program_signals (%d, {",
2851 for (i = 0; i < numsigs; i++)
2852 if (program_signals[i])
2853 fprintf_unfiltered (gdb_stdlog, " %s",
2854 gdb_signal_to_name (i));
2856 fprintf_unfiltered (gdb_stdlog, " })\n");
2859 (*t->to_program_signals) (t, numsigs, program_signals);
2865 /* Look through the list of possible targets for a target that can
2869 target_follow_fork (int follow_child, int detach_fork)
2871 struct target_ops *t;
2873 for (t = current_target.beneath; t != NULL; t = t->beneath)
2875 if (t->to_follow_fork != NULL)
2877 int retval = t->to_follow_fork (t, follow_child, detach_fork);
2880 fprintf_unfiltered (gdb_stdlog,
2881 "target_follow_fork (%d, %d) = %d\n",
2882 follow_child, detach_fork, retval);
2887 /* Some target returned a fork event, but did not know how to follow it. */
2888 internal_error (__FILE__, __LINE__,
2889 _("could not find a target to follow fork"));
2893 target_mourn_inferior (void)
2895 struct target_ops *t;
2897 for (t = current_target.beneath; t != NULL; t = t->beneath)
2899 if (t->to_mourn_inferior != NULL)
2901 t->to_mourn_inferior (t);
2903 fprintf_unfiltered (gdb_stdlog, "target_mourn_inferior ()\n");
2905 /* We no longer need to keep handles on any of the object files.
2906 Make sure to release them to avoid unnecessarily locking any
2907 of them while we're not actually debugging. */
2908 bfd_cache_close_all ();
2914 internal_error (__FILE__, __LINE__,
2915 _("could not find a target to follow mourn inferior"));
2918 /* Look for a target which can describe architectural features, starting
2919 from TARGET. If we find one, return its description. */
2921 const struct target_desc *
2922 target_read_description (struct target_ops *target)
2924 struct target_ops *t;
2926 for (t = target; t != NULL; t = t->beneath)
2927 if (t->to_read_description != NULL)
2929 const struct target_desc *tdesc;
2931 tdesc = t->to_read_description (t);
2939 /* The default implementation of to_search_memory.
2940 This implements a basic search of memory, reading target memory and
2941 performing the search here (as opposed to performing the search in on the
2942 target side with, for example, gdbserver). */
2945 simple_search_memory (struct target_ops *ops,
2946 CORE_ADDR start_addr, ULONGEST search_space_len,
2947 const gdb_byte *pattern, ULONGEST pattern_len,
2948 CORE_ADDR *found_addrp)
2950 /* NOTE: also defined in find.c testcase. */
2951 #define SEARCH_CHUNK_SIZE 16000
2952 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
2953 /* Buffer to hold memory contents for searching. */
2954 gdb_byte *search_buf;
2955 unsigned search_buf_size;
2956 struct cleanup *old_cleanups;
2958 search_buf_size = chunk_size + pattern_len - 1;
2960 /* No point in trying to allocate a buffer larger than the search space. */
2961 if (search_space_len < search_buf_size)
2962 search_buf_size = search_space_len;
2964 search_buf = malloc (search_buf_size);
2965 if (search_buf == NULL)
2966 error (_("Unable to allocate memory to perform the search."));
2967 old_cleanups = make_cleanup (free_current_contents, &search_buf);
2969 /* Prime the search buffer. */
2971 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2972 search_buf, start_addr, search_buf_size) != search_buf_size)
2974 warning (_("Unable to access %s bytes of target "
2975 "memory at %s, halting search."),
2976 pulongest (search_buf_size), hex_string (start_addr));
2977 do_cleanups (old_cleanups);
2981 /* Perform the search.
2983 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
2984 When we've scanned N bytes we copy the trailing bytes to the start and
2985 read in another N bytes. */
2987 while (search_space_len >= pattern_len)
2989 gdb_byte *found_ptr;
2990 unsigned nr_search_bytes = min (search_space_len, search_buf_size);
2992 found_ptr = memmem (search_buf, nr_search_bytes,
2993 pattern, pattern_len);
2995 if (found_ptr != NULL)
2997 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
2999 *found_addrp = found_addr;
3000 do_cleanups (old_cleanups);
3004 /* Not found in this chunk, skip to next chunk. */
3006 /* Don't let search_space_len wrap here, it's unsigned. */
3007 if (search_space_len >= chunk_size)
3008 search_space_len -= chunk_size;
3010 search_space_len = 0;
3012 if (search_space_len >= pattern_len)
3014 unsigned keep_len = search_buf_size - chunk_size;
3015 CORE_ADDR read_addr = start_addr + chunk_size + keep_len;
3018 /* Copy the trailing part of the previous iteration to the front
3019 of the buffer for the next iteration. */
3020 gdb_assert (keep_len == pattern_len - 1);
3021 memcpy (search_buf, search_buf + chunk_size, keep_len);
3023 nr_to_read = min (search_space_len - keep_len, chunk_size);
3025 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
3026 search_buf + keep_len, read_addr,
3027 nr_to_read) != nr_to_read)
3029 warning (_("Unable to access %s bytes of target "
3030 "memory at %s, halting search."),
3031 plongest (nr_to_read),
3032 hex_string (read_addr));
3033 do_cleanups (old_cleanups);
3037 start_addr += chunk_size;
3043 do_cleanups (old_cleanups);
3047 /* Search SEARCH_SPACE_LEN bytes beginning at START_ADDR for the
3048 sequence of bytes in PATTERN with length PATTERN_LEN.
3050 The result is 1 if found, 0 if not found, and -1 if there was an error
3051 requiring halting of the search (e.g. memory read error).
3052 If the pattern is found the address is recorded in FOUND_ADDRP. */
3055 target_search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
3056 const gdb_byte *pattern, ULONGEST pattern_len,
3057 CORE_ADDR *found_addrp)
3059 struct target_ops *t;
3062 /* We don't use INHERIT to set current_target.to_search_memory,
3063 so we have to scan the target stack and handle targetdebug
3067 fprintf_unfiltered (gdb_stdlog, "target_search_memory (%s, ...)\n",
3068 hex_string (start_addr));
3070 for (t = current_target.beneath; t != NULL; t = t->beneath)
3071 if (t->to_search_memory != NULL)
3076 found = t->to_search_memory (t, start_addr, search_space_len,
3077 pattern, pattern_len, found_addrp);
3081 /* If a special version of to_search_memory isn't available, use the
3083 found = simple_search_memory (current_target.beneath,
3084 start_addr, search_space_len,
3085 pattern, pattern_len, found_addrp);
3089 fprintf_unfiltered (gdb_stdlog, " = %d\n", found);
3094 /* Look through the currently pushed targets. If none of them will
3095 be able to restart the currently running process, issue an error
3099 target_require_runnable (void)
3101 struct target_ops *t;
3103 for (t = target_stack; t != NULL; t = t->beneath)
3105 /* If this target knows how to create a new program, then
3106 assume we will still be able to after killing the current
3107 one. Either killing and mourning will not pop T, or else
3108 find_default_run_target will find it again. */
3109 if (t->to_create_inferior != NULL)
3112 /* Do not worry about thread_stratum targets that can not
3113 create inferiors. Assume they will be pushed again if
3114 necessary, and continue to the process_stratum. */
3115 if (t->to_stratum == thread_stratum
3116 || t->to_stratum == arch_stratum)
3119 error (_("The \"%s\" target does not support \"run\". "
3120 "Try \"help target\" or \"continue\"."),
3124 /* This function is only called if the target is running. In that
3125 case there should have been a process_stratum target and it
3126 should either know how to create inferiors, or not... */
3127 internal_error (__FILE__, __LINE__, _("No targets found"));
3130 /* Look through the list of possible targets for a target that can
3131 execute a run or attach command without any other data. This is
3132 used to locate the default process stratum.
3134 If DO_MESG is not NULL, the result is always valid (error() is
3135 called for errors); else, return NULL on error. */
3137 static struct target_ops *
3138 find_default_run_target (char *do_mesg)
3140 struct target_ops **t;
3141 struct target_ops *runable = NULL;
3146 for (t = target_structs; t < target_structs + target_struct_size;
3149 if ((*t)->to_can_run && target_can_run (*t))
3159 error (_("Don't know how to %s. Try \"help target\"."), do_mesg);
3168 find_default_attach (struct target_ops *ops, char *args, int from_tty)
3170 struct target_ops *t;
3172 t = find_default_run_target ("attach");
3173 (t->to_attach) (t, args, from_tty);
3178 find_default_create_inferior (struct target_ops *ops,
3179 char *exec_file, char *allargs, char **env,
3182 struct target_ops *t;
3184 t = find_default_run_target ("run");
3185 (t->to_create_inferior) (t, exec_file, allargs, env, from_tty);
3190 find_default_can_async_p (struct target_ops *ignore)
3192 struct target_ops *t;
3194 /* This may be called before the target is pushed on the stack;
3195 look for the default process stratum. If there's none, gdb isn't
3196 configured with a native debugger, and target remote isn't
3198 t = find_default_run_target (NULL);
3199 if (t && t->to_can_async_p != delegate_can_async_p)
3200 return (t->to_can_async_p) (t);
3205 find_default_is_async_p (struct target_ops *ignore)
3207 struct target_ops *t;
3209 /* This may be called before the target is pushed on the stack;
3210 look for the default process stratum. If there's none, gdb isn't
3211 configured with a native debugger, and target remote isn't
3213 t = find_default_run_target (NULL);
3214 if (t && t->to_is_async_p != delegate_is_async_p)
3215 return (t->to_is_async_p) (t);
3220 find_default_supports_non_stop (struct target_ops *self)
3222 struct target_ops *t;
3224 t = find_default_run_target (NULL);
3225 if (t && t->to_supports_non_stop)
3226 return (t->to_supports_non_stop) (t);
3231 target_supports_non_stop (void)
3233 struct target_ops *t;
3235 for (t = ¤t_target; t != NULL; t = t->beneath)
3236 if (t->to_supports_non_stop)
3237 return t->to_supports_non_stop (t);
3242 /* Implement the "info proc" command. */
3245 target_info_proc (char *args, enum info_proc_what what)
3247 struct target_ops *t;
3249 /* If we're already connected to something that can get us OS
3250 related data, use it. Otherwise, try using the native
3252 if (current_target.to_stratum >= process_stratum)
3253 t = current_target.beneath;
3255 t = find_default_run_target (NULL);
3257 for (; t != NULL; t = t->beneath)
3259 if (t->to_info_proc != NULL)
3261 t->to_info_proc (t, args, what);
3264 fprintf_unfiltered (gdb_stdlog,
3265 "target_info_proc (\"%s\", %d)\n", args, what);
3275 find_default_supports_disable_randomization (struct target_ops *self)
3277 struct target_ops *t;
3279 t = find_default_run_target (NULL);
3280 if (t && t->to_supports_disable_randomization)
3281 return (t->to_supports_disable_randomization) (t);
3286 target_supports_disable_randomization (void)
3288 struct target_ops *t;
3290 for (t = ¤t_target; t != NULL; t = t->beneath)
3291 if (t->to_supports_disable_randomization)
3292 return t->to_supports_disable_randomization (t);
3298 target_get_osdata (const char *type)
3300 struct target_ops *t;
3302 /* If we're already connected to something that can get us OS
3303 related data, use it. Otherwise, try using the native
3305 if (current_target.to_stratum >= process_stratum)
3306 t = current_target.beneath;
3308 t = find_default_run_target ("get OS data");
3313 return target_read_stralloc (t, TARGET_OBJECT_OSDATA, type);
3316 /* Determine the current address space of thread PTID. */
3318 struct address_space *
3319 target_thread_address_space (ptid_t ptid)
3321 struct address_space *aspace;
3322 struct inferior *inf;
3323 struct target_ops *t;
3325 for (t = current_target.beneath; t != NULL; t = t->beneath)
3327 if (t->to_thread_address_space != NULL)
3329 aspace = t->to_thread_address_space (t, ptid);
3330 gdb_assert (aspace);
3333 fprintf_unfiltered (gdb_stdlog,
3334 "target_thread_address_space (%s) = %d\n",
3335 target_pid_to_str (ptid),
3336 address_space_num (aspace));
3341 /* Fall-back to the "main" address space of the inferior. */
3342 inf = find_inferior_pid (ptid_get_pid (ptid));
3344 if (inf == NULL || inf->aspace == NULL)
3345 internal_error (__FILE__, __LINE__,
3346 _("Can't determine the current "
3347 "address space of thread %s\n"),
3348 target_pid_to_str (ptid));
3354 /* Target file operations. */
3356 static struct target_ops *
3357 default_fileio_target (void)
3359 /* If we're already connected to something that can perform
3360 file I/O, use it. Otherwise, try using the native target. */
3361 if (current_target.to_stratum >= process_stratum)
3362 return current_target.beneath;
3364 return find_default_run_target ("file I/O");
3367 /* Open FILENAME on the target, using FLAGS and MODE. Return a
3368 target file descriptor, or -1 if an error occurs (and set
3371 target_fileio_open (const char *filename, int flags, int mode,
3374 struct target_ops *t;
3376 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3378 if (t->to_fileio_open != NULL)
3380 int fd = t->to_fileio_open (t, filename, flags, mode, target_errno);
3383 fprintf_unfiltered (gdb_stdlog,
3384 "target_fileio_open (%s,0x%x,0%o) = %d (%d)\n",
3385 filename, flags, mode,
3386 fd, fd != -1 ? 0 : *target_errno);
3391 *target_errno = FILEIO_ENOSYS;
3395 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
3396 Return the number of bytes written, or -1 if an error occurs
3397 (and set *TARGET_ERRNO). */
3399 target_fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
3400 ULONGEST offset, int *target_errno)
3402 struct target_ops *t;
3404 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3406 if (t->to_fileio_pwrite != NULL)
3408 int ret = t->to_fileio_pwrite (t, fd, write_buf, len, offset,
3412 fprintf_unfiltered (gdb_stdlog,
3413 "target_fileio_pwrite (%d,...,%d,%s) "
3415 fd, len, pulongest (offset),
3416 ret, ret != -1 ? 0 : *target_errno);
3421 *target_errno = FILEIO_ENOSYS;
3425 /* Read up to LEN bytes FD on the target into READ_BUF.
3426 Return the number of bytes read, or -1 if an error occurs
3427 (and set *TARGET_ERRNO). */
3429 target_fileio_pread (int fd, gdb_byte *read_buf, int len,
3430 ULONGEST offset, int *target_errno)
3432 struct target_ops *t;
3434 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3436 if (t->to_fileio_pread != NULL)
3438 int ret = t->to_fileio_pread (t, fd, read_buf, len, offset,
3442 fprintf_unfiltered (gdb_stdlog,
3443 "target_fileio_pread (%d,...,%d,%s) "
3445 fd, len, pulongest (offset),
3446 ret, ret != -1 ? 0 : *target_errno);
3451 *target_errno = FILEIO_ENOSYS;
3455 /* Close FD on the target. Return 0, or -1 if an error occurs
3456 (and set *TARGET_ERRNO). */
3458 target_fileio_close (int fd, int *target_errno)
3460 struct target_ops *t;
3462 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3464 if (t->to_fileio_close != NULL)
3466 int ret = t->to_fileio_close (t, fd, target_errno);
3469 fprintf_unfiltered (gdb_stdlog,
3470 "target_fileio_close (%d) = %d (%d)\n",
3471 fd, ret, ret != -1 ? 0 : *target_errno);
3476 *target_errno = FILEIO_ENOSYS;
3480 /* Unlink FILENAME on the target. Return 0, or -1 if an error
3481 occurs (and set *TARGET_ERRNO). */
3483 target_fileio_unlink (const char *filename, int *target_errno)
3485 struct target_ops *t;
3487 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3489 if (t->to_fileio_unlink != NULL)
3491 int ret = t->to_fileio_unlink (t, filename, target_errno);
3494 fprintf_unfiltered (gdb_stdlog,
3495 "target_fileio_unlink (%s) = %d (%d)\n",
3496 filename, ret, ret != -1 ? 0 : *target_errno);
3501 *target_errno = FILEIO_ENOSYS;
3505 /* Read value of symbolic link FILENAME on the target. Return a
3506 null-terminated string allocated via xmalloc, or NULL if an error
3507 occurs (and set *TARGET_ERRNO). */
3509 target_fileio_readlink (const char *filename, int *target_errno)
3511 struct target_ops *t;
3513 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3515 if (t->to_fileio_readlink != NULL)
3517 char *ret = t->to_fileio_readlink (t, filename, target_errno);
3520 fprintf_unfiltered (gdb_stdlog,
3521 "target_fileio_readlink (%s) = %s (%d)\n",
3522 filename, ret? ret : "(nil)",
3523 ret? 0 : *target_errno);
3528 *target_errno = FILEIO_ENOSYS;
3533 target_fileio_close_cleanup (void *opaque)
3535 int fd = *(int *) opaque;
3538 target_fileio_close (fd, &target_errno);
3541 /* Read target file FILENAME. Store the result in *BUF_P and
3542 return the size of the transferred data. PADDING additional bytes are
3543 available in *BUF_P. This is a helper function for
3544 target_fileio_read_alloc; see the declaration of that function for more
3548 target_fileio_read_alloc_1 (const char *filename,
3549 gdb_byte **buf_p, int padding)
3551 struct cleanup *close_cleanup;
3552 size_t buf_alloc, buf_pos;
3558 fd = target_fileio_open (filename, FILEIO_O_RDONLY, 0700, &target_errno);
3562 close_cleanup = make_cleanup (target_fileio_close_cleanup, &fd);
3564 /* Start by reading up to 4K at a time. The target will throttle
3565 this number down if necessary. */
3567 buf = xmalloc (buf_alloc);
3571 n = target_fileio_pread (fd, &buf[buf_pos],
3572 buf_alloc - buf_pos - padding, buf_pos,
3576 /* An error occurred. */
3577 do_cleanups (close_cleanup);
3583 /* Read all there was. */
3584 do_cleanups (close_cleanup);
3594 /* If the buffer is filling up, expand it. */
3595 if (buf_alloc < buf_pos * 2)
3598 buf = xrealloc (buf, buf_alloc);
3605 /* Read target file FILENAME. Store the result in *BUF_P and return
3606 the size of the transferred data. See the declaration in "target.h"
3607 function for more information about the return value. */
3610 target_fileio_read_alloc (const char *filename, gdb_byte **buf_p)
3612 return target_fileio_read_alloc_1 (filename, buf_p, 0);
3615 /* Read target file FILENAME. The result is NUL-terminated and
3616 returned as a string, allocated using xmalloc. If an error occurs
3617 or the transfer is unsupported, NULL is returned. Empty objects
3618 are returned as allocated but empty strings. A warning is issued
3619 if the result contains any embedded NUL bytes. */
3622 target_fileio_read_stralloc (const char *filename)
3626 LONGEST i, transferred;
3628 transferred = target_fileio_read_alloc_1 (filename, &buffer, 1);
3629 bufstr = (char *) buffer;
3631 if (transferred < 0)
3634 if (transferred == 0)
3635 return xstrdup ("");
3637 bufstr[transferred] = 0;
3639 /* Check for embedded NUL bytes; but allow trailing NULs. */
3640 for (i = strlen (bufstr); i < transferred; i++)
3643 warning (_("target file %s "
3644 "contained unexpected null characters"),
3654 default_region_ok_for_hw_watchpoint (struct target_ops *self,
3655 CORE_ADDR addr, int len)
3657 return (len <= gdbarch_ptr_bit (target_gdbarch ()) / TARGET_CHAR_BIT);
3661 default_watchpoint_addr_within_range (struct target_ops *target,
3663 CORE_ADDR start, int length)
3665 return addr >= start && addr < start + length;
3668 static struct gdbarch *
3669 default_thread_architecture (struct target_ops *ops, ptid_t ptid)
3671 return target_gdbarch ();
3687 return_minus_one (void)
3699 * Find the next target down the stack from the specified target.
3703 find_target_beneath (struct target_ops *t)
3711 find_target_at (enum strata stratum)
3713 struct target_ops *t;
3715 for (t = current_target.beneath; t != NULL; t = t->beneath)
3716 if (t->to_stratum == stratum)
3723 /* The inferior process has died. Long live the inferior! */
3726 generic_mourn_inferior (void)
3730 ptid = inferior_ptid;
3731 inferior_ptid = null_ptid;
3733 /* Mark breakpoints uninserted in case something tries to delete a
3734 breakpoint while we delete the inferior's threads (which would
3735 fail, since the inferior is long gone). */
3736 mark_breakpoints_out ();
3738 if (!ptid_equal (ptid, null_ptid))
3740 int pid = ptid_get_pid (ptid);
3741 exit_inferior (pid);
3744 /* Note this wipes step-resume breakpoints, so needs to be done
3745 after exit_inferior, which ends up referencing the step-resume
3746 breakpoints through clear_thread_inferior_resources. */
3747 breakpoint_init_inferior (inf_exited);
3749 registers_changed ();
3751 reopen_exec_file ();
3752 reinit_frame_cache ();
3754 if (deprecated_detach_hook)
3755 deprecated_detach_hook ();
3758 /* Convert a normal process ID to a string. Returns the string in a
3762 normal_pid_to_str (ptid_t ptid)
3764 static char buf[32];
3766 xsnprintf (buf, sizeof buf, "process %d", ptid_get_pid (ptid));
3771 dummy_pid_to_str (struct target_ops *ops, ptid_t ptid)
3773 return normal_pid_to_str (ptid);
3776 /* Error-catcher for target_find_memory_regions. */
3778 dummy_find_memory_regions (struct target_ops *self,
3779 find_memory_region_ftype ignore1, void *ignore2)
3781 error (_("Command not implemented for this target."));
3785 /* Error-catcher for target_make_corefile_notes. */
3787 dummy_make_corefile_notes (struct target_ops *self,
3788 bfd *ignore1, int *ignore2)
3790 error (_("Command not implemented for this target."));
3794 /* Error-catcher for target_get_bookmark. */
3796 dummy_get_bookmark (struct target_ops *self, char *ignore1, int ignore2)
3802 /* Error-catcher for target_goto_bookmark. */
3804 dummy_goto_bookmark (struct target_ops *self, gdb_byte *ignore, int from_tty)
3809 /* Set up the handful of non-empty slots needed by the dummy target
3813 init_dummy_target (void)
3815 dummy_target.to_shortname = "None";
3816 dummy_target.to_longname = "None";
3817 dummy_target.to_doc = "";
3818 dummy_target.to_attach = find_default_attach;
3819 dummy_target.to_detach =
3820 (void (*)(struct target_ops *, const char *, int))target_ignore;
3821 dummy_target.to_create_inferior = find_default_create_inferior;
3822 dummy_target.to_supports_non_stop = find_default_supports_non_stop;
3823 dummy_target.to_supports_disable_randomization
3824 = find_default_supports_disable_randomization;
3825 dummy_target.to_pid_to_str = dummy_pid_to_str;
3826 dummy_target.to_stratum = dummy_stratum;
3827 dummy_target.to_find_memory_regions = dummy_find_memory_regions;
3828 dummy_target.to_make_corefile_notes = dummy_make_corefile_notes;
3829 dummy_target.to_get_bookmark = dummy_get_bookmark;
3830 dummy_target.to_goto_bookmark = dummy_goto_bookmark;
3831 dummy_target.to_has_all_memory = (int (*) (struct target_ops *)) return_zero;
3832 dummy_target.to_has_memory = (int (*) (struct target_ops *)) return_zero;
3833 dummy_target.to_has_stack = (int (*) (struct target_ops *)) return_zero;
3834 dummy_target.to_has_registers = (int (*) (struct target_ops *)) return_zero;
3835 dummy_target.to_has_execution
3836 = (int (*) (struct target_ops *, ptid_t)) return_zero;
3837 dummy_target.to_magic = OPS_MAGIC;
3839 install_dummy_methods (&dummy_target);
3843 debug_to_open (char *args, int from_tty)
3845 debug_target.to_open (args, from_tty);
3847 fprintf_unfiltered (gdb_stdlog, "target_open (%s, %d)\n", args, from_tty);
3851 target_close (struct target_ops *targ)
3853 gdb_assert (!target_is_pushed (targ));
3855 if (targ->to_xclose != NULL)
3856 targ->to_xclose (targ);
3857 else if (targ->to_close != NULL)
3858 targ->to_close (targ);
3861 fprintf_unfiltered (gdb_stdlog, "target_close ()\n");
3865 target_attach (char *args, int from_tty)
3867 struct target_ops *t;
3869 for (t = current_target.beneath; t != NULL; t = t->beneath)
3871 if (t->to_attach != NULL)
3873 t->to_attach (t, args, from_tty);
3875 fprintf_unfiltered (gdb_stdlog, "target_attach (%s, %d)\n",
3881 internal_error (__FILE__, __LINE__,
3882 _("could not find a target to attach"));
3886 target_thread_alive (ptid_t ptid)
3888 struct target_ops *t;
3890 for (t = current_target.beneath; t != NULL; t = t->beneath)
3892 if (t->to_thread_alive != NULL)
3896 retval = t->to_thread_alive (t, ptid);
3898 fprintf_unfiltered (gdb_stdlog, "target_thread_alive (%d) = %d\n",
3899 ptid_get_pid (ptid), retval);
3909 target_find_new_threads (void)
3911 struct target_ops *t;
3913 for (t = current_target.beneath; t != NULL; t = t->beneath)
3915 if (t->to_find_new_threads != NULL)
3917 t->to_find_new_threads (t);
3919 fprintf_unfiltered (gdb_stdlog, "target_find_new_threads ()\n");
3927 target_stop (ptid_t ptid)
3931 warning (_("May not interrupt or stop the target, ignoring attempt"));
3935 (*current_target.to_stop) (¤t_target, ptid);
3939 debug_to_post_attach (struct target_ops *self, int pid)
3941 debug_target.to_post_attach (&debug_target, pid);
3943 fprintf_unfiltered (gdb_stdlog, "target_post_attach (%d)\n", pid);
3946 /* Concatenate ELEM to LIST, a comma separate list, and return the
3947 result. The LIST incoming argument is released. */
3950 str_comma_list_concat_elem (char *list, const char *elem)
3953 return xstrdup (elem);
3955 return reconcat (list, list, ", ", elem, (char *) NULL);
3958 /* Helper for target_options_to_string. If OPT is present in
3959 TARGET_OPTIONS, append the OPT_STR (string version of OPT) in RET.
3960 Returns the new resulting string. OPT is removed from
3964 do_option (int *target_options, char *ret,
3965 int opt, char *opt_str)
3967 if ((*target_options & opt) != 0)
3969 ret = str_comma_list_concat_elem (ret, opt_str);
3970 *target_options &= ~opt;
3977 target_options_to_string (int target_options)
3981 #define DO_TARG_OPTION(OPT) \
3982 ret = do_option (&target_options, ret, OPT, #OPT)
3984 DO_TARG_OPTION (TARGET_WNOHANG);
3986 if (target_options != 0)
3987 ret = str_comma_list_concat_elem (ret, "unknown???");
3995 debug_print_register (const char * func,
3996 struct regcache *regcache, int regno)
3998 struct gdbarch *gdbarch = get_regcache_arch (regcache);
4000 fprintf_unfiltered (gdb_stdlog, "%s ", func);
4001 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch)
4002 && gdbarch_register_name (gdbarch, regno) != NULL
4003 && gdbarch_register_name (gdbarch, regno)[0] != '\0')
4004 fprintf_unfiltered (gdb_stdlog, "(%s)",
4005 gdbarch_register_name (gdbarch, regno));
4007 fprintf_unfiltered (gdb_stdlog, "(%d)", regno);
4008 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch))
4010 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
4011 int i, size = register_size (gdbarch, regno);
4012 gdb_byte buf[MAX_REGISTER_SIZE];
4014 regcache_raw_collect (regcache, regno, buf);
4015 fprintf_unfiltered (gdb_stdlog, " = ");
4016 for (i = 0; i < size; i++)
4018 fprintf_unfiltered (gdb_stdlog, "%02x", buf[i]);
4020 if (size <= sizeof (LONGEST))
4022 ULONGEST val = extract_unsigned_integer (buf, size, byte_order);
4024 fprintf_unfiltered (gdb_stdlog, " %s %s",
4025 core_addr_to_string_nz (val), plongest (val));
4028 fprintf_unfiltered (gdb_stdlog, "\n");
4032 target_fetch_registers (struct regcache *regcache, int regno)
4034 struct target_ops *t;
4036 for (t = current_target.beneath; t != NULL; t = t->beneath)
4038 if (t->to_fetch_registers != NULL)
4040 t->to_fetch_registers (t, regcache, regno);
4042 debug_print_register ("target_fetch_registers", regcache, regno);
4049 target_store_registers (struct regcache *regcache, int regno)
4051 struct target_ops *t;
4053 if (!may_write_registers)
4054 error (_("Writing to registers is not allowed (regno %d)"), regno);
4056 current_target.to_store_registers (¤t_target, regcache, regno);
4059 debug_print_register ("target_store_registers", regcache, regno);
4064 target_core_of_thread (ptid_t ptid)
4066 struct target_ops *t;
4068 for (t = current_target.beneath; t != NULL; t = t->beneath)
4070 if (t->to_core_of_thread != NULL)
4072 int retval = t->to_core_of_thread (t, ptid);
4075 fprintf_unfiltered (gdb_stdlog,
4076 "target_core_of_thread (%d) = %d\n",
4077 ptid_get_pid (ptid), retval);
4086 target_verify_memory (const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
4088 struct target_ops *t;
4090 for (t = current_target.beneath; t != NULL; t = t->beneath)
4092 if (t->to_verify_memory != NULL)
4094 int retval = t->to_verify_memory (t, data, memaddr, size);
4097 fprintf_unfiltered (gdb_stdlog,
4098 "target_verify_memory (%s, %s) = %d\n",
4099 paddress (target_gdbarch (), memaddr),
4109 /* The documentation for this function is in its prototype declaration in
4113 target_insert_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
4115 struct target_ops *t;
4117 for (t = current_target.beneath; t != NULL; t = t->beneath)
4118 if (t->to_insert_mask_watchpoint != NULL)
4122 ret = t->to_insert_mask_watchpoint (t, addr, mask, rw);
4125 fprintf_unfiltered (gdb_stdlog, "\
4126 target_insert_mask_watchpoint (%s, %s, %d) = %d\n",
4127 core_addr_to_string (addr),
4128 core_addr_to_string (mask), rw, ret);
4136 /* The documentation for this function is in its prototype declaration in
4140 target_remove_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
4142 struct target_ops *t;
4144 for (t = current_target.beneath; t != NULL; t = t->beneath)
4145 if (t->to_remove_mask_watchpoint != NULL)
4149 ret = t->to_remove_mask_watchpoint (t, addr, mask, rw);
4152 fprintf_unfiltered (gdb_stdlog, "\
4153 target_remove_mask_watchpoint (%s, %s, %d) = %d\n",
4154 core_addr_to_string (addr),
4155 core_addr_to_string (mask), rw, ret);
4163 /* The documentation for this function is in its prototype declaration
4167 target_masked_watch_num_registers (CORE_ADDR addr, CORE_ADDR mask)
4169 struct target_ops *t;
4171 for (t = current_target.beneath; t != NULL; t = t->beneath)
4172 if (t->to_masked_watch_num_registers != NULL)
4173 return t->to_masked_watch_num_registers (t, addr, mask);
4178 /* The documentation for this function is in its prototype declaration
4182 target_ranged_break_num_registers (void)
4184 struct target_ops *t;
4186 for (t = current_target.beneath; t != NULL; t = t->beneath)
4187 if (t->to_ranged_break_num_registers != NULL)
4188 return t->to_ranged_break_num_registers (t);
4195 struct btrace_target_info *
4196 target_enable_btrace (ptid_t ptid)
4198 struct target_ops *t;
4200 for (t = current_target.beneath; t != NULL; t = t->beneath)
4201 if (t->to_enable_btrace != NULL)
4202 return t->to_enable_btrace (t, ptid);
4211 target_disable_btrace (struct btrace_target_info *btinfo)
4213 struct target_ops *t;
4215 for (t = current_target.beneath; t != NULL; t = t->beneath)
4216 if (t->to_disable_btrace != NULL)
4218 t->to_disable_btrace (t, btinfo);
4228 target_teardown_btrace (struct btrace_target_info *btinfo)
4230 struct target_ops *t;
4232 for (t = current_target.beneath; t != NULL; t = t->beneath)
4233 if (t->to_teardown_btrace != NULL)
4235 t->to_teardown_btrace (t, btinfo);
4245 target_read_btrace (VEC (btrace_block_s) **btrace,
4246 struct btrace_target_info *btinfo,
4247 enum btrace_read_type type)
4249 struct target_ops *t;
4251 for (t = current_target.beneath; t != NULL; t = t->beneath)
4252 if (t->to_read_btrace != NULL)
4253 return t->to_read_btrace (t, btrace, btinfo, type);
4256 return BTRACE_ERR_NOT_SUPPORTED;
4262 target_stop_recording (void)
4264 struct target_ops *t;
4266 for (t = current_target.beneath; t != NULL; t = t->beneath)
4267 if (t->to_stop_recording != NULL)
4269 t->to_stop_recording (t);
4273 /* This is optional. */
4279 target_info_record (void)
4281 struct target_ops *t;
4283 for (t = current_target.beneath; t != NULL; t = t->beneath)
4284 if (t->to_info_record != NULL)
4286 t->to_info_record (t);
4296 target_save_record (const char *filename)
4298 struct target_ops *t;
4300 for (t = current_target.beneath; t != NULL; t = t->beneath)
4301 if (t->to_save_record != NULL)
4303 t->to_save_record (t, filename);
4313 target_supports_delete_record (void)
4315 struct target_ops *t;
4317 for (t = current_target.beneath; t != NULL; t = t->beneath)
4318 if (t->to_delete_record != NULL)
4327 target_delete_record (void)
4329 struct target_ops *t;
4331 for (t = current_target.beneath; t != NULL; t = t->beneath)
4332 if (t->to_delete_record != NULL)
4334 t->to_delete_record (t);
4344 target_record_is_replaying (void)
4346 struct target_ops *t;
4348 for (t = current_target.beneath; t != NULL; t = t->beneath)
4349 if (t->to_record_is_replaying != NULL)
4350 return t->to_record_is_replaying (t);
4358 target_goto_record_begin (void)
4360 struct target_ops *t;
4362 for (t = current_target.beneath; t != NULL; t = t->beneath)
4363 if (t->to_goto_record_begin != NULL)
4365 t->to_goto_record_begin (t);
4375 target_goto_record_end (void)
4377 struct target_ops *t;
4379 for (t = current_target.beneath; t != NULL; t = t->beneath)
4380 if (t->to_goto_record_end != NULL)
4382 t->to_goto_record_end (t);
4392 target_goto_record (ULONGEST insn)
4394 struct target_ops *t;
4396 for (t = current_target.beneath; t != NULL; t = t->beneath)
4397 if (t->to_goto_record != NULL)
4399 t->to_goto_record (t, insn);
4409 target_insn_history (int size, int flags)
4411 struct target_ops *t;
4413 for (t = current_target.beneath; t != NULL; t = t->beneath)
4414 if (t->to_insn_history != NULL)
4416 t->to_insn_history (t, size, flags);
4426 target_insn_history_from (ULONGEST from, int size, int flags)
4428 struct target_ops *t;
4430 for (t = current_target.beneath; t != NULL; t = t->beneath)
4431 if (t->to_insn_history_from != NULL)
4433 t->to_insn_history_from (from, size, flags);
4443 target_insn_history_range (ULONGEST begin, ULONGEST end, int flags)
4445 struct target_ops *t;
4447 for (t = current_target.beneath; t != NULL; t = t->beneath)
4448 if (t->to_insn_history_range != NULL)
4450 t->to_insn_history_range (begin, end, flags);
4460 target_call_history (int size, int flags)
4462 struct target_ops *t;
4464 for (t = current_target.beneath; t != NULL; t = t->beneath)
4465 if (t->to_call_history != NULL)
4467 t->to_call_history (size, flags);
4477 target_call_history_from (ULONGEST begin, int size, int flags)
4479 struct target_ops *t;
4481 for (t = current_target.beneath; t != NULL; t = t->beneath)
4482 if (t->to_call_history_from != NULL)
4484 t->to_call_history_from (begin, size, flags);
4494 target_call_history_range (ULONGEST begin, ULONGEST end, int flags)
4496 struct target_ops *t;
4498 for (t = current_target.beneath; t != NULL; t = t->beneath)
4499 if (t->to_call_history_range != NULL)
4501 t->to_call_history_range (begin, end, flags);
4509 debug_to_prepare_to_store (struct target_ops *self, struct regcache *regcache)
4511 debug_target.to_prepare_to_store (&debug_target, regcache);
4513 fprintf_unfiltered (gdb_stdlog, "target_prepare_to_store ()\n");
4518 const struct frame_unwind *
4519 target_get_unwinder (void)
4521 struct target_ops *t;
4523 for (t = current_target.beneath; t != NULL; t = t->beneath)
4524 if (t->to_get_unwinder != NULL)
4525 return t->to_get_unwinder;
4532 const struct frame_unwind *
4533 target_get_tailcall_unwinder (void)
4535 struct target_ops *t;
4537 for (t = current_target.beneath; t != NULL; t = t->beneath)
4538 if (t->to_get_tailcall_unwinder != NULL)
4539 return t->to_get_tailcall_unwinder;
4547 forward_target_decr_pc_after_break (struct target_ops *ops,
4548 struct gdbarch *gdbarch)
4550 for (; ops != NULL; ops = ops->beneath)
4551 if (ops->to_decr_pc_after_break != NULL)
4552 return ops->to_decr_pc_after_break (ops, gdbarch);
4554 return gdbarch_decr_pc_after_break (gdbarch);
4560 target_decr_pc_after_break (struct gdbarch *gdbarch)
4562 return forward_target_decr_pc_after_break (current_target.beneath, gdbarch);
4566 deprecated_debug_xfer_memory (CORE_ADDR memaddr, bfd_byte *myaddr, int len,
4567 int write, struct mem_attrib *attrib,
4568 struct target_ops *target)
4572 retval = debug_target.deprecated_xfer_memory (memaddr, myaddr, len, write,
4575 fprintf_unfiltered (gdb_stdlog,
4576 "target_xfer_memory (%s, xxx, %d, %s, xxx) = %d",
4577 paddress (target_gdbarch (), memaddr), len,
4578 write ? "write" : "read", retval);
4584 fputs_unfiltered (", bytes =", gdb_stdlog);
4585 for (i = 0; i < retval; i++)
4587 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
4589 if (targetdebug < 2 && i > 0)
4591 fprintf_unfiltered (gdb_stdlog, " ...");
4594 fprintf_unfiltered (gdb_stdlog, "\n");
4597 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
4601 fputc_unfiltered ('\n', gdb_stdlog);
4607 debug_to_files_info (struct target_ops *target)
4609 debug_target.to_files_info (target);
4611 fprintf_unfiltered (gdb_stdlog, "target_files_info (xxx)\n");
4615 debug_to_insert_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
4616 struct bp_target_info *bp_tgt)
4620 retval = debug_target.to_insert_breakpoint (&debug_target, gdbarch, bp_tgt);
4622 fprintf_unfiltered (gdb_stdlog,
4623 "target_insert_breakpoint (%s, xxx) = %ld\n",
4624 core_addr_to_string (bp_tgt->placed_address),
4625 (unsigned long) retval);
4630 debug_to_remove_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
4631 struct bp_target_info *bp_tgt)
4635 retval = debug_target.to_remove_breakpoint (&debug_target, gdbarch, bp_tgt);
4637 fprintf_unfiltered (gdb_stdlog,
4638 "target_remove_breakpoint (%s, xxx) = %ld\n",
4639 core_addr_to_string (bp_tgt->placed_address),
4640 (unsigned long) retval);
4645 debug_to_can_use_hw_breakpoint (struct target_ops *self,
4646 int type, int cnt, int from_tty)
4650 retval = debug_target.to_can_use_hw_breakpoint (&debug_target,
4651 type, cnt, from_tty);
4653 fprintf_unfiltered (gdb_stdlog,
4654 "target_can_use_hw_breakpoint (%ld, %ld, %ld) = %ld\n",
4655 (unsigned long) type,
4656 (unsigned long) cnt,
4657 (unsigned long) from_tty,
4658 (unsigned long) retval);
4663 debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
4664 CORE_ADDR addr, int len)
4668 retval = debug_target.to_region_ok_for_hw_watchpoint (&debug_target,
4671 fprintf_unfiltered (gdb_stdlog,
4672 "target_region_ok_for_hw_watchpoint (%s, %ld) = %s\n",
4673 core_addr_to_string (addr), (unsigned long) len,
4674 core_addr_to_string (retval));
4679 debug_to_can_accel_watchpoint_condition (struct target_ops *self,
4680 CORE_ADDR addr, int len, int rw,
4681 struct expression *cond)
4685 retval = debug_target.to_can_accel_watchpoint_condition (&debug_target,
4689 fprintf_unfiltered (gdb_stdlog,
4690 "target_can_accel_watchpoint_condition "
4691 "(%s, %d, %d, %s) = %ld\n",
4692 core_addr_to_string (addr), len, rw,
4693 host_address_to_string (cond), (unsigned long) retval);
4698 debug_to_stopped_by_watchpoint (struct target_ops *ops)
4702 retval = debug_target.to_stopped_by_watchpoint (&debug_target);
4704 fprintf_unfiltered (gdb_stdlog,
4705 "target_stopped_by_watchpoint () = %ld\n",
4706 (unsigned long) retval);
4711 debug_to_stopped_data_address (struct target_ops *target, CORE_ADDR *addr)
4715 retval = debug_target.to_stopped_data_address (target, addr);
4717 fprintf_unfiltered (gdb_stdlog,
4718 "target_stopped_data_address ([%s]) = %ld\n",
4719 core_addr_to_string (*addr),
4720 (unsigned long)retval);
4725 debug_to_watchpoint_addr_within_range (struct target_ops *target,
4727 CORE_ADDR start, int length)
4731 retval = debug_target.to_watchpoint_addr_within_range (target, addr,
4734 fprintf_filtered (gdb_stdlog,
4735 "target_watchpoint_addr_within_range (%s, %s, %d) = %d\n",
4736 core_addr_to_string (addr), core_addr_to_string (start),
4742 debug_to_insert_hw_breakpoint (struct target_ops *self,
4743 struct gdbarch *gdbarch,
4744 struct bp_target_info *bp_tgt)
4748 retval = debug_target.to_insert_hw_breakpoint (&debug_target,
4751 fprintf_unfiltered (gdb_stdlog,
4752 "target_insert_hw_breakpoint (%s, xxx) = %ld\n",
4753 core_addr_to_string (bp_tgt->placed_address),
4754 (unsigned long) retval);
4759 debug_to_remove_hw_breakpoint (struct target_ops *self,
4760 struct gdbarch *gdbarch,
4761 struct bp_target_info *bp_tgt)
4765 retval = debug_target.to_remove_hw_breakpoint (&debug_target,
4768 fprintf_unfiltered (gdb_stdlog,
4769 "target_remove_hw_breakpoint (%s, xxx) = %ld\n",
4770 core_addr_to_string (bp_tgt->placed_address),
4771 (unsigned long) retval);
4776 debug_to_insert_watchpoint (struct target_ops *self,
4777 CORE_ADDR addr, int len, int type,
4778 struct expression *cond)
4782 retval = debug_target.to_insert_watchpoint (&debug_target,
4783 addr, len, type, cond);
4785 fprintf_unfiltered (gdb_stdlog,
4786 "target_insert_watchpoint (%s, %d, %d, %s) = %ld\n",
4787 core_addr_to_string (addr), len, type,
4788 host_address_to_string (cond), (unsigned long) retval);
4793 debug_to_remove_watchpoint (struct target_ops *self,
4794 CORE_ADDR addr, int len, int type,
4795 struct expression *cond)
4799 retval = debug_target.to_remove_watchpoint (&debug_target,
4800 addr, len, type, cond);
4802 fprintf_unfiltered (gdb_stdlog,
4803 "target_remove_watchpoint (%s, %d, %d, %s) = %ld\n",
4804 core_addr_to_string (addr), len, type,
4805 host_address_to_string (cond), (unsigned long) retval);
4810 debug_to_terminal_init (struct target_ops *self)
4812 debug_target.to_terminal_init (&debug_target);
4814 fprintf_unfiltered (gdb_stdlog, "target_terminal_init ()\n");
4818 debug_to_terminal_inferior (struct target_ops *self)
4820 debug_target.to_terminal_inferior (&debug_target);
4822 fprintf_unfiltered (gdb_stdlog, "target_terminal_inferior ()\n");
4826 debug_to_terminal_ours_for_output (struct target_ops *self)
4828 debug_target.to_terminal_ours_for_output (&debug_target);
4830 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours_for_output ()\n");
4834 debug_to_terminal_ours (struct target_ops *self)
4836 debug_target.to_terminal_ours (&debug_target);
4838 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours ()\n");
4842 debug_to_terminal_save_ours (struct target_ops *self)
4844 debug_target.to_terminal_save_ours (&debug_target);
4846 fprintf_unfiltered (gdb_stdlog, "target_terminal_save_ours ()\n");
4850 debug_to_terminal_info (struct target_ops *self,
4851 const char *arg, int from_tty)
4853 debug_target.to_terminal_info (&debug_target, arg, from_tty);
4855 fprintf_unfiltered (gdb_stdlog, "target_terminal_info (%s, %d)\n", arg,
4860 debug_to_load (struct target_ops *self, char *args, int from_tty)
4862 debug_target.to_load (&debug_target, args, from_tty);
4864 fprintf_unfiltered (gdb_stdlog, "target_load (%s, %d)\n", args, from_tty);
4868 debug_to_post_startup_inferior (struct target_ops *self, ptid_t ptid)
4870 debug_target.to_post_startup_inferior (&debug_target, ptid);
4872 fprintf_unfiltered (gdb_stdlog, "target_post_startup_inferior (%d)\n",
4873 ptid_get_pid (ptid));
4877 debug_to_insert_fork_catchpoint (struct target_ops *self, int pid)
4881 retval = debug_target.to_insert_fork_catchpoint (&debug_target, pid);
4883 fprintf_unfiltered (gdb_stdlog, "target_insert_fork_catchpoint (%d) = %d\n",
4890 debug_to_remove_fork_catchpoint (struct target_ops *self, int pid)
4894 retval = debug_target.to_remove_fork_catchpoint (&debug_target, pid);
4896 fprintf_unfiltered (gdb_stdlog, "target_remove_fork_catchpoint (%d) = %d\n",
4903 debug_to_insert_vfork_catchpoint (struct target_ops *self, int pid)
4907 retval = debug_target.to_insert_vfork_catchpoint (&debug_target, pid);
4909 fprintf_unfiltered (gdb_stdlog, "target_insert_vfork_catchpoint (%d) = %d\n",
4916 debug_to_remove_vfork_catchpoint (struct target_ops *self, int pid)
4920 retval = debug_target.to_remove_vfork_catchpoint (&debug_target, pid);
4922 fprintf_unfiltered (gdb_stdlog, "target_remove_vfork_catchpoint (%d) = %d\n",
4929 debug_to_insert_exec_catchpoint (struct target_ops *self, int pid)
4933 retval = debug_target.to_insert_exec_catchpoint (&debug_target, pid);
4935 fprintf_unfiltered (gdb_stdlog, "target_insert_exec_catchpoint (%d) = %d\n",
4942 debug_to_remove_exec_catchpoint (struct target_ops *self, int pid)
4946 retval = debug_target.to_remove_exec_catchpoint (&debug_target, pid);
4948 fprintf_unfiltered (gdb_stdlog, "target_remove_exec_catchpoint (%d) = %d\n",
4955 debug_to_has_exited (struct target_ops *self,
4956 int pid, int wait_status, int *exit_status)
4960 has_exited = debug_target.to_has_exited (&debug_target,
4961 pid, wait_status, exit_status);
4963 fprintf_unfiltered (gdb_stdlog, "target_has_exited (%d, %d, %d) = %d\n",
4964 pid, wait_status, *exit_status, has_exited);
4970 debug_to_can_run (struct target_ops *self)
4974 retval = debug_target.to_can_run (&debug_target);
4976 fprintf_unfiltered (gdb_stdlog, "target_can_run () = %d\n", retval);
4981 static struct gdbarch *
4982 debug_to_thread_architecture (struct target_ops *ops, ptid_t ptid)
4984 struct gdbarch *retval;
4986 retval = debug_target.to_thread_architecture (ops, ptid);
4988 fprintf_unfiltered (gdb_stdlog,
4989 "target_thread_architecture (%s) = %s [%s]\n",
4990 target_pid_to_str (ptid),
4991 host_address_to_string (retval),
4992 gdbarch_bfd_arch_info (retval)->printable_name);
4997 debug_to_stop (struct target_ops *self, ptid_t ptid)
4999 debug_target.to_stop (&debug_target, ptid);
5001 fprintf_unfiltered (gdb_stdlog, "target_stop (%s)\n",
5002 target_pid_to_str (ptid));
5006 debug_to_rcmd (struct target_ops *self, char *command,
5007 struct ui_file *outbuf)
5009 debug_target.to_rcmd (&debug_target, command, outbuf);
5010 fprintf_unfiltered (gdb_stdlog, "target_rcmd (%s, ...)\n", command);
5014 debug_to_pid_to_exec_file (struct target_ops *self, int pid)
5018 exec_file = debug_target.to_pid_to_exec_file (&debug_target, pid);
5020 fprintf_unfiltered (gdb_stdlog, "target_pid_to_exec_file (%d) = %s\n",
5027 setup_target_debug (void)
5029 memcpy (&debug_target, ¤t_target, sizeof debug_target);
5031 current_target.to_open = debug_to_open;
5032 current_target.to_post_attach = debug_to_post_attach;
5033 current_target.to_prepare_to_store = debug_to_prepare_to_store;
5034 current_target.deprecated_xfer_memory = deprecated_debug_xfer_memory;
5035 current_target.to_files_info = debug_to_files_info;
5036 current_target.to_insert_breakpoint = debug_to_insert_breakpoint;
5037 current_target.to_remove_breakpoint = debug_to_remove_breakpoint;
5038 current_target.to_can_use_hw_breakpoint = debug_to_can_use_hw_breakpoint;
5039 current_target.to_insert_hw_breakpoint = debug_to_insert_hw_breakpoint;
5040 current_target.to_remove_hw_breakpoint = debug_to_remove_hw_breakpoint;
5041 current_target.to_insert_watchpoint = debug_to_insert_watchpoint;
5042 current_target.to_remove_watchpoint = debug_to_remove_watchpoint;
5043 current_target.to_stopped_by_watchpoint = debug_to_stopped_by_watchpoint;
5044 current_target.to_stopped_data_address = debug_to_stopped_data_address;
5045 current_target.to_watchpoint_addr_within_range
5046 = debug_to_watchpoint_addr_within_range;
5047 current_target.to_region_ok_for_hw_watchpoint
5048 = debug_to_region_ok_for_hw_watchpoint;
5049 current_target.to_can_accel_watchpoint_condition
5050 = debug_to_can_accel_watchpoint_condition;
5051 current_target.to_terminal_init = debug_to_terminal_init;
5052 current_target.to_terminal_inferior = debug_to_terminal_inferior;
5053 current_target.to_terminal_ours_for_output
5054 = debug_to_terminal_ours_for_output;
5055 current_target.to_terminal_ours = debug_to_terminal_ours;
5056 current_target.to_terminal_save_ours = debug_to_terminal_save_ours;
5057 current_target.to_terminal_info = debug_to_terminal_info;
5058 current_target.to_load = debug_to_load;
5059 current_target.to_post_startup_inferior = debug_to_post_startup_inferior;
5060 current_target.to_insert_fork_catchpoint = debug_to_insert_fork_catchpoint;
5061 current_target.to_remove_fork_catchpoint = debug_to_remove_fork_catchpoint;
5062 current_target.to_insert_vfork_catchpoint = debug_to_insert_vfork_catchpoint;
5063 current_target.to_remove_vfork_catchpoint = debug_to_remove_vfork_catchpoint;
5064 current_target.to_insert_exec_catchpoint = debug_to_insert_exec_catchpoint;
5065 current_target.to_remove_exec_catchpoint = debug_to_remove_exec_catchpoint;
5066 current_target.to_has_exited = debug_to_has_exited;
5067 current_target.to_can_run = debug_to_can_run;
5068 current_target.to_stop = debug_to_stop;
5069 current_target.to_rcmd = debug_to_rcmd;
5070 current_target.to_pid_to_exec_file = debug_to_pid_to_exec_file;
5071 current_target.to_thread_architecture = debug_to_thread_architecture;
5075 static char targ_desc[] =
5076 "Names of targets and files being debugged.\nShows the entire \
5077 stack of targets currently in use (including the exec-file,\n\
5078 core-file, and process, if any), as well as the symbol file name.";
5081 do_monitor_command (char *cmd,
5084 if ((current_target.to_rcmd
5085 == (void (*) (struct target_ops *, char *, struct ui_file *)) tcomplain)
5086 || (current_target.to_rcmd == debug_to_rcmd
5087 && (debug_target.to_rcmd
5088 == (void (*) (struct target_ops *,
5089 char *, struct ui_file *)) tcomplain)))
5090 error (_("\"monitor\" command not supported by this target."));
5091 target_rcmd (cmd, gdb_stdtarg);
5094 /* Print the name of each layers of our target stack. */
5097 maintenance_print_target_stack (char *cmd, int from_tty)
5099 struct target_ops *t;
5101 printf_filtered (_("The current target stack is:\n"));
5103 for (t = target_stack; t != NULL; t = t->beneath)
5105 printf_filtered (" - %s (%s)\n", t->to_shortname, t->to_longname);
5109 /* Controls if async mode is permitted. */
5110 int target_async_permitted = 0;
5112 /* The set command writes to this variable. If the inferior is
5113 executing, target_async_permitted is *not* updated. */
5114 static int target_async_permitted_1 = 0;
5117 set_target_async_command (char *args, int from_tty,
5118 struct cmd_list_element *c)
5120 if (have_live_inferiors ())
5122 target_async_permitted_1 = target_async_permitted;
5123 error (_("Cannot change this setting while the inferior is running."));
5126 target_async_permitted = target_async_permitted_1;
5130 show_target_async_command (struct ui_file *file, int from_tty,
5131 struct cmd_list_element *c,
5134 fprintf_filtered (file,
5135 _("Controlling the inferior in "
5136 "asynchronous mode is %s.\n"), value);
5139 /* Temporary copies of permission settings. */
5141 static int may_write_registers_1 = 1;
5142 static int may_write_memory_1 = 1;
5143 static int may_insert_breakpoints_1 = 1;
5144 static int may_insert_tracepoints_1 = 1;
5145 static int may_insert_fast_tracepoints_1 = 1;
5146 static int may_stop_1 = 1;
5148 /* Make the user-set values match the real values again. */
5151 update_target_permissions (void)
5153 may_write_registers_1 = may_write_registers;
5154 may_write_memory_1 = may_write_memory;
5155 may_insert_breakpoints_1 = may_insert_breakpoints;
5156 may_insert_tracepoints_1 = may_insert_tracepoints;
5157 may_insert_fast_tracepoints_1 = may_insert_fast_tracepoints;
5158 may_stop_1 = may_stop;
5161 /* The one function handles (most of) the permission flags in the same
5165 set_target_permissions (char *args, int from_tty,
5166 struct cmd_list_element *c)
5168 if (target_has_execution)
5170 update_target_permissions ();
5171 error (_("Cannot change this setting while the inferior is running."));
5174 /* Make the real values match the user-changed values. */
5175 may_write_registers = may_write_registers_1;
5176 may_insert_breakpoints = may_insert_breakpoints_1;
5177 may_insert_tracepoints = may_insert_tracepoints_1;
5178 may_insert_fast_tracepoints = may_insert_fast_tracepoints_1;
5179 may_stop = may_stop_1;
5180 update_observer_mode ();
5183 /* Set memory write permission independently of observer mode. */
5186 set_write_memory_permission (char *args, int from_tty,
5187 struct cmd_list_element *c)
5189 /* Make the real values match the user-changed values. */
5190 may_write_memory = may_write_memory_1;
5191 update_observer_mode ();
5196 initialize_targets (void)
5198 init_dummy_target ();
5199 push_target (&dummy_target);
5201 add_info ("target", target_info, targ_desc);
5202 add_info ("files", target_info, targ_desc);
5204 add_setshow_zuinteger_cmd ("target", class_maintenance, &targetdebug, _("\
5205 Set target debugging."), _("\
5206 Show target debugging."), _("\
5207 When non-zero, target debugging is enabled. Higher numbers are more\n\
5208 verbose. Changes do not take effect until the next \"run\" or \"target\"\n\
5212 &setdebuglist, &showdebuglist);
5214 add_setshow_boolean_cmd ("trust-readonly-sections", class_support,
5215 &trust_readonly, _("\
5216 Set mode for reading from readonly sections."), _("\
5217 Show mode for reading from readonly sections."), _("\
5218 When this mode is on, memory reads from readonly sections (such as .text)\n\
5219 will be read from the object file instead of from the target. This will\n\
5220 result in significant performance improvement for remote targets."),
5222 show_trust_readonly,
5223 &setlist, &showlist);
5225 add_com ("monitor", class_obscure, do_monitor_command,
5226 _("Send a command to the remote monitor (remote targets only)."));
5228 add_cmd ("target-stack", class_maintenance, maintenance_print_target_stack,
5229 _("Print the name of each layer of the internal target stack."),
5230 &maintenanceprintlist);
5232 add_setshow_boolean_cmd ("target-async", no_class,
5233 &target_async_permitted_1, _("\
5234 Set whether gdb controls the inferior in asynchronous mode."), _("\
5235 Show whether gdb controls the inferior in asynchronous mode."), _("\
5236 Tells gdb whether to control the inferior in asynchronous mode."),
5237 set_target_async_command,
5238 show_target_async_command,
5242 add_setshow_boolean_cmd ("may-write-registers", class_support,
5243 &may_write_registers_1, _("\
5244 Set permission to write into registers."), _("\
5245 Show permission to write into registers."), _("\
5246 When this permission is on, GDB may write into the target's registers.\n\
5247 Otherwise, any sort of write attempt will result in an error."),
5248 set_target_permissions, NULL,
5249 &setlist, &showlist);
5251 add_setshow_boolean_cmd ("may-write-memory", class_support,
5252 &may_write_memory_1, _("\
5253 Set permission to write into target memory."), _("\
5254 Show permission to write into target memory."), _("\
5255 When this permission is on, GDB may write into the target's memory.\n\
5256 Otherwise, any sort of write attempt will result in an error."),
5257 set_write_memory_permission, NULL,
5258 &setlist, &showlist);
5260 add_setshow_boolean_cmd ("may-insert-breakpoints", class_support,
5261 &may_insert_breakpoints_1, _("\
5262 Set permission to insert breakpoints in the target."), _("\
5263 Show permission to insert breakpoints in the target."), _("\
5264 When this permission is on, GDB may insert breakpoints in the program.\n\
5265 Otherwise, any sort of insertion attempt will result in an error."),
5266 set_target_permissions, NULL,
5267 &setlist, &showlist);
5269 add_setshow_boolean_cmd ("may-insert-tracepoints", class_support,
5270 &may_insert_tracepoints_1, _("\
5271 Set permission to insert tracepoints in the target."), _("\
5272 Show permission to insert tracepoints in the target."), _("\
5273 When this permission is on, GDB may insert tracepoints in the program.\n\
5274 Otherwise, any sort of insertion attempt will result in an error."),
5275 set_target_permissions, NULL,
5276 &setlist, &showlist);
5278 add_setshow_boolean_cmd ("may-insert-fast-tracepoints", class_support,
5279 &may_insert_fast_tracepoints_1, _("\
5280 Set permission to insert fast tracepoints in the target."), _("\
5281 Show permission to insert fast tracepoints in the target."), _("\
5282 When this permission is on, GDB may insert fast tracepoints.\n\
5283 Otherwise, any sort of insertion attempt will result in an error."),
5284 set_target_permissions, NULL,
5285 &setlist, &showlist);
5287 add_setshow_boolean_cmd ("may-interrupt", class_support,
5289 Set permission to interrupt or signal the target."), _("\
5290 Show permission to interrupt or signal the target."), _("\
5291 When this permission is on, GDB may interrupt/stop the target's execution.\n\
5292 Otherwise, any attempt to interrupt or stop will be ignored."),
5293 set_target_permissions, NULL,
5294 &setlist, &showlist);