1 /* Select target systems and architectures at runtime for GDB.
3 Copyright (C) 1990-2014 Free Software Foundation, Inc.
5 Contributed by Cygnus Support.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
26 #include "target-dcache.h"
36 #include "gdb_assert.h"
38 #include "exceptions.h"
39 #include "target-descriptions.h"
40 #include "gdbthread.h"
43 #include "inline-frame.h"
44 #include "tracepoint.h"
45 #include "gdb/fileio.h"
49 static void target_info (char *, int);
51 static void default_terminal_info (struct target_ops *, const char *, int);
53 static int default_watchpoint_addr_within_range (struct target_ops *,
54 CORE_ADDR, CORE_ADDR, int);
56 static int default_region_ok_for_hw_watchpoint (struct target_ops *,
59 static void default_rcmd (struct target_ops *, char *, struct ui_file *);
61 static ptid_t default_get_ada_task_ptid (struct target_ops *self,
64 static int default_follow_fork (struct target_ops *self, int follow_child,
67 static void default_mourn_inferior (struct target_ops *self);
69 static int default_search_memory (struct target_ops *ops,
71 ULONGEST search_space_len,
72 const gdb_byte *pattern,
74 CORE_ADDR *found_addrp);
76 static int default_verify_memory (struct target_ops *self,
78 CORE_ADDR memaddr, ULONGEST size);
80 static void tcomplain (void) ATTRIBUTE_NORETURN;
82 static int return_zero (struct target_ops *);
84 static int return_zero_has_execution (struct target_ops *, ptid_t);
86 static void target_command (char *, int);
88 static struct target_ops *find_default_run_target (char *);
90 static struct gdbarch *default_thread_architecture (struct target_ops *ops,
93 static int dummy_find_memory_regions (struct target_ops *self,
94 find_memory_region_ftype ignore1,
97 static char *dummy_make_corefile_notes (struct target_ops *self,
98 bfd *ignore1, int *ignore2);
100 static char *default_pid_to_str (struct target_ops *ops, ptid_t ptid);
102 static enum exec_direction_kind default_execution_direction
103 (struct target_ops *self);
105 static CORE_ADDR default_target_decr_pc_after_break (struct target_ops *ops,
106 struct gdbarch *gdbarch);
108 #include "target-delegates.c"
110 static void init_dummy_target (void);
112 static struct target_ops debug_target;
114 static void debug_to_open (char *, int);
116 static void debug_to_prepare_to_store (struct target_ops *self,
119 static void debug_to_files_info (struct target_ops *);
121 static int debug_to_insert_breakpoint (struct target_ops *, struct gdbarch *,
122 struct bp_target_info *);
124 static int debug_to_remove_breakpoint (struct target_ops *, struct gdbarch *,
125 struct bp_target_info *);
127 static int debug_to_can_use_hw_breakpoint (struct target_ops *self,
130 static int debug_to_insert_hw_breakpoint (struct target_ops *self,
132 struct bp_target_info *);
134 static int debug_to_remove_hw_breakpoint (struct target_ops *self,
136 struct bp_target_info *);
138 static int debug_to_insert_watchpoint (struct target_ops *self,
140 struct expression *);
142 static int debug_to_remove_watchpoint (struct target_ops *self,
144 struct expression *);
146 static int debug_to_stopped_data_address (struct target_ops *, CORE_ADDR *);
148 static int debug_to_watchpoint_addr_within_range (struct target_ops *,
149 CORE_ADDR, CORE_ADDR, int);
151 static int debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
154 static int debug_to_can_accel_watchpoint_condition (struct target_ops *self,
156 struct expression *);
158 static void debug_to_terminal_init (struct target_ops *self);
160 static void debug_to_terminal_inferior (struct target_ops *self);
162 static void debug_to_terminal_ours_for_output (struct target_ops *self);
164 static void debug_to_terminal_save_ours (struct target_ops *self);
166 static void debug_to_terminal_ours (struct target_ops *self);
168 static void debug_to_load (struct target_ops *self, char *, int);
170 static int debug_to_can_run (struct target_ops *self);
172 static void debug_to_stop (struct target_ops *self, ptid_t);
174 /* Pointer to array of target architecture structures; the size of the
175 array; the current index into the array; the allocated size of the
177 struct target_ops **target_structs;
178 unsigned target_struct_size;
179 unsigned target_struct_allocsize;
180 #define DEFAULT_ALLOCSIZE 10
182 /* The initial current target, so that there is always a semi-valid
185 static struct target_ops dummy_target;
187 /* Top of target stack. */
189 static struct target_ops *target_stack;
191 /* The target structure we are currently using to talk to a process
192 or file or whatever "inferior" we have. */
194 struct target_ops current_target;
196 /* Command list for target. */
198 static struct cmd_list_element *targetlist = NULL;
200 /* Nonzero if we should trust readonly sections from the
201 executable when reading memory. */
203 static int trust_readonly = 0;
205 /* Nonzero if we should show true memory content including
206 memory breakpoint inserted by gdb. */
208 static int show_memory_breakpoints = 0;
210 /* These globals control whether GDB attempts to perform these
211 operations; they are useful for targets that need to prevent
212 inadvertant disruption, such as in non-stop mode. */
214 int may_write_registers = 1;
216 int may_write_memory = 1;
218 int may_insert_breakpoints = 1;
220 int may_insert_tracepoints = 1;
222 int may_insert_fast_tracepoints = 1;
226 /* Non-zero if we want to see trace of target level stuff. */
228 static unsigned int targetdebug = 0;
230 show_targetdebug (struct ui_file *file, int from_tty,
231 struct cmd_list_element *c, const char *value)
233 fprintf_filtered (file, _("Target debugging is %s.\n"), value);
236 static void setup_target_debug (void);
238 /* The user just typed 'target' without the name of a target. */
241 target_command (char *arg, int from_tty)
243 fputs_filtered ("Argument required (target name). Try `help target'\n",
247 /* Default target_has_* methods for process_stratum targets. */
250 default_child_has_all_memory (struct target_ops *ops)
252 /* If no inferior selected, then we can't read memory here. */
253 if (ptid_equal (inferior_ptid, null_ptid))
260 default_child_has_memory (struct target_ops *ops)
262 /* If no inferior selected, then we can't read memory here. */
263 if (ptid_equal (inferior_ptid, null_ptid))
270 default_child_has_stack (struct target_ops *ops)
272 /* If no inferior selected, there's no stack. */
273 if (ptid_equal (inferior_ptid, null_ptid))
280 default_child_has_registers (struct target_ops *ops)
282 /* Can't read registers from no inferior. */
283 if (ptid_equal (inferior_ptid, null_ptid))
290 default_child_has_execution (struct target_ops *ops, ptid_t the_ptid)
292 /* If there's no thread selected, then we can't make it run through
294 if (ptid_equal (the_ptid, null_ptid))
302 target_has_all_memory_1 (void)
304 struct target_ops *t;
306 for (t = current_target.beneath; t != NULL; t = t->beneath)
307 if (t->to_has_all_memory (t))
314 target_has_memory_1 (void)
316 struct target_ops *t;
318 for (t = current_target.beneath; t != NULL; t = t->beneath)
319 if (t->to_has_memory (t))
326 target_has_stack_1 (void)
328 struct target_ops *t;
330 for (t = current_target.beneath; t != NULL; t = t->beneath)
331 if (t->to_has_stack (t))
338 target_has_registers_1 (void)
340 struct target_ops *t;
342 for (t = current_target.beneath; t != NULL; t = t->beneath)
343 if (t->to_has_registers (t))
350 target_has_execution_1 (ptid_t the_ptid)
352 struct target_ops *t;
354 for (t = current_target.beneath; t != NULL; t = t->beneath)
355 if (t->to_has_execution (t, the_ptid))
362 target_has_execution_current (void)
364 return target_has_execution_1 (inferior_ptid);
367 /* Complete initialization of T. This ensures that various fields in
368 T are set, if needed by the target implementation. */
371 complete_target_initialization (struct target_ops *t)
373 /* Provide default values for all "must have" methods. */
375 if (t->to_has_all_memory == NULL)
376 t->to_has_all_memory = return_zero;
378 if (t->to_has_memory == NULL)
379 t->to_has_memory = return_zero;
381 if (t->to_has_stack == NULL)
382 t->to_has_stack = return_zero;
384 if (t->to_has_registers == NULL)
385 t->to_has_registers = return_zero;
387 if (t->to_has_execution == NULL)
388 t->to_has_execution = return_zero_has_execution;
390 /* These methods can be called on an unpushed target and so require
391 a default implementation if the target might plausibly be the
392 default run target. */
393 gdb_assert (t->to_can_run == NULL || (t->to_can_async_p != NULL
394 && t->to_supports_non_stop != NULL));
396 install_delegators (t);
399 /* Add possible target architecture T to the list and add a new
400 command 'target T->to_shortname'. Set COMPLETER as the command's
401 completer if not NULL. */
404 add_target_with_completer (struct target_ops *t,
405 completer_ftype *completer)
407 struct cmd_list_element *c;
409 complete_target_initialization (t);
413 target_struct_allocsize = DEFAULT_ALLOCSIZE;
414 target_structs = (struct target_ops **) xmalloc
415 (target_struct_allocsize * sizeof (*target_structs));
417 if (target_struct_size >= target_struct_allocsize)
419 target_struct_allocsize *= 2;
420 target_structs = (struct target_ops **)
421 xrealloc ((char *) target_structs,
422 target_struct_allocsize * sizeof (*target_structs));
424 target_structs[target_struct_size++] = t;
426 if (targetlist == NULL)
427 add_prefix_cmd ("target", class_run, target_command, _("\
428 Connect to a target machine or process.\n\
429 The first argument is the type or protocol of the target machine.\n\
430 Remaining arguments are interpreted by the target protocol. For more\n\
431 information on the arguments for a particular protocol, type\n\
432 `help target ' followed by the protocol name."),
433 &targetlist, "target ", 0, &cmdlist);
434 c = add_cmd (t->to_shortname, no_class, t->to_open, t->to_doc,
436 if (completer != NULL)
437 set_cmd_completer (c, completer);
440 /* Add a possible target architecture to the list. */
443 add_target (struct target_ops *t)
445 add_target_with_completer (t, NULL);
451 add_deprecated_target_alias (struct target_ops *t, char *alias)
453 struct cmd_list_element *c;
456 /* If we use add_alias_cmd, here, we do not get the deprecated warning,
458 c = add_cmd (alias, no_class, t->to_open, t->to_doc, &targetlist);
459 alt = xstrprintf ("target %s", t->to_shortname);
460 deprecate_cmd (c, alt);
469 fprintf_unfiltered (gdb_stdlog, "target_kill ()\n");
471 current_target.to_kill (¤t_target);
475 target_load (char *arg, int from_tty)
477 target_dcache_invalidate ();
478 (*current_target.to_load) (¤t_target, arg, from_tty);
482 target_terminal_inferior (void)
484 /* A background resume (``run&'') should leave GDB in control of the
485 terminal. Use target_can_async_p, not target_is_async_p, since at
486 this point the target is not async yet. However, if sync_execution
487 is not set, we know it will become async prior to resume. */
488 if (target_can_async_p () && !sync_execution)
491 /* If GDB is resuming the inferior in the foreground, install
492 inferior's terminal modes. */
493 (*current_target.to_terminal_inferior) (¤t_target);
499 error (_("You can't do that when your target is `%s'"),
500 current_target.to_shortname);
506 error (_("You can't do that without a process to debug."));
510 default_terminal_info (struct target_ops *self, const char *args, int from_tty)
512 printf_unfiltered (_("No saved terminal information.\n"));
515 /* A default implementation for the to_get_ada_task_ptid target method.
517 This function builds the PTID by using both LWP and TID as part of
518 the PTID lwp and tid elements. The pid used is the pid of the
522 default_get_ada_task_ptid (struct target_ops *self, long lwp, long tid)
524 return ptid_build (ptid_get_pid (inferior_ptid), lwp, tid);
527 static enum exec_direction_kind
528 default_execution_direction (struct target_ops *self)
530 if (!target_can_execute_reverse)
532 else if (!target_can_async_p ())
535 gdb_assert_not_reached ("\
536 to_execution_direction must be implemented for reverse async");
539 /* Go through the target stack from top to bottom, copying over zero
540 entries in current_target, then filling in still empty entries. In
541 effect, we are doing class inheritance through the pushed target
544 NOTE: cagney/2003-10-17: The problem with this inheritance, as it
545 is currently implemented, is that it discards any knowledge of
546 which target an inherited method originally belonged to.
547 Consequently, new new target methods should instead explicitly and
548 locally search the target stack for the target that can handle the
552 update_current_target (void)
554 struct target_ops *t;
556 /* First, reset current's contents. */
557 memset (¤t_target, 0, sizeof (current_target));
559 /* Install the delegators. */
560 install_delegators (¤t_target);
562 current_target.to_stratum = target_stack->to_stratum;
564 #define INHERIT(FIELD, TARGET) \
565 if (!current_target.FIELD) \
566 current_target.FIELD = (TARGET)->FIELD
568 /* Do not add any new INHERITs here. Instead, use the delegation
569 mechanism provided by make-target-delegates. */
570 for (t = target_stack; t; t = t->beneath)
572 INHERIT (to_shortname, t);
573 INHERIT (to_longname, t);
574 INHERIT (to_attach_no_wait, t);
575 INHERIT (to_have_steppable_watchpoint, t);
576 INHERIT (to_have_continuable_watchpoint, t);
577 INHERIT (to_has_thread_control, t);
581 /* Finally, position the target-stack beneath the squashed
582 "current_target". That way code looking for a non-inherited
583 target method can quickly and simply find it. */
584 current_target.beneath = target_stack;
587 setup_target_debug ();
590 /* Push a new target type into the stack of the existing target accessors,
591 possibly superseding some of the existing accessors.
593 Rather than allow an empty stack, we always have the dummy target at
594 the bottom stratum, so we can call the function vectors without
598 push_target (struct target_ops *t)
600 struct target_ops **cur;
602 /* Check magic number. If wrong, it probably means someone changed
603 the struct definition, but not all the places that initialize one. */
604 if (t->to_magic != OPS_MAGIC)
606 fprintf_unfiltered (gdb_stderr,
607 "Magic number of %s target struct wrong\n",
609 internal_error (__FILE__, __LINE__,
610 _("failed internal consistency check"));
613 /* Find the proper stratum to install this target in. */
614 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
616 if ((int) (t->to_stratum) >= (int) (*cur)->to_stratum)
620 /* If there's already targets at this stratum, remove them. */
621 /* FIXME: cagney/2003-10-15: I think this should be popping all
622 targets to CUR, and not just those at this stratum level. */
623 while ((*cur) != NULL && t->to_stratum == (*cur)->to_stratum)
625 /* There's already something at this stratum level. Close it,
626 and un-hook it from the stack. */
627 struct target_ops *tmp = (*cur);
629 (*cur) = (*cur)->beneath;
634 /* We have removed all targets in our stratum, now add the new one. */
638 update_current_target ();
641 /* Remove a target_ops vector from the stack, wherever it may be.
642 Return how many times it was removed (0 or 1). */
645 unpush_target (struct target_ops *t)
647 struct target_ops **cur;
648 struct target_ops *tmp;
650 if (t->to_stratum == dummy_stratum)
651 internal_error (__FILE__, __LINE__,
652 _("Attempt to unpush the dummy target"));
654 /* Look for the specified target. Note that we assume that a target
655 can only occur once in the target stack. */
657 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
663 /* If we don't find target_ops, quit. Only open targets should be
668 /* Unchain the target. */
670 (*cur) = (*cur)->beneath;
673 update_current_target ();
675 /* Finally close the target. Note we do this after unchaining, so
676 any target method calls from within the target_close
677 implementation don't end up in T anymore. */
684 pop_all_targets_above (enum strata above_stratum)
686 while ((int) (current_target.to_stratum) > (int) above_stratum)
688 if (!unpush_target (target_stack))
690 fprintf_unfiltered (gdb_stderr,
691 "pop_all_targets couldn't find target %s\n",
692 target_stack->to_shortname);
693 internal_error (__FILE__, __LINE__,
694 _("failed internal consistency check"));
701 pop_all_targets (void)
703 pop_all_targets_above (dummy_stratum);
706 /* Return 1 if T is now pushed in the target stack. Return 0 otherwise. */
709 target_is_pushed (struct target_ops *t)
711 struct target_ops **cur;
713 /* Check magic number. If wrong, it probably means someone changed
714 the struct definition, but not all the places that initialize one. */
715 if (t->to_magic != OPS_MAGIC)
717 fprintf_unfiltered (gdb_stderr,
718 "Magic number of %s target struct wrong\n",
720 internal_error (__FILE__, __LINE__,
721 _("failed internal consistency check"));
724 for (cur = &target_stack; (*cur) != NULL; cur = &(*cur)->beneath)
731 /* Using the objfile specified in OBJFILE, find the address for the
732 current thread's thread-local storage with offset OFFSET. */
734 target_translate_tls_address (struct objfile *objfile, CORE_ADDR offset)
736 volatile CORE_ADDR addr = 0;
737 struct target_ops *target;
739 for (target = current_target.beneath;
741 target = target->beneath)
743 if (target->to_get_thread_local_address != NULL)
748 && gdbarch_fetch_tls_load_module_address_p (target_gdbarch ()))
750 ptid_t ptid = inferior_ptid;
751 volatile struct gdb_exception ex;
753 TRY_CATCH (ex, RETURN_MASK_ALL)
757 /* Fetch the load module address for this objfile. */
758 lm_addr = gdbarch_fetch_tls_load_module_address (target_gdbarch (),
760 /* If it's 0, throw the appropriate exception. */
762 throw_error (TLS_LOAD_MODULE_NOT_FOUND_ERROR,
763 _("TLS load module not found"));
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 (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 set_executing (ptid, 1);
2157 set_running (ptid, 1);
2158 clear_inline_frame_state (ptid);
2162 target_pass_signals (int numsigs, unsigned char *pass_signals)
2168 fprintf_unfiltered (gdb_stdlog, "target_pass_signals (%d, {",
2171 for (i = 0; i < numsigs; i++)
2172 if (pass_signals[i])
2173 fprintf_unfiltered (gdb_stdlog, " %s",
2174 gdb_signal_to_name (i));
2176 fprintf_unfiltered (gdb_stdlog, " })\n");
2179 (*current_target.to_pass_signals) (¤t_target, numsigs, pass_signals);
2183 target_program_signals (int numsigs, unsigned char *program_signals)
2189 fprintf_unfiltered (gdb_stdlog, "target_program_signals (%d, {",
2192 for (i = 0; i < numsigs; i++)
2193 if (program_signals[i])
2194 fprintf_unfiltered (gdb_stdlog, " %s",
2195 gdb_signal_to_name (i));
2197 fprintf_unfiltered (gdb_stdlog, " })\n");
2200 (*current_target.to_program_signals) (¤t_target,
2201 numsigs, program_signals);
2205 default_follow_fork (struct target_ops *self, int follow_child,
2208 /* Some target returned a fork event, but did not know how to follow it. */
2209 internal_error (__FILE__, __LINE__,
2210 _("could not find a target to follow fork"));
2213 /* Look through the list of possible targets for a target that can
2217 target_follow_fork (int follow_child, int detach_fork)
2219 int retval = current_target.to_follow_fork (¤t_target,
2220 follow_child, detach_fork);
2223 fprintf_unfiltered (gdb_stdlog,
2224 "target_follow_fork (%d, %d) = %d\n",
2225 follow_child, detach_fork, retval);
2230 default_mourn_inferior (struct target_ops *self)
2232 internal_error (__FILE__, __LINE__,
2233 _("could not find a target to follow mourn inferior"));
2237 target_mourn_inferior (void)
2239 current_target.to_mourn_inferior (¤t_target);
2241 fprintf_unfiltered (gdb_stdlog, "target_mourn_inferior ()\n");
2243 /* We no longer need to keep handles on any of the object files.
2244 Make sure to release them to avoid unnecessarily locking any
2245 of them while we're not actually debugging. */
2246 bfd_cache_close_all ();
2249 /* Look for a target which can describe architectural features, starting
2250 from TARGET. If we find one, return its description. */
2252 const struct target_desc *
2253 target_read_description (struct target_ops *target)
2255 return target->to_read_description (target);
2258 /* This implements a basic search of memory, reading target memory and
2259 performing the search here (as opposed to performing the search in on the
2260 target side with, for example, gdbserver). */
2263 simple_search_memory (struct target_ops *ops,
2264 CORE_ADDR start_addr, ULONGEST search_space_len,
2265 const gdb_byte *pattern, ULONGEST pattern_len,
2266 CORE_ADDR *found_addrp)
2268 /* NOTE: also defined in find.c testcase. */
2269 #define SEARCH_CHUNK_SIZE 16000
2270 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
2271 /* Buffer to hold memory contents for searching. */
2272 gdb_byte *search_buf;
2273 unsigned search_buf_size;
2274 struct cleanup *old_cleanups;
2276 search_buf_size = chunk_size + pattern_len - 1;
2278 /* No point in trying to allocate a buffer larger than the search space. */
2279 if (search_space_len < search_buf_size)
2280 search_buf_size = search_space_len;
2282 search_buf = malloc (search_buf_size);
2283 if (search_buf == NULL)
2284 error (_("Unable to allocate memory to perform the search."));
2285 old_cleanups = make_cleanup (free_current_contents, &search_buf);
2287 /* Prime the search buffer. */
2289 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2290 search_buf, start_addr, search_buf_size) != search_buf_size)
2292 warning (_("Unable to access %s bytes of target "
2293 "memory at %s, halting search."),
2294 pulongest (search_buf_size), hex_string (start_addr));
2295 do_cleanups (old_cleanups);
2299 /* Perform the search.
2301 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
2302 When we've scanned N bytes we copy the trailing bytes to the start and
2303 read in another N bytes. */
2305 while (search_space_len >= pattern_len)
2307 gdb_byte *found_ptr;
2308 unsigned nr_search_bytes = min (search_space_len, search_buf_size);
2310 found_ptr = memmem (search_buf, nr_search_bytes,
2311 pattern, pattern_len);
2313 if (found_ptr != NULL)
2315 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
2317 *found_addrp = found_addr;
2318 do_cleanups (old_cleanups);
2322 /* Not found in this chunk, skip to next chunk. */
2324 /* Don't let search_space_len wrap here, it's unsigned. */
2325 if (search_space_len >= chunk_size)
2326 search_space_len -= chunk_size;
2328 search_space_len = 0;
2330 if (search_space_len >= pattern_len)
2332 unsigned keep_len = search_buf_size - chunk_size;
2333 CORE_ADDR read_addr = start_addr + chunk_size + keep_len;
2336 /* Copy the trailing part of the previous iteration to the front
2337 of the buffer for the next iteration. */
2338 gdb_assert (keep_len == pattern_len - 1);
2339 memcpy (search_buf, search_buf + chunk_size, keep_len);
2341 nr_to_read = min (search_space_len - keep_len, chunk_size);
2343 if (target_read (ops, TARGET_OBJECT_MEMORY, NULL,
2344 search_buf + keep_len, read_addr,
2345 nr_to_read) != nr_to_read)
2347 warning (_("Unable to access %s bytes of target "
2348 "memory at %s, halting search."),
2349 plongest (nr_to_read),
2350 hex_string (read_addr));
2351 do_cleanups (old_cleanups);
2355 start_addr += chunk_size;
2361 do_cleanups (old_cleanups);
2365 /* Default implementation of memory-searching. */
2368 default_search_memory (struct target_ops *self,
2369 CORE_ADDR start_addr, ULONGEST search_space_len,
2370 const gdb_byte *pattern, ULONGEST pattern_len,
2371 CORE_ADDR *found_addrp)
2373 /* Start over from the top of the target stack. */
2374 return simple_search_memory (current_target.beneath,
2375 start_addr, search_space_len,
2376 pattern, pattern_len, found_addrp);
2379 /* Search SEARCH_SPACE_LEN bytes beginning at START_ADDR for the
2380 sequence of bytes in PATTERN with length PATTERN_LEN.
2382 The result is 1 if found, 0 if not found, and -1 if there was an error
2383 requiring halting of the search (e.g. memory read error).
2384 If the pattern is found the address is recorded in FOUND_ADDRP. */
2387 target_search_memory (CORE_ADDR start_addr, ULONGEST search_space_len,
2388 const gdb_byte *pattern, ULONGEST pattern_len,
2389 CORE_ADDR *found_addrp)
2394 fprintf_unfiltered (gdb_stdlog, "target_search_memory (%s, ...)\n",
2395 hex_string (start_addr));
2397 found = current_target.to_search_memory (¤t_target, start_addr,
2399 pattern, pattern_len, found_addrp);
2402 fprintf_unfiltered (gdb_stdlog, " = %d\n", found);
2407 /* Look through the currently pushed targets. If none of them will
2408 be able to restart the currently running process, issue an error
2412 target_require_runnable (void)
2414 struct target_ops *t;
2416 for (t = target_stack; t != NULL; t = t->beneath)
2418 /* If this target knows how to create a new program, then
2419 assume we will still be able to after killing the current
2420 one. Either killing and mourning will not pop T, or else
2421 find_default_run_target will find it again. */
2422 if (t->to_create_inferior != NULL)
2425 /* Do not worry about thread_stratum targets that can not
2426 create inferiors. Assume they will be pushed again if
2427 necessary, and continue to the process_stratum. */
2428 if (t->to_stratum == thread_stratum
2429 || t->to_stratum == arch_stratum)
2432 error (_("The \"%s\" target does not support \"run\". "
2433 "Try \"help target\" or \"continue\"."),
2437 /* This function is only called if the target is running. In that
2438 case there should have been a process_stratum target and it
2439 should either know how to create inferiors, or not... */
2440 internal_error (__FILE__, __LINE__, _("No targets found"));
2443 /* Look through the list of possible targets for a target that can
2444 execute a run or attach command without any other data. This is
2445 used to locate the default process stratum.
2447 If DO_MESG is not NULL, the result is always valid (error() is
2448 called for errors); else, return NULL on error. */
2450 static struct target_ops *
2451 find_default_run_target (char *do_mesg)
2453 struct target_ops **t;
2454 struct target_ops *runable = NULL;
2459 for (t = target_structs; t < target_structs + target_struct_size;
2462 if ((*t)->to_can_run != delegate_can_run && target_can_run (*t))
2472 error (_("Don't know how to %s. Try \"help target\"."), do_mesg);
2483 find_attach_target (void)
2485 struct target_ops *t;
2487 /* If a target on the current stack can attach, use it. */
2488 for (t = current_target.beneath; t != NULL; t = t->beneath)
2490 if (t->to_attach != NULL)
2494 /* Otherwise, use the default run target for attaching. */
2496 t = find_default_run_target ("attach");
2504 find_run_target (void)
2506 struct target_ops *t;
2508 /* If a target on the current stack can attach, use it. */
2509 for (t = current_target.beneath; t != NULL; t = t->beneath)
2511 if (t->to_create_inferior != NULL)
2515 /* Otherwise, use the default run target. */
2517 t = find_default_run_target ("run");
2522 /* Implement the "info proc" command. */
2525 target_info_proc (char *args, enum info_proc_what what)
2527 struct target_ops *t;
2529 /* If we're already connected to something that can get us OS
2530 related data, use it. Otherwise, try using the native
2532 if (current_target.to_stratum >= process_stratum)
2533 t = current_target.beneath;
2535 t = find_default_run_target (NULL);
2537 for (; t != NULL; t = t->beneath)
2539 if (t->to_info_proc != NULL)
2541 t->to_info_proc (t, args, what);
2544 fprintf_unfiltered (gdb_stdlog,
2545 "target_info_proc (\"%s\", %d)\n", args, what);
2555 find_default_supports_disable_randomization (struct target_ops *self)
2557 struct target_ops *t;
2559 t = find_default_run_target (NULL);
2560 if (t && t->to_supports_disable_randomization)
2561 return (t->to_supports_disable_randomization) (t);
2566 target_supports_disable_randomization (void)
2568 struct target_ops *t;
2570 for (t = ¤t_target; t != NULL; t = t->beneath)
2571 if (t->to_supports_disable_randomization)
2572 return t->to_supports_disable_randomization (t);
2578 target_get_osdata (const char *type)
2580 struct target_ops *t;
2582 /* If we're already connected to something that can get us OS
2583 related data, use it. Otherwise, try using the native
2585 if (current_target.to_stratum >= process_stratum)
2586 t = current_target.beneath;
2588 t = find_default_run_target ("get OS data");
2593 return target_read_stralloc (t, TARGET_OBJECT_OSDATA, type);
2596 /* Determine the current address space of thread PTID. */
2598 struct address_space *
2599 target_thread_address_space (ptid_t ptid)
2601 struct address_space *aspace;
2602 struct inferior *inf;
2603 struct target_ops *t;
2605 for (t = current_target.beneath; t != NULL; t = t->beneath)
2607 if (t->to_thread_address_space != NULL)
2609 aspace = t->to_thread_address_space (t, ptid);
2610 gdb_assert (aspace);
2613 fprintf_unfiltered (gdb_stdlog,
2614 "target_thread_address_space (%s) = %d\n",
2615 target_pid_to_str (ptid),
2616 address_space_num (aspace));
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));
2634 /* Target file operations. */
2636 static struct target_ops *
2637 default_fileio_target (void)
2639 /* If we're already connected to something that can perform
2640 file I/O, use it. Otherwise, try using the native target. */
2641 if (current_target.to_stratum >= process_stratum)
2642 return current_target.beneath;
2644 return find_default_run_target ("file I/O");
2647 /* Open FILENAME on the target, using FLAGS and MODE. Return a
2648 target file descriptor, or -1 if an error occurs (and set
2651 target_fileio_open (const char *filename, int flags, int mode,
2654 struct target_ops *t;
2656 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2658 if (t->to_fileio_open != NULL)
2660 int fd = t->to_fileio_open (t, filename, flags, mode, target_errno);
2663 fprintf_unfiltered (gdb_stdlog,
2664 "target_fileio_open (%s,0x%x,0%o) = %d (%d)\n",
2665 filename, flags, mode,
2666 fd, fd != -1 ? 0 : *target_errno);
2671 *target_errno = FILEIO_ENOSYS;
2675 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
2676 Return the number of bytes written, or -1 if an error occurs
2677 (and set *TARGET_ERRNO). */
2679 target_fileio_pwrite (int fd, const gdb_byte *write_buf, int len,
2680 ULONGEST offset, int *target_errno)
2682 struct target_ops *t;
2684 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2686 if (t->to_fileio_pwrite != NULL)
2688 int ret = t->to_fileio_pwrite (t, fd, write_buf, len, offset,
2692 fprintf_unfiltered (gdb_stdlog,
2693 "target_fileio_pwrite (%d,...,%d,%s) "
2695 fd, len, pulongest (offset),
2696 ret, ret != -1 ? 0 : *target_errno);
2701 *target_errno = FILEIO_ENOSYS;
2705 /* Read up to LEN bytes FD on the target into READ_BUF.
2706 Return the number of bytes read, or -1 if an error occurs
2707 (and set *TARGET_ERRNO). */
2709 target_fileio_pread (int fd, gdb_byte *read_buf, int len,
2710 ULONGEST offset, int *target_errno)
2712 struct target_ops *t;
2714 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2716 if (t->to_fileio_pread != NULL)
2718 int ret = t->to_fileio_pread (t, fd, read_buf, len, offset,
2722 fprintf_unfiltered (gdb_stdlog,
2723 "target_fileio_pread (%d,...,%d,%s) "
2725 fd, len, pulongest (offset),
2726 ret, ret != -1 ? 0 : *target_errno);
2731 *target_errno = FILEIO_ENOSYS;
2735 /* Close FD on the target. Return 0, or -1 if an error occurs
2736 (and set *TARGET_ERRNO). */
2738 target_fileio_close (int fd, int *target_errno)
2740 struct target_ops *t;
2742 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2744 if (t->to_fileio_close != NULL)
2746 int ret = t->to_fileio_close (t, fd, target_errno);
2749 fprintf_unfiltered (gdb_stdlog,
2750 "target_fileio_close (%d) = %d (%d)\n",
2751 fd, ret, ret != -1 ? 0 : *target_errno);
2756 *target_errno = FILEIO_ENOSYS;
2760 /* Unlink FILENAME on the target. Return 0, or -1 if an error
2761 occurs (and set *TARGET_ERRNO). */
2763 target_fileio_unlink (const char *filename, int *target_errno)
2765 struct target_ops *t;
2767 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2769 if (t->to_fileio_unlink != NULL)
2771 int ret = t->to_fileio_unlink (t, filename, target_errno);
2774 fprintf_unfiltered (gdb_stdlog,
2775 "target_fileio_unlink (%s) = %d (%d)\n",
2776 filename, ret, ret != -1 ? 0 : *target_errno);
2781 *target_errno = FILEIO_ENOSYS;
2785 /* Read value of symbolic link FILENAME on the target. Return a
2786 null-terminated string allocated via xmalloc, or NULL if an error
2787 occurs (and set *TARGET_ERRNO). */
2789 target_fileio_readlink (const char *filename, int *target_errno)
2791 struct target_ops *t;
2793 for (t = default_fileio_target (); t != NULL; t = t->beneath)
2795 if (t->to_fileio_readlink != NULL)
2797 char *ret = t->to_fileio_readlink (t, filename, target_errno);
2800 fprintf_unfiltered (gdb_stdlog,
2801 "target_fileio_readlink (%s) = %s (%d)\n",
2802 filename, ret? ret : "(nil)",
2803 ret? 0 : *target_errno);
2808 *target_errno = FILEIO_ENOSYS;
2813 target_fileio_close_cleanup (void *opaque)
2815 int fd = *(int *) opaque;
2818 target_fileio_close (fd, &target_errno);
2821 /* Read target file FILENAME. Store the result in *BUF_P and
2822 return the size of the transferred data. PADDING additional bytes are
2823 available in *BUF_P. This is a helper function for
2824 target_fileio_read_alloc; see the declaration of that function for more
2828 target_fileio_read_alloc_1 (const char *filename,
2829 gdb_byte **buf_p, int padding)
2831 struct cleanup *close_cleanup;
2832 size_t buf_alloc, buf_pos;
2838 fd = target_fileio_open (filename, FILEIO_O_RDONLY, 0700, &target_errno);
2842 close_cleanup = make_cleanup (target_fileio_close_cleanup, &fd);
2844 /* Start by reading up to 4K at a time. The target will throttle
2845 this number down if necessary. */
2847 buf = xmalloc (buf_alloc);
2851 n = target_fileio_pread (fd, &buf[buf_pos],
2852 buf_alloc - buf_pos - padding, buf_pos,
2856 /* An error occurred. */
2857 do_cleanups (close_cleanup);
2863 /* Read all there was. */
2864 do_cleanups (close_cleanup);
2874 /* If the buffer is filling up, expand it. */
2875 if (buf_alloc < buf_pos * 2)
2878 buf = xrealloc (buf, buf_alloc);
2885 /* Read target file FILENAME. Store the result in *BUF_P and return
2886 the size of the transferred data. See the declaration in "target.h"
2887 function for more information about the return value. */
2890 target_fileio_read_alloc (const char *filename, gdb_byte **buf_p)
2892 return target_fileio_read_alloc_1 (filename, buf_p, 0);
2895 /* Read target file FILENAME. The result is NUL-terminated and
2896 returned as a string, allocated using xmalloc. If an error occurs
2897 or the transfer is unsupported, NULL is returned. Empty objects
2898 are returned as allocated but empty strings. A warning is issued
2899 if the result contains any embedded NUL bytes. */
2902 target_fileio_read_stralloc (const char *filename)
2906 LONGEST i, transferred;
2908 transferred = target_fileio_read_alloc_1 (filename, &buffer, 1);
2909 bufstr = (char *) buffer;
2911 if (transferred < 0)
2914 if (transferred == 0)
2915 return xstrdup ("");
2917 bufstr[transferred] = 0;
2919 /* Check for embedded NUL bytes; but allow trailing NULs. */
2920 for (i = strlen (bufstr); i < transferred; i++)
2923 warning (_("target file %s "
2924 "contained unexpected null characters"),
2934 default_region_ok_for_hw_watchpoint (struct target_ops *self,
2935 CORE_ADDR addr, int len)
2937 return (len <= gdbarch_ptr_bit (target_gdbarch ()) / TARGET_CHAR_BIT);
2941 default_watchpoint_addr_within_range (struct target_ops *target,
2943 CORE_ADDR start, int length)
2945 return addr >= start && addr < start + length;
2948 static struct gdbarch *
2949 default_thread_architecture (struct target_ops *ops, ptid_t ptid)
2951 return target_gdbarch ();
2955 return_zero (struct target_ops *ignore)
2961 return_zero_has_execution (struct target_ops *ignore, ptid_t ignore2)
2967 * Find the next target down the stack from the specified target.
2971 find_target_beneath (struct target_ops *t)
2979 find_target_at (enum strata stratum)
2981 struct target_ops *t;
2983 for (t = current_target.beneath; t != NULL; t = t->beneath)
2984 if (t->to_stratum == stratum)
2991 /* The inferior process has died. Long live the inferior! */
2994 generic_mourn_inferior (void)
2998 ptid = inferior_ptid;
2999 inferior_ptid = null_ptid;
3001 /* Mark breakpoints uninserted in case something tries to delete a
3002 breakpoint while we delete the inferior's threads (which would
3003 fail, since the inferior is long gone). */
3004 mark_breakpoints_out ();
3006 if (!ptid_equal (ptid, null_ptid))
3008 int pid = ptid_get_pid (ptid);
3009 exit_inferior (pid);
3012 /* Note this wipes step-resume breakpoints, so needs to be done
3013 after exit_inferior, which ends up referencing the step-resume
3014 breakpoints through clear_thread_inferior_resources. */
3015 breakpoint_init_inferior (inf_exited);
3017 registers_changed ();
3019 reopen_exec_file ();
3020 reinit_frame_cache ();
3022 if (deprecated_detach_hook)
3023 deprecated_detach_hook ();
3026 /* Convert a normal process ID to a string. Returns the string in a
3030 normal_pid_to_str (ptid_t ptid)
3032 static char buf[32];
3034 xsnprintf (buf, sizeof buf, "process %d", ptid_get_pid (ptid));
3039 default_pid_to_str (struct target_ops *ops, ptid_t ptid)
3041 return normal_pid_to_str (ptid);
3044 /* Error-catcher for target_find_memory_regions. */
3046 dummy_find_memory_regions (struct target_ops *self,
3047 find_memory_region_ftype ignore1, void *ignore2)
3049 error (_("Command not implemented for this target."));
3053 /* Error-catcher for target_make_corefile_notes. */
3055 dummy_make_corefile_notes (struct target_ops *self,
3056 bfd *ignore1, int *ignore2)
3058 error (_("Command not implemented for this target."));
3062 /* Set up the handful of non-empty slots needed by the dummy target
3066 init_dummy_target (void)
3068 dummy_target.to_shortname = "None";
3069 dummy_target.to_longname = "None";
3070 dummy_target.to_doc = "";
3071 dummy_target.to_supports_disable_randomization
3072 = find_default_supports_disable_randomization;
3073 dummy_target.to_stratum = dummy_stratum;
3074 dummy_target.to_has_all_memory = return_zero;
3075 dummy_target.to_has_memory = return_zero;
3076 dummy_target.to_has_stack = return_zero;
3077 dummy_target.to_has_registers = return_zero;
3078 dummy_target.to_has_execution = return_zero_has_execution;
3079 dummy_target.to_magic = OPS_MAGIC;
3081 install_dummy_methods (&dummy_target);
3085 debug_to_open (char *args, int from_tty)
3087 debug_target.to_open (args, from_tty);
3089 fprintf_unfiltered (gdb_stdlog, "target_open (%s, %d)\n", args, from_tty);
3093 target_close (struct target_ops *targ)
3095 gdb_assert (!target_is_pushed (targ));
3097 if (targ->to_xclose != NULL)
3098 targ->to_xclose (targ);
3099 else if (targ->to_close != NULL)
3100 targ->to_close (targ);
3103 fprintf_unfiltered (gdb_stdlog, "target_close ()\n");
3107 target_thread_alive (ptid_t ptid)
3111 retval = current_target.to_thread_alive (¤t_target, ptid);
3113 fprintf_unfiltered (gdb_stdlog, "target_thread_alive (%d) = %d\n",
3114 ptid_get_pid (ptid), retval);
3120 target_find_new_threads (void)
3122 current_target.to_find_new_threads (¤t_target);
3124 fprintf_unfiltered (gdb_stdlog, "target_find_new_threads ()\n");
3128 target_stop (ptid_t ptid)
3132 warning (_("May not interrupt or stop the target, ignoring attempt"));
3136 (*current_target.to_stop) (¤t_target, ptid);
3140 debug_to_post_attach (struct target_ops *self, int pid)
3142 debug_target.to_post_attach (&debug_target, pid);
3144 fprintf_unfiltered (gdb_stdlog, "target_post_attach (%d)\n", pid);
3147 /* Concatenate ELEM to LIST, a comma separate list, and return the
3148 result. The LIST incoming argument is released. */
3151 str_comma_list_concat_elem (char *list, const char *elem)
3154 return xstrdup (elem);
3156 return reconcat (list, list, ", ", elem, (char *) NULL);
3159 /* Helper for target_options_to_string. If OPT is present in
3160 TARGET_OPTIONS, append the OPT_STR (string version of OPT) in RET.
3161 Returns the new resulting string. OPT is removed from
3165 do_option (int *target_options, char *ret,
3166 int opt, char *opt_str)
3168 if ((*target_options & opt) != 0)
3170 ret = str_comma_list_concat_elem (ret, opt_str);
3171 *target_options &= ~opt;
3178 target_options_to_string (int target_options)
3182 #define DO_TARG_OPTION(OPT) \
3183 ret = do_option (&target_options, ret, OPT, #OPT)
3185 DO_TARG_OPTION (TARGET_WNOHANG);
3187 if (target_options != 0)
3188 ret = str_comma_list_concat_elem (ret, "unknown???");
3196 debug_print_register (const char * func,
3197 struct regcache *regcache, int regno)
3199 struct gdbarch *gdbarch = get_regcache_arch (regcache);
3201 fprintf_unfiltered (gdb_stdlog, "%s ", func);
3202 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch)
3203 && gdbarch_register_name (gdbarch, regno) != NULL
3204 && gdbarch_register_name (gdbarch, regno)[0] != '\0')
3205 fprintf_unfiltered (gdb_stdlog, "(%s)",
3206 gdbarch_register_name (gdbarch, regno));
3208 fprintf_unfiltered (gdb_stdlog, "(%d)", regno);
3209 if (regno >= 0 && regno < gdbarch_num_regs (gdbarch))
3211 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
3212 int i, size = register_size (gdbarch, regno);
3213 gdb_byte buf[MAX_REGISTER_SIZE];
3215 regcache_raw_collect (regcache, regno, buf);
3216 fprintf_unfiltered (gdb_stdlog, " = ");
3217 for (i = 0; i < size; i++)
3219 fprintf_unfiltered (gdb_stdlog, "%02x", buf[i]);
3221 if (size <= sizeof (LONGEST))
3223 ULONGEST val = extract_unsigned_integer (buf, size, byte_order);
3225 fprintf_unfiltered (gdb_stdlog, " %s %s",
3226 core_addr_to_string_nz (val), plongest (val));
3229 fprintf_unfiltered (gdb_stdlog, "\n");
3233 target_fetch_registers (struct regcache *regcache, int regno)
3235 current_target.to_fetch_registers (¤t_target, regcache, regno);
3237 debug_print_register ("target_fetch_registers", regcache, regno);
3241 target_store_registers (struct regcache *regcache, int regno)
3243 struct target_ops *t;
3245 if (!may_write_registers)
3246 error (_("Writing to registers is not allowed (regno %d)"), regno);
3248 current_target.to_store_registers (¤t_target, regcache, regno);
3251 debug_print_register ("target_store_registers", regcache, regno);
3256 target_core_of_thread (ptid_t ptid)
3258 int retval = current_target.to_core_of_thread (¤t_target, ptid);
3261 fprintf_unfiltered (gdb_stdlog,
3262 "target_core_of_thread (%d) = %d\n",
3263 ptid_get_pid (ptid), retval);
3268 simple_verify_memory (struct target_ops *ops,
3269 const gdb_byte *data, CORE_ADDR lma, ULONGEST size)
3271 LONGEST total_xfered = 0;
3273 while (total_xfered < size)
3275 ULONGEST xfered_len;
3276 enum target_xfer_status status;
3278 ULONGEST howmuch = min (sizeof (buf), size - total_xfered);
3280 status = target_xfer_partial (ops, TARGET_OBJECT_MEMORY, NULL,
3281 buf, NULL, lma + total_xfered, howmuch,
3283 if (status == TARGET_XFER_OK
3284 && memcmp (data + total_xfered, buf, xfered_len) == 0)
3286 total_xfered += xfered_len;
3295 /* Default implementation of memory verification. */
3298 default_verify_memory (struct target_ops *self,
3299 const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
3301 /* Start over from the top of the target stack. */
3302 return simple_verify_memory (current_target.beneath,
3303 data, memaddr, size);
3307 target_verify_memory (const gdb_byte *data, CORE_ADDR memaddr, ULONGEST size)
3309 int retval = current_target.to_verify_memory (¤t_target,
3310 data, memaddr, size);
3313 fprintf_unfiltered (gdb_stdlog,
3314 "target_verify_memory (%s, %s) = %d\n",
3315 paddress (target_gdbarch (), memaddr),
3321 /* The documentation for this function is in its prototype declaration in
3325 target_insert_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
3329 ret = current_target.to_insert_mask_watchpoint (¤t_target,
3333 fprintf_unfiltered (gdb_stdlog, "\
3334 target_insert_mask_watchpoint (%s, %s, %d) = %d\n",
3335 core_addr_to_string (addr),
3336 core_addr_to_string (mask), rw, ret);
3341 /* The documentation for this function is in its prototype declaration in
3345 target_remove_mask_watchpoint (CORE_ADDR addr, CORE_ADDR mask, int rw)
3349 ret = current_target.to_remove_mask_watchpoint (¤t_target,
3353 fprintf_unfiltered (gdb_stdlog, "\
3354 target_remove_mask_watchpoint (%s, %s, %d) = %d\n",
3355 core_addr_to_string (addr),
3356 core_addr_to_string (mask), rw, ret);
3361 /* The documentation for this function is in its prototype declaration
3365 target_masked_watch_num_registers (CORE_ADDR addr, CORE_ADDR mask)
3367 return current_target.to_masked_watch_num_registers (¤t_target,
3371 /* The documentation for this function is in its prototype declaration
3375 target_ranged_break_num_registers (void)
3377 return current_target.to_ranged_break_num_registers (¤t_target);
3382 struct btrace_target_info *
3383 target_enable_btrace (ptid_t ptid)
3385 return current_target.to_enable_btrace (¤t_target, ptid);
3391 target_disable_btrace (struct btrace_target_info *btinfo)
3393 current_target.to_disable_btrace (¤t_target, btinfo);
3399 target_teardown_btrace (struct btrace_target_info *btinfo)
3401 current_target.to_teardown_btrace (¤t_target, btinfo);
3407 target_read_btrace (VEC (btrace_block_s) **btrace,
3408 struct btrace_target_info *btinfo,
3409 enum btrace_read_type type)
3411 return current_target.to_read_btrace (¤t_target, btrace, btinfo, type);
3417 target_stop_recording (void)
3419 current_target.to_stop_recording (¤t_target);
3425 target_info_record (void)
3427 struct target_ops *t;
3429 for (t = current_target.beneath; t != NULL; t = t->beneath)
3430 if (t->to_info_record != NULL)
3432 t->to_info_record (t);
3442 target_save_record (const char *filename)
3444 current_target.to_save_record (¤t_target, filename);
3450 target_supports_delete_record (void)
3452 struct target_ops *t;
3454 for (t = current_target.beneath; t != NULL; t = t->beneath)
3455 if (t->to_delete_record != NULL)
3464 target_delete_record (void)
3466 current_target.to_delete_record (¤t_target);
3472 target_record_is_replaying (void)
3474 return current_target.to_record_is_replaying (¤t_target);
3480 target_goto_record_begin (void)
3482 current_target.to_goto_record_begin (¤t_target);
3488 target_goto_record_end (void)
3490 current_target.to_goto_record_end (¤t_target);
3496 target_goto_record (ULONGEST insn)
3498 current_target.to_goto_record (¤t_target, insn);
3504 target_insn_history (int size, int flags)
3506 current_target.to_insn_history (¤t_target, size, flags);
3512 target_insn_history_from (ULONGEST from, int size, int flags)
3514 current_target.to_insn_history_from (¤t_target, from, size, flags);
3520 target_insn_history_range (ULONGEST begin, ULONGEST end, int flags)
3522 current_target.to_insn_history_range (¤t_target, begin, end, flags);
3528 target_call_history (int size, int flags)
3530 current_target.to_call_history (¤t_target, size, flags);
3536 target_call_history_from (ULONGEST begin, int size, int flags)
3538 current_target.to_call_history_from (¤t_target, begin, size, flags);
3544 target_call_history_range (ULONGEST begin, ULONGEST end, int flags)
3546 current_target.to_call_history_range (¤t_target, begin, end, flags);
3550 debug_to_prepare_to_store (struct target_ops *self, struct regcache *regcache)
3552 debug_target.to_prepare_to_store (&debug_target, regcache);
3554 fprintf_unfiltered (gdb_stdlog, "target_prepare_to_store ()\n");
3559 const struct frame_unwind *
3560 target_get_unwinder (void)
3562 return current_target.to_get_unwinder (¤t_target);
3567 const struct frame_unwind *
3568 target_get_tailcall_unwinder (void)
3570 return current_target.to_get_tailcall_unwinder (¤t_target);
3573 /* Default implementation of to_decr_pc_after_break. */
3576 default_target_decr_pc_after_break (struct target_ops *ops,
3577 struct gdbarch *gdbarch)
3579 return gdbarch_decr_pc_after_break (gdbarch);
3585 target_decr_pc_after_break (struct gdbarch *gdbarch)
3587 return current_target.to_decr_pc_after_break (¤t_target, gdbarch);
3591 debug_to_files_info (struct target_ops *target)
3593 debug_target.to_files_info (target);
3595 fprintf_unfiltered (gdb_stdlog, "target_files_info (xxx)\n");
3599 debug_to_insert_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
3600 struct bp_target_info *bp_tgt)
3604 retval = debug_target.to_insert_breakpoint (&debug_target, gdbarch, bp_tgt);
3606 fprintf_unfiltered (gdb_stdlog,
3607 "target_insert_breakpoint (%s, xxx) = %ld\n",
3608 core_addr_to_string (bp_tgt->placed_address),
3609 (unsigned long) retval);
3614 debug_to_remove_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
3615 struct bp_target_info *bp_tgt)
3619 retval = debug_target.to_remove_breakpoint (&debug_target, gdbarch, bp_tgt);
3621 fprintf_unfiltered (gdb_stdlog,
3622 "target_remove_breakpoint (%s, xxx) = %ld\n",
3623 core_addr_to_string (bp_tgt->placed_address),
3624 (unsigned long) retval);
3629 debug_to_can_use_hw_breakpoint (struct target_ops *self,
3630 int type, int cnt, int from_tty)
3634 retval = debug_target.to_can_use_hw_breakpoint (&debug_target,
3635 type, cnt, from_tty);
3637 fprintf_unfiltered (gdb_stdlog,
3638 "target_can_use_hw_breakpoint (%ld, %ld, %ld) = %ld\n",
3639 (unsigned long) type,
3640 (unsigned long) cnt,
3641 (unsigned long) from_tty,
3642 (unsigned long) retval);
3647 debug_to_region_ok_for_hw_watchpoint (struct target_ops *self,
3648 CORE_ADDR addr, int len)
3652 retval = debug_target.to_region_ok_for_hw_watchpoint (&debug_target,
3655 fprintf_unfiltered (gdb_stdlog,
3656 "target_region_ok_for_hw_watchpoint (%s, %ld) = %s\n",
3657 core_addr_to_string (addr), (unsigned long) len,
3658 core_addr_to_string (retval));
3663 debug_to_can_accel_watchpoint_condition (struct target_ops *self,
3664 CORE_ADDR addr, int len, int rw,
3665 struct expression *cond)
3669 retval = debug_target.to_can_accel_watchpoint_condition (&debug_target,
3673 fprintf_unfiltered (gdb_stdlog,
3674 "target_can_accel_watchpoint_condition "
3675 "(%s, %d, %d, %s) = %ld\n",
3676 core_addr_to_string (addr), len, rw,
3677 host_address_to_string (cond), (unsigned long) retval);
3682 debug_to_stopped_by_watchpoint (struct target_ops *ops)
3686 retval = debug_target.to_stopped_by_watchpoint (&debug_target);
3688 fprintf_unfiltered (gdb_stdlog,
3689 "target_stopped_by_watchpoint () = %ld\n",
3690 (unsigned long) retval);
3695 debug_to_stopped_data_address (struct target_ops *target, CORE_ADDR *addr)
3699 retval = debug_target.to_stopped_data_address (target, addr);
3701 fprintf_unfiltered (gdb_stdlog,
3702 "target_stopped_data_address ([%s]) = %ld\n",
3703 core_addr_to_string (*addr),
3704 (unsigned long)retval);
3709 debug_to_watchpoint_addr_within_range (struct target_ops *target,
3711 CORE_ADDR start, int length)
3715 retval = debug_target.to_watchpoint_addr_within_range (target, addr,
3718 fprintf_filtered (gdb_stdlog,
3719 "target_watchpoint_addr_within_range (%s, %s, %d) = %d\n",
3720 core_addr_to_string (addr), core_addr_to_string (start),
3726 debug_to_insert_hw_breakpoint (struct target_ops *self,
3727 struct gdbarch *gdbarch,
3728 struct bp_target_info *bp_tgt)
3732 retval = debug_target.to_insert_hw_breakpoint (&debug_target,
3735 fprintf_unfiltered (gdb_stdlog,
3736 "target_insert_hw_breakpoint (%s, xxx) = %ld\n",
3737 core_addr_to_string (bp_tgt->placed_address),
3738 (unsigned long) retval);
3743 debug_to_remove_hw_breakpoint (struct target_ops *self,
3744 struct gdbarch *gdbarch,
3745 struct bp_target_info *bp_tgt)
3749 retval = debug_target.to_remove_hw_breakpoint (&debug_target,
3752 fprintf_unfiltered (gdb_stdlog,
3753 "target_remove_hw_breakpoint (%s, xxx) = %ld\n",
3754 core_addr_to_string (bp_tgt->placed_address),
3755 (unsigned long) retval);
3760 debug_to_insert_watchpoint (struct target_ops *self,
3761 CORE_ADDR addr, int len, int type,
3762 struct expression *cond)
3766 retval = debug_target.to_insert_watchpoint (&debug_target,
3767 addr, len, type, cond);
3769 fprintf_unfiltered (gdb_stdlog,
3770 "target_insert_watchpoint (%s, %d, %d, %s) = %ld\n",
3771 core_addr_to_string (addr), len, type,
3772 host_address_to_string (cond), (unsigned long) retval);
3777 debug_to_remove_watchpoint (struct target_ops *self,
3778 CORE_ADDR addr, int len, int type,
3779 struct expression *cond)
3783 retval = debug_target.to_remove_watchpoint (&debug_target,
3784 addr, len, type, cond);
3786 fprintf_unfiltered (gdb_stdlog,
3787 "target_remove_watchpoint (%s, %d, %d, %s) = %ld\n",
3788 core_addr_to_string (addr), len, type,
3789 host_address_to_string (cond), (unsigned long) retval);
3794 debug_to_terminal_init (struct target_ops *self)
3796 debug_target.to_terminal_init (&debug_target);
3798 fprintf_unfiltered (gdb_stdlog, "target_terminal_init ()\n");
3802 debug_to_terminal_inferior (struct target_ops *self)
3804 debug_target.to_terminal_inferior (&debug_target);
3806 fprintf_unfiltered (gdb_stdlog, "target_terminal_inferior ()\n");
3810 debug_to_terminal_ours_for_output (struct target_ops *self)
3812 debug_target.to_terminal_ours_for_output (&debug_target);
3814 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours_for_output ()\n");
3818 debug_to_terminal_ours (struct target_ops *self)
3820 debug_target.to_terminal_ours (&debug_target);
3822 fprintf_unfiltered (gdb_stdlog, "target_terminal_ours ()\n");
3826 debug_to_terminal_save_ours (struct target_ops *self)
3828 debug_target.to_terminal_save_ours (&debug_target);
3830 fprintf_unfiltered (gdb_stdlog, "target_terminal_save_ours ()\n");
3834 debug_to_terminal_info (struct target_ops *self,
3835 const char *arg, int from_tty)
3837 debug_target.to_terminal_info (&debug_target, arg, from_tty);
3839 fprintf_unfiltered (gdb_stdlog, "target_terminal_info (%s, %d)\n", arg,
3844 debug_to_load (struct target_ops *self, char *args, int from_tty)
3846 debug_target.to_load (&debug_target, args, from_tty);
3848 fprintf_unfiltered (gdb_stdlog, "target_load (%s, %d)\n", args, from_tty);
3852 debug_to_post_startup_inferior (struct target_ops *self, ptid_t ptid)
3854 debug_target.to_post_startup_inferior (&debug_target, ptid);
3856 fprintf_unfiltered (gdb_stdlog, "target_post_startup_inferior (%d)\n",
3857 ptid_get_pid (ptid));
3861 debug_to_insert_fork_catchpoint (struct target_ops *self, int pid)
3865 retval = debug_target.to_insert_fork_catchpoint (&debug_target, pid);
3867 fprintf_unfiltered (gdb_stdlog, "target_insert_fork_catchpoint (%d) = %d\n",
3874 debug_to_remove_fork_catchpoint (struct target_ops *self, int pid)
3878 retval = debug_target.to_remove_fork_catchpoint (&debug_target, pid);
3880 fprintf_unfiltered (gdb_stdlog, "target_remove_fork_catchpoint (%d) = %d\n",
3887 debug_to_insert_vfork_catchpoint (struct target_ops *self, int pid)
3891 retval = debug_target.to_insert_vfork_catchpoint (&debug_target, pid);
3893 fprintf_unfiltered (gdb_stdlog, "target_insert_vfork_catchpoint (%d) = %d\n",
3900 debug_to_remove_vfork_catchpoint (struct target_ops *self, int pid)
3904 retval = debug_target.to_remove_vfork_catchpoint (&debug_target, pid);
3906 fprintf_unfiltered (gdb_stdlog, "target_remove_vfork_catchpoint (%d) = %d\n",
3913 debug_to_insert_exec_catchpoint (struct target_ops *self, int pid)
3917 retval = debug_target.to_insert_exec_catchpoint (&debug_target, pid);
3919 fprintf_unfiltered (gdb_stdlog, "target_insert_exec_catchpoint (%d) = %d\n",
3926 debug_to_remove_exec_catchpoint (struct target_ops *self, int pid)
3930 retval = debug_target.to_remove_exec_catchpoint (&debug_target, pid);
3932 fprintf_unfiltered (gdb_stdlog, "target_remove_exec_catchpoint (%d) = %d\n",
3939 debug_to_has_exited (struct target_ops *self,
3940 int pid, int wait_status, int *exit_status)
3944 has_exited = debug_target.to_has_exited (&debug_target,
3945 pid, wait_status, exit_status);
3947 fprintf_unfiltered (gdb_stdlog, "target_has_exited (%d, %d, %d) = %d\n",
3948 pid, wait_status, *exit_status, has_exited);
3954 debug_to_can_run (struct target_ops *self)
3958 retval = debug_target.to_can_run (&debug_target);
3960 fprintf_unfiltered (gdb_stdlog, "target_can_run () = %d\n", retval);
3965 static struct gdbarch *
3966 debug_to_thread_architecture (struct target_ops *ops, ptid_t ptid)
3968 struct gdbarch *retval;
3970 retval = debug_target.to_thread_architecture (ops, ptid);
3972 fprintf_unfiltered (gdb_stdlog,
3973 "target_thread_architecture (%s) = %s [%s]\n",
3974 target_pid_to_str (ptid),
3975 host_address_to_string (retval),
3976 gdbarch_bfd_arch_info (retval)->printable_name);
3981 debug_to_stop (struct target_ops *self, ptid_t ptid)
3983 debug_target.to_stop (&debug_target, ptid);
3985 fprintf_unfiltered (gdb_stdlog, "target_stop (%s)\n",
3986 target_pid_to_str (ptid));
3990 debug_to_rcmd (struct target_ops *self, char *command,
3991 struct ui_file *outbuf)
3993 debug_target.to_rcmd (&debug_target, command, outbuf);
3994 fprintf_unfiltered (gdb_stdlog, "target_rcmd (%s, ...)\n", command);
3998 debug_to_pid_to_exec_file (struct target_ops *self, int pid)
4002 exec_file = debug_target.to_pid_to_exec_file (&debug_target, pid);
4004 fprintf_unfiltered (gdb_stdlog, "target_pid_to_exec_file (%d) = %s\n",
4011 setup_target_debug (void)
4013 memcpy (&debug_target, ¤t_target, sizeof debug_target);
4015 current_target.to_open = debug_to_open;
4016 current_target.to_post_attach = debug_to_post_attach;
4017 current_target.to_prepare_to_store = debug_to_prepare_to_store;
4018 current_target.to_files_info = debug_to_files_info;
4019 current_target.to_insert_breakpoint = debug_to_insert_breakpoint;
4020 current_target.to_remove_breakpoint = debug_to_remove_breakpoint;
4021 current_target.to_can_use_hw_breakpoint = debug_to_can_use_hw_breakpoint;
4022 current_target.to_insert_hw_breakpoint = debug_to_insert_hw_breakpoint;
4023 current_target.to_remove_hw_breakpoint = debug_to_remove_hw_breakpoint;
4024 current_target.to_insert_watchpoint = debug_to_insert_watchpoint;
4025 current_target.to_remove_watchpoint = debug_to_remove_watchpoint;
4026 current_target.to_stopped_by_watchpoint = debug_to_stopped_by_watchpoint;
4027 current_target.to_stopped_data_address = debug_to_stopped_data_address;
4028 current_target.to_watchpoint_addr_within_range
4029 = debug_to_watchpoint_addr_within_range;
4030 current_target.to_region_ok_for_hw_watchpoint
4031 = debug_to_region_ok_for_hw_watchpoint;
4032 current_target.to_can_accel_watchpoint_condition
4033 = debug_to_can_accel_watchpoint_condition;
4034 current_target.to_terminal_init = debug_to_terminal_init;
4035 current_target.to_terminal_inferior = debug_to_terminal_inferior;
4036 current_target.to_terminal_ours_for_output
4037 = debug_to_terminal_ours_for_output;
4038 current_target.to_terminal_ours = debug_to_terminal_ours;
4039 current_target.to_terminal_save_ours = debug_to_terminal_save_ours;
4040 current_target.to_terminal_info = debug_to_terminal_info;
4041 current_target.to_load = debug_to_load;
4042 current_target.to_post_startup_inferior = debug_to_post_startup_inferior;
4043 current_target.to_insert_fork_catchpoint = debug_to_insert_fork_catchpoint;
4044 current_target.to_remove_fork_catchpoint = debug_to_remove_fork_catchpoint;
4045 current_target.to_insert_vfork_catchpoint = debug_to_insert_vfork_catchpoint;
4046 current_target.to_remove_vfork_catchpoint = debug_to_remove_vfork_catchpoint;
4047 current_target.to_insert_exec_catchpoint = debug_to_insert_exec_catchpoint;
4048 current_target.to_remove_exec_catchpoint = debug_to_remove_exec_catchpoint;
4049 current_target.to_has_exited = debug_to_has_exited;
4050 current_target.to_can_run = debug_to_can_run;
4051 current_target.to_stop = debug_to_stop;
4052 current_target.to_rcmd = debug_to_rcmd;
4053 current_target.to_pid_to_exec_file = debug_to_pid_to_exec_file;
4054 current_target.to_thread_architecture = debug_to_thread_architecture;
4058 static char targ_desc[] =
4059 "Names of targets and files being debugged.\nShows the entire \
4060 stack of targets currently in use (including the exec-file,\n\
4061 core-file, and process, if any), as well as the symbol file name.";
4064 default_rcmd (struct target_ops *self, char *command, struct ui_file *output)
4066 error (_("\"monitor\" command not supported by this target."));
4070 do_monitor_command (char *cmd,
4073 target_rcmd (cmd, gdb_stdtarg);
4076 /* Print the name of each layers of our target stack. */
4079 maintenance_print_target_stack (char *cmd, int from_tty)
4081 struct target_ops *t;
4083 printf_filtered (_("The current target stack is:\n"));
4085 for (t = target_stack; t != NULL; t = t->beneath)
4087 printf_filtered (" - %s (%s)\n", t->to_shortname, t->to_longname);
4091 /* Controls if async mode is permitted. */
4092 int target_async_permitted = 0;
4094 /* The set command writes to this variable. If the inferior is
4095 executing, target_async_permitted is *not* updated. */
4096 static int target_async_permitted_1 = 0;
4099 set_target_async_command (char *args, int from_tty,
4100 struct cmd_list_element *c)
4102 if (have_live_inferiors ())
4104 target_async_permitted_1 = target_async_permitted;
4105 error (_("Cannot change this setting while the inferior is running."));
4108 target_async_permitted = target_async_permitted_1;
4112 show_target_async_command (struct ui_file *file, int from_tty,
4113 struct cmd_list_element *c,
4116 fprintf_filtered (file,
4117 _("Controlling the inferior in "
4118 "asynchronous mode is %s.\n"), value);
4121 /* Temporary copies of permission settings. */
4123 static int may_write_registers_1 = 1;
4124 static int may_write_memory_1 = 1;
4125 static int may_insert_breakpoints_1 = 1;
4126 static int may_insert_tracepoints_1 = 1;
4127 static int may_insert_fast_tracepoints_1 = 1;
4128 static int may_stop_1 = 1;
4130 /* Make the user-set values match the real values again. */
4133 update_target_permissions (void)
4135 may_write_registers_1 = may_write_registers;
4136 may_write_memory_1 = may_write_memory;
4137 may_insert_breakpoints_1 = may_insert_breakpoints;
4138 may_insert_tracepoints_1 = may_insert_tracepoints;
4139 may_insert_fast_tracepoints_1 = may_insert_fast_tracepoints;
4140 may_stop_1 = may_stop;
4143 /* The one function handles (most of) the permission flags in the same
4147 set_target_permissions (char *args, int from_tty,
4148 struct cmd_list_element *c)
4150 if (target_has_execution)
4152 update_target_permissions ();
4153 error (_("Cannot change this setting while the inferior is running."));
4156 /* Make the real values match the user-changed values. */
4157 may_write_registers = may_write_registers_1;
4158 may_insert_breakpoints = may_insert_breakpoints_1;
4159 may_insert_tracepoints = may_insert_tracepoints_1;
4160 may_insert_fast_tracepoints = may_insert_fast_tracepoints_1;
4161 may_stop = may_stop_1;
4162 update_observer_mode ();
4165 /* Set memory write permission independently of observer mode. */
4168 set_write_memory_permission (char *args, int from_tty,
4169 struct cmd_list_element *c)
4171 /* Make the real values match the user-changed values. */
4172 may_write_memory = may_write_memory_1;
4173 update_observer_mode ();
4178 initialize_targets (void)
4180 init_dummy_target ();
4181 push_target (&dummy_target);
4183 add_info ("target", target_info, targ_desc);
4184 add_info ("files", target_info, targ_desc);
4186 add_setshow_zuinteger_cmd ("target", class_maintenance, &targetdebug, _("\
4187 Set target debugging."), _("\
4188 Show target debugging."), _("\
4189 When non-zero, target debugging is enabled. Higher numbers are more\n\
4190 verbose. Changes do not take effect until the next \"run\" or \"target\"\n\
4194 &setdebuglist, &showdebuglist);
4196 add_setshow_boolean_cmd ("trust-readonly-sections", class_support,
4197 &trust_readonly, _("\
4198 Set mode for reading from readonly sections."), _("\
4199 Show mode for reading from readonly sections."), _("\
4200 When this mode is on, memory reads from readonly sections (such as .text)\n\
4201 will be read from the object file instead of from the target. This will\n\
4202 result in significant performance improvement for remote targets."),
4204 show_trust_readonly,
4205 &setlist, &showlist);
4207 add_com ("monitor", class_obscure, do_monitor_command,
4208 _("Send a command to the remote monitor (remote targets only)."));
4210 add_cmd ("target-stack", class_maintenance, maintenance_print_target_stack,
4211 _("Print the name of each layer of the internal target stack."),
4212 &maintenanceprintlist);
4214 add_setshow_boolean_cmd ("target-async", no_class,
4215 &target_async_permitted_1, _("\
4216 Set whether gdb controls the inferior in asynchronous mode."), _("\
4217 Show whether gdb controls the inferior in asynchronous mode."), _("\
4218 Tells gdb whether to control the inferior in asynchronous mode."),
4219 set_target_async_command,
4220 show_target_async_command,
4224 add_setshow_boolean_cmd ("may-write-registers", class_support,
4225 &may_write_registers_1, _("\
4226 Set permission to write into registers."), _("\
4227 Show permission to write into registers."), _("\
4228 When this permission is on, GDB may write into the target's registers.\n\
4229 Otherwise, any sort of write attempt will result in an error."),
4230 set_target_permissions, NULL,
4231 &setlist, &showlist);
4233 add_setshow_boolean_cmd ("may-write-memory", class_support,
4234 &may_write_memory_1, _("\
4235 Set permission to write into target memory."), _("\
4236 Show permission to write into target memory."), _("\
4237 When this permission is on, GDB may write into the target's memory.\n\
4238 Otherwise, any sort of write attempt will result in an error."),
4239 set_write_memory_permission, NULL,
4240 &setlist, &showlist);
4242 add_setshow_boolean_cmd ("may-insert-breakpoints", class_support,
4243 &may_insert_breakpoints_1, _("\
4244 Set permission to insert breakpoints in the target."), _("\
4245 Show permission to insert breakpoints in the target."), _("\
4246 When this permission is on, GDB may insert breakpoints in the program.\n\
4247 Otherwise, any sort of insertion attempt will result in an error."),
4248 set_target_permissions, NULL,
4249 &setlist, &showlist);
4251 add_setshow_boolean_cmd ("may-insert-tracepoints", class_support,
4252 &may_insert_tracepoints_1, _("\
4253 Set permission to insert tracepoints in the target."), _("\
4254 Show permission to insert tracepoints in the target."), _("\
4255 When this permission is on, GDB may insert tracepoints in the program.\n\
4256 Otherwise, any sort of insertion attempt will result in an error."),
4257 set_target_permissions, NULL,
4258 &setlist, &showlist);
4260 add_setshow_boolean_cmd ("may-insert-fast-tracepoints", class_support,
4261 &may_insert_fast_tracepoints_1, _("\
4262 Set permission to insert fast tracepoints in the target."), _("\
4263 Show permission to insert fast tracepoints in the target."), _("\
4264 When this permission is on, GDB may insert fast tracepoints.\n\
4265 Otherwise, any sort of insertion attempt will result in an error."),
4266 set_target_permissions, NULL,
4267 &setlist, &showlist);
4269 add_setshow_boolean_cmd ("may-interrupt", class_support,
4271 Set permission to interrupt or signal the target."), _("\
4272 Show permission to interrupt or signal the target."), _("\
4273 When this permission is on, GDB may interrupt/stop the target's execution.\n\
4274 Otherwise, any attempt to interrupt or stop will be ignored."),
4275 set_target_permissions, NULL,
4276 &setlist, &showlist);