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/>. */
24 #include "target-dcache.h"
36 #include "exceptions.h"
37 #include "target-descriptions.h"
38 #include "gdbthread.h"
41 #include "inline-frame.h"
42 #include "tracepoint.h"
43 #include "gdb/fileio.h"
46 #include "target-debug.h"
48 static void target_info (char *, int);
50 static void generic_tls_error (void) ATTRIBUTE_NORETURN
;
52 static void default_terminal_info (struct target_ops
*, const char *, int);
54 static int default_watchpoint_addr_within_range (struct target_ops
*,
55 CORE_ADDR
, CORE_ADDR
, int);
57 static int default_region_ok_for_hw_watchpoint (struct target_ops
*,
60 static void default_rcmd (struct target_ops
*, const char *, struct ui_file
*);
62 static ptid_t
default_get_ada_task_ptid (struct target_ops
*self
,
65 static int default_follow_fork (struct target_ops
*self
, int follow_child
,
68 static void default_mourn_inferior (struct target_ops
*self
);
70 static int default_search_memory (struct target_ops
*ops
,
72 ULONGEST search_space_len
,
73 const gdb_byte
*pattern
,
75 CORE_ADDR
*found_addrp
);
77 static int default_verify_memory (struct target_ops
*self
,
79 CORE_ADDR memaddr
, ULONGEST size
);
81 static struct address_space
*default_thread_address_space
82 (struct target_ops
*self
, ptid_t ptid
);
84 static void tcomplain (void) ATTRIBUTE_NORETURN
;
86 static int return_zero (struct target_ops
*);
88 static int return_zero_has_execution (struct target_ops
*, ptid_t
);
90 static void target_command (char *, int);
92 static struct target_ops
*find_default_run_target (char *);
94 static struct gdbarch
*default_thread_architecture (struct target_ops
*ops
,
97 static int dummy_find_memory_regions (struct target_ops
*self
,
98 find_memory_region_ftype ignore1
,
101 static char *dummy_make_corefile_notes (struct target_ops
*self
,
102 bfd
*ignore1
, int *ignore2
);
104 static char *default_pid_to_str (struct target_ops
*ops
, ptid_t ptid
);
106 static enum exec_direction_kind default_execution_direction
107 (struct target_ops
*self
);
109 static CORE_ADDR
default_target_decr_pc_after_break (struct target_ops
*ops
,
110 struct gdbarch
*gdbarch
);
112 static struct target_ops debug_target
;
114 #include "target-delegates.c"
116 static void init_dummy_target (void);
118 static void update_current_target (void);
120 /* Pointer to array of target architecture structures; the size of the
121 array; the current index into the array; the allocated size of the
123 struct target_ops
**target_structs
;
124 unsigned target_struct_size
;
125 unsigned target_struct_allocsize
;
126 #define DEFAULT_ALLOCSIZE 10
128 /* The initial current target, so that there is always a semi-valid
131 static struct target_ops dummy_target
;
133 /* Top of target stack. */
135 static struct target_ops
*target_stack
;
137 /* The target structure we are currently using to talk to a process
138 or file or whatever "inferior" we have. */
140 struct target_ops current_target
;
142 /* Command list for target. */
144 static struct cmd_list_element
*targetlist
= NULL
;
146 /* Nonzero if we should trust readonly sections from the
147 executable when reading memory. */
149 static int trust_readonly
= 0;
151 /* Nonzero if we should show true memory content including
152 memory breakpoint inserted by gdb. */
154 static int show_memory_breakpoints
= 0;
156 /* These globals control whether GDB attempts to perform these
157 operations; they are useful for targets that need to prevent
158 inadvertant disruption, such as in non-stop mode. */
160 int may_write_registers
= 1;
162 int may_write_memory
= 1;
164 int may_insert_breakpoints
= 1;
166 int may_insert_tracepoints
= 1;
168 int may_insert_fast_tracepoints
= 1;
172 /* Non-zero if we want to see trace of target level stuff. */
174 static unsigned int targetdebug
= 0;
177 set_targetdebug (char *args
, int from_tty
, struct cmd_list_element
*c
)
179 update_current_target ();
183 show_targetdebug (struct ui_file
*file
, int from_tty
,
184 struct cmd_list_element
*c
, const char *value
)
186 fprintf_filtered (file
, _("Target debugging is %s.\n"), value
);
189 static void setup_target_debug (void);
191 /* The user just typed 'target' without the name of a target. */
194 target_command (char *arg
, int from_tty
)
196 fputs_filtered ("Argument required (target name). Try `help target'\n",
200 /* Default target_has_* methods for process_stratum targets. */
203 default_child_has_all_memory (struct target_ops
*ops
)
205 /* If no inferior selected, then we can't read memory here. */
206 if (ptid_equal (inferior_ptid
, null_ptid
))
213 default_child_has_memory (struct target_ops
*ops
)
215 /* If no inferior selected, then we can't read memory here. */
216 if (ptid_equal (inferior_ptid
, null_ptid
))
223 default_child_has_stack (struct target_ops
*ops
)
225 /* If no inferior selected, there's no stack. */
226 if (ptid_equal (inferior_ptid
, null_ptid
))
233 default_child_has_registers (struct target_ops
*ops
)
235 /* Can't read registers from no inferior. */
236 if (ptid_equal (inferior_ptid
, null_ptid
))
243 default_child_has_execution (struct target_ops
*ops
, ptid_t the_ptid
)
245 /* If there's no thread selected, then we can't make it run through
247 if (ptid_equal (the_ptid
, null_ptid
))
255 target_has_all_memory_1 (void)
257 struct target_ops
*t
;
259 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
260 if (t
->to_has_all_memory (t
))
267 target_has_memory_1 (void)
269 struct target_ops
*t
;
271 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
272 if (t
->to_has_memory (t
))
279 target_has_stack_1 (void)
281 struct target_ops
*t
;
283 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
284 if (t
->to_has_stack (t
))
291 target_has_registers_1 (void)
293 struct target_ops
*t
;
295 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
296 if (t
->to_has_registers (t
))
303 target_has_execution_1 (ptid_t the_ptid
)
305 struct target_ops
*t
;
307 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
308 if (t
->to_has_execution (t
, the_ptid
))
315 target_has_execution_current (void)
317 return target_has_execution_1 (inferior_ptid
);
320 /* Complete initialization of T. This ensures that various fields in
321 T are set, if needed by the target implementation. */
324 complete_target_initialization (struct target_ops
*t
)
326 /* Provide default values for all "must have" methods. */
328 if (t
->to_has_all_memory
== NULL
)
329 t
->to_has_all_memory
= return_zero
;
331 if (t
->to_has_memory
== NULL
)
332 t
->to_has_memory
= return_zero
;
334 if (t
->to_has_stack
== NULL
)
335 t
->to_has_stack
= return_zero
;
337 if (t
->to_has_registers
== NULL
)
338 t
->to_has_registers
= return_zero
;
340 if (t
->to_has_execution
== NULL
)
341 t
->to_has_execution
= return_zero_has_execution
;
343 /* These methods can be called on an unpushed target and so require
344 a default implementation if the target might plausibly be the
345 default run target. */
346 gdb_assert (t
->to_can_run
== NULL
|| (t
->to_can_async_p
!= NULL
347 && t
->to_supports_non_stop
!= NULL
));
349 install_delegators (t
);
352 /* This is used to implement the various target commands. */
355 open_target (char *args
, int from_tty
, struct cmd_list_element
*command
)
357 struct target_ops
*ops
= get_cmd_context (command
);
360 fprintf_unfiltered (gdb_stdlog
, "-> %s->to_open (...)\n",
363 ops
->to_open (args
, from_tty
);
366 fprintf_unfiltered (gdb_stdlog
, "<- %s->to_open (%s, %d)\n",
367 ops
->to_shortname
, args
, from_tty
);
370 /* Add possible target architecture T to the list and add a new
371 command 'target T->to_shortname'. Set COMPLETER as the command's
372 completer if not NULL. */
375 add_target_with_completer (struct target_ops
*t
,
376 completer_ftype
*completer
)
378 struct cmd_list_element
*c
;
380 complete_target_initialization (t
);
384 target_struct_allocsize
= DEFAULT_ALLOCSIZE
;
385 target_structs
= (struct target_ops
**) xmalloc
386 (target_struct_allocsize
* sizeof (*target_structs
));
388 if (target_struct_size
>= target_struct_allocsize
)
390 target_struct_allocsize
*= 2;
391 target_structs
= (struct target_ops
**)
392 xrealloc ((char *) target_structs
,
393 target_struct_allocsize
* sizeof (*target_structs
));
395 target_structs
[target_struct_size
++] = t
;
397 if (targetlist
== NULL
)
398 add_prefix_cmd ("target", class_run
, target_command
, _("\
399 Connect to a target machine or process.\n\
400 The first argument is the type or protocol of the target machine.\n\
401 Remaining arguments are interpreted by the target protocol. For more\n\
402 information on the arguments for a particular protocol, type\n\
403 `help target ' followed by the protocol name."),
404 &targetlist
, "target ", 0, &cmdlist
);
405 c
= add_cmd (t
->to_shortname
, no_class
, NULL
, t
->to_doc
, &targetlist
);
406 set_cmd_sfunc (c
, open_target
);
407 set_cmd_context (c
, t
);
408 if (completer
!= NULL
)
409 set_cmd_completer (c
, completer
);
412 /* Add a possible target architecture to the list. */
415 add_target (struct target_ops
*t
)
417 add_target_with_completer (t
, NULL
);
423 add_deprecated_target_alias (struct target_ops
*t
, char *alias
)
425 struct cmd_list_element
*c
;
428 /* If we use add_alias_cmd, here, we do not get the deprecated warning,
430 c
= add_cmd (alias
, no_class
, NULL
, t
->to_doc
, &targetlist
);
431 set_cmd_sfunc (c
, open_target
);
432 set_cmd_context (c
, t
);
433 alt
= xstrprintf ("target %s", t
->to_shortname
);
434 deprecate_cmd (c
, alt
);
442 current_target
.to_kill (¤t_target
);
446 target_load (const char *arg
, int from_tty
)
448 target_dcache_invalidate ();
449 (*current_target
.to_load
) (¤t_target
, arg
, from_tty
);
453 target_terminal_inferior (void)
455 /* A background resume (``run&'') should leave GDB in control of the
456 terminal. Use target_can_async_p, not target_is_async_p, since at
457 this point the target is not async yet. However, if sync_execution
458 is not set, we know it will become async prior to resume. */
459 if (target_can_async_p () && !sync_execution
)
462 /* If GDB is resuming the inferior in the foreground, install
463 inferior's terminal modes. */
464 (*current_target
.to_terminal_inferior
) (¤t_target
);
470 target_supports_terminal_ours (void)
472 struct target_ops
*t
;
474 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
476 if (t
->to_terminal_ours
!= delegate_terminal_ours
477 && t
->to_terminal_ours
!= tdefault_terminal_ours
)
487 error (_("You can't do that when your target is `%s'"),
488 current_target
.to_shortname
);
494 error (_("You can't do that without a process to debug."));
498 default_terminal_info (struct target_ops
*self
, const char *args
, int from_tty
)
500 printf_unfiltered (_("No saved terminal information.\n"));
503 /* A default implementation for the to_get_ada_task_ptid target method.
505 This function builds the PTID by using both LWP and TID as part of
506 the PTID lwp and tid elements. The pid used is the pid of the
510 default_get_ada_task_ptid (struct target_ops
*self
, long lwp
, long tid
)
512 return ptid_build (ptid_get_pid (inferior_ptid
), lwp
, tid
);
515 static enum exec_direction_kind
516 default_execution_direction (struct target_ops
*self
)
518 if (!target_can_execute_reverse
)
520 else if (!target_can_async_p ())
523 gdb_assert_not_reached ("\
524 to_execution_direction must be implemented for reverse async");
527 /* Go through the target stack from top to bottom, copying over zero
528 entries in current_target, then filling in still empty entries. In
529 effect, we are doing class inheritance through the pushed target
532 NOTE: cagney/2003-10-17: The problem with this inheritance, as it
533 is currently implemented, is that it discards any knowledge of
534 which target an inherited method originally belonged to.
535 Consequently, new new target methods should instead explicitly and
536 locally search the target stack for the target that can handle the
540 update_current_target (void)
542 struct target_ops
*t
;
544 /* First, reset current's contents. */
545 memset (¤t_target
, 0, sizeof (current_target
));
547 /* Install the delegators. */
548 install_delegators (¤t_target
);
550 current_target
.to_stratum
= target_stack
->to_stratum
;
552 #define INHERIT(FIELD, TARGET) \
553 if (!current_target.FIELD) \
554 current_target.FIELD = (TARGET)->FIELD
556 /* Do not add any new INHERITs here. Instead, use the delegation
557 mechanism provided by make-target-delegates. */
558 for (t
= target_stack
; t
; t
= t
->beneath
)
560 INHERIT (to_shortname
, t
);
561 INHERIT (to_longname
, t
);
562 INHERIT (to_attach_no_wait
, t
);
563 INHERIT (to_have_steppable_watchpoint
, t
);
564 INHERIT (to_have_continuable_watchpoint
, t
);
565 INHERIT (to_has_thread_control
, t
);
569 /* Finally, position the target-stack beneath the squashed
570 "current_target". That way code looking for a non-inherited
571 target method can quickly and simply find it. */
572 current_target
.beneath
= target_stack
;
575 setup_target_debug ();
578 /* Push a new target type into the stack of the existing target accessors,
579 possibly superseding some of the existing accessors.
581 Rather than allow an empty stack, we always have the dummy target at
582 the bottom stratum, so we can call the function vectors without
586 push_target (struct target_ops
*t
)
588 struct target_ops
**cur
;
590 /* Check magic number. If wrong, it probably means someone changed
591 the struct definition, but not all the places that initialize one. */
592 if (t
->to_magic
!= OPS_MAGIC
)
594 fprintf_unfiltered (gdb_stderr
,
595 "Magic number of %s target struct wrong\n",
597 internal_error (__FILE__
, __LINE__
,
598 _("failed internal consistency check"));
601 /* Find the proper stratum to install this target in. */
602 for (cur
= &target_stack
; (*cur
) != NULL
; cur
= &(*cur
)->beneath
)
604 if ((int) (t
->to_stratum
) >= (int) (*cur
)->to_stratum
)
608 /* If there's already targets at this stratum, remove them. */
609 /* FIXME: cagney/2003-10-15: I think this should be popping all
610 targets to CUR, and not just those at this stratum level. */
611 while ((*cur
) != NULL
&& t
->to_stratum
== (*cur
)->to_stratum
)
613 /* There's already something at this stratum level. Close it,
614 and un-hook it from the stack. */
615 struct target_ops
*tmp
= (*cur
);
617 (*cur
) = (*cur
)->beneath
;
622 /* We have removed all targets in our stratum, now add the new one. */
626 update_current_target ();
629 /* Remove a target_ops vector from the stack, wherever it may be.
630 Return how many times it was removed (0 or 1). */
633 unpush_target (struct target_ops
*t
)
635 struct target_ops
**cur
;
636 struct target_ops
*tmp
;
638 if (t
->to_stratum
== dummy_stratum
)
639 internal_error (__FILE__
, __LINE__
,
640 _("Attempt to unpush the dummy target"));
642 /* Look for the specified target. Note that we assume that a target
643 can only occur once in the target stack. */
645 for (cur
= &target_stack
; (*cur
) != NULL
; cur
= &(*cur
)->beneath
)
651 /* If we don't find target_ops, quit. Only open targets should be
656 /* Unchain the target. */
658 (*cur
) = (*cur
)->beneath
;
661 update_current_target ();
663 /* Finally close the target. Note we do this after unchaining, so
664 any target method calls from within the target_close
665 implementation don't end up in T anymore. */
672 pop_all_targets_above (enum strata above_stratum
)
674 while ((int) (current_target
.to_stratum
) > (int) above_stratum
)
676 if (!unpush_target (target_stack
))
678 fprintf_unfiltered (gdb_stderr
,
679 "pop_all_targets couldn't find target %s\n",
680 target_stack
->to_shortname
);
681 internal_error (__FILE__
, __LINE__
,
682 _("failed internal consistency check"));
689 pop_all_targets (void)
691 pop_all_targets_above (dummy_stratum
);
694 /* Return 1 if T is now pushed in the target stack. Return 0 otherwise. */
697 target_is_pushed (struct target_ops
*t
)
699 struct target_ops
*cur
;
701 /* Check magic number. If wrong, it probably means someone changed
702 the struct definition, but not all the places that initialize one. */
703 if (t
->to_magic
!= OPS_MAGIC
)
705 fprintf_unfiltered (gdb_stderr
,
706 "Magic number of %s target struct wrong\n",
708 internal_error (__FILE__
, __LINE__
,
709 _("failed internal consistency check"));
712 for (cur
= target_stack
; cur
!= NULL
; cur
= cur
->beneath
)
719 /* Default implementation of to_get_thread_local_address. */
722 generic_tls_error (void)
724 throw_error (TLS_GENERIC_ERROR
,
725 _("Cannot find thread-local variables on this target"));
728 /* Using the objfile specified in OBJFILE, find the address for the
729 current thread's thread-local storage with offset OFFSET. */
731 target_translate_tls_address (struct objfile
*objfile
, CORE_ADDR offset
)
733 volatile CORE_ADDR addr
= 0;
734 struct target_ops
*target
= ¤t_target
;
736 if (gdbarch_fetch_tls_load_module_address_p (target_gdbarch ()))
738 ptid_t ptid
= inferior_ptid
;
739 volatile struct gdb_exception ex
;
741 TRY_CATCH (ex
, RETURN_MASK_ALL
)
745 /* Fetch the load module address for this objfile. */
746 lm_addr
= gdbarch_fetch_tls_load_module_address (target_gdbarch (),
749 addr
= target
->to_get_thread_local_address (target
, ptid
,
752 /* If an error occurred, print TLS related messages here. Otherwise,
753 throw the error to some higher catcher. */
756 int objfile_is_library
= (objfile
->flags
& OBJF_SHARED
);
760 case TLS_NO_LIBRARY_SUPPORT_ERROR
:
761 error (_("Cannot find thread-local variables "
762 "in this thread library."));
764 case TLS_LOAD_MODULE_NOT_FOUND_ERROR
:
765 if (objfile_is_library
)
766 error (_("Cannot find shared library `%s' in dynamic"
767 " linker's load module list"), objfile_name (objfile
));
769 error (_("Cannot find executable file `%s' in dynamic"
770 " linker's load module list"), objfile_name (objfile
));
772 case TLS_NOT_ALLOCATED_YET_ERROR
:
773 if (objfile_is_library
)
774 error (_("The inferior has not yet allocated storage for"
775 " thread-local variables in\n"
776 "the shared library `%s'\n"
778 objfile_name (objfile
), target_pid_to_str (ptid
));
780 error (_("The inferior has not yet allocated storage for"
781 " thread-local variables in\n"
782 "the executable `%s'\n"
784 objfile_name (objfile
), target_pid_to_str (ptid
));
786 case TLS_GENERIC_ERROR
:
787 if (objfile_is_library
)
788 error (_("Cannot find thread-local storage for %s, "
789 "shared library %s:\n%s"),
790 target_pid_to_str (ptid
),
791 objfile_name (objfile
), ex
.message
);
793 error (_("Cannot find thread-local storage for %s, "
794 "executable file %s:\n%s"),
795 target_pid_to_str (ptid
),
796 objfile_name (objfile
), ex
.message
);
799 throw_exception (ex
);
804 /* It wouldn't be wrong here to try a gdbarch method, too; finding
805 TLS is an ABI-specific thing. But we don't do that yet. */
807 error (_("Cannot find thread-local variables on this target"));
813 target_xfer_status_to_string (enum target_xfer_status status
)
815 #define CASE(X) case X: return #X
818 CASE(TARGET_XFER_E_IO
);
819 CASE(TARGET_XFER_UNAVAILABLE
);
828 #define MIN(A, B) (((A) <= (B)) ? (A) : (B))
830 /* target_read_string -- read a null terminated string, up to LEN bytes,
831 from MEMADDR in target. Set *ERRNOP to the errno code, or 0 if successful.
832 Set *STRING to a pointer to malloc'd memory containing the data; the caller
833 is responsible for freeing it. Return the number of bytes successfully
837 target_read_string (CORE_ADDR memaddr
, char **string
, int len
, int *errnop
)
843 int buffer_allocated
;
845 unsigned int nbytes_read
= 0;
849 /* Small for testing. */
850 buffer_allocated
= 4;
851 buffer
= xmalloc (buffer_allocated
);
856 tlen
= MIN (len
, 4 - (memaddr
& 3));
857 offset
= memaddr
& 3;
859 errcode
= target_read_memory (memaddr
& ~3, buf
, sizeof buf
);
862 /* The transfer request might have crossed the boundary to an
863 unallocated region of memory. Retry the transfer, requesting
867 errcode
= target_read_memory (memaddr
, buf
, 1);
872 if (bufptr
- buffer
+ tlen
> buffer_allocated
)
876 bytes
= bufptr
- buffer
;
877 buffer_allocated
*= 2;
878 buffer
= xrealloc (buffer
, buffer_allocated
);
879 bufptr
= buffer
+ bytes
;
882 for (i
= 0; i
< tlen
; i
++)
884 *bufptr
++ = buf
[i
+ offset
];
885 if (buf
[i
+ offset
] == '\000')
887 nbytes_read
+= i
+ 1;
903 struct target_section_table
*
904 target_get_section_table (struct target_ops
*target
)
906 return (*target
->to_get_section_table
) (target
);
909 /* Find a section containing ADDR. */
911 struct target_section
*
912 target_section_by_addr (struct target_ops
*target
, CORE_ADDR addr
)
914 struct target_section_table
*table
= target_get_section_table (target
);
915 struct target_section
*secp
;
920 for (secp
= table
->sections
; secp
< table
->sections_end
; secp
++)
922 if (addr
>= secp
->addr
&& addr
< secp
->endaddr
)
928 /* Read memory from more than one valid target. A core file, for
929 instance, could have some of memory but delegate other bits to
930 the target below it. So, we must manually try all targets. */
932 static enum target_xfer_status
933 raw_memory_xfer_partial (struct target_ops
*ops
, gdb_byte
*readbuf
,
934 const gdb_byte
*writebuf
, ULONGEST memaddr
, LONGEST len
,
935 ULONGEST
*xfered_len
)
937 enum target_xfer_status res
;
941 res
= ops
->to_xfer_partial (ops
, TARGET_OBJECT_MEMORY
, NULL
,
942 readbuf
, writebuf
, memaddr
, len
,
944 if (res
== TARGET_XFER_OK
)
947 /* Stop if the target reports that the memory is not available. */
948 if (res
== TARGET_XFER_UNAVAILABLE
)
951 /* We want to continue past core files to executables, but not
952 past a running target's memory. */
953 if (ops
->to_has_all_memory (ops
))
960 /* The cache works at the raw memory level. Make sure the cache
961 gets updated with raw contents no matter what kind of memory
962 object was originally being written. Note we do write-through
963 first, so that if it fails, we don't write to the cache contents
964 that never made it to the target. */
966 && !ptid_equal (inferior_ptid
, null_ptid
)
967 && target_dcache_init_p ()
968 && (stack_cache_enabled_p () || code_cache_enabled_p ()))
970 DCACHE
*dcache
= target_dcache_get ();
972 /* Note that writing to an area of memory which wasn't present
973 in the cache doesn't cause it to be loaded in. */
974 dcache_update (dcache
, res
, memaddr
, writebuf
, *xfered_len
);
980 /* Perform a partial memory transfer.
981 For docs see target.h, to_xfer_partial. */
983 static enum target_xfer_status
984 memory_xfer_partial_1 (struct target_ops
*ops
, enum target_object object
,
985 gdb_byte
*readbuf
, const gdb_byte
*writebuf
, ULONGEST memaddr
,
986 ULONGEST len
, ULONGEST
*xfered_len
)
988 enum target_xfer_status res
;
990 struct mem_region
*region
;
991 struct inferior
*inf
;
993 /* For accesses to unmapped overlay sections, read directly from
994 files. Must do this first, as MEMADDR may need adjustment. */
995 if (readbuf
!= NULL
&& overlay_debugging
)
997 struct obj_section
*section
= find_pc_overlay (memaddr
);
999 if (pc_in_unmapped_range (memaddr
, section
))
1001 struct target_section_table
*table
1002 = target_get_section_table (ops
);
1003 const char *section_name
= section
->the_bfd_section
->name
;
1005 memaddr
= overlay_mapped_address (memaddr
, section
);
1006 return section_table_xfer_memory_partial (readbuf
, writebuf
,
1007 memaddr
, len
, xfered_len
,
1009 table
->sections_end
,
1014 /* Try the executable files, if "trust-readonly-sections" is set. */
1015 if (readbuf
!= NULL
&& trust_readonly
)
1017 struct target_section
*secp
;
1018 struct target_section_table
*table
;
1020 secp
= target_section_by_addr (ops
, memaddr
);
1022 && (bfd_get_section_flags (secp
->the_bfd_section
->owner
,
1023 secp
->the_bfd_section
)
1026 table
= target_get_section_table (ops
);
1027 return section_table_xfer_memory_partial (readbuf
, writebuf
,
1028 memaddr
, len
, xfered_len
,
1030 table
->sections_end
,
1035 /* Try GDB's internal data cache. */
1036 region
= lookup_mem_region (memaddr
);
1037 /* region->hi == 0 means there's no upper bound. */
1038 if (memaddr
+ len
< region
->hi
|| region
->hi
== 0)
1041 reg_len
= region
->hi
- memaddr
;
1043 switch (region
->attrib
.mode
)
1046 if (writebuf
!= NULL
)
1047 return TARGET_XFER_E_IO
;
1051 if (readbuf
!= NULL
)
1052 return TARGET_XFER_E_IO
;
1056 /* We only support writing to flash during "load" for now. */
1057 if (writebuf
!= NULL
)
1058 error (_("Writing to flash memory forbidden in this context"));
1062 return TARGET_XFER_E_IO
;
1065 if (!ptid_equal (inferior_ptid
, null_ptid
))
1066 inf
= find_inferior_pid (ptid_get_pid (inferior_ptid
));
1072 /* The dcache reads whole cache lines; that doesn't play well
1073 with reading from a trace buffer, because reading outside of
1074 the collected memory range fails. */
1075 && get_traceframe_number () == -1
1076 && (region
->attrib
.cache
1077 || (stack_cache_enabled_p () && object
== TARGET_OBJECT_STACK_MEMORY
)
1078 || (code_cache_enabled_p () && object
== TARGET_OBJECT_CODE_MEMORY
)))
1080 DCACHE
*dcache
= target_dcache_get_or_init ();
1082 return dcache_read_memory_partial (ops
, dcache
, memaddr
, readbuf
,
1083 reg_len
, xfered_len
);
1086 /* If none of those methods found the memory we wanted, fall back
1087 to a target partial transfer. Normally a single call to
1088 to_xfer_partial is enough; if it doesn't recognize an object
1089 it will call the to_xfer_partial of the next target down.
1090 But for memory this won't do. Memory is the only target
1091 object which can be read from more than one valid target.
1092 A core file, for instance, could have some of memory but
1093 delegate other bits to the target below it. So, we must
1094 manually try all targets. */
1096 res
= raw_memory_xfer_partial (ops
, readbuf
, writebuf
, memaddr
, reg_len
,
1099 /* If we still haven't got anything, return the last error. We
1104 /* Perform a partial memory transfer. For docs see target.h,
1107 static enum target_xfer_status
1108 memory_xfer_partial (struct target_ops
*ops
, enum target_object object
,
1109 gdb_byte
*readbuf
, const gdb_byte
*writebuf
,
1110 ULONGEST memaddr
, ULONGEST len
, ULONGEST
*xfered_len
)
1112 enum target_xfer_status res
;
1114 /* Zero length requests are ok and require no work. */
1116 return TARGET_XFER_EOF
;
1118 /* Fill in READBUF with breakpoint shadows, or WRITEBUF with
1119 breakpoint insns, thus hiding out from higher layers whether
1120 there are software breakpoints inserted in the code stream. */
1121 if (readbuf
!= NULL
)
1123 res
= memory_xfer_partial_1 (ops
, object
, readbuf
, NULL
, memaddr
, len
,
1126 if (res
== TARGET_XFER_OK
&& !show_memory_breakpoints
)
1127 breakpoint_xfer_memory (readbuf
, NULL
, NULL
, memaddr
, *xfered_len
);
1132 struct cleanup
*old_chain
;
1134 /* A large write request is likely to be partially satisfied
1135 by memory_xfer_partial_1. We will continually malloc
1136 and free a copy of the entire write request for breakpoint
1137 shadow handling even though we only end up writing a small
1138 subset of it. Cap writes to 4KB to mitigate this. */
1139 len
= min (4096, len
);
1141 buf
= xmalloc (len
);
1142 old_chain
= make_cleanup (xfree
, buf
);
1143 memcpy (buf
, writebuf
, len
);
1145 breakpoint_xfer_memory (NULL
, buf
, writebuf
, memaddr
, len
);
1146 res
= memory_xfer_partial_1 (ops
, object
, NULL
, buf
, memaddr
, len
,
1149 do_cleanups (old_chain
);
1156 restore_show_memory_breakpoints (void *arg
)
1158 show_memory_breakpoints
= (uintptr_t) arg
;
1162 make_show_memory_breakpoints_cleanup (int show
)
1164 int current
= show_memory_breakpoints
;
1166 show_memory_breakpoints
= show
;
1167 return make_cleanup (restore_show_memory_breakpoints
,
1168 (void *) (uintptr_t) current
);
1171 /* For docs see target.h, to_xfer_partial. */
1173 enum target_xfer_status
1174 target_xfer_partial (struct target_ops
*ops
,
1175 enum target_object object
, const char *annex
,
1176 gdb_byte
*readbuf
, const gdb_byte
*writebuf
,
1177 ULONGEST offset
, ULONGEST len
,
1178 ULONGEST
*xfered_len
)
1180 enum target_xfer_status retval
;
1182 gdb_assert (ops
->to_xfer_partial
!= NULL
);
1184 /* Transfer is done when LEN is zero. */
1186 return TARGET_XFER_EOF
;
1188 if (writebuf
&& !may_write_memory
)
1189 error (_("Writing to memory is not allowed (addr %s, len %s)"),
1190 core_addr_to_string_nz (offset
), plongest (len
));
1194 /* If this is a memory transfer, let the memory-specific code
1195 have a look at it instead. Memory transfers are more
1197 if (object
== TARGET_OBJECT_MEMORY
|| object
== TARGET_OBJECT_STACK_MEMORY
1198 || object
== TARGET_OBJECT_CODE_MEMORY
)
1199 retval
= memory_xfer_partial (ops
, object
, readbuf
,
1200 writebuf
, offset
, len
, xfered_len
);
1201 else if (object
== TARGET_OBJECT_RAW_MEMORY
)
1203 /* Request the normal memory object from other layers. */
1204 retval
= raw_memory_xfer_partial (ops
, readbuf
, writebuf
, offset
, len
,
1208 retval
= ops
->to_xfer_partial (ops
, object
, annex
, readbuf
,
1209 writebuf
, offset
, len
, xfered_len
);
1213 const unsigned char *myaddr
= NULL
;
1215 fprintf_unfiltered (gdb_stdlog
,
1216 "%s:target_xfer_partial "
1217 "(%d, %s, %s, %s, %s, %s) = %d, %s",
1220 (annex
? annex
: "(null)"),
1221 host_address_to_string (readbuf
),
1222 host_address_to_string (writebuf
),
1223 core_addr_to_string_nz (offset
),
1224 pulongest (len
), retval
,
1225 pulongest (*xfered_len
));
1231 if (retval
== TARGET_XFER_OK
&& myaddr
!= NULL
)
1235 fputs_unfiltered (", bytes =", gdb_stdlog
);
1236 for (i
= 0; i
< *xfered_len
; i
++)
1238 if ((((intptr_t) &(myaddr
[i
])) & 0xf) == 0)
1240 if (targetdebug
< 2 && i
> 0)
1242 fprintf_unfiltered (gdb_stdlog
, " ...");
1245 fprintf_unfiltered (gdb_stdlog
, "\n");
1248 fprintf_unfiltered (gdb_stdlog
, " %02x", myaddr
[i
] & 0xff);
1252 fputc_unfiltered ('\n', gdb_stdlog
);
1255 /* Check implementations of to_xfer_partial update *XFERED_LEN
1256 properly. Do assertion after printing debug messages, so that we
1257 can find more clues on assertion failure from debugging messages. */
1258 if (retval
== TARGET_XFER_OK
|| retval
== TARGET_XFER_UNAVAILABLE
)
1259 gdb_assert (*xfered_len
> 0);
1264 /* Read LEN bytes of target memory at address MEMADDR, placing the
1265 results in GDB's memory at MYADDR. Returns either 0 for success or
1266 TARGET_XFER_E_IO if any error occurs.
1268 If an error occurs, no guarantee is made about the contents of the data at
1269 MYADDR. In particular, the caller should not depend upon partial reads
1270 filling the buffer with good data. There is no way for the caller to know
1271 how much good data might have been transfered anyway. Callers that can
1272 deal with partial reads should call target_read (which will retry until
1273 it makes no progress, and then return how much was transferred). */
1276 target_read_memory (CORE_ADDR memaddr
, gdb_byte
*myaddr
, ssize_t len
)
1278 /* Dispatch to the topmost target, not the flattened current_target.
1279 Memory accesses check target->to_has_(all_)memory, and the
1280 flattened target doesn't inherit those. */
1281 if (target_read (current_target
.beneath
, TARGET_OBJECT_MEMORY
, NULL
,
1282 myaddr
, memaddr
, len
) == len
)
1285 return TARGET_XFER_E_IO
;
1288 /* Like target_read_memory, but specify explicitly that this is a read
1289 from the target's raw memory. That is, this read bypasses the
1290 dcache, breakpoint shadowing, etc. */
1293 target_read_raw_memory (CORE_ADDR memaddr
, gdb_byte
*myaddr
, ssize_t len
)
1295 /* See comment in target_read_memory about why the request starts at
1296 current_target.beneath. */
1297 if (target_read (current_target
.beneath
, TARGET_OBJECT_RAW_MEMORY
, NULL
,
1298 myaddr
, memaddr
, len
) == len
)
1301 return TARGET_XFER_E_IO
;
1304 /* Like target_read_memory, but specify explicitly that this is a read from
1305 the target's stack. This may trigger different cache behavior. */
1308 target_read_stack (CORE_ADDR memaddr
, gdb_byte
*myaddr
, ssize_t len
)
1310 /* See comment in target_read_memory about why the request starts at
1311 current_target.beneath. */
1312 if (target_read (current_target
.beneath
, TARGET_OBJECT_STACK_MEMORY
, NULL
,
1313 myaddr
, memaddr
, len
) == len
)
1316 return TARGET_XFER_E_IO
;
1319 /* Like target_read_memory, but specify explicitly that this is a read from
1320 the target's code. This may trigger different cache behavior. */
1323 target_read_code (CORE_ADDR memaddr
, gdb_byte
*myaddr
, ssize_t len
)
1325 /* See comment in target_read_memory about why the request starts at
1326 current_target.beneath. */
1327 if (target_read (current_target
.beneath
, TARGET_OBJECT_CODE_MEMORY
, NULL
,
1328 myaddr
, memaddr
, len
) == len
)
1331 return TARGET_XFER_E_IO
;
1334 /* Write LEN bytes from MYADDR to target memory at address MEMADDR.
1335 Returns either 0 for success or TARGET_XFER_E_IO if any
1336 error occurs. If an error occurs, no guarantee is made about how
1337 much data got written. Callers that can deal with partial writes
1338 should call target_write. */
1341 target_write_memory (CORE_ADDR memaddr
, const gdb_byte
*myaddr
, ssize_t len
)
1343 /* See comment in target_read_memory about why the request starts at
1344 current_target.beneath. */
1345 if (target_write (current_target
.beneath
, TARGET_OBJECT_MEMORY
, NULL
,
1346 myaddr
, memaddr
, len
) == len
)
1349 return TARGET_XFER_E_IO
;
1352 /* Write LEN bytes from MYADDR to target raw memory at address
1353 MEMADDR. Returns either 0 for success or TARGET_XFER_E_IO
1354 if any error occurs. If an error occurs, no guarantee is made
1355 about how much data got written. Callers that can deal with
1356 partial writes should call target_write. */
1359 target_write_raw_memory (CORE_ADDR memaddr
, const gdb_byte
*myaddr
, ssize_t len
)
1361 /* See comment in target_read_memory about why the request starts at
1362 current_target.beneath. */
1363 if (target_write (current_target
.beneath
, TARGET_OBJECT_RAW_MEMORY
, NULL
,
1364 myaddr
, memaddr
, len
) == len
)
1367 return TARGET_XFER_E_IO
;
1370 /* Fetch the target's memory map. */
1373 target_memory_map (void)
1375 VEC(mem_region_s
) *result
;
1376 struct mem_region
*last_one
, *this_one
;
1378 struct target_ops
*t
;
1380 result
= current_target
.to_memory_map (¤t_target
);
1384 qsort (VEC_address (mem_region_s
, result
),
1385 VEC_length (mem_region_s
, result
),
1386 sizeof (struct mem_region
), mem_region_cmp
);
1388 /* Check that regions do not overlap. Simultaneously assign
1389 a numbering for the "mem" commands to use to refer to
1392 for (ix
= 0; VEC_iterate (mem_region_s
, result
, ix
, this_one
); ix
++)
1394 this_one
->number
= ix
;
1396 if (last_one
&& last_one
->hi
> this_one
->lo
)
1398 warning (_("Overlapping regions in memory map: ignoring"));
1399 VEC_free (mem_region_s
, result
);
1402 last_one
= this_one
;
1409 target_flash_erase (ULONGEST address
, LONGEST length
)
1411 current_target
.to_flash_erase (¤t_target
, address
, length
);
1415 target_flash_done (void)
1417 current_target
.to_flash_done (¤t_target
);
1421 show_trust_readonly (struct ui_file
*file
, int from_tty
,
1422 struct cmd_list_element
*c
, const char *value
)
1424 fprintf_filtered (file
,
1425 _("Mode for reading from readonly sections is %s.\n"),
1429 /* Target vector read/write partial wrapper functions. */
1431 static enum target_xfer_status
1432 target_read_partial (struct target_ops
*ops
,
1433 enum target_object object
,
1434 const char *annex
, gdb_byte
*buf
,
1435 ULONGEST offset
, ULONGEST len
,
1436 ULONGEST
*xfered_len
)
1438 return target_xfer_partial (ops
, object
, annex
, buf
, NULL
, offset
, len
,
1442 static enum target_xfer_status
1443 target_write_partial (struct target_ops
*ops
,
1444 enum target_object object
,
1445 const char *annex
, const gdb_byte
*buf
,
1446 ULONGEST offset
, LONGEST len
, ULONGEST
*xfered_len
)
1448 return target_xfer_partial (ops
, object
, annex
, NULL
, buf
, offset
, len
,
1452 /* Wrappers to perform the full transfer. */
1454 /* For docs on target_read see target.h. */
1457 target_read (struct target_ops
*ops
,
1458 enum target_object object
,
1459 const char *annex
, gdb_byte
*buf
,
1460 ULONGEST offset
, LONGEST len
)
1464 while (xfered
< len
)
1466 ULONGEST xfered_len
;
1467 enum target_xfer_status status
;
1469 status
= target_read_partial (ops
, object
, annex
,
1470 (gdb_byte
*) buf
+ xfered
,
1471 offset
+ xfered
, len
- xfered
,
1474 /* Call an observer, notifying them of the xfer progress? */
1475 if (status
== TARGET_XFER_EOF
)
1477 else if (status
== TARGET_XFER_OK
)
1479 xfered
+= xfered_len
;
1489 /* Assuming that the entire [begin, end) range of memory cannot be
1490 read, try to read whatever subrange is possible to read.
1492 The function returns, in RESULT, either zero or one memory block.
1493 If there's a readable subrange at the beginning, it is completely
1494 read and returned. Any further readable subrange will not be read.
1495 Otherwise, if there's a readable subrange at the end, it will be
1496 completely read and returned. Any readable subranges before it
1497 (obviously, not starting at the beginning), will be ignored. In
1498 other cases -- either no readable subrange, or readable subrange(s)
1499 that is neither at the beginning, or end, nothing is returned.
1501 The purpose of this function is to handle a read across a boundary
1502 of accessible memory in a case when memory map is not available.
1503 The above restrictions are fine for this case, but will give
1504 incorrect results if the memory is 'patchy'. However, supporting
1505 'patchy' memory would require trying to read every single byte,
1506 and it seems unacceptable solution. Explicit memory map is
1507 recommended for this case -- and target_read_memory_robust will
1508 take care of reading multiple ranges then. */
1511 read_whatever_is_readable (struct target_ops
*ops
,
1512 ULONGEST begin
, ULONGEST end
,
1513 VEC(memory_read_result_s
) **result
)
1515 gdb_byte
*buf
= xmalloc (end
- begin
);
1516 ULONGEST current_begin
= begin
;
1517 ULONGEST current_end
= end
;
1519 memory_read_result_s r
;
1520 ULONGEST xfered_len
;
1522 /* If we previously failed to read 1 byte, nothing can be done here. */
1523 if (end
- begin
<= 1)
1529 /* Check that either first or the last byte is readable, and give up
1530 if not. This heuristic is meant to permit reading accessible memory
1531 at the boundary of accessible region. */
1532 if (target_read_partial (ops
, TARGET_OBJECT_MEMORY
, NULL
,
1533 buf
, begin
, 1, &xfered_len
) == TARGET_XFER_OK
)
1538 else if (target_read_partial (ops
, TARGET_OBJECT_MEMORY
, NULL
,
1539 buf
+ (end
-begin
) - 1, end
- 1, 1,
1540 &xfered_len
) == TARGET_XFER_OK
)
1551 /* Loop invariant is that the [current_begin, current_end) was previously
1552 found to be not readable as a whole.
1554 Note loop condition -- if the range has 1 byte, we can't divide the range
1555 so there's no point trying further. */
1556 while (current_end
- current_begin
> 1)
1558 ULONGEST first_half_begin
, first_half_end
;
1559 ULONGEST second_half_begin
, second_half_end
;
1561 ULONGEST middle
= current_begin
+ (current_end
- current_begin
)/2;
1565 first_half_begin
= current_begin
;
1566 first_half_end
= middle
;
1567 second_half_begin
= middle
;
1568 second_half_end
= current_end
;
1572 first_half_begin
= middle
;
1573 first_half_end
= current_end
;
1574 second_half_begin
= current_begin
;
1575 second_half_end
= middle
;
1578 xfer
= target_read (ops
, TARGET_OBJECT_MEMORY
, NULL
,
1579 buf
+ (first_half_begin
- begin
),
1581 first_half_end
- first_half_begin
);
1583 if (xfer
== first_half_end
- first_half_begin
)
1585 /* This half reads up fine. So, the error must be in the
1587 current_begin
= second_half_begin
;
1588 current_end
= second_half_end
;
1592 /* This half is not readable. Because we've tried one byte, we
1593 know some part of this half if actually redable. Go to the next
1594 iteration to divide again and try to read.
1596 We don't handle the other half, because this function only tries
1597 to read a single readable subrange. */
1598 current_begin
= first_half_begin
;
1599 current_end
= first_half_end
;
1605 /* The [begin, current_begin) range has been read. */
1607 r
.end
= current_begin
;
1612 /* The [current_end, end) range has been read. */
1613 LONGEST rlen
= end
- current_end
;
1615 r
.data
= xmalloc (rlen
);
1616 memcpy (r
.data
, buf
+ current_end
- begin
, rlen
);
1617 r
.begin
= current_end
;
1621 VEC_safe_push(memory_read_result_s
, (*result
), &r
);
1625 free_memory_read_result_vector (void *x
)
1627 VEC(memory_read_result_s
) *v
= x
;
1628 memory_read_result_s
*current
;
1631 for (ix
= 0; VEC_iterate (memory_read_result_s
, v
, ix
, current
); ++ix
)
1633 xfree (current
->data
);
1635 VEC_free (memory_read_result_s
, v
);
1638 VEC(memory_read_result_s
) *
1639 read_memory_robust (struct target_ops
*ops
, ULONGEST offset
, LONGEST len
)
1641 VEC(memory_read_result_s
) *result
= 0;
1644 while (xfered
< len
)
1646 struct mem_region
*region
= lookup_mem_region (offset
+ xfered
);
1649 /* If there is no explicit region, a fake one should be created. */
1650 gdb_assert (region
);
1652 if (region
->hi
== 0)
1653 rlen
= len
- xfered
;
1655 rlen
= region
->hi
- offset
;
1657 if (region
->attrib
.mode
== MEM_NONE
|| region
->attrib
.mode
== MEM_WO
)
1659 /* Cannot read this region. Note that we can end up here only
1660 if the region is explicitly marked inaccessible, or
1661 'inaccessible-by-default' is in effect. */
1666 LONGEST to_read
= min (len
- xfered
, rlen
);
1667 gdb_byte
*buffer
= (gdb_byte
*)xmalloc (to_read
);
1669 LONGEST xfer
= target_read (ops
, TARGET_OBJECT_MEMORY
, NULL
,
1670 (gdb_byte
*) buffer
,
1671 offset
+ xfered
, to_read
);
1672 /* Call an observer, notifying them of the xfer progress? */
1675 /* Got an error reading full chunk. See if maybe we can read
1678 read_whatever_is_readable (ops
, offset
+ xfered
,
1679 offset
+ xfered
+ to_read
, &result
);
1684 struct memory_read_result r
;
1686 r
.begin
= offset
+ xfered
;
1687 r
.end
= r
.begin
+ xfer
;
1688 VEC_safe_push (memory_read_result_s
, result
, &r
);
1698 /* An alternative to target_write with progress callbacks. */
1701 target_write_with_progress (struct target_ops
*ops
,
1702 enum target_object object
,
1703 const char *annex
, const gdb_byte
*buf
,
1704 ULONGEST offset
, LONGEST len
,
1705 void (*progress
) (ULONGEST
, void *), void *baton
)
1709 /* Give the progress callback a chance to set up. */
1711 (*progress
) (0, baton
);
1713 while (xfered
< len
)
1715 ULONGEST xfered_len
;
1716 enum target_xfer_status status
;
1718 status
= target_write_partial (ops
, object
, annex
,
1719 (gdb_byte
*) buf
+ xfered
,
1720 offset
+ xfered
, len
- xfered
,
1723 if (status
!= TARGET_XFER_OK
)
1724 return status
== TARGET_XFER_EOF
? xfered
: -1;
1727 (*progress
) (xfered_len
, baton
);
1729 xfered
+= xfered_len
;
1735 /* For docs on target_write see target.h. */
1738 target_write (struct target_ops
*ops
,
1739 enum target_object object
,
1740 const char *annex
, const gdb_byte
*buf
,
1741 ULONGEST offset
, LONGEST len
)
1743 return target_write_with_progress (ops
, object
, annex
, buf
, offset
, len
,
1747 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
1748 the size of the transferred data. PADDING additional bytes are
1749 available in *BUF_P. This is a helper function for
1750 target_read_alloc; see the declaration of that function for more
1754 target_read_alloc_1 (struct target_ops
*ops
, enum target_object object
,
1755 const char *annex
, gdb_byte
**buf_p
, int padding
)
1757 size_t buf_alloc
, buf_pos
;
1760 /* This function does not have a length parameter; it reads the
1761 entire OBJECT). Also, it doesn't support objects fetched partly
1762 from one target and partly from another (in a different stratum,
1763 e.g. a core file and an executable). Both reasons make it
1764 unsuitable for reading memory. */
1765 gdb_assert (object
!= TARGET_OBJECT_MEMORY
);
1767 /* Start by reading up to 4K at a time. The target will throttle
1768 this number down if necessary. */
1770 buf
= xmalloc (buf_alloc
);
1774 ULONGEST xfered_len
;
1775 enum target_xfer_status status
;
1777 status
= target_read_partial (ops
, object
, annex
, &buf
[buf_pos
],
1778 buf_pos
, buf_alloc
- buf_pos
- padding
,
1781 if (status
== TARGET_XFER_EOF
)
1783 /* Read all there was. */
1790 else if (status
!= TARGET_XFER_OK
)
1792 /* An error occurred. */
1794 return TARGET_XFER_E_IO
;
1797 buf_pos
+= xfered_len
;
1799 /* If the buffer is filling up, expand it. */
1800 if (buf_alloc
< buf_pos
* 2)
1803 buf
= xrealloc (buf
, buf_alloc
);
1810 /* Read OBJECT/ANNEX using OPS. Store the result in *BUF_P and return
1811 the size of the transferred data. See the declaration in "target.h"
1812 function for more information about the return value. */
1815 target_read_alloc (struct target_ops
*ops
, enum target_object object
,
1816 const char *annex
, gdb_byte
**buf_p
)
1818 return target_read_alloc_1 (ops
, object
, annex
, buf_p
, 0);
1821 /* Read OBJECT/ANNEX using OPS. The result is NUL-terminated and
1822 returned as a string, allocated using xmalloc. If an error occurs
1823 or the transfer is unsupported, NULL is returned. Empty objects
1824 are returned as allocated but empty strings. A warning is issued
1825 if the result contains any embedded NUL bytes. */
1828 target_read_stralloc (struct target_ops
*ops
, enum target_object object
,
1833 LONGEST i
, transferred
;
1835 transferred
= target_read_alloc_1 (ops
, object
, annex
, &buffer
, 1);
1836 bufstr
= (char *) buffer
;
1838 if (transferred
< 0)
1841 if (transferred
== 0)
1842 return xstrdup ("");
1844 bufstr
[transferred
] = 0;
1846 /* Check for embedded NUL bytes; but allow trailing NULs. */
1847 for (i
= strlen (bufstr
); i
< transferred
; i
++)
1850 warning (_("target object %d, annex %s, "
1851 "contained unexpected null characters"),
1852 (int) object
, annex
? annex
: "(none)");
1859 /* Memory transfer methods. */
1862 get_target_memory (struct target_ops
*ops
, CORE_ADDR addr
, gdb_byte
*buf
,
1865 /* This method is used to read from an alternate, non-current
1866 target. This read must bypass the overlay support (as symbols
1867 don't match this target), and GDB's internal cache (wrong cache
1868 for this target). */
1869 if (target_read (ops
, TARGET_OBJECT_RAW_MEMORY
, NULL
, buf
, addr
, len
)
1871 memory_error (TARGET_XFER_E_IO
, addr
);
1875 get_target_memory_unsigned (struct target_ops
*ops
, CORE_ADDR addr
,
1876 int len
, enum bfd_endian byte_order
)
1878 gdb_byte buf
[sizeof (ULONGEST
)];
1880 gdb_assert (len
<= sizeof (buf
));
1881 get_target_memory (ops
, addr
, buf
, len
);
1882 return extract_unsigned_integer (buf
, len
, byte_order
);
1888 target_insert_breakpoint (struct gdbarch
*gdbarch
,
1889 struct bp_target_info
*bp_tgt
)
1891 if (!may_insert_breakpoints
)
1893 warning (_("May not insert breakpoints"));
1897 return current_target
.to_insert_breakpoint (¤t_target
,
1904 target_remove_breakpoint (struct gdbarch
*gdbarch
,
1905 struct bp_target_info
*bp_tgt
)
1907 /* This is kind of a weird case to handle, but the permission might
1908 have been changed after breakpoints were inserted - in which case
1909 we should just take the user literally and assume that any
1910 breakpoints should be left in place. */
1911 if (!may_insert_breakpoints
)
1913 warning (_("May not remove breakpoints"));
1917 return current_target
.to_remove_breakpoint (¤t_target
,
1922 target_info (char *args
, int from_tty
)
1924 struct target_ops
*t
;
1925 int has_all_mem
= 0;
1927 if (symfile_objfile
!= NULL
)
1928 printf_unfiltered (_("Symbols from \"%s\".\n"),
1929 objfile_name (symfile_objfile
));
1931 for (t
= target_stack
; t
!= NULL
; t
= t
->beneath
)
1933 if (!(*t
->to_has_memory
) (t
))
1936 if ((int) (t
->to_stratum
) <= (int) dummy_stratum
)
1939 printf_unfiltered (_("\tWhile running this, "
1940 "GDB does not access memory from...\n"));
1941 printf_unfiltered ("%s:\n", t
->to_longname
);
1942 (t
->to_files_info
) (t
);
1943 has_all_mem
= (*t
->to_has_all_memory
) (t
);
1947 /* This function is called before any new inferior is created, e.g.
1948 by running a program, attaching, or connecting to a target.
1949 It cleans up any state from previous invocations which might
1950 change between runs. This is a subset of what target_preopen
1951 resets (things which might change between targets). */
1954 target_pre_inferior (int from_tty
)
1956 /* Clear out solib state. Otherwise the solib state of the previous
1957 inferior might have survived and is entirely wrong for the new
1958 target. This has been observed on GNU/Linux using glibc 2.3. How
1970 Cannot access memory at address 0xdeadbeef
1973 /* In some OSs, the shared library list is the same/global/shared
1974 across inferiors. If code is shared between processes, so are
1975 memory regions and features. */
1976 if (!gdbarch_has_global_solist (target_gdbarch ()))
1978 no_shared_libraries (NULL
, from_tty
);
1980 invalidate_target_mem_regions ();
1982 target_clear_description ();
1985 agent_capability_invalidate ();
1988 /* Callback for iterate_over_inferiors. Gets rid of the given
1992 dispose_inferior (struct inferior
*inf
, void *args
)
1994 struct thread_info
*thread
;
1996 thread
= any_thread_of_process (inf
->pid
);
1999 switch_to_thread (thread
->ptid
);
2001 /* Core inferiors actually should be detached, not killed. */
2002 if (target_has_execution
)
2005 target_detach (NULL
, 0);
2011 /* This is to be called by the open routine before it does
2015 target_preopen (int from_tty
)
2019 if (have_inferiors ())
2022 || !have_live_inferiors ()
2023 || query (_("A program is being debugged already. Kill it? ")))
2024 iterate_over_inferiors (dispose_inferior
, NULL
);
2026 error (_("Program not killed."));
2029 /* Calling target_kill may remove the target from the stack. But if
2030 it doesn't (which seems like a win for UDI), remove it now. */
2031 /* Leave the exec target, though. The user may be switching from a
2032 live process to a core of the same program. */
2033 pop_all_targets_above (file_stratum
);
2035 target_pre_inferior (from_tty
);
2038 /* Detach a target after doing deferred register stores. */
2041 target_detach (const char *args
, int from_tty
)
2043 struct target_ops
* t
;
2045 if (gdbarch_has_global_breakpoints (target_gdbarch ()))
2046 /* Don't remove global breakpoints here. They're removed on
2047 disconnection from the target. */
2050 /* If we're in breakpoints-always-inserted mode, have to remove
2051 them before detaching. */
2052 remove_breakpoints_pid (ptid_get_pid (inferior_ptid
));
2054 prepare_for_detach ();
2056 current_target
.to_detach (¤t_target
, args
, from_tty
);
2060 target_disconnect (const char *args
, int from_tty
)
2062 /* If we're in breakpoints-always-inserted mode or if breakpoints
2063 are global across processes, we have to remove them before
2065 remove_breakpoints ();
2067 current_target
.to_disconnect (¤t_target
, args
, from_tty
);
2071 target_wait (ptid_t ptid
, struct target_waitstatus
*status
, int options
)
2073 return (current_target
.to_wait
) (¤t_target
, ptid
, status
, options
);
2077 target_pid_to_str (ptid_t ptid
)
2079 return (*current_target
.to_pid_to_str
) (¤t_target
, ptid
);
2083 target_thread_name (struct thread_info
*info
)
2085 return current_target
.to_thread_name (¤t_target
, info
);
2089 target_resume (ptid_t ptid
, int step
, enum gdb_signal signal
)
2091 struct target_ops
*t
;
2093 target_dcache_invalidate ();
2095 current_target
.to_resume (¤t_target
, ptid
, step
, signal
);
2097 registers_changed_ptid (ptid
);
2098 /* We only set the internal executing state here. The user/frontend
2099 running state is set at a higher level. */
2100 set_executing (ptid
, 1);
2101 clear_inline_frame_state (ptid
);
2105 target_pass_signals (int numsigs
, unsigned char *pass_signals
)
2107 (*current_target
.to_pass_signals
) (¤t_target
, numsigs
, pass_signals
);
2111 target_program_signals (int numsigs
, unsigned char *program_signals
)
2113 (*current_target
.to_program_signals
) (¤t_target
,
2114 numsigs
, program_signals
);
2118 default_follow_fork (struct target_ops
*self
, int follow_child
,
2121 /* Some target returned a fork event, but did not know how to follow it. */
2122 internal_error (__FILE__
, __LINE__
,
2123 _("could not find a target to follow fork"));
2126 /* Look through the list of possible targets for a target that can
2130 target_follow_fork (int follow_child
, int detach_fork
)
2132 return current_target
.to_follow_fork (¤t_target
,
2133 follow_child
, detach_fork
);
2137 default_mourn_inferior (struct target_ops
*self
)
2139 internal_error (__FILE__
, __LINE__
,
2140 _("could not find a target to follow mourn inferior"));
2144 target_mourn_inferior (void)
2146 current_target
.to_mourn_inferior (¤t_target
);
2148 /* We no longer need to keep handles on any of the object files.
2149 Make sure to release them to avoid unnecessarily locking any
2150 of them while we're not actually debugging. */
2151 bfd_cache_close_all ();
2154 /* Look for a target which can describe architectural features, starting
2155 from TARGET. If we find one, return its description. */
2157 const struct target_desc
*
2158 target_read_description (struct target_ops
*target
)
2160 return target
->to_read_description (target
);
2163 /* This implements a basic search of memory, reading target memory and
2164 performing the search here (as opposed to performing the search in on the
2165 target side with, for example, gdbserver). */
2168 simple_search_memory (struct target_ops
*ops
,
2169 CORE_ADDR start_addr
, ULONGEST search_space_len
,
2170 const gdb_byte
*pattern
, ULONGEST pattern_len
,
2171 CORE_ADDR
*found_addrp
)
2173 /* NOTE: also defined in find.c testcase. */
2174 #define SEARCH_CHUNK_SIZE 16000
2175 const unsigned chunk_size
= SEARCH_CHUNK_SIZE
;
2176 /* Buffer to hold memory contents for searching. */
2177 gdb_byte
*search_buf
;
2178 unsigned search_buf_size
;
2179 struct cleanup
*old_cleanups
;
2181 search_buf_size
= chunk_size
+ pattern_len
- 1;
2183 /* No point in trying to allocate a buffer larger than the search space. */
2184 if (search_space_len
< search_buf_size
)
2185 search_buf_size
= search_space_len
;
2187 search_buf
= malloc (search_buf_size
);
2188 if (search_buf
== NULL
)
2189 error (_("Unable to allocate memory to perform the search."));
2190 old_cleanups
= make_cleanup (free_current_contents
, &search_buf
);
2192 /* Prime the search buffer. */
2194 if (target_read (ops
, TARGET_OBJECT_MEMORY
, NULL
,
2195 search_buf
, start_addr
, search_buf_size
) != search_buf_size
)
2197 warning (_("Unable to access %s bytes of target "
2198 "memory at %s, halting search."),
2199 pulongest (search_buf_size
), hex_string (start_addr
));
2200 do_cleanups (old_cleanups
);
2204 /* Perform the search.
2206 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
2207 When we've scanned N bytes we copy the trailing bytes to the start and
2208 read in another N bytes. */
2210 while (search_space_len
>= pattern_len
)
2212 gdb_byte
*found_ptr
;
2213 unsigned nr_search_bytes
= min (search_space_len
, search_buf_size
);
2215 found_ptr
= memmem (search_buf
, nr_search_bytes
,
2216 pattern
, pattern_len
);
2218 if (found_ptr
!= NULL
)
2220 CORE_ADDR found_addr
= start_addr
+ (found_ptr
- search_buf
);
2222 *found_addrp
= found_addr
;
2223 do_cleanups (old_cleanups
);
2227 /* Not found in this chunk, skip to next chunk. */
2229 /* Don't let search_space_len wrap here, it's unsigned. */
2230 if (search_space_len
>= chunk_size
)
2231 search_space_len
-= chunk_size
;
2233 search_space_len
= 0;
2235 if (search_space_len
>= pattern_len
)
2237 unsigned keep_len
= search_buf_size
- chunk_size
;
2238 CORE_ADDR read_addr
= start_addr
+ chunk_size
+ keep_len
;
2241 /* Copy the trailing part of the previous iteration to the front
2242 of the buffer for the next iteration. */
2243 gdb_assert (keep_len
== pattern_len
- 1);
2244 memcpy (search_buf
, search_buf
+ chunk_size
, keep_len
);
2246 nr_to_read
= min (search_space_len
- keep_len
, chunk_size
);
2248 if (target_read (ops
, TARGET_OBJECT_MEMORY
, NULL
,
2249 search_buf
+ keep_len
, read_addr
,
2250 nr_to_read
) != nr_to_read
)
2252 warning (_("Unable to access %s bytes of target "
2253 "memory at %s, halting search."),
2254 plongest (nr_to_read
),
2255 hex_string (read_addr
));
2256 do_cleanups (old_cleanups
);
2260 start_addr
+= chunk_size
;
2266 do_cleanups (old_cleanups
);
2270 /* Default implementation of memory-searching. */
2273 default_search_memory (struct target_ops
*self
,
2274 CORE_ADDR start_addr
, ULONGEST search_space_len
,
2275 const gdb_byte
*pattern
, ULONGEST pattern_len
,
2276 CORE_ADDR
*found_addrp
)
2278 /* Start over from the top of the target stack. */
2279 return simple_search_memory (current_target
.beneath
,
2280 start_addr
, search_space_len
,
2281 pattern
, pattern_len
, found_addrp
);
2284 /* Search SEARCH_SPACE_LEN bytes beginning at START_ADDR for the
2285 sequence of bytes in PATTERN with length PATTERN_LEN.
2287 The result is 1 if found, 0 if not found, and -1 if there was an error
2288 requiring halting of the search (e.g. memory read error).
2289 If the pattern is found the address is recorded in FOUND_ADDRP. */
2292 target_search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
2293 const gdb_byte
*pattern
, ULONGEST pattern_len
,
2294 CORE_ADDR
*found_addrp
)
2296 return current_target
.to_search_memory (¤t_target
, start_addr
,
2298 pattern
, pattern_len
, found_addrp
);
2301 /* Look through the currently pushed targets. If none of them will
2302 be able to restart the currently running process, issue an error
2306 target_require_runnable (void)
2308 struct target_ops
*t
;
2310 for (t
= target_stack
; t
!= NULL
; t
= t
->beneath
)
2312 /* If this target knows how to create a new program, then
2313 assume we will still be able to after killing the current
2314 one. Either killing and mourning will not pop T, or else
2315 find_default_run_target will find it again. */
2316 if (t
->to_create_inferior
!= NULL
)
2319 /* Do not worry about targets at certain strata that can not
2320 create inferiors. Assume they will be pushed again if
2321 necessary, and continue to the process_stratum. */
2322 if (t
->to_stratum
== thread_stratum
2323 || t
->to_stratum
== record_stratum
2324 || t
->to_stratum
== arch_stratum
)
2327 error (_("The \"%s\" target does not support \"run\". "
2328 "Try \"help target\" or \"continue\"."),
2332 /* This function is only called if the target is running. In that
2333 case there should have been a process_stratum target and it
2334 should either know how to create inferiors, or not... */
2335 internal_error (__FILE__
, __LINE__
, _("No targets found"));
2338 /* Whether GDB is allowed to fall back to the default run target for
2339 "run", "attach", etc. when no target is connected yet. */
2340 static int auto_connect_native_target
= 1;
2343 show_auto_connect_native_target (struct ui_file
*file
, int from_tty
,
2344 struct cmd_list_element
*c
, const char *value
)
2346 fprintf_filtered (file
,
2347 _("Whether GDB may automatically connect to the "
2348 "native target is %s.\n"),
2352 /* Look through the list of possible targets for a target that can
2353 execute a run or attach command without any other data. This is
2354 used to locate the default process stratum.
2356 If DO_MESG is not NULL, the result is always valid (error() is
2357 called for errors); else, return NULL on error. */
2359 static struct target_ops
*
2360 find_default_run_target (char *do_mesg
)
2362 struct target_ops
*runable
= NULL
;
2364 if (auto_connect_native_target
)
2366 struct target_ops
**t
;
2369 for (t
= target_structs
; t
< target_structs
+ target_struct_size
;
2372 if ((*t
)->to_can_run
!= delegate_can_run
&& target_can_run (*t
))
2383 if (runable
== NULL
)
2386 error (_("Don't know how to %s. Try \"help target\"."), do_mesg
);
2397 find_attach_target (void)
2399 struct target_ops
*t
;
2401 /* If a target on the current stack can attach, use it. */
2402 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
2404 if (t
->to_attach
!= NULL
)
2408 /* Otherwise, use the default run target for attaching. */
2410 t
= find_default_run_target ("attach");
2418 find_run_target (void)
2420 struct target_ops
*t
;
2422 /* If a target on the current stack can attach, use it. */
2423 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
2425 if (t
->to_create_inferior
!= NULL
)
2429 /* Otherwise, use the default run target. */
2431 t
= find_default_run_target ("run");
2436 /* Implement the "info proc" command. */
2439 target_info_proc (const char *args
, enum info_proc_what what
)
2441 struct target_ops
*t
;
2443 /* If we're already connected to something that can get us OS
2444 related data, use it. Otherwise, try using the native
2446 if (current_target
.to_stratum
>= process_stratum
)
2447 t
= current_target
.beneath
;
2449 t
= find_default_run_target (NULL
);
2451 for (; t
!= NULL
; t
= t
->beneath
)
2453 if (t
->to_info_proc
!= NULL
)
2455 t
->to_info_proc (t
, args
, what
);
2458 fprintf_unfiltered (gdb_stdlog
,
2459 "target_info_proc (\"%s\", %d)\n", args
, what
);
2469 find_default_supports_disable_randomization (struct target_ops
*self
)
2471 struct target_ops
*t
;
2473 t
= find_default_run_target (NULL
);
2474 if (t
&& t
->to_supports_disable_randomization
)
2475 return (t
->to_supports_disable_randomization
) (t
);
2480 target_supports_disable_randomization (void)
2482 struct target_ops
*t
;
2484 for (t
= ¤t_target
; t
!= NULL
; t
= t
->beneath
)
2485 if (t
->to_supports_disable_randomization
)
2486 return t
->to_supports_disable_randomization (t
);
2492 target_get_osdata (const char *type
)
2494 struct target_ops
*t
;
2496 /* If we're already connected to something that can get us OS
2497 related data, use it. Otherwise, try using the native
2499 if (current_target
.to_stratum
>= process_stratum
)
2500 t
= current_target
.beneath
;
2502 t
= find_default_run_target ("get OS data");
2507 return target_read_stralloc (t
, TARGET_OBJECT_OSDATA
, type
);
2510 static struct address_space
*
2511 default_thread_address_space (struct target_ops
*self
, ptid_t ptid
)
2513 struct inferior
*inf
;
2515 /* Fall-back to the "main" address space of the inferior. */
2516 inf
= find_inferior_pid (ptid_get_pid (ptid
));
2518 if (inf
== NULL
|| inf
->aspace
== NULL
)
2519 internal_error (__FILE__
, __LINE__
,
2520 _("Can't determine the current "
2521 "address space of thread %s\n"),
2522 target_pid_to_str (ptid
));
2527 /* Determine the current address space of thread PTID. */
2529 struct address_space
*
2530 target_thread_address_space (ptid_t ptid
)
2532 struct address_space
*aspace
;
2534 aspace
= current_target
.to_thread_address_space (¤t_target
, ptid
);
2535 gdb_assert (aspace
!= NULL
);
2541 /* Target file operations. */
2543 static struct target_ops
*
2544 default_fileio_target (void)
2546 /* If we're already connected to something that can perform
2547 file I/O, use it. Otherwise, try using the native target. */
2548 if (current_target
.to_stratum
>= process_stratum
)
2549 return current_target
.beneath
;
2551 return find_default_run_target ("file I/O");
2554 /* Open FILENAME on the target, using FLAGS and MODE. Return a
2555 target file descriptor, or -1 if an error occurs (and set
2558 target_fileio_open (const char *filename
, int flags
, int mode
,
2561 struct target_ops
*t
;
2563 for (t
= default_fileio_target (); t
!= NULL
; t
= t
->beneath
)
2565 if (t
->to_fileio_open
!= NULL
)
2567 int fd
= t
->to_fileio_open (t
, filename
, flags
, mode
, target_errno
);
2570 fprintf_unfiltered (gdb_stdlog
,
2571 "target_fileio_open (%s,0x%x,0%o) = %d (%d)\n",
2572 filename
, flags
, mode
,
2573 fd
, fd
!= -1 ? 0 : *target_errno
);
2578 *target_errno
= FILEIO_ENOSYS
;
2582 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
2583 Return the number of bytes written, or -1 if an error occurs
2584 (and set *TARGET_ERRNO). */
2586 target_fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
2587 ULONGEST offset
, int *target_errno
)
2589 struct target_ops
*t
;
2591 for (t
= default_fileio_target (); t
!= NULL
; t
= t
->beneath
)
2593 if (t
->to_fileio_pwrite
!= NULL
)
2595 int ret
= t
->to_fileio_pwrite (t
, fd
, write_buf
, len
, offset
,
2599 fprintf_unfiltered (gdb_stdlog
,
2600 "target_fileio_pwrite (%d,...,%d,%s) "
2602 fd
, len
, pulongest (offset
),
2603 ret
, ret
!= -1 ? 0 : *target_errno
);
2608 *target_errno
= FILEIO_ENOSYS
;
2612 /* Read up to LEN bytes FD on the target into READ_BUF.
2613 Return the number of bytes read, or -1 if an error occurs
2614 (and set *TARGET_ERRNO). */
2616 target_fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
2617 ULONGEST offset
, int *target_errno
)
2619 struct target_ops
*t
;
2621 for (t
= default_fileio_target (); t
!= NULL
; t
= t
->beneath
)
2623 if (t
->to_fileio_pread
!= NULL
)
2625 int ret
= t
->to_fileio_pread (t
, fd
, read_buf
, len
, offset
,
2629 fprintf_unfiltered (gdb_stdlog
,
2630 "target_fileio_pread (%d,...,%d,%s) "
2632 fd
, len
, pulongest (offset
),
2633 ret
, ret
!= -1 ? 0 : *target_errno
);
2638 *target_errno
= FILEIO_ENOSYS
;
2642 /* Close FD on the target. Return 0, or -1 if an error occurs
2643 (and set *TARGET_ERRNO). */
2645 target_fileio_close (int fd
, int *target_errno
)
2647 struct target_ops
*t
;
2649 for (t
= default_fileio_target (); t
!= NULL
; t
= t
->beneath
)
2651 if (t
->to_fileio_close
!= NULL
)
2653 int ret
= t
->to_fileio_close (t
, fd
, target_errno
);
2656 fprintf_unfiltered (gdb_stdlog
,
2657 "target_fileio_close (%d) = %d (%d)\n",
2658 fd
, ret
, ret
!= -1 ? 0 : *target_errno
);
2663 *target_errno
= FILEIO_ENOSYS
;
2667 /* Unlink FILENAME on the target. Return 0, or -1 if an error
2668 occurs (and set *TARGET_ERRNO). */
2670 target_fileio_unlink (const char *filename
, int *target_errno
)
2672 struct target_ops
*t
;
2674 for (t
= default_fileio_target (); t
!= NULL
; t
= t
->beneath
)
2676 if (t
->to_fileio_unlink
!= NULL
)
2678 int ret
= t
->to_fileio_unlink (t
, filename
, target_errno
);
2681 fprintf_unfiltered (gdb_stdlog
,
2682 "target_fileio_unlink (%s) = %d (%d)\n",
2683 filename
, ret
, ret
!= -1 ? 0 : *target_errno
);
2688 *target_errno
= FILEIO_ENOSYS
;
2692 /* Read value of symbolic link FILENAME on the target. Return a
2693 null-terminated string allocated via xmalloc, or NULL if an error
2694 occurs (and set *TARGET_ERRNO). */
2696 target_fileio_readlink (const char *filename
, int *target_errno
)
2698 struct target_ops
*t
;
2700 for (t
= default_fileio_target (); t
!= NULL
; t
= t
->beneath
)
2702 if (t
->to_fileio_readlink
!= NULL
)
2704 char *ret
= t
->to_fileio_readlink (t
, filename
, target_errno
);
2707 fprintf_unfiltered (gdb_stdlog
,
2708 "target_fileio_readlink (%s) = %s (%d)\n",
2709 filename
, ret
? ret
: "(nil)",
2710 ret
? 0 : *target_errno
);
2715 *target_errno
= FILEIO_ENOSYS
;
2720 target_fileio_close_cleanup (void *opaque
)
2722 int fd
= *(int *) opaque
;
2725 target_fileio_close (fd
, &target_errno
);
2728 /* Read target file FILENAME. Store the result in *BUF_P and
2729 return the size of the transferred data. PADDING additional bytes are
2730 available in *BUF_P. This is a helper function for
2731 target_fileio_read_alloc; see the declaration of that function for more
2735 target_fileio_read_alloc_1 (const char *filename
,
2736 gdb_byte
**buf_p
, int padding
)
2738 struct cleanup
*close_cleanup
;
2739 size_t buf_alloc
, buf_pos
;
2745 fd
= target_fileio_open (filename
, FILEIO_O_RDONLY
, 0700, &target_errno
);
2749 close_cleanup
= make_cleanup (target_fileio_close_cleanup
, &fd
);
2751 /* Start by reading up to 4K at a time. The target will throttle
2752 this number down if necessary. */
2754 buf
= xmalloc (buf_alloc
);
2758 n
= target_fileio_pread (fd
, &buf
[buf_pos
],
2759 buf_alloc
- buf_pos
- padding
, buf_pos
,
2763 /* An error occurred. */
2764 do_cleanups (close_cleanup
);
2770 /* Read all there was. */
2771 do_cleanups (close_cleanup
);
2781 /* If the buffer is filling up, expand it. */
2782 if (buf_alloc
< buf_pos
* 2)
2785 buf
= xrealloc (buf
, buf_alloc
);
2792 /* Read target file FILENAME. Store the result in *BUF_P and return
2793 the size of the transferred data. See the declaration in "target.h"
2794 function for more information about the return value. */
2797 target_fileio_read_alloc (const char *filename
, gdb_byte
**buf_p
)
2799 return target_fileio_read_alloc_1 (filename
, buf_p
, 0);
2802 /* Read target file FILENAME. The result is NUL-terminated and
2803 returned as a string, allocated using xmalloc. If an error occurs
2804 or the transfer is unsupported, NULL is returned. Empty objects
2805 are returned as allocated but empty strings. A warning is issued
2806 if the result contains any embedded NUL bytes. */
2809 target_fileio_read_stralloc (const char *filename
)
2813 LONGEST i
, transferred
;
2815 transferred
= target_fileio_read_alloc_1 (filename
, &buffer
, 1);
2816 bufstr
= (char *) buffer
;
2818 if (transferred
< 0)
2821 if (transferred
== 0)
2822 return xstrdup ("");
2824 bufstr
[transferred
] = 0;
2826 /* Check for embedded NUL bytes; but allow trailing NULs. */
2827 for (i
= strlen (bufstr
); i
< transferred
; i
++)
2830 warning (_("target file %s "
2831 "contained unexpected null characters"),
2841 default_region_ok_for_hw_watchpoint (struct target_ops
*self
,
2842 CORE_ADDR addr
, int len
)
2844 return (len
<= gdbarch_ptr_bit (target_gdbarch ()) / TARGET_CHAR_BIT
);
2848 default_watchpoint_addr_within_range (struct target_ops
*target
,
2850 CORE_ADDR start
, int length
)
2852 return addr
>= start
&& addr
< start
+ length
;
2855 static struct gdbarch
*
2856 default_thread_architecture (struct target_ops
*ops
, ptid_t ptid
)
2858 return target_gdbarch ();
2862 return_zero (struct target_ops
*ignore
)
2868 return_zero_has_execution (struct target_ops
*ignore
, ptid_t ignore2
)
2874 * Find the next target down the stack from the specified target.
2878 find_target_beneath (struct target_ops
*t
)
2886 find_target_at (enum strata stratum
)
2888 struct target_ops
*t
;
2890 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
2891 if (t
->to_stratum
== stratum
)
2898 /* The inferior process has died. Long live the inferior! */
2901 generic_mourn_inferior (void)
2905 ptid
= inferior_ptid
;
2906 inferior_ptid
= null_ptid
;
2908 /* Mark breakpoints uninserted in case something tries to delete a
2909 breakpoint while we delete the inferior's threads (which would
2910 fail, since the inferior is long gone). */
2911 mark_breakpoints_out ();
2913 if (!ptid_equal (ptid
, null_ptid
))
2915 int pid
= ptid_get_pid (ptid
);
2916 exit_inferior (pid
);
2919 /* Note this wipes step-resume breakpoints, so needs to be done
2920 after exit_inferior, which ends up referencing the step-resume
2921 breakpoints through clear_thread_inferior_resources. */
2922 breakpoint_init_inferior (inf_exited
);
2924 registers_changed ();
2926 reopen_exec_file ();
2927 reinit_frame_cache ();
2929 if (deprecated_detach_hook
)
2930 deprecated_detach_hook ();
2933 /* Convert a normal process ID to a string. Returns the string in a
2937 normal_pid_to_str (ptid_t ptid
)
2939 static char buf
[32];
2941 xsnprintf (buf
, sizeof buf
, "process %d", ptid_get_pid (ptid
));
2946 default_pid_to_str (struct target_ops
*ops
, ptid_t ptid
)
2948 return normal_pid_to_str (ptid
);
2951 /* Error-catcher for target_find_memory_regions. */
2953 dummy_find_memory_regions (struct target_ops
*self
,
2954 find_memory_region_ftype ignore1
, void *ignore2
)
2956 error (_("Command not implemented for this target."));
2960 /* Error-catcher for target_make_corefile_notes. */
2962 dummy_make_corefile_notes (struct target_ops
*self
,
2963 bfd
*ignore1
, int *ignore2
)
2965 error (_("Command not implemented for this target."));
2969 /* Set up the handful of non-empty slots needed by the dummy target
2973 init_dummy_target (void)
2975 dummy_target
.to_shortname
= "None";
2976 dummy_target
.to_longname
= "None";
2977 dummy_target
.to_doc
= "";
2978 dummy_target
.to_supports_disable_randomization
2979 = find_default_supports_disable_randomization
;
2980 dummy_target
.to_stratum
= dummy_stratum
;
2981 dummy_target
.to_has_all_memory
= return_zero
;
2982 dummy_target
.to_has_memory
= return_zero
;
2983 dummy_target
.to_has_stack
= return_zero
;
2984 dummy_target
.to_has_registers
= return_zero
;
2985 dummy_target
.to_has_execution
= return_zero_has_execution
;
2986 dummy_target
.to_magic
= OPS_MAGIC
;
2988 install_dummy_methods (&dummy_target
);
2993 target_close (struct target_ops
*targ
)
2995 gdb_assert (!target_is_pushed (targ
));
2997 if (targ
->to_xclose
!= NULL
)
2998 targ
->to_xclose (targ
);
2999 else if (targ
->to_close
!= NULL
)
3000 targ
->to_close (targ
);
3003 fprintf_unfiltered (gdb_stdlog
, "target_close ()\n");
3007 target_thread_alive (ptid_t ptid
)
3009 return current_target
.to_thread_alive (¤t_target
, ptid
);
3013 target_find_new_threads (void)
3015 current_target
.to_find_new_threads (¤t_target
);
3019 target_stop (ptid_t ptid
)
3023 warning (_("May not interrupt or stop the target, ignoring attempt"));
3027 (*current_target
.to_stop
) (¤t_target
, ptid
);
3030 /* Concatenate ELEM to LIST, a comma separate list, and return the
3031 result. The LIST incoming argument is released. */
3034 str_comma_list_concat_elem (char *list
, const char *elem
)
3037 return xstrdup (elem
);
3039 return reconcat (list
, list
, ", ", elem
, (char *) NULL
);
3042 /* Helper for target_options_to_string. If OPT is present in
3043 TARGET_OPTIONS, append the OPT_STR (string version of OPT) in RET.
3044 Returns the new resulting string. OPT is removed from
3048 do_option (int *target_options
, char *ret
,
3049 int opt
, char *opt_str
)
3051 if ((*target_options
& opt
) != 0)
3053 ret
= str_comma_list_concat_elem (ret
, opt_str
);
3054 *target_options
&= ~opt
;
3061 target_options_to_string (int target_options
)
3065 #define DO_TARG_OPTION(OPT) \
3066 ret = do_option (&target_options, ret, OPT, #OPT)
3068 DO_TARG_OPTION (TARGET_WNOHANG
);
3070 if (target_options
!= 0)
3071 ret
= str_comma_list_concat_elem (ret
, "unknown???");
3079 debug_print_register (const char * func
,
3080 struct regcache
*regcache
, int regno
)
3082 struct gdbarch
*gdbarch
= get_regcache_arch (regcache
);
3084 fprintf_unfiltered (gdb_stdlog
, "%s ", func
);
3085 if (regno
>= 0 && regno
< gdbarch_num_regs (gdbarch
)
3086 && gdbarch_register_name (gdbarch
, regno
) != NULL
3087 && gdbarch_register_name (gdbarch
, regno
)[0] != '\0')
3088 fprintf_unfiltered (gdb_stdlog
, "(%s)",
3089 gdbarch_register_name (gdbarch
, regno
));
3091 fprintf_unfiltered (gdb_stdlog
, "(%d)", regno
);
3092 if (regno
>= 0 && regno
< gdbarch_num_regs (gdbarch
))
3094 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
3095 int i
, size
= register_size (gdbarch
, regno
);
3096 gdb_byte buf
[MAX_REGISTER_SIZE
];
3098 regcache_raw_collect (regcache
, regno
, buf
);
3099 fprintf_unfiltered (gdb_stdlog
, " = ");
3100 for (i
= 0; i
< size
; i
++)
3102 fprintf_unfiltered (gdb_stdlog
, "%02x", buf
[i
]);
3104 if (size
<= sizeof (LONGEST
))
3106 ULONGEST val
= extract_unsigned_integer (buf
, size
, byte_order
);
3108 fprintf_unfiltered (gdb_stdlog
, " %s %s",
3109 core_addr_to_string_nz (val
), plongest (val
));
3112 fprintf_unfiltered (gdb_stdlog
, "\n");
3116 target_fetch_registers (struct regcache
*regcache
, int regno
)
3118 current_target
.to_fetch_registers (¤t_target
, regcache
, regno
);
3120 debug_print_register ("target_fetch_registers", regcache
, regno
);
3124 target_store_registers (struct regcache
*regcache
, int regno
)
3126 struct target_ops
*t
;
3128 if (!may_write_registers
)
3129 error (_("Writing to registers is not allowed (regno %d)"), regno
);
3131 current_target
.to_store_registers (¤t_target
, regcache
, regno
);
3134 debug_print_register ("target_store_registers", regcache
, regno
);
3139 target_core_of_thread (ptid_t ptid
)
3141 return current_target
.to_core_of_thread (¤t_target
, ptid
);
3145 simple_verify_memory (struct target_ops
*ops
,
3146 const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
3148 LONGEST total_xfered
= 0;
3150 while (total_xfered
< size
)
3152 ULONGEST xfered_len
;
3153 enum target_xfer_status status
;
3155 ULONGEST howmuch
= min (sizeof (buf
), size
- total_xfered
);
3157 status
= target_xfer_partial (ops
, TARGET_OBJECT_MEMORY
, NULL
,
3158 buf
, NULL
, lma
+ total_xfered
, howmuch
,
3160 if (status
== TARGET_XFER_OK
3161 && memcmp (data
+ total_xfered
, buf
, xfered_len
) == 0)
3163 total_xfered
+= xfered_len
;
3172 /* Default implementation of memory verification. */
3175 default_verify_memory (struct target_ops
*self
,
3176 const gdb_byte
*data
, CORE_ADDR memaddr
, ULONGEST size
)
3178 /* Start over from the top of the target stack. */
3179 return simple_verify_memory (current_target
.beneath
,
3180 data
, memaddr
, size
);
3184 target_verify_memory (const gdb_byte
*data
, CORE_ADDR memaddr
, ULONGEST size
)
3186 return current_target
.to_verify_memory (¤t_target
,
3187 data
, memaddr
, size
);
3190 /* The documentation for this function is in its prototype declaration in
3194 target_insert_mask_watchpoint (CORE_ADDR addr
, CORE_ADDR mask
, int rw
)
3196 return current_target
.to_insert_mask_watchpoint (¤t_target
,
3200 /* The documentation for this function is in its prototype declaration in
3204 target_remove_mask_watchpoint (CORE_ADDR addr
, CORE_ADDR mask
, int rw
)
3206 return current_target
.to_remove_mask_watchpoint (¤t_target
,
3210 /* The documentation for this function is in its prototype declaration
3214 target_masked_watch_num_registers (CORE_ADDR addr
, CORE_ADDR mask
)
3216 return current_target
.to_masked_watch_num_registers (¤t_target
,
3220 /* The documentation for this function is in its prototype declaration
3224 target_ranged_break_num_registers (void)
3226 return current_target
.to_ranged_break_num_registers (¤t_target
);
3231 struct btrace_target_info
*
3232 target_enable_btrace (ptid_t ptid
)
3234 return current_target
.to_enable_btrace (¤t_target
, ptid
);
3240 target_disable_btrace (struct btrace_target_info
*btinfo
)
3242 current_target
.to_disable_btrace (¤t_target
, btinfo
);
3248 target_teardown_btrace (struct btrace_target_info
*btinfo
)
3250 current_target
.to_teardown_btrace (¤t_target
, btinfo
);
3256 target_read_btrace (VEC (btrace_block_s
) **btrace
,
3257 struct btrace_target_info
*btinfo
,
3258 enum btrace_read_type type
)
3260 return current_target
.to_read_btrace (¤t_target
, btrace
, btinfo
, type
);
3266 target_stop_recording (void)
3268 current_target
.to_stop_recording (¤t_target
);
3274 target_save_record (const char *filename
)
3276 current_target
.to_save_record (¤t_target
, filename
);
3282 target_supports_delete_record (void)
3284 struct target_ops
*t
;
3286 for (t
= current_target
.beneath
; t
!= NULL
; t
= t
->beneath
)
3287 if (t
->to_delete_record
!= delegate_delete_record
3288 && t
->to_delete_record
!= tdefault_delete_record
)
3297 target_delete_record (void)
3299 current_target
.to_delete_record (¤t_target
);
3305 target_record_is_replaying (void)
3307 return current_target
.to_record_is_replaying (¤t_target
);
3313 target_goto_record_begin (void)
3315 current_target
.to_goto_record_begin (¤t_target
);
3321 target_goto_record_end (void)
3323 current_target
.to_goto_record_end (¤t_target
);
3329 target_goto_record (ULONGEST insn
)
3331 current_target
.to_goto_record (¤t_target
, insn
);
3337 target_insn_history (int size
, int flags
)
3339 current_target
.to_insn_history (¤t_target
, size
, flags
);
3345 target_insn_history_from (ULONGEST from
, int size
, int flags
)
3347 current_target
.to_insn_history_from (¤t_target
, from
, size
, flags
);
3353 target_insn_history_range (ULONGEST begin
, ULONGEST end
, int flags
)
3355 current_target
.to_insn_history_range (¤t_target
, begin
, end
, flags
);
3361 target_call_history (int size
, int flags
)
3363 current_target
.to_call_history (¤t_target
, size
, flags
);
3369 target_call_history_from (ULONGEST begin
, int size
, int flags
)
3371 current_target
.to_call_history_from (¤t_target
, begin
, size
, flags
);
3377 target_call_history_range (ULONGEST begin
, ULONGEST end
, int flags
)
3379 current_target
.to_call_history_range (¤t_target
, begin
, end
, flags
);
3384 const struct frame_unwind
*
3385 target_get_unwinder (void)
3387 return current_target
.to_get_unwinder (¤t_target
);
3392 const struct frame_unwind
*
3393 target_get_tailcall_unwinder (void)
3395 return current_target
.to_get_tailcall_unwinder (¤t_target
);
3398 /* Default implementation of to_decr_pc_after_break. */
3401 default_target_decr_pc_after_break (struct target_ops
*ops
,
3402 struct gdbarch
*gdbarch
)
3404 return gdbarch_decr_pc_after_break (gdbarch
);
3410 target_decr_pc_after_break (struct gdbarch
*gdbarch
)
3412 return current_target
.to_decr_pc_after_break (¤t_target
, gdbarch
);
3418 target_prepare_to_generate_core (void)
3420 current_target
.to_prepare_to_generate_core (¤t_target
);
3426 target_done_generating_core (void)
3428 current_target
.to_done_generating_core (¤t_target
);
3432 setup_target_debug (void)
3434 memcpy (&debug_target
, ¤t_target
, sizeof debug_target
);
3436 init_debug_target (¤t_target
);
3440 static char targ_desc
[] =
3441 "Names of targets and files being debugged.\nShows the entire \
3442 stack of targets currently in use (including the exec-file,\n\
3443 core-file, and process, if any), as well as the symbol file name.";
3446 default_rcmd (struct target_ops
*self
, const char *command
,
3447 struct ui_file
*output
)
3449 error (_("\"monitor\" command not supported by this target."));
3453 do_monitor_command (char *cmd
,
3456 target_rcmd (cmd
, gdb_stdtarg
);
3459 /* Print the name of each layers of our target stack. */
3462 maintenance_print_target_stack (char *cmd
, int from_tty
)
3464 struct target_ops
*t
;
3466 printf_filtered (_("The current target stack is:\n"));
3468 for (t
= target_stack
; t
!= NULL
; t
= t
->beneath
)
3470 printf_filtered (" - %s (%s)\n", t
->to_shortname
, t
->to_longname
);
3474 /* Controls if targets can report that they can/are async. This is
3475 just for maintainers to use when debugging gdb. */
3476 int target_async_permitted
= 1;
3478 /* The set command writes to this variable. If the inferior is
3479 executing, target_async_permitted is *not* updated. */
3480 static int target_async_permitted_1
= 1;
3483 maint_set_target_async_command (char *args
, int from_tty
,
3484 struct cmd_list_element
*c
)
3486 if (have_live_inferiors ())
3488 target_async_permitted_1
= target_async_permitted
;
3489 error (_("Cannot change this setting while the inferior is running."));
3492 target_async_permitted
= target_async_permitted_1
;
3496 maint_show_target_async_command (struct ui_file
*file
, int from_tty
,
3497 struct cmd_list_element
*c
,
3500 fprintf_filtered (file
,
3501 _("Controlling the inferior in "
3502 "asynchronous mode is %s.\n"), value
);
3505 /* Temporary copies of permission settings. */
3507 static int may_write_registers_1
= 1;
3508 static int may_write_memory_1
= 1;
3509 static int may_insert_breakpoints_1
= 1;
3510 static int may_insert_tracepoints_1
= 1;
3511 static int may_insert_fast_tracepoints_1
= 1;
3512 static int may_stop_1
= 1;
3514 /* Make the user-set values match the real values again. */
3517 update_target_permissions (void)
3519 may_write_registers_1
= may_write_registers
;
3520 may_write_memory_1
= may_write_memory
;
3521 may_insert_breakpoints_1
= may_insert_breakpoints
;
3522 may_insert_tracepoints_1
= may_insert_tracepoints
;
3523 may_insert_fast_tracepoints_1
= may_insert_fast_tracepoints
;
3524 may_stop_1
= may_stop
;
3527 /* The one function handles (most of) the permission flags in the same
3531 set_target_permissions (char *args
, int from_tty
,
3532 struct cmd_list_element
*c
)
3534 if (target_has_execution
)
3536 update_target_permissions ();
3537 error (_("Cannot change this setting while the inferior is running."));
3540 /* Make the real values match the user-changed values. */
3541 may_write_registers
= may_write_registers_1
;
3542 may_insert_breakpoints
= may_insert_breakpoints_1
;
3543 may_insert_tracepoints
= may_insert_tracepoints_1
;
3544 may_insert_fast_tracepoints
= may_insert_fast_tracepoints_1
;
3545 may_stop
= may_stop_1
;
3546 update_observer_mode ();
3549 /* Set memory write permission independently of observer mode. */
3552 set_write_memory_permission (char *args
, int from_tty
,
3553 struct cmd_list_element
*c
)
3555 /* Make the real values match the user-changed values. */
3556 may_write_memory
= may_write_memory_1
;
3557 update_observer_mode ();
3562 initialize_targets (void)
3564 init_dummy_target ();
3565 push_target (&dummy_target
);
3567 add_info ("target", target_info
, targ_desc
);
3568 add_info ("files", target_info
, targ_desc
);
3570 add_setshow_zuinteger_cmd ("target", class_maintenance
, &targetdebug
, _("\
3571 Set target debugging."), _("\
3572 Show target debugging."), _("\
3573 When non-zero, target debugging is enabled. Higher numbers are more\n\
3577 &setdebuglist
, &showdebuglist
);
3579 add_setshow_boolean_cmd ("trust-readonly-sections", class_support
,
3580 &trust_readonly
, _("\
3581 Set mode for reading from readonly sections."), _("\
3582 Show mode for reading from readonly sections."), _("\
3583 When this mode is on, memory reads from readonly sections (such as .text)\n\
3584 will be read from the object file instead of from the target. This will\n\
3585 result in significant performance improvement for remote targets."),
3587 show_trust_readonly
,
3588 &setlist
, &showlist
);
3590 add_com ("monitor", class_obscure
, do_monitor_command
,
3591 _("Send a command to the remote monitor (remote targets only)."));
3593 add_cmd ("target-stack", class_maintenance
, maintenance_print_target_stack
,
3594 _("Print the name of each layer of the internal target stack."),
3595 &maintenanceprintlist
);
3597 add_setshow_boolean_cmd ("target-async", no_class
,
3598 &target_async_permitted_1
, _("\
3599 Set whether gdb controls the inferior in asynchronous mode."), _("\
3600 Show whether gdb controls the inferior in asynchronous mode."), _("\
3601 Tells gdb whether to control the inferior in asynchronous mode."),
3602 maint_set_target_async_command
,
3603 maint_show_target_async_command
,
3604 &maintenance_set_cmdlist
,
3605 &maintenance_show_cmdlist
);
3607 add_setshow_boolean_cmd ("may-write-registers", class_support
,
3608 &may_write_registers_1
, _("\
3609 Set permission to write into registers."), _("\
3610 Show permission to write into registers."), _("\
3611 When this permission is on, GDB may write into the target's registers.\n\
3612 Otherwise, any sort of write attempt will result in an error."),
3613 set_target_permissions
, NULL
,
3614 &setlist
, &showlist
);
3616 add_setshow_boolean_cmd ("may-write-memory", class_support
,
3617 &may_write_memory_1
, _("\
3618 Set permission to write into target memory."), _("\
3619 Show permission to write into target memory."), _("\
3620 When this permission is on, GDB may write into the target's memory.\n\
3621 Otherwise, any sort of write attempt will result in an error."),
3622 set_write_memory_permission
, NULL
,
3623 &setlist
, &showlist
);
3625 add_setshow_boolean_cmd ("may-insert-breakpoints", class_support
,
3626 &may_insert_breakpoints_1
, _("\
3627 Set permission to insert breakpoints in the target."), _("\
3628 Show permission to insert breakpoints in the target."), _("\
3629 When this permission is on, GDB may insert breakpoints in the program.\n\
3630 Otherwise, any sort of insertion attempt will result in an error."),
3631 set_target_permissions
, NULL
,
3632 &setlist
, &showlist
);
3634 add_setshow_boolean_cmd ("may-insert-tracepoints", class_support
,
3635 &may_insert_tracepoints_1
, _("\
3636 Set permission to insert tracepoints in the target."), _("\
3637 Show permission to insert tracepoints in the target."), _("\
3638 When this permission is on, GDB may insert tracepoints in the program.\n\
3639 Otherwise, any sort of insertion attempt will result in an error."),
3640 set_target_permissions
, NULL
,
3641 &setlist
, &showlist
);
3643 add_setshow_boolean_cmd ("may-insert-fast-tracepoints", class_support
,
3644 &may_insert_fast_tracepoints_1
, _("\
3645 Set permission to insert fast tracepoints in the target."), _("\
3646 Show permission to insert fast tracepoints in the target."), _("\
3647 When this permission is on, GDB may insert fast tracepoints.\n\
3648 Otherwise, any sort of insertion attempt will result in an error."),
3649 set_target_permissions
, NULL
,
3650 &setlist
, &showlist
);
3652 add_setshow_boolean_cmd ("may-interrupt", class_support
,
3654 Set permission to interrupt or signal the target."), _("\
3655 Show permission to interrupt or signal the target."), _("\
3656 When this permission is on, GDB may interrupt/stop the target's execution.\n\
3657 Otherwise, any attempt to interrupt or stop will be ignored."),
3658 set_target_permissions
, NULL
,
3659 &setlist
, &showlist
);
3661 add_setshow_boolean_cmd ("auto-connect-native-target", class_support
,
3662 &auto_connect_native_target
, _("\
3663 Set whether GDB may automatically connect to the native target."), _("\
3664 Show whether GDB may automatically connect to the native target."), _("\
3665 When on, and GDB is not connected to a target yet, GDB\n\
3666 attempts \"run\" and other commands with the native target."),
3667 NULL
, show_auto_connect_native_target
,
3668 &setlist
, &showlist
);