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 default_rcmd (struct target_ops *, char *, struct ui_file *);
60 static ptid_t default_get_ada_task_ptid (struct target_ops *self,
63 static void tcomplain (void) ATTRIBUTE_NORETURN;
65 static int nomemory (CORE_ADDR, char *, int, int, struct target_ops *);
67 static int return_zero (void);
69 static int return_minus_one (void);
71 static void *return_null (void);
73 void target_ignore (void);
75 static void target_command (char *, int);
77 static struct target_ops *find_default_run_target (char *);
79 static target_xfer_partial_ftype default_xfer_partial;
81 static struct gdbarch *default_thread_architecture (struct target_ops *ops,
84 static int dummy_find_memory_regions (struct target_ops *self,
85 find_memory_region_ftype ignore1,
88 static char *dummy_make_corefile_notes (struct target_ops *self,
89 bfd *ignore1, int *ignore2);
91 static int find_default_can_async_p (struct target_ops *ignore);
93 static int find_default_is_async_p (struct target_ops *ignore);
95 static enum exec_direction_kind default_execution_direction
96 (struct target_ops *self);
98 #include "target-delegates.c"
100 static void init_dummy_target (void);
102 static struct target_ops debug_target;
104 static void debug_to_open (char *, int);
106 static void debug_to_prepare_to_store (struct target_ops *self,
109 static void debug_to_files_info (struct target_ops *);
111 static int debug_to_insert_breakpoint (struct target_ops *, struct gdbarch *,
112 struct bp_target_info *);
114 static int debug_to_remove_breakpoint (struct target_ops *, struct gdbarch *,
115 struct bp_target_info *);
117 static int debug_to_can_use_hw_breakpoint (struct target_ops *self,
120 static int debug_to_insert_hw_breakpoint (struct target_ops *self,
122 struct bp_target_info *);
124 static int debug_to_remove_hw_breakpoint (struct target_ops *self,
126 struct bp_target_info *);
128 static int debug_to_insert_watchpoint (struct target_ops *self,
130 struct expression *);
132 static int debug_to_remove_watchpoint (struct target_ops *self,
134 struct expression *);
136 static int debug_to_stopped_data_address (struct target_ops *, CORE_ADDR *);
138 static int debug_to_watchpoint_addr_within_range (struct target_ops *,
139 CORE_ADDR, CORE_ADDR, int);
141 static int debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
144 static int debug_to_can_accel_watchpoint_condition (struct target_ops *self,
146 struct expression *);
148 static void debug_to_terminal_init (struct target_ops *self);
150 static void debug_to_terminal_inferior (struct target_ops *self);
152 static void debug_to_terminal_ours_for_output (struct target_ops *self);
154 static void debug_to_terminal_save_ours (struct target_ops *self);
156 static void debug_to_terminal_ours (struct target_ops *self);
158 static void debug_to_load (struct target_ops *self, char *, int);
160 static int debug_to_can_run (struct target_ops *self);
162 static void debug_to_stop (struct target_ops *self, ptid_t);
164 /* Pointer to array of target architecture structures; the size of the
165 array; the current index into the array; the allocated size of the
167 struct target_ops **target_structs;
168 unsigned target_struct_size;
169 unsigned target_struct_allocsize;
170 #define DEFAULT_ALLOCSIZE 10
172 /* The initial current target, so that there is always a semi-valid
175 static struct target_ops dummy_target;
177 /* Top of target stack. */
179 static struct target_ops *target_stack;
181 /* The target structure we are currently using to talk to a process
182 or file or whatever "inferior" we have. */
184 struct target_ops current_target;
186 /* Command list for target. */
188 static struct cmd_list_element *targetlist = NULL;
190 /* Nonzero if we should trust readonly sections from the
191 executable when reading memory. */
193 static int trust_readonly = 0;
195 /* Nonzero if we should show true memory content including
196 memory breakpoint inserted by gdb. */
198 static int show_memory_breakpoints = 0;
200 /* These globals control whether GDB attempts to perform these
201 operations; they are useful for targets that need to prevent
202 inadvertant disruption, such as in non-stop mode. */
204 int may_write_registers = 1;
206 int may_write_memory = 1;
208 int may_insert_breakpoints = 1;
210 int may_insert_tracepoints = 1;
212 int may_insert_fast_tracepoints = 1;
216 /* Non-zero if we want to see trace of target level stuff. */
218 static unsigned int targetdebug = 0;
220 show_targetdebug (struct ui_file *file, int from_tty,
221 struct cmd_list_element *c, const char *value)
223 fprintf_filtered (file, _("Target debugging is %s.\n"), value);
226 static void setup_target_debug (void);
228 /* The user just typed 'target' without the name of a target. */
231 target_command (char *arg, int from_tty)
233 fputs_filtered ("Argument required (target name). Try `help target'\n",
237 /* Default target_has_* methods for process_stratum targets. */
240 default_child_has_all_memory (struct target_ops *ops)
242 /* If no inferior selected, then we can't read memory here. */
243 if (ptid_equal (inferior_ptid, null_ptid))
250 default_child_has_memory (struct target_ops *ops)
252 /* If no inferior selected, then we can't read memory here. */
253 if (ptid_equal (inferior_ptid, null_ptid))
260 default_child_has_stack (struct target_ops *ops)
262 /* If no inferior selected, there's no stack. */
263 if (ptid_equal (inferior_ptid, null_ptid))
270 default_child_has_registers (struct target_ops *ops)
272 /* Can't read registers from no inferior. */
273 if (ptid_equal (inferior_ptid, null_ptid))
280 default_child_has_execution (struct target_ops *ops, ptid_t the_ptid)
282 /* If there's no thread selected, then we can't make it run through
284 if (ptid_equal (the_ptid, null_ptid))
292 target_has_all_memory_1 (void)
294 struct target_ops *t;
296 for (t = current_target.beneath; t != NULL; t = t->beneath)
297 if (t->to_has_all_memory (t))
304 target_has_memory_1 (void)
306 struct target_ops *t;
308 for (t = current_target.beneath; t != NULL; t = t->beneath)
309 if (t->to_has_memory (t))
316 target_has_stack_1 (void)
318 struct target_ops *t;
320 for (t = current_target.beneath; t != NULL; t = t->beneath)
321 if (t->to_has_stack (t))
328 target_has_registers_1 (void)
330 struct target_ops *t;
332 for (t = current_target.beneath; t != NULL; t = t->beneath)
333 if (t->to_has_registers (t))
340 target_has_execution_1 (ptid_t the_ptid)
342 struct target_ops *t;
344 for (t = current_target.beneath; t != NULL; t = t->beneath)
345 if (t->to_has_execution (t, the_ptid))
352 target_has_execution_current (void)
354 return target_has_execution_1 (inferior_ptid);
357 /* Complete initialization of T. This ensures that various fields in
358 T are set, if needed by the target implementation. */
361 complete_target_initialization (struct target_ops *t)
363 /* Provide default values for all "must have" methods. */
364 if (t->to_xfer_partial == NULL)
365 t->to_xfer_partial = default_xfer_partial;
367 if (t->to_has_all_memory == NULL)
368 t->to_has_all_memory = (int (*) (struct target_ops *)) return_zero;
370 if (t->to_has_memory == NULL)
371 t->to_has_memory = (int (*) (struct target_ops *)) return_zero;
373 if (t->to_has_stack == NULL)
374 t->to_has_stack = (int (*) (struct target_ops *)) return_zero;
376 if (t->to_has_registers == NULL)
377 t->to_has_registers = (int (*) (struct target_ops *)) return_zero;
379 if (t->to_has_execution == NULL)
380 t->to_has_execution = (int (*) (struct target_ops *, ptid_t)) return_zero;
382 install_delegators (t);
385 /* Add possible target architecture T to the list and add a new
386 command 'target T->to_shortname'. Set COMPLETER as the command's
387 completer if not NULL. */
390 add_target_with_completer (struct target_ops *t,
391 completer_ftype *completer)
393 struct cmd_list_element *c;
395 complete_target_initialization (t);
399 target_struct_allocsize = DEFAULT_ALLOCSIZE;
400 target_structs = (struct target_ops **) xmalloc
401 (target_struct_allocsize * sizeof (*target_structs));
403 if (target_struct_size >= target_struct_allocsize)
405 target_struct_allocsize *= 2;
406 target_structs = (struct target_ops **)
407 xrealloc ((char *) target_structs,
408 target_struct_allocsize * sizeof (*target_structs));
410 target_structs[target_struct_size++] = t;
412 if (targetlist == NULL)
413 add_prefix_cmd ("target", class_run, target_command, _("\
414 Connect to a target machine or process.\n\
415 The first argument is the type or protocol of the target machine.\n\
416 Remaining arguments are interpreted by the target protocol. For more\n\
417 information on the arguments for a particular protocol, type\n\
418 `help target ' followed by the protocol name."),
419 &targetlist, "target ", 0, &cmdlist);
420 c = add_cmd (t->to_shortname, no_class, t->to_open, t->to_doc,
422 if (completer != NULL)
423 set_cmd_completer (c, completer);
426 /* Add a possible target architecture to the list. */
429 add_target (struct target_ops *t)
431 add_target_with_completer (t, NULL);
437 add_deprecated_target_alias (struct target_ops *t, char *alias)
439 struct cmd_list_element *c;
442 /* If we use add_alias_cmd, here, we do not get the deprecated warning,
444 c = add_cmd (alias, no_class, t->to_open, t->to_doc, &targetlist);
445 alt = xstrprintf ("target %s", t->to_shortname);
446 deprecate_cmd (c, alt);
459 struct target_ops *t;
461 for (t = current_target.beneath; t != NULL; t = t->beneath)
462 if (t->to_kill != NULL)
465 fprintf_unfiltered (gdb_stdlog, "target_kill ()\n");
475 target_load (char *arg, int from_tty)
477 target_dcache_invalidate ();
478 (*current_target.to_load) (¤t_target, arg, from_tty);
482 target_create_inferior (char *exec_file, char *args,
483 char **env, int from_tty)
485 struct target_ops *t;
487 for (t = current_target.beneath; t != NULL; t = t->beneath)
489 if (t->to_create_inferior != NULL)
491 t->to_create_inferior (t, exec_file, args, env, from_tty);
493 fprintf_unfiltered (gdb_stdlog,
494 "target_create_inferior (%s, %s, xxx, %d)\n",
495 exec_file, args, from_tty);
500 internal_error (__FILE__, __LINE__,
501 _("could not find a target to create inferior"));
505 target_terminal_inferior (void)
507 /* A background resume (``run&'') should leave GDB in control of the
508 terminal. Use target_can_async_p, not target_is_async_p, since at
509 this point the target is not async yet. However, if sync_execution
510 is not set, we know it will become async prior to resume. */
511 if (target_can_async_p () && !sync_execution)
514 /* If GDB is resuming the inferior in the foreground, install
515 inferior's terminal modes. */
516 (*current_target.to_terminal_inferior) (¤t_target);
520 nomemory (CORE_ADDR memaddr, char *myaddr, int len, int write,
521 struct target_ops *t)
523 errno = EIO; /* Can't read/write this location. */
524 return 0; /* No bytes handled. */
530 error (_("You can't do that when your target is `%s'"),
531 current_target.to_shortname);
537 error (_("You can't do that without a process to debug."));
541 default_terminal_info (struct target_ops *self, const char *args, int from_tty)
543 printf_unfiltered (_("No saved terminal information.\n"));
546 /* A default implementation for the to_get_ada_task_ptid target method.
548 This function builds the PTID by using both LWP and TID as part of
549 the PTID lwp and tid elements. The pid used is the pid of the
553 default_get_ada_task_ptid (struct target_ops *self, long lwp, long tid)
555 return ptid_build (ptid_get_pid (inferior_ptid), lwp, tid);
558 static enum exec_direction_kind
559 default_execution_direction (struct target_ops *self)
561 if (!target_can_execute_reverse)
563 else if (!target_can_async_p ())
566 gdb_assert_not_reached ("\
567 to_execution_direction must be implemented for reverse async");
570 /* Go through the target stack from top to bottom, copying over zero
571 entries in current_target, then filling in still empty entries. In
572 effect, we are doing class inheritance through the pushed target
575 NOTE: cagney/2003-10-17: The problem with this inheritance, as it
576 is currently implemented, is that it discards any knowledge of
577 which target an inherited method originally belonged to.
578 Consequently, new new target methods should instead explicitly and
579 locally search the target stack for the target that can handle the
583 update_current_target (void)
585 struct target_ops *t;
587 /* First, reset current's contents. */
588 memset (¤t_target, 0, sizeof (current_target));
590 /* Install the delegators. */
591 install_delegators (¤t_target);
593 #define INHERIT(FIELD, TARGET) \
594 if (!current_target.FIELD) \
595 current_target.FIELD = (TARGET)->FIELD
597 for (t = target_stack; t; t = t->beneath)
599 INHERIT (to_shortname, t);
600 INHERIT (to_longname, t);
602 /* Do not inherit to_open. */
603 /* Do not inherit to_close. */
604 /* Do not inherit to_attach. */
605 /* Do not inherit to_post_attach. */
606 INHERIT (to_attach_no_wait, t);
607 /* Do not inherit to_detach. */
608 /* Do not inherit to_disconnect. */
609 /* Do not inherit to_resume. */
610 /* Do not inherit to_wait. */
611 /* Do not inherit to_fetch_registers. */
612 /* Do not inherit to_store_registers. */
613 /* Do not inherit to_prepare_to_store. */
614 INHERIT (deprecated_xfer_memory, t);
615 /* Do not inherit to_files_info. */
616 /* Do not inherit to_insert_breakpoint. */
617 /* Do not inherit to_remove_breakpoint. */
618 /* Do not inherit to_can_use_hw_breakpoint. */
619 /* Do not inherit to_insert_hw_breakpoint. */
620 /* Do not inherit to_remove_hw_breakpoint. */
621 /* Do not inherit to_ranged_break_num_registers. */
622 /* Do not inherit to_insert_watchpoint. */
623 /* Do not inherit to_remove_watchpoint. */
624 /* Do not inherit to_insert_mask_watchpoint. */
625 /* Do not inherit to_remove_mask_watchpoint. */
626 /* Do not inherit to_stopped_data_address. */
627 INHERIT (to_have_steppable_watchpoint, t);
628 INHERIT (to_have_continuable_watchpoint, t);
629 /* Do not inherit to_stopped_by_watchpoint. */
630 /* Do not inherit to_watchpoint_addr_within_range. */
631 /* Do not inherit to_region_ok_for_hw_watchpoint. */
632 /* Do not inherit to_can_accel_watchpoint_condition. */
633 /* Do not inherit to_masked_watch_num_registers. */
634 /* Do not inherit to_terminal_init. */
635 /* Do not inherit to_terminal_inferior. */
636 /* Do not inherit to_terminal_ours_for_output. */
637 /* Do not inherit to_terminal_ours. */
638 /* Do not inherit to_terminal_save_ours. */
639 /* Do not inherit to_terminal_info. */
640 /* Do not inherit to_kill. */
641 /* Do not inherit to_load. */
642 /* Do no inherit to_create_inferior. */
643 /* Do not inherit to_post_startup_inferior. */
644 /* Do not inherit to_insert_fork_catchpoint. */
645 /* Do not inherit to_remove_fork_catchpoint. */
646 /* Do not inherit to_insert_vfork_catchpoint. */
647 /* Do not inherit to_remove_vfork_catchpoint. */
648 /* Do not inherit to_follow_fork. */
649 /* Do not inherit to_insert_exec_catchpoint. */
650 /* Do not inherit to_remove_exec_catchpoint. */
651 /* Do not inherit to_set_syscall_catchpoint. */
652 /* Do not inherit to_has_exited. */
653 /* Do not inherit to_mourn_inferior. */
654 INHERIT (to_can_run, t);
655 /* Do not inherit to_pass_signals. */
656 /* Do not inherit to_program_signals. */
657 /* Do not inherit to_thread_alive. */
658 /* Do not inherit to_find_new_threads. */
659 /* Do not inherit to_pid_to_str. */
660 /* Do not inherit to_extra_thread_info. */
661 /* Do not inherit to_thread_name. */
662 INHERIT (to_stop, t);
663 /* Do not inherit to_xfer_partial. */
664 /* Do not inherit to_rcmd. */
665 /* Do not inherit to_pid_to_exec_file. */
666 /* Do not inherit to_log_command. */
667 INHERIT (to_stratum, t);
668 /* Do not inherit to_has_all_memory. */
669 /* Do not inherit to_has_memory. */
670 /* Do not inherit to_has_stack. */
671 /* Do not inherit to_has_registers. */
672 /* Do not inherit to_has_execution. */
673 INHERIT (to_has_thread_control, t);
674 /* Do not inherit to_can_async_p. */
675 /* Do not inherit to_is_async_p. */
676 /* Do not inherit to_async. */
677 /* Do not inherit to_find_memory_regions. */
678 /* Do not inherit to_make_corefile_notes. */
679 /* Do not inherit to_get_bookmark. */
680 /* Do not inherit to_goto_bookmark. */
681 /* Do not inherit to_get_thread_local_address. */
682 /* Do not inherit to_can_execute_reverse. */
683 /* Do not inherit to_execution_direction. */
684 /* Do not inherit to_thread_architecture. */
685 /* Do not inherit to_read_description. */
686 /* Do not inherit to_get_ada_task_ptid. */
687 /* Do not inherit to_search_memory. */
688 /* Do not inherit to_supports_multi_process. */
689 /* Do not inherit to_supports_enable_disable_tracepoint. */
690 /* Do not inherit to_supports_string_tracing. */
691 /* Do not inherit to_trace_init. */
692 /* Do not inherit to_download_tracepoint. */
693 /* Do not inherit to_can_download_tracepoint. */
694 /* Do not inherit to_download_trace_state_variable. */
695 /* Do not inherit to_enable_tracepoint. */
696 /* Do not inherit to_disable_tracepoint. */
697 /* Do not inherit to_trace_set_readonly_regions. */
698 /* Do not inherit to_trace_start. */
699 /* Do not inherit to_get_trace_status. */
700 /* Do not inherit to_get_tracepoint_status. */
701 /* Do not inherit to_trace_stop. */
702 /* Do not inherit to_trace_find. */
703 /* Do not inherit to_get_trace_state_variable_value. */
704 /* Do not inherit to_save_trace_data. */
705 /* Do not inherit to_upload_tracepoints. */
706 /* Do not inherit to_upload_trace_state_variables. */
707 INHERIT (to_get_raw_trace_data, t);
708 INHERIT (to_get_min_fast_tracepoint_insn_len, t);
709 INHERIT (to_set_disconnected_tracing, t);
710 INHERIT (to_set_circular_trace_buffer, t);
711 INHERIT (to_set_trace_buffer_size, t);
712 INHERIT (to_set_trace_notes, t);
713 INHERIT (to_get_tib_address, t);
714 INHERIT (to_set_permissions, t);
715 INHERIT (to_static_tracepoint_marker_at, t);
716 INHERIT (to_static_tracepoint_markers_by_strid, t);
717 INHERIT (to_traceframe_info, t);
718 INHERIT (to_use_agent, t);
719 INHERIT (to_can_use_agent, t);
720 INHERIT (to_augmented_libraries_svr4_read, t);
721 INHERIT (to_magic, t);
722 INHERIT (to_supports_evaluation_of_breakpoint_conditions, t);
723 INHERIT (to_can_run_breakpoint_commands, t);
724 /* Do not inherit to_memory_map. */
725 /* Do not inherit to_flash_erase. */
726 /* Do not inherit to_flash_done. */
730 /* Clean up a target struct so it no longer has any zero pointers in
731 it. Some entries are defaulted to a method that print an error,
732 others are hard-wired to a standard recursive default. */
734 #define de_fault(field, value) \
735 if (!current_target.field) \
736 current_target.field = value
739 (void (*) (char *, int))
742 (void (*) (struct target_ops *))
744 de_fault (deprecated_xfer_memory,
745 (int (*) (CORE_ADDR, gdb_byte *, int, int,
746 struct mem_attrib *, struct target_ops *))
748 de_fault (to_can_run,
749 (int (*) (struct target_ops *))
752 (void (*) (struct target_ops *, ptid_t))
754 current_target.to_read_description = NULL;
755 de_fault (to_get_raw_trace_data,
756 (LONGEST (*) (struct target_ops *, gdb_byte *, ULONGEST, LONGEST))
758 de_fault (to_get_min_fast_tracepoint_insn_len,
759 (int (*) (struct target_ops *))
761 de_fault (to_set_disconnected_tracing,
762 (void (*) (struct target_ops *, int))
764 de_fault (to_set_circular_trace_buffer,
765 (void (*) (struct target_ops *, int))
767 de_fault (to_set_trace_buffer_size,
768 (void (*) (struct target_ops *, LONGEST))
770 de_fault (to_set_trace_notes,
771 (int (*) (struct target_ops *,
772 const char *, const char *, const char *))
774 de_fault (to_get_tib_address,
775 (int (*) (struct target_ops *, ptid_t, CORE_ADDR *))
777 de_fault (to_set_permissions,
778 (void (*) (struct target_ops *))
780 de_fault (to_static_tracepoint_marker_at,
781 (int (*) (struct target_ops *,
782 CORE_ADDR, struct static_tracepoint_marker *))
784 de_fault (to_static_tracepoint_markers_by_strid,
785 (VEC(static_tracepoint_marker_p) * (*) (struct target_ops *,
788 de_fault (to_traceframe_info,
789 (struct traceframe_info * (*) (struct target_ops *))
791 de_fault (to_supports_evaluation_of_breakpoint_conditions,
792 (int (*) (struct target_ops *))
794 de_fault (to_can_run_breakpoint_commands,
795 (int (*) (struct target_ops *))
797 de_fault (to_use_agent,
798 (int (*) (struct target_ops *, int))
800 de_fault (to_can_use_agent,
801 (int (*) (struct target_ops *))
803 de_fault (to_augmented_libraries_svr4_read,
804 (int (*) (struct target_ops *))
809 /* Finally, position the target-stack beneath the squashed
810 "current_target". That way code looking for a non-inherited
811 target method can quickly and simply find it. */
812 current_target.beneath = target_stack;
815 setup_target_debug ();
818 /* Push a new target type into the stack of the existing target accessors,
819 possibly superseding some of the existing accessors.
821 Rather than allow an empty stack, we always have the dummy target at
822 the bottom stratum, so we can call the function vectors without
826 push_target (struct target_ops *t)
828 struct target_ops **cur;
830 /* Check magic number. If wrong, it probably means someone changed
831 the struct definition, but not all the places that initialize one. */
832 if (t->to_magic != OPS_MAGIC)
834 fprintf_unfiltered (gdb_stderr,
835 "Magic number of %s target struct wrong\n",
837 internal_error (__FILE__, __LINE__,
838 _("failed internal consistency check"));
841 /* Find the proper stratum to install this target in. */
842 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
844 if ((int) (t->to_stratum) >= (int) (*cur)->to_stratum)
848 /* If there's already targets at this stratum, remove them. */
849 /* FIXME: cagney/2003-10-15: I think this should be popping all
850 targets to CUR, and not just those at this stratum level. */
851 while ((*cur) != NULL && t->to_stratum == (*cur)->to_stratum)
853 /* There's already something at this stratum level. Close it,
854 and un-hook it from the stack. */
855 struct target_ops *tmp = (*cur);
857 (*cur) = (*cur)->beneath;
862 /* We have removed all targets in our stratum, now add the new one. */
866 update_current_target ();
869 /* Remove a target_ops vector from the stack, wherever it may be.
870 Return how many times it was removed (0 or 1). */
873 unpush_target (struct target_ops *t)
875 struct target_ops **cur;
876 struct target_ops *tmp;
878 if (t->to_stratum == dummy_stratum)
879 internal_error (__FILE__, __LINE__,
880 _("Attempt to unpush the dummy target"));
882 /* Look for the specified target. Note that we assume that a target
883 can only occur once in the target stack. */
885 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
891 /* If we don't find target_ops, quit. Only open targets should be
896 /* Unchain the target. */
898 (*cur) = (*cur)->beneath;
901 update_current_target ();
903 /* Finally close the target. Note we do this after unchaining, so
904 any target method calls from within the target_close
905 implementation don't end up in T anymore. */
912 pop_all_targets_above (enum strata above_stratum)
914 while ((int) (current_target.to_stratum) > (int) above_stratum)
916 if (!unpush_target (target_stack))
918 fprintf_unfiltered (gdb_stderr,
919 "pop_all_targets couldn't find target %s\n",
920 target_stack->to_shortname);
921 internal_error (__FILE__, __LINE__,
922 _("failed internal consistency check"));
929 pop_all_targets (void)
931 pop_all_targets_above (dummy_stratum);
934 /* Return 1 if T is now pushed in the target stack. Return 0 otherwise. */
937 target_is_pushed (struct target_ops *t)
939 struct target_ops **cur;
941 /* Check magic number. If wrong, it probably means someone changed
942 the struct definition, but not all the places that initialize one. */
943 if (t->to_magic != OPS_MAGIC)
945 fprintf_unfiltered (gdb_stderr,
946 "Magic number of %s target struct wrong\n",
948 internal_error (__FILE__, __LINE__,
949 _("failed internal consistency check"));
952 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
959 /* Using the objfile specified in OBJFILE, find the address for the
960 current thread's thread-local storage with offset OFFSET. */
962 target_translate_tls_address (struct objfile *objfile, CORE_ADDR offset)
964 volatile CORE_ADDR addr = 0;
965 struct target_ops *target;
967 for (target = current_target.beneath;
969 target = target->beneath)
971 if (target->to_get_thread_local_address != NULL)
976 && gdbarch_fetch_tls_load_module_address_p (target_gdbarch ()))
978 ptid_t ptid = inferior_ptid;
979 volatile struct gdb_exception ex;
981 TRY_CATCH (ex, RETURN_MASK_ALL)
985 /* Fetch the load module address for this objfile. */
986 lm_addr = gdbarch_fetch_tls_load_module_address (target_gdbarch (),
988 /* If it's 0, throw the appropriate exception. */
990 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR,
991 _("TLS load module not found"));
993 addr = target->to_get_thread_local_address (target, ptid,
996 /* If an error occurred, print TLS related messages here. Otherwise,
997 throw the error to some higher catcher. */
1000 int objfile_is_library = (objfile->flags & OBJF_SHARED);
1004 case TLS_NO_LIBRARY_SUPPORT_ERROR:
1005 error (_("Cannot find thread-local variables "
1006 "in this thread library."));
1008 case TLS_LOAD_MODULE_NOT_FOUND_ERROR:
1009 if (objfile_is_library)
1010 error (_("Cannot find shared library `%s' in dynamic"
1011 " linker's load module list"), objfile_name (objfile));
1013 error (_("Cannot find executable file `%s' in dynamic"
1014 " linker's load module list"), objfile_name (objfile));
1016 case TLS_NOT_ALLOCATED_YET_ERROR:
1017 if (objfile_is_library)
1018 error (_("The inferior has not yet allocated storage for"
1019 " thread-local variables in\n"
1020 "the shared library `%s'\n"
1022 objfile_name (objfile), target_pid_to_str (ptid));
1024 error (_("The inferior has not yet allocated storage for"
1025 " thread-local variables in\n"
1026 "the executable `%s'\n"
1028 objfile_name (objfile), target_pid_to_str (ptid));
1030 case TLS_GENERIC_ERROR:
1031 if (objfile_is_library)
1032 error (_("Cannot find thread-local storage for %s, "
1033 "shared library %s:\n%s"),
1034 target_pid_to_str (ptid),
1035 objfile_name (objfile), ex.message);
1037 error (_("Cannot find thread-local storage for %s, "
1038 "executable file %s:\n%s"),
1039 target_pid_to_str (ptid),
1040 objfile_name (objfile), ex.message);
1043 throw_exception (ex);
1048 /* It wouldn't be wrong here to try a gdbarch method, too; finding
1049 TLS is an ABI-specific thing. But we don't do that yet. */
1051 error (_("Cannot find thread-local variables on this target"));
1057 target_xfer_status_to_string (enum target_xfer_status err)
1059 #define CASE(X) case X: return #X
1062 CASE(TARGET_XFER_E_IO);
1063 CASE(TARGET_XFER_E_UNAVAILABLE);
1072 #define MIN(A, B) (((A) <= (B)) ? (A) : (B))
1074 /* target_read_string -- read a null terminated string, up to LEN bytes,
1075 from MEMADDR in target. Set *ERRNOP to the errno code, or 0 if successful.
1076 Set *STRING to a pointer to malloc'd memory containing the data; the caller
1077 is responsible for freeing it. Return the number of bytes successfully
1081 target_read_string (CORE_ADDR memaddr, char **string, int len, int *errnop)
1083 int tlen, offset, i;
1087 int buffer_allocated;
1089 unsigned int nbytes_read = 0;
1091 gdb_assert (string);
1093 /* Small for testing. */
1094 buffer_allocated = 4;
1095 buffer = xmalloc (buffer_allocated);
1100 tlen = MIN (len, 4 - (memaddr & 3));
1101 offset = memaddr & 3;
1103 errcode = target_read_memory (memaddr & ~3, buf, sizeof buf);
1106 /* The transfer request might have crossed the boundary to an
1107 unallocated region of memory. Retry the transfer, requesting
1111 errcode = target_read_memory (memaddr, buf, 1);
1116 if (bufptr - buffer + tlen > buffer_allocated)
1120 bytes = bufptr - buffer;
1121 buffer_allocated *= 2;
1122 buffer = xrealloc (buffer, buffer_allocated);
1123 bufptr = buffer + bytes;
1126 for (i = 0; i < tlen; i++)
1128 *bufptr++ = buf[i + offset];
1129 if (buf[i + offset] == '\000')
1131 nbytes_read += i + 1;
1138 nbytes_read += tlen;
1147 struct target_section_table *
1148 target_get_section_table (struct target_ops *target)
1150 struct target_ops *t;
1153 fprintf_unfiltered (gdb_stdlog, "target_get_section_table ()\n");
1155 for (t = target; t != NULL; t = t->beneath)
1156 if (t->to_get_section_table != NULL)
1157 return (*t->to_get_section_table) (t);
1162 /* Find a section containing ADDR. */
1164 struct target_section *
1165 target_section_by_addr (struct target_ops *target, CORE_ADDR addr)
1167 struct target_section_table *table = target_get_section_table (target);
1168 struct target_section *secp;
1173 for (secp = table->sections; secp < table->sections_end; secp++)
1175 if (addr >= secp->addr && addr < secp->endaddr)
1181 /* Read memory from the live target, even if currently inspecting a
1182 traceframe. The return is the same as that of target_read. */
1184 static enum target_xfer_status
1185 target_read_live_memory (enum target_object object,
1186 ULONGEST memaddr, gdb_byte *myaddr, ULONGEST len,
1187 ULONGEST *xfered_len)
1189 enum target_xfer_status ret;
1190 struct cleanup *cleanup;
1192 /* Switch momentarily out of tfind mode so to access live memory.
1193 Note that this must not clear global state, such as the frame
1194 cache, which must still remain valid for the previous traceframe.
1195 We may be _building_ the frame cache at this point. */
1196 cleanup = make_cleanup_restore_traceframe_number ();
1197 set_traceframe_number (-1);
1199 ret = target_xfer_partial (current_target.beneath, object, NULL,
1200 myaddr, NULL, memaddr, len, xfered_len);
1202 do_cleanups (cleanup);
1206 /* Using the set of read-only target sections of OPS, read live
1207 read-only memory. Note that the actual reads start from the
1208 top-most target again.
1210 For interface/parameters/return description see target.h,
1213 static enum target_xfer_status
1214 memory_xfer_live_readonly_partial (struct target_ops *ops,
1215 enum target_object object,
1216 gdb_byte *readbuf, ULONGEST memaddr,
1217 ULONGEST len, ULONGEST *xfered_len)
1219 struct target_section *secp;
1220 struct target_section_table *table;
1222 secp = target_section_by_addr (ops, memaddr);
1224 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1225 secp->the_bfd_section)
1228 struct target_section *p;
1229 ULONGEST memend = memaddr + len;
1231 table = target_get_section_table (ops);
1233 for (p = table->sections; p < table->sections_end; p++)
1235 if (memaddr >= p->addr)
1237 if (memend <= p->endaddr)
1239 /* Entire transfer is within this section. */
1240 return target_read_live_memory (object, memaddr,
1241 readbuf, len, xfered_len);
1243 else if (memaddr >= p->endaddr)
1245 /* This section ends before the transfer starts. */
1250 /* This section overlaps the transfer. Just do half. */
1251 len = p->endaddr - memaddr;
1252 return target_read_live_memory (object, memaddr,
1253 readbuf, len, xfered_len);
1259 return TARGET_XFER_EOF;
1262 /* Read memory from more than one valid target. A core file, for
1263 instance, could have some of memory but delegate other bits to
1264 the target below it. So, we must manually try all targets. */
1266 static enum target_xfer_status
1267 raw_memory_xfer_partial (struct target_ops *ops, gdb_byte *readbuf,
1268 const gdb_byte *writebuf, ULONGEST memaddr, LONGEST len,
1269 ULONGEST *xfered_len)
1271 enum target_xfer_status res;
1275 res = ops->to_xfer_partial (ops, TARGET_OBJECT_MEMORY, NULL,
1276 readbuf, writebuf, memaddr, len,
1278 if (res == TARGET_XFER_OK)
1281 /* Stop if the target reports that the memory is not available. */
1282 if (res == TARGET_XFER_E_UNAVAILABLE)
1285 /* We want to continue past core files to executables, but not
1286 past a running target's memory. */
1287 if (ops->to_has_all_memory (ops))
1292 while (ops != NULL);
1297 /* Perform a partial memory transfer.
1298 For docs see target.h, to_xfer_partial. */
1300 static enum target_xfer_status
1301 memory_xfer_partial_1 (struct target_ops *ops, enum target_object object,
1302 gdb_byte *readbuf, const gdb_byte *writebuf, ULONGEST memaddr,
1303 ULONGEST len, ULONGEST *xfered_len)
1305 enum target_xfer_status res;
1307 struct mem_region *region;
1308 struct inferior *inf;
1310 /* For accesses to unmapped overlay sections, read directly from
1311 files. Must do this first, as MEMADDR may need adjustment. */
1312 if (readbuf != NULL && overlay_debugging)
1314 struct obj_section *section = find_pc_overlay (memaddr);
1316 if (pc_in_unmapped_range (memaddr, section))
1318 struct target_section_table *table
1319 = target_get_section_table (ops);
1320 const char *section_name = section->the_bfd_section->name;
1322 memaddr = overlay_mapped_address (memaddr, section);
1323 return section_table_xfer_memory_partial (readbuf, writebuf,
1324 memaddr, len, xfered_len,
1326 table->sections_end,
1331 /* Try the executable files, if "trust-readonly-sections" is set. */
1332 if (readbuf != NULL && trust_readonly)
1334 struct target_section *secp;
1335 struct target_section_table *table;
1337 secp = target_section_by_addr (ops, memaddr);
1339 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1340 secp->the_bfd_section)
1343 table = target_get_section_table (ops);
1344 return section_table_xfer_memory_partial (readbuf, writebuf,
1345 memaddr, len, xfered_len,
1347 table->sections_end,
1352 /* If reading unavailable memory in the context of traceframes, and
1353 this address falls within a read-only section, fallback to
1354 reading from live memory. */
1355 if (readbuf != NULL && get_traceframe_number () != -1)
1357 VEC(mem_range_s) *available;
1359 /* If we fail to get the set of available memory, then the
1360 target does not support querying traceframe info, and so we
1361 attempt reading from the traceframe anyway (assuming the
1362 target implements the old QTro packet then). */
1363 if (traceframe_available_memory (&available, memaddr, len))
1365 struct cleanup *old_chain;
1367 old_chain = make_cleanup (VEC_cleanup(mem_range_s), &available);
1369 if (VEC_empty (mem_range_s, available)
1370 || VEC_index (mem_range_s, available, 0)->start != memaddr)
1372 /* Don't read into the traceframe's available
1374 if (!VEC_empty (mem_range_s, available))
1376 LONGEST oldlen = len;
1378 len = VEC_index (mem_range_s, available, 0)->start - memaddr;
1379 gdb_assert (len <= oldlen);
1382 do_cleanups (old_chain);
1384 /* This goes through the topmost target again. */
1385 res = memory_xfer_live_readonly_partial (ops, object,
1388 if (res == TARGET_XFER_OK)
1389 return TARGET_XFER_OK;
1392 /* No use trying further, we know some memory starting
1393 at MEMADDR isn't available. */
1395 return TARGET_XFER_E_UNAVAILABLE;
1399 /* Don't try to read more than how much is available, in
1400 case the target implements the deprecated QTro packet to
1401 cater for older GDBs (the target's knowledge of read-only
1402 sections may be outdated by now). */
1403 len = VEC_index (mem_range_s, available, 0)->length;
1405 do_cleanups (old_chain);
1409 /* Try GDB's internal data cache. */
1410 region = lookup_mem_region (memaddr);
1411 /* region->hi == 0 means there's no upper bound. */
1412 if (memaddr + len < region->hi || region->hi == 0)
1415 reg_len = region->hi - memaddr;
1417 switch (region->attrib.mode)
1420 if (writebuf != NULL)
1421 return TARGET_XFER_E_IO;
1425 if (readbuf != NULL)
1426 return TARGET_XFER_E_IO;
1430 /* We only support writing to flash during "load" for now. */
1431 if (writebuf != NULL)
1432 error (_("Writing to flash memory forbidden in this context"));
1436 return TARGET_XFER_E_IO;
1439 if (!ptid_equal (inferior_ptid, null_ptid))
1440 inf = find_inferior_pid (ptid_get_pid (inferior_ptid));
1445 /* The dcache reads whole cache lines; that doesn't play well
1446 with reading from a trace buffer, because reading outside of
1447 the collected memory range fails. */
1448 && get_traceframe_number () == -1
1449 && (region->attrib.cache
1450 || (stack_cache_enabled_p () && object == TARGET_OBJECT_STACK_MEMORY)
1451 || (code_cache_enabled_p () && object == TARGET_OBJECT_CODE_MEMORY)))
1453 DCACHE *dcache = target_dcache_get_or_init ();
1456 if (readbuf != NULL)
1457 l = dcache_xfer_memory (ops, dcache, memaddr, readbuf, reg_len, 0);
1459 /* FIXME drow/2006-08-09: If we're going to preserve const
1460 correctness dcache_xfer_memory should take readbuf and
1462 l = dcache_xfer_memory (ops, dcache, memaddr, (void *) writebuf,
1465 return TARGET_XFER_E_IO;
1468 *xfered_len = (ULONGEST) l;
1469 return TARGET_XFER_OK;
1473 /* If none of those methods found the memory we wanted, fall back
1474 to a target partial transfer. Normally a single call to
1475 to_xfer_partial is enough; if it doesn't recognize an object
1476 it will call the to_xfer_partial of the next target down.
1477 But for memory this won't do. Memory is the only target
1478 object which can be read from more than one valid target.
1479 A core file, for instance, could have some of memory but
1480 delegate other bits to the target below it. So, we must
1481 manually try all targets. */
1483 res = raw_memory_xfer_partial (ops, readbuf, writebuf, memaddr, reg_len,
1486 /* Make sure the cache gets updated no matter what - if we are writing
1487 to the stack. Even if this write is not tagged as such, we still need
1488 to update the cache. */
1490 if (res == TARGET_XFER_OK
1493 && target_dcache_init_p ()
1494 && !region->attrib.cache
1495 && ((stack_cache_enabled_p () && object != TARGET_OBJECT_STACK_MEMORY)
1496 || (code_cache_enabled_p () && object != TARGET_OBJECT_CODE_MEMORY)))
1498 DCACHE *dcache = target_dcache_get ();
1500 dcache_update (dcache, memaddr, (void *) writebuf, reg_len);
1503 /* If we still haven't got anything, return the last error. We
1508 /* Perform a partial memory transfer. For docs see target.h,
1511 static enum target_xfer_status
1512 memory_xfer_partial (struct target_ops *ops, enum target_object object,
1513 gdb_byte *readbuf, const gdb_byte *writebuf,
1514 ULONGEST memaddr, ULONGEST len, ULONGEST *xfered_len)
1516 enum target_xfer_status res;
1518 /* Zero length requests are ok and require no work. */
1520 return TARGET_XFER_EOF;
1522 /* Fill in READBUF with breakpoint shadows, or WRITEBUF with
1523 breakpoint insns, thus hiding out from higher layers whether
1524 there are software breakpoints inserted in the code stream. */
1525 if (readbuf != NULL)
1527 res = memory_xfer_partial_1 (ops, object, readbuf, NULL, memaddr, len,
1530 if (res == TARGET_XFER_OK && !show_memory_breakpoints)
1531 breakpoint_xfer_memory (readbuf, NULL, NULL, memaddr, res);
1536 struct cleanup *old_chain;
1538 /* A large write request is likely to be partially satisfied
1539 by memory_xfer_partial_1. We will continually malloc
1540 and free a copy of the entire write request for breakpoint
1541 shadow handling even though we only end up writing a small
1542 subset of it. Cap writes to 4KB to mitigate this. */
1543 len = min (4096, len);
1545 buf = xmalloc (len);
1546 old_chain = make_cleanup (xfree, buf);
1547 memcpy (buf, writebuf, len);
1549 breakpoint_xfer_memory (NULL, buf, writebuf, memaddr, len);
1550 res = memory_xfer_partial_1 (ops, object, NULL, buf, memaddr, len,
1553 do_cleanups (old_chain);
1560 restore_show_memory_breakpoints (void *arg)
1562 show_memory_breakpoints = (uintptr_t) arg;
1566 make_show_memory_breakpoints_cleanup (int show)
1568 int current = show_memory_breakpoints;
1570 show_memory_breakpoints = show;
1571 return make_cleanup (restore_show_memory_breakpoints,
1572 (void *) (uintptr_t) current);
1575 /* For docs see target.h, to_xfer_partial. */
1577 enum target_xfer_status
1578 target_xfer_partial (struct target_ops *ops,
1579 enum target_object object, const char *annex,
1580 gdb_byte *readbuf, const gdb_byte *writebuf,
1581 ULONGEST offset, ULONGEST len,
1582 ULONGEST *xfered_len)
1584 enum target_xfer_status retval;
1586 gdb_assert (ops->to_xfer_partial != NULL);
1588 /* Transfer is done when LEN is zero. */
1590 return TARGET_XFER_EOF;
1592 if (writebuf && !may_write_memory)
1593 error (_("Writing to memory is not allowed (addr %s, len %s)"),
1594 core_addr_to_string_nz (offset), plongest (len));
1598 /* If this is a memory transfer, let the memory-specific code
1599 have a look at it instead. Memory transfers are more
1601 if (object == TARGET_OBJECT_MEMORY || object == TARGET_OBJECT_STACK_MEMORY
1602 || object == TARGET_OBJECT_CODE_MEMORY)
1603 retval = memory_xfer_partial (ops, object, readbuf,
1604 writebuf, offset, len, xfered_len);
1605 else if (object == TARGET_OBJECT_RAW_MEMORY)
1607 /* Request the normal memory object from other layers. */
1608 retval = raw_memory_xfer_partial (ops, readbuf, writebuf, offset, len,
1612 retval = ops->to_xfer_partial (ops, object, annex, readbuf,
1613 writebuf, offset, len, xfered_len);
1617 const unsigned char *myaddr = NULL;
1619 fprintf_unfiltered (gdb_stdlog,
1620 "%s:target_xfer_partial "
1621 "(%d, %s, %s, %s, %s, %s) = %d, %s",
1624 (annex ? annex : "(null)"),
1625 host_address_to_string (readbuf),
1626 host_address_to_string (writebuf),
1627 core_addr_to_string_nz (offset),
1628 pulongest (len), retval,
1629 pulongest (*xfered_len));
1635 if (retval == TARGET_XFER_OK && myaddr != NULL)
1639 fputs_unfiltered (", bytes =", gdb_stdlog);
1640 for (i = 0; i < *xfered_len; i++)
1642 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
1644 if (targetdebug < 2 && i > 0)
1646 fprintf_unfiltered (gdb_stdlog, " ...");
1649 fprintf_unfiltered (gdb_stdlog, "\n");
1652 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
1656 fputc_unfiltered ('\n', gdb_stdlog);
1659 /* Check implementations of to_xfer_partial update *XFERED_LEN
1660 properly. Do assertion after printing debug messages, so that we
1661 can find more clues on assertion failure from debugging messages. */
1662 if (retval == TARGET_XFER_OK || retval == TARGET_XFER_E_UNAVAILABLE)
1663 gdb_assert (*xfered_len > 0);
1668 /* Read LEN bytes of target memory at address MEMADDR, placing the
1669 results in GDB's memory at MYADDR. Returns either 0 for success or
1670 TARGET_XFER_E_IO if any error occurs.
1672 If an error occurs, no guarantee is made about the contents of the data at
1673 MYADDR. In particular, the caller should not depend upon partial reads
1674 filling the buffer with good data. There is no way for the caller to know
1675 how much good data might have been transfered anyway. Callers that can
1676 deal with partial reads should call target_read (which will retry until
1677 it makes no progress, and then return how much was transferred). */
1680 target_read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1682 /* Dispatch to the topmost target, not the flattened current_target.
1683 Memory accesses check target->to_has_(all_)memory, and the
1684 flattened target doesn't inherit those. */
1685 if (target_read (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1686 myaddr, memaddr, len) == len)
1689 return TARGET_XFER_E_IO;
1692 /* Like target_read_memory, but specify explicitly that this is a read
1693 from the target's raw memory. That is, this read bypasses the
1694 dcache, breakpoint shadowing, etc. */
1697 target_read_raw_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1699 /* See comment in target_read_memory about why the request starts at
1700 current_target.beneath. */
1701 if (target_read (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1702 myaddr, memaddr, len) == len)
1705 return TARGET_XFER_E_IO;
1708 /* Like target_read_memory, but specify explicitly that this is a read from
1709 the target's stack. This may trigger different cache behavior. */
1712 target_read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1714 /* See comment in target_read_memory about why the request starts at
1715 current_target.beneath. */
1716 if (target_read (current_target.beneath, TARGET_OBJECT_STACK_MEMORY, NULL,
1717 myaddr, memaddr, len) == len)
1720 return TARGET_XFER_E_IO;
1723 /* Like target_read_memory, but specify explicitly that this is a read from
1724 the target's code. This may trigger different cache behavior. */
1727 target_read_code (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1729 /* See comment in target_read_memory about why the request starts at
1730 current_target.beneath. */
1731 if (target_read (current_target.beneath, TARGET_OBJECT_CODE_MEMORY, NULL,
1732 myaddr, memaddr, len) == len)
1735 return TARGET_XFER_E_IO;
1738 /* Write LEN bytes from MYADDR to target memory at address MEMADDR.
1739 Returns either 0 for success or TARGET_XFER_E_IO if any
1740 error occurs. If an error occurs, no guarantee is made about how
1741 much data got written. Callers that can deal with partial writes
1742 should call target_write. */
1745 target_write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1747 /* See comment in target_read_memory about why the request starts at
1748 current_target.beneath. */
1749 if (target_write (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1750 myaddr, memaddr, len) == len)
1753 return TARGET_XFER_E_IO;
1756 /* Write LEN bytes from MYADDR to target raw memory at address
1757 MEMADDR. Returns either 0 for success or TARGET_XFER_E_IO
1758 if any error occurs. If an error occurs, no guarantee is made
1759 about how much data got written. Callers that can deal with
1760 partial writes should call target_write. */
1763 target_write_raw_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1765 /* See comment in target_read_memory about why the request starts at
1766 current_target.beneath. */
1767 if (target_write (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1768 myaddr, memaddr, len) == len)
1771 return TARGET_XFER_E_IO;
1774 /* Fetch the target's memory map. */
1777 target_memory_map (void)
1779 VEC(mem_region_s) *result;
1780 struct mem_region *last_one, *this_one;
1782 struct target_ops *t;
1785 fprintf_unfiltered (gdb_stdlog, "target_memory_map ()\n");
1787 for (t = current_target.beneath; t != NULL; t = t->beneath)
1788 if (t->to_memory_map != NULL)
1794 result = t->to_memory_map (t);
1798 qsort (VEC_address (mem_region_s, result),
1799 VEC_length (mem_region_s, result),
1800 sizeof (struct mem_region), mem_region_cmp);
1802 /* Check that regions do not overlap. Simultaneously assign
1803 a numbering for the "mem" commands to use to refer to
1806 for (ix = 0; VEC_iterate (mem_region_s, result, ix, this_one); ix++)
1808 this_one->number = ix;
1810 if (last_one && last_one->hi > this_one->lo)
1812 warning (_("Overlapping regions in memory map: ignoring"));
1813 VEC_free (mem_region_s, result);
1816 last_one = this_one;
1823 target_flash_erase (ULONGEST address, LONGEST length)
1825 struct target_ops *t;
1827 for (t = current_target.beneath; t != NULL; t = t->beneath)
1828 if (t->to_flash_erase != NULL)
1831 fprintf_unfiltered (gdb_stdlog, "target_flash_erase (%s, %s)\n",
1832 hex_string (address), phex (length, 0));
1833 t->to_flash_erase (t, address, length);
1841 target_flash_done (void)
1843 struct target_ops *t;
1845 for (t = current_target.beneath; t != NULL; t = t->beneath)
1846 if (t->to_flash_done != NULL)
1849 fprintf_unfiltered (gdb_stdlog, "target_flash_done\n");
1850 t->to_flash_done (t);
1858 show_trust_readonly (struct ui_file *file, int from_tty,
1859 struct cmd_list_element *c, const char *value)
1861 fprintf_filtered (file,
1862 _("Mode for reading from readonly sections is %s.\n"),
1866 /* More generic transfers. */
1868 static enum target_xfer_status
1869 default_xfer_partial (struct target_ops *ops, enum target_object object,
1870 const char *annex, gdb_byte *readbuf,
1871 const gdb_byte *writebuf, ULONGEST offset, ULONGEST len,
1872 ULONGEST *xfered_len)
1874 if (object == TARGET_OBJECT_MEMORY
1875 && ops->deprecated_xfer_memory != NULL)
1876 /* If available, fall back to the target's
1877 "deprecated_xfer_memory" method. */
1882 if (writebuf != NULL)
1884 void *buffer = xmalloc (len);
1885 struct cleanup *cleanup = make_cleanup (xfree, buffer);
1887 memcpy (buffer, writebuf, len);
1888 xfered = ops->deprecated_xfer_memory (offset, buffer, len,
1889 1/*write*/, NULL, ops);
1890 do_cleanups (cleanup);
1892 if (readbuf != NULL)
1893 xfered = ops->deprecated_xfer_memory (offset, readbuf, len,
1894 0/*read*/, NULL, ops);
1897 *xfered_len = (ULONGEST) xfered;
1898 return TARGET_XFER_E_IO;
1900 else if (xfered == 0 && errno == 0)
1901 /* "deprecated_xfer_memory" uses 0, cross checked against
1902 ERRNO as one indication of an error. */
1903 return TARGET_XFER_EOF;
1905 return TARGET_XFER_E_IO;
1909 gdb_assert (ops->beneath != NULL);
1910 return ops->beneath->to_xfer_partial (ops->beneath, object, annex,
1911 readbuf, writebuf, offset, len,
1916 /* Target vector read/write partial wrapper functions. */
1918 static enum target_xfer_status
1919 target_read_partial (struct target_ops *ops,
1920 enum target_object object,
1921 const char *annex, gdb_byte *buf,
1922 ULONGEST offset, ULONGEST len,
1923 ULONGEST *xfered_len)
1925 return target_xfer_partial (ops, object, annex, buf, NULL, offset, len,
1929 static enum target_xfer_status
1930 target_write_partial (struct target_ops *ops,
1931 enum target_object object,
1932 const char *annex, const gdb_byte *buf,
1933 ULONGEST offset, LONGEST len, ULONGEST *xfered_len)
1935 return target_xfer_partial (ops, object, annex, NULL, buf, offset, len,
1939 /* Wrappers to perform the full transfer. */
1941 /* For docs on target_read see target.h. */
1944 target_read (struct target_ops *ops,
1945 enum target_object object,
1946 const char *annex, gdb_byte *buf,
1947 ULONGEST offset, LONGEST len)
1951 while (xfered < len)
1953 ULONGEST xfered_len;
1954 enum target_xfer_status status;
1956 status = target_read_partial (ops, object, annex,
1957 (gdb_byte *) buf + xfered,
1958 offset + xfered, len - xfered,
1961 /* Call an observer, notifying them of the xfer progress? */
1962 if (status == TARGET_XFER_EOF)
1964 else if (status == TARGET_XFER_OK)
1966 xfered += xfered_len;
1976 /* Assuming that the entire [begin, end) range of memory cannot be
1977 read, try to read whatever subrange is possible to read.
1979 The function returns, in RESULT, either zero or one memory block.
1980 If there's a readable subrange at the beginning, it is completely
1981 read and returned. Any further readable subrange will not be read.
1982 Otherwise, if there's a readable subrange at the end, it will be
1983 completely read and returned. Any readable subranges before it
1984 (obviously, not starting at the beginning), will be ignored. In
1985 other cases -- either no readable subrange, or readable subrange(s)
1986 that is neither at the beginning, or end, nothing is returned.
1988 The purpose of this function is to handle a read across a boundary
1989 of accessible memory in a case when memory map is not available.
1990 The above restrictions are fine for this case, but will give
1991 incorrect results if the memory is 'patchy'. However, supporting
1992 'patchy' memory would require trying to read every single byte,
1993 and it seems unacceptable solution. Explicit memory map is
1994 recommended for this case -- and target_read_memory_robust will
1995 take care of reading multiple ranges then. */
1998 read_whatever_is_readable (struct target_ops *ops,
1999 ULONGEST begin, ULONGEST end,
2000 VEC(memory_read_result_s) **result)
2002 gdb_byte *buf = xmalloc (end - begin);
2003 ULONGEST current_begin = begin;
2004 ULONGEST current_end = end;
2006 memory_read_result_s r;
2007 ULONGEST xfered_len;
2009 /* If we previously failed to read 1 byte, nothing can be done here. */
2010 if (end - begin <= 1)
2016 /* Check that either first or the last byte is readable, and give up
2017 if not. This heuristic is meant to permit reading accessible memory
2018 at the boundary of accessible region. */
2019 if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
2020 buf, begin, 1, &xfered_len) == TARGET_XFER_OK)
2025 else if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
2026 buf + (end-begin) - 1, end - 1, 1,
2027 &xfered_len) == TARGET_XFER_OK)
2038 /* Loop invariant is that the [current_begin, current_end) was previously
2039 found to be not readable as a whole.
2041 Note loop condition -- if the range has 1 byte, we can't divide the range
2042 so there's no point trying further. */
2043 while (current_end - current_begin > 1)
2045 ULONGEST first_half_begin, first_half_end;
2046 ULONGEST second_half_begin, second_half_end;
2048 ULONGEST middle = current_begin + (current_end - current_begin)/2;
2052 first_half_begin = current_begin;
2053 first_half_end = middle;
2054 second_half_begin = middle;
2055 second_half_end = current_end;
2059 first_half_begin = middle;
2060 first_half_end = current_end;
2061 second_half_begin = current_begin;
2062 second_half_end = middle;
2065 xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2066 buf + (first_half_begin - begin),
2068 first_half_end - first_half_begin);
2070 if (xfer == first_half_end - first_half_begin)
2072 /* This half reads up fine. So, the error must be in the
2074 current_begin = second_half_begin;
2075 current_end = second_half_end;
2079 /* This half is not readable. Because we've tried one byte, we
2080 know some part of this half if actually redable. Go to the next
2081 iteration to divide again and try to read.
2083 We don't handle the other half, because this function only tries
2084 to read a single readable subrange. */
2085 current_begin = first_half_begin;
2086 current_end = first_half_end;
2092 /* The [begin, current_begin) range has been read. */
2094 r.end = current_begin;
2099 /* The [current_end, end) range has been read. */
2100 LONGEST rlen = end - current_end;
2102 r.data = xmalloc (rlen);
2103 memcpy (r.data, buf + current_end - begin, rlen);
2104 r.begin = current_end;
2108 VEC_safe_push(memory_read_result_s, (*result), &r);
2112 free_memory_read_result_vector (void *x)
2114 VEC(memory_read_result_s) *v = x;
2115 memory_read_result_s *current;
2118 for (ix = 0; VEC_iterate (memory_read_result_s, v, ix, current); ++ix)
2120 xfree (current->data);
2122 VEC_free (memory_read_result_s, v);
2125 VEC(memory_read_result_s) *
2126 read_memory_robust (struct target_ops *ops, ULONGEST offset, LONGEST len)
2128 VEC(memory_read_result_s) *result = 0;
2131 while (xfered < len)
2133 struct mem_region *region = lookup_mem_region (offset + xfered);
2136 /* If there is no explicit region, a fake one should be created. */
2137 gdb_assert (region);
2139 if (region->hi == 0)
2140 rlen = len - xfered;
2142 rlen = region->hi - offset;
2144 if (region->attrib.mode == MEM_NONE || region->attrib.mode == MEM_WO)
2146 /* Cannot read this region. Note that we can end up here only
2147 if the region is explicitly marked inaccessible, or
2148 'inaccessible-by-default' is in effect. */
2153 LONGEST to_read = min (len - xfered, rlen);
2154 gdb_byte *buffer = (gdb_byte *)xmalloc (to_read);
2156 LONGEST xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2157 (gdb_byte *) buffer,
2158 offset + xfered, to_read);
2159 /* Call an observer, notifying them of the xfer progress? */
2162 /* Got an error reading full chunk. See if maybe we can read
2165 read_whatever_is_readable (ops, offset + xfered,
2166 offset + xfered + to_read, &result);
2171 struct memory_read_result r;
2173 r.begin = offset + xfered;
2174 r.end = r.begin + xfer;
2175 VEC_safe_push (memory_read_result_s, result, &r);
2185 /* An alternative to target_write with progress callbacks. */
2188 target_write_with_progress (struct target_ops *ops,
2189 enum target_object object,
2190 const char *annex, const gdb_byte *buf,
2191 ULONGEST offset, LONGEST len,
2192 void (*progress) (ULONGEST, void *), void *baton)
2196 /* Give the progress callback a chance to set up. */
2198 (*progress) (0, baton);
2200 while (xfered < len)
2202 ULONGEST xfered_len;
2203 enum target_xfer_status status;
2205 status = target_write_partial (ops, object, annex,
2206 (gdb_byte *) buf + xfered,
2207 offset + xfered, len - xfered,
2210 if (status == TARGET_XFER_EOF)
2212 if (TARGET_XFER_STATUS_ERROR_P (status))
2215 gdb_assert (status == TARGET_XFER_OK);
2217 (*progress) (xfered_len, baton);
2219 xfered += xfered_len;
2225 /* For docs on target_write see target.h. */
2228 target_write (struct target_ops *ops,
2229 enum target_object object,
2230 const char *annex, const gdb_byte *buf,
2231 ULONGEST offset, LONGEST len)
2233 return target_write_with_progress (ops, object, annex, buf, offset, len,
2237 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
2238 the size of the transferred data. PADDING additional bytes are
2239 available in *BUF_P. This is a helper function for
2240 target_read_alloc; see the declaration of that function for more
2244 target_read_alloc_1 (struct target_ops *ops, enum target_object object,
2245 const char *annex, gdb_byte **buf_p, int padding)
2247 size_t buf_alloc, buf_pos;
2250 /* This function does not have a length parameter; it reads the
2251 entire OBJECT). Also, it doesn't support objects fetched partly
2252 from one target and partly from another (in a different stratum,
2253 e.g. a core file and an executable). Both reasons make it
2254 unsuitable for reading memory. */
2255 gdb_assert (object != TARGET_OBJECT_MEMORY);
2257 /* Start by reading up to 4K at a time. The target will throttle
2258 this number down if necessary. */
2260 buf = xmalloc (buf_alloc);
2264 ULONGEST xfered_len;
2265 enum target_xfer_status status;
2267 status = target_read_partial (ops, object, annex, &buf[buf_pos],
2268 buf_pos, buf_alloc - buf_pos - padding,
2271 if (status == TARGET_XFER_EOF)
2273 /* Read all there was. */
2280 else if (status != TARGET_XFER_OK)
2282 /* An error occurred. */
2284 return TARGET_XFER_E_IO;
2287 buf_pos += xfered_len;
2289 /* If the buffer is filling up, expand it. */
2290 if (buf_alloc < buf_pos * 2)
2293 buf = xrealloc (buf, buf_alloc);
2300 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
2301 the size of the transferred data. See the declaration in "target.h"
2302 function for more information about the return value. */
2305 target_read_alloc (struct target_ops *ops, enum target_object object,
2306 const char *annex, gdb_byte **buf_p)
2308 return target_read_alloc_1 (ops, object, annex, buf_p, 0);
2311 /* Read OBJECT/ANNEX using OPS. The result is NUL-terminated and
2312 returned as a string, allocated using xmalloc. If an error occurs
2313 or the transfer is unsupported, NULL is returned. Empty objects
2314 are returned as allocated but empty strings. A warning is issued
2315 if the result contains any embedded NUL bytes. */
2318 target_read_stralloc (struct target_ops *ops, enum target_object object,
2323 LONGEST i, transferred;
2325 transferred = target_read_alloc_1 (ops, object, annex, &buffer, 1);
2326 bufstr = (char *) buffer;
2328 if (transferred < 0)
2331 if (transferred == 0)
2332 return xstrdup ("");
2334 bufstr[transferred] = 0;
2336 /* Check for embedded NUL bytes; but allow trailing NULs. */
2337 for (i = strlen (bufstr); i < transferred; i++)
2340 warning (_("target object %d, annex %s, "
2341 "contained unexpected null characters"),
2342 (int) object, annex ? annex : "(none)");
2349 /* Memory transfer methods. */
2352 get_target_memory (struct target_ops *ops, CORE_ADDR addr, gdb_byte *buf,
2355 /* This method is used to read from an alternate, non-current
2356 target. This read must bypass the overlay support (as symbols
2357 don't match this target), and GDB's internal cache (wrong cache
2358 for this target). */
2359 if (target_read (ops, TARGET_OBJECT_RAW_MEMORY, NULL, buf, addr, len)
2361 memory_error (TARGET_XFER_E_IO, addr);
2365 get_target_memory_unsigned (struct target_ops *ops, CORE_ADDR addr,
2366 int len, enum bfd_endian byte_order)
2368 gdb_byte buf[sizeof (ULONGEST)];
2370 gdb_assert (len <= sizeof (buf));
2371 get_target_memory (ops, addr, buf, len);
2372 return extract_unsigned_integer (buf, len, byte_order);
2378 target_insert_breakpoint (struct gdbarch *gdbarch,
2379 struct bp_target_info *bp_tgt)
2381 if (!may_insert_breakpoints)
2383 warning (_("May not insert breakpoints"));
2387 return current_target.to_insert_breakpoint (¤t_target,
2394 target_remove_breakpoint (struct gdbarch *gdbarch,
2395 struct bp_target_info *bp_tgt)
2397 /* This is kind of a weird case to handle, but the permission might
2398 have been changed after breakpoints were inserted - in which case
2399 we should just take the user literally and assume that any
2400 breakpoints should be left in place. */
2401 if (!may_insert_breakpoints)
2403 warning (_("May not remove breakpoints"));
2407 return current_target.to_remove_breakpoint (¤t_target,
2412 target_info (char *args, int from_tty)
2414 struct target_ops *t;
2415 int has_all_mem = 0;
2417 if (symfile_objfile != NULL)
2418 printf_unfiltered (_("Symbols from \"%s\".\n"),
2419 objfile_name (symfile_objfile));
2421 for (t = target_stack; t != NULL; t = t->beneath)
2423 if (!(*t->to_has_memory) (t))
2426 if ((int) (t->to_stratum) <= (int) dummy_stratum)
2429 printf_unfiltered (_("\tWhile running this, "
2430 "GDB does not access memory from...\n"));
2431 printf_unfiltered ("%s:\n", t->to_longname);
2432 (t->to_files_info) (t);
2433 has_all_mem = (*t->to_has_all_memory) (t);
2437 /* This function is called before any new inferior is created, e.g.
2438 by running a program, attaching, or connecting to a target.
2439 It cleans up any state from previous invocations which might
2440 change between runs. This is a subset of what target_preopen
2441 resets (things which might change between targets). */
2444 target_pre_inferior (int from_tty)
2446 /* Clear out solib state. Otherwise the solib state of the previous
2447 inferior might have survived and is entirely wrong for the new
2448 target. This has been observed on GNU/Linux using glibc 2.3. How
2460 Cannot access memory at address 0xdeadbeef
2463 /* In some OSs, the shared library list is the same/global/shared
2464 across inferiors. If code is shared between processes, so are
2465 memory regions and features. */
2466 if (!gdbarch_has_global_solist (target_gdbarch ()))
2468 no_shared_libraries (NULL, from_tty);
2470 invalidate_target_mem_regions ();
2472 target_clear_description ();
2475 agent_capability_invalidate ();
2478 /* Callback for iterate_over_inferiors. Gets rid of the given
2482 dispose_inferior (struct inferior *inf, void *args)
2484 struct thread_info *thread;
2486 thread = any_thread_of_process (inf->pid);
2489 switch_to_thread (thread->ptid);
2491 /* Core inferiors actually should be detached, not killed. */
2492 if (target_has_execution)
2495 target_detach (NULL, 0);
2501 /* This is to be called by the open routine before it does
2505 target_preopen (int from_tty)
2509 if (have_inferiors ())
2512 || !have_live_inferiors ()
2513 || query (_("A program is being debugged already. Kill it? ")))
2514 iterate_over_inferiors (dispose_inferior, NULL);
2516 error (_("Program not killed."));
2519 /* Calling target_kill may remove the target from the stack. But if
2520 it doesn't (which seems like a win for UDI), remove it now. */
2521 /* Leave the exec target, though. The user may be switching from a
2522 live process to a core of the same program. */
2523 pop_all_targets_above (file_stratum);
2525 target_pre_inferior (from_tty);
2528 /* Detach a target after doing deferred register stores. */
2531 target_detach (const char *args, int from_tty)
2533 struct target_ops* t;
2535 if (gdbarch_has_global_breakpoints (target_gdbarch ()))
2536 /* Don't remove global breakpoints here. They're removed on
2537 disconnection from the target. */
2540 /* If we're in breakpoints-always-inserted mode, have to remove
2541 them before detaching. */
2542 remove_breakpoints_pid (ptid_get_pid (inferior_ptid));
2544 prepare_for_detach ();
2546 current_target.to_detach (¤t_target, args, from_tty);
2548 fprintf_unfiltered (gdb_stdlog, "target_detach (%s, %d)\n",
2553 target_disconnect (char *args, int from_tty)
2555 struct target_ops *t;
2557 /* If we're in breakpoints-always-inserted mode or if breakpoints
2558 are global across processes, we have to remove them before
2560 remove_breakpoints ();
2562 for (t = current_target.beneath; t != NULL; t = t->beneath)
2563 if (t->to_disconnect != NULL)
2566 fprintf_unfiltered (gdb_stdlog, "target_disconnect (%s, %d)\n",
2568 t->to_disconnect (t, args, from_tty);
2576 target_wait (ptid_t ptid, struct target_waitstatus *status, int options)
2578 struct target_ops *t;
2579 ptid_t retval = (current_target.to_wait) (¤t_target, ptid,
2584 char *status_string;
2585 char *options_string;
2587 status_string = target_waitstatus_to_string (status);
2588 options_string = target_options_to_string (options);
2589 fprintf_unfiltered (gdb_stdlog,
2590 "target_wait (%d, status, options={%s})"
2592 ptid_get_pid (ptid), options_string,
2593 ptid_get_pid (retval), status_string);
2594 xfree (status_string);
2595 xfree (options_string);
2602 target_pid_to_str (ptid_t ptid)
2604 struct target_ops *t;
2606 for (t = current_target.beneath; t != NULL; t = t->beneath)
2608 if (t->to_pid_to_str != NULL)
2609 return (*t->to_pid_to_str) (t, ptid);
2612 return normal_pid_to_str (ptid);
2616 target_thread_name (struct thread_info *info)
2618 return current_target.to_thread_name (¤t_target, info);
2622 target_resume (ptid_t ptid, int step, enum gdb_signal signal)
2624 struct target_ops *t;
2626 target_dcache_invalidate ();
2628 current_target.to_resume (¤t_target, ptid, step, signal);
2630 fprintf_unfiltered (gdb_stdlog, "target_resume (%d, %s, %s)\n",
2631 ptid_get_pid (ptid),
2632 step ? "step" : "continue",
2633 gdb_signal_to_name (signal));
2635 registers_changed_ptid (ptid);
2636 set_executing (ptid, 1);
2637 set_running (ptid, 1);
2638 clear_inline_frame_state (ptid);
2642 target_pass_signals (int numsigs, unsigned char *pass_signals)
2644 struct target_ops *t;
2646 for (t = current_target.beneath; t != NULL; t = t->beneath)
2648 if (t->to_pass_signals != NULL)
2654 fprintf_unfiltered (gdb_stdlog, "target_pass_signals (%d, {",
2657 for (i = 0; i < numsigs; i++)
2658 if (pass_signals[i])
2659 fprintf_unfiltered (gdb_stdlog, " %s",
2660 gdb_signal_to_name (i));
2662 fprintf_unfiltered (gdb_stdlog, " })\n");
2665 (*t->to_pass_signals) (t, numsigs, pass_signals);
2672 target_program_signals (int numsigs, unsigned char *program_signals)
2674 struct target_ops *t;
2676 for (t = current_target.beneath; t != NULL; t = t->beneath)
2678 if (t->to_program_signals != NULL)
2684 fprintf_unfiltered (gdb_stdlog, "target_program_signals (%d, {",
2687 for (i = 0; i < numsigs; i++)
2688 if (program_signals[i])
2689 fprintf_unfiltered (gdb_stdlog, " %s",
2690 gdb_signal_to_name (i));
2692 fprintf_unfiltered (gdb_stdlog, " })\n");
2695 (*t->to_program_signals) (t, numsigs, program_signals);
2701 /* Look through the list of possible targets for a target that can
2705 target_follow_fork (int follow_child, int detach_fork)
2707 struct target_ops *t;
2709 for (t = current_target.beneath; t != NULL; t = t->beneath)
2711 if (t->to_follow_fork != NULL)
2713 int retval = t->to_follow_fork (t, follow_child, detach_fork);
2716 fprintf_unfiltered (gdb_stdlog,
2717 "target_follow_fork (%d, %d) = %d\n",
2718 follow_child, detach_fork, retval);
2723 /* Some target returned a fork event, but did not know how to follow it. */
2724 internal_error (__FILE__, __LINE__,
2725 _("could not find a target to follow fork"));
2729 target_mourn_inferior (void)
2731 struct target_ops *t;
2733 for (t = current_target.beneath; t != NULL; t = t->beneath)
2735 if (t->to_mourn_inferior != NULL)
2737 t->to_mourn_inferior (t);
2739 fprintf_unfiltered (gdb_stdlog, "target_mourn_inferior ()\n");
2741 /* We no longer need to keep handles on any of the object files.
2742 Make sure to release them to avoid unnecessarily locking any
2743 of them while we're not actually debugging. */
2744 bfd_cache_close_all ();
2750 internal_error (__FILE__, __LINE__,
2751 _("could not find a target to follow mourn inferior"));
2754 /* Look for a target which can describe architectural features, starting
2755 from TARGET. If we find one, return its description. */
2757 const struct target_desc *
2758 target_read_description (struct target_ops *target)
2760 struct target_ops *t;
2762 for (t = target; t != NULL; t = t->beneath)
2763 if (t->to_read_description != NULL)
2765 const struct target_desc *tdesc;
2767 tdesc = t->to_read_description (t);
2775 /* The default implementation of to_search_memory.
2776 This implements a basic search of memory, reading target memory and
2777 performing the search here (as opposed to performing the search in on the
2778 target side with, for example, gdbserver). */
2781 simple_search_memory (struct target_ops *ops,
2782 CORE_ADDR start_addr, ULONGEST search_space_len,
2783 const gdb_byte *pattern, ULONGEST pattern_len,
2784 CORE_ADDR *found_addrp)
2786 /* NOTE: also defined in find.c testcase. */
2787 #define SEARCH_CHUNK_SIZE 16000
2788 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
2789 /* Buffer to hold memory contents for searching. */
2790 gdb_byte *search_buf;
2791 unsigned search_buf_size;
2792 struct cleanup *old_cleanups;
2794 search_buf_size = chunk_size + pattern_len - 1;
2796 /* No point in trying to allocate a buffer larger than the search space. */
2797 if (search_space_len < search_buf_size)
2798 search_buf_size = search_space_len;
2800 search_buf = malloc (search_buf_size);
2801 if (search_buf == NULL)
2802 error (_("Unable to allocate memory to perform the search."));
2803 old_cleanups = make_cleanup (free_current_contents, &search_buf);
2805 /* Prime the search buffer. */
2807 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2808 search_buf, start_addr, search_buf_size) != search_buf_size)
2810 warning (_("Unable to access %s bytes of target "
2811 "memory at %s, halting search."),
2812 pulongest (search_buf_size), hex_string (start_addr));
2813 do_cleanups (old_cleanups);
2817 /* Perform the search.
2819 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
2820 When we've scanned N bytes we copy the trailing bytes to the start and
2821 read in another N bytes. */
2823 while (search_space_len >= pattern_len)
2825 gdb_byte *found_ptr;
2826 unsigned nr_search_bytes = min (search_space_len, search_buf_size);
2828 found_ptr = memmem (search_buf, nr_search_bytes,
2829 pattern, pattern_len);
2831 if (found_ptr != NULL)
2833 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
2835 *found_addrp = found_addr;
2836 do_cleanups (old_cleanups);
2840 /* Not found in this chunk, skip to next chunk. */
2842 /* Don't let search_space_len wrap here, it's unsigned. */
2843 if (search_space_len >= chunk_size)
2844 search_space_len -= chunk_size;
2846 search_space_len = 0;
2848 if (search_space_len >= pattern_len)
2850 unsigned keep_len = search_buf_size - chunk_size;
2851 CORE_ADDR read_addr = start_addr + chunk_size + keep_len;
2854 /* Copy the trailing part of the previous iteration to the front
2855 of the buffer for the next iteration. */
2856 gdb_assert (keep_len == pattern_len - 1);
2857 memcpy (search_buf, search_buf + chunk_size, keep_len);
2859 nr_to_read = min (search_space_len - keep_len, chunk_size);
2861 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2862 search_buf + keep_len, read_addr,
2863 nr_to_read) != nr_to_read)
2865 warning (_("Unable to access %s bytes of target "
2866 "memory at %s, halting search."),
2867 plongest (nr_to_read),
2868 hex_string (read_addr));
2869 do_cleanups (old_cleanups);
2873 start_addr += chunk_size;
2879 do_cleanups (old_cleanups);
2883 /* Search SEARCH_SPACE_LEN bytes beginning at START_ADDR for the
2884 sequence of bytes in PATTERN with length PATTERN_LEN.
2886 The result is 1 if found, 0 if not found, and -1 if there was an error
2887 requiring halting of the search (e.g. memory read error).
2888 If the pattern is found the address is recorded in FOUND_ADDRP. */
2891 target_search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
2892 const gdb_byte *pattern, ULONGEST pattern_len,
2893 CORE_ADDR *found_addrp)
2895 struct target_ops *t;
2898 /* We don't use INHERIT to set current_target.to_search_memory,
2899 so we have to scan the target stack and handle targetdebug
2903 fprintf_unfiltered (gdb_stdlog, "target_search_memory (%s, ...)\n",
2904 hex_string (start_addr));
2906 for (t = current_target.beneath; t != NULL; t = t->beneath)
2907 if (t->to_search_memory != NULL)
2912 found = t->to_search_memory (t, start_addr, search_space_len,
2913 pattern, pattern_len, found_addrp);
2917 /* If a special version of to_search_memory isn't available, use the
2919 found = simple_search_memory (current_target.beneath,
2920 start_addr, search_space_len,
2921 pattern, pattern_len, found_addrp);
2925 fprintf_unfiltered (gdb_stdlog, " = %d\n", found);
2930 /* Look through the currently pushed targets. If none of them will
2931 be able to restart the currently running process, issue an error
2935 target_require_runnable (void)
2937 struct target_ops *t;
2939 for (t = target_stack; t != NULL; t = t->beneath)
2941 /* If this target knows how to create a new program, then
2942 assume we will still be able to after killing the current
2943 one. Either killing and mourning will not pop T, or else
2944 find_default_run_target will find it again. */
2945 if (t->to_create_inferior != NULL)
2948 /* Do not worry about thread_stratum targets that can not
2949 create inferiors. Assume they will be pushed again if
2950 necessary, and continue to the process_stratum. */
2951 if (t->to_stratum == thread_stratum
2952 || t->to_stratum == arch_stratum)
2955 error (_("The \"%s\" target does not support \"run\". "
2956 "Try \"help target\" or \"continue\"."),
2960 /* This function is only called if the target is running. In that
2961 case there should have been a process_stratum target and it
2962 should either know how to create inferiors, or not... */
2963 internal_error (__FILE__, __LINE__, _("No targets found"));
2966 /* Look through the list of possible targets for a target that can
2967 execute a run or attach command without any other data. This is
2968 used to locate the default process stratum.
2970 If DO_MESG is not NULL, the result is always valid (error() is
2971 called for errors); else, return NULL on error. */
2973 static struct target_ops *
2974 find_default_run_target (char *do_mesg)
2976 struct target_ops **t;
2977 struct target_ops *runable = NULL;
2982 for (t = target_structs; t < target_structs + target_struct_size;
2985 if ((*t)->to_can_run && target_can_run (*t))
2995 error (_("Don't know how to %s. Try \"help target\"."), do_mesg);
3004 find_default_attach (struct target_ops *ops, char *args, int from_tty)
3006 struct target_ops *t;
3008 t = find_default_run_target ("attach");
3009 (t->to_attach) (t, args, from_tty);
3014 find_default_create_inferior (struct target_ops *ops,
3015 char *exec_file, char *allargs, char **env,
3018 struct target_ops *t;
3020 t = find_default_run_target ("run");
3021 (t->to_create_inferior) (t, exec_file, allargs, env, from_tty);
3026 find_default_can_async_p (struct target_ops *ignore)
3028 struct target_ops *t;
3030 /* This may be called before the target is pushed on the stack;
3031 look for the default process stratum. If there's none, gdb isn't
3032 configured with a native debugger, and target remote isn't
3034 t = find_default_run_target (NULL);
3035 if (t && t->to_can_async_p != delegate_can_async_p)
3036 return (t->to_can_async_p) (t);
3041 find_default_is_async_p (struct target_ops *ignore)
3043 struct target_ops *t;
3045 /* This may be called before the target is pushed on the stack;
3046 look for the default process stratum. If there's none, gdb isn't
3047 configured with a native debugger, and target remote isn't
3049 t = find_default_run_target (NULL);
3050 if (t && t->to_is_async_p != delegate_is_async_p)
3051 return (t->to_is_async_p) (t);
3056 find_default_supports_non_stop (struct target_ops *self)
3058 struct target_ops *t;
3060 t = find_default_run_target (NULL);
3061 if (t && t->to_supports_non_stop)
3062 return (t->to_supports_non_stop) (t);
3067 target_supports_non_stop (void)
3069 struct target_ops *t;
3071 for (t = ¤t_target; t != NULL; t = t->beneath)
3072 if (t->to_supports_non_stop)
3073 return t->to_supports_non_stop (t);
3078 /* Implement the "info proc" command. */
3081 target_info_proc (char *args, enum info_proc_what what)
3083 struct target_ops *t;
3085 /* If we're already connected to something that can get us OS
3086 related data, use it. Otherwise, try using the native
3088 if (current_target.to_stratum >= process_stratum)
3089 t = current_target.beneath;
3091 t = find_default_run_target (NULL);
3093 for (; t != NULL; t = t->beneath)
3095 if (t->to_info_proc != NULL)
3097 t->to_info_proc (t, args, what);
3100 fprintf_unfiltered (gdb_stdlog,
3101 "target_info_proc (\"%s\", %d)\n", args, what);
3111 find_default_supports_disable_randomization (struct target_ops *self)
3113 struct target_ops *t;
3115 t = find_default_run_target (NULL);
3116 if (t && t->to_supports_disable_randomization)
3117 return (t->to_supports_disable_randomization) (t);
3122 target_supports_disable_randomization (void)
3124 struct target_ops *t;
3126 for (t = ¤t_target; t != NULL; t = t->beneath)
3127 if (t->to_supports_disable_randomization)
3128 return t->to_supports_disable_randomization (t);
3134 target_get_osdata (const char *type)
3136 struct target_ops *t;
3138 /* If we're already connected to something that can get us OS
3139 related data, use it. Otherwise, try using the native
3141 if (current_target.to_stratum >= process_stratum)
3142 t = current_target.beneath;
3144 t = find_default_run_target ("get OS data");
3149 return target_read_stralloc (t, TARGET_OBJECT_OSDATA, type);
3152 /* Determine the current address space of thread PTID. */
3154 struct address_space *
3155 target_thread_address_space (ptid_t ptid)
3157 struct address_space *aspace;
3158 struct inferior *inf;
3159 struct target_ops *t;
3161 for (t = current_target.beneath; t != NULL; t = t->beneath)
3163 if (t->to_thread_address_space != NULL)
3165 aspace = t->to_thread_address_space (t, ptid);
3166 gdb_assert (aspace);
3169 fprintf_unfiltered (gdb_stdlog,
3170 "target_thread_address_space (%s) = %d\n",
3171 target_pid_to_str (ptid),
3172 address_space_num (aspace));
3177 /* Fall-back to the "main" address space of the inferior. */
3178 inf = find_inferior_pid (ptid_get_pid (ptid));
3180 if (inf == NULL || inf->aspace == NULL)
3181 internal_error (__FILE__, __LINE__,
3182 _("Can't determine the current "
3183 "address space of thread %s\n"),
3184 target_pid_to_str (ptid));
3190 /* Target file operations. */
3192 static struct target_ops *
3193 default_fileio_target (void)
3195 /* If we're already connected to something that can perform
3196 file I/O, use it. Otherwise, try using the native target. */
3197 if (current_target.to_stratum >= process_stratum)
3198 return current_target.beneath;
3200 return find_default_run_target ("file I/O");
3203 /* Open FILENAME on the target, using FLAGS and MODE. Return a
3204 target file descriptor, or -1 if an error occurs (and set
3207 target_fileio_open (const char *filename, int flags, int mode,
3210 struct target_ops *t;
3212 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3214 if (t->to_fileio_open != NULL)
3216 int fd = t->to_fileio_open (t, filename, flags, mode, target_errno);
3219 fprintf_unfiltered (gdb_stdlog,
3220 "target_fileio_open (%s,0x%x,0%o) = %d (%d)\n",
3221 filename, flags, mode,
3222 fd, fd != -1 ? 0 : *target_errno);
3227 *target_errno = FILEIO_ENOSYS;
3231 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
3232 Return the number of bytes written, or -1 if an error occurs
3233 (and set *TARGET_ERRNO). */
3235 target_fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
3236 ULONGEST offset, int *target_errno)
3238 struct target_ops *t;
3240 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3242 if (t->to_fileio_pwrite != NULL)
3244 int ret = t->to_fileio_pwrite (t, fd, write_buf, len, offset,
3248 fprintf_unfiltered (gdb_stdlog,
3249 "target_fileio_pwrite (%d,...,%d,%s) "
3251 fd, len, pulongest (offset),
3252 ret, ret != -1 ? 0 : *target_errno);
3257 *target_errno = FILEIO_ENOSYS;
3261 /* Read up to LEN bytes FD on the target into READ_BUF.
3262 Return the number of bytes read, or -1 if an error occurs
3263 (and set *TARGET_ERRNO). */
3265 target_fileio_pread (int fd, gdb_byte *read_buf, int len,
3266 ULONGEST offset, int *target_errno)
3268 struct target_ops *t;
3270 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3272 if (t->to_fileio_pread != NULL)
3274 int ret = t->to_fileio_pread (t, fd, read_buf, len, offset,
3278 fprintf_unfiltered (gdb_stdlog,
3279 "target_fileio_pread (%d,...,%d,%s) "
3281 fd, len, pulongest (offset),
3282 ret, ret != -1 ? 0 : *target_errno);
3287 *target_errno = FILEIO_ENOSYS;
3291 /* Close FD on the target. Return 0, or -1 if an error occurs
3292 (and set *TARGET_ERRNO). */
3294 target_fileio_close (int fd, int *target_errno)
3296 struct target_ops *t;
3298 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3300 if (t->to_fileio_close != NULL)
3302 int ret = t->to_fileio_close (t, fd, target_errno);
3305 fprintf_unfiltered (gdb_stdlog,
3306 "target_fileio_close (%d) = %d (%d)\n",
3307 fd, ret, ret != -1 ? 0 : *target_errno);
3312 *target_errno = FILEIO_ENOSYS;
3316 /* Unlink FILENAME on the target. Return 0, or -1 if an error
3317 occurs (and set *TARGET_ERRNO). */
3319 target_fileio_unlink (const char *filename, int *target_errno)
3321 struct target_ops *t;
3323 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3325 if (t->to_fileio_unlink != NULL)
3327 int ret = t->to_fileio_unlink (t, filename, target_errno);
3330 fprintf_unfiltered (gdb_stdlog,
3331 "target_fileio_unlink (%s) = %d (%d)\n",
3332 filename, ret, ret != -1 ? 0 : *target_errno);
3337 *target_errno = FILEIO_ENOSYS;
3341 /* Read value of symbolic link FILENAME on the target. Return a
3342 null-terminated string allocated via xmalloc, or NULL if an error
3343 occurs (and set *TARGET_ERRNO). */
3345 target_fileio_readlink (const char *filename, int *target_errno)
3347 struct target_ops *t;
3349 for (t = default_fileio_target (); t != NULL; t = t->beneath)
3351 if (t->to_fileio_readlink != NULL)
3353 char *ret = t->to_fileio_readlink (t, filename, target_errno);
3356 fprintf_unfiltered (gdb_stdlog,
3357 "target_fileio_readlink (%s) = %s (%d)\n",
3358 filename, ret? ret : "(nil)",
3359 ret? 0 : *target_errno);
3364 *target_errno = FILEIO_ENOSYS;
3369 target_fileio_close_cleanup (void *opaque)
3371 int fd = *(int *) opaque;
3374 target_fileio_close (fd, &target_errno);
3377 /* Read target file FILENAME. Store the result in *BUF_P and
3378 return the size of the transferred data. PADDING additional bytes are
3379 available in *BUF_P. This is a helper function for
3380 target_fileio_read_alloc; see the declaration of that function for more
3384 target_fileio_read_alloc_1 (const char *filename,
3385 gdb_byte **buf_p, int padding)
3387 struct cleanup *close_cleanup;
3388 size_t buf_alloc, buf_pos;
3394 fd = target_fileio_open (filename, FILEIO_O_RDONLY, 0700, &target_errno);
3398 close_cleanup = make_cleanup (target_fileio_close_cleanup, &fd);
3400 /* Start by reading up to 4K at a time. The target will throttle
3401 this number down if necessary. */
3403 buf = xmalloc (buf_alloc);
3407 n = target_fileio_pread (fd, &buf[buf_pos],
3408 buf_alloc - buf_pos - padding, buf_pos,
3412 /* An error occurred. */
3413 do_cleanups (close_cleanup);
3419 /* Read all there was. */
3420 do_cleanups (close_cleanup);
3430 /* If the buffer is filling up, expand it. */
3431 if (buf_alloc < buf_pos * 2)
3434 buf = xrealloc (buf, buf_alloc);
3441 /* Read target file FILENAME. Store the result in *BUF_P and return
3442 the size of the transferred data. See the declaration in "target.h"
3443 function for more information about the return value. */
3446 target_fileio_read_alloc (const char *filename, gdb_byte **buf_p)
3448 return target_fileio_read_alloc_1 (filename, buf_p, 0);
3451 /* Read target file FILENAME. The result is NUL-terminated and
3452 returned as a string, allocated using xmalloc. If an error occurs
3453 or the transfer is unsupported, NULL is returned. Empty objects
3454 are returned as allocated but empty strings. A warning is issued
3455 if the result contains any embedded NUL bytes. */
3458 target_fileio_read_stralloc (const char *filename)
3462 LONGEST i, transferred;
3464 transferred = target_fileio_read_alloc_1 (filename, &buffer, 1);
3465 bufstr = (char *) buffer;
3467 if (transferred < 0)
3470 if (transferred == 0)
3471 return xstrdup ("");
3473 bufstr[transferred] = 0;
3475 /* Check for embedded NUL bytes; but allow trailing NULs. */
3476 for (i = strlen (bufstr); i < transferred; i++)
3479 warning (_("target file %s "
3480 "contained unexpected null characters"),
3490 default_region_ok_for_hw_watchpoint (struct target_ops *self,
3491 CORE_ADDR addr, int len)
3493 return (len <= gdbarch_ptr_bit (target_gdbarch ()) / TARGET_CHAR_BIT);
3497 default_watchpoint_addr_within_range (struct target_ops *target,
3499 CORE_ADDR start, int length)
3501 return addr >= start && addr < start + length;
3504 static struct gdbarch *
3505 default_thread_architecture (struct target_ops *ops, ptid_t ptid)
3507 return target_gdbarch ();
3517 return_minus_one (void)
3529 * Find the next target down the stack from the specified target.
3533 find_target_beneath (struct target_ops *t)
3541 find_target_at (enum strata stratum)
3543 struct target_ops *t;
3545 for (t = current_target.beneath; t != NULL; t = t->beneath)
3546 if (t->to_stratum == stratum)
3553 /* The inferior process has died. Long live the inferior! */
3556 generic_mourn_inferior (void)
3560 ptid = inferior_ptid;
3561 inferior_ptid = null_ptid;
3563 /* Mark breakpoints uninserted in case something tries to delete a
3564 breakpoint while we delete the inferior's threads (which would
3565 fail, since the inferior is long gone). */
3566 mark_breakpoints_out ();
3568 if (!ptid_equal (ptid, null_ptid))
3570 int pid = ptid_get_pid (ptid);
3571 exit_inferior (pid);
3574 /* Note this wipes step-resume breakpoints, so needs to be done
3575 after exit_inferior, which ends up referencing the step-resume
3576 breakpoints through clear_thread_inferior_resources. */
3577 breakpoint_init_inferior (inf_exited);
3579 registers_changed ();
3581 reopen_exec_file ();
3582 reinit_frame_cache ();
3584 if (deprecated_detach_hook)
3585 deprecated_detach_hook ();
3588 /* Convert a normal process ID to a string. Returns the string in a
3592 normal_pid_to_str (ptid_t ptid)
3594 static char buf[32];
3596 xsnprintf (buf, sizeof buf, "process %d", ptid_get_pid (ptid));
3601 dummy_pid_to_str (struct target_ops *ops, ptid_t ptid)
3603 return normal_pid_to_str (ptid);
3606 /* Error-catcher for target_find_memory_regions. */
3608 dummy_find_memory_regions (struct target_ops *self,
3609 find_memory_region_ftype ignore1, void *ignore2)
3611 error (_("Command not implemented for this target."));
3615 /* Error-catcher for target_make_corefile_notes. */
3617 dummy_make_corefile_notes (struct target_ops *self,
3618 bfd *ignore1, int *ignore2)
3620 error (_("Command not implemented for this target."));
3624 /* Set up the handful of non-empty slots needed by the dummy target
3628 init_dummy_target (void)
3630 dummy_target.to_shortname = "None";
3631 dummy_target.to_longname = "None";
3632 dummy_target.to_doc = "";
3633 dummy_target.to_create_inferior = find_default_create_inferior;
3634 dummy_target.to_supports_non_stop = find_default_supports_non_stop;
3635 dummy_target.to_supports_disable_randomization
3636 = find_default_supports_disable_randomization;
3637 dummy_target.to_pid_to_str = dummy_pid_to_str;
3638 dummy_target.to_stratum = dummy_stratum;
3639 dummy_target.to_has_all_memory = (int (*) (struct target_ops *)) return_zero;
3640 dummy_target.to_has_memory = (int (*) (struct target_ops *)) return_zero;
3641 dummy_target.to_has_stack = (int (*) (struct target_ops *)) return_zero;
3642 dummy_target.to_has_registers = (int (*) (struct target_ops *)) return_zero;
3643 dummy_target.to_has_execution
3644 = (int (*) (struct target_ops *, ptid_t)) return_zero;
3645 dummy_target.to_magic = OPS_MAGIC;
3647 install_dummy_methods (&dummy_target);
3651 debug_to_open (char *args, int from_tty)
3653 debug_target.to_open (args, from_tty);
3655 fprintf_unfiltered (gdb_stdlog, "target_open (%s, %d)\n", args, from_tty);
3659 target_close (struct target_ops *targ)
3661 gdb_assert (!target_is_pushed (targ));
3663 if (targ->to_xclose != NULL)
3664 targ->to_xclose (targ);
3665 else if (targ->to_close != NULL)
3666 targ->to_close (targ);
3669 fprintf_unfiltered (gdb_stdlog, "target_close ()\n");
3673 target_attach (char *args, int from_tty)
3675 current_target.to_attach (¤t_target, args, from_tty);
3677 fprintf_unfiltered (gdb_stdlog, "target_attach (%s, %d)\n",
3682 target_thread_alive (ptid_t ptid)
3684 struct target_ops *t;
3686 for (t = current_target.beneath; t != NULL; t = t->beneath)
3688 if (t->to_thread_alive != NULL)
3692 retval = t->to_thread_alive (t, ptid);
3694 fprintf_unfiltered (gdb_stdlog, "target_thread_alive (%d) = %d\n",
3695 ptid_get_pid (ptid), retval);
3705 target_find_new_threads (void)
3707 struct target_ops *t;
3709 for (t = current_target.beneath; t != NULL; t = t->beneath)
3711 if (t->to_find_new_threads != NULL)
3713 t->to_find_new_threads (t);
3715 fprintf_unfiltered (gdb_stdlog, "target_find_new_threads ()\n");
3723 target_stop (ptid_t ptid)
3727 warning (_("May not interrupt or stop the target, ignoring attempt"));
3731 (*current_target.to_stop) (¤t_target, ptid);
3735 debug_to_post_attach (struct target_ops *self, int pid)
3737 debug_target.to_post_attach (&debug_target, pid);
3739 fprintf_unfiltered (gdb_stdlog, "target_post_attach (%d)\n", pid);
3742 /* Concatenate ELEM to LIST, a comma separate list, and return the
3743 result. The LIST incoming argument is released. */
3746 str_comma_list_concat_elem (char *list, const char *elem)
3749 return xstrdup (elem);
3751 return reconcat (list, list, ", ", elem, (char *) NULL);
3754 /* Helper for target_options_to_string. If OPT is present in
3755 TARGET_OPTIONS, append the OPT_STR (string version of OPT) in RET.
3756 Returns the new resulting string. OPT is removed from
3760 do_option (int *target_options, char *ret,
3761 int opt, char *opt_str)
3763 if ((*target_options & opt) != 0)
3765 ret = str_comma_list_concat_elem (ret, opt_str);
3766 *target_options &= ~opt;
3773 target_options_to_string (int target_options)
3777 #define DO_TARG_OPTION(OPT) \
3778 ret = do_option (&target_options, ret, OPT, #OPT)
3780 DO_TARG_OPTION (TARGET_WNOHANG);
3782 if (target_options != 0)
3783 ret = str_comma_list_concat_elem (ret, "unknown???");
3791 debug_print_register (const char * func,
3792 struct regcache *regcache, int regno)
3794 struct gdbarch *gdbarch = get_regcache_arch (regcache);
3796 fprintf_unfiltered (gdb_stdlog, "%s ", func);
3797 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch)
3798 && gdbarch_register_name (gdbarch, regno) != NULL
3799 && gdbarch_register_name (gdbarch, regno)[0] != '\0')
3800 fprintf_unfiltered (gdb_stdlog, "(%s)",
3801 gdbarch_register_name (gdbarch, regno));
3803 fprintf_unfiltered (gdb_stdlog, "(%d)", regno);
3804 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch))
3806 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
3807 int i, size = register_size (gdbarch, regno);
3808 gdb_byte buf[MAX_REGISTER_SIZE];
3810 regcache_raw_collect (regcache, regno, buf);
3811 fprintf_unfiltered (gdb_stdlog, " = ");
3812 for (i = 0; i < size; i++)
3814 fprintf_unfiltered (gdb_stdlog, "%02x", buf[i]);
3816 if (size <= sizeof (LONGEST))
3818 ULONGEST val = extract_unsigned_integer (buf, size, byte_order);
3820 fprintf_unfiltered (gdb_stdlog, " %s %s",
3821 core_addr_to_string_nz (val), plongest (val));
3824 fprintf_unfiltered (gdb_stdlog, "\n");
3828 target_fetch_registers (struct regcache *regcache, int regno)
3830 struct target_ops *t;
3832 for (t = current_target.beneath; t != NULL; t = t->beneath)
3834 if (t->to_fetch_registers != NULL)
3836 t->to_fetch_registers (t, regcache, regno);
3838 debug_print_register ("target_fetch_registers", regcache, regno);
3845 target_store_registers (struct regcache *regcache, int regno)
3847 struct target_ops *t;
3849 if (!may_write_registers)
3850 error (_("Writing to registers is not allowed (regno %d)"), regno);
3852 current_target.to_store_registers (¤t_target, regcache, regno);
3855 debug_print_register ("target_store_registers", regcache, regno);
3860 target_core_of_thread (ptid_t ptid)
3862 struct target_ops *t;
3864 for (t = current_target.beneath; t != NULL; t = t->beneath)
3866 if (t->to_core_of_thread != NULL)
3868 int retval = t->to_core_of_thread (t, ptid);
3871 fprintf_unfiltered (gdb_stdlog,
3872 "target_core_of_thread (%d) = %d\n",
3873 ptid_get_pid (ptid), retval);
3882 target_verify_memory (const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
3884 struct target_ops *t;
3886 for (t = current_target.beneath; t != NULL; t = t->beneath)
3888 if (t->to_verify_memory != NULL)
3890 int retval = t->to_verify_memory (t, data, memaddr, size);
3893 fprintf_unfiltered (gdb_stdlog,
3894 "target_verify_memory (%s, %s) = %d\n",
3895 paddress (target_gdbarch (), memaddr),
3905 /* The documentation for this function is in its prototype declaration in
3909 target_insert_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
3911 struct target_ops *t;
3913 for (t = current_target.beneath; t != NULL; t = t->beneath)
3914 if (t->to_insert_mask_watchpoint != NULL)
3918 ret = t->to_insert_mask_watchpoint (t, addr, mask, rw);
3921 fprintf_unfiltered (gdb_stdlog, "\
3922 target_insert_mask_watchpoint (%s, %s, %d) = %d\n",
3923 core_addr_to_string (addr),
3924 core_addr_to_string (mask), rw, ret);
3932 /* The documentation for this function is in its prototype declaration in
3936 target_remove_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
3938 struct target_ops *t;
3940 for (t = current_target.beneath; t != NULL; t = t->beneath)
3941 if (t->to_remove_mask_watchpoint != NULL)
3945 ret = t->to_remove_mask_watchpoint (t, addr, mask, rw);
3948 fprintf_unfiltered (gdb_stdlog, "\
3949 target_remove_mask_watchpoint (%s, %s, %d) = %d\n",
3950 core_addr_to_string (addr),
3951 core_addr_to_string (mask), rw, ret);
3959 /* The documentation for this function is in its prototype declaration
3963 target_masked_watch_num_registers (CORE_ADDR addr, CORE_ADDR mask)
3965 struct target_ops *t;
3967 for (t = current_target.beneath; t != NULL; t = t->beneath)
3968 if (t->to_masked_watch_num_registers != NULL)
3969 return t->to_masked_watch_num_registers (t, addr, mask);
3974 /* The documentation for this function is in its prototype declaration
3978 target_ranged_break_num_registers (void)
3980 struct target_ops *t;
3982 for (t = current_target.beneath; t != NULL; t = t->beneath)
3983 if (t->to_ranged_break_num_registers != NULL)
3984 return t->to_ranged_break_num_registers (t);
3991 struct btrace_target_info *
3992 target_enable_btrace (ptid_t ptid)
3994 struct target_ops *t;
3996 for (t = current_target.beneath; t != NULL; t = t->beneath)
3997 if (t->to_enable_btrace != NULL)
3998 return t->to_enable_btrace (t, ptid);
4007 target_disable_btrace (struct btrace_target_info *btinfo)
4009 struct target_ops *t;
4011 for (t = current_target.beneath; t != NULL; t = t->beneath)
4012 if (t->to_disable_btrace != NULL)
4014 t->to_disable_btrace (t, btinfo);
4024 target_teardown_btrace (struct btrace_target_info *btinfo)
4026 struct target_ops *t;
4028 for (t = current_target.beneath; t != NULL; t = t->beneath)
4029 if (t->to_teardown_btrace != NULL)
4031 t->to_teardown_btrace (t, btinfo);
4041 target_read_btrace (VEC (btrace_block_s) **btrace,
4042 struct btrace_target_info *btinfo,
4043 enum btrace_read_type type)
4045 struct target_ops *t;
4047 for (t = current_target.beneath; t != NULL; t = t->beneath)
4048 if (t->to_read_btrace != NULL)
4049 return t->to_read_btrace (t, btrace, btinfo, type);
4052 return BTRACE_ERR_NOT_SUPPORTED;
4058 target_stop_recording (void)
4060 struct target_ops *t;
4062 for (t = current_target.beneath; t != NULL; t = t->beneath)
4063 if (t->to_stop_recording != NULL)
4065 t->to_stop_recording (t);
4069 /* This is optional. */
4075 target_info_record (void)
4077 struct target_ops *t;
4079 for (t = current_target.beneath; t != NULL; t = t->beneath)
4080 if (t->to_info_record != NULL)
4082 t->to_info_record (t);
4092 target_save_record (const char *filename)
4094 struct target_ops *t;
4096 for (t = current_target.beneath; t != NULL; t = t->beneath)
4097 if (t->to_save_record != NULL)
4099 t->to_save_record (t, filename);
4109 target_supports_delete_record (void)
4111 struct target_ops *t;
4113 for (t = current_target.beneath; t != NULL; t = t->beneath)
4114 if (t->to_delete_record != NULL)
4123 target_delete_record (void)
4125 struct target_ops *t;
4127 for (t = current_target.beneath; t != NULL; t = t->beneath)
4128 if (t->to_delete_record != NULL)
4130 t->to_delete_record (t);
4140 target_record_is_replaying (void)
4142 struct target_ops *t;
4144 for (t = current_target.beneath; t != NULL; t = t->beneath)
4145 if (t->to_record_is_replaying != NULL)
4146 return t->to_record_is_replaying (t);
4154 target_goto_record_begin (void)
4156 struct target_ops *t;
4158 for (t = current_target.beneath; t != NULL; t = t->beneath)
4159 if (t->to_goto_record_begin != NULL)
4161 t->to_goto_record_begin (t);
4171 target_goto_record_end (void)
4173 struct target_ops *t;
4175 for (t = current_target.beneath; t != NULL; t = t->beneath)
4176 if (t->to_goto_record_end != NULL)
4178 t->to_goto_record_end (t);
4188 target_goto_record (ULONGEST insn)
4190 struct target_ops *t;
4192 for (t = current_target.beneath; t != NULL; t = t->beneath)
4193 if (t->to_goto_record != NULL)
4195 t->to_goto_record (t, insn);
4205 target_insn_history (int size, int flags)
4207 struct target_ops *t;
4209 for (t = current_target.beneath; t != NULL; t = t->beneath)
4210 if (t->to_insn_history != NULL)
4212 t->to_insn_history (t, size, flags);
4222 target_insn_history_from (ULONGEST from, int size, int flags)
4224 struct target_ops *t;
4226 for (t = current_target.beneath; t != NULL; t = t->beneath)
4227 if (t->to_insn_history_from != NULL)
4229 t->to_insn_history_from (t, from, size, flags);
4239 target_insn_history_range (ULONGEST begin, ULONGEST end, int flags)
4241 struct target_ops *t;
4243 for (t = current_target.beneath; t != NULL; t = t->beneath)
4244 if (t->to_insn_history_range != NULL)
4246 t->to_insn_history_range (t, begin, end, flags);
4256 target_call_history (int size, int flags)
4258 struct target_ops *t;
4260 for (t = current_target.beneath; t != NULL; t = t->beneath)
4261 if (t->to_call_history != NULL)
4263 t->to_call_history (t, size, flags);
4273 target_call_history_from (ULONGEST begin, int size, int flags)
4275 struct target_ops *t;
4277 for (t = current_target.beneath; t != NULL; t = t->beneath)
4278 if (t->to_call_history_from != NULL)
4280 t->to_call_history_from (t, begin, size, flags);
4290 target_call_history_range (ULONGEST begin, ULONGEST end, int flags)
4292 struct target_ops *t;
4294 for (t = current_target.beneath; t != NULL; t = t->beneath)
4295 if (t->to_call_history_range != NULL)
4297 t->to_call_history_range (t, begin, end, flags);
4305 debug_to_prepare_to_store (struct target_ops *self, struct regcache *regcache)
4307 debug_target.to_prepare_to_store (&debug_target, regcache);
4309 fprintf_unfiltered (gdb_stdlog, "target_prepare_to_store ()\n");
4314 const struct frame_unwind *
4315 target_get_unwinder (void)
4317 struct target_ops *t;
4319 for (t = current_target.beneath; t != NULL; t = t->beneath)
4320 if (t->to_get_unwinder != NULL)
4321 return t->to_get_unwinder;
4328 const struct frame_unwind *
4329 target_get_tailcall_unwinder (void)
4331 struct target_ops *t;
4333 for (t = current_target.beneath; t != NULL; t = t->beneath)
4334 if (t->to_get_tailcall_unwinder != NULL)
4335 return t->to_get_tailcall_unwinder;
4343 forward_target_decr_pc_after_break (struct target_ops *ops,
4344 struct gdbarch *gdbarch)
4346 for (; ops != NULL; ops = ops->beneath)
4347 if (ops->to_decr_pc_after_break != NULL)
4348 return ops->to_decr_pc_after_break (ops, gdbarch);
4350 return gdbarch_decr_pc_after_break (gdbarch);
4356 target_decr_pc_after_break (struct gdbarch *gdbarch)
4358 return forward_target_decr_pc_after_break (current_target.beneath, gdbarch);
4362 deprecated_debug_xfer_memory (CORE_ADDR memaddr, bfd_byte *myaddr, int len,
4363 int write, struct mem_attrib *attrib,
4364 struct target_ops *target)
4368 retval = debug_target.deprecated_xfer_memory (memaddr, myaddr, len, write,
4371 fprintf_unfiltered (gdb_stdlog,
4372 "target_xfer_memory (%s, xxx, %d, %s, xxx) = %d",
4373 paddress (target_gdbarch (), memaddr), len,
4374 write ? "write" : "read", retval);
4380 fputs_unfiltered (", bytes =", gdb_stdlog);
4381 for (i = 0; i < retval; i++)
4383 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
4385 if (targetdebug < 2 && i > 0)
4387 fprintf_unfiltered (gdb_stdlog, " ...");
4390 fprintf_unfiltered (gdb_stdlog, "\n");
4393 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
4397 fputc_unfiltered ('\n', gdb_stdlog);
4403 debug_to_files_info (struct target_ops *target)
4405 debug_target.to_files_info (target);
4407 fprintf_unfiltered (gdb_stdlog, "target_files_info (xxx)\n");
4411 debug_to_insert_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
4412 struct bp_target_info *bp_tgt)
4416 retval = debug_target.to_insert_breakpoint (&debug_target, gdbarch, bp_tgt);
4418 fprintf_unfiltered (gdb_stdlog,
4419 "target_insert_breakpoint (%s, xxx) = %ld\n",
4420 core_addr_to_string (bp_tgt->placed_address),
4421 (unsigned long) retval);
4426 debug_to_remove_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
4427 struct bp_target_info *bp_tgt)
4431 retval = debug_target.to_remove_breakpoint (&debug_target, gdbarch, bp_tgt);
4433 fprintf_unfiltered (gdb_stdlog,
4434 "target_remove_breakpoint (%s, xxx) = %ld\n",
4435 core_addr_to_string (bp_tgt->placed_address),
4436 (unsigned long) retval);
4441 debug_to_can_use_hw_breakpoint (struct target_ops *self,
4442 int type, int cnt, int from_tty)
4446 retval = debug_target.to_can_use_hw_breakpoint (&debug_target,
4447 type, cnt, from_tty);
4449 fprintf_unfiltered (gdb_stdlog,
4450 "target_can_use_hw_breakpoint (%ld, %ld, %ld) = %ld\n",
4451 (unsigned long) type,
4452 (unsigned long) cnt,
4453 (unsigned long) from_tty,
4454 (unsigned long) retval);
4459 debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
4460 CORE_ADDR addr, int len)
4464 retval = debug_target.to_region_ok_for_hw_watchpoint (&debug_target,
4467 fprintf_unfiltered (gdb_stdlog,
4468 "target_region_ok_for_hw_watchpoint (%s, %ld) = %s\n",
4469 core_addr_to_string (addr), (unsigned long) len,
4470 core_addr_to_string (retval));
4475 debug_to_can_accel_watchpoint_condition (struct target_ops *self,
4476 CORE_ADDR addr, int len, int rw,
4477 struct expression *cond)
4481 retval = debug_target.to_can_accel_watchpoint_condition (&debug_target,
4485 fprintf_unfiltered (gdb_stdlog,
4486 "target_can_accel_watchpoint_condition "
4487 "(%s, %d, %d, %s) = %ld\n",
4488 core_addr_to_string (addr), len, rw,
4489 host_address_to_string (cond), (unsigned long) retval);
4494 debug_to_stopped_by_watchpoint (struct target_ops *ops)
4498 retval = debug_target.to_stopped_by_watchpoint (&debug_target);
4500 fprintf_unfiltered (gdb_stdlog,
4501 "target_stopped_by_watchpoint () = %ld\n",
4502 (unsigned long) retval);
4507 debug_to_stopped_data_address (struct target_ops *target, CORE_ADDR *addr)
4511 retval = debug_target.to_stopped_data_address (target, addr);
4513 fprintf_unfiltered (gdb_stdlog,
4514 "target_stopped_data_address ([%s]) = %ld\n",
4515 core_addr_to_string (*addr),
4516 (unsigned long)retval);
4521 debug_to_watchpoint_addr_within_range (struct target_ops *target,
4523 CORE_ADDR start, int length)
4527 retval = debug_target.to_watchpoint_addr_within_range (target, addr,
4530 fprintf_filtered (gdb_stdlog,
4531 "target_watchpoint_addr_within_range (%s, %s, %d) = %d\n",
4532 core_addr_to_string (addr), core_addr_to_string (start),
4538 debug_to_insert_hw_breakpoint (struct target_ops *self,
4539 struct gdbarch *gdbarch,
4540 struct bp_target_info *bp_tgt)
4544 retval = debug_target.to_insert_hw_breakpoint (&debug_target,
4547 fprintf_unfiltered (gdb_stdlog,
4548 "target_insert_hw_breakpoint (%s, xxx) = %ld\n",
4549 core_addr_to_string (bp_tgt->placed_address),
4550 (unsigned long) retval);
4555 debug_to_remove_hw_breakpoint (struct target_ops *self,
4556 struct gdbarch *gdbarch,
4557 struct bp_target_info *bp_tgt)
4561 retval = debug_target.to_remove_hw_breakpoint (&debug_target,
4564 fprintf_unfiltered (gdb_stdlog,
4565 "target_remove_hw_breakpoint (%s, xxx) = %ld\n",
4566 core_addr_to_string (bp_tgt->placed_address),
4567 (unsigned long) retval);
4572 debug_to_insert_watchpoint (struct target_ops *self,
4573 CORE_ADDR addr, int len, int type,
4574 struct expression *cond)
4578 retval = debug_target.to_insert_watchpoint (&debug_target,
4579 addr, len, type, cond);
4581 fprintf_unfiltered (gdb_stdlog,
4582 "target_insert_watchpoint (%s, %d, %d, %s) = %ld\n",
4583 core_addr_to_string (addr), len, type,
4584 host_address_to_string (cond), (unsigned long) retval);
4589 debug_to_remove_watchpoint (struct target_ops *self,
4590 CORE_ADDR addr, int len, int type,
4591 struct expression *cond)
4595 retval = debug_target.to_remove_watchpoint (&debug_target,
4596 addr, len, type, cond);
4598 fprintf_unfiltered (gdb_stdlog,
4599 "target_remove_watchpoint (%s, %d, %d, %s) = %ld\n",
4600 core_addr_to_string (addr), len, type,
4601 host_address_to_string (cond), (unsigned long) retval);
4606 debug_to_terminal_init (struct target_ops *self)
4608 debug_target.to_terminal_init (&debug_target);
4610 fprintf_unfiltered (gdb_stdlog, "target_terminal_init ()\n");
4614 debug_to_terminal_inferior (struct target_ops *self)
4616 debug_target.to_terminal_inferior (&debug_target);
4618 fprintf_unfiltered (gdb_stdlog, "target_terminal_inferior ()\n");
4622 debug_to_terminal_ours_for_output (struct target_ops *self)
4624 debug_target.to_terminal_ours_for_output (&debug_target);
4626 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours_for_output ()\n");
4630 debug_to_terminal_ours (struct target_ops *self)
4632 debug_target.to_terminal_ours (&debug_target);
4634 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours ()\n");
4638 debug_to_terminal_save_ours (struct target_ops *self)
4640 debug_target.to_terminal_save_ours (&debug_target);
4642 fprintf_unfiltered (gdb_stdlog, "target_terminal_save_ours ()\n");
4646 debug_to_terminal_info (struct target_ops *self,
4647 const char *arg, int from_tty)
4649 debug_target.to_terminal_info (&debug_target, arg, from_tty);
4651 fprintf_unfiltered (gdb_stdlog, "target_terminal_info (%s, %d)\n", arg,
4656 debug_to_load (struct target_ops *self, char *args, int from_tty)
4658 debug_target.to_load (&debug_target, args, from_tty);
4660 fprintf_unfiltered (gdb_stdlog, "target_load (%s, %d)\n", args, from_tty);
4664 debug_to_post_startup_inferior (struct target_ops *self, ptid_t ptid)
4666 debug_target.to_post_startup_inferior (&debug_target, ptid);
4668 fprintf_unfiltered (gdb_stdlog, "target_post_startup_inferior (%d)\n",
4669 ptid_get_pid (ptid));
4673 debug_to_insert_fork_catchpoint (struct target_ops *self, int pid)
4677 retval = debug_target.to_insert_fork_catchpoint (&debug_target, pid);
4679 fprintf_unfiltered (gdb_stdlog, "target_insert_fork_catchpoint (%d) = %d\n",
4686 debug_to_remove_fork_catchpoint (struct target_ops *self, int pid)
4690 retval = debug_target.to_remove_fork_catchpoint (&debug_target, pid);
4692 fprintf_unfiltered (gdb_stdlog, "target_remove_fork_catchpoint (%d) = %d\n",
4699 debug_to_insert_vfork_catchpoint (struct target_ops *self, int pid)
4703 retval = debug_target.to_insert_vfork_catchpoint (&debug_target, pid);
4705 fprintf_unfiltered (gdb_stdlog, "target_insert_vfork_catchpoint (%d) = %d\n",
4712 debug_to_remove_vfork_catchpoint (struct target_ops *self, int pid)
4716 retval = debug_target.to_remove_vfork_catchpoint (&debug_target, pid);
4718 fprintf_unfiltered (gdb_stdlog, "target_remove_vfork_catchpoint (%d) = %d\n",
4725 debug_to_insert_exec_catchpoint (struct target_ops *self, int pid)
4729 retval = debug_target.to_insert_exec_catchpoint (&debug_target, pid);
4731 fprintf_unfiltered (gdb_stdlog, "target_insert_exec_catchpoint (%d) = %d\n",
4738 debug_to_remove_exec_catchpoint (struct target_ops *self, int pid)
4742 retval = debug_target.to_remove_exec_catchpoint (&debug_target, pid);
4744 fprintf_unfiltered (gdb_stdlog, "target_remove_exec_catchpoint (%d) = %d\n",
4751 debug_to_has_exited (struct target_ops *self,
4752 int pid, int wait_status, int *exit_status)
4756 has_exited = debug_target.to_has_exited (&debug_target,
4757 pid, wait_status, exit_status);
4759 fprintf_unfiltered (gdb_stdlog, "target_has_exited (%d, %d, %d) = %d\n",
4760 pid, wait_status, *exit_status, has_exited);
4766 debug_to_can_run (struct target_ops *self)
4770 retval = debug_target.to_can_run (&debug_target);
4772 fprintf_unfiltered (gdb_stdlog, "target_can_run () = %d\n", retval);
4777 static struct gdbarch *
4778 debug_to_thread_architecture (struct target_ops *ops, ptid_t ptid)
4780 struct gdbarch *retval;
4782 retval = debug_target.to_thread_architecture (ops, ptid);
4784 fprintf_unfiltered (gdb_stdlog,
4785 "target_thread_architecture (%s) = %s [%s]\n",
4786 target_pid_to_str (ptid),
4787 host_address_to_string (retval),
4788 gdbarch_bfd_arch_info (retval)->printable_name);
4793 debug_to_stop (struct target_ops *self, ptid_t ptid)
4795 debug_target.to_stop (&debug_target, ptid);
4797 fprintf_unfiltered (gdb_stdlog, "target_stop (%s)\n",
4798 target_pid_to_str (ptid));
4802 debug_to_rcmd (struct target_ops *self, char *command,
4803 struct ui_file *outbuf)
4805 debug_target.to_rcmd (&debug_target, command, outbuf);
4806 fprintf_unfiltered (gdb_stdlog, "target_rcmd (%s, ...)\n", command);
4810 debug_to_pid_to_exec_file (struct target_ops *self, int pid)
4814 exec_file = debug_target.to_pid_to_exec_file (&debug_target, pid);
4816 fprintf_unfiltered (gdb_stdlog, "target_pid_to_exec_file (%d) = %s\n",
4823 setup_target_debug (void)
4825 memcpy (&debug_target, ¤t_target, sizeof debug_target);
4827 current_target.to_open = debug_to_open;
4828 current_target.to_post_attach = debug_to_post_attach;
4829 current_target.to_prepare_to_store = debug_to_prepare_to_store;
4830 current_target.deprecated_xfer_memory = deprecated_debug_xfer_memory;
4831 current_target.to_files_info = debug_to_files_info;
4832 current_target.to_insert_breakpoint = debug_to_insert_breakpoint;
4833 current_target.to_remove_breakpoint = debug_to_remove_breakpoint;
4834 current_target.to_can_use_hw_breakpoint = debug_to_can_use_hw_breakpoint;
4835 current_target.to_insert_hw_breakpoint = debug_to_insert_hw_breakpoint;
4836 current_target.to_remove_hw_breakpoint = debug_to_remove_hw_breakpoint;
4837 current_target.to_insert_watchpoint = debug_to_insert_watchpoint;
4838 current_target.to_remove_watchpoint = debug_to_remove_watchpoint;
4839 current_target.to_stopped_by_watchpoint = debug_to_stopped_by_watchpoint;
4840 current_target.to_stopped_data_address = debug_to_stopped_data_address;
4841 current_target.to_watchpoint_addr_within_range
4842 = debug_to_watchpoint_addr_within_range;
4843 current_target.to_region_ok_for_hw_watchpoint
4844 = debug_to_region_ok_for_hw_watchpoint;
4845 current_target.to_can_accel_watchpoint_condition
4846 = debug_to_can_accel_watchpoint_condition;
4847 current_target.to_terminal_init = debug_to_terminal_init;
4848 current_target.to_terminal_inferior = debug_to_terminal_inferior;
4849 current_target.to_terminal_ours_for_output
4850 = debug_to_terminal_ours_for_output;
4851 current_target.to_terminal_ours = debug_to_terminal_ours;
4852 current_target.to_terminal_save_ours = debug_to_terminal_save_ours;
4853 current_target.to_terminal_info = debug_to_terminal_info;
4854 current_target.to_load = debug_to_load;
4855 current_target.to_post_startup_inferior = debug_to_post_startup_inferior;
4856 current_target.to_insert_fork_catchpoint = debug_to_insert_fork_catchpoint;
4857 current_target.to_remove_fork_catchpoint = debug_to_remove_fork_catchpoint;
4858 current_target.to_insert_vfork_catchpoint = debug_to_insert_vfork_catchpoint;
4859 current_target.to_remove_vfork_catchpoint = debug_to_remove_vfork_catchpoint;
4860 current_target.to_insert_exec_catchpoint = debug_to_insert_exec_catchpoint;
4861 current_target.to_remove_exec_catchpoint = debug_to_remove_exec_catchpoint;
4862 current_target.to_has_exited = debug_to_has_exited;
4863 current_target.to_can_run = debug_to_can_run;
4864 current_target.to_stop = debug_to_stop;
4865 current_target.to_rcmd = debug_to_rcmd;
4866 current_target.to_pid_to_exec_file = debug_to_pid_to_exec_file;
4867 current_target.to_thread_architecture = debug_to_thread_architecture;
4871 static char targ_desc[] =
4872 "Names of targets and files being debugged.\nShows the entire \
4873 stack of targets currently in use (including the exec-file,\n\
4874 core-file, and process, if any), as well as the symbol file name.";
4877 default_rcmd (struct target_ops *self, char *command, struct ui_file *output)
4879 error (_("\"monitor\" command not supported by this target."));
4883 do_monitor_command (char *cmd,
4886 target_rcmd (cmd, gdb_stdtarg);
4889 /* Print the name of each layers of our target stack. */
4892 maintenance_print_target_stack (char *cmd, int from_tty)
4894 struct target_ops *t;
4896 printf_filtered (_("The current target stack is:\n"));
4898 for (t = target_stack; t != NULL; t = t->beneath)
4900 printf_filtered (" - %s (%s)\n", t->to_shortname, t->to_longname);
4904 /* Controls if async mode is permitted. */
4905 int target_async_permitted = 0;
4907 /* The set command writes to this variable. If the inferior is
4908 executing, target_async_permitted is *not* updated. */
4909 static int target_async_permitted_1 = 0;
4912 set_target_async_command (char *args, int from_tty,
4913 struct cmd_list_element *c)
4915 if (have_live_inferiors ())
4917 target_async_permitted_1 = target_async_permitted;
4918 error (_("Cannot change this setting while the inferior is running."));
4921 target_async_permitted = target_async_permitted_1;
4925 show_target_async_command (struct ui_file *file, int from_tty,
4926 struct cmd_list_element *c,
4929 fprintf_filtered (file,
4930 _("Controlling the inferior in "
4931 "asynchronous mode is %s.\n"), value);
4934 /* Temporary copies of permission settings. */
4936 static int may_write_registers_1 = 1;
4937 static int may_write_memory_1 = 1;
4938 static int may_insert_breakpoints_1 = 1;
4939 static int may_insert_tracepoints_1 = 1;
4940 static int may_insert_fast_tracepoints_1 = 1;
4941 static int may_stop_1 = 1;
4943 /* Make the user-set values match the real values again. */
4946 update_target_permissions (void)
4948 may_write_registers_1 = may_write_registers;
4949 may_write_memory_1 = may_write_memory;
4950 may_insert_breakpoints_1 = may_insert_breakpoints;
4951 may_insert_tracepoints_1 = may_insert_tracepoints;
4952 may_insert_fast_tracepoints_1 = may_insert_fast_tracepoints;
4953 may_stop_1 = may_stop;
4956 /* The one function handles (most of) the permission flags in the same
4960 set_target_permissions (char *args, int from_tty,
4961 struct cmd_list_element *c)
4963 if (target_has_execution)
4965 update_target_permissions ();
4966 error (_("Cannot change this setting while the inferior is running."));
4969 /* Make the real values match the user-changed values. */
4970 may_write_registers = may_write_registers_1;
4971 may_insert_breakpoints = may_insert_breakpoints_1;
4972 may_insert_tracepoints = may_insert_tracepoints_1;
4973 may_insert_fast_tracepoints = may_insert_fast_tracepoints_1;
4974 may_stop = may_stop_1;
4975 update_observer_mode ();
4978 /* Set memory write permission independently of observer mode. */
4981 set_write_memory_permission (char *args, int from_tty,
4982 struct cmd_list_element *c)
4984 /* Make the real values match the user-changed values. */
4985 may_write_memory = may_write_memory_1;
4986 update_observer_mode ();
4991 initialize_targets (void)
4993 init_dummy_target ();
4994 push_target (&dummy_target);
4996 add_info ("target", target_info, targ_desc);
4997 add_info ("files", target_info, targ_desc);
4999 add_setshow_zuinteger_cmd ("target", class_maintenance, &targetdebug, _("\
5000 Set target debugging."), _("\
5001 Show target debugging."), _("\
5002 When non-zero, target debugging is enabled. Higher numbers are more\n\
5003 verbose. Changes do not take effect until the next \"run\" or \"target\"\n\
5007 &setdebuglist, &showdebuglist);
5009 add_setshow_boolean_cmd ("trust-readonly-sections", class_support,
5010 &trust_readonly, _("\
5011 Set mode for reading from readonly sections."), _("\
5012 Show mode for reading from readonly sections."), _("\
5013 When this mode is on, memory reads from readonly sections (such as .text)\n\
5014 will be read from the object file instead of from the target. This will\n\
5015 result in significant performance improvement for remote targets."),
5017 show_trust_readonly,
5018 &setlist, &showlist);
5020 add_com ("monitor", class_obscure, do_monitor_command,
5021 _("Send a command to the remote monitor (remote targets only)."));
5023 add_cmd ("target-stack", class_maintenance, maintenance_print_target_stack,
5024 _("Print the name of each layer of the internal target stack."),
5025 &maintenanceprintlist);
5027 add_setshow_boolean_cmd ("target-async", no_class,
5028 &target_async_permitted_1, _("\
5029 Set whether gdb controls the inferior in asynchronous mode."), _("\
5030 Show whether gdb controls the inferior in asynchronous mode."), _("\
5031 Tells gdb whether to control the inferior in asynchronous mode."),
5032 set_target_async_command,
5033 show_target_async_command,
5037 add_setshow_boolean_cmd ("may-write-registers", class_support,
5038 &may_write_registers_1, _("\
5039 Set permission to write into registers."), _("\
5040 Show permission to write into registers."), _("\
5041 When this permission is on, GDB may write into the target's registers.\n\
5042 Otherwise, any sort of write attempt will result in an error."),
5043 set_target_permissions, NULL,
5044 &setlist, &showlist);
5046 add_setshow_boolean_cmd ("may-write-memory", class_support,
5047 &may_write_memory_1, _("\
5048 Set permission to write into target memory."), _("\
5049 Show permission to write into target memory."), _("\
5050 When this permission is on, GDB may write into the target's memory.\n\
5051 Otherwise, any sort of write attempt will result in an error."),
5052 set_write_memory_permission, NULL,
5053 &setlist, &showlist);
5055 add_setshow_boolean_cmd ("may-insert-breakpoints", class_support,
5056 &may_insert_breakpoints_1, _("\
5057 Set permission to insert breakpoints in the target."), _("\
5058 Show permission to insert breakpoints in the target."), _("\
5059 When this permission is on, GDB may insert breakpoints in the program.\n\
5060 Otherwise, any sort of insertion attempt will result in an error."),
5061 set_target_permissions, NULL,
5062 &setlist, &showlist);
5064 add_setshow_boolean_cmd ("may-insert-tracepoints", class_support,
5065 &may_insert_tracepoints_1, _("\
5066 Set permission to insert tracepoints in the target."), _("\
5067 Show permission to insert tracepoints in the target."), _("\
5068 When this permission is on, GDB may insert tracepoints in the program.\n\
5069 Otherwise, any sort of insertion attempt will result in an error."),
5070 set_target_permissions, NULL,
5071 &setlist, &showlist);
5073 add_setshow_boolean_cmd ("may-insert-fast-tracepoints", class_support,
5074 &may_insert_fast_tracepoints_1, _("\
5075 Set permission to insert fast tracepoints in the target."), _("\
5076 Show permission to insert fast tracepoints in the target."), _("\
5077 When this permission is on, GDB may insert fast tracepoints.\n\
5078 Otherwise, any sort of insertion attempt will result in an error."),
5079 set_target_permissions, NULL,
5080 &setlist, &showlist);
5082 add_setshow_boolean_cmd ("may-interrupt", class_support,
5084 Set permission to interrupt or signal the target."), _("\
5085 Show permission to interrupt or signal the target."), _("\
5086 When this permission is on, GDB may interrupt/stop the target's execution.\n\
5087 Otherwise, any attempt to interrupt or stop will be ignored."),
5088 set_target_permissions, NULL,
5089 &setlist, &showlist);