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"
37 #include "gdb_assert.h"
39 #include "exceptions.h"
40 #include "target-descriptions.h"
41 #include "gdbthread.h"
44 #include "inline-frame.h"
45 #include "tracepoint.h"
46 #include "gdb/fileio.h"
50 static void target_info (char *, int);
52 static void default_terminal_info (struct target_ops *, const char *, int);
54 static int default_watchpoint_addr_within_range (struct target_ops *,
55 CORE_ADDR, CORE_ADDR, int);
57 static int default_region_ok_for_hw_watchpoint (struct target_ops *,
60 static void default_rcmd (struct target_ops *, const char *, struct ui_file *);
62 static ptid_t default_get_ada_task_ptid (struct target_ops *self,
65 static int default_follow_fork (struct target_ops *self, int follow_child,
68 static void default_mourn_inferior (struct target_ops *self);
70 static int default_search_memory (struct target_ops *ops,
72 ULONGEST search_space_len,
73 const gdb_byte *pattern,
75 CORE_ADDR *found_addrp);
77 static int default_verify_memory (struct target_ops *self,
79 CORE_ADDR memaddr, ULONGEST size);
81 static struct address_space *default_thread_address_space
82 (struct target_ops *self, ptid_t ptid);
84 static void tcomplain (void) ATTRIBUTE_NORETURN;
86 static int return_zero (struct target_ops *);
88 static int return_zero_has_execution (struct target_ops *, ptid_t);
90 static void target_command (char *, int);
92 static struct target_ops *find_default_run_target (char *);
94 static struct gdbarch *default_thread_architecture (struct target_ops *ops,
97 static int dummy_find_memory_regions (struct target_ops *self,
98 find_memory_region_ftype ignore1,
101 static char *dummy_make_corefile_notes (struct target_ops *self,
102 bfd *ignore1, int *ignore2);
104 static char *default_pid_to_str (struct target_ops *ops, ptid_t ptid);
106 static enum exec_direction_kind default_execution_direction
107 (struct target_ops *self);
109 static CORE_ADDR default_target_decr_pc_after_break (struct target_ops *ops,
110 struct gdbarch *gdbarch);
112 #include "target-delegates.c"
114 static void init_dummy_target (void);
116 static struct target_ops debug_target;
118 static void debug_to_open (char *, int);
120 static void debug_to_prepare_to_store (struct target_ops *self,
123 static void debug_to_files_info (struct target_ops *);
125 static int debug_to_insert_breakpoint (struct target_ops *, struct gdbarch *,
126 struct bp_target_info *);
128 static int debug_to_remove_breakpoint (struct target_ops *, struct gdbarch *,
129 struct bp_target_info *);
131 static int debug_to_can_use_hw_breakpoint (struct target_ops *self,
134 static int debug_to_insert_hw_breakpoint (struct target_ops *self,
136 struct bp_target_info *);
138 static int debug_to_remove_hw_breakpoint (struct target_ops *self,
140 struct bp_target_info *);
142 static int debug_to_insert_watchpoint (struct target_ops *self,
144 struct expression *);
146 static int debug_to_remove_watchpoint (struct target_ops *self,
148 struct expression *);
150 static int debug_to_stopped_data_address (struct target_ops *, CORE_ADDR *);
152 static int debug_to_watchpoint_addr_within_range (struct target_ops *,
153 CORE_ADDR, CORE_ADDR, int);
155 static int debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
158 static int debug_to_can_accel_watchpoint_condition (struct target_ops *self,
160 struct expression *);
162 static void debug_to_terminal_init (struct target_ops *self);
164 static void debug_to_terminal_inferior (struct target_ops *self);
166 static void debug_to_terminal_ours_for_output (struct target_ops *self);
168 static void debug_to_terminal_save_ours (struct target_ops *self);
170 static void debug_to_terminal_ours (struct target_ops *self);
172 static void debug_to_load (struct target_ops *self, const char *, int);
174 static int debug_to_can_run (struct target_ops *self);
176 static void debug_to_stop (struct target_ops *self, ptid_t);
178 /* Pointer to array of target architecture structures; the size of the
179 array; the current index into the array; the allocated size of the
181 struct target_ops **target_structs;
182 unsigned target_struct_size;
183 unsigned target_struct_allocsize;
184 #define DEFAULT_ALLOCSIZE 10
186 /* The initial current target, so that there is always a semi-valid
189 static struct target_ops dummy_target;
191 /* Top of target stack. */
193 static struct target_ops *target_stack;
195 /* The target structure we are currently using to talk to a process
196 or file or whatever "inferior" we have. */
198 struct target_ops current_target;
200 /* Command list for target. */
202 static struct cmd_list_element *targetlist = NULL;
204 /* Nonzero if we should trust readonly sections from the
205 executable when reading memory. */
207 static int trust_readonly = 0;
209 /* Nonzero if we should show true memory content including
210 memory breakpoint inserted by gdb. */
212 static int show_memory_breakpoints = 0;
214 /* These globals control whether GDB attempts to perform these
215 operations; they are useful for targets that need to prevent
216 inadvertant disruption, such as in non-stop mode. */
218 int may_write_registers = 1;
220 int may_write_memory = 1;
222 int may_insert_breakpoints = 1;
224 int may_insert_tracepoints = 1;
226 int may_insert_fast_tracepoints = 1;
230 /* Non-zero if we want to see trace of target level stuff. */
232 static unsigned int targetdebug = 0;
234 show_targetdebug (struct ui_file *file, int from_tty,
235 struct cmd_list_element *c, const char *value)
237 fprintf_filtered (file, _("Target debugging is %s.\n"), value);
240 static void setup_target_debug (void);
242 /* The user just typed 'target' without the name of a target. */
245 target_command (char *arg, int from_tty)
247 fputs_filtered ("Argument required (target name). Try `help target'\n",
251 /* Default target_has_* methods for process_stratum targets. */
254 default_child_has_all_memory (struct target_ops *ops)
256 /* If no inferior selected, then we can't read memory here. */
257 if (ptid_equal (inferior_ptid, null_ptid))
264 default_child_has_memory (struct target_ops *ops)
266 /* If no inferior selected, then we can't read memory here. */
267 if (ptid_equal (inferior_ptid, null_ptid))
274 default_child_has_stack (struct target_ops *ops)
276 /* If no inferior selected, there's no stack. */
277 if (ptid_equal (inferior_ptid, null_ptid))
284 default_child_has_registers (struct target_ops *ops)
286 /* Can't read registers from no inferior. */
287 if (ptid_equal (inferior_ptid, null_ptid))
294 default_child_has_execution (struct target_ops *ops, ptid_t the_ptid)
296 /* If there's no thread selected, then we can't make it run through
298 if (ptid_equal (the_ptid, null_ptid))
306 target_has_all_memory_1 (void)
308 struct target_ops *t;
310 for (t = current_target.beneath; t != NULL; t = t->beneath)
311 if (t->to_has_all_memory (t))
318 target_has_memory_1 (void)
320 struct target_ops *t;
322 for (t = current_target.beneath; t != NULL; t = t->beneath)
323 if (t->to_has_memory (t))
330 target_has_stack_1 (void)
332 struct target_ops *t;
334 for (t = current_target.beneath; t != NULL; t = t->beneath)
335 if (t->to_has_stack (t))
342 target_has_registers_1 (void)
344 struct target_ops *t;
346 for (t = current_target.beneath; t != NULL; t = t->beneath)
347 if (t->to_has_registers (t))
354 target_has_execution_1 (ptid_t the_ptid)
356 struct target_ops *t;
358 for (t = current_target.beneath; t != NULL; t = t->beneath)
359 if (t->to_has_execution (t, the_ptid))
366 target_has_execution_current (void)
368 return target_has_execution_1 (inferior_ptid);
371 /* Complete initialization of T. This ensures that various fields in
372 T are set, if needed by the target implementation. */
375 complete_target_initialization (struct target_ops *t)
377 /* Provide default values for all "must have" methods. */
379 if (t->to_has_all_memory == NULL)
380 t->to_has_all_memory = return_zero;
382 if (t->to_has_memory == NULL)
383 t->to_has_memory = return_zero;
385 if (t->to_has_stack == NULL)
386 t->to_has_stack = return_zero;
388 if (t->to_has_registers == NULL)
389 t->to_has_registers = return_zero;
391 if (t->to_has_execution == NULL)
392 t->to_has_execution = return_zero_has_execution;
394 /* These methods can be called on an unpushed target and so require
395 a default implementation if the target might plausibly be the
396 default run target. */
397 gdb_assert (t->to_can_run == NULL || (t->to_can_async_p != NULL
398 && t->to_supports_non_stop != NULL));
400 install_delegators (t);
403 /* Add possible target architecture T to the list and add a new
404 command 'target T->to_shortname'. Set COMPLETER as the command's
405 completer if not NULL. */
408 add_target_with_completer (struct target_ops *t,
409 completer_ftype *completer)
411 struct cmd_list_element *c;
413 complete_target_initialization (t);
417 target_struct_allocsize = DEFAULT_ALLOCSIZE;
418 target_structs = (struct target_ops **) xmalloc
419 (target_struct_allocsize * sizeof (*target_structs));
421 if (target_struct_size >= target_struct_allocsize)
423 target_struct_allocsize *= 2;
424 target_structs = (struct target_ops **)
425 xrealloc ((char *) target_structs,
426 target_struct_allocsize * sizeof (*target_structs));
428 target_structs[target_struct_size++] = t;
430 if (targetlist == NULL)
431 add_prefix_cmd ("target", class_run, target_command, _("\
432 Connect to a target machine or process.\n\
433 The first argument is the type or protocol of the target machine.\n\
434 Remaining arguments are interpreted by the target protocol. For more\n\
435 information on the arguments for a particular protocol, type\n\
436 `help target ' followed by the protocol name."),
437 &targetlist, "target ", 0, &cmdlist);
438 c = add_cmd (t->to_shortname, no_class, t->to_open, t->to_doc,
440 if (completer != NULL)
441 set_cmd_completer (c, completer);
444 /* Add a possible target architecture to the list. */
447 add_target (struct target_ops *t)
449 add_target_with_completer (t, NULL);
455 add_deprecated_target_alias (struct target_ops *t, char *alias)
457 struct cmd_list_element *c;
460 /* If we use add_alias_cmd, here, we do not get the deprecated warning,
462 c = add_cmd (alias, no_class, t->to_open, t->to_doc, &targetlist);
463 alt = xstrprintf ("target %s", t->to_shortname);
464 deprecate_cmd (c, alt);
473 fprintf_unfiltered (gdb_stdlog, "target_kill ()\n");
475 current_target.to_kill (¤t_target);
479 target_load (const char *arg, int from_tty)
481 target_dcache_invalidate ();
482 (*current_target.to_load) (¤t_target, arg, from_tty);
486 target_terminal_inferior (void)
488 /* A background resume (``run&'') should leave GDB in control of the
489 terminal. Use target_can_async_p, not target_is_async_p, since at
490 this point the target is not async yet. However, if sync_execution
491 is not set, we know it will become async prior to resume. */
492 if (target_can_async_p () && !sync_execution)
495 /* If GDB is resuming the inferior in the foreground, install
496 inferior's terminal modes. */
497 (*current_target.to_terminal_inferior) (¤t_target);
503 error (_("You can't do that when your target is `%s'"),
504 current_target.to_shortname);
510 error (_("You can't do that without a process to debug."));
514 default_terminal_info (struct target_ops *self, const char *args, int from_tty)
516 printf_unfiltered (_("No saved terminal information.\n"));
519 /* A default implementation for the to_get_ada_task_ptid target method.
521 This function builds the PTID by using both LWP and TID as part of
522 the PTID lwp and tid elements. The pid used is the pid of the
526 default_get_ada_task_ptid (struct target_ops *self, long lwp, long tid)
528 return ptid_build (ptid_get_pid (inferior_ptid), lwp, tid);
531 static enum exec_direction_kind
532 default_execution_direction (struct target_ops *self)
534 if (!target_can_execute_reverse)
536 else if (!target_can_async_p ())
539 gdb_assert_not_reached ("\
540 to_execution_direction must be implemented for reverse async");
543 /* Go through the target stack from top to bottom, copying over zero
544 entries in current_target, then filling in still empty entries. In
545 effect, we are doing class inheritance through the pushed target
548 NOTE: cagney/2003-10-17: The problem with this inheritance, as it
549 is currently implemented, is that it discards any knowledge of
550 which target an inherited method originally belonged to.
551 Consequently, new new target methods should instead explicitly and
552 locally search the target stack for the target that can handle the
556 update_current_target (void)
558 struct target_ops *t;
560 /* First, reset current's contents. */
561 memset (¤t_target, 0, sizeof (current_target));
563 /* Install the delegators. */
564 install_delegators (¤t_target);
566 current_target.to_stratum = target_stack->to_stratum;
568 #define INHERIT(FIELD, TARGET) \
569 if (!current_target.FIELD) \
570 current_target.FIELD = (TARGET)->FIELD
572 /* Do not add any new INHERITs here. Instead, use the delegation
573 mechanism provided by make-target-delegates. */
574 for (t = target_stack; t; t = t->beneath)
576 INHERIT (to_shortname, t);
577 INHERIT (to_longname, t);
578 INHERIT (to_attach_no_wait, t);
579 INHERIT (to_have_steppable_watchpoint, t);
580 INHERIT (to_have_continuable_watchpoint, t);
581 INHERIT (to_has_thread_control, t);
585 /* Finally, position the target-stack beneath the squashed
586 "current_target". That way code looking for a non-inherited
587 target method can quickly and simply find it. */
588 current_target.beneath = target_stack;
591 setup_target_debug ();
594 /* Push a new target type into the stack of the existing target accessors,
595 possibly superseding some of the existing accessors.
597 Rather than allow an empty stack, we always have the dummy target at
598 the bottom stratum, so we can call the function vectors without
602 push_target (struct target_ops *t)
604 struct target_ops **cur;
606 /* Check magic number. If wrong, it probably means someone changed
607 the struct definition, but not all the places that initialize one. */
608 if (t->to_magic != OPS_MAGIC)
610 fprintf_unfiltered (gdb_stderr,
611 "Magic number of %s target struct wrong\n",
613 internal_error (__FILE__, __LINE__,
614 _("failed internal consistency check"));
617 /* Find the proper stratum to install this target in. */
618 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
620 if ((int) (t->to_stratum) >= (int) (*cur)->to_stratum)
624 /* If there's already targets at this stratum, remove them. */
625 /* FIXME: cagney/2003-10-15: I think this should be popping all
626 targets to CUR, and not just those at this stratum level. */
627 while ((*cur) != NULL && t->to_stratum == (*cur)->to_stratum)
629 /* There's already something at this stratum level. Close it,
630 and un-hook it from the stack. */
631 struct target_ops *tmp = (*cur);
633 (*cur) = (*cur)->beneath;
638 /* We have removed all targets in our stratum, now add the new one. */
642 update_current_target ();
645 /* Remove a target_ops vector from the stack, wherever it may be.
646 Return how many times it was removed (0 or 1). */
649 unpush_target (struct target_ops *t)
651 struct target_ops **cur;
652 struct target_ops *tmp;
654 if (t->to_stratum == dummy_stratum)
655 internal_error (__FILE__, __LINE__,
656 _("Attempt to unpush the dummy target"));
658 /* Look for the specified target. Note that we assume that a target
659 can only occur once in the target stack. */
661 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
667 /* If we don't find target_ops, quit. Only open targets should be
672 /* Unchain the target. */
674 (*cur) = (*cur)->beneath;
677 update_current_target ();
679 /* Finally close the target. Note we do this after unchaining, so
680 any target method calls from within the target_close
681 implementation don't end up in T anymore. */
688 pop_all_targets_above (enum strata above_stratum)
690 while ((int) (current_target.to_stratum) > (int) above_stratum)
692 if (!unpush_target (target_stack))
694 fprintf_unfiltered (gdb_stderr,
695 "pop_all_targets couldn't find target %s\n",
696 target_stack->to_shortname);
697 internal_error (__FILE__, __LINE__,
698 _("failed internal consistency check"));
705 pop_all_targets (void)
707 pop_all_targets_above (dummy_stratum);
710 /* Return 1 if T is now pushed in the target stack. Return 0 otherwise. */
713 target_is_pushed (struct target_ops *t)
715 struct target_ops **cur;
717 /* Check magic number. If wrong, it probably means someone changed
718 the struct definition, but not all the places that initialize one. */
719 if (t->to_magic != OPS_MAGIC)
721 fprintf_unfiltered (gdb_stderr,
722 "Magic number of %s target struct wrong\n",
724 internal_error (__FILE__, __LINE__,
725 _("failed internal consistency check"));
728 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
735 /* Using the objfile specified in OBJFILE, find the address for the
736 current thread's thread-local storage with offset OFFSET. */
738 target_translate_tls_address (struct objfile *objfile, CORE_ADDR offset)
740 volatile CORE_ADDR addr = 0;
741 struct target_ops *target;
743 for (target = current_target.beneath;
745 target = target->beneath)
747 if (target->to_get_thread_local_address != NULL)
752 && gdbarch_fetch_tls_load_module_address_p (target_gdbarch ()))
754 ptid_t ptid = inferior_ptid;
755 volatile struct gdb_exception ex;
757 TRY_CATCH (ex, RETURN_MASK_ALL)
761 /* Fetch the load module address for this objfile. */
762 lm_addr = gdbarch_fetch_tls_load_module_address (target_gdbarch (),
765 addr = target->to_get_thread_local_address (target, ptid,
768 /* If an error occurred, print TLS related messages here. Otherwise,
769 throw the error to some higher catcher. */
772 int objfile_is_library = (objfile->flags & OBJF_SHARED);
776 case TLS_NO_LIBRARY_SUPPORT_ERROR:
777 error (_("Cannot find thread-local variables "
778 "in this thread library."));
780 case TLS_LOAD_MODULE_NOT_FOUND_ERROR:
781 if (objfile_is_library)
782 error (_("Cannot find shared library `%s' in dynamic"
783 " linker's load module list"), objfile_name (objfile));
785 error (_("Cannot find executable file `%s' in dynamic"
786 " linker's load module list"), objfile_name (objfile));
788 case TLS_NOT_ALLOCATED_YET_ERROR:
789 if (objfile_is_library)
790 error (_("The inferior has not yet allocated storage for"
791 " thread-local variables in\n"
792 "the shared library `%s'\n"
794 objfile_name (objfile), target_pid_to_str (ptid));
796 error (_("The inferior has not yet allocated storage for"
797 " thread-local variables in\n"
798 "the executable `%s'\n"
800 objfile_name (objfile), target_pid_to_str (ptid));
802 case TLS_GENERIC_ERROR:
803 if (objfile_is_library)
804 error (_("Cannot find thread-local storage for %s, "
805 "shared library %s:\n%s"),
806 target_pid_to_str (ptid),
807 objfile_name (objfile), ex.message);
809 error (_("Cannot find thread-local storage for %s, "
810 "executable file %s:\n%s"),
811 target_pid_to_str (ptid),
812 objfile_name (objfile), ex.message);
815 throw_exception (ex);
820 /* It wouldn't be wrong here to try a gdbarch method, too; finding
821 TLS is an ABI-specific thing. But we don't do that yet. */
823 error (_("Cannot find thread-local variables on this target"));
829 target_xfer_status_to_string (enum target_xfer_status status)
831 #define CASE(X) case X: return #X
834 CASE(TARGET_XFER_E_IO);
835 CASE(TARGET_XFER_UNAVAILABLE);
844 #define MIN(A, B) (((A) <= (B)) ? (A) : (B))
846 /* target_read_string -- read a null terminated string, up to LEN bytes,
847 from MEMADDR in target. Set *ERRNOP to the errno code, or 0 if successful.
848 Set *STRING to a pointer to malloc'd memory containing the data; the caller
849 is responsible for freeing it. Return the number of bytes successfully
853 target_read_string (CORE_ADDR memaddr, char **string, int len, int *errnop)
859 int buffer_allocated;
861 unsigned int nbytes_read = 0;
865 /* Small for testing. */
866 buffer_allocated = 4;
867 buffer = xmalloc (buffer_allocated);
872 tlen = MIN (len, 4 - (memaddr & 3));
873 offset = memaddr & 3;
875 errcode = target_read_memory (memaddr & ~3, buf, sizeof buf);
878 /* The transfer request might have crossed the boundary to an
879 unallocated region of memory. Retry the transfer, requesting
883 errcode = target_read_memory (memaddr, buf, 1);
888 if (bufptr - buffer + tlen > buffer_allocated)
892 bytes = bufptr - buffer;
893 buffer_allocated *= 2;
894 buffer = xrealloc (buffer, buffer_allocated);
895 bufptr = buffer + bytes;
898 for (i = 0; i < tlen; i++)
900 *bufptr++ = buf[i + offset];
901 if (buf[i + offset] == '\000')
903 nbytes_read += i + 1;
919 struct target_section_table *
920 target_get_section_table (struct target_ops *target)
923 fprintf_unfiltered (gdb_stdlog, "target_get_section_table ()\n");
925 return (*target->to_get_section_table) (target);
928 /* Find a section containing ADDR. */
930 struct target_section *
931 target_section_by_addr (struct target_ops *target, CORE_ADDR addr)
933 struct target_section_table *table = target_get_section_table (target);
934 struct target_section *secp;
939 for (secp = table->sections; secp < table->sections_end; secp++)
941 if (addr >= secp->addr && addr < secp->endaddr)
947 /* Read memory from more than one valid target. A core file, for
948 instance, could have some of memory but delegate other bits to
949 the target below it. So, we must manually try all targets. */
951 static enum target_xfer_status
952 raw_memory_xfer_partial (struct target_ops *ops, gdb_byte *readbuf,
953 const gdb_byte *writebuf, ULONGEST memaddr, LONGEST len,
954 ULONGEST *xfered_len)
956 enum target_xfer_status res;
960 res = ops->to_xfer_partial (ops, TARGET_OBJECT_MEMORY, NULL,
961 readbuf, writebuf, memaddr, len,
963 if (res == TARGET_XFER_OK)
966 /* Stop if the target reports that the memory is not available. */
967 if (res == TARGET_XFER_UNAVAILABLE)
970 /* We want to continue past core files to executables, but not
971 past a running target's memory. */
972 if (ops->to_has_all_memory (ops))
979 /* The cache works at the raw memory level. Make sure the cache
980 gets updated with raw contents no matter what kind of memory
981 object was originally being written. Note we do write-through
982 first, so that if it fails, we don't write to the cache contents
983 that never made it to the target. */
985 && !ptid_equal (inferior_ptid, null_ptid)
986 && target_dcache_init_p ()
987 && (stack_cache_enabled_p () || code_cache_enabled_p ()))
989 DCACHE *dcache = target_dcache_get ();
991 /* Note that writing to an area of memory which wasn't present
992 in the cache doesn't cause it to be loaded in. */
993 dcache_update (dcache, res, memaddr, writebuf, *xfered_len);
999 /* Perform a partial memory transfer.
1000 For docs see target.h, to_xfer_partial. */
1002 static enum target_xfer_status
1003 memory_xfer_partial_1 (struct target_ops *ops, enum target_object object,
1004 gdb_byte *readbuf, const gdb_byte *writebuf, ULONGEST memaddr,
1005 ULONGEST len, ULONGEST *xfered_len)
1007 enum target_xfer_status res;
1009 struct mem_region *region;
1010 struct inferior *inf;
1012 /* For accesses to unmapped overlay sections, read directly from
1013 files. Must do this first, as MEMADDR may need adjustment. */
1014 if (readbuf != NULL && overlay_debugging)
1016 struct obj_section *section = find_pc_overlay (memaddr);
1018 if (pc_in_unmapped_range (memaddr, section))
1020 struct target_section_table *table
1021 = target_get_section_table (ops);
1022 const char *section_name = section->the_bfd_section->name;
1024 memaddr = overlay_mapped_address (memaddr, section);
1025 return section_table_xfer_memory_partial (readbuf, writebuf,
1026 memaddr, len, xfered_len,
1028 table->sections_end,
1033 /* Try the executable files, if "trust-readonly-sections" is set. */
1034 if (readbuf != NULL && trust_readonly)
1036 struct target_section *secp;
1037 struct target_section_table *table;
1039 secp = target_section_by_addr (ops, memaddr);
1041 && (bfd_get_section_flags (secp->the_bfd_section->owner,
1042 secp->the_bfd_section)
1045 table = target_get_section_table (ops);
1046 return section_table_xfer_memory_partial (readbuf, writebuf,
1047 memaddr, len, xfered_len,
1049 table->sections_end,
1054 /* Try GDB's internal data cache. */
1055 region = lookup_mem_region (memaddr);
1056 /* region->hi == 0 means there's no upper bound. */
1057 if (memaddr + len < region->hi || region->hi == 0)
1060 reg_len = region->hi - memaddr;
1062 switch (region->attrib.mode)
1065 if (writebuf != NULL)
1066 return TARGET_XFER_E_IO;
1070 if (readbuf != NULL)
1071 return TARGET_XFER_E_IO;
1075 /* We only support writing to flash during "load" for now. */
1076 if (writebuf != NULL)
1077 error (_("Writing to flash memory forbidden in this context"));
1081 return TARGET_XFER_E_IO;
1084 if (!ptid_equal (inferior_ptid, null_ptid))
1085 inf = find_inferior_pid (ptid_get_pid (inferior_ptid));
1091 /* The dcache reads whole cache lines; that doesn't play well
1092 with reading from a trace buffer, because reading outside of
1093 the collected memory range fails. */
1094 && get_traceframe_number () == -1
1095 && (region->attrib.cache
1096 || (stack_cache_enabled_p () && object == TARGET_OBJECT_STACK_MEMORY)
1097 || (code_cache_enabled_p () && object == TARGET_OBJECT_CODE_MEMORY)))
1099 DCACHE *dcache = target_dcache_get_or_init ();
1101 return dcache_read_memory_partial (ops, dcache, memaddr, readbuf,
1102 reg_len, xfered_len);
1105 /* If none of those methods found the memory we wanted, fall back
1106 to a target partial transfer. Normally a single call to
1107 to_xfer_partial is enough; if it doesn't recognize an object
1108 it will call the to_xfer_partial of the next target down.
1109 But for memory this won't do. Memory is the only target
1110 object which can be read from more than one valid target.
1111 A core file, for instance, could have some of memory but
1112 delegate other bits to the target below it. So, we must
1113 manually try all targets. */
1115 res = raw_memory_xfer_partial (ops, readbuf, writebuf, memaddr, reg_len,
1118 /* If we still haven't got anything, return the last error. We
1123 /* Perform a partial memory transfer. For docs see target.h,
1126 static enum target_xfer_status
1127 memory_xfer_partial (struct target_ops *ops, enum target_object object,
1128 gdb_byte *readbuf, const gdb_byte *writebuf,
1129 ULONGEST memaddr, ULONGEST len, ULONGEST *xfered_len)
1131 enum target_xfer_status res;
1133 /* Zero length requests are ok and require no work. */
1135 return TARGET_XFER_EOF;
1137 /* Fill in READBUF with breakpoint shadows, or WRITEBUF with
1138 breakpoint insns, thus hiding out from higher layers whether
1139 there are software breakpoints inserted in the code stream. */
1140 if (readbuf != NULL)
1142 res = memory_xfer_partial_1 (ops, object, readbuf, NULL, memaddr, len,
1145 if (res == TARGET_XFER_OK && !show_memory_breakpoints)
1146 breakpoint_xfer_memory (readbuf, NULL, NULL, memaddr, *xfered_len);
1151 struct cleanup *old_chain;
1153 /* A large write request is likely to be partially satisfied
1154 by memory_xfer_partial_1. We will continually malloc
1155 and free a copy of the entire write request for breakpoint
1156 shadow handling even though we only end up writing a small
1157 subset of it. Cap writes to 4KB to mitigate this. */
1158 len = min (4096, len);
1160 buf = xmalloc (len);
1161 old_chain = make_cleanup (xfree, buf);
1162 memcpy (buf, writebuf, len);
1164 breakpoint_xfer_memory (NULL, buf, writebuf, memaddr, len);
1165 res = memory_xfer_partial_1 (ops, object, NULL, buf, memaddr, len,
1168 do_cleanups (old_chain);
1175 restore_show_memory_breakpoints (void *arg)
1177 show_memory_breakpoints = (uintptr_t) arg;
1181 make_show_memory_breakpoints_cleanup (int show)
1183 int current = show_memory_breakpoints;
1185 show_memory_breakpoints = show;
1186 return make_cleanup (restore_show_memory_breakpoints,
1187 (void *) (uintptr_t) current);
1190 /* For docs see target.h, to_xfer_partial. */
1192 enum target_xfer_status
1193 target_xfer_partial (struct target_ops *ops,
1194 enum target_object object, const char *annex,
1195 gdb_byte *readbuf, const gdb_byte *writebuf,
1196 ULONGEST offset, ULONGEST len,
1197 ULONGEST *xfered_len)
1199 enum target_xfer_status retval;
1201 gdb_assert (ops->to_xfer_partial != NULL);
1203 /* Transfer is done when LEN is zero. */
1205 return TARGET_XFER_EOF;
1207 if (writebuf && !may_write_memory)
1208 error (_("Writing to memory is not allowed (addr %s, len %s)"),
1209 core_addr_to_string_nz (offset), plongest (len));
1213 /* If this is a memory transfer, let the memory-specific code
1214 have a look at it instead. Memory transfers are more
1216 if (object == TARGET_OBJECT_MEMORY || object == TARGET_OBJECT_STACK_MEMORY
1217 || object == TARGET_OBJECT_CODE_MEMORY)
1218 retval = memory_xfer_partial (ops, object, readbuf,
1219 writebuf, offset, len, xfered_len);
1220 else if (object == TARGET_OBJECT_RAW_MEMORY)
1222 /* Request the normal memory object from other layers. */
1223 retval = raw_memory_xfer_partial (ops, readbuf, writebuf, offset, len,
1227 retval = ops->to_xfer_partial (ops, object, annex, readbuf,
1228 writebuf, offset, len, xfered_len);
1232 const unsigned char *myaddr = NULL;
1234 fprintf_unfiltered (gdb_stdlog,
1235 "%s:target_xfer_partial "
1236 "(%d, %s, %s, %s, %s, %s) = %d, %s",
1239 (annex ? annex : "(null)"),
1240 host_address_to_string (readbuf),
1241 host_address_to_string (writebuf),
1242 core_addr_to_string_nz (offset),
1243 pulongest (len), retval,
1244 pulongest (*xfered_len));
1250 if (retval == TARGET_XFER_OK && myaddr != NULL)
1254 fputs_unfiltered (", bytes =", gdb_stdlog);
1255 for (i = 0; i < *xfered_len; i++)
1257 if ((((intptr_t) &(myaddr[i])) & 0xf) == 0)
1259 if (targetdebug < 2 && i > 0)
1261 fprintf_unfiltered (gdb_stdlog, " ...");
1264 fprintf_unfiltered (gdb_stdlog, "\n");
1267 fprintf_unfiltered (gdb_stdlog, " %02x", myaddr[i] & 0xff);
1271 fputc_unfiltered ('\n', gdb_stdlog);
1274 /* Check implementations of to_xfer_partial update *XFERED_LEN
1275 properly. Do assertion after printing debug messages, so that we
1276 can find more clues on assertion failure from debugging messages. */
1277 if (retval == TARGET_XFER_OK || retval == TARGET_XFER_UNAVAILABLE)
1278 gdb_assert (*xfered_len > 0);
1283 /* Read LEN bytes of target memory at address MEMADDR, placing the
1284 results in GDB's memory at MYADDR. Returns either 0 for success or
1285 TARGET_XFER_E_IO if any error occurs.
1287 If an error occurs, no guarantee is made about the contents of the data at
1288 MYADDR. In particular, the caller should not depend upon partial reads
1289 filling the buffer with good data. There is no way for the caller to know
1290 how much good data might have been transfered anyway. Callers that can
1291 deal with partial reads should call target_read (which will retry until
1292 it makes no progress, and then return how much was transferred). */
1295 target_read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1297 /* Dispatch to the topmost target, not the flattened current_target.
1298 Memory accesses check target->to_has_(all_)memory, and the
1299 flattened target doesn't inherit those. */
1300 if (target_read (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1301 myaddr, memaddr, len) == len)
1304 return TARGET_XFER_E_IO;
1307 /* Like target_read_memory, but specify explicitly that this is a read
1308 from the target's raw memory. That is, this read bypasses the
1309 dcache, breakpoint shadowing, etc. */
1312 target_read_raw_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1314 /* See comment in target_read_memory about why the request starts at
1315 current_target.beneath. */
1316 if (target_read (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1317 myaddr, memaddr, len) == len)
1320 return TARGET_XFER_E_IO;
1323 /* Like target_read_memory, but specify explicitly that this is a read from
1324 the target's stack. This may trigger different cache behavior. */
1327 target_read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1329 /* See comment in target_read_memory about why the request starts at
1330 current_target.beneath. */
1331 if (target_read (current_target.beneath, TARGET_OBJECT_STACK_MEMORY, NULL,
1332 myaddr, memaddr, len) == len)
1335 return TARGET_XFER_E_IO;
1338 /* Like target_read_memory, but specify explicitly that this is a read from
1339 the target's code. This may trigger different cache behavior. */
1342 target_read_code (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len)
1344 /* See comment in target_read_memory about why the request starts at
1345 current_target.beneath. */
1346 if (target_read (current_target.beneath, TARGET_OBJECT_CODE_MEMORY, NULL,
1347 myaddr, memaddr, len) == len)
1350 return TARGET_XFER_E_IO;
1353 /* Write LEN bytes from MYADDR to target memory at address MEMADDR.
1354 Returns either 0 for success or TARGET_XFER_E_IO if any
1355 error occurs. If an error occurs, no guarantee is made about how
1356 much data got written. Callers that can deal with partial writes
1357 should call target_write. */
1360 target_write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1362 /* See comment in target_read_memory about why the request starts at
1363 current_target.beneath. */
1364 if (target_write (current_target.beneath, TARGET_OBJECT_MEMORY, NULL,
1365 myaddr, memaddr, len) == len)
1368 return TARGET_XFER_E_IO;
1371 /* Write LEN bytes from MYADDR to target raw memory at address
1372 MEMADDR. Returns either 0 for success or TARGET_XFER_E_IO
1373 if any error occurs. If an error occurs, no guarantee is made
1374 about how much data got written. Callers that can deal with
1375 partial writes should call target_write. */
1378 target_write_raw_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, ssize_t len)
1380 /* See comment in target_read_memory about why the request starts at
1381 current_target.beneath. */
1382 if (target_write (current_target.beneath, TARGET_OBJECT_RAW_MEMORY, NULL,
1383 myaddr, memaddr, len) == len)
1386 return TARGET_XFER_E_IO;
1389 /* Fetch the target's memory map. */
1392 target_memory_map (void)
1394 VEC(mem_region_s) *result;
1395 struct mem_region *last_one, *this_one;
1397 struct target_ops *t;
1400 fprintf_unfiltered (gdb_stdlog, "target_memory_map ()\n");
1402 result = current_target.to_memory_map (¤t_target);
1406 qsort (VEC_address (mem_region_s, result),
1407 VEC_length (mem_region_s, result),
1408 sizeof (struct mem_region), mem_region_cmp);
1410 /* Check that regions do not overlap. Simultaneously assign
1411 a numbering for the "mem" commands to use to refer to
1414 for (ix = 0; VEC_iterate (mem_region_s, result, ix, this_one); ix++)
1416 this_one->number = ix;
1418 if (last_one && last_one->hi > this_one->lo)
1420 warning (_("Overlapping regions in memory map: ignoring"));
1421 VEC_free (mem_region_s, result);
1424 last_one = this_one;
1431 target_flash_erase (ULONGEST address, LONGEST length)
1434 fprintf_unfiltered (gdb_stdlog, "target_flash_erase (%s, %s)\n",
1435 hex_string (address), phex (length, 0));
1436 current_target.to_flash_erase (¤t_target, address, length);
1440 target_flash_done (void)
1443 fprintf_unfiltered (gdb_stdlog, "target_flash_done\n");
1444 current_target.to_flash_done (¤t_target);
1448 show_trust_readonly (struct ui_file *file, int from_tty,
1449 struct cmd_list_element *c, const char *value)
1451 fprintf_filtered (file,
1452 _("Mode for reading from readonly sections is %s.\n"),
1456 /* Target vector read/write partial wrapper functions. */
1458 static enum target_xfer_status
1459 target_read_partial (struct target_ops *ops,
1460 enum target_object object,
1461 const char *annex, gdb_byte *buf,
1462 ULONGEST offset, ULONGEST len,
1463 ULONGEST *xfered_len)
1465 return target_xfer_partial (ops, object, annex, buf, NULL, offset, len,
1469 static enum target_xfer_status
1470 target_write_partial (struct target_ops *ops,
1471 enum target_object object,
1472 const char *annex, const gdb_byte *buf,
1473 ULONGEST offset, LONGEST len, ULONGEST *xfered_len)
1475 return target_xfer_partial (ops, object, annex, NULL, buf, offset, len,
1479 /* Wrappers to perform the full transfer. */
1481 /* For docs on target_read see target.h. */
1484 target_read (struct target_ops *ops,
1485 enum target_object object,
1486 const char *annex, gdb_byte *buf,
1487 ULONGEST offset, LONGEST len)
1491 while (xfered < len)
1493 ULONGEST xfered_len;
1494 enum target_xfer_status status;
1496 status = target_read_partial (ops, object, annex,
1497 (gdb_byte *) buf + xfered,
1498 offset + xfered, len - xfered,
1501 /* Call an observer, notifying them of the xfer progress? */
1502 if (status == TARGET_XFER_EOF)
1504 else if (status == TARGET_XFER_OK)
1506 xfered += xfered_len;
1516 /* Assuming that the entire [begin, end) range of memory cannot be
1517 read, try to read whatever subrange is possible to read.
1519 The function returns, in RESULT, either zero or one memory block.
1520 If there's a readable subrange at the beginning, it is completely
1521 read and returned. Any further readable subrange will not be read.
1522 Otherwise, if there's a readable subrange at the end, it will be
1523 completely read and returned. Any readable subranges before it
1524 (obviously, not starting at the beginning), will be ignored. In
1525 other cases -- either no readable subrange, or readable subrange(s)
1526 that is neither at the beginning, or end, nothing is returned.
1528 The purpose of this function is to handle a read across a boundary
1529 of accessible memory in a case when memory map is not available.
1530 The above restrictions are fine for this case, but will give
1531 incorrect results if the memory is 'patchy'. However, supporting
1532 'patchy' memory would require trying to read every single byte,
1533 and it seems unacceptable solution. Explicit memory map is
1534 recommended for this case -- and target_read_memory_robust will
1535 take care of reading multiple ranges then. */
1538 read_whatever_is_readable (struct target_ops *ops,
1539 ULONGEST begin, ULONGEST end,
1540 VEC(memory_read_result_s) **result)
1542 gdb_byte *buf = xmalloc (end - begin);
1543 ULONGEST current_begin = begin;
1544 ULONGEST current_end = end;
1546 memory_read_result_s r;
1547 ULONGEST xfered_len;
1549 /* If we previously failed to read 1 byte, nothing can be done here. */
1550 if (end - begin <= 1)
1556 /* Check that either first or the last byte is readable, and give up
1557 if not. This heuristic is meant to permit reading accessible memory
1558 at the boundary of accessible region. */
1559 if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
1560 buf, begin, 1, &xfered_len) == TARGET_XFER_OK)
1565 else if (target_read_partial (ops, TARGET_OBJECT_MEMORY, NULL,
1566 buf + (end-begin) - 1, end - 1, 1,
1567 &xfered_len) == TARGET_XFER_OK)
1578 /* Loop invariant is that the [current_begin, current_end) was previously
1579 found to be not readable as a whole.
1581 Note loop condition -- if the range has 1 byte, we can't divide the range
1582 so there's no point trying further. */
1583 while (current_end - current_begin > 1)
1585 ULONGEST first_half_begin, first_half_end;
1586 ULONGEST second_half_begin, second_half_end;
1588 ULONGEST middle = current_begin + (current_end - current_begin)/2;
1592 first_half_begin = current_begin;
1593 first_half_end = middle;
1594 second_half_begin = middle;
1595 second_half_end = current_end;
1599 first_half_begin = middle;
1600 first_half_end = current_end;
1601 second_half_begin = current_begin;
1602 second_half_end = middle;
1605 xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
1606 buf + (first_half_begin - begin),
1608 first_half_end - first_half_begin);
1610 if (xfer == first_half_end - first_half_begin)
1612 /* This half reads up fine. So, the error must be in the
1614 current_begin = second_half_begin;
1615 current_end = second_half_end;
1619 /* This half is not readable. Because we've tried one byte, we
1620 know some part of this half if actually redable. Go to the next
1621 iteration to divide again and try to read.
1623 We don't handle the other half, because this function only tries
1624 to read a single readable subrange. */
1625 current_begin = first_half_begin;
1626 current_end = first_half_end;
1632 /* The [begin, current_begin) range has been read. */
1634 r.end = current_begin;
1639 /* The [current_end, end) range has been read. */
1640 LONGEST rlen = end - current_end;
1642 r.data = xmalloc (rlen);
1643 memcpy (r.data, buf + current_end - begin, rlen);
1644 r.begin = current_end;
1648 VEC_safe_push(memory_read_result_s, (*result), &r);
1652 free_memory_read_result_vector (void *x)
1654 VEC(memory_read_result_s) *v = x;
1655 memory_read_result_s *current;
1658 for (ix = 0; VEC_iterate (memory_read_result_s, v, ix, current); ++ix)
1660 xfree (current->data);
1662 VEC_free (memory_read_result_s, v);
1665 VEC(memory_read_result_s) *
1666 read_memory_robust (struct target_ops *ops, ULONGEST offset, LONGEST len)
1668 VEC(memory_read_result_s) *result = 0;
1671 while (xfered < len)
1673 struct mem_region *region = lookup_mem_region (offset + xfered);
1676 /* If there is no explicit region, a fake one should be created. */
1677 gdb_assert (region);
1679 if (region->hi == 0)
1680 rlen = len - xfered;
1682 rlen = region->hi - offset;
1684 if (region->attrib.mode == MEM_NONE || region->attrib.mode == MEM_WO)
1686 /* Cannot read this region. Note that we can end up here only
1687 if the region is explicitly marked inaccessible, or
1688 'inaccessible-by-default' is in effect. */
1693 LONGEST to_read = min (len - xfered, rlen);
1694 gdb_byte *buffer = (gdb_byte *)xmalloc (to_read);
1696 LONGEST xfer = target_read (ops, TARGET_OBJECT_MEMORY, NULL,
1697 (gdb_byte *) buffer,
1698 offset + xfered, to_read);
1699 /* Call an observer, notifying them of the xfer progress? */
1702 /* Got an error reading full chunk. See if maybe we can read
1705 read_whatever_is_readable (ops, offset + xfered,
1706 offset + xfered + to_read, &result);
1711 struct memory_read_result r;
1713 r.begin = offset + xfered;
1714 r.end = r.begin + xfer;
1715 VEC_safe_push (memory_read_result_s, result, &r);
1725 /* An alternative to target_write with progress callbacks. */
1728 target_write_with_progress (struct target_ops *ops,
1729 enum target_object object,
1730 const char *annex, const gdb_byte *buf,
1731 ULONGEST offset, LONGEST len,
1732 void (*progress) (ULONGEST, void *), void *baton)
1736 /* Give the progress callback a chance to set up. */
1738 (*progress) (0, baton);
1740 while (xfered < len)
1742 ULONGEST xfered_len;
1743 enum target_xfer_status status;
1745 status = target_write_partial (ops, object, annex,
1746 (gdb_byte *) buf + xfered,
1747 offset + xfered, len - xfered,
1750 if (status != TARGET_XFER_OK)
1751 return status == TARGET_XFER_EOF ? xfered : -1;
1754 (*progress) (xfered_len, baton);
1756 xfered += xfered_len;
1762 /* For docs on target_write see target.h. */
1765 target_write (struct target_ops *ops,
1766 enum target_object object,
1767 const char *annex, const gdb_byte *buf,
1768 ULONGEST offset, LONGEST len)
1770 return target_write_with_progress (ops, object, annex, buf, offset, len,
1774 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
1775 the size of the transferred data. PADDING additional bytes are
1776 available in *BUF_P. This is a helper function for
1777 target_read_alloc; see the declaration of that function for more
1781 target_read_alloc_1 (struct target_ops *ops, enum target_object object,
1782 const char *annex, gdb_byte **buf_p, int padding)
1784 size_t buf_alloc, buf_pos;
1787 /* This function does not have a length parameter; it reads the
1788 entire OBJECT). Also, it doesn't support objects fetched partly
1789 from one target and partly from another (in a different stratum,
1790 e.g. a core file and an executable). Both reasons make it
1791 unsuitable for reading memory. */
1792 gdb_assert (object != TARGET_OBJECT_MEMORY);
1794 /* Start by reading up to 4K at a time. The target will throttle
1795 this number down if necessary. */
1797 buf = xmalloc (buf_alloc);
1801 ULONGEST xfered_len;
1802 enum target_xfer_status status;
1804 status = target_read_partial (ops, object, annex, &buf[buf_pos],
1805 buf_pos, buf_alloc - buf_pos - padding,
1808 if (status == TARGET_XFER_EOF)
1810 /* Read all there was. */
1817 else if (status != TARGET_XFER_OK)
1819 /* An error occurred. */
1821 return TARGET_XFER_E_IO;
1824 buf_pos += xfered_len;
1826 /* If the buffer is filling up, expand it. */
1827 if (buf_alloc < buf_pos * 2)
1830 buf = xrealloc (buf, buf_alloc);
1837 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
1838 the size of the transferred data. See the declaration in "target.h"
1839 function for more information about the return value. */
1842 target_read_alloc (struct target_ops *ops, enum target_object object,
1843 const char *annex, gdb_byte **buf_p)
1845 return target_read_alloc_1 (ops, object, annex, buf_p, 0);
1848 /* Read OBJECT/ANNEX using OPS. The result is NUL-terminated and
1849 returned as a string, allocated using xmalloc. If an error occurs
1850 or the transfer is unsupported, NULL is returned. Empty objects
1851 are returned as allocated but empty strings. A warning is issued
1852 if the result contains any embedded NUL bytes. */
1855 target_read_stralloc (struct target_ops *ops, enum target_object object,
1860 LONGEST i, transferred;
1862 transferred = target_read_alloc_1 (ops, object, annex, &buffer, 1);
1863 bufstr = (char *) buffer;
1865 if (transferred < 0)
1868 if (transferred == 0)
1869 return xstrdup ("");
1871 bufstr[transferred] = 0;
1873 /* Check for embedded NUL bytes; but allow trailing NULs. */
1874 for (i = strlen (bufstr); i < transferred; i++)
1877 warning (_("target object %d, annex %s, "
1878 "contained unexpected null characters"),
1879 (int) object, annex ? annex : "(none)");
1886 /* Memory transfer methods. */
1889 get_target_memory (struct target_ops *ops, CORE_ADDR addr, gdb_byte *buf,
1892 /* This method is used to read from an alternate, non-current
1893 target. This read must bypass the overlay support (as symbols
1894 don't match this target), and GDB's internal cache (wrong cache
1895 for this target). */
1896 if (target_read (ops, TARGET_OBJECT_RAW_MEMORY, NULL, buf, addr, len)
1898 memory_error (TARGET_XFER_E_IO, addr);
1902 get_target_memory_unsigned (struct target_ops *ops, CORE_ADDR addr,
1903 int len, enum bfd_endian byte_order)
1905 gdb_byte buf[sizeof (ULONGEST)];
1907 gdb_assert (len <= sizeof (buf));
1908 get_target_memory (ops, addr, buf, len);
1909 return extract_unsigned_integer (buf, len, byte_order);
1915 target_insert_breakpoint (struct gdbarch *gdbarch,
1916 struct bp_target_info *bp_tgt)
1918 if (!may_insert_breakpoints)
1920 warning (_("May not insert breakpoints"));
1924 return current_target.to_insert_breakpoint (¤t_target,
1931 target_remove_breakpoint (struct gdbarch *gdbarch,
1932 struct bp_target_info *bp_tgt)
1934 /* This is kind of a weird case to handle, but the permission might
1935 have been changed after breakpoints were inserted - in which case
1936 we should just take the user literally and assume that any
1937 breakpoints should be left in place. */
1938 if (!may_insert_breakpoints)
1940 warning (_("May not remove breakpoints"));
1944 return current_target.to_remove_breakpoint (¤t_target,
1949 target_info (char *args, int from_tty)
1951 struct target_ops *t;
1952 int has_all_mem = 0;
1954 if (symfile_objfile != NULL)
1955 printf_unfiltered (_("Symbols from \"%s\".\n"),
1956 objfile_name (symfile_objfile));
1958 for (t = target_stack; t != NULL; t = t->beneath)
1960 if (!(*t->to_has_memory) (t))
1963 if ((int) (t->to_stratum) <= (int) dummy_stratum)
1966 printf_unfiltered (_("\tWhile running this, "
1967 "GDB does not access memory from...\n"));
1968 printf_unfiltered ("%s:\n", t->to_longname);
1969 (t->to_files_info) (t);
1970 has_all_mem = (*t->to_has_all_memory) (t);
1974 /* This function is called before any new inferior is created, e.g.
1975 by running a program, attaching, or connecting to a target.
1976 It cleans up any state from previous invocations which might
1977 change between runs. This is a subset of what target_preopen
1978 resets (things which might change between targets). */
1981 target_pre_inferior (int from_tty)
1983 /* Clear out solib state. Otherwise the solib state of the previous
1984 inferior might have survived and is entirely wrong for the new
1985 target. This has been observed on GNU/Linux using glibc 2.3. How
1997 Cannot access memory at address 0xdeadbeef
2000 /* In some OSs, the shared library list is the same/global/shared
2001 across inferiors. If code is shared between processes, so are
2002 memory regions and features. */
2003 if (!gdbarch_has_global_solist (target_gdbarch ()))
2005 no_shared_libraries (NULL, from_tty);
2007 invalidate_target_mem_regions ();
2009 target_clear_description ();
2012 agent_capability_invalidate ();
2015 /* Callback for iterate_over_inferiors. Gets rid of the given
2019 dispose_inferior (struct inferior *inf, void *args)
2021 struct thread_info *thread;
2023 thread = any_thread_of_process (inf->pid);
2026 switch_to_thread (thread->ptid);
2028 /* Core inferiors actually should be detached, not killed. */
2029 if (target_has_execution)
2032 target_detach (NULL, 0);
2038 /* This is to be called by the open routine before it does
2042 target_preopen (int from_tty)
2046 if (have_inferiors ())
2049 || !have_live_inferiors ()
2050 || query (_("A program is being debugged already. Kill it? ")))
2051 iterate_over_inferiors (dispose_inferior, NULL);
2053 error (_("Program not killed."));
2056 /* Calling target_kill may remove the target from the stack. But if
2057 it doesn't (which seems like a win for UDI), remove it now. */
2058 /* Leave the exec target, though. The user may be switching from a
2059 live process to a core of the same program. */
2060 pop_all_targets_above (file_stratum);
2062 target_pre_inferior (from_tty);
2065 /* Detach a target after doing deferred register stores. */
2068 target_detach (const char *args, int from_tty)
2070 struct target_ops* t;
2072 if (gdbarch_has_global_breakpoints (target_gdbarch ()))
2073 /* Don't remove global breakpoints here. They're removed on
2074 disconnection from the target. */
2077 /* If we're in breakpoints-always-inserted mode, have to remove
2078 them before detaching. */
2079 remove_breakpoints_pid (ptid_get_pid (inferior_ptid));
2081 prepare_for_detach ();
2083 current_target.to_detach (¤t_target, args, from_tty);
2085 fprintf_unfiltered (gdb_stdlog, "target_detach (%s, %d)\n",
2090 target_disconnect (const char *args, int from_tty)
2092 /* If we're in breakpoints-always-inserted mode or if breakpoints
2093 are global across processes, we have to remove them before
2095 remove_breakpoints ();
2098 fprintf_unfiltered (gdb_stdlog, "target_disconnect (%s, %d)\n",
2100 current_target.to_disconnect (¤t_target, args, from_tty);
2104 target_wait (ptid_t ptid, struct target_waitstatus *status, int options)
2106 struct target_ops *t;
2107 ptid_t retval = (current_target.to_wait) (¤t_target, ptid,
2112 char *status_string;
2113 char *options_string;
2115 status_string = target_waitstatus_to_string (status);
2116 options_string = target_options_to_string (options);
2117 fprintf_unfiltered (gdb_stdlog,
2118 "target_wait (%d, status, options={%s})"
2120 ptid_get_pid (ptid), options_string,
2121 ptid_get_pid (retval), status_string);
2122 xfree (status_string);
2123 xfree (options_string);
2130 target_pid_to_str (ptid_t ptid)
2132 return (*current_target.to_pid_to_str) (¤t_target, ptid);
2136 target_thread_name (struct thread_info *info)
2138 return current_target.to_thread_name (¤t_target, info);
2142 target_resume (ptid_t ptid, int step, enum gdb_signal signal)
2144 struct target_ops *t;
2146 target_dcache_invalidate ();
2148 current_target.to_resume (¤t_target, ptid, step, signal);
2150 fprintf_unfiltered (gdb_stdlog, "target_resume (%d, %s, %s)\n",
2151 ptid_get_pid (ptid),
2152 step ? "step" : "continue",
2153 gdb_signal_to_name (signal));
2155 registers_changed_ptid (ptid);
2156 /* We only set the internal executing state here. The user/frontend
2157 running state is set at a higher level. */
2158 set_executing (ptid, 1);
2159 clear_inline_frame_state (ptid);
2163 target_pass_signals (int numsigs, unsigned char *pass_signals)
2169 fprintf_unfiltered (gdb_stdlog, "target_pass_signals (%d, {",
2172 for (i = 0; i < numsigs; i++)
2173 if (pass_signals[i])
2174 fprintf_unfiltered (gdb_stdlog, " %s",
2175 gdb_signal_to_name (i));
2177 fprintf_unfiltered (gdb_stdlog, " })\n");
2180 (*current_target.to_pass_signals) (¤t_target, numsigs, pass_signals);
2184 target_program_signals (int numsigs, unsigned char *program_signals)
2190 fprintf_unfiltered (gdb_stdlog, "target_program_signals (%d, {",
2193 for (i = 0; i < numsigs; i++)
2194 if (program_signals[i])
2195 fprintf_unfiltered (gdb_stdlog, " %s",
2196 gdb_signal_to_name (i));
2198 fprintf_unfiltered (gdb_stdlog, " })\n");
2201 (*current_target.to_program_signals) (¤t_target,
2202 numsigs, program_signals);
2206 default_follow_fork (struct target_ops *self, int follow_child,
2209 /* Some target returned a fork event, but did not know how to follow it. */
2210 internal_error (__FILE__, __LINE__,
2211 _("could not find a target to follow fork"));
2214 /* Look through the list of possible targets for a target that can
2218 target_follow_fork (int follow_child, int detach_fork)
2220 int retval = current_target.to_follow_fork (¤t_target,
2221 follow_child, detach_fork);
2224 fprintf_unfiltered (gdb_stdlog,
2225 "target_follow_fork (%d, %d) = %d\n",
2226 follow_child, detach_fork, retval);
2231 default_mourn_inferior (struct target_ops *self)
2233 internal_error (__FILE__, __LINE__,
2234 _("could not find a target to follow mourn inferior"));
2238 target_mourn_inferior (void)
2240 current_target.to_mourn_inferior (¤t_target);
2242 fprintf_unfiltered (gdb_stdlog, "target_mourn_inferior ()\n");
2244 /* We no longer need to keep handles on any of the object files.
2245 Make sure to release them to avoid unnecessarily locking any
2246 of them while we're not actually debugging. */
2247 bfd_cache_close_all ();
2250 /* Look for a target which can describe architectural features, starting
2251 from TARGET. If we find one, return its description. */
2253 const struct target_desc *
2254 target_read_description (struct target_ops *target)
2256 return target->to_read_description (target);
2259 /* This implements a basic search of memory, reading target memory and
2260 performing the search here (as opposed to performing the search in on the
2261 target side with, for example, gdbserver). */
2264 simple_search_memory (struct target_ops *ops,
2265 CORE_ADDR start_addr, ULONGEST search_space_len,
2266 const gdb_byte *pattern, ULONGEST pattern_len,
2267 CORE_ADDR *found_addrp)
2269 /* NOTE: also defined in find.c testcase. */
2270 #define SEARCH_CHUNK_SIZE 16000
2271 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
2272 /* Buffer to hold memory contents for searching. */
2273 gdb_byte *search_buf;
2274 unsigned search_buf_size;
2275 struct cleanup *old_cleanups;
2277 search_buf_size = chunk_size + pattern_len - 1;
2279 /* No point in trying to allocate a buffer larger than the search space. */
2280 if (search_space_len < search_buf_size)
2281 search_buf_size = search_space_len;
2283 search_buf = malloc (search_buf_size);
2284 if (search_buf == NULL)
2285 error (_("Unable to allocate memory to perform the search."));
2286 old_cleanups = make_cleanup (free_current_contents, &search_buf);
2288 /* Prime the search buffer. */
2290 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2291 search_buf, start_addr, search_buf_size) != search_buf_size)
2293 warning (_("Unable to access %s bytes of target "
2294 "memory at %s, halting search."),
2295 pulongest (search_buf_size), hex_string (start_addr));
2296 do_cleanups (old_cleanups);
2300 /* Perform the search.
2302 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
2303 When we've scanned N bytes we copy the trailing bytes to the start and
2304 read in another N bytes. */
2306 while (search_space_len >= pattern_len)
2308 gdb_byte *found_ptr;
2309 unsigned nr_search_bytes = min (search_space_len, search_buf_size);
2311 found_ptr = memmem (search_buf, nr_search_bytes,
2312 pattern, pattern_len);
2314 if (found_ptr != NULL)
2316 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
2318 *found_addrp = found_addr;
2319 do_cleanups (old_cleanups);
2323 /* Not found in this chunk, skip to next chunk. */
2325 /* Don't let search_space_len wrap here, it's unsigned. */
2326 if (search_space_len >= chunk_size)
2327 search_space_len -= chunk_size;
2329 search_space_len = 0;
2331 if (search_space_len >= pattern_len)
2333 unsigned keep_len = search_buf_size - chunk_size;
2334 CORE_ADDR read_addr = start_addr + chunk_size + keep_len;
2337 /* Copy the trailing part of the previous iteration to the front
2338 of the buffer for the next iteration. */
2339 gdb_assert (keep_len == pattern_len - 1);
2340 memcpy (search_buf, search_buf + chunk_size, keep_len);
2342 nr_to_read = min (search_space_len - keep_len, chunk_size);
2344 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2345 search_buf + keep_len, read_addr,
2346 nr_to_read) != nr_to_read)
2348 warning (_("Unable to access %s bytes of target "
2349 "memory at %s, halting search."),
2350 plongest (nr_to_read),
2351 hex_string (read_addr));
2352 do_cleanups (old_cleanups);
2356 start_addr += chunk_size;
2362 do_cleanups (old_cleanups);
2366 /* Default implementation of memory-searching. */
2369 default_search_memory (struct target_ops *self,
2370 CORE_ADDR start_addr, ULONGEST search_space_len,
2371 const gdb_byte *pattern, ULONGEST pattern_len,
2372 CORE_ADDR *found_addrp)
2374 /* Start over from the top of the target stack. */
2375 return simple_search_memory (current_target.beneath,
2376 start_addr, search_space_len,
2377 pattern, pattern_len, found_addrp);
2380 /* Search SEARCH_SPACE_LEN bytes beginning at START_ADDR for the
2381 sequence of bytes in PATTERN with length PATTERN_LEN.
2383 The result is 1 if found, 0 if not found, and -1 if there was an error
2384 requiring halting of the search (e.g. memory read error).
2385 If the pattern is found the address is recorded in FOUND_ADDRP. */
2388 target_search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
2389 const gdb_byte *pattern, ULONGEST pattern_len,
2390 CORE_ADDR *found_addrp)
2395 fprintf_unfiltered (gdb_stdlog, "target_search_memory (%s, ...)\n",
2396 hex_string (start_addr));
2398 found = current_target.to_search_memory (¤t_target, start_addr,
2400 pattern, pattern_len, found_addrp);
2403 fprintf_unfiltered (gdb_stdlog, " = %d\n", found);
2408 /* Look through the currently pushed targets. If none of them will
2409 be able to restart the currently running process, issue an error
2413 target_require_runnable (void)
2415 struct target_ops *t;
2417 for (t = target_stack; t != NULL; t = t->beneath)
2419 /* If this target knows how to create a new program, then
2420 assume we will still be able to after killing the current
2421 one. Either killing and mourning will not pop T, or else
2422 find_default_run_target will find it again. */
2423 if (t->to_create_inferior != NULL)
2426 /* Do not worry about thread_stratum targets that can not
2427 create inferiors. Assume they will be pushed again if
2428 necessary, and continue to the process_stratum. */
2429 if (t->to_stratum == thread_stratum
2430 || t->to_stratum == arch_stratum)
2433 error (_("The \"%s\" target does not support \"run\". "
2434 "Try \"help target\" or \"continue\"."),
2438 /* This function is only called if the target is running. In that
2439 case there should have been a process_stratum target and it
2440 should either know how to create inferiors, or not... */
2441 internal_error (__FILE__, __LINE__, _("No targets found"));
2444 /* Whether GDB is allowed to fall back to the default run target for
2445 "run", "attach", etc. when no target is connected yet. */
2446 static int auto_connect_native_target = 1;
2449 show_auto_connect_native_target (struct ui_file *file, int from_tty,
2450 struct cmd_list_element *c, const char *value)
2452 fprintf_filtered (file,
2453 _("Whether GDB may automatically connect to the "
2454 "native target is %s.\n"),
2458 /* Look through the list of possible targets for a target that can
2459 execute a run or attach command without any other data. This is
2460 used to locate the default process stratum.
2462 If DO_MESG is not NULL, the result is always valid (error() is
2463 called for errors); else, return NULL on error. */
2465 static struct target_ops *
2466 find_default_run_target (char *do_mesg)
2468 struct target_ops *runable = NULL;
2470 if (auto_connect_native_target)
2472 struct target_ops **t;
2475 for (t = target_structs; t < target_structs + target_struct_size;
2478 if ((*t)->to_can_run != delegate_can_run && target_can_run (*t))
2489 if (runable == NULL)
2492 error (_("Don't know how to %s. Try \"help target\"."), do_mesg);
2503 find_attach_target (void)
2505 struct target_ops *t;
2507 /* If a target on the current stack can attach, use it. */
2508 for (t = current_target.beneath; t != NULL; t = t->beneath)
2510 if (t->to_attach != NULL)
2514 /* Otherwise, use the default run target for attaching. */
2516 t = find_default_run_target ("attach");
2524 find_run_target (void)
2526 struct target_ops *t;
2528 /* If a target on the current stack can attach, use it. */
2529 for (t = current_target.beneath; t != NULL; t = t->beneath)
2531 if (t->to_create_inferior != NULL)
2535 /* Otherwise, use the default run target. */
2537 t = find_default_run_target ("run");
2542 /* Implement the "info proc" command. */
2545 target_info_proc (const char *args, enum info_proc_what what)
2547 struct target_ops *t;
2549 /* If we're already connected to something that can get us OS
2550 related data, use it. Otherwise, try using the native
2552 if (current_target.to_stratum >= process_stratum)
2553 t = current_target.beneath;
2555 t = find_default_run_target (NULL);
2557 for (; t != NULL; t = t->beneath)
2559 if (t->to_info_proc != NULL)
2561 t->to_info_proc (t, args, what);
2564 fprintf_unfiltered (gdb_stdlog,
2565 "target_info_proc (\"%s\", %d)\n", args, what);
2575 find_default_supports_disable_randomization (struct target_ops *self)
2577 struct target_ops *t;
2579 t = find_default_run_target (NULL);
2580 if (t && t->to_supports_disable_randomization)
2581 return (t->to_supports_disable_randomization) (t);
2586 target_supports_disable_randomization (void)
2588 struct target_ops *t;
2590 for (t = ¤t_target; t != NULL; t = t->beneath)
2591 if (t->to_supports_disable_randomization)
2592 return t->to_supports_disable_randomization (t);
2598 target_get_osdata (const char *type)
2600 struct target_ops *t;
2602 /* If we're already connected to something that can get us OS
2603 related data, use it. Otherwise, try using the native
2605 if (current_target.to_stratum >= process_stratum)
2606 t = current_target.beneath;
2608 t = find_default_run_target ("get OS data");
2613 return target_read_stralloc (t, TARGET_OBJECT_OSDATA, type);
2616 static struct address_space *
2617 default_thread_address_space (struct target_ops *self, ptid_t ptid)
2619 struct inferior *inf;
2621 /* Fall-back to the "main" address space of the inferior. */
2622 inf = find_inferior_pid (ptid_get_pid (ptid));
2624 if (inf == NULL || inf->aspace == NULL)
2625 internal_error (__FILE__, __LINE__,
2626 _("Can't determine the current "
2627 "address space of thread %s\n"),
2628 target_pid_to_str (ptid));
2633 /* Determine the current address space of thread PTID. */
2635 struct address_space *
2636 target_thread_address_space (ptid_t ptid)
2638 struct address_space *aspace;
2640 aspace = current_target.to_thread_address_space (¤t_target, ptid);
2641 gdb_assert (aspace != NULL);
2644 fprintf_unfiltered (gdb_stdlog,
2645 "target_thread_address_space (%s) = %d\n",
2646 target_pid_to_str (ptid),
2647 address_space_num (aspace));
2653 /* Target file operations. */
2655 static struct target_ops *
2656 default_fileio_target (void)
2658 /* If we're already connected to something that can perform
2659 file I/O, use it. Otherwise, try using the native target. */
2660 if (current_target.to_stratum >= process_stratum)
2661 return current_target.beneath;
2663 return find_default_run_target ("file I/O");
2666 /* Open FILENAME on the target, using FLAGS and MODE. Return a
2667 target file descriptor, or -1 if an error occurs (and set
2670 target_fileio_open (const char *filename, int flags, int mode,
2673 struct target_ops *t;
2675 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2677 if (t->to_fileio_open != NULL)
2679 int fd = t->to_fileio_open (t, filename, flags, mode, target_errno);
2682 fprintf_unfiltered (gdb_stdlog,
2683 "target_fileio_open (%s,0x%x,0%o) = %d (%d)\n",
2684 filename, flags, mode,
2685 fd, fd != -1 ? 0 : *target_errno);
2690 *target_errno = FILEIO_ENOSYS;
2694 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
2695 Return the number of bytes written, or -1 if an error occurs
2696 (and set *TARGET_ERRNO). */
2698 target_fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
2699 ULONGEST offset, int *target_errno)
2701 struct target_ops *t;
2703 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2705 if (t->to_fileio_pwrite != NULL)
2707 int ret = t->to_fileio_pwrite (t, fd, write_buf, len, offset,
2711 fprintf_unfiltered (gdb_stdlog,
2712 "target_fileio_pwrite (%d,...,%d,%s) "
2714 fd, len, pulongest (offset),
2715 ret, ret != -1 ? 0 : *target_errno);
2720 *target_errno = FILEIO_ENOSYS;
2724 /* Read up to LEN bytes FD on the target into READ_BUF.
2725 Return the number of bytes read, or -1 if an error occurs
2726 (and set *TARGET_ERRNO). */
2728 target_fileio_pread (int fd, gdb_byte *read_buf, int len,
2729 ULONGEST offset, int *target_errno)
2731 struct target_ops *t;
2733 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2735 if (t->to_fileio_pread != NULL)
2737 int ret = t->to_fileio_pread (t, fd, read_buf, len, offset,
2741 fprintf_unfiltered (gdb_stdlog,
2742 "target_fileio_pread (%d,...,%d,%s) "
2744 fd, len, pulongest (offset),
2745 ret, ret != -1 ? 0 : *target_errno);
2750 *target_errno = FILEIO_ENOSYS;
2754 /* Close FD on the target. Return 0, or -1 if an error occurs
2755 (and set *TARGET_ERRNO). */
2757 target_fileio_close (int fd, int *target_errno)
2759 struct target_ops *t;
2761 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2763 if (t->to_fileio_close != NULL)
2765 int ret = t->to_fileio_close (t, fd, target_errno);
2768 fprintf_unfiltered (gdb_stdlog,
2769 "target_fileio_close (%d) = %d (%d)\n",
2770 fd, ret, ret != -1 ? 0 : *target_errno);
2775 *target_errno = FILEIO_ENOSYS;
2779 /* Unlink FILENAME on the target. Return 0, or -1 if an error
2780 occurs (and set *TARGET_ERRNO). */
2782 target_fileio_unlink (const char *filename, int *target_errno)
2784 struct target_ops *t;
2786 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2788 if (t->to_fileio_unlink != NULL)
2790 int ret = t->to_fileio_unlink (t, filename, target_errno);
2793 fprintf_unfiltered (gdb_stdlog,
2794 "target_fileio_unlink (%s) = %d (%d)\n",
2795 filename, ret, ret != -1 ? 0 : *target_errno);
2800 *target_errno = FILEIO_ENOSYS;
2804 /* Read value of symbolic link FILENAME on the target. Return a
2805 null-terminated string allocated via xmalloc, or NULL if an error
2806 occurs (and set *TARGET_ERRNO). */
2808 target_fileio_readlink (const char *filename, int *target_errno)
2810 struct target_ops *t;
2812 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2814 if (t->to_fileio_readlink != NULL)
2816 char *ret = t->to_fileio_readlink (t, filename, target_errno);
2819 fprintf_unfiltered (gdb_stdlog,
2820 "target_fileio_readlink (%s) = %s (%d)\n",
2821 filename, ret? ret : "(nil)",
2822 ret? 0 : *target_errno);
2827 *target_errno = FILEIO_ENOSYS;
2832 target_fileio_close_cleanup (void *opaque)
2834 int fd = *(int *) opaque;
2837 target_fileio_close (fd, &target_errno);
2840 /* Read target file FILENAME. Store the result in *BUF_P and
2841 return the size of the transferred data. PADDING additional bytes are
2842 available in *BUF_P. This is a helper function for
2843 target_fileio_read_alloc; see the declaration of that function for more
2847 target_fileio_read_alloc_1 (const char *filename,
2848 gdb_byte **buf_p, int padding)
2850 struct cleanup *close_cleanup;
2851 size_t buf_alloc, buf_pos;
2857 fd = target_fileio_open (filename, FILEIO_O_RDONLY, 0700, &target_errno);
2861 close_cleanup = make_cleanup (target_fileio_close_cleanup, &fd);
2863 /* Start by reading up to 4K at a time. The target will throttle
2864 this number down if necessary. */
2866 buf = xmalloc (buf_alloc);
2870 n = target_fileio_pread (fd, &buf[buf_pos],
2871 buf_alloc - buf_pos - padding, buf_pos,
2875 /* An error occurred. */
2876 do_cleanups (close_cleanup);
2882 /* Read all there was. */
2883 do_cleanups (close_cleanup);
2893 /* If the buffer is filling up, expand it. */
2894 if (buf_alloc < buf_pos * 2)
2897 buf = xrealloc (buf, buf_alloc);
2904 /* Read target file FILENAME. Store the result in *BUF_P and return
2905 the size of the transferred data. See the declaration in "target.h"
2906 function for more information about the return value. */
2909 target_fileio_read_alloc (const char *filename, gdb_byte **buf_p)
2911 return target_fileio_read_alloc_1 (filename, buf_p, 0);
2914 /* Read target file FILENAME. The result is NUL-terminated and
2915 returned as a string, allocated using xmalloc. If an error occurs
2916 or the transfer is unsupported, NULL is returned. Empty objects
2917 are returned as allocated but empty strings. A warning is issued
2918 if the result contains any embedded NUL bytes. */
2921 target_fileio_read_stralloc (const char *filename)
2925 LONGEST i, transferred;
2927 transferred = target_fileio_read_alloc_1 (filename, &buffer, 1);
2928 bufstr = (char *) buffer;
2930 if (transferred < 0)
2933 if (transferred == 0)
2934 return xstrdup ("");
2936 bufstr[transferred] = 0;
2938 /* Check for embedded NUL bytes; but allow trailing NULs. */
2939 for (i = strlen (bufstr); i < transferred; i++)
2942 warning (_("target file %s "
2943 "contained unexpected null characters"),
2953 default_region_ok_for_hw_watchpoint (struct target_ops *self,
2954 CORE_ADDR addr, int len)
2956 return (len <= gdbarch_ptr_bit (target_gdbarch ()) / TARGET_CHAR_BIT);
2960 default_watchpoint_addr_within_range (struct target_ops *target,
2962 CORE_ADDR start, int length)
2964 return addr >= start && addr < start + length;
2967 static struct gdbarch *
2968 default_thread_architecture (struct target_ops *ops, ptid_t ptid)
2970 return target_gdbarch ();
2974 return_zero (struct target_ops *ignore)
2980 return_zero_has_execution (struct target_ops *ignore, ptid_t ignore2)
2986 * Find the next target down the stack from the specified target.
2990 find_target_beneath (struct target_ops *t)
2998 find_target_at (enum strata stratum)
3000 struct target_ops *t;
3002 for (t = current_target.beneath; t != NULL; t = t->beneath)
3003 if (t->to_stratum == stratum)
3010 /* The inferior process has died. Long live the inferior! */
3013 generic_mourn_inferior (void)
3017 ptid = inferior_ptid;
3018 inferior_ptid = null_ptid;
3020 /* Mark breakpoints uninserted in case something tries to delete a
3021 breakpoint while we delete the inferior's threads (which would
3022 fail, since the inferior is long gone). */
3023 mark_breakpoints_out ();
3025 if (!ptid_equal (ptid, null_ptid))
3027 int pid = ptid_get_pid (ptid);
3028 exit_inferior (pid);
3031 /* Note this wipes step-resume breakpoints, so needs to be done
3032 after exit_inferior, which ends up referencing the step-resume
3033 breakpoints through clear_thread_inferior_resources. */
3034 breakpoint_init_inferior (inf_exited);
3036 registers_changed ();
3038 reopen_exec_file ();
3039 reinit_frame_cache ();
3041 if (deprecated_detach_hook)
3042 deprecated_detach_hook ();
3045 /* Convert a normal process ID to a string. Returns the string in a
3049 normal_pid_to_str (ptid_t ptid)
3051 static char buf[32];
3053 xsnprintf (buf, sizeof buf, "process %d", ptid_get_pid (ptid));
3058 default_pid_to_str (struct target_ops *ops, ptid_t ptid)
3060 return normal_pid_to_str (ptid);
3063 /* Error-catcher for target_find_memory_regions. */
3065 dummy_find_memory_regions (struct target_ops *self,
3066 find_memory_region_ftype ignore1, void *ignore2)
3068 error (_("Command not implemented for this target."));
3072 /* Error-catcher for target_make_corefile_notes. */
3074 dummy_make_corefile_notes (struct target_ops *self,
3075 bfd *ignore1, int *ignore2)
3077 error (_("Command not implemented for this target."));
3081 /* Set up the handful of non-empty slots needed by the dummy target
3085 init_dummy_target (void)
3087 dummy_target.to_shortname = "None";
3088 dummy_target.to_longname = "None";
3089 dummy_target.to_doc = "";
3090 dummy_target.to_supports_disable_randomization
3091 = find_default_supports_disable_randomization;
3092 dummy_target.to_stratum = dummy_stratum;
3093 dummy_target.to_has_all_memory = return_zero;
3094 dummy_target.to_has_memory = return_zero;
3095 dummy_target.to_has_stack = return_zero;
3096 dummy_target.to_has_registers = return_zero;
3097 dummy_target.to_has_execution = return_zero_has_execution;
3098 dummy_target.to_magic = OPS_MAGIC;
3100 install_dummy_methods (&dummy_target);
3104 debug_to_open (char *args, int from_tty)
3106 debug_target.to_open (args, from_tty);
3108 fprintf_unfiltered (gdb_stdlog, "target_open (%s, %d)\n", args, from_tty);
3112 target_close (struct target_ops *targ)
3114 gdb_assert (!target_is_pushed (targ));
3116 if (targ->to_xclose != NULL)
3117 targ->to_xclose (targ);
3118 else if (targ->to_close != NULL)
3119 targ->to_close (targ);
3122 fprintf_unfiltered (gdb_stdlog, "target_close ()\n");
3126 target_thread_alive (ptid_t ptid)
3130 retval = current_target.to_thread_alive (¤t_target, ptid);
3132 fprintf_unfiltered (gdb_stdlog, "target_thread_alive (%d) = %d\n",
3133 ptid_get_pid (ptid), retval);
3139 target_find_new_threads (void)
3141 current_target.to_find_new_threads (¤t_target);
3143 fprintf_unfiltered (gdb_stdlog, "target_find_new_threads ()\n");
3147 target_stop (ptid_t ptid)
3151 warning (_("May not interrupt or stop the target, ignoring attempt"));
3155 (*current_target.to_stop) (¤t_target, ptid);
3159 debug_to_post_attach (struct target_ops *self, int pid)
3161 debug_target.to_post_attach (&debug_target, pid);
3163 fprintf_unfiltered (gdb_stdlog, "target_post_attach (%d)\n", pid);
3166 /* Concatenate ELEM to LIST, a comma separate list, and return the
3167 result. The LIST incoming argument is released. */
3170 str_comma_list_concat_elem (char *list, const char *elem)
3173 return xstrdup (elem);
3175 return reconcat (list, list, ", ", elem, (char *) NULL);
3178 /* Helper for target_options_to_string. If OPT is present in
3179 TARGET_OPTIONS, append the OPT_STR (string version of OPT) in RET.
3180 Returns the new resulting string. OPT is removed from
3184 do_option (int *target_options, char *ret,
3185 int opt, char *opt_str)
3187 if ((*target_options & opt) != 0)
3189 ret = str_comma_list_concat_elem (ret, opt_str);
3190 *target_options &= ~opt;
3197 target_options_to_string (int target_options)
3201 #define DO_TARG_OPTION(OPT) \
3202 ret = do_option (&target_options, ret, OPT, #OPT)
3204 DO_TARG_OPTION (TARGET_WNOHANG);
3206 if (target_options != 0)
3207 ret = str_comma_list_concat_elem (ret, "unknown???");
3215 debug_print_register (const char * func,
3216 struct regcache *regcache, int regno)
3218 struct gdbarch *gdbarch = get_regcache_arch (regcache);
3220 fprintf_unfiltered (gdb_stdlog, "%s ", func);
3221 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch)
3222 && gdbarch_register_name (gdbarch, regno) != NULL
3223 && gdbarch_register_name (gdbarch, regno)[0] != '\0')
3224 fprintf_unfiltered (gdb_stdlog, "(%s)",
3225 gdbarch_register_name (gdbarch, regno));
3227 fprintf_unfiltered (gdb_stdlog, "(%d)", regno);
3228 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch))
3230 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
3231 int i, size = register_size (gdbarch, regno);
3232 gdb_byte buf[MAX_REGISTER_SIZE];
3234 regcache_raw_collect (regcache, regno, buf);
3235 fprintf_unfiltered (gdb_stdlog, " = ");
3236 for (i = 0; i < size; i++)
3238 fprintf_unfiltered (gdb_stdlog, "%02x", buf[i]);
3240 if (size <= sizeof (LONGEST))
3242 ULONGEST val = extract_unsigned_integer (buf, size, byte_order);
3244 fprintf_unfiltered (gdb_stdlog, " %s %s",
3245 core_addr_to_string_nz (val), plongest (val));
3248 fprintf_unfiltered (gdb_stdlog, "\n");
3252 target_fetch_registers (struct regcache *regcache, int regno)
3254 current_target.to_fetch_registers (¤t_target, regcache, regno);
3256 debug_print_register ("target_fetch_registers", regcache, regno);
3260 target_store_registers (struct regcache *regcache, int regno)
3262 struct target_ops *t;
3264 if (!may_write_registers)
3265 error (_("Writing to registers is not allowed (regno %d)"), regno);
3267 current_target.to_store_registers (¤t_target, regcache, regno);
3270 debug_print_register ("target_store_registers", regcache, regno);
3275 target_core_of_thread (ptid_t ptid)
3277 int retval = current_target.to_core_of_thread (¤t_target, ptid);
3280 fprintf_unfiltered (gdb_stdlog,
3281 "target_core_of_thread (%d) = %d\n",
3282 ptid_get_pid (ptid), retval);
3287 simple_verify_memory (struct target_ops *ops,
3288 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
3290 LONGEST total_xfered = 0;
3292 while (total_xfered < size)
3294 ULONGEST xfered_len;
3295 enum target_xfer_status status;
3297 ULONGEST howmuch = min (sizeof (buf), size - total_xfered);
3299 status = target_xfer_partial (ops, TARGET_OBJECT_MEMORY, NULL,
3300 buf, NULL, lma + total_xfered, howmuch,
3302 if (status == TARGET_XFER_OK
3303 && memcmp (data + total_xfered, buf, xfered_len) == 0)
3305 total_xfered += xfered_len;
3314 /* Default implementation of memory verification. */
3317 default_verify_memory (struct target_ops *self,
3318 const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
3320 /* Start over from the top of the target stack. */
3321 return simple_verify_memory (current_target.beneath,
3322 data, memaddr, size);
3326 target_verify_memory (const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
3328 int retval = current_target.to_verify_memory (¤t_target,
3329 data, memaddr, size);
3332 fprintf_unfiltered (gdb_stdlog,
3333 "target_verify_memory (%s, %s) = %d\n",
3334 paddress (target_gdbarch (), memaddr),
3340 /* The documentation for this function is in its prototype declaration in
3344 target_insert_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
3348 ret = current_target.to_insert_mask_watchpoint (¤t_target,
3352 fprintf_unfiltered (gdb_stdlog, "\
3353 target_insert_mask_watchpoint (%s, %s, %d) = %d\n",
3354 core_addr_to_string (addr),
3355 core_addr_to_string (mask), rw, ret);
3360 /* The documentation for this function is in its prototype declaration in
3364 target_remove_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
3368 ret = current_target.to_remove_mask_watchpoint (¤t_target,
3372 fprintf_unfiltered (gdb_stdlog, "\
3373 target_remove_mask_watchpoint (%s, %s, %d) = %d\n",
3374 core_addr_to_string (addr),
3375 core_addr_to_string (mask), rw, ret);
3380 /* The documentation for this function is in its prototype declaration
3384 target_masked_watch_num_registers (CORE_ADDR addr, CORE_ADDR mask)
3386 return current_target.to_masked_watch_num_registers (¤t_target,
3390 /* The documentation for this function is in its prototype declaration
3394 target_ranged_break_num_registers (void)
3396 return current_target.to_ranged_break_num_registers (¤t_target);
3401 struct btrace_target_info *
3402 target_enable_btrace (ptid_t ptid)
3404 return current_target.to_enable_btrace (¤t_target, ptid);
3410 target_disable_btrace (struct btrace_target_info *btinfo)
3412 current_target.to_disable_btrace (¤t_target, btinfo);
3418 target_teardown_btrace (struct btrace_target_info *btinfo)
3420 current_target.to_teardown_btrace (¤t_target, btinfo);
3426 target_read_btrace (VEC (btrace_block_s) **btrace,
3427 struct btrace_target_info *btinfo,
3428 enum btrace_read_type type)
3430 return current_target.to_read_btrace (¤t_target, btrace, btinfo, type);
3436 target_stop_recording (void)
3438 current_target.to_stop_recording (¤t_target);
3444 target_info_record (void)
3446 struct target_ops *t;
3448 for (t = current_target.beneath; t != NULL; t = t->beneath)
3449 if (t->to_info_record != NULL)
3451 t->to_info_record (t);
3461 target_save_record (const char *filename)
3463 current_target.to_save_record (¤t_target, filename);
3469 target_supports_delete_record (void)
3471 struct target_ops *t;
3473 for (t = current_target.beneath; t != NULL; t = t->beneath)
3474 if (t->to_delete_record != NULL)
3483 target_delete_record (void)
3485 current_target.to_delete_record (¤t_target);
3491 target_record_is_replaying (void)
3493 return current_target.to_record_is_replaying (¤t_target);
3499 target_goto_record_begin (void)
3501 current_target.to_goto_record_begin (¤t_target);
3507 target_goto_record_end (void)
3509 current_target.to_goto_record_end (¤t_target);
3515 target_goto_record (ULONGEST insn)
3517 current_target.to_goto_record (¤t_target, insn);
3523 target_insn_history (int size, int flags)
3525 current_target.to_insn_history (¤t_target, size, flags);
3531 target_insn_history_from (ULONGEST from, int size, int flags)
3533 current_target.to_insn_history_from (¤t_target, from, size, flags);
3539 target_insn_history_range (ULONGEST begin, ULONGEST end, int flags)
3541 current_target.to_insn_history_range (¤t_target, begin, end, flags);
3547 target_call_history (int size, int flags)
3549 current_target.to_call_history (¤t_target, size, flags);
3555 target_call_history_from (ULONGEST begin, int size, int flags)
3557 current_target.to_call_history_from (¤t_target, begin, size, flags);
3563 target_call_history_range (ULONGEST begin, ULONGEST end, int flags)
3565 current_target.to_call_history_range (¤t_target, begin, end, flags);
3569 debug_to_prepare_to_store (struct target_ops *self, struct regcache *regcache)
3571 debug_target.to_prepare_to_store (&debug_target, regcache);
3573 fprintf_unfiltered (gdb_stdlog, "target_prepare_to_store ()\n");
3578 const struct frame_unwind *
3579 target_get_unwinder (void)
3581 return current_target.to_get_unwinder (¤t_target);
3586 const struct frame_unwind *
3587 target_get_tailcall_unwinder (void)
3589 return current_target.to_get_tailcall_unwinder (¤t_target);
3592 /* Default implementation of to_decr_pc_after_break. */
3595 default_target_decr_pc_after_break (struct target_ops *ops,
3596 struct gdbarch *gdbarch)
3598 return gdbarch_decr_pc_after_break (gdbarch);
3604 target_decr_pc_after_break (struct gdbarch *gdbarch)
3606 return current_target.to_decr_pc_after_break (¤t_target, gdbarch);
3612 target_prepare_to_generate_core (void)
3614 current_target.to_prepare_to_generate_core (¤t_target);
3620 target_done_generating_core (void)
3622 current_target.to_done_generating_core (¤t_target);
3626 debug_to_files_info (struct target_ops *target)
3628 debug_target.to_files_info (target);
3630 fprintf_unfiltered (gdb_stdlog, "target_files_info (xxx)\n");
3634 debug_to_insert_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
3635 struct bp_target_info *bp_tgt)
3639 retval = debug_target.to_insert_breakpoint (&debug_target, gdbarch, bp_tgt);
3641 fprintf_unfiltered (gdb_stdlog,
3642 "target_insert_breakpoint (%s, xxx) = %ld\n",
3643 core_addr_to_string (bp_tgt->placed_address),
3644 (unsigned long) retval);
3649 debug_to_remove_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
3650 struct bp_target_info *bp_tgt)
3654 retval = debug_target.to_remove_breakpoint (&debug_target, gdbarch, bp_tgt);
3656 fprintf_unfiltered (gdb_stdlog,
3657 "target_remove_breakpoint (%s, xxx) = %ld\n",
3658 core_addr_to_string (bp_tgt->placed_address),
3659 (unsigned long) retval);
3664 debug_to_can_use_hw_breakpoint (struct target_ops *self,
3665 int type, int cnt, int from_tty)
3669 retval = debug_target.to_can_use_hw_breakpoint (&debug_target,
3670 type, cnt, from_tty);
3672 fprintf_unfiltered (gdb_stdlog,
3673 "target_can_use_hw_breakpoint (%ld, %ld, %ld) = %ld\n",
3674 (unsigned long) type,
3675 (unsigned long) cnt,
3676 (unsigned long) from_tty,
3677 (unsigned long) retval);
3682 debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
3683 CORE_ADDR addr, int len)
3687 retval = debug_target.to_region_ok_for_hw_watchpoint (&debug_target,
3690 fprintf_unfiltered (gdb_stdlog,
3691 "target_region_ok_for_hw_watchpoint (%s, %ld) = %s\n",
3692 core_addr_to_string (addr), (unsigned long) len,
3693 core_addr_to_string (retval));
3698 debug_to_can_accel_watchpoint_condition (struct target_ops *self,
3699 CORE_ADDR addr, int len, int rw,
3700 struct expression *cond)
3704 retval = debug_target.to_can_accel_watchpoint_condition (&debug_target,
3708 fprintf_unfiltered (gdb_stdlog,
3709 "target_can_accel_watchpoint_condition "
3710 "(%s, %d, %d, %s) = %ld\n",
3711 core_addr_to_string (addr), len, rw,
3712 host_address_to_string (cond), (unsigned long) retval);
3717 debug_to_stopped_by_watchpoint (struct target_ops *ops)
3721 retval = debug_target.to_stopped_by_watchpoint (&debug_target);
3723 fprintf_unfiltered (gdb_stdlog,
3724 "target_stopped_by_watchpoint () = %ld\n",
3725 (unsigned long) retval);
3730 debug_to_stopped_data_address (struct target_ops *target, CORE_ADDR *addr)
3734 retval = debug_target.to_stopped_data_address (target, addr);
3736 fprintf_unfiltered (gdb_stdlog,
3737 "target_stopped_data_address ([%s]) = %ld\n",
3738 core_addr_to_string (*addr),
3739 (unsigned long)retval);
3744 debug_to_watchpoint_addr_within_range (struct target_ops *target,
3746 CORE_ADDR start, int length)
3750 retval = debug_target.to_watchpoint_addr_within_range (target, addr,
3753 fprintf_filtered (gdb_stdlog,
3754 "target_watchpoint_addr_within_range (%s, %s, %d) = %d\n",
3755 core_addr_to_string (addr), core_addr_to_string (start),
3761 debug_to_insert_hw_breakpoint (struct target_ops *self,
3762 struct gdbarch *gdbarch,
3763 struct bp_target_info *bp_tgt)
3767 retval = debug_target.to_insert_hw_breakpoint (&debug_target,
3770 fprintf_unfiltered (gdb_stdlog,
3771 "target_insert_hw_breakpoint (%s, xxx) = %ld\n",
3772 core_addr_to_string (bp_tgt->placed_address),
3773 (unsigned long) retval);
3778 debug_to_remove_hw_breakpoint (struct target_ops *self,
3779 struct gdbarch *gdbarch,
3780 struct bp_target_info *bp_tgt)
3784 retval = debug_target.to_remove_hw_breakpoint (&debug_target,
3787 fprintf_unfiltered (gdb_stdlog,
3788 "target_remove_hw_breakpoint (%s, xxx) = %ld\n",
3789 core_addr_to_string (bp_tgt->placed_address),
3790 (unsigned long) retval);
3795 debug_to_insert_watchpoint (struct target_ops *self,
3796 CORE_ADDR addr, int len, int type,
3797 struct expression *cond)
3801 retval = debug_target.to_insert_watchpoint (&debug_target,
3802 addr, len, type, cond);
3804 fprintf_unfiltered (gdb_stdlog,
3805 "target_insert_watchpoint (%s, %d, %d, %s) = %ld\n",
3806 core_addr_to_string (addr), len, type,
3807 host_address_to_string (cond), (unsigned long) retval);
3812 debug_to_remove_watchpoint (struct target_ops *self,
3813 CORE_ADDR addr, int len, int type,
3814 struct expression *cond)
3818 retval = debug_target.to_remove_watchpoint (&debug_target,
3819 addr, len, type, cond);
3821 fprintf_unfiltered (gdb_stdlog,
3822 "target_remove_watchpoint (%s, %d, %d, %s) = %ld\n",
3823 core_addr_to_string (addr), len, type,
3824 host_address_to_string (cond), (unsigned long) retval);
3829 debug_to_terminal_init (struct target_ops *self)
3831 debug_target.to_terminal_init (&debug_target);
3833 fprintf_unfiltered (gdb_stdlog, "target_terminal_init ()\n");
3837 debug_to_terminal_inferior (struct target_ops *self)
3839 debug_target.to_terminal_inferior (&debug_target);
3841 fprintf_unfiltered (gdb_stdlog, "target_terminal_inferior ()\n");
3845 debug_to_terminal_ours_for_output (struct target_ops *self)
3847 debug_target.to_terminal_ours_for_output (&debug_target);
3849 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours_for_output ()\n");
3853 debug_to_terminal_ours (struct target_ops *self)
3855 debug_target.to_terminal_ours (&debug_target);
3857 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours ()\n");
3861 debug_to_terminal_save_ours (struct target_ops *self)
3863 debug_target.to_terminal_save_ours (&debug_target);
3865 fprintf_unfiltered (gdb_stdlog, "target_terminal_save_ours ()\n");
3869 debug_to_terminal_info (struct target_ops *self,
3870 const char *arg, int from_tty)
3872 debug_target.to_terminal_info (&debug_target, arg, from_tty);
3874 fprintf_unfiltered (gdb_stdlog, "target_terminal_info (%s, %d)\n", arg,
3879 debug_to_load (struct target_ops *self, const char *args, int from_tty)
3881 debug_target.to_load (&debug_target, args, from_tty);
3883 fprintf_unfiltered (gdb_stdlog, "target_load (%s, %d)\n", args, from_tty);
3887 debug_to_post_startup_inferior (struct target_ops *self, ptid_t ptid)
3889 debug_target.to_post_startup_inferior (&debug_target, ptid);
3891 fprintf_unfiltered (gdb_stdlog, "target_post_startup_inferior (%d)\n",
3892 ptid_get_pid (ptid));
3896 debug_to_insert_fork_catchpoint (struct target_ops *self, int pid)
3900 retval = debug_target.to_insert_fork_catchpoint (&debug_target, pid);
3902 fprintf_unfiltered (gdb_stdlog, "target_insert_fork_catchpoint (%d) = %d\n",
3909 debug_to_remove_fork_catchpoint (struct target_ops *self, int pid)
3913 retval = debug_target.to_remove_fork_catchpoint (&debug_target, pid);
3915 fprintf_unfiltered (gdb_stdlog, "target_remove_fork_catchpoint (%d) = %d\n",
3922 debug_to_insert_vfork_catchpoint (struct target_ops *self, int pid)
3926 retval = debug_target.to_insert_vfork_catchpoint (&debug_target, pid);
3928 fprintf_unfiltered (gdb_stdlog, "target_insert_vfork_catchpoint (%d) = %d\n",
3935 debug_to_remove_vfork_catchpoint (struct target_ops *self, int pid)
3939 retval = debug_target.to_remove_vfork_catchpoint (&debug_target, pid);
3941 fprintf_unfiltered (gdb_stdlog, "target_remove_vfork_catchpoint (%d) = %d\n",
3948 debug_to_insert_exec_catchpoint (struct target_ops *self, int pid)
3952 retval = debug_target.to_insert_exec_catchpoint (&debug_target, pid);
3954 fprintf_unfiltered (gdb_stdlog, "target_insert_exec_catchpoint (%d) = %d\n",
3961 debug_to_remove_exec_catchpoint (struct target_ops *self, int pid)
3965 retval = debug_target.to_remove_exec_catchpoint (&debug_target, pid);
3967 fprintf_unfiltered (gdb_stdlog, "target_remove_exec_catchpoint (%d) = %d\n",
3974 debug_to_has_exited (struct target_ops *self,
3975 int pid, int wait_status, int *exit_status)
3979 has_exited = debug_target.to_has_exited (&debug_target,
3980 pid, wait_status, exit_status);
3982 fprintf_unfiltered (gdb_stdlog, "target_has_exited (%d, %d, %d) = %d\n",
3983 pid, wait_status, *exit_status, has_exited);
3989 debug_to_can_run (struct target_ops *self)
3993 retval = debug_target.to_can_run (&debug_target);
3995 fprintf_unfiltered (gdb_stdlog, "target_can_run () = %d\n", retval);
4000 static struct gdbarch *
4001 debug_to_thread_architecture (struct target_ops *ops, ptid_t ptid)
4003 struct gdbarch *retval;
4005 retval = debug_target.to_thread_architecture (ops, ptid);
4007 fprintf_unfiltered (gdb_stdlog,
4008 "target_thread_architecture (%s) = %s [%s]\n",
4009 target_pid_to_str (ptid),
4010 host_address_to_string (retval),
4011 gdbarch_bfd_arch_info (retval)->printable_name);
4016 debug_to_stop (struct target_ops *self, ptid_t ptid)
4018 debug_target.to_stop (&debug_target, ptid);
4020 fprintf_unfiltered (gdb_stdlog, "target_stop (%s)\n",
4021 target_pid_to_str (ptid));
4025 debug_to_rcmd (struct target_ops *self, const char *command,
4026 struct ui_file *outbuf)
4028 debug_target.to_rcmd (&debug_target, command, outbuf);
4029 fprintf_unfiltered (gdb_stdlog, "target_rcmd (%s, ...)\n", command);
4033 debug_to_pid_to_exec_file (struct target_ops *self, int pid)
4037 exec_file = debug_target.to_pid_to_exec_file (&debug_target, pid);
4039 fprintf_unfiltered (gdb_stdlog, "target_pid_to_exec_file (%d) = %s\n",
4046 setup_target_debug (void)
4048 memcpy (&debug_target, ¤t_target, sizeof debug_target);
4050 current_target.to_open = debug_to_open;
4051 current_target.to_post_attach = debug_to_post_attach;
4052 current_target.to_prepare_to_store = debug_to_prepare_to_store;
4053 current_target.to_files_info = debug_to_files_info;
4054 current_target.to_insert_breakpoint = debug_to_insert_breakpoint;
4055 current_target.to_remove_breakpoint = debug_to_remove_breakpoint;
4056 current_target.to_can_use_hw_breakpoint = debug_to_can_use_hw_breakpoint;
4057 current_target.to_insert_hw_breakpoint = debug_to_insert_hw_breakpoint;
4058 current_target.to_remove_hw_breakpoint = debug_to_remove_hw_breakpoint;
4059 current_target.to_insert_watchpoint = debug_to_insert_watchpoint;
4060 current_target.to_remove_watchpoint = debug_to_remove_watchpoint;
4061 current_target.to_stopped_by_watchpoint = debug_to_stopped_by_watchpoint;
4062 current_target.to_stopped_data_address = debug_to_stopped_data_address;
4063 current_target.to_watchpoint_addr_within_range
4064 = debug_to_watchpoint_addr_within_range;
4065 current_target.to_region_ok_for_hw_watchpoint
4066 = debug_to_region_ok_for_hw_watchpoint;
4067 current_target.to_can_accel_watchpoint_condition
4068 = debug_to_can_accel_watchpoint_condition;
4069 current_target.to_terminal_init = debug_to_terminal_init;
4070 current_target.to_terminal_inferior = debug_to_terminal_inferior;
4071 current_target.to_terminal_ours_for_output
4072 = debug_to_terminal_ours_for_output;
4073 current_target.to_terminal_ours = debug_to_terminal_ours;
4074 current_target.to_terminal_save_ours = debug_to_terminal_save_ours;
4075 current_target.to_terminal_info = debug_to_terminal_info;
4076 current_target.to_load = debug_to_load;
4077 current_target.to_post_startup_inferior = debug_to_post_startup_inferior;
4078 current_target.to_insert_fork_catchpoint = debug_to_insert_fork_catchpoint;
4079 current_target.to_remove_fork_catchpoint = debug_to_remove_fork_catchpoint;
4080 current_target.to_insert_vfork_catchpoint = debug_to_insert_vfork_catchpoint;
4081 current_target.to_remove_vfork_catchpoint = debug_to_remove_vfork_catchpoint;
4082 current_target.to_insert_exec_catchpoint = debug_to_insert_exec_catchpoint;
4083 current_target.to_remove_exec_catchpoint = debug_to_remove_exec_catchpoint;
4084 current_target.to_has_exited = debug_to_has_exited;
4085 current_target.to_can_run = debug_to_can_run;
4086 current_target.to_stop = debug_to_stop;
4087 current_target.to_rcmd = debug_to_rcmd;
4088 current_target.to_pid_to_exec_file = debug_to_pid_to_exec_file;
4089 current_target.to_thread_architecture = debug_to_thread_architecture;
4093 static char targ_desc[] =
4094 "Names of targets and files being debugged.\nShows the entire \
4095 stack of targets currently in use (including the exec-file,\n\
4096 core-file, and process, if any), as well as the symbol file name.";
4099 default_rcmd (struct target_ops *self, const char *command,
4100 struct ui_file *output)
4102 error (_("\"monitor\" command not supported by this target."));
4106 do_monitor_command (char *cmd,
4109 target_rcmd (cmd, gdb_stdtarg);
4112 /* Print the name of each layers of our target stack. */
4115 maintenance_print_target_stack (char *cmd, int from_tty)
4117 struct target_ops *t;
4119 printf_filtered (_("The current target stack is:\n"));
4121 for (t = target_stack; t != NULL; t = t->beneath)
4123 printf_filtered (" - %s (%s)\n", t->to_shortname, t->to_longname);
4127 /* Controls if targets can report that they can/are async. This is
4128 just for maintainers to use when debugging gdb. */
4129 int target_async_permitted = 1;
4131 /* The set command writes to this variable. If the inferior is
4132 executing, target_async_permitted is *not* updated. */
4133 static int target_async_permitted_1 = 1;
4136 maint_set_target_async_command (char *args, int from_tty,
4137 struct cmd_list_element *c)
4139 if (have_live_inferiors ())
4141 target_async_permitted_1 = target_async_permitted;
4142 error (_("Cannot change this setting while the inferior is running."));
4145 target_async_permitted = target_async_permitted_1;
4149 maint_show_target_async_command (struct ui_file *file, int from_tty,
4150 struct cmd_list_element *c,
4153 fprintf_filtered (file,
4154 _("Controlling the inferior in "
4155 "asynchronous mode is %s.\n"), value);
4158 /* Temporary copies of permission settings. */
4160 static int may_write_registers_1 = 1;
4161 static int may_write_memory_1 = 1;
4162 static int may_insert_breakpoints_1 = 1;
4163 static int may_insert_tracepoints_1 = 1;
4164 static int may_insert_fast_tracepoints_1 = 1;
4165 static int may_stop_1 = 1;
4167 /* Make the user-set values match the real values again. */
4170 update_target_permissions (void)
4172 may_write_registers_1 = may_write_registers;
4173 may_write_memory_1 = may_write_memory;
4174 may_insert_breakpoints_1 = may_insert_breakpoints;
4175 may_insert_tracepoints_1 = may_insert_tracepoints;
4176 may_insert_fast_tracepoints_1 = may_insert_fast_tracepoints;
4177 may_stop_1 = may_stop;
4180 /* The one function handles (most of) the permission flags in the same
4184 set_target_permissions (char *args, int from_tty,
4185 struct cmd_list_element *c)
4187 if (target_has_execution)
4189 update_target_permissions ();
4190 error (_("Cannot change this setting while the inferior is running."));
4193 /* Make the real values match the user-changed values. */
4194 may_write_registers = may_write_registers_1;
4195 may_insert_breakpoints = may_insert_breakpoints_1;
4196 may_insert_tracepoints = may_insert_tracepoints_1;
4197 may_insert_fast_tracepoints = may_insert_fast_tracepoints_1;
4198 may_stop = may_stop_1;
4199 update_observer_mode ();
4202 /* Set memory write permission independently of observer mode. */
4205 set_write_memory_permission (char *args, int from_tty,
4206 struct cmd_list_element *c)
4208 /* Make the real values match the user-changed values. */
4209 may_write_memory = may_write_memory_1;
4210 update_observer_mode ();
4215 initialize_targets (void)
4217 init_dummy_target ();
4218 push_target (&dummy_target);
4220 add_info ("target", target_info, targ_desc);
4221 add_info ("files", target_info, targ_desc);
4223 add_setshow_zuinteger_cmd ("target", class_maintenance, &targetdebug, _("\
4224 Set target debugging."), _("\
4225 Show target debugging."), _("\
4226 When non-zero, target debugging is enabled. Higher numbers are more\n\
4227 verbose. Changes do not take effect until the next \"run\" or \"target\"\n\
4231 &setdebuglist, &showdebuglist);
4233 add_setshow_boolean_cmd ("trust-readonly-sections", class_support,
4234 &trust_readonly, _("\
4235 Set mode for reading from readonly sections."), _("\
4236 Show mode for reading from readonly sections."), _("\
4237 When this mode is on, memory reads from readonly sections (such as .text)\n\
4238 will be read from the object file instead of from the target. This will\n\
4239 result in significant performance improvement for remote targets."),
4241 show_trust_readonly,
4242 &setlist, &showlist);
4244 add_com ("monitor", class_obscure, do_monitor_command,
4245 _("Send a command to the remote monitor (remote targets only)."));
4247 add_cmd ("target-stack", class_maintenance, maintenance_print_target_stack,
4248 _("Print the name of each layer of the internal target stack."),
4249 &maintenanceprintlist);
4251 add_setshow_boolean_cmd ("target-async", no_class,
4252 &target_async_permitted_1, _("\
4253 Set whether gdb controls the inferior in asynchronous mode."), _("\
4254 Show whether gdb controls the inferior in asynchronous mode."), _("\
4255 Tells gdb whether to control the inferior in asynchronous mode."),
4256 maint_set_target_async_command,
4257 maint_show_target_async_command,
4258 &maintenance_set_cmdlist,
4259 &maintenance_show_cmdlist);
4261 add_setshow_boolean_cmd ("may-write-registers", class_support,
4262 &may_write_registers_1, _("\
4263 Set permission to write into registers."), _("\
4264 Show permission to write into registers."), _("\
4265 When this permission is on, GDB may write into the target's registers.\n\
4266 Otherwise, any sort of write attempt will result in an error."),
4267 set_target_permissions, NULL,
4268 &setlist, &showlist);
4270 add_setshow_boolean_cmd ("may-write-memory", class_support,
4271 &may_write_memory_1, _("\
4272 Set permission to write into target memory."), _("\
4273 Show permission to write into target memory."), _("\
4274 When this permission is on, GDB may write into the target's memory.\n\
4275 Otherwise, any sort of write attempt will result in an error."),
4276 set_write_memory_permission, NULL,
4277 &setlist, &showlist);
4279 add_setshow_boolean_cmd ("may-insert-breakpoints", class_support,
4280 &may_insert_breakpoints_1, _("\
4281 Set permission to insert breakpoints in the target."), _("\
4282 Show permission to insert breakpoints in the target."), _("\
4283 When this permission is on, GDB may insert breakpoints in the program.\n\
4284 Otherwise, any sort of insertion attempt will result in an error."),
4285 set_target_permissions, NULL,
4286 &setlist, &showlist);
4288 add_setshow_boolean_cmd ("may-insert-tracepoints", class_support,
4289 &may_insert_tracepoints_1, _("\
4290 Set permission to insert tracepoints in the target."), _("\
4291 Show permission to insert tracepoints in the target."), _("\
4292 When this permission is on, GDB may insert tracepoints in the program.\n\
4293 Otherwise, any sort of insertion attempt will result in an error."),
4294 set_target_permissions, NULL,
4295 &setlist, &showlist);
4297 add_setshow_boolean_cmd ("may-insert-fast-tracepoints", class_support,
4298 &may_insert_fast_tracepoints_1, _("\
4299 Set permission to insert fast tracepoints in the target."), _("\
4300 Show permission to insert fast tracepoints in the target."), _("\
4301 When this permission is on, GDB may insert fast tracepoints.\n\
4302 Otherwise, any sort of insertion attempt will result in an error."),
4303 set_target_permissions, NULL,
4304 &setlist, &showlist);
4306 add_setshow_boolean_cmd ("may-interrupt", class_support,
4308 Set permission to interrupt or signal the target."), _("\
4309 Show permission to interrupt or signal the target."), _("\
4310 When this permission is on, GDB may interrupt/stop the target's execution.\n\
4311 Otherwise, any attempt to interrupt or stop will be ignored."),
4312 set_target_permissions, NULL,
4313 &setlist, &showlist);
4315 add_setshow_boolean_cmd ("auto-connect-native-target", class_support,
4316 &auto_connect_native_target, _("\
4317 Set whether GDB may automatically connect to the native target."), _("\
4318 Show whether GDB may automatically connect to the native target."), _("\
4319 When on, and GDB is not connected to a target yet, GDB\n\
4320 attempts \"run\" and other commands with the native target."),
4321 NULL, show_auto_connect_native_target,
4322 &setlist, &showlist);