1 /* Remote target communications for serial-line targets in custom GDB protocol
3 Copyright (C) 1988-2022 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* See the GDB User Guide for details of the GDB remote protocol. */
30 #include "process-stratum-target.h"
33 #include "gdb-stabs.h"
34 #include "gdbthread.h"
36 #include "remote-notif.h"
39 #include "observable.h"
41 #include "cli/cli-decode.h"
42 #include "cli/cli-setshow.h"
43 #include "target-descriptions.h"
45 #include "gdbsupport/filestuff.h"
46 #include "gdbsupport/rsp-low.h"
50 #include "gdbsupport/gdb_sys_time.h"
52 #include "gdbsupport/event-loop.h"
53 #include "event-top.h"
61 #include "remote-fileio.h"
62 #include "gdb/fileio.h"
64 #include "xml-support.h"
66 #include "memory-map.h"
68 #include "tracepoint.h"
71 #include "gdbsupport/agent.h"
73 #include "record-btrace.h"
75 #include "gdbsupport/scoped_restore.h"
76 #include "gdbsupport/environ.h"
77 #include "gdbsupport/byte-vector.h"
78 #include "gdbsupport/search.h"
80 #include <unordered_map>
81 #include "async-event.h"
82 #include "gdbsupport/selftest.h"
84 /* The remote target. */
86 static const char remote_doc
[] = N_("\
87 Use a remote computer via a serial line, using a gdb-specific protocol.\n\
88 Specify the serial device it is connected to\n\
89 (e.g. /dev/ttyS0, /dev/ttya, COM1, etc.).");
93 bool remote_debug
= false;
95 #define OPAQUETHREADBYTES 8
97 /* a 64 bit opaque identifier */
98 typedef unsigned char threadref
[OPAQUETHREADBYTES
];
100 struct gdb_ext_thread_info
;
101 struct threads_listing_context
;
102 typedef int (*rmt_thread_action
) (threadref
*ref
, void *context
);
103 struct protocol_feature
;
107 typedef std::unique_ptr
<stop_reply
> stop_reply_up
;
109 /* Generic configuration support for packets the stub optionally
110 supports. Allows the user to specify the use of the packet as well
111 as allowing GDB to auto-detect support in the remote stub. */
115 PACKET_SUPPORT_UNKNOWN
= 0,
120 /* Analyze a packet's return value and update the packet config
130 struct threads_listing_context
;
132 /* Stub vCont actions support.
134 Each field is a boolean flag indicating whether the stub reports
135 support for the corresponding action. */
137 struct vCont_action_support
152 /* About this many threadids fit in a packet. */
154 #define MAXTHREADLISTRESULTS 32
156 /* Data for the vFile:pread readahead cache. */
158 struct readahead_cache
160 /* Invalidate the readahead cache. */
163 /* Invalidate the readahead cache if it is holding data for FD. */
164 void invalidate_fd (int fd
);
166 /* Serve pread from the readahead cache. Returns number of bytes
167 read, or 0 if the request can't be served from the cache. */
168 int pread (int fd
, gdb_byte
*read_buf
, size_t len
, ULONGEST offset
);
170 /* The file descriptor for the file that is being cached. -1 if the
174 /* The offset into the file that the cache buffer corresponds
178 /* The buffer holding the cache contents. */
179 gdb_byte
*buf
= nullptr;
180 /* The buffer's size. We try to read as much as fits into a packet
184 /* Cache hit and miss counters. */
185 ULONGEST hit_count
= 0;
186 ULONGEST miss_count
= 0;
189 /* Description of the remote protocol for a given architecture. */
193 long offset
; /* Offset into G packet. */
194 long regnum
; /* GDB's internal register number. */
195 LONGEST pnum
; /* Remote protocol register number. */
196 int in_g_packet
; /* Always part of G packet. */
197 /* long size in bytes; == register_size (target_gdbarch (), regnum);
199 /* char *name; == gdbarch_register_name (target_gdbarch (), regnum);
203 struct remote_arch_state
205 explicit remote_arch_state (struct gdbarch
*gdbarch
);
207 /* Description of the remote protocol registers. */
208 long sizeof_g_packet
;
210 /* Description of the remote protocol registers indexed by REGNUM
211 (making an array gdbarch_num_regs in size). */
212 std::unique_ptr
<packet_reg
[]> regs
;
214 /* This is the size (in chars) of the first response to the ``g''
215 packet. It is used as a heuristic when determining the maximum
216 size of memory-read and memory-write packets. A target will
217 typically only reserve a buffer large enough to hold the ``g''
218 packet. The size does not include packet overhead (headers and
220 long actual_register_packet_size
;
222 /* This is the maximum size (in chars) of a non read/write packet.
223 It is also used as a cap on the size of read/write packets. */
224 long remote_packet_size
;
227 /* Description of the remote protocol state for the currently
228 connected target. This is per-target state, and independent of the
229 selected architecture. */
238 /* Get the remote arch state for GDBARCH. */
239 struct remote_arch_state
*get_remote_arch_state (struct gdbarch
*gdbarch
);
243 /* A buffer to use for incoming packets, and its current size. The
244 buffer is grown dynamically for larger incoming packets.
245 Outgoing packets may also be constructed in this buffer.
246 The size of the buffer is always at least REMOTE_PACKET_SIZE;
247 REMOTE_PACKET_SIZE should be used to limit the length of outgoing
249 gdb::char_vector buf
;
251 /* True if we're going through initial connection setup (finding out
252 about the remote side's threads, relocating symbols, etc.). */
253 bool starting_up
= false;
255 /* If we negotiated packet size explicitly (and thus can bypass
256 heuristics for the largest packet size that will not overflow
257 a buffer in the stub), this will be set to that packet size.
258 Otherwise zero, meaning to use the guessed size. */
259 long explicit_packet_size
= 0;
261 /* remote_wait is normally called when the target is running and
262 waits for a stop reply packet. But sometimes we need to call it
263 when the target is already stopped. We can send a "?" packet
264 and have remote_wait read the response. Or, if we already have
265 the response, we can stash it in BUF and tell remote_wait to
266 skip calling getpkt. This flag is set when BUF contains a
267 stop reply packet and the target is not waiting. */
268 int cached_wait_status
= 0;
270 /* True, if in no ack mode. That is, neither GDB nor the stub will
271 expect acks from each other. The connection is assumed to be
273 bool noack_mode
= false;
275 /* True if we're connected in extended remote mode. */
276 bool extended
= false;
278 /* True if we resumed the target and we're waiting for the target to
279 stop. In the mean time, we can't start another command/query.
280 The remote server wouldn't be ready to process it, so we'd
281 timeout waiting for a reply that would never come and eventually
282 we'd close the connection. This can happen in asynchronous mode
283 because we allow GDB commands while the target is running. */
284 bool waiting_for_stop_reply
= false;
286 /* The status of the stub support for the various vCont actions. */
287 vCont_action_support supports_vCont
;
288 /* Whether vCont support was probed already. This is a workaround
289 until packet_support is per-connection. */
290 bool supports_vCont_probed
;
292 /* True if the user has pressed Ctrl-C, but the target hasn't
293 responded to that. */
294 bool ctrlc_pending_p
= false;
296 /* True if we saw a Ctrl-C while reading or writing from/to the
297 remote descriptor. At that point it is not safe to send a remote
298 interrupt packet, so we instead remember we saw the Ctrl-C and
299 process it once we're done with sending/receiving the current
300 packet, which should be shortly. If however that takes too long,
301 and the user presses Ctrl-C again, we offer to disconnect. */
302 bool got_ctrlc_during_io
= false;
304 /* Descriptor for I/O to remote machine. Initialize it to NULL so that
305 remote_open knows that we don't have a file open when the program
307 struct serial
*remote_desc
= nullptr;
309 /* These are the threads which we last sent to the remote system. The
310 TID member will be -1 for all or -2 for not sent yet. */
311 ptid_t general_thread
= null_ptid
;
312 ptid_t continue_thread
= null_ptid
;
314 /* This is the traceframe which we last selected on the remote system.
315 It will be -1 if no traceframe is selected. */
316 int remote_traceframe_number
= -1;
318 char *last_pass_packet
= nullptr;
320 /* The last QProgramSignals packet sent to the target. We bypass
321 sending a new program signals list down to the target if the new
322 packet is exactly the same as the last we sent. IOW, we only let
323 the target know about program signals list changes. */
324 char *last_program_signals_packet
= nullptr;
326 gdb_signal last_sent_signal
= GDB_SIGNAL_0
;
328 bool last_sent_step
= false;
330 /* The execution direction of the last resume we got. */
331 exec_direction_kind last_resume_exec_dir
= EXEC_FORWARD
;
333 char *finished_object
= nullptr;
334 char *finished_annex
= nullptr;
335 ULONGEST finished_offset
= 0;
337 /* Should we try the 'ThreadInfo' query packet?
339 This variable (NOT available to the user: auto-detect only!)
340 determines whether GDB will use the new, simpler "ThreadInfo"
341 query or the older, more complex syntax for thread queries.
342 This is an auto-detect variable (set to true at each connect,
343 and set to false when the target fails to recognize it). */
344 bool use_threadinfo_query
= false;
345 bool use_threadextra_query
= false;
347 threadref echo_nextthread
{};
348 threadref nextthread
{};
349 threadref resultthreadlist
[MAXTHREADLISTRESULTS
] {};
351 /* The state of remote notification. */
352 struct remote_notif_state
*notif_state
= nullptr;
354 /* The branch trace configuration. */
355 struct btrace_config btrace_config
{};
357 /* The argument to the last "vFile:setfs:" packet we sent, used
358 to avoid sending repeated unnecessary "vFile:setfs:" packets.
359 Initialized to -1 to indicate that no "vFile:setfs:" packet
360 has yet been sent. */
363 /* A readahead cache for vFile:pread. Often, reading a binary
364 involves a sequence of small reads. E.g., when parsing an ELF
365 file. A readahead cache helps mostly the case of remote
366 debugging on a connection with higher latency, due to the
367 request/reply nature of the RSP. We only cache data for a single
368 file descriptor at a time. */
369 struct readahead_cache readahead_cache
;
371 /* The list of already fetched and acknowledged stop events. This
372 queue is used for notification Stop, and other notifications
373 don't need queue for their events, because the notification
374 events of Stop can't be consumed immediately, so that events
375 should be queued first, and be consumed by remote_wait_{ns,as}
376 one per time. Other notifications can consume their events
377 immediately, so queue is not needed for them. */
378 std::vector
<stop_reply_up
> stop_reply_queue
;
380 /* Asynchronous signal handle registered as event loop source for
381 when we have pending events ready to be passed to the core. */
382 struct async_event_handler
*remote_async_inferior_event_token
= nullptr;
384 /* FIXME: cagney/1999-09-23: Even though getpkt was called with
385 ``forever'' still use the normal timeout mechanism. This is
386 currently used by the ASYNC code to guarentee that target reads
387 during the initial connect always time-out. Once getpkt has been
388 modified to return a timeout indication and, in turn
389 remote_wait()/wait_for_inferior() have gained a timeout parameter
391 int wait_forever_enabled_p
= 1;
394 /* Mapping of remote protocol data for each gdbarch. Usually there
395 is only one entry here, though we may see more with stubs that
396 support multi-process. */
397 std::unordered_map
<struct gdbarch
*, remote_arch_state
>
401 static const target_info remote_target_info
= {
403 N_("Remote serial target in gdb-specific protocol"),
407 class remote_target
: public process_stratum_target
410 remote_target () = default;
411 ~remote_target () override
;
413 const target_info
&info () const override
414 { return remote_target_info
; }
416 const char *connection_string () override
;
418 thread_control_capabilities
get_thread_control_capabilities () override
419 { return tc_schedlock
; }
421 /* Open a remote connection. */
422 static void open (const char *, int);
424 void close () override
;
426 void detach (inferior
*, int) override
;
427 void disconnect (const char *, int) override
;
429 void commit_resumed () override
;
430 void resume (ptid_t
, int, enum gdb_signal
) override
;
431 ptid_t
wait (ptid_t
, struct target_waitstatus
*, target_wait_flags
) override
;
432 bool has_pending_events () override
;
434 void fetch_registers (struct regcache
*, int) override
;
435 void store_registers (struct regcache
*, int) override
;
436 void prepare_to_store (struct regcache
*) override
;
438 void files_info () override
;
440 int insert_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
442 int remove_breakpoint (struct gdbarch
*, struct bp_target_info
*,
443 enum remove_bp_reason
) override
;
446 bool stopped_by_sw_breakpoint () override
;
447 bool supports_stopped_by_sw_breakpoint () override
;
449 bool stopped_by_hw_breakpoint () override
;
451 bool supports_stopped_by_hw_breakpoint () override
;
453 bool stopped_by_watchpoint () override
;
455 bool stopped_data_address (CORE_ADDR
*) override
;
457 bool watchpoint_addr_within_range (CORE_ADDR
, CORE_ADDR
, int) override
;
459 int can_use_hw_breakpoint (enum bptype
, int, int) override
;
461 int insert_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
463 int remove_hw_breakpoint (struct gdbarch
*, struct bp_target_info
*) override
;
465 int region_ok_for_hw_watchpoint (CORE_ADDR
, int) override
;
467 int insert_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
468 struct expression
*) override
;
470 int remove_watchpoint (CORE_ADDR
, int, enum target_hw_bp_type
,
471 struct expression
*) override
;
473 void kill () override
;
475 void load (const char *, int) override
;
477 void mourn_inferior () override
;
479 void pass_signals (gdb::array_view
<const unsigned char>) override
;
481 int set_syscall_catchpoint (int, bool, int,
482 gdb::array_view
<const int>) override
;
484 void program_signals (gdb::array_view
<const unsigned char>) override
;
486 bool thread_alive (ptid_t ptid
) override
;
488 const char *thread_name (struct thread_info
*) override
;
490 void update_thread_list () override
;
492 std::string
pid_to_str (ptid_t
) override
;
494 const char *extra_thread_info (struct thread_info
*) override
;
496 ptid_t
get_ada_task_ptid (long lwp
, long thread
) override
;
498 thread_info
*thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
500 inferior
*inf
) override
;
502 gdb::byte_vector
thread_info_to_thread_handle (struct thread_info
*tp
)
505 void stop (ptid_t
) override
;
507 void interrupt () override
;
509 void pass_ctrlc () override
;
511 enum target_xfer_status
xfer_partial (enum target_object object
,
514 const gdb_byte
*writebuf
,
515 ULONGEST offset
, ULONGEST len
,
516 ULONGEST
*xfered_len
) override
;
518 ULONGEST
get_memory_xfer_limit () override
;
520 void rcmd (const char *command
, struct ui_file
*output
) override
;
522 char *pid_to_exec_file (int pid
) override
;
524 void log_command (const char *cmd
) override
526 serial_log_command (this, cmd
);
529 CORE_ADDR
get_thread_local_address (ptid_t ptid
,
530 CORE_ADDR load_module_addr
,
531 CORE_ADDR offset
) override
;
533 bool can_execute_reverse () override
;
535 std::vector
<mem_region
> memory_map () override
;
537 void flash_erase (ULONGEST address
, LONGEST length
) override
;
539 void flash_done () override
;
541 const struct target_desc
*read_description () override
;
543 int search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
544 const gdb_byte
*pattern
, ULONGEST pattern_len
,
545 CORE_ADDR
*found_addrp
) override
;
547 bool can_async_p () override
;
549 bool is_async_p () override
;
551 void async (int) override
;
553 int async_wait_fd () override
;
555 void thread_events (int) override
;
557 int can_do_single_step () override
;
559 void terminal_inferior () override
;
561 void terminal_ours () override
;
563 bool supports_non_stop () override
;
565 bool supports_multi_process () override
;
567 bool supports_disable_randomization () override
;
569 bool filesystem_is_local () override
;
572 int fileio_open (struct inferior
*inf
, const char *filename
,
573 int flags
, int mode
, int warn_if_slow
,
574 int *target_errno
) override
;
576 int fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
577 ULONGEST offset
, int *target_errno
) override
;
579 int fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
580 ULONGEST offset
, int *target_errno
) override
;
582 int fileio_fstat (int fd
, struct stat
*sb
, int *target_errno
) override
;
584 int fileio_close (int fd
, int *target_errno
) override
;
586 int fileio_unlink (struct inferior
*inf
,
587 const char *filename
,
588 int *target_errno
) override
;
590 gdb::optional
<std::string
>
591 fileio_readlink (struct inferior
*inf
,
592 const char *filename
,
593 int *target_errno
) override
;
595 bool supports_enable_disable_tracepoint () override
;
597 bool supports_string_tracing () override
;
599 bool supports_evaluation_of_breakpoint_conditions () override
;
601 bool can_run_breakpoint_commands () override
;
603 void trace_init () override
;
605 void download_tracepoint (struct bp_location
*location
) override
;
607 bool can_download_tracepoint () override
;
609 void download_trace_state_variable (const trace_state_variable
&tsv
) override
;
611 void enable_tracepoint (struct bp_location
*location
) override
;
613 void disable_tracepoint (struct bp_location
*location
) override
;
615 void trace_set_readonly_regions () override
;
617 void trace_start () override
;
619 int get_trace_status (struct trace_status
*ts
) override
;
621 void get_tracepoint_status (struct breakpoint
*tp
, struct uploaded_tp
*utp
)
624 void trace_stop () override
;
626 int trace_find (enum trace_find_type type
, int num
,
627 CORE_ADDR addr1
, CORE_ADDR addr2
, int *tpp
) override
;
629 bool get_trace_state_variable_value (int tsv
, LONGEST
*val
) override
;
631 int save_trace_data (const char *filename
) override
;
633 int upload_tracepoints (struct uploaded_tp
**utpp
) override
;
635 int upload_trace_state_variables (struct uploaded_tsv
**utsvp
) override
;
637 LONGEST
get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
) override
;
639 int get_min_fast_tracepoint_insn_len () override
;
641 void set_disconnected_tracing (int val
) override
;
643 void set_circular_trace_buffer (int val
) override
;
645 void set_trace_buffer_size (LONGEST val
) override
;
647 bool set_trace_notes (const char *user
, const char *notes
,
648 const char *stopnotes
) override
;
650 int core_of_thread (ptid_t ptid
) override
;
652 int verify_memory (const gdb_byte
*data
,
653 CORE_ADDR memaddr
, ULONGEST size
) override
;
656 bool get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
) override
;
658 void set_permissions () override
;
660 bool static_tracepoint_marker_at (CORE_ADDR
,
661 struct static_tracepoint_marker
*marker
)
664 std::vector
<static_tracepoint_marker
>
665 static_tracepoint_markers_by_strid (const char *id
) override
;
667 traceframe_info_up
traceframe_info () override
;
669 bool use_agent (bool use
) override
;
670 bool can_use_agent () override
;
672 struct btrace_target_info
*enable_btrace (ptid_t ptid
,
673 const struct btrace_config
*conf
) override
;
675 void disable_btrace (struct btrace_target_info
*tinfo
) override
;
677 void teardown_btrace (struct btrace_target_info
*tinfo
) override
;
679 enum btrace_error
read_btrace (struct btrace_data
*data
,
680 struct btrace_target_info
*btinfo
,
681 enum btrace_read_type type
) override
;
683 const struct btrace_config
*btrace_conf (const struct btrace_target_info
*) override
;
684 bool augmented_libraries_svr4_read () override
;
685 void follow_fork (bool, bool) override
;
686 void follow_exec (inferior
*, ptid_t
, const char *) override
;
687 int insert_fork_catchpoint (int) override
;
688 int remove_fork_catchpoint (int) override
;
689 int insert_vfork_catchpoint (int) override
;
690 int remove_vfork_catchpoint (int) override
;
691 int insert_exec_catchpoint (int) override
;
692 int remove_exec_catchpoint (int) override
;
693 enum exec_direction_kind
execution_direction () override
;
695 bool supports_memory_tagging () override
;
697 bool fetch_memtags (CORE_ADDR address
, size_t len
,
698 gdb::byte_vector
&tags
, int type
) override
;
700 bool store_memtags (CORE_ADDR address
, size_t len
,
701 const gdb::byte_vector
&tags
, int type
) override
;
703 public: /* Remote specific methods. */
705 void remote_download_command_source (int num
, ULONGEST addr
,
706 struct command_line
*cmds
);
708 void remote_file_put (const char *local_file
, const char *remote_file
,
710 void remote_file_get (const char *remote_file
, const char *local_file
,
712 void remote_file_delete (const char *remote_file
, int from_tty
);
714 int remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
715 ULONGEST offset
, int *remote_errno
);
716 int remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
717 ULONGEST offset
, int *remote_errno
);
718 int remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
719 ULONGEST offset
, int *remote_errno
);
721 int remote_hostio_send_command (int command_bytes
, int which_packet
,
722 int *remote_errno
, const char **attachment
,
723 int *attachment_len
);
724 int remote_hostio_set_filesystem (struct inferior
*inf
,
726 /* We should get rid of this and use fileio_open directly. */
727 int remote_hostio_open (struct inferior
*inf
, const char *filename
,
728 int flags
, int mode
, int warn_if_slow
,
730 int remote_hostio_close (int fd
, int *remote_errno
);
732 int remote_hostio_unlink (inferior
*inf
, const char *filename
,
735 struct remote_state
*get_remote_state ();
737 long get_remote_packet_size (void);
738 long get_memory_packet_size (struct memory_packet_config
*config
);
740 long get_memory_write_packet_size ();
741 long get_memory_read_packet_size ();
743 char *append_pending_thread_resumptions (char *p
, char *endp
,
745 static void open_1 (const char *name
, int from_tty
, int extended_p
);
746 void start_remote (int from_tty
, int extended_p
);
747 void remote_detach_1 (struct inferior
*inf
, int from_tty
);
749 char *append_resumption (char *p
, char *endp
,
750 ptid_t ptid
, int step
, gdb_signal siggnal
);
751 int remote_resume_with_vcont (ptid_t ptid
, int step
,
754 thread_info
*add_current_inferior_and_thread (const char *wait_status
);
756 ptid_t
wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
757 target_wait_flags options
);
758 ptid_t
wait_as (ptid_t ptid
, target_waitstatus
*status
,
759 target_wait_flags options
);
761 ptid_t
process_stop_reply (struct stop_reply
*stop_reply
,
762 target_waitstatus
*status
);
764 ptid_t select_thread_for_ambiguous_stop_reply
765 (const struct target_waitstatus
*status
);
767 void remote_notice_new_inferior (ptid_t currthread
, bool executing
);
769 void process_initial_stop_replies (int from_tty
);
771 thread_info
*remote_add_thread (ptid_t ptid
, bool running
, bool executing
,
774 void btrace_sync_conf (const btrace_config
*conf
);
776 void remote_btrace_maybe_reopen ();
778 void remove_new_fork_children (threads_listing_context
*context
);
779 void kill_new_fork_children (int pid
);
780 void discard_pending_stop_replies (struct inferior
*inf
);
781 int stop_reply_queue_length ();
783 void check_pending_events_prevent_wildcard_vcont
784 (bool *may_global_wildcard_vcont
);
786 void discard_pending_stop_replies_in_queue ();
787 struct stop_reply
*remote_notif_remove_queued_reply (ptid_t ptid
);
788 struct stop_reply
*queued_stop_reply (ptid_t ptid
);
789 int peek_stop_reply (ptid_t ptid
);
790 void remote_parse_stop_reply (const char *buf
, stop_reply
*event
);
792 void remote_stop_ns (ptid_t ptid
);
793 void remote_interrupt_as ();
794 void remote_interrupt_ns ();
796 char *remote_get_noisy_reply ();
797 int remote_query_attached (int pid
);
798 inferior
*remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
801 ptid_t
remote_current_thread (ptid_t oldpid
);
802 ptid_t
get_current_thread (const char *wait_status
);
804 void set_thread (ptid_t ptid
, int gen
);
805 void set_general_thread (ptid_t ptid
);
806 void set_continue_thread (ptid_t ptid
);
807 void set_general_process ();
809 char *write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
);
811 int remote_unpack_thread_info_response (const char *pkt
, threadref
*expectedref
,
812 gdb_ext_thread_info
*info
);
813 int remote_get_threadinfo (threadref
*threadid
, int fieldset
,
814 gdb_ext_thread_info
*info
);
816 int parse_threadlist_response (const char *pkt
, int result_limit
,
817 threadref
*original_echo
,
818 threadref
*resultlist
,
820 int remote_get_threadlist (int startflag
, threadref
*nextthread
,
821 int result_limit
, int *done
, int *result_count
,
822 threadref
*threadlist
);
824 int remote_threadlist_iterator (rmt_thread_action stepfunction
,
825 void *context
, int looplimit
);
827 int remote_get_threads_with_ql (threads_listing_context
*context
);
828 int remote_get_threads_with_qxfer (threads_listing_context
*context
);
829 int remote_get_threads_with_qthreadinfo (threads_listing_context
*context
);
831 void extended_remote_restart ();
835 void remote_check_symbols ();
837 void remote_supported_packet (const struct protocol_feature
*feature
,
838 enum packet_support support
,
839 const char *argument
);
841 void remote_query_supported ();
843 void remote_packet_size (const protocol_feature
*feature
,
844 packet_support support
, const char *value
);
846 void remote_serial_quit_handler ();
848 void remote_detach_pid (int pid
);
850 void remote_vcont_probe ();
852 void remote_resume_with_hc (ptid_t ptid
, int step
,
855 void send_interrupt_sequence ();
856 void interrupt_query ();
858 void remote_notif_get_pending_events (notif_client
*nc
);
860 int fetch_register_using_p (struct regcache
*regcache
,
862 int send_g_packet ();
863 void process_g_packet (struct regcache
*regcache
);
864 void fetch_registers_using_g (struct regcache
*regcache
);
865 int store_register_using_P (const struct regcache
*regcache
,
867 void store_registers_using_G (const struct regcache
*regcache
);
869 void set_remote_traceframe ();
871 void check_binary_download (CORE_ADDR addr
);
873 target_xfer_status
remote_write_bytes_aux (const char *header
,
875 const gdb_byte
*myaddr
,
878 ULONGEST
*xfered_len_units
,
882 target_xfer_status
remote_write_bytes (CORE_ADDR memaddr
,
883 const gdb_byte
*myaddr
, ULONGEST len
,
884 int unit_size
, ULONGEST
*xfered_len
);
886 target_xfer_status
remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
888 int unit_size
, ULONGEST
*xfered_len_units
);
890 target_xfer_status
remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
894 ULONGEST
*xfered_len
);
896 target_xfer_status
remote_read_bytes (CORE_ADDR memaddr
,
897 gdb_byte
*myaddr
, ULONGEST len
,
899 ULONGEST
*xfered_len
);
901 packet_result
remote_send_printf (const char *format
, ...)
902 ATTRIBUTE_PRINTF (2, 3);
904 target_xfer_status
remote_flash_write (ULONGEST address
,
905 ULONGEST length
, ULONGEST
*xfered_len
,
906 const gdb_byte
*data
);
908 int readchar (int timeout
);
910 void remote_serial_write (const char *str
, int len
);
912 int putpkt (const char *buf
);
913 int putpkt_binary (const char *buf
, int cnt
);
915 int putpkt (const gdb::char_vector
&buf
)
917 return putpkt (buf
.data ());
921 long read_frame (gdb::char_vector
*buf_p
);
922 void getpkt (gdb::char_vector
*buf
, int forever
);
923 int getpkt_or_notif_sane_1 (gdb::char_vector
*buf
, int forever
,
924 int expecting_notif
, int *is_notif
);
925 int getpkt_sane (gdb::char_vector
*buf
, int forever
);
926 int getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
928 int remote_vkill (int pid
);
929 void remote_kill_k ();
931 void extended_remote_disable_randomization (int val
);
932 int extended_remote_run (const std::string
&args
);
934 void send_environment_packet (const char *action
,
938 void extended_remote_environment_support ();
939 void extended_remote_set_inferior_cwd ();
941 target_xfer_status
remote_write_qxfer (const char *object_name
,
943 const gdb_byte
*writebuf
,
944 ULONGEST offset
, LONGEST len
,
945 ULONGEST
*xfered_len
,
946 struct packet_config
*packet
);
948 target_xfer_status
remote_read_qxfer (const char *object_name
,
950 gdb_byte
*readbuf
, ULONGEST offset
,
952 ULONGEST
*xfered_len
,
953 struct packet_config
*packet
);
955 void push_stop_reply (struct stop_reply
*new_event
);
957 bool vcont_r_supported ();
959 void packet_command (const char *args
, int from_tty
);
961 private: /* data fields */
963 /* The remote state. Don't reference this directly. Use the
964 get_remote_state method instead. */
965 remote_state m_remote_state
;
968 static const target_info extended_remote_target_info
= {
970 N_("Extended remote serial target in gdb-specific protocol"),
974 /* Set up the extended remote target by extending the standard remote
975 target and adding to it. */
977 class extended_remote_target final
: public remote_target
980 const target_info
&info () const override
981 { return extended_remote_target_info
; }
983 /* Open an extended-remote connection. */
984 static void open (const char *, int);
986 bool can_create_inferior () override
{ return true; }
987 void create_inferior (const char *, const std::string
&,
988 char **, int) override
;
990 void detach (inferior
*, int) override
;
992 bool can_attach () override
{ return true; }
993 void attach (const char *, int) override
;
995 void post_attach (int) override
;
996 bool supports_disable_randomization () override
;
999 /* Per-program-space data key. */
1000 static const struct program_space_key
<char, gdb::xfree_deleter
<char>>
1003 /* The variable registered as the control variable used by the
1004 remote exec-file commands. While the remote exec-file setting is
1005 per-program-space, the set/show machinery uses this as the
1006 location of the remote exec-file value. */
1007 static char *remote_exec_file_var
;
1009 /* The size to align memory write packets, when practical. The protocol
1010 does not guarantee any alignment, and gdb will generate short
1011 writes and unaligned writes, but even as a best-effort attempt this
1012 can improve bulk transfers. For instance, if a write is misaligned
1013 relative to the target's data bus, the stub may need to make an extra
1014 round trip fetching data from the target. This doesn't make a
1015 huge difference, but it's easy to do, so we try to be helpful.
1017 The alignment chosen is arbitrary; usually data bus width is
1018 important here, not the possibly larger cache line size. */
1019 enum { REMOTE_ALIGN_WRITES
= 16 };
1021 /* Prototypes for local functions. */
1023 static int hexnumlen (ULONGEST num
);
1025 static int stubhex (int ch
);
1027 static int hexnumstr (char *, ULONGEST
);
1029 static int hexnumnstr (char *, ULONGEST
, int);
1031 static CORE_ADDR
remote_address_masked (CORE_ADDR
);
1033 static void print_packet (const char *);
1035 static int stub_unpack_int (const char *buff
, int fieldlength
);
1037 struct packet_config
;
1039 static void show_packet_config_cmd (struct packet_config
*config
);
1041 static void show_remote_protocol_packet_cmd (struct ui_file
*file
,
1043 struct cmd_list_element
*c
,
1046 static ptid_t
read_ptid (const char *buf
, const char **obuf
);
1048 static void remote_async_inferior_event_handler (gdb_client_data
);
1050 static bool remote_read_description_p (struct target_ops
*target
);
1052 static void remote_console_output (const char *msg
);
1054 static void remote_btrace_reset (remote_state
*rs
);
1056 static void remote_unpush_and_throw (remote_target
*target
);
1060 static struct cmd_list_element
*remote_cmdlist
;
1062 /* For "set remote" and "show remote". */
1064 static struct cmd_list_element
*remote_set_cmdlist
;
1065 static struct cmd_list_element
*remote_show_cmdlist
;
1067 /* Controls whether GDB is willing to use range stepping. */
1069 static bool use_range_stepping
= true;
1071 /* From the remote target's point of view, each thread is in one of these three
1073 enum class resume_state
1075 /* Not resumed - we haven't been asked to resume this thread. */
1078 /* We have been asked to resume this thread, but haven't sent a vCont action
1079 for it yet. We'll need to consider it next time commit_resume is
1081 RESUMED_PENDING_VCONT
,
1083 /* We have been asked to resume this thread, and we have sent a vCont action
1088 /* Information about a thread's pending vCont-resume. Used when a thread is in
1089 the remote_resume_state::RESUMED_PENDING_VCONT state. remote_target::resume
1090 stores this information which is then picked up by
1091 remote_target::commit_resume to know which is the proper action for this
1092 thread to include in the vCont packet. */
1093 struct resumed_pending_vcont_info
1095 /* True if the last resume call for this thread was a step request, false
1096 if a continue request. */
1099 /* The signal specified in the last resume call for this thread. */
1103 /* Private data that we'll store in (struct thread_info)->priv. */
1104 struct remote_thread_info
: public private_thread_info
1110 /* Thread handle, perhaps a pthread_t or thread_t value, stored as a
1111 sequence of bytes. */
1112 gdb::byte_vector thread_handle
;
1114 /* Whether the target stopped for a breakpoint/watchpoint. */
1115 enum target_stop_reason stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
1117 /* This is set to the data address of the access causing the target
1118 to stop for a watchpoint. */
1119 CORE_ADDR watch_data_address
= 0;
1121 /* Get the thread's resume state. */
1122 enum resume_state
get_resume_state () const
1124 return m_resume_state
;
1127 /* Put the thread in the NOT_RESUMED state. */
1128 void set_not_resumed ()
1130 m_resume_state
= resume_state::NOT_RESUMED
;
1133 /* Put the thread in the RESUMED_PENDING_VCONT state. */
1134 void set_resumed_pending_vcont (bool step
, gdb_signal sig
)
1136 m_resume_state
= resume_state::RESUMED_PENDING_VCONT
;
1137 m_resumed_pending_vcont_info
.step
= step
;
1138 m_resumed_pending_vcont_info
.sig
= sig
;
1141 /* Get the information this thread's pending vCont-resumption.
1143 Must only be called if the thread is in the RESUMED_PENDING_VCONT resume
1145 const struct resumed_pending_vcont_info
&resumed_pending_vcont_info () const
1147 gdb_assert (m_resume_state
== resume_state::RESUMED_PENDING_VCONT
);
1149 return m_resumed_pending_vcont_info
;
1152 /* Put the thread in the VCONT_RESUMED state. */
1155 m_resume_state
= resume_state::RESUMED
;
1159 /* Resume state for this thread. This is used to implement vCont action
1160 coalescing (only when the target operates in non-stop mode).
1162 remote_target::resume moves the thread to the RESUMED_PENDING_VCONT state,
1163 which notes that this thread must be considered in the next commit_resume
1166 remote_target::commit_resume sends a vCont packet with actions for the
1167 threads in the RESUMED_PENDING_VCONT state and moves them to the
1168 VCONT_RESUMED state.
1170 When reporting a stop to the core for a thread, that thread is moved back
1171 to the NOT_RESUMED state. */
1172 enum resume_state m_resume_state
= resume_state::NOT_RESUMED
;
1174 /* Extra info used if the thread is in the RESUMED_PENDING_VCONT state. */
1175 struct resumed_pending_vcont_info m_resumed_pending_vcont_info
;
1178 remote_state::remote_state ()
1183 remote_state::~remote_state ()
1185 xfree (this->last_pass_packet
);
1186 xfree (this->last_program_signals_packet
);
1187 xfree (this->finished_object
);
1188 xfree (this->finished_annex
);
1191 /* Utility: generate error from an incoming stub packet. */
1193 trace_error (char *buf
)
1196 return; /* not an error msg */
1199 case '1': /* malformed packet error */
1200 if (*++buf
== '0') /* general case: */
1201 error (_("remote.c: error in outgoing packet."));
1203 error (_("remote.c: error in outgoing packet at field #%ld."),
1204 strtol (buf
, NULL
, 16));
1206 error (_("Target returns error code '%s'."), buf
);
1210 /* Utility: wait for reply from stub, while accepting "O" packets. */
1213 remote_target::remote_get_noisy_reply ()
1215 struct remote_state
*rs
= get_remote_state ();
1217 do /* Loop on reply from remote stub. */
1221 QUIT
; /* Allow user to bail out with ^C. */
1222 getpkt (&rs
->buf
, 0);
1223 buf
= rs
->buf
.data ();
1226 else if (startswith (buf
, "qRelocInsn:"))
1229 CORE_ADDR from
, to
, org_to
;
1231 int adjusted_size
= 0;
1234 p
= buf
+ strlen ("qRelocInsn:");
1235 pp
= unpack_varlen_hex (p
, &ul
);
1237 error (_("invalid qRelocInsn packet: %s"), buf
);
1241 unpack_varlen_hex (p
, &ul
);
1248 gdbarch_relocate_instruction (target_gdbarch (), &to
, from
);
1251 catch (const gdb_exception
&ex
)
1253 if (ex
.error
== MEMORY_ERROR
)
1255 /* Propagate memory errors silently back to the
1256 target. The stub may have limited the range of
1257 addresses we can write to, for example. */
1261 /* Something unexpectedly bad happened. Be verbose
1262 so we can tell what, and propagate the error back
1263 to the stub, so it doesn't get stuck waiting for
1265 exception_fprintf (gdb_stderr
, ex
,
1266 _("warning: relocating instruction: "));
1273 adjusted_size
= to
- org_to
;
1275 xsnprintf (buf
, rs
->buf
.size (), "qRelocInsn:%x", adjusted_size
);
1279 else if (buf
[0] == 'O' && buf
[1] != 'K')
1280 remote_console_output (buf
+ 1); /* 'O' message from stub */
1282 return buf
; /* Here's the actual reply. */
1287 struct remote_arch_state
*
1288 remote_state::get_remote_arch_state (struct gdbarch
*gdbarch
)
1290 remote_arch_state
*rsa
;
1292 auto it
= this->m_arch_states
.find (gdbarch
);
1293 if (it
== this->m_arch_states
.end ())
1295 auto p
= this->m_arch_states
.emplace (std::piecewise_construct
,
1296 std::forward_as_tuple (gdbarch
),
1297 std::forward_as_tuple (gdbarch
));
1298 rsa
= &p
.first
->second
;
1300 /* Make sure that the packet buffer is plenty big enough for
1301 this architecture. */
1302 if (this->buf
.size () < rsa
->remote_packet_size
)
1303 this->buf
.resize (2 * rsa
->remote_packet_size
);
1311 /* Fetch the global remote target state. */
1314 remote_target::get_remote_state ()
1316 /* Make sure that the remote architecture state has been
1317 initialized, because doing so might reallocate rs->buf. Any
1318 function which calls getpkt also needs to be mindful of changes
1319 to rs->buf, but this call limits the number of places which run
1321 m_remote_state
.get_remote_arch_state (target_gdbarch ());
1323 return &m_remote_state
;
1326 /* Fetch the remote exec-file from the current program space. */
1329 get_remote_exec_file (void)
1331 char *remote_exec_file
;
1333 remote_exec_file
= remote_pspace_data
.get (current_program_space
);
1334 if (remote_exec_file
== NULL
)
1337 return remote_exec_file
;
1340 /* Set the remote exec file for PSPACE. */
1343 set_pspace_remote_exec_file (struct program_space
*pspace
,
1344 const char *remote_exec_file
)
1346 char *old_file
= remote_pspace_data
.get (pspace
);
1349 remote_pspace_data
.set (pspace
, xstrdup (remote_exec_file
));
1352 /* The "set/show remote exec-file" set command hook. */
1355 set_remote_exec_file (const char *ignored
, int from_tty
,
1356 struct cmd_list_element
*c
)
1358 gdb_assert (remote_exec_file_var
!= NULL
);
1359 set_pspace_remote_exec_file (current_program_space
, remote_exec_file_var
);
1362 /* The "set/show remote exec-file" show command hook. */
1365 show_remote_exec_file (struct ui_file
*file
, int from_tty
,
1366 struct cmd_list_element
*cmd
, const char *value
)
1368 fprintf_filtered (file
, "%s\n", get_remote_exec_file ());
1372 map_regcache_remote_table (struct gdbarch
*gdbarch
, struct packet_reg
*regs
)
1374 int regnum
, num_remote_regs
, offset
;
1375 struct packet_reg
**remote_regs
;
1377 for (regnum
= 0; regnum
< gdbarch_num_regs (gdbarch
); regnum
++)
1379 struct packet_reg
*r
= ®s
[regnum
];
1381 if (register_size (gdbarch
, regnum
) == 0)
1382 /* Do not try to fetch zero-sized (placeholder) registers. */
1385 r
->pnum
= gdbarch_remote_register_number (gdbarch
, regnum
);
1390 /* Define the g/G packet format as the contents of each register
1391 with a remote protocol number, in order of ascending protocol
1394 remote_regs
= XALLOCAVEC (struct packet_reg
*, gdbarch_num_regs (gdbarch
));
1395 for (num_remote_regs
= 0, regnum
= 0;
1396 regnum
< gdbarch_num_regs (gdbarch
);
1398 if (regs
[regnum
].pnum
!= -1)
1399 remote_regs
[num_remote_regs
++] = ®s
[regnum
];
1401 std::sort (remote_regs
, remote_regs
+ num_remote_regs
,
1402 [] (const packet_reg
*a
, const packet_reg
*b
)
1403 { return a
->pnum
< b
->pnum
; });
1405 for (regnum
= 0, offset
= 0; regnum
< num_remote_regs
; regnum
++)
1407 remote_regs
[regnum
]->in_g_packet
= 1;
1408 remote_regs
[regnum
]->offset
= offset
;
1409 offset
+= register_size (gdbarch
, remote_regs
[regnum
]->regnum
);
1415 /* Given the architecture described by GDBARCH, return the remote
1416 protocol register's number and the register's offset in the g/G
1417 packets of GDB register REGNUM, in PNUM and POFFSET respectively.
1418 If the target does not have a mapping for REGNUM, return false,
1419 otherwise, return true. */
1422 remote_register_number_and_offset (struct gdbarch
*gdbarch
, int regnum
,
1423 int *pnum
, int *poffset
)
1425 gdb_assert (regnum
< gdbarch_num_regs (gdbarch
));
1427 std::vector
<packet_reg
> regs (gdbarch_num_regs (gdbarch
));
1429 map_regcache_remote_table (gdbarch
, regs
.data ());
1431 *pnum
= regs
[regnum
].pnum
;
1432 *poffset
= regs
[regnum
].offset
;
1437 remote_arch_state::remote_arch_state (struct gdbarch
*gdbarch
)
1439 /* Use the architecture to build a regnum<->pnum table, which will be
1440 1:1 unless a feature set specifies otherwise. */
1441 this->regs
.reset (new packet_reg
[gdbarch_num_regs (gdbarch
)] ());
1443 /* Record the maximum possible size of the g packet - it may turn out
1445 this->sizeof_g_packet
1446 = map_regcache_remote_table (gdbarch
, this->regs
.get ());
1448 /* Default maximum number of characters in a packet body. Many
1449 remote stubs have a hardwired buffer size of 400 bytes
1450 (c.f. BUFMAX in m68k-stub.c and i386-stub.c). BUFMAX-1 is used
1451 as the maximum packet-size to ensure that the packet and an extra
1452 NUL character can always fit in the buffer. This stops GDB
1453 trashing stubs that try to squeeze an extra NUL into what is
1454 already a full buffer (As of 1999-12-04 that was most stubs). */
1455 this->remote_packet_size
= 400 - 1;
1457 /* This one is filled in when a ``g'' packet is received. */
1458 this->actual_register_packet_size
= 0;
1460 /* Should rsa->sizeof_g_packet needs more space than the
1461 default, adjust the size accordingly. Remember that each byte is
1462 encoded as two characters. 32 is the overhead for the packet
1463 header / footer. NOTE: cagney/1999-10-26: I suspect that 8
1464 (``$NN:G...#NN'') is a better guess, the below has been padded a
1466 if (this->sizeof_g_packet
> ((this->remote_packet_size
- 32) / 2))
1467 this->remote_packet_size
= (this->sizeof_g_packet
* 2 + 32);
1470 /* Get a pointer to the current remote target. If not connected to a
1471 remote target, return NULL. */
1473 static remote_target
*
1474 get_current_remote_target ()
1476 target_ops
*proc_target
= current_inferior ()->process_target ();
1477 return dynamic_cast<remote_target
*> (proc_target
);
1480 /* Return the current allowed size of a remote packet. This is
1481 inferred from the current architecture, and should be used to
1482 limit the length of outgoing packets. */
1484 remote_target::get_remote_packet_size ()
1486 struct remote_state
*rs
= get_remote_state ();
1487 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1489 if (rs
->explicit_packet_size
)
1490 return rs
->explicit_packet_size
;
1492 return rsa
->remote_packet_size
;
1495 static struct packet_reg
*
1496 packet_reg_from_regnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1499 if (regnum
< 0 && regnum
>= gdbarch_num_regs (gdbarch
))
1503 struct packet_reg
*r
= &rsa
->regs
[regnum
];
1505 gdb_assert (r
->regnum
== regnum
);
1510 static struct packet_reg
*
1511 packet_reg_from_pnum (struct gdbarch
*gdbarch
, struct remote_arch_state
*rsa
,
1516 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
1518 struct packet_reg
*r
= &rsa
->regs
[i
];
1520 if (r
->pnum
== pnum
)
1526 /* Allow the user to specify what sequence to send to the remote
1527 when he requests a program interruption: Although ^C is usually
1528 what remote systems expect (this is the default, here), it is
1529 sometimes preferable to send a break. On other systems such
1530 as the Linux kernel, a break followed by g, which is Magic SysRq g
1531 is required in order to interrupt the execution. */
1532 const char interrupt_sequence_control_c
[] = "Ctrl-C";
1533 const char interrupt_sequence_break
[] = "BREAK";
1534 const char interrupt_sequence_break_g
[] = "BREAK-g";
1535 static const char *const interrupt_sequence_modes
[] =
1537 interrupt_sequence_control_c
,
1538 interrupt_sequence_break
,
1539 interrupt_sequence_break_g
,
1542 static const char *interrupt_sequence_mode
= interrupt_sequence_control_c
;
1545 show_interrupt_sequence (struct ui_file
*file
, int from_tty
,
1546 struct cmd_list_element
*c
,
1549 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
1550 fprintf_filtered (file
,
1551 _("Send the ASCII ETX character (Ctrl-c) "
1552 "to the remote target to interrupt the "
1553 "execution of the program.\n"));
1554 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
1555 fprintf_filtered (file
,
1556 _("send a break signal to the remote target "
1557 "to interrupt the execution of the program.\n"));
1558 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
1559 fprintf_filtered (file
,
1560 _("Send a break signal and 'g' a.k.a. Magic SysRq g to "
1561 "the remote target to interrupt the execution "
1562 "of Linux kernel.\n"));
1564 internal_error (__FILE__
, __LINE__
,
1565 _("Invalid value for interrupt_sequence_mode: %s."),
1566 interrupt_sequence_mode
);
1569 /* This boolean variable specifies whether interrupt_sequence is sent
1570 to the remote target when gdb connects to it.
1571 This is mostly needed when you debug the Linux kernel: The Linux kernel
1572 expects BREAK g which is Magic SysRq g for connecting gdb. */
1573 static bool interrupt_on_connect
= false;
1575 /* This variable is used to implement the "set/show remotebreak" commands.
1576 Since these commands are now deprecated in favor of "set/show remote
1577 interrupt-sequence", it no longer has any effect on the code. */
1578 static bool remote_break
;
1581 set_remotebreak (const char *args
, int from_tty
, struct cmd_list_element
*c
)
1584 interrupt_sequence_mode
= interrupt_sequence_break
;
1586 interrupt_sequence_mode
= interrupt_sequence_control_c
;
1590 show_remotebreak (struct ui_file
*file
, int from_tty
,
1591 struct cmd_list_element
*c
,
1596 /* This variable sets the number of bits in an address that are to be
1597 sent in a memory ("M" or "m") packet. Normally, after stripping
1598 leading zeros, the entire address would be sent. This variable
1599 restricts the address to REMOTE_ADDRESS_SIZE bits. HISTORY: The
1600 initial implementation of remote.c restricted the address sent in
1601 memory packets to ``host::sizeof long'' bytes - (typically 32
1602 bits). Consequently, for 64 bit targets, the upper 32 bits of an
1603 address was never sent. Since fixing this bug may cause a break in
1604 some remote targets this variable is principally provided to
1605 facilitate backward compatibility. */
1607 static unsigned int remote_address_size
;
1610 /* User configurable variables for the number of characters in a
1611 memory read/write packet. MIN (rsa->remote_packet_size,
1612 rsa->sizeof_g_packet) is the default. Some targets need smaller
1613 values (fifo overruns, et.al.) and some users need larger values
1614 (speed up transfers). The variables ``preferred_*'' (the user
1615 request), ``current_*'' (what was actually set) and ``forced_*''
1616 (Positive - a soft limit, negative - a hard limit). */
1618 struct memory_packet_config
1625 /* The default max memory-write-packet-size, when the setting is
1626 "fixed". The 16k is historical. (It came from older GDB's using
1627 alloca for buffers and the knowledge (folklore?) that some hosts
1628 don't cope very well with large alloca calls.) */
1629 #define DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED 16384
1631 /* The minimum remote packet size for memory transfers. Ensures we
1632 can write at least one byte. */
1633 #define MIN_MEMORY_PACKET_SIZE 20
1635 /* Get the memory packet size, assuming it is fixed. */
1638 get_fixed_memory_packet_size (struct memory_packet_config
*config
)
1640 gdb_assert (config
->fixed_p
);
1642 if (config
->size
<= 0)
1643 return DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
;
1645 return config
->size
;
1648 /* Compute the current size of a read/write packet. Since this makes
1649 use of ``actual_register_packet_size'' the computation is dynamic. */
1652 remote_target::get_memory_packet_size (struct memory_packet_config
*config
)
1654 struct remote_state
*rs
= get_remote_state ();
1655 remote_arch_state
*rsa
= rs
->get_remote_arch_state (target_gdbarch ());
1658 if (config
->fixed_p
)
1659 what_they_get
= get_fixed_memory_packet_size (config
);
1662 what_they_get
= get_remote_packet_size ();
1663 /* Limit the packet to the size specified by the user. */
1664 if (config
->size
> 0
1665 && what_they_get
> config
->size
)
1666 what_they_get
= config
->size
;
1668 /* Limit it to the size of the targets ``g'' response unless we have
1669 permission from the stub to use a larger packet size. */
1670 if (rs
->explicit_packet_size
== 0
1671 && rsa
->actual_register_packet_size
> 0
1672 && what_they_get
> rsa
->actual_register_packet_size
)
1673 what_they_get
= rsa
->actual_register_packet_size
;
1675 if (what_they_get
< MIN_MEMORY_PACKET_SIZE
)
1676 what_they_get
= MIN_MEMORY_PACKET_SIZE
;
1678 /* Make sure there is room in the global buffer for this packet
1679 (including its trailing NUL byte). */
1680 if (rs
->buf
.size () < what_they_get
+ 1)
1681 rs
->buf
.resize (2 * what_they_get
);
1683 return what_they_get
;
1686 /* Update the size of a read/write packet. If they user wants
1687 something really big then do a sanity check. */
1690 set_memory_packet_size (const char *args
, struct memory_packet_config
*config
)
1692 int fixed_p
= config
->fixed_p
;
1693 long size
= config
->size
;
1696 error (_("Argument required (integer, `fixed' or `limited')."));
1697 else if (strcmp (args
, "hard") == 0
1698 || strcmp (args
, "fixed") == 0)
1700 else if (strcmp (args
, "soft") == 0
1701 || strcmp (args
, "limit") == 0)
1707 size
= strtoul (args
, &end
, 0);
1709 error (_("Invalid %s (bad syntax)."), config
->name
);
1711 /* Instead of explicitly capping the size of a packet to or
1712 disallowing it, the user is allowed to set the size to
1713 something arbitrarily large. */
1717 if (fixed_p
&& !config
->fixed_p
)
1719 /* So that the query shows the correct value. */
1720 long query_size
= (size
<= 0
1721 ? DEFAULT_MAX_MEMORY_PACKET_SIZE_FIXED
1724 if (! query (_("The target may not be able to correctly handle a %s\n"
1725 "of %ld bytes. Change the packet size? "),
1726 config
->name
, query_size
))
1727 error (_("Packet size not changed."));
1729 /* Update the config. */
1730 config
->fixed_p
= fixed_p
;
1731 config
->size
= size
;
1735 show_memory_packet_size (struct memory_packet_config
*config
)
1737 if (config
->size
== 0)
1738 printf_filtered (_("The %s is 0 (default). "), config
->name
);
1740 printf_filtered (_("The %s is %ld. "), config
->name
, config
->size
);
1741 if (config
->fixed_p
)
1742 printf_filtered (_("Packets are fixed at %ld bytes.\n"),
1743 get_fixed_memory_packet_size (config
));
1746 remote_target
*remote
= get_current_remote_target ();
1749 printf_filtered (_("Packets are limited to %ld bytes.\n"),
1750 remote
->get_memory_packet_size (config
));
1752 puts_filtered ("The actual limit will be further reduced "
1753 "dependent on the target.\n");
1757 /* FIXME: needs to be per-remote-target. */
1758 static struct memory_packet_config memory_write_packet_config
=
1760 "memory-write-packet-size",
1764 set_memory_write_packet_size (const char *args
, int from_tty
)
1766 set_memory_packet_size (args
, &memory_write_packet_config
);
1770 show_memory_write_packet_size (const char *args
, int from_tty
)
1772 show_memory_packet_size (&memory_write_packet_config
);
1775 /* Show the number of hardware watchpoints that can be used. */
1778 show_hardware_watchpoint_limit (struct ui_file
*file
, int from_tty
,
1779 struct cmd_list_element
*c
,
1782 fprintf_filtered (file
, _("The maximum number of target hardware "
1783 "watchpoints is %s.\n"), value
);
1786 /* Show the length limit (in bytes) for hardware watchpoints. */
1789 show_hardware_watchpoint_length_limit (struct ui_file
*file
, int from_tty
,
1790 struct cmd_list_element
*c
,
1793 fprintf_filtered (file
, _("The maximum length (in bytes) of a target "
1794 "hardware watchpoint is %s.\n"), value
);
1797 /* Show the number of hardware breakpoints that can be used. */
1800 show_hardware_breakpoint_limit (struct ui_file
*file
, int from_tty
,
1801 struct cmd_list_element
*c
,
1804 fprintf_filtered (file
, _("The maximum number of target hardware "
1805 "breakpoints is %s.\n"), value
);
1808 /* Controls the maximum number of characters to display in the debug output
1809 for each remote packet. The remaining characters are omitted. */
1811 static int remote_packet_max_chars
= 512;
1813 /* Show the maximum number of characters to display for each remote packet
1814 when remote debugging is enabled. */
1817 show_remote_packet_max_chars (struct ui_file
*file
, int from_tty
,
1818 struct cmd_list_element
*c
,
1821 fprintf_filtered (file
, _("Number of remote packet characters to "
1822 "display is %s.\n"), value
);
1826 remote_target::get_memory_write_packet_size ()
1828 return get_memory_packet_size (&memory_write_packet_config
);
1831 /* FIXME: needs to be per-remote-target. */
1832 static struct memory_packet_config memory_read_packet_config
=
1834 "memory-read-packet-size",
1838 set_memory_read_packet_size (const char *args
, int from_tty
)
1840 set_memory_packet_size (args
, &memory_read_packet_config
);
1844 show_memory_read_packet_size (const char *args
, int from_tty
)
1846 show_memory_packet_size (&memory_read_packet_config
);
1850 remote_target::get_memory_read_packet_size ()
1852 long size
= get_memory_packet_size (&memory_read_packet_config
);
1854 /* FIXME: cagney/1999-11-07: Functions like getpkt() need to get an
1855 extra buffer size argument before the memory read size can be
1856 increased beyond this. */
1857 if (size
> get_remote_packet_size ())
1858 size
= get_remote_packet_size ();
1864 struct packet_config
1869 /* If auto, GDB auto-detects support for this packet or feature,
1870 either through qSupported, or by trying the packet and looking
1871 at the response. If true, GDB assumes the target supports this
1872 packet. If false, the packet is disabled. Configs that don't
1873 have an associated command always have this set to auto. */
1874 enum auto_boolean detect
;
1876 /* Does the target support this packet? */
1877 enum packet_support support
;
1880 static enum packet_support
packet_config_support (struct packet_config
*config
);
1881 static enum packet_support
packet_support (int packet
);
1884 show_packet_config_cmd (struct packet_config
*config
)
1886 const char *support
= "internal-error";
1888 switch (packet_config_support (config
))
1891 support
= "enabled";
1893 case PACKET_DISABLE
:
1894 support
= "disabled";
1896 case PACKET_SUPPORT_UNKNOWN
:
1897 support
= "unknown";
1900 switch (config
->detect
)
1902 case AUTO_BOOLEAN_AUTO
:
1903 printf_filtered (_("Support for the `%s' packet "
1904 "is auto-detected, currently %s.\n"),
1905 config
->name
, support
);
1907 case AUTO_BOOLEAN_TRUE
:
1908 case AUTO_BOOLEAN_FALSE
:
1909 printf_filtered (_("Support for the `%s' packet is currently %s.\n"),
1910 config
->name
, support
);
1916 add_packet_config_cmd (struct packet_config
*config
, const char *name
,
1917 const char *title
, int legacy
)
1923 config
->name
= name
;
1924 config
->title
= title
;
1925 set_doc
= xstrprintf ("Set use of remote protocol `%s' (%s) packet.",
1927 show_doc
= xstrprintf ("Show current use of remote "
1928 "protocol `%s' (%s) packet.",
1930 /* set/show TITLE-packet {auto,on,off} */
1931 cmd_name
= xstrprintf ("%s-packet", title
);
1932 set_show_commands cmds
1933 = add_setshow_auto_boolean_cmd (cmd_name
, class_obscure
,
1934 &config
->detect
, set_doc
,
1935 show_doc
, NULL
, /* help_doc */
1937 show_remote_protocol_packet_cmd
,
1938 &remote_set_cmdlist
, &remote_show_cmdlist
);
1940 /* The command code copies the documentation strings. */
1944 /* set/show remote NAME-packet {auto,on,off} -- legacy. */
1949 legacy_name
= xstrprintf ("%s-packet", name
);
1950 add_alias_cmd (legacy_name
, cmds
.set
, class_obscure
, 0,
1951 &remote_set_cmdlist
);
1952 add_alias_cmd (legacy_name
, cmds
.show
, class_obscure
, 0,
1953 &remote_show_cmdlist
);
1957 static enum packet_result
1958 packet_check_result (const char *buf
)
1962 /* The stub recognized the packet request. Check that the
1963 operation succeeded. */
1965 && isxdigit (buf
[1]) && isxdigit (buf
[2])
1967 /* "Enn" - definitely an error. */
1968 return PACKET_ERROR
;
1970 /* Always treat "E." as an error. This will be used for
1971 more verbose error messages, such as E.memtypes. */
1972 if (buf
[0] == 'E' && buf
[1] == '.')
1973 return PACKET_ERROR
;
1975 /* The packet may or may not be OK. Just assume it is. */
1979 /* The stub does not support the packet. */
1980 return PACKET_UNKNOWN
;
1983 static enum packet_result
1984 packet_check_result (const gdb::char_vector
&buf
)
1986 return packet_check_result (buf
.data ());
1989 static enum packet_result
1990 packet_ok (const char *buf
, struct packet_config
*config
)
1992 enum packet_result result
;
1994 if (config
->detect
!= AUTO_BOOLEAN_TRUE
1995 && config
->support
== PACKET_DISABLE
)
1996 internal_error (__FILE__
, __LINE__
,
1997 _("packet_ok: attempt to use a disabled packet"));
1999 result
= packet_check_result (buf
);
2004 /* The stub recognized the packet request. */
2005 if (config
->support
== PACKET_SUPPORT_UNKNOWN
)
2007 remote_debug_printf ("Packet %s (%s) is supported",
2008 config
->name
, config
->title
);
2009 config
->support
= PACKET_ENABLE
;
2012 case PACKET_UNKNOWN
:
2013 /* The stub does not support the packet. */
2014 if (config
->detect
== AUTO_BOOLEAN_AUTO
2015 && config
->support
== PACKET_ENABLE
)
2017 /* If the stub previously indicated that the packet was
2018 supported then there is a protocol error. */
2019 error (_("Protocol error: %s (%s) conflicting enabled responses."),
2020 config
->name
, config
->title
);
2022 else if (config
->detect
== AUTO_BOOLEAN_TRUE
)
2024 /* The user set it wrong. */
2025 error (_("Enabled packet %s (%s) not recognized by stub"),
2026 config
->name
, config
->title
);
2029 remote_debug_printf ("Packet %s (%s) is NOT supported",
2030 config
->name
, config
->title
);
2031 config
->support
= PACKET_DISABLE
;
2038 static enum packet_result
2039 packet_ok (const gdb::char_vector
&buf
, struct packet_config
*config
)
2041 return packet_ok (buf
.data (), config
);
2058 PACKET_vFile_pwrite
,
2060 PACKET_vFile_unlink
,
2061 PACKET_vFile_readlink
,
2064 PACKET_qXfer_features
,
2065 PACKET_qXfer_exec_file
,
2066 PACKET_qXfer_libraries
,
2067 PACKET_qXfer_libraries_svr4
,
2068 PACKET_qXfer_memory_map
,
2069 PACKET_qXfer_osdata
,
2070 PACKET_qXfer_threads
,
2071 PACKET_qXfer_statictrace_read
,
2072 PACKET_qXfer_traceframe_info
,
2078 PACKET_QPassSignals
,
2079 PACKET_QCatchSyscalls
,
2080 PACKET_QProgramSignals
,
2081 PACKET_QSetWorkingDir
,
2082 PACKET_QStartupWithShell
,
2083 PACKET_QEnvironmentHexEncoded
,
2084 PACKET_QEnvironmentReset
,
2085 PACKET_QEnvironmentUnset
,
2087 PACKET_qSearch_memory
,
2090 PACKET_QStartNoAckMode
,
2092 PACKET_qXfer_siginfo_read
,
2093 PACKET_qXfer_siginfo_write
,
2096 /* Support for conditional tracepoints. */
2097 PACKET_ConditionalTracepoints
,
2099 /* Support for target-side breakpoint conditions. */
2100 PACKET_ConditionalBreakpoints
,
2102 /* Support for target-side breakpoint commands. */
2103 PACKET_BreakpointCommands
,
2105 /* Support for fast tracepoints. */
2106 PACKET_FastTracepoints
,
2108 /* Support for static tracepoints. */
2109 PACKET_StaticTracepoints
,
2111 /* Support for installing tracepoints while a trace experiment is
2113 PACKET_InstallInTrace
,
2117 PACKET_TracepointSource
,
2120 PACKET_QDisableRandomization
,
2122 PACKET_QTBuffer_size
,
2126 PACKET_qXfer_btrace
,
2128 /* Support for the QNonStop packet. */
2131 /* Support for the QThreadEvents packet. */
2132 PACKET_QThreadEvents
,
2134 /* Support for multi-process extensions. */
2135 PACKET_multiprocess_feature
,
2137 /* Support for enabling and disabling tracepoints while a trace
2138 experiment is running. */
2139 PACKET_EnableDisableTracepoints_feature
,
2141 /* Support for collecting strings using the tracenz bytecode. */
2142 PACKET_tracenz_feature
,
2144 /* Support for continuing to run a trace experiment while GDB is
2146 PACKET_DisconnectedTracing_feature
,
2148 /* Support for qXfer:libraries-svr4:read with a non-empty annex. */
2149 PACKET_augmented_libraries_svr4_read_feature
,
2151 /* Support for the qXfer:btrace-conf:read packet. */
2152 PACKET_qXfer_btrace_conf
,
2154 /* Support for the Qbtrace-conf:bts:size packet. */
2155 PACKET_Qbtrace_conf_bts_size
,
2157 /* Support for swbreak+ feature. */
2158 PACKET_swbreak_feature
,
2160 /* Support for hwbreak+ feature. */
2161 PACKET_hwbreak_feature
,
2163 /* Support for fork events. */
2164 PACKET_fork_event_feature
,
2166 /* Support for vfork events. */
2167 PACKET_vfork_event_feature
,
2169 /* Support for the Qbtrace-conf:pt:size packet. */
2170 PACKET_Qbtrace_conf_pt_size
,
2172 /* Support for exec events. */
2173 PACKET_exec_event_feature
,
2175 /* Support for query supported vCont actions. */
2176 PACKET_vContSupported
,
2178 /* Support remote CTRL-C. */
2181 /* Support TARGET_WAITKIND_NO_RESUMED. */
2184 /* Support for memory tagging, allocation tag fetch/store
2185 packets and the tag violation stop replies. */
2186 PACKET_memory_tagging_feature
,
2191 /* FIXME: needs to be per-remote-target. Ignoring this for now,
2192 assuming all remote targets are the same server (thus all support
2193 the same packets). */
2194 static struct packet_config remote_protocol_packets
[PACKET_MAX
];
2196 /* Returns the packet's corresponding "set remote foo-packet" command
2197 state. See struct packet_config for more details. */
2199 static enum auto_boolean
2200 packet_set_cmd_state (int packet
)
2202 return remote_protocol_packets
[packet
].detect
;
2205 /* Returns whether a given packet or feature is supported. This takes
2206 into account the state of the corresponding "set remote foo-packet"
2207 command, which may be used to bypass auto-detection. */
2209 static enum packet_support
2210 packet_config_support (struct packet_config
*config
)
2212 switch (config
->detect
)
2214 case AUTO_BOOLEAN_TRUE
:
2215 return PACKET_ENABLE
;
2216 case AUTO_BOOLEAN_FALSE
:
2217 return PACKET_DISABLE
;
2218 case AUTO_BOOLEAN_AUTO
:
2219 return config
->support
;
2221 gdb_assert_not_reached (_("bad switch"));
2225 /* Same as packet_config_support, but takes the packet's enum value as
2228 static enum packet_support
2229 packet_support (int packet
)
2231 struct packet_config
*config
= &remote_protocol_packets
[packet
];
2233 return packet_config_support (config
);
2237 show_remote_protocol_packet_cmd (struct ui_file
*file
, int from_tty
,
2238 struct cmd_list_element
*c
,
2241 struct packet_config
*packet
;
2243 for (packet
= remote_protocol_packets
;
2244 packet
< &remote_protocol_packets
[PACKET_MAX
];
2247 if (&packet
->detect
== c
->var
)
2249 show_packet_config_cmd (packet
);
2253 internal_error (__FILE__
, __LINE__
, _("Could not find config for %s"),
2257 /* Should we try one of the 'Z' requests? */
2261 Z_PACKET_SOFTWARE_BP
,
2262 Z_PACKET_HARDWARE_BP
,
2269 /* For compatibility with older distributions. Provide a ``set remote
2270 Z-packet ...'' command that updates all the Z packet types. */
2272 static enum auto_boolean remote_Z_packet_detect
;
2275 set_remote_protocol_Z_packet_cmd (const char *args
, int from_tty
,
2276 struct cmd_list_element
*c
)
2280 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2281 remote_protocol_packets
[PACKET_Z0
+ i
].detect
= remote_Z_packet_detect
;
2285 show_remote_protocol_Z_packet_cmd (struct ui_file
*file
, int from_tty
,
2286 struct cmd_list_element
*c
,
2291 for (i
= 0; i
< NR_Z_PACKET_TYPES
; i
++)
2293 show_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
+ i
]);
2297 /* Returns true if the multi-process extensions are in effect. */
2300 remote_multi_process_p (struct remote_state
*rs
)
2302 return packet_support (PACKET_multiprocess_feature
) == PACKET_ENABLE
;
2305 /* Returns true if fork events are supported. */
2308 remote_fork_event_p (struct remote_state
*rs
)
2310 return packet_support (PACKET_fork_event_feature
) == PACKET_ENABLE
;
2313 /* Returns true if vfork events are supported. */
2316 remote_vfork_event_p (struct remote_state
*rs
)
2318 return packet_support (PACKET_vfork_event_feature
) == PACKET_ENABLE
;
2321 /* Returns true if exec events are supported. */
2324 remote_exec_event_p (struct remote_state
*rs
)
2326 return packet_support (PACKET_exec_event_feature
) == PACKET_ENABLE
;
2329 /* Returns true if memory tagging is supported, false otherwise. */
2332 remote_memory_tagging_p ()
2334 return packet_support (PACKET_memory_tagging_feature
) == PACKET_ENABLE
;
2337 /* Insert fork catchpoint target routine. If fork events are enabled
2338 then return success, nothing more to do. */
2341 remote_target::insert_fork_catchpoint (int pid
)
2343 struct remote_state
*rs
= get_remote_state ();
2345 return !remote_fork_event_p (rs
);
2348 /* Remove fork catchpoint target routine. Nothing to do, just
2352 remote_target::remove_fork_catchpoint (int pid
)
2357 /* Insert vfork catchpoint target routine. If vfork events are enabled
2358 then return success, nothing more to do. */
2361 remote_target::insert_vfork_catchpoint (int pid
)
2363 struct remote_state
*rs
= get_remote_state ();
2365 return !remote_vfork_event_p (rs
);
2368 /* Remove vfork catchpoint target routine. Nothing to do, just
2372 remote_target::remove_vfork_catchpoint (int pid
)
2377 /* Insert exec catchpoint target routine. If exec events are
2378 enabled, just return success. */
2381 remote_target::insert_exec_catchpoint (int pid
)
2383 struct remote_state
*rs
= get_remote_state ();
2385 return !remote_exec_event_p (rs
);
2388 /* Remove exec catchpoint target routine. Nothing to do, just
2392 remote_target::remove_exec_catchpoint (int pid
)
2399 /* Take advantage of the fact that the TID field is not used, to tag
2400 special ptids with it set to != 0. */
2401 static const ptid_t
magic_null_ptid (42000, -1, 1);
2402 static const ptid_t
not_sent_ptid (42000, -2, 1);
2403 static const ptid_t
any_thread_ptid (42000, 0, 1);
2405 /* Find out if the stub attached to PID (and hence GDB should offer to
2406 detach instead of killing it when bailing out). */
2409 remote_target::remote_query_attached (int pid
)
2411 struct remote_state
*rs
= get_remote_state ();
2412 size_t size
= get_remote_packet_size ();
2414 if (packet_support (PACKET_qAttached
) == PACKET_DISABLE
)
2417 if (remote_multi_process_p (rs
))
2418 xsnprintf (rs
->buf
.data (), size
, "qAttached:%x", pid
);
2420 xsnprintf (rs
->buf
.data (), size
, "qAttached");
2423 getpkt (&rs
->buf
, 0);
2425 switch (packet_ok (rs
->buf
,
2426 &remote_protocol_packets
[PACKET_qAttached
]))
2429 if (strcmp (rs
->buf
.data (), "1") == 0)
2433 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
2435 case PACKET_UNKNOWN
:
2442 /* Add PID to GDB's inferior table. If FAKE_PID_P is true, then PID
2443 has been invented by GDB, instead of reported by the target. Since
2444 we can be connected to a remote system before before knowing about
2445 any inferior, mark the target with execution when we find the first
2446 inferior. If ATTACHED is 1, then we had just attached to this
2447 inferior. If it is 0, then we just created this inferior. If it
2448 is -1, then try querying the remote stub to find out if it had
2449 attached to the inferior or not. If TRY_OPEN_EXEC is true then
2450 attempt to open this inferior's executable as the main executable
2451 if no main executable is open already. */
2454 remote_target::remote_add_inferior (bool fake_pid_p
, int pid
, int attached
,
2457 struct inferior
*inf
;
2459 /* Check whether this process we're learning about is to be
2460 considered attached, or if is to be considered to have been
2461 spawned by the stub. */
2463 attached
= remote_query_attached (pid
);
2465 if (gdbarch_has_global_solist (target_gdbarch ()))
2467 /* If the target shares code across all inferiors, then every
2468 attach adds a new inferior. */
2469 inf
= add_inferior (pid
);
2471 /* ... and every inferior is bound to the same program space.
2472 However, each inferior may still have its own address
2474 inf
->aspace
= maybe_new_address_space ();
2475 inf
->pspace
= current_program_space
;
2479 /* In the traditional debugging scenario, there's a 1-1 match
2480 between program/address spaces. We simply bind the inferior
2481 to the program space's address space. */
2482 inf
= current_inferior ();
2484 /* However, if the current inferior is already bound to a
2485 process, find some other empty inferior. */
2489 for (inferior
*it
: all_inferiors ())
2498 /* Since all inferiors were already bound to a process, add
2500 inf
= add_inferior_with_spaces ();
2502 switch_to_inferior_no_thread (inf
);
2503 inf
->push_target (this);
2504 inferior_appeared (inf
, pid
);
2507 inf
->attach_flag
= attached
;
2508 inf
->fake_pid_p
= fake_pid_p
;
2510 /* If no main executable is currently open then attempt to
2511 open the file that was executed to create this inferior. */
2512 if (try_open_exec
&& get_exec_file (0) == NULL
)
2513 exec_file_locate_attach (pid
, 0, 1);
2515 /* Check for exec file mismatch, and let the user solve it. */
2516 validate_exec_file (1);
2521 static remote_thread_info
*get_remote_thread_info (thread_info
*thread
);
2522 static remote_thread_info
*get_remote_thread_info (remote_target
*target
,
2525 /* Add thread PTID to GDB's thread list. Tag it as executing/running
2526 according to EXECUTING and RUNNING respectively. If SILENT_P (or the
2527 remote_state::starting_up flag) is true then the new thread is added
2528 silently, otherwise the new thread will be announced to the user. */
2531 remote_target::remote_add_thread (ptid_t ptid
, bool running
, bool executing
,
2534 struct remote_state
*rs
= get_remote_state ();
2535 struct thread_info
*thread
;
2537 /* GDB historically didn't pull threads in the initial connection
2538 setup. If the remote target doesn't even have a concept of
2539 threads (e.g., a bare-metal target), even if internally we
2540 consider that a single-threaded target, mentioning a new thread
2541 might be confusing to the user. Be silent then, preserving the
2542 age old behavior. */
2543 if (rs
->starting_up
|| silent_p
)
2544 thread
= add_thread_silent (this, ptid
);
2546 thread
= add_thread (this, ptid
);
2548 /* We start by assuming threads are resumed. That state then gets updated
2549 when we process a matching stop reply. */
2550 get_remote_thread_info (thread
)->set_resumed ();
2552 set_executing (this, ptid
, executing
);
2553 set_running (this, ptid
, running
);
2558 /* Come here when we learn about a thread id from the remote target.
2559 It may be the first time we hear about such thread, so take the
2560 opportunity to add it to GDB's thread list. In case this is the
2561 first time we're noticing its corresponding inferior, add it to
2562 GDB's inferior list as well. EXECUTING indicates whether the
2563 thread is (internally) executing or stopped. */
2566 remote_target::remote_notice_new_inferior (ptid_t currthread
, bool executing
)
2568 /* In non-stop mode, we assume new found threads are (externally)
2569 running until proven otherwise with a stop reply. In all-stop,
2570 we can only get here if all threads are stopped. */
2571 bool running
= target_is_non_stop_p ();
2573 /* If this is a new thread, add it to GDB's thread list.
2574 If we leave it up to WFI to do this, bad things will happen. */
2576 thread_info
*tp
= find_thread_ptid (this, currthread
);
2577 if (tp
!= NULL
&& tp
->state
== THREAD_EXITED
)
2579 /* We're seeing an event on a thread id we knew had exited.
2580 This has to be a new thread reusing the old id. Add it. */
2581 remote_add_thread (currthread
, running
, executing
, false);
2585 if (!in_thread_list (this, currthread
))
2587 struct inferior
*inf
= NULL
;
2588 int pid
= currthread
.pid ();
2590 if (inferior_ptid
.is_pid ()
2591 && pid
== inferior_ptid
.pid ())
2593 /* inferior_ptid has no thread member yet. This can happen
2594 with the vAttach -> remote_wait,"TAAthread:" path if the
2595 stub doesn't support qC. This is the first stop reported
2596 after an attach, so this is the main thread. Update the
2597 ptid in the thread list. */
2598 if (in_thread_list (this, ptid_t (pid
)))
2599 thread_change_ptid (this, inferior_ptid
, currthread
);
2603 = remote_add_thread (currthread
, running
, executing
, false);
2604 switch_to_thread (thr
);
2609 if (magic_null_ptid
== inferior_ptid
)
2611 /* inferior_ptid is not set yet. This can happen with the
2612 vRun -> remote_wait,"TAAthread:" path if the stub
2613 doesn't support qC. This is the first stop reported
2614 after an attach, so this is the main thread. Update the
2615 ptid in the thread list. */
2616 thread_change_ptid (this, inferior_ptid
, currthread
);
2620 /* When connecting to a target remote, or to a target
2621 extended-remote which already was debugging an inferior, we
2622 may not know about it yet. Add it before adding its child
2623 thread, so notifications are emitted in a sensible order. */
2624 if (find_inferior_pid (this, currthread
.pid ()) == NULL
)
2626 struct remote_state
*rs
= get_remote_state ();
2627 bool fake_pid_p
= !remote_multi_process_p (rs
);
2629 inf
= remote_add_inferior (fake_pid_p
,
2630 currthread
.pid (), -1, 1);
2633 /* This is really a new thread. Add it. */
2634 thread_info
*new_thr
2635 = remote_add_thread (currthread
, running
, executing
, false);
2637 /* If we found a new inferior, let the common code do whatever
2638 it needs to with it (e.g., read shared libraries, insert
2639 breakpoints), unless we're just setting up an all-stop
2643 struct remote_state
*rs
= get_remote_state ();
2645 if (!rs
->starting_up
)
2646 notice_new_inferior (new_thr
, executing
, 0);
2651 /* Return THREAD's private thread data, creating it if necessary. */
2653 static remote_thread_info
*
2654 get_remote_thread_info (thread_info
*thread
)
2656 gdb_assert (thread
!= NULL
);
2658 if (thread
->priv
== NULL
)
2659 thread
->priv
.reset (new remote_thread_info
);
2661 return static_cast<remote_thread_info
*> (thread
->priv
.get ());
2664 /* Return PTID's private thread data, creating it if necessary. */
2666 static remote_thread_info
*
2667 get_remote_thread_info (remote_target
*target
, ptid_t ptid
)
2669 thread_info
*thr
= find_thread_ptid (target
, ptid
);
2670 return get_remote_thread_info (thr
);
2673 /* Call this function as a result of
2674 1) A halt indication (T packet) containing a thread id
2675 2) A direct query of currthread
2676 3) Successful execution of set thread */
2679 record_currthread (struct remote_state
*rs
, ptid_t currthread
)
2681 rs
->general_thread
= currthread
;
2684 /* If 'QPassSignals' is supported, tell the remote stub what signals
2685 it can simply pass through to the inferior without reporting. */
2688 remote_target::pass_signals (gdb::array_view
<const unsigned char> pass_signals
)
2690 if (packet_support (PACKET_QPassSignals
) != PACKET_DISABLE
)
2692 char *pass_packet
, *p
;
2694 struct remote_state
*rs
= get_remote_state ();
2696 gdb_assert (pass_signals
.size () < 256);
2697 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2699 if (pass_signals
[i
])
2702 pass_packet
= (char *) xmalloc (count
* 3 + strlen ("QPassSignals:") + 1);
2703 strcpy (pass_packet
, "QPassSignals:");
2704 p
= pass_packet
+ strlen (pass_packet
);
2705 for (size_t i
= 0; i
< pass_signals
.size (); i
++)
2707 if (pass_signals
[i
])
2710 *p
++ = tohex (i
>> 4);
2711 *p
++ = tohex (i
& 15);
2720 if (!rs
->last_pass_packet
|| strcmp (rs
->last_pass_packet
, pass_packet
))
2722 putpkt (pass_packet
);
2723 getpkt (&rs
->buf
, 0);
2724 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QPassSignals
]);
2725 xfree (rs
->last_pass_packet
);
2726 rs
->last_pass_packet
= pass_packet
;
2729 xfree (pass_packet
);
2733 /* If 'QCatchSyscalls' is supported, tell the remote stub
2734 to report syscalls to GDB. */
2737 remote_target::set_syscall_catchpoint (int pid
, bool needed
, int any_count
,
2738 gdb::array_view
<const int> syscall_counts
)
2740 const char *catch_packet
;
2741 enum packet_result result
;
2744 if (packet_support (PACKET_QCatchSyscalls
) == PACKET_DISABLE
)
2746 /* Not supported. */
2750 if (needed
&& any_count
== 0)
2752 /* Count how many syscalls are to be caught. */
2753 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2755 if (syscall_counts
[i
] != 0)
2760 remote_debug_printf ("pid %d needed %d any_count %d n_sysno %d",
2761 pid
, needed
, any_count
, n_sysno
);
2763 std::string built_packet
;
2766 /* Prepare a packet with the sysno list, assuming max 8+1
2767 characters for a sysno. If the resulting packet size is too
2768 big, fallback on the non-selective packet. */
2769 const int maxpktsz
= strlen ("QCatchSyscalls:1") + n_sysno
* 9 + 1;
2770 built_packet
.reserve (maxpktsz
);
2771 built_packet
= "QCatchSyscalls:1";
2774 /* Add in each syscall to be caught. */
2775 for (size_t i
= 0; i
< syscall_counts
.size (); i
++)
2777 if (syscall_counts
[i
] != 0)
2778 string_appendf (built_packet
, ";%zx", i
);
2781 if (built_packet
.size () > get_remote_packet_size ())
2783 /* catch_packet too big. Fallback to less efficient
2784 non selective mode, with GDB doing the filtering. */
2785 catch_packet
= "QCatchSyscalls:1";
2788 catch_packet
= built_packet
.c_str ();
2791 catch_packet
= "QCatchSyscalls:0";
2793 struct remote_state
*rs
= get_remote_state ();
2795 putpkt (catch_packet
);
2796 getpkt (&rs
->buf
, 0);
2797 result
= packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QCatchSyscalls
]);
2798 if (result
== PACKET_OK
)
2804 /* If 'QProgramSignals' is supported, tell the remote stub what
2805 signals it should pass through to the inferior when detaching. */
2808 remote_target::program_signals (gdb::array_view
<const unsigned char> signals
)
2810 if (packet_support (PACKET_QProgramSignals
) != PACKET_DISABLE
)
2814 struct remote_state
*rs
= get_remote_state ();
2816 gdb_assert (signals
.size () < 256);
2817 for (size_t i
= 0; i
< signals
.size (); i
++)
2822 packet
= (char *) xmalloc (count
* 3 + strlen ("QProgramSignals:") + 1);
2823 strcpy (packet
, "QProgramSignals:");
2824 p
= packet
+ strlen (packet
);
2825 for (size_t i
= 0; i
< signals
.size (); i
++)
2827 if (signal_pass_state (i
))
2830 *p
++ = tohex (i
>> 4);
2831 *p
++ = tohex (i
& 15);
2840 if (!rs
->last_program_signals_packet
2841 || strcmp (rs
->last_program_signals_packet
, packet
) != 0)
2844 getpkt (&rs
->buf
, 0);
2845 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_QProgramSignals
]);
2846 xfree (rs
->last_program_signals_packet
);
2847 rs
->last_program_signals_packet
= packet
;
2854 /* If PTID is MAGIC_NULL_PTID, don't set any thread. If PTID is
2855 MINUS_ONE_PTID, set the thread to -1, so the stub returns the
2856 thread. If GEN is set, set the general thread, if not, then set
2857 the step/continue thread. */
2859 remote_target::set_thread (ptid_t ptid
, int gen
)
2861 struct remote_state
*rs
= get_remote_state ();
2862 ptid_t state
= gen
? rs
->general_thread
: rs
->continue_thread
;
2863 char *buf
= rs
->buf
.data ();
2864 char *endbuf
= buf
+ get_remote_packet_size ();
2870 *buf
++ = gen
? 'g' : 'c';
2871 if (ptid
== magic_null_ptid
)
2872 xsnprintf (buf
, endbuf
- buf
, "0");
2873 else if (ptid
== any_thread_ptid
)
2874 xsnprintf (buf
, endbuf
- buf
, "0");
2875 else if (ptid
== minus_one_ptid
)
2876 xsnprintf (buf
, endbuf
- buf
, "-1");
2878 write_ptid (buf
, endbuf
, ptid
);
2880 getpkt (&rs
->buf
, 0);
2882 rs
->general_thread
= ptid
;
2884 rs
->continue_thread
= ptid
;
2888 remote_target::set_general_thread (ptid_t ptid
)
2890 set_thread (ptid
, 1);
2894 remote_target::set_continue_thread (ptid_t ptid
)
2896 set_thread (ptid
, 0);
2899 /* Change the remote current process. Which thread within the process
2900 ends up selected isn't important, as long as it is the same process
2901 as what INFERIOR_PTID points to.
2903 This comes from that fact that there is no explicit notion of
2904 "selected process" in the protocol. The selected process for
2905 general operations is the process the selected general thread
2909 remote_target::set_general_process ()
2911 struct remote_state
*rs
= get_remote_state ();
2913 /* If the remote can't handle multiple processes, don't bother. */
2914 if (!remote_multi_process_p (rs
))
2917 /* We only need to change the remote current thread if it's pointing
2918 at some other process. */
2919 if (rs
->general_thread
.pid () != inferior_ptid
.pid ())
2920 set_general_thread (inferior_ptid
);
2924 /* Return nonzero if this is the main thread that we made up ourselves
2925 to model non-threaded targets as single-threaded. */
2928 remote_thread_always_alive (ptid_t ptid
)
2930 if (ptid
== magic_null_ptid
)
2931 /* The main thread is always alive. */
2934 if (ptid
.pid () != 0 && ptid
.lwp () == 0)
2935 /* The main thread is always alive. This can happen after a
2936 vAttach, if the remote side doesn't support
2943 /* Return nonzero if the thread PTID is still alive on the remote
2947 remote_target::thread_alive (ptid_t ptid
)
2949 struct remote_state
*rs
= get_remote_state ();
2952 /* Check if this is a thread that we made up ourselves to model
2953 non-threaded targets as single-threaded. */
2954 if (remote_thread_always_alive (ptid
))
2957 p
= rs
->buf
.data ();
2958 endp
= p
+ get_remote_packet_size ();
2961 write_ptid (p
, endp
, ptid
);
2964 getpkt (&rs
->buf
, 0);
2965 return (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K');
2968 /* Return a pointer to a thread name if we know it and NULL otherwise.
2969 The thread_info object owns the memory for the name. */
2972 remote_target::thread_name (struct thread_info
*info
)
2974 if (info
->priv
!= NULL
)
2976 const std::string
&name
= get_remote_thread_info (info
)->name
;
2977 return !name
.empty () ? name
.c_str () : NULL
;
2983 /* About these extended threadlist and threadinfo packets. They are
2984 variable length packets but, the fields within them are often fixed
2985 length. They are redundant enough to send over UDP as is the
2986 remote protocol in general. There is a matching unit test module
2989 /* WARNING: This threadref data structure comes from the remote O.S.,
2990 libstub protocol encoding, and remote.c. It is not particularly
2993 /* Right now, the internal structure is int. We want it to be bigger.
2994 Plan to fix this. */
2996 typedef int gdb_threadref
; /* Internal GDB thread reference. */
2998 /* gdb_ext_thread_info is an internal GDB data structure which is
2999 equivalent to the reply of the remote threadinfo packet. */
3001 struct gdb_ext_thread_info
3003 threadref threadid
; /* External form of thread reference. */
3004 int active
; /* Has state interesting to GDB?
3006 char display
[256]; /* Brief state display, name,
3007 blocked/suspended. */
3008 char shortname
[32]; /* To be used to name threads. */
3009 char more_display
[256]; /* Long info, statistics, queue depth,
3013 /* The volume of remote transfers can be limited by submitting
3014 a mask containing bits specifying the desired information.
3015 Use a union of these values as the 'selection' parameter to
3016 get_thread_info. FIXME: Make these TAG names more thread specific. */
3018 #define TAG_THREADID 1
3019 #define TAG_EXISTS 2
3020 #define TAG_DISPLAY 4
3021 #define TAG_THREADNAME 8
3022 #define TAG_MOREDISPLAY 16
3024 #define BUF_THREAD_ID_SIZE (OPAQUETHREADBYTES * 2)
3026 static const char *unpack_nibble (const char *buf
, int *val
);
3028 static const char *unpack_byte (const char *buf
, int *value
);
3030 static char *pack_int (char *buf
, int value
);
3032 static const char *unpack_int (const char *buf
, int *value
);
3034 static const char *unpack_string (const char *src
, char *dest
, int length
);
3036 static char *pack_threadid (char *pkt
, threadref
*id
);
3038 static const char *unpack_threadid (const char *inbuf
, threadref
*id
);
3040 void int_to_threadref (threadref
*id
, int value
);
3042 static int threadref_to_int (threadref
*ref
);
3044 static void copy_threadref (threadref
*dest
, threadref
*src
);
3046 static int threadmatch (threadref
*dest
, threadref
*src
);
3048 static char *pack_threadinfo_request (char *pkt
, int mode
,
3051 static char *pack_threadlist_request (char *pkt
, int startflag
,
3053 threadref
*nextthread
);
3055 static int remote_newthread_step (threadref
*ref
, void *context
);
3058 /* Write a PTID to BUF. ENDBUF points to one-passed-the-end of the
3059 buffer we're allowed to write to. Returns
3060 BUF+CHARACTERS_WRITTEN. */
3063 remote_target::write_ptid (char *buf
, const char *endbuf
, ptid_t ptid
)
3066 struct remote_state
*rs
= get_remote_state ();
3068 if (remote_multi_process_p (rs
))
3072 buf
+= xsnprintf (buf
, endbuf
- buf
, "p-%x.", -pid
);
3074 buf
+= xsnprintf (buf
, endbuf
- buf
, "p%x.", pid
);
3078 buf
+= xsnprintf (buf
, endbuf
- buf
, "-%x", -tid
);
3080 buf
+= xsnprintf (buf
, endbuf
- buf
, "%x", tid
);
3085 /* Extract a PTID from BUF. If non-null, OBUF is set to one past the
3086 last parsed char. Returns null_ptid if no thread id is found, and
3087 throws an error if the thread id has an invalid format. */
3090 read_ptid (const char *buf
, const char **obuf
)
3092 const char *p
= buf
;
3094 ULONGEST pid
= 0, tid
= 0;
3098 /* Multi-process ptid. */
3099 pp
= unpack_varlen_hex (p
+ 1, &pid
);
3101 error (_("invalid remote ptid: %s"), p
);
3104 pp
= unpack_varlen_hex (p
+ 1, &tid
);
3107 return ptid_t (pid
, tid
, 0);
3110 /* No multi-process. Just a tid. */
3111 pp
= unpack_varlen_hex (p
, &tid
);
3113 /* Return null_ptid when no thread id is found. */
3121 /* Since the stub is not sending a process id, then default to
3122 what's in inferior_ptid, unless it's null at this point. If so,
3123 then since there's no way to know the pid of the reported
3124 threads, use the magic number. */
3125 if (inferior_ptid
== null_ptid
)
3126 pid
= magic_null_ptid
.pid ();
3128 pid
= inferior_ptid
.pid ();
3132 return ptid_t (pid
, tid
, 0);
3138 if (ch
>= 'a' && ch
<= 'f')
3139 return ch
- 'a' + 10;
3140 if (ch
>= '0' && ch
<= '9')
3142 if (ch
>= 'A' && ch
<= 'F')
3143 return ch
- 'A' + 10;
3148 stub_unpack_int (const char *buff
, int fieldlength
)
3155 nibble
= stubhex (*buff
++);
3159 retval
= retval
<< 4;
3165 unpack_nibble (const char *buf
, int *val
)
3167 *val
= fromhex (*buf
++);
3172 unpack_byte (const char *buf
, int *value
)
3174 *value
= stub_unpack_int (buf
, 2);
3179 pack_int (char *buf
, int value
)
3181 buf
= pack_hex_byte (buf
, (value
>> 24) & 0xff);
3182 buf
= pack_hex_byte (buf
, (value
>> 16) & 0xff);
3183 buf
= pack_hex_byte (buf
, (value
>> 8) & 0x0ff);
3184 buf
= pack_hex_byte (buf
, (value
& 0xff));
3189 unpack_int (const char *buf
, int *value
)
3191 *value
= stub_unpack_int (buf
, 8);
3195 #if 0 /* Currently unused, uncomment when needed. */
3196 static char *pack_string (char *pkt
, char *string
);
3199 pack_string (char *pkt
, char *string
)
3204 len
= strlen (string
);
3206 len
= 200; /* Bigger than most GDB packets, junk??? */
3207 pkt
= pack_hex_byte (pkt
, len
);
3211 if ((ch
== '\0') || (ch
== '#'))
3212 ch
= '*'; /* Protect encapsulation. */
3217 #endif /* 0 (unused) */
3220 unpack_string (const char *src
, char *dest
, int length
)
3229 pack_threadid (char *pkt
, threadref
*id
)
3232 unsigned char *altid
;
3234 altid
= (unsigned char *) id
;
3235 limit
= pkt
+ BUF_THREAD_ID_SIZE
;
3237 pkt
= pack_hex_byte (pkt
, *altid
++);
3243 unpack_threadid (const char *inbuf
, threadref
*id
)
3246 const char *limit
= inbuf
+ BUF_THREAD_ID_SIZE
;
3249 altref
= (char *) id
;
3251 while (inbuf
< limit
)
3253 x
= stubhex (*inbuf
++);
3254 y
= stubhex (*inbuf
++);
3255 *altref
++ = (x
<< 4) | y
;
3260 /* Externally, threadrefs are 64 bits but internally, they are still
3261 ints. This is due to a mismatch of specifications. We would like
3262 to use 64bit thread references internally. This is an adapter
3266 int_to_threadref (threadref
*id
, int value
)
3268 unsigned char *scan
;
3270 scan
= (unsigned char *) id
;
3276 *scan
++ = (value
>> 24) & 0xff;
3277 *scan
++ = (value
>> 16) & 0xff;
3278 *scan
++ = (value
>> 8) & 0xff;
3279 *scan
++ = (value
& 0xff);
3283 threadref_to_int (threadref
*ref
)
3286 unsigned char *scan
;
3292 value
= (value
<< 8) | ((*scan
++) & 0xff);
3297 copy_threadref (threadref
*dest
, threadref
*src
)
3300 unsigned char *csrc
, *cdest
;
3302 csrc
= (unsigned char *) src
;
3303 cdest
= (unsigned char *) dest
;
3310 threadmatch (threadref
*dest
, threadref
*src
)
3312 /* Things are broken right now, so just assume we got a match. */
3314 unsigned char *srcp
, *destp
;
3316 srcp
= (char *) src
;
3317 destp
= (char *) dest
;
3321 result
&= (*srcp
++ == *destp
++) ? 1 : 0;
3328 threadid:1, # always request threadid
3335 /* Encoding: 'Q':8,'P':8,mask:32,threadid:64 */
3338 pack_threadinfo_request (char *pkt
, int mode
, threadref
*id
)
3340 *pkt
++ = 'q'; /* Info Query */
3341 *pkt
++ = 'P'; /* process or thread info */
3342 pkt
= pack_int (pkt
, mode
); /* mode */
3343 pkt
= pack_threadid (pkt
, id
); /* threadid */
3344 *pkt
= '\0'; /* terminate */
3348 /* These values tag the fields in a thread info response packet. */
3349 /* Tagging the fields allows us to request specific fields and to
3350 add more fields as time goes by. */
3352 #define TAG_THREADID 1 /* Echo the thread identifier. */
3353 #define TAG_EXISTS 2 /* Is this process defined enough to
3354 fetch registers and its stack? */
3355 #define TAG_DISPLAY 4 /* A short thing maybe to put on a window */
3356 #define TAG_THREADNAME 8 /* string, maps 1-to-1 with a thread is. */
3357 #define TAG_MOREDISPLAY 16 /* Whatever the kernel wants to say about
3361 remote_target::remote_unpack_thread_info_response (const char *pkt
,
3362 threadref
*expectedref
,
3363 gdb_ext_thread_info
*info
)
3365 struct remote_state
*rs
= get_remote_state ();
3369 const char *limit
= pkt
+ rs
->buf
.size (); /* Plausible parsing limit. */
3372 /* info->threadid = 0; FIXME: implement zero_threadref. */
3374 info
->display
[0] = '\0';
3375 info
->shortname
[0] = '\0';
3376 info
->more_display
[0] = '\0';
3378 /* Assume the characters indicating the packet type have been
3380 pkt
= unpack_int (pkt
, &mask
); /* arg mask */
3381 pkt
= unpack_threadid (pkt
, &ref
);
3384 warning (_("Incomplete response to threadinfo request."));
3385 if (!threadmatch (&ref
, expectedref
))
3386 { /* This is an answer to a different request. */
3387 warning (_("ERROR RMT Thread info mismatch."));
3390 copy_threadref (&info
->threadid
, &ref
);
3392 /* Loop on tagged fields , try to bail if something goes wrong. */
3394 /* Packets are terminated with nulls. */
3395 while ((pkt
< limit
) && mask
&& *pkt
)
3397 pkt
= unpack_int (pkt
, &tag
); /* tag */
3398 pkt
= unpack_byte (pkt
, &length
); /* length */
3399 if (!(tag
& mask
)) /* Tags out of synch with mask. */
3401 warning (_("ERROR RMT: threadinfo tag mismatch."));
3405 if (tag
== TAG_THREADID
)
3409 warning (_("ERROR RMT: length of threadid is not 16."));
3413 pkt
= unpack_threadid (pkt
, &ref
);
3414 mask
= mask
& ~TAG_THREADID
;
3417 if (tag
== TAG_EXISTS
)
3419 info
->active
= stub_unpack_int (pkt
, length
);
3421 mask
= mask
& ~(TAG_EXISTS
);
3424 warning (_("ERROR RMT: 'exists' length too long."));
3430 if (tag
== TAG_THREADNAME
)
3432 pkt
= unpack_string (pkt
, &info
->shortname
[0], length
);
3433 mask
= mask
& ~TAG_THREADNAME
;
3436 if (tag
== TAG_DISPLAY
)
3438 pkt
= unpack_string (pkt
, &info
->display
[0], length
);
3439 mask
= mask
& ~TAG_DISPLAY
;
3442 if (tag
== TAG_MOREDISPLAY
)
3444 pkt
= unpack_string (pkt
, &info
->more_display
[0], length
);
3445 mask
= mask
& ~TAG_MOREDISPLAY
;
3448 warning (_("ERROR RMT: unknown thread info tag."));
3449 break; /* Not a tag we know about. */
3455 remote_target::remote_get_threadinfo (threadref
*threadid
,
3457 gdb_ext_thread_info
*info
)
3459 struct remote_state
*rs
= get_remote_state ();
3462 pack_threadinfo_request (rs
->buf
.data (), fieldset
, threadid
);
3464 getpkt (&rs
->buf
, 0);
3466 if (rs
->buf
[0] == '\0')
3469 result
= remote_unpack_thread_info_response (&rs
->buf
[2],
3474 /* Format: i'Q':8,i"L":8,initflag:8,batchsize:16,lastthreadid:32 */
3477 pack_threadlist_request (char *pkt
, int startflag
, int threadcount
,
3478 threadref
*nextthread
)
3480 *pkt
++ = 'q'; /* info query packet */
3481 *pkt
++ = 'L'; /* Process LIST or threadLIST request */
3482 pkt
= pack_nibble (pkt
, startflag
); /* initflag 1 bytes */
3483 pkt
= pack_hex_byte (pkt
, threadcount
); /* threadcount 2 bytes */
3484 pkt
= pack_threadid (pkt
, nextthread
); /* 64 bit thread identifier */
3489 /* Encoding: 'q':8,'M':8,count:16,done:8,argthreadid:64,(threadid:64)* */
3492 remote_target::parse_threadlist_response (const char *pkt
, int result_limit
,
3493 threadref
*original_echo
,
3494 threadref
*resultlist
,
3497 struct remote_state
*rs
= get_remote_state ();
3498 int count
, resultcount
, done
;
3501 /* Assume the 'q' and 'M chars have been stripped. */
3502 const char *limit
= pkt
+ (rs
->buf
.size () - BUF_THREAD_ID_SIZE
);
3503 /* done parse past here */
3504 pkt
= unpack_byte (pkt
, &count
); /* count field */
3505 pkt
= unpack_nibble (pkt
, &done
);
3506 /* The first threadid is the argument threadid. */
3507 pkt
= unpack_threadid (pkt
, original_echo
); /* should match query packet */
3508 while ((count
-- > 0) && (pkt
< limit
))
3510 pkt
= unpack_threadid (pkt
, resultlist
++);
3511 if (resultcount
++ >= result_limit
)
3519 /* Fetch the next batch of threads from the remote. Returns -1 if the
3520 qL packet is not supported, 0 on error and 1 on success. */
3523 remote_target::remote_get_threadlist (int startflag
, threadref
*nextthread
,
3524 int result_limit
, int *done
, int *result_count
,
3525 threadref
*threadlist
)
3527 struct remote_state
*rs
= get_remote_state ();
3530 /* Truncate result limit to be smaller than the packet size. */
3531 if ((((result_limit
+ 1) * BUF_THREAD_ID_SIZE
) + 10)
3532 >= get_remote_packet_size ())
3533 result_limit
= (get_remote_packet_size () / BUF_THREAD_ID_SIZE
) - 2;
3535 pack_threadlist_request (rs
->buf
.data (), startflag
, result_limit
,
3538 getpkt (&rs
->buf
, 0);
3539 if (rs
->buf
[0] == '\0')
3541 /* Packet not supported. */
3546 parse_threadlist_response (&rs
->buf
[2], result_limit
,
3547 &rs
->echo_nextthread
, threadlist
, done
);
3549 if (!threadmatch (&rs
->echo_nextthread
, nextthread
))
3551 /* FIXME: This is a good reason to drop the packet. */
3552 /* Possibly, there is a duplicate response. */
3554 retransmit immediatly - race conditions
3555 retransmit after timeout - yes
3557 wait for packet, then exit
3559 warning (_("HMM: threadlist did not echo arg thread, dropping it."));
3560 return 0; /* I choose simply exiting. */
3562 if (*result_count
<= 0)
3566 warning (_("RMT ERROR : failed to get remote thread list."));
3569 return result
; /* break; */
3571 if (*result_count
> result_limit
)
3574 warning (_("RMT ERROR: threadlist response longer than requested."));
3580 /* Fetch the list of remote threads, with the qL packet, and call
3581 STEPFUNCTION for each thread found. Stops iterating and returns 1
3582 if STEPFUNCTION returns true. Stops iterating and returns 0 if the
3583 STEPFUNCTION returns false. If the packet is not supported,
3587 remote_target::remote_threadlist_iterator (rmt_thread_action stepfunction
,
3588 void *context
, int looplimit
)
3590 struct remote_state
*rs
= get_remote_state ();
3591 int done
, i
, result_count
;
3599 if (loopcount
++ > looplimit
)
3602 warning (_("Remote fetch threadlist -infinite loop-."));
3605 result
= remote_get_threadlist (startflag
, &rs
->nextthread
,
3606 MAXTHREADLISTRESULTS
,
3607 &done
, &result_count
,
3608 rs
->resultthreadlist
);
3611 /* Clear for later iterations. */
3613 /* Setup to resume next batch of thread references, set nextthread. */
3614 if (result_count
>= 1)
3615 copy_threadref (&rs
->nextthread
,
3616 &rs
->resultthreadlist
[result_count
- 1]);
3618 while (result_count
--)
3620 if (!(*stepfunction
) (&rs
->resultthreadlist
[i
++], context
))
3630 /* A thread found on the remote target. */
3634 explicit thread_item (ptid_t ptid_
)
3638 thread_item (thread_item
&&other
) = default;
3639 thread_item
&operator= (thread_item
&&other
) = default;
3641 DISABLE_COPY_AND_ASSIGN (thread_item
);
3643 /* The thread's PTID. */
3646 /* The thread's extra info. */
3649 /* The thread's name. */
3652 /* The core the thread was running on. -1 if not known. */
3655 /* The thread handle associated with the thread. */
3656 gdb::byte_vector thread_handle
;
3659 /* Context passed around to the various methods listing remote
3660 threads. As new threads are found, they're added to the ITEMS
3663 struct threads_listing_context
3665 /* Return true if this object contains an entry for a thread with ptid
3668 bool contains_thread (ptid_t ptid
) const
3670 auto match_ptid
= [&] (const thread_item
&item
)
3672 return item
.ptid
== ptid
;
3675 auto it
= std::find_if (this->items
.begin (),
3679 return it
!= this->items
.end ();
3682 /* Remove the thread with ptid PTID. */
3684 void remove_thread (ptid_t ptid
)
3686 auto match_ptid
= [&] (const thread_item
&item
)
3688 return item
.ptid
== ptid
;
3691 auto it
= std::remove_if (this->items
.begin (),
3695 if (it
!= this->items
.end ())
3696 this->items
.erase (it
);
3699 /* The threads found on the remote target. */
3700 std::vector
<thread_item
> items
;
3704 remote_newthread_step (threadref
*ref
, void *data
)
3706 struct threads_listing_context
*context
3707 = (struct threads_listing_context
*) data
;
3708 int pid
= inferior_ptid
.pid ();
3709 int lwp
= threadref_to_int (ref
);
3710 ptid_t
ptid (pid
, lwp
);
3712 context
->items
.emplace_back (ptid
);
3714 return 1; /* continue iterator */
3717 #define CRAZY_MAX_THREADS 1000
3720 remote_target::remote_current_thread (ptid_t oldpid
)
3722 struct remote_state
*rs
= get_remote_state ();
3725 getpkt (&rs
->buf
, 0);
3726 if (rs
->buf
[0] == 'Q' && rs
->buf
[1] == 'C')
3731 result
= read_ptid (&rs
->buf
[2], &obuf
);
3733 remote_debug_printf ("warning: garbage in qC reply");
3741 /* List remote threads using the deprecated qL packet. */
3744 remote_target::remote_get_threads_with_ql (threads_listing_context
*context
)
3746 if (remote_threadlist_iterator (remote_newthread_step
, context
,
3747 CRAZY_MAX_THREADS
) >= 0)
3753 #if defined(HAVE_LIBEXPAT)
3756 start_thread (struct gdb_xml_parser
*parser
,
3757 const struct gdb_xml_element
*element
,
3759 std::vector
<gdb_xml_value
> &attributes
)
3761 struct threads_listing_context
*data
3762 = (struct threads_listing_context
*) user_data
;
3763 struct gdb_xml_value
*attr
;
3765 char *id
= (char *) xml_find_attribute (attributes
, "id")->value
.get ();
3766 ptid_t ptid
= read_ptid (id
, NULL
);
3768 data
->items
.emplace_back (ptid
);
3769 thread_item
&item
= data
->items
.back ();
3771 attr
= xml_find_attribute (attributes
, "core");
3773 item
.core
= *(ULONGEST
*) attr
->value
.get ();
3775 attr
= xml_find_attribute (attributes
, "name");
3777 item
.name
= (const char *) attr
->value
.get ();
3779 attr
= xml_find_attribute (attributes
, "handle");
3781 item
.thread_handle
= hex2bin ((const char *) attr
->value
.get ());
3785 end_thread (struct gdb_xml_parser
*parser
,
3786 const struct gdb_xml_element
*element
,
3787 void *user_data
, const char *body_text
)
3789 struct threads_listing_context
*data
3790 = (struct threads_listing_context
*) user_data
;
3792 if (body_text
!= NULL
&& *body_text
!= '\0')
3793 data
->items
.back ().extra
= body_text
;
3796 const struct gdb_xml_attribute thread_attributes
[] = {
3797 { "id", GDB_XML_AF_NONE
, NULL
, NULL
},
3798 { "core", GDB_XML_AF_OPTIONAL
, gdb_xml_parse_attr_ulongest
, NULL
},
3799 { "name", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3800 { "handle", GDB_XML_AF_OPTIONAL
, NULL
, NULL
},
3801 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
3804 const struct gdb_xml_element thread_children
[] = {
3805 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3808 const struct gdb_xml_element threads_children
[] = {
3809 { "thread", thread_attributes
, thread_children
,
3810 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
3811 start_thread
, end_thread
},
3812 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3815 const struct gdb_xml_element threads_elements
[] = {
3816 { "threads", NULL
, threads_children
,
3817 GDB_XML_EF_NONE
, NULL
, NULL
},
3818 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
3823 /* List remote threads using qXfer:threads:read. */
3826 remote_target::remote_get_threads_with_qxfer (threads_listing_context
*context
)
3828 #if defined(HAVE_LIBEXPAT)
3829 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
3831 gdb::optional
<gdb::char_vector
> xml
3832 = target_read_stralloc (this, TARGET_OBJECT_THREADS
, NULL
);
3834 if (xml
&& (*xml
)[0] != '\0')
3836 gdb_xml_parse_quick (_("threads"), "threads.dtd",
3837 threads_elements
, xml
->data (), context
);
3847 /* List remote threads using qfThreadInfo/qsThreadInfo. */
3850 remote_target::remote_get_threads_with_qthreadinfo (threads_listing_context
*context
)
3852 struct remote_state
*rs
= get_remote_state ();
3854 if (rs
->use_threadinfo_query
)
3858 putpkt ("qfThreadInfo");
3859 getpkt (&rs
->buf
, 0);
3860 bufp
= rs
->buf
.data ();
3861 if (bufp
[0] != '\0') /* q packet recognized */
3863 while (*bufp
++ == 'm') /* reply contains one or more TID */
3867 ptid_t ptid
= read_ptid (bufp
, &bufp
);
3868 context
->items
.emplace_back (ptid
);
3870 while (*bufp
++ == ','); /* comma-separated list */
3871 putpkt ("qsThreadInfo");
3872 getpkt (&rs
->buf
, 0);
3873 bufp
= rs
->buf
.data ();
3879 /* Packet not recognized. */
3880 rs
->use_threadinfo_query
= 0;
3887 /* Return true if INF only has one non-exited thread. */
3890 has_single_non_exited_thread (inferior
*inf
)
3893 for (thread_info
*tp ATTRIBUTE_UNUSED
: inf
->non_exited_threads ())
3899 /* Implement the to_update_thread_list function for the remote
3903 remote_target::update_thread_list ()
3905 struct threads_listing_context context
;
3908 /* We have a few different mechanisms to fetch the thread list. Try
3909 them all, starting with the most preferred one first, falling
3910 back to older methods. */
3911 if (remote_get_threads_with_qxfer (&context
)
3912 || remote_get_threads_with_qthreadinfo (&context
)
3913 || remote_get_threads_with_ql (&context
))
3917 if (context
.items
.empty ()
3918 && remote_thread_always_alive (inferior_ptid
))
3920 /* Some targets don't really support threads, but still
3921 reply an (empty) thread list in response to the thread
3922 listing packets, instead of replying "packet not
3923 supported". Exit early so we don't delete the main
3928 /* CONTEXT now holds the current thread list on the remote
3929 target end. Delete GDB-side threads no longer found on the
3931 for (thread_info
*tp
: all_threads_safe ())
3933 if (tp
->inf
->process_target () != this)
3936 if (!context
.contains_thread (tp
->ptid
))
3938 /* Do not remove the thread if it is the last thread in
3939 the inferior. This situation happens when we have a
3940 pending exit process status to process. Otherwise we
3941 may end up with a seemingly live inferior (i.e. pid
3942 != 0) that has no threads. */
3943 if (has_single_non_exited_thread (tp
->inf
))
3951 /* Remove any unreported fork child threads from CONTEXT so
3952 that we don't interfere with follow fork, which is where
3953 creation of such threads is handled. */
3954 remove_new_fork_children (&context
);
3956 /* And now add threads we don't know about yet to our list. */
3957 for (thread_item
&item
: context
.items
)
3959 if (item
.ptid
!= null_ptid
)
3961 /* In non-stop mode, we assume new found threads are
3962 executing until proven otherwise with a stop reply.
3963 In all-stop, we can only get here if all threads are
3965 bool executing
= target_is_non_stop_p ();
3967 remote_notice_new_inferior (item
.ptid
, executing
);
3969 thread_info
*tp
= find_thread_ptid (this, item
.ptid
);
3970 remote_thread_info
*info
= get_remote_thread_info (tp
);
3971 info
->core
= item
.core
;
3972 info
->extra
= std::move (item
.extra
);
3973 info
->name
= std::move (item
.name
);
3974 info
->thread_handle
= std::move (item
.thread_handle
);
3981 /* If no thread listing method is supported, then query whether
3982 each known thread is alive, one by one, with the T packet.
3983 If the target doesn't support threads at all, then this is a
3984 no-op. See remote_thread_alive. */
3990 * Collect a descriptive string about the given thread.
3991 * The target may say anything it wants to about the thread
3992 * (typically info about its blocked / runnable state, name, etc.).
3993 * This string will appear in the info threads display.
3995 * Optional: targets are not required to implement this function.
3999 remote_target::extra_thread_info (thread_info
*tp
)
4001 struct remote_state
*rs
= get_remote_state ();
4004 struct gdb_ext_thread_info threadinfo
;
4006 if (rs
->remote_desc
== 0) /* paranoia */
4007 internal_error (__FILE__
, __LINE__
,
4008 _("remote_threads_extra_info"));
4010 if (tp
->ptid
== magic_null_ptid
4011 || (tp
->ptid
.pid () != 0 && tp
->ptid
.lwp () == 0))
4012 /* This is the main thread which was added by GDB. The remote
4013 server doesn't know about it. */
4016 std::string
&extra
= get_remote_thread_info (tp
)->extra
;
4018 /* If already have cached info, use it. */
4019 if (!extra
.empty ())
4020 return extra
.c_str ();
4022 if (packet_support (PACKET_qXfer_threads
) == PACKET_ENABLE
)
4024 /* If we're using qXfer:threads:read, then the extra info is
4025 included in the XML. So if we didn't have anything cached,
4026 it's because there's really no extra info. */
4030 if (rs
->use_threadextra_query
)
4032 char *b
= rs
->buf
.data ();
4033 char *endb
= b
+ get_remote_packet_size ();
4035 xsnprintf (b
, endb
- b
, "qThreadExtraInfo,");
4037 write_ptid (b
, endb
, tp
->ptid
);
4040 getpkt (&rs
->buf
, 0);
4041 if (rs
->buf
[0] != 0)
4043 extra
.resize (strlen (rs
->buf
.data ()) / 2);
4044 hex2bin (rs
->buf
.data (), (gdb_byte
*) &extra
[0], extra
.size ());
4045 return extra
.c_str ();
4049 /* If the above query fails, fall back to the old method. */
4050 rs
->use_threadextra_query
= 0;
4051 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
4052 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
4053 int_to_threadref (&id
, tp
->ptid
.lwp ());
4054 if (remote_get_threadinfo (&id
, set
, &threadinfo
))
4055 if (threadinfo
.active
)
4057 if (*threadinfo
.shortname
)
4058 string_appendf (extra
, " Name: %s", threadinfo
.shortname
);
4059 if (*threadinfo
.display
)
4061 if (!extra
.empty ())
4063 string_appendf (extra
, " State: %s", threadinfo
.display
);
4065 if (*threadinfo
.more_display
)
4067 if (!extra
.empty ())
4069 string_appendf (extra
, " Priority: %s", threadinfo
.more_display
);
4071 return extra
.c_str ();
4078 remote_target::static_tracepoint_marker_at (CORE_ADDR addr
,
4079 struct static_tracepoint_marker
*marker
)
4081 struct remote_state
*rs
= get_remote_state ();
4082 char *p
= rs
->buf
.data ();
4084 xsnprintf (p
, get_remote_packet_size (), "qTSTMat:");
4086 p
+= hexnumstr (p
, addr
);
4088 getpkt (&rs
->buf
, 0);
4089 p
= rs
->buf
.data ();
4092 error (_("Remote failure reply: %s"), p
);
4096 parse_static_tracepoint_marker_definition (p
, NULL
, marker
);
4103 std::vector
<static_tracepoint_marker
>
4104 remote_target::static_tracepoint_markers_by_strid (const char *strid
)
4106 struct remote_state
*rs
= get_remote_state ();
4107 std::vector
<static_tracepoint_marker
> markers
;
4109 static_tracepoint_marker marker
;
4111 /* Ask for a first packet of static tracepoint marker
4114 getpkt (&rs
->buf
, 0);
4115 p
= rs
->buf
.data ();
4117 error (_("Remote failure reply: %s"), p
);
4123 parse_static_tracepoint_marker_definition (p
, &p
, &marker
);
4125 if (strid
== NULL
|| marker
.str_id
== strid
)
4126 markers
.push_back (std::move (marker
));
4128 while (*p
++ == ','); /* comma-separated list */
4129 /* Ask for another packet of static tracepoint definition. */
4131 getpkt (&rs
->buf
, 0);
4132 p
= rs
->buf
.data ();
4139 /* Implement the to_get_ada_task_ptid function for the remote targets. */
4142 remote_target::get_ada_task_ptid (long lwp
, long thread
)
4144 return ptid_t (inferior_ptid
.pid (), lwp
, 0);
4148 /* Restart the remote side; this is an extended protocol operation. */
4151 remote_target::extended_remote_restart ()
4153 struct remote_state
*rs
= get_remote_state ();
4155 /* Send the restart command; for reasons I don't understand the
4156 remote side really expects a number after the "R". */
4157 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "R%x", 0);
4160 remote_fileio_reset ();
4163 /* Clean up connection to a remote debugger. */
4166 remote_target::close ()
4168 /* Make sure we leave stdin registered in the event loop. */
4171 trace_reset_local_state ();
4176 remote_target::~remote_target ()
4178 struct remote_state
*rs
= get_remote_state ();
4180 /* Check for NULL because we may get here with a partially
4181 constructed target/connection. */
4182 if (rs
->remote_desc
== nullptr)
4185 serial_close (rs
->remote_desc
);
4187 /* We are destroying the remote target, so we should discard
4188 everything of this target. */
4189 discard_pending_stop_replies_in_queue ();
4191 if (rs
->remote_async_inferior_event_token
)
4192 delete_async_event_handler (&rs
->remote_async_inferior_event_token
);
4194 delete rs
->notif_state
;
4197 /* Query the remote side for the text, data and bss offsets. */
4200 remote_target::get_offsets ()
4202 struct remote_state
*rs
= get_remote_state ();
4205 int lose
, num_segments
= 0, do_sections
, do_segments
;
4206 CORE_ADDR text_addr
, data_addr
, bss_addr
, segments
[2];
4208 if (current_program_space
->symfile_object_file
== NULL
)
4211 putpkt ("qOffsets");
4212 getpkt (&rs
->buf
, 0);
4213 buf
= rs
->buf
.data ();
4215 if (buf
[0] == '\000')
4216 return; /* Return silently. Stub doesn't support
4220 warning (_("Remote failure reply: %s"), buf
);
4224 /* Pick up each field in turn. This used to be done with scanf, but
4225 scanf will make trouble if CORE_ADDR size doesn't match
4226 conversion directives correctly. The following code will work
4227 with any size of CORE_ADDR. */
4228 text_addr
= data_addr
= bss_addr
= 0;
4232 if (startswith (ptr
, "Text="))
4235 /* Don't use strtol, could lose on big values. */
4236 while (*ptr
&& *ptr
!= ';')
4237 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4239 if (startswith (ptr
, ";Data="))
4242 while (*ptr
&& *ptr
!= ';')
4243 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4248 if (!lose
&& startswith (ptr
, ";Bss="))
4251 while (*ptr
&& *ptr
!= ';')
4252 bss_addr
= (bss_addr
<< 4) + fromhex (*ptr
++);
4254 if (bss_addr
!= data_addr
)
4255 warning (_("Target reported unsupported offsets: %s"), buf
);
4260 else if (startswith (ptr
, "TextSeg="))
4263 /* Don't use strtol, could lose on big values. */
4264 while (*ptr
&& *ptr
!= ';')
4265 text_addr
= (text_addr
<< 4) + fromhex (*ptr
++);
4268 if (startswith (ptr
, ";DataSeg="))
4271 while (*ptr
&& *ptr
!= ';')
4272 data_addr
= (data_addr
<< 4) + fromhex (*ptr
++);
4280 error (_("Malformed response to offset query, %s"), buf
);
4281 else if (*ptr
!= '\0')
4282 warning (_("Target reported unsupported offsets: %s"), buf
);
4284 objfile
*objf
= current_program_space
->symfile_object_file
;
4285 section_offsets offs
= objf
->section_offsets
;
4287 symfile_segment_data_up data
= get_symfile_segment_data (objf
->obfd
);
4288 do_segments
= (data
!= NULL
);
4289 do_sections
= num_segments
== 0;
4291 if (num_segments
> 0)
4293 segments
[0] = text_addr
;
4294 segments
[1] = data_addr
;
4296 /* If we have two segments, we can still try to relocate everything
4297 by assuming that the .text and .data offsets apply to the whole
4298 text and data segments. Convert the offsets given in the packet
4299 to base addresses for symfile_map_offsets_to_segments. */
4300 else if (data
!= nullptr && data
->segments
.size () == 2)
4302 segments
[0] = data
->segments
[0].base
+ text_addr
;
4303 segments
[1] = data
->segments
[1].base
+ data_addr
;
4306 /* If the object file has only one segment, assume that it is text
4307 rather than data; main programs with no writable data are rare,
4308 but programs with no code are useless. Of course the code might
4309 have ended up in the data segment... to detect that we would need
4310 the permissions here. */
4311 else if (data
&& data
->segments
.size () == 1)
4313 segments
[0] = data
->segments
[0].base
+ text_addr
;
4316 /* There's no way to relocate by segment. */
4322 int ret
= symfile_map_offsets_to_segments (objf
->obfd
,
4324 num_segments
, segments
);
4326 if (ret
== 0 && !do_sections
)
4327 error (_("Can not handle qOffsets TextSeg "
4328 "response with this symbol file"));
4336 offs
[SECT_OFF_TEXT (objf
)] = text_addr
;
4338 /* This is a temporary kludge to force data and bss to use the
4339 same offsets because that's what nlmconv does now. The real
4340 solution requires changes to the stub and remote.c that I
4341 don't have time to do right now. */
4343 offs
[SECT_OFF_DATA (objf
)] = data_addr
;
4344 offs
[SECT_OFF_BSS (objf
)] = data_addr
;
4347 objfile_relocate (objf
, offs
);
4350 /* Send interrupt_sequence to remote target. */
4353 remote_target::send_interrupt_sequence ()
4355 struct remote_state
*rs
= get_remote_state ();
4357 if (interrupt_sequence_mode
== interrupt_sequence_control_c
)
4358 remote_serial_write ("\x03", 1);
4359 else if (interrupt_sequence_mode
== interrupt_sequence_break
)
4360 serial_send_break (rs
->remote_desc
);
4361 else if (interrupt_sequence_mode
== interrupt_sequence_break_g
)
4363 serial_send_break (rs
->remote_desc
);
4364 remote_serial_write ("g", 1);
4367 internal_error (__FILE__
, __LINE__
,
4368 _("Invalid value for interrupt_sequence_mode: %s."),
4369 interrupt_sequence_mode
);
4373 /* If STOP_REPLY is a T stop reply, look for the "thread" register,
4374 and extract the PTID. Returns NULL_PTID if not found. */
4377 stop_reply_extract_thread (const char *stop_reply
)
4379 if (stop_reply
[0] == 'T' && strlen (stop_reply
) > 3)
4383 /* Txx r:val ; r:val (...) */
4386 /* Look for "register" named "thread". */
4391 p1
= strchr (p
, ':');
4395 if (strncmp (p
, "thread", p1
- p
) == 0)
4396 return read_ptid (++p1
, &p
);
4398 p1
= strchr (p
, ';');
4410 /* Determine the remote side's current thread. If we have a stop
4411 reply handy (in WAIT_STATUS), maybe it's a T stop reply with a
4412 "thread" register we can extract the current thread from. If not,
4413 ask the remote which is the current thread with qC. The former
4414 method avoids a roundtrip. */
4417 remote_target::get_current_thread (const char *wait_status
)
4419 ptid_t ptid
= null_ptid
;
4421 /* Note we don't use remote_parse_stop_reply as that makes use of
4422 the target architecture, which we haven't yet fully determined at
4424 if (wait_status
!= NULL
)
4425 ptid
= stop_reply_extract_thread (wait_status
);
4426 if (ptid
== null_ptid
)
4427 ptid
= remote_current_thread (inferior_ptid
);
4432 /* Query the remote target for which is the current thread/process,
4433 add it to our tables, and update INFERIOR_PTID. The caller is
4434 responsible for setting the state such that the remote end is ready
4435 to return the current thread.
4437 This function is called after handling the '?' or 'vRun' packets,
4438 whose response is a stop reply from which we can also try
4439 extracting the thread. If the target doesn't support the explicit
4440 qC query, we infer the current thread from that stop reply, passed
4441 in in WAIT_STATUS, which may be NULL.
4443 The function returns pointer to the main thread of the inferior. */
4446 remote_target::add_current_inferior_and_thread (const char *wait_status
)
4448 struct remote_state
*rs
= get_remote_state ();
4449 bool fake_pid_p
= false;
4451 switch_to_no_thread ();
4453 /* Now, if we have thread information, update the current thread's
4455 ptid_t curr_ptid
= get_current_thread (wait_status
);
4457 if (curr_ptid
!= null_ptid
)
4459 if (!remote_multi_process_p (rs
))
4464 /* Without this, some commands which require an active target
4465 (such as kill) won't work. This variable serves (at least)
4466 double duty as both the pid of the target process (if it has
4467 such), and as a flag indicating that a target is active. */
4468 curr_ptid
= magic_null_ptid
;
4472 remote_add_inferior (fake_pid_p
, curr_ptid
.pid (), -1, 1);
4474 /* Add the main thread and switch to it. Don't try reading
4475 registers yet, since we haven't fetched the target description
4477 thread_info
*tp
= add_thread_silent (this, curr_ptid
);
4478 switch_to_thread_no_regs (tp
);
4483 /* Print info about a thread that was found already stopped on
4487 print_one_stopped_thread (struct thread_info
*thread
)
4489 struct target_waitstatus
*ws
= &thread
->suspend
.waitstatus
;
4491 switch_to_thread (thread
);
4492 thread
->suspend
.stop_pc
= get_frame_pc (get_current_frame ());
4493 set_current_sal_from_frame (get_current_frame ());
4495 thread
->suspend
.waitstatus_pending_p
= 0;
4497 if (ws
->kind
== TARGET_WAITKIND_STOPPED
)
4499 enum gdb_signal sig
= ws
->value
.sig
;
4501 if (signal_print_state (sig
))
4502 gdb::observers::signal_received
.notify (sig
);
4504 gdb::observers::normal_stop
.notify (NULL
, 1);
4507 /* Process all initial stop replies the remote side sent in response
4508 to the ? packet. These indicate threads that were already stopped
4509 on initial connection. We mark these threads as stopped and print
4510 their current frame before giving the user the prompt. */
4513 remote_target::process_initial_stop_replies (int from_tty
)
4515 int pending_stop_replies
= stop_reply_queue_length ();
4516 struct thread_info
*selected
= NULL
;
4517 struct thread_info
*lowest_stopped
= NULL
;
4518 struct thread_info
*first
= NULL
;
4520 /* Consume the initial pending events. */
4521 while (pending_stop_replies
-- > 0)
4523 ptid_t waiton_ptid
= minus_one_ptid
;
4525 struct target_waitstatus ws
;
4526 int ignore_event
= 0;
4528 memset (&ws
, 0, sizeof (ws
));
4529 event_ptid
= target_wait (waiton_ptid
, &ws
, TARGET_WNOHANG
);
4531 print_target_wait_results (waiton_ptid
, event_ptid
, &ws
);
4535 case TARGET_WAITKIND_IGNORE
:
4536 case TARGET_WAITKIND_NO_RESUMED
:
4537 case TARGET_WAITKIND_SIGNALLED
:
4538 case TARGET_WAITKIND_EXITED
:
4539 /* We shouldn't see these, but if we do, just ignore. */
4540 remote_debug_printf ("event ignored");
4544 case TARGET_WAITKIND_EXECD
:
4545 xfree (ws
.value
.execd_pathname
);
4554 thread_info
*evthread
= find_thread_ptid (this, event_ptid
);
4556 if (ws
.kind
== TARGET_WAITKIND_STOPPED
)
4558 enum gdb_signal sig
= ws
.value
.sig
;
4560 /* Stubs traditionally report SIGTRAP as initial signal,
4561 instead of signal 0. Suppress it. */
4562 if (sig
== GDB_SIGNAL_TRAP
)
4564 evthread
->suspend
.stop_signal
= sig
;
4568 evthread
->suspend
.waitstatus
= ws
;
4570 if (ws
.kind
!= TARGET_WAITKIND_STOPPED
4571 || ws
.value
.sig
!= GDB_SIGNAL_0
)
4572 evthread
->suspend
.waitstatus_pending_p
= 1;
4574 set_executing (this, event_ptid
, false);
4575 set_running (this, event_ptid
, false);
4576 get_remote_thread_info (evthread
)->set_not_resumed ();
4579 /* "Notice" the new inferiors before anything related to
4580 registers/memory. */
4581 for (inferior
*inf
: all_non_exited_inferiors (this))
4583 inf
->needs_setup
= 1;
4587 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4588 notice_new_inferior (thread
, thread
->state
== THREAD_RUNNING
,
4593 /* If all-stop on top of non-stop, pause all threads. Note this
4594 records the threads' stop pc, so must be done after "noticing"
4598 stop_all_threads ("remote connect in all-stop");
4600 /* If all threads of an inferior were already stopped, we
4601 haven't setup the inferior yet. */
4602 for (inferior
*inf
: all_non_exited_inferiors (this))
4604 if (inf
->needs_setup
)
4606 thread_info
*thread
= any_live_thread_of_inferior (inf
);
4607 switch_to_thread_no_regs (thread
);
4613 /* Now go over all threads that are stopped, and print their current
4614 frame. If all-stop, then if there's a signalled thread, pick
4616 for (thread_info
*thread
: all_non_exited_threads (this))
4622 thread
->set_running (false);
4623 else if (thread
->state
!= THREAD_STOPPED
)
4626 if (selected
== NULL
4627 && thread
->suspend
.waitstatus_pending_p
)
4630 if (lowest_stopped
== NULL
4631 || thread
->inf
->num
< lowest_stopped
->inf
->num
4632 || thread
->per_inf_num
< lowest_stopped
->per_inf_num
)
4633 lowest_stopped
= thread
;
4636 print_one_stopped_thread (thread
);
4639 /* In all-stop, we only print the status of one thread, and leave
4640 others with their status pending. */
4643 thread_info
*thread
= selected
;
4645 thread
= lowest_stopped
;
4649 print_one_stopped_thread (thread
);
4652 /* For "info program". */
4653 thread_info
*thread
= inferior_thread ();
4654 if (thread
->state
== THREAD_STOPPED
)
4655 set_last_target_status (this, inferior_ptid
, thread
->suspend
.waitstatus
);
4658 /* Start the remote connection and sync state. */
4661 remote_target::start_remote (int from_tty
, int extended_p
)
4663 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
4665 struct remote_state
*rs
= get_remote_state ();
4666 struct packet_config
*noack_config
;
4668 /* Signal other parts that we're going through the initial setup,
4669 and so things may not be stable yet. E.g., we don't try to
4670 install tracepoints until we've relocated symbols. Also, a
4671 Ctrl-C before we're connected and synced up can't interrupt the
4672 target. Instead, it offers to drop the (potentially wedged)
4674 rs
->starting_up
= true;
4678 if (interrupt_on_connect
)
4679 send_interrupt_sequence ();
4681 /* Ack any packet which the remote side has already sent. */
4682 remote_serial_write ("+", 1);
4684 /* The first packet we send to the target is the optional "supported
4685 packets" request. If the target can answer this, it will tell us
4686 which later probes to skip. */
4687 remote_query_supported ();
4689 /* If the stub wants to get a QAllow, compose one and send it. */
4690 if (packet_support (PACKET_QAllow
) != PACKET_DISABLE
)
4693 /* gdbserver < 7.7 (before its fix from 2013-12-11) did reply to any
4694 unknown 'v' packet with string "OK". "OK" gets interpreted by GDB
4695 as a reply to known packet. For packet "vFile:setfs:" it is an
4696 invalid reply and GDB would return error in
4697 remote_hostio_set_filesystem, making remote files access impossible.
4698 Disable "vFile:setfs:" in such case. Do not disable other 'v' packets as
4699 other "vFile" packets get correctly detected even on gdbserver < 7.7. */
4701 const char v_mustreplyempty
[] = "vMustReplyEmpty";
4703 putpkt (v_mustreplyempty
);
4704 getpkt (&rs
->buf
, 0);
4705 if (strcmp (rs
->buf
.data (), "OK") == 0)
4706 remote_protocol_packets
[PACKET_vFile_setfs
].support
= PACKET_DISABLE
;
4707 else if (strcmp (rs
->buf
.data (), "") != 0)
4708 error (_("Remote replied unexpectedly to '%s': %s"), v_mustreplyempty
,
4712 /* Next, we possibly activate noack mode.
4714 If the QStartNoAckMode packet configuration is set to AUTO,
4715 enable noack mode if the stub reported a wish for it with
4718 If set to TRUE, then enable noack mode even if the stub didn't
4719 report it in qSupported. If the stub doesn't reply OK, the
4720 session ends with an error.
4722 If FALSE, then don't activate noack mode, regardless of what the
4723 stub claimed should be the default with qSupported. */
4725 noack_config
= &remote_protocol_packets
[PACKET_QStartNoAckMode
];
4726 if (packet_config_support (noack_config
) != PACKET_DISABLE
)
4728 putpkt ("QStartNoAckMode");
4729 getpkt (&rs
->buf
, 0);
4730 if (packet_ok (rs
->buf
, noack_config
) == PACKET_OK
)
4736 /* Tell the remote that we are using the extended protocol. */
4738 getpkt (&rs
->buf
, 0);
4741 /* Let the target know which signals it is allowed to pass down to
4743 update_signals_program_target ();
4745 /* Next, if the target can specify a description, read it. We do
4746 this before anything involving memory or registers. */
4747 target_find_description ();
4749 /* Next, now that we know something about the target, update the
4750 address spaces in the program spaces. */
4751 update_address_spaces ();
4753 /* On OSs where the list of libraries is global to all
4754 processes, we fetch them early. */
4755 if (gdbarch_has_global_solist (target_gdbarch ()))
4756 solib_add (NULL
, from_tty
, auto_solib_add
);
4758 if (target_is_non_stop_p ())
4760 if (packet_support (PACKET_QNonStop
) != PACKET_ENABLE
)
4761 error (_("Non-stop mode requested, but remote "
4762 "does not support non-stop"));
4764 putpkt ("QNonStop:1");
4765 getpkt (&rs
->buf
, 0);
4767 if (strcmp (rs
->buf
.data (), "OK") != 0)
4768 error (_("Remote refused setting non-stop mode with: %s"),
4771 /* Find about threads and processes the stub is already
4772 controlling. We default to adding them in the running state.
4773 The '?' query below will then tell us about which threads are
4775 this->update_thread_list ();
4777 else if (packet_support (PACKET_QNonStop
) == PACKET_ENABLE
)
4779 /* Don't assume that the stub can operate in all-stop mode.
4780 Request it explicitly. */
4781 putpkt ("QNonStop:0");
4782 getpkt (&rs
->buf
, 0);
4784 if (strcmp (rs
->buf
.data (), "OK") != 0)
4785 error (_("Remote refused setting all-stop mode with: %s"),
4789 /* Upload TSVs regardless of whether the target is running or not. The
4790 remote stub, such as GDBserver, may have some predefined or builtin
4791 TSVs, even if the target is not running. */
4792 if (get_trace_status (current_trace_status ()) != -1)
4794 struct uploaded_tsv
*uploaded_tsvs
= NULL
;
4796 upload_trace_state_variables (&uploaded_tsvs
);
4797 merge_uploaded_trace_state_variables (&uploaded_tsvs
);
4800 /* Check whether the target is running now. */
4802 getpkt (&rs
->buf
, 0);
4804 if (!target_is_non_stop_p ())
4806 char *wait_status
= NULL
;
4808 if (rs
->buf
[0] == 'W' || rs
->buf
[0] == 'X')
4811 error (_("The target is not running (try extended-remote?)"));
4813 /* We're connected, but not running. Drop out before we
4814 call start_remote. */
4815 rs
->starting_up
= false;
4820 /* Save the reply for later. */
4821 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
4822 strcpy (wait_status
, rs
->buf
.data ());
4825 /* Fetch thread list. */
4826 target_update_thread_list ();
4828 /* Let the stub know that we want it to return the thread. */
4829 set_continue_thread (minus_one_ptid
);
4831 if (thread_count (this) == 0)
4833 /* Target has no concept of threads at all. GDB treats
4834 non-threaded target as single-threaded; add a main
4836 thread_info
*tp
= add_current_inferior_and_thread (wait_status
);
4837 get_remote_thread_info (tp
)->set_resumed ();
4841 /* We have thread information; select the thread the target
4842 says should be current. If we're reconnecting to a
4843 multi-threaded program, this will ideally be the thread
4844 that last reported an event before GDB disconnected. */
4845 ptid_t curr_thread
= get_current_thread (wait_status
);
4846 if (curr_thread
== null_ptid
)
4848 /* Odd... The target was able to list threads, but not
4849 tell us which thread was current (no "thread"
4850 register in T stop reply?). Just pick the first
4851 thread in the thread list then. */
4853 remote_debug_printf ("warning: couldn't determine remote "
4854 "current thread; picking first in list.");
4856 for (thread_info
*tp
: all_non_exited_threads (this,
4859 switch_to_thread (tp
);
4864 switch_to_thread (find_thread_ptid (this, curr_thread
));
4867 /* init_wait_for_inferior should be called before get_offsets in order
4868 to manage `inserted' flag in bp loc in a correct state.
4869 breakpoint_init_inferior, called from init_wait_for_inferior, set
4870 `inserted' flag to 0, while before breakpoint_re_set, called from
4871 start_remote, set `inserted' flag to 1. In the initialization of
4872 inferior, breakpoint_init_inferior should be called first, and then
4873 breakpoint_re_set can be called. If this order is broken, state of
4874 `inserted' flag is wrong, and cause some problems on breakpoint
4876 init_wait_for_inferior ();
4878 get_offsets (); /* Get text, data & bss offsets. */
4880 /* If we could not find a description using qXfer, and we know
4881 how to do it some other way, try again. This is not
4882 supported for non-stop; it could be, but it is tricky if
4883 there are no stopped threads when we connect. */
4884 if (remote_read_description_p (this)
4885 && gdbarch_target_desc (target_gdbarch ()) == NULL
)
4887 target_clear_description ();
4888 target_find_description ();
4891 /* Use the previously fetched status. */
4892 gdb_assert (wait_status
!= NULL
);
4893 strcpy (rs
->buf
.data (), wait_status
);
4894 rs
->cached_wait_status
= 1;
4896 ::start_remote (from_tty
); /* Initialize gdb process mechanisms. */
4900 /* Clear WFI global state. Do this before finding about new
4901 threads and inferiors, and setting the current inferior.
4902 Otherwise we would clear the proceed status of the current
4903 inferior when we want its stop_soon state to be preserved
4904 (see notice_new_inferior). */
4905 init_wait_for_inferior ();
4907 /* In non-stop, we will either get an "OK", meaning that there
4908 are no stopped threads at this time; or, a regular stop
4909 reply. In the latter case, there may be more than one thread
4910 stopped --- we pull them all out using the vStopped
4912 if (strcmp (rs
->buf
.data (), "OK") != 0)
4914 struct notif_client
*notif
= ¬if_client_stop
;
4916 /* remote_notif_get_pending_replies acks this one, and gets
4918 rs
->notif_state
->pending_event
[notif_client_stop
.id
]
4919 = remote_notif_parse (this, notif
, rs
->buf
.data ());
4920 remote_notif_get_pending_events (notif
);
4923 if (thread_count (this) == 0)
4926 error (_("The target is not running (try extended-remote?)"));
4928 /* We're connected, but not running. Drop out before we
4929 call start_remote. */
4930 rs
->starting_up
= false;
4934 /* Report all signals during attach/startup. */
4937 /* If there are already stopped threads, mark them stopped and
4938 report their stops before giving the prompt to the user. */
4939 process_initial_stop_replies (from_tty
);
4941 if (target_can_async_p ())
4945 /* If we connected to a live target, do some additional setup. */
4946 if (target_has_execution ())
4948 /* No use without a symbol-file. */
4949 if (current_program_space
->symfile_object_file
)
4950 remote_check_symbols ();
4953 /* Possibly the target has been engaged in a trace run started
4954 previously; find out where things are at. */
4955 if (get_trace_status (current_trace_status ()) != -1)
4957 struct uploaded_tp
*uploaded_tps
= NULL
;
4959 if (current_trace_status ()->running
)
4960 printf_filtered (_("Trace is already running on the target.\n"));
4962 upload_tracepoints (&uploaded_tps
);
4964 merge_uploaded_tracepoints (&uploaded_tps
);
4967 /* Possibly the target has been engaged in a btrace record started
4968 previously; find out where things are at. */
4969 remote_btrace_maybe_reopen ();
4971 /* The thread and inferior lists are now synchronized with the
4972 target, our symbols have been relocated, and we're merged the
4973 target's tracepoints with ours. We're done with basic start
4975 rs
->starting_up
= false;
4977 /* Maybe breakpoints are global and need to be inserted now. */
4978 if (breakpoints_should_be_inserted_now ())
4979 insert_breakpoints ();
4983 remote_target::connection_string ()
4985 remote_state
*rs
= get_remote_state ();
4987 if (rs
->remote_desc
->name
!= NULL
)
4988 return rs
->remote_desc
->name
;
4993 /* Open a connection to a remote debugger.
4994 NAME is the filename used for communication. */
4997 remote_target::open (const char *name
, int from_tty
)
4999 open_1 (name
, from_tty
, 0);
5002 /* Open a connection to a remote debugger using the extended
5003 remote gdb protocol. NAME is the filename used for communication. */
5006 extended_remote_target::open (const char *name
, int from_tty
)
5008 open_1 (name
, from_tty
, 1 /*extended_p */);
5011 /* Reset all packets back to "unknown support". Called when opening a
5012 new connection to a remote target. */
5015 reset_all_packet_configs_support (void)
5019 for (i
= 0; i
< PACKET_MAX
; i
++)
5020 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5023 /* Initialize all packet configs. */
5026 init_all_packet_configs (void)
5030 for (i
= 0; i
< PACKET_MAX
; i
++)
5032 remote_protocol_packets
[i
].detect
= AUTO_BOOLEAN_AUTO
;
5033 remote_protocol_packets
[i
].support
= PACKET_SUPPORT_UNKNOWN
;
5037 /* Symbol look-up. */
5040 remote_target::remote_check_symbols ()
5045 /* The remote side has no concept of inferiors that aren't running
5046 yet, it only knows about running processes. If we're connected
5047 but our current inferior is not running, we should not invite the
5048 remote target to request symbol lookups related to its
5049 (unrelated) current process. */
5050 if (!target_has_execution ())
5053 if (packet_support (PACKET_qSymbol
) == PACKET_DISABLE
)
5056 /* Make sure the remote is pointing at the right process. Note
5057 there's no way to select "no process". */
5058 set_general_process ();
5060 /* Allocate a message buffer. We can't reuse the input buffer in RS,
5061 because we need both at the same time. */
5062 gdb::char_vector
msg (get_remote_packet_size ());
5063 gdb::char_vector
reply (get_remote_packet_size ());
5065 /* Invite target to request symbol lookups. */
5067 putpkt ("qSymbol::");
5069 packet_ok (reply
, &remote_protocol_packets
[PACKET_qSymbol
]);
5071 while (startswith (reply
.data (), "qSymbol:"))
5073 struct bound_minimal_symbol sym
;
5076 end
= hex2bin (tmp
, reinterpret_cast <gdb_byte
*> (msg
.data ()),
5079 sym
= lookup_minimal_symbol (msg
.data (), NULL
, NULL
);
5080 if (sym
.minsym
== NULL
)
5081 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol::%s",
5085 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
5086 CORE_ADDR sym_addr
= BMSYMBOL_VALUE_ADDRESS (sym
);
5088 /* If this is a function address, return the start of code
5089 instead of any data function descriptor. */
5090 sym_addr
= gdbarch_convert_from_func_ptr_addr
5091 (target_gdbarch (), sym_addr
, current_inferior ()->top_target ());
5093 xsnprintf (msg
.data (), get_remote_packet_size (), "qSymbol:%s:%s",
5094 phex_nz (sym_addr
, addr_size
), &reply
[8]);
5097 putpkt (msg
.data ());
5102 static struct serial
*
5103 remote_serial_open (const char *name
)
5105 static int udp_warning
= 0;
5107 /* FIXME: Parsing NAME here is a hack. But we want to warn here instead
5108 of in ser-tcp.c, because it is the remote protocol assuming that the
5109 serial connection is reliable and not the serial connection promising
5111 if (!udp_warning
&& startswith (name
, "udp:"))
5113 warning (_("The remote protocol may be unreliable over UDP.\n"
5114 "Some events may be lost, rendering further debugging "
5119 return serial_open (name
);
5122 /* Inform the target of our permission settings. The permission flags
5123 work without this, but if the target knows the settings, it can do
5124 a couple things. First, it can add its own check, to catch cases
5125 that somehow manage to get by the permissions checks in target
5126 methods. Second, if the target is wired to disallow particular
5127 settings (for instance, a system in the field that is not set up to
5128 be able to stop at a breakpoint), it can object to any unavailable
5132 remote_target::set_permissions ()
5134 struct remote_state
*rs
= get_remote_state ();
5136 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAllow:"
5137 "WriteReg:%x;WriteMem:%x;"
5138 "InsertBreak:%x;InsertTrace:%x;"
5139 "InsertFastTrace:%x;Stop:%x",
5140 may_write_registers
, may_write_memory
,
5141 may_insert_breakpoints
, may_insert_tracepoints
,
5142 may_insert_fast_tracepoints
, may_stop
);
5144 getpkt (&rs
->buf
, 0);
5146 /* If the target didn't like the packet, warn the user. Do not try
5147 to undo the user's settings, that would just be maddening. */
5148 if (strcmp (rs
->buf
.data (), "OK") != 0)
5149 warning (_("Remote refused setting permissions with: %s"),
5153 /* This type describes each known response to the qSupported
5155 struct protocol_feature
5157 /* The name of this protocol feature. */
5160 /* The default for this protocol feature. */
5161 enum packet_support default_support
;
5163 /* The function to call when this feature is reported, or after
5164 qSupported processing if the feature is not supported.
5165 The first argument points to this structure. The second
5166 argument indicates whether the packet requested support be
5167 enabled, disabled, or probed (or the default, if this function
5168 is being called at the end of processing and this feature was
5169 not reported). The third argument may be NULL; if not NULL, it
5170 is a NUL-terminated string taken from the packet following
5171 this feature's name and an equals sign. */
5172 void (*func
) (remote_target
*remote
, const struct protocol_feature
*,
5173 enum packet_support
, const char *);
5175 /* The corresponding packet for this feature. Only used if
5176 FUNC is remote_supported_packet. */
5181 remote_supported_packet (remote_target
*remote
,
5182 const struct protocol_feature
*feature
,
5183 enum packet_support support
,
5184 const char *argument
)
5188 warning (_("Remote qSupported response supplied an unexpected value for"
5189 " \"%s\"."), feature
->name
);
5193 remote_protocol_packets
[feature
->packet
].support
= support
;
5197 remote_target::remote_packet_size (const protocol_feature
*feature
,
5198 enum packet_support support
, const char *value
)
5200 struct remote_state
*rs
= get_remote_state ();
5205 if (support
!= PACKET_ENABLE
)
5208 if (value
== NULL
|| *value
== '\0')
5210 warning (_("Remote target reported \"%s\" without a size."),
5216 packet_size
= strtol (value
, &value_end
, 16);
5217 if (errno
!= 0 || *value_end
!= '\0' || packet_size
< 0)
5219 warning (_("Remote target reported \"%s\" with a bad size: \"%s\"."),
5220 feature
->name
, value
);
5224 /* Record the new maximum packet size. */
5225 rs
->explicit_packet_size
= packet_size
;
5229 remote_packet_size (remote_target
*remote
, const protocol_feature
*feature
,
5230 enum packet_support support
, const char *value
)
5232 remote
->remote_packet_size (feature
, support
, value
);
5235 static const struct protocol_feature remote_protocol_features
[] = {
5236 { "PacketSize", PACKET_DISABLE
, remote_packet_size
, -1 },
5237 { "qXfer:auxv:read", PACKET_DISABLE
, remote_supported_packet
,
5238 PACKET_qXfer_auxv
},
5239 { "qXfer:exec-file:read", PACKET_DISABLE
, remote_supported_packet
,
5240 PACKET_qXfer_exec_file
},
5241 { "qXfer:features:read", PACKET_DISABLE
, remote_supported_packet
,
5242 PACKET_qXfer_features
},
5243 { "qXfer:libraries:read", PACKET_DISABLE
, remote_supported_packet
,
5244 PACKET_qXfer_libraries
},
5245 { "qXfer:libraries-svr4:read", PACKET_DISABLE
, remote_supported_packet
,
5246 PACKET_qXfer_libraries_svr4
},
5247 { "augmented-libraries-svr4-read", PACKET_DISABLE
,
5248 remote_supported_packet
, PACKET_augmented_libraries_svr4_read_feature
},
5249 { "qXfer:memory-map:read", PACKET_DISABLE
, remote_supported_packet
,
5250 PACKET_qXfer_memory_map
},
5251 { "qXfer:osdata:read", PACKET_DISABLE
, remote_supported_packet
,
5252 PACKET_qXfer_osdata
},
5253 { "qXfer:threads:read", PACKET_DISABLE
, remote_supported_packet
,
5254 PACKET_qXfer_threads
},
5255 { "qXfer:traceframe-info:read", PACKET_DISABLE
, remote_supported_packet
,
5256 PACKET_qXfer_traceframe_info
},
5257 { "QPassSignals", PACKET_DISABLE
, remote_supported_packet
,
5258 PACKET_QPassSignals
},
5259 { "QCatchSyscalls", PACKET_DISABLE
, remote_supported_packet
,
5260 PACKET_QCatchSyscalls
},
5261 { "QProgramSignals", PACKET_DISABLE
, remote_supported_packet
,
5262 PACKET_QProgramSignals
},
5263 { "QSetWorkingDir", PACKET_DISABLE
, remote_supported_packet
,
5264 PACKET_QSetWorkingDir
},
5265 { "QStartupWithShell", PACKET_DISABLE
, remote_supported_packet
,
5266 PACKET_QStartupWithShell
},
5267 { "QEnvironmentHexEncoded", PACKET_DISABLE
, remote_supported_packet
,
5268 PACKET_QEnvironmentHexEncoded
},
5269 { "QEnvironmentReset", PACKET_DISABLE
, remote_supported_packet
,
5270 PACKET_QEnvironmentReset
},
5271 { "QEnvironmentUnset", PACKET_DISABLE
, remote_supported_packet
,
5272 PACKET_QEnvironmentUnset
},
5273 { "QStartNoAckMode", PACKET_DISABLE
, remote_supported_packet
,
5274 PACKET_QStartNoAckMode
},
5275 { "multiprocess", PACKET_DISABLE
, remote_supported_packet
,
5276 PACKET_multiprocess_feature
},
5277 { "QNonStop", PACKET_DISABLE
, remote_supported_packet
, PACKET_QNonStop
},
5278 { "qXfer:siginfo:read", PACKET_DISABLE
, remote_supported_packet
,
5279 PACKET_qXfer_siginfo_read
},
5280 { "qXfer:siginfo:write", PACKET_DISABLE
, remote_supported_packet
,
5281 PACKET_qXfer_siginfo_write
},
5282 { "ConditionalTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5283 PACKET_ConditionalTracepoints
},
5284 { "ConditionalBreakpoints", PACKET_DISABLE
, remote_supported_packet
,
5285 PACKET_ConditionalBreakpoints
},
5286 { "BreakpointCommands", PACKET_DISABLE
, remote_supported_packet
,
5287 PACKET_BreakpointCommands
},
5288 { "FastTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5289 PACKET_FastTracepoints
},
5290 { "StaticTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5291 PACKET_StaticTracepoints
},
5292 {"InstallInTrace", PACKET_DISABLE
, remote_supported_packet
,
5293 PACKET_InstallInTrace
},
5294 { "DisconnectedTracing", PACKET_DISABLE
, remote_supported_packet
,
5295 PACKET_DisconnectedTracing_feature
},
5296 { "ReverseContinue", PACKET_DISABLE
, remote_supported_packet
,
5298 { "ReverseStep", PACKET_DISABLE
, remote_supported_packet
,
5300 { "TracepointSource", PACKET_DISABLE
, remote_supported_packet
,
5301 PACKET_TracepointSource
},
5302 { "QAllow", PACKET_DISABLE
, remote_supported_packet
,
5304 { "EnableDisableTracepoints", PACKET_DISABLE
, remote_supported_packet
,
5305 PACKET_EnableDisableTracepoints_feature
},
5306 { "qXfer:fdpic:read", PACKET_DISABLE
, remote_supported_packet
,
5307 PACKET_qXfer_fdpic
},
5308 { "qXfer:uib:read", PACKET_DISABLE
, remote_supported_packet
,
5310 { "QDisableRandomization", PACKET_DISABLE
, remote_supported_packet
,
5311 PACKET_QDisableRandomization
},
5312 { "QAgent", PACKET_DISABLE
, remote_supported_packet
, PACKET_QAgent
},
5313 { "QTBuffer:size", PACKET_DISABLE
,
5314 remote_supported_packet
, PACKET_QTBuffer_size
},
5315 { "tracenz", PACKET_DISABLE
, remote_supported_packet
, PACKET_tracenz_feature
},
5316 { "Qbtrace:off", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_off
},
5317 { "Qbtrace:bts", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_bts
},
5318 { "Qbtrace:pt", PACKET_DISABLE
, remote_supported_packet
, PACKET_Qbtrace_pt
},
5319 { "qXfer:btrace:read", PACKET_DISABLE
, remote_supported_packet
,
5320 PACKET_qXfer_btrace
},
5321 { "qXfer:btrace-conf:read", PACKET_DISABLE
, remote_supported_packet
,
5322 PACKET_qXfer_btrace_conf
},
5323 { "Qbtrace-conf:bts:size", PACKET_DISABLE
, remote_supported_packet
,
5324 PACKET_Qbtrace_conf_bts_size
},
5325 { "swbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_swbreak_feature
},
5326 { "hwbreak", PACKET_DISABLE
, remote_supported_packet
, PACKET_hwbreak_feature
},
5327 { "fork-events", PACKET_DISABLE
, remote_supported_packet
,
5328 PACKET_fork_event_feature
},
5329 { "vfork-events", PACKET_DISABLE
, remote_supported_packet
,
5330 PACKET_vfork_event_feature
},
5331 { "exec-events", PACKET_DISABLE
, remote_supported_packet
,
5332 PACKET_exec_event_feature
},
5333 { "Qbtrace-conf:pt:size", PACKET_DISABLE
, remote_supported_packet
,
5334 PACKET_Qbtrace_conf_pt_size
},
5335 { "vContSupported", PACKET_DISABLE
, remote_supported_packet
, PACKET_vContSupported
},
5336 { "QThreadEvents", PACKET_DISABLE
, remote_supported_packet
, PACKET_QThreadEvents
},
5337 { "no-resumed", PACKET_DISABLE
, remote_supported_packet
, PACKET_no_resumed
},
5338 { "memory-tagging", PACKET_DISABLE
, remote_supported_packet
,
5339 PACKET_memory_tagging_feature
},
5342 static char *remote_support_xml
;
5344 /* Register string appended to "xmlRegisters=" in qSupported query. */
5347 register_remote_support_xml (const char *xml
)
5349 #if defined(HAVE_LIBEXPAT)
5350 if (remote_support_xml
== NULL
)
5351 remote_support_xml
= concat ("xmlRegisters=", xml
, (char *) NULL
);
5354 char *copy
= xstrdup (remote_support_xml
+ 13);
5356 char *p
= strtok_r (copy
, ",", &saveptr
);
5360 if (strcmp (p
, xml
) == 0)
5367 while ((p
= strtok_r (NULL
, ",", &saveptr
)) != NULL
);
5370 remote_support_xml
= reconcat (remote_support_xml
,
5371 remote_support_xml
, ",", xml
,
5378 remote_query_supported_append (std::string
*msg
, const char *append
)
5382 msg
->append (append
);
5386 remote_target::remote_query_supported ()
5388 struct remote_state
*rs
= get_remote_state ();
5391 unsigned char seen
[ARRAY_SIZE (remote_protocol_features
)];
5393 /* The packet support flags are handled differently for this packet
5394 than for most others. We treat an error, a disabled packet, and
5395 an empty response identically: any features which must be reported
5396 to be used will be automatically disabled. An empty buffer
5397 accomplishes this, since that is also the representation for a list
5398 containing no features. */
5401 if (packet_support (PACKET_qSupported
) != PACKET_DISABLE
)
5405 if (packet_set_cmd_state (PACKET_multiprocess_feature
) != AUTO_BOOLEAN_FALSE
)
5406 remote_query_supported_append (&q
, "multiprocess+");
5408 if (packet_set_cmd_state (PACKET_swbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5409 remote_query_supported_append (&q
, "swbreak+");
5410 if (packet_set_cmd_state (PACKET_hwbreak_feature
) != AUTO_BOOLEAN_FALSE
)
5411 remote_query_supported_append (&q
, "hwbreak+");
5413 remote_query_supported_append (&q
, "qRelocInsn+");
5415 if (packet_set_cmd_state (PACKET_fork_event_feature
)
5416 != AUTO_BOOLEAN_FALSE
)
5417 remote_query_supported_append (&q
, "fork-events+");
5418 if (packet_set_cmd_state (PACKET_vfork_event_feature
)
5419 != AUTO_BOOLEAN_FALSE
)
5420 remote_query_supported_append (&q
, "vfork-events+");
5421 if (packet_set_cmd_state (PACKET_exec_event_feature
)
5422 != AUTO_BOOLEAN_FALSE
)
5423 remote_query_supported_append (&q
, "exec-events+");
5425 if (packet_set_cmd_state (PACKET_vContSupported
) != AUTO_BOOLEAN_FALSE
)
5426 remote_query_supported_append (&q
, "vContSupported+");
5428 if (packet_set_cmd_state (PACKET_QThreadEvents
) != AUTO_BOOLEAN_FALSE
)
5429 remote_query_supported_append (&q
, "QThreadEvents+");
5431 if (packet_set_cmd_state (PACKET_no_resumed
) != AUTO_BOOLEAN_FALSE
)
5432 remote_query_supported_append (&q
, "no-resumed+");
5434 if (packet_set_cmd_state (PACKET_memory_tagging_feature
)
5435 != AUTO_BOOLEAN_FALSE
)
5436 remote_query_supported_append (&q
, "memory-tagging+");
5438 /* Keep this one last to work around a gdbserver <= 7.10 bug in
5439 the qSupported:xmlRegisters=i386 handling. */
5440 if (remote_support_xml
!= NULL
5441 && packet_support (PACKET_qXfer_features
) != PACKET_DISABLE
)
5442 remote_query_supported_append (&q
, remote_support_xml
);
5444 q
= "qSupported:" + q
;
5445 putpkt (q
.c_str ());
5447 getpkt (&rs
->buf
, 0);
5449 /* If an error occured, warn, but do not return - just reset the
5450 buffer to empty and go on to disable features. */
5451 if (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_qSupported
])
5454 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
5459 memset (seen
, 0, sizeof (seen
));
5461 next
= rs
->buf
.data ();
5464 enum packet_support is_supported
;
5465 char *p
, *end
, *name_end
, *value
;
5467 /* First separate out this item from the rest of the packet. If
5468 there's another item after this, we overwrite the separator
5469 (terminated strings are much easier to work with). */
5471 end
= strchr (p
, ';');
5474 end
= p
+ strlen (p
);
5484 warning (_("empty item in \"qSupported\" response"));
5489 name_end
= strchr (p
, '=');
5492 /* This is a name=value entry. */
5493 is_supported
= PACKET_ENABLE
;
5494 value
= name_end
+ 1;
5503 is_supported
= PACKET_ENABLE
;
5507 is_supported
= PACKET_DISABLE
;
5511 is_supported
= PACKET_SUPPORT_UNKNOWN
;
5515 warning (_("unrecognized item \"%s\" "
5516 "in \"qSupported\" response"), p
);
5522 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5523 if (strcmp (remote_protocol_features
[i
].name
, p
) == 0)
5525 const struct protocol_feature
*feature
;
5528 feature
= &remote_protocol_features
[i
];
5529 feature
->func (this, feature
, is_supported
, value
);
5534 /* If we increased the packet size, make sure to increase the global
5535 buffer size also. We delay this until after parsing the entire
5536 qSupported packet, because this is the same buffer we were
5538 if (rs
->buf
.size () < rs
->explicit_packet_size
)
5539 rs
->buf
.resize (rs
->explicit_packet_size
);
5541 /* Handle the defaults for unmentioned features. */
5542 for (i
= 0; i
< ARRAY_SIZE (remote_protocol_features
); i
++)
5545 const struct protocol_feature
*feature
;
5547 feature
= &remote_protocol_features
[i
];
5548 feature
->func (this, feature
, feature
->default_support
, NULL
);
5552 /* Serial QUIT handler for the remote serial descriptor.
5554 Defers handling a Ctrl-C until we're done with the current
5555 command/response packet sequence, unless:
5557 - We're setting up the connection. Don't send a remote interrupt
5558 request, as we're not fully synced yet. Quit immediately
5561 - The target has been resumed in the foreground
5562 (target_terminal::is_ours is false) with a synchronous resume
5563 packet, and we're blocked waiting for the stop reply, thus a
5564 Ctrl-C should be immediately sent to the target.
5566 - We get a second Ctrl-C while still within the same serial read or
5567 write. In that case the serial is seemingly wedged --- offer to
5570 - We see a second Ctrl-C without target response, after having
5571 previously interrupted the target. In that case the target/stub
5572 is probably wedged --- offer to quit/disconnect.
5576 remote_target::remote_serial_quit_handler ()
5578 struct remote_state
*rs
= get_remote_state ();
5580 if (check_quit_flag ())
5582 /* If we're starting up, we're not fully synced yet. Quit
5584 if (rs
->starting_up
)
5586 else if (rs
->got_ctrlc_during_io
)
5588 if (query (_("The target is not responding to GDB commands.\n"
5589 "Stop debugging it? ")))
5590 remote_unpush_and_throw (this);
5592 /* If ^C has already been sent once, offer to disconnect. */
5593 else if (!target_terminal::is_ours () && rs
->ctrlc_pending_p
)
5595 /* All-stop protocol, and blocked waiting for stop reply. Send
5596 an interrupt request. */
5597 else if (!target_terminal::is_ours () && rs
->waiting_for_stop_reply
)
5598 target_interrupt ();
5600 rs
->got_ctrlc_during_io
= 1;
5604 /* The remote_target that is current while the quit handler is
5605 overridden with remote_serial_quit_handler. */
5606 static remote_target
*curr_quit_handler_target
;
5609 remote_serial_quit_handler ()
5611 curr_quit_handler_target
->remote_serial_quit_handler ();
5614 /* Remove the remote target from the target stack of each inferior
5615 that is using it. Upper targets depend on it so remove them
5619 remote_unpush_target (remote_target
*target
)
5621 /* We have to unpush the target from all inferiors, even those that
5623 scoped_restore_current_inferior restore_current_inferior
;
5625 for (inferior
*inf
: all_inferiors (target
))
5627 switch_to_inferior_no_thread (inf
);
5628 pop_all_targets_at_and_above (process_stratum
);
5629 generic_mourn_inferior ();
5632 /* Don't rely on target_close doing this when the target is popped
5633 from the last remote inferior above, because something may be
5634 holding a reference to the target higher up on the stack, meaning
5635 target_close won't be called yet. We lost the connection to the
5636 target, so clear these now, otherwise we may later throw
5637 TARGET_CLOSE_ERROR while trying to tell the remote target to
5639 fileio_handles_invalidate_target (target
);
5643 remote_unpush_and_throw (remote_target
*target
)
5645 remote_unpush_target (target
);
5646 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
5650 remote_target::open_1 (const char *name
, int from_tty
, int extended_p
)
5652 remote_target
*curr_remote
= get_current_remote_target ();
5655 error (_("To open a remote debug connection, you need to specify what\n"
5656 "serial device is attached to the remote system\n"
5657 "(e.g. /dev/ttyS0, /dev/ttya, COM1, etc.)."));
5659 /* If we're connected to a running target, target_preopen will kill it.
5660 Ask this question first, before target_preopen has a chance to kill
5662 if (curr_remote
!= NULL
&& !target_has_execution ())
5665 && !query (_("Already connected to a remote target. Disconnect? ")))
5666 error (_("Still connected."));
5669 /* Here the possibly existing remote target gets unpushed. */
5670 target_preopen (from_tty
);
5672 remote_fileio_reset ();
5673 reopen_exec_file ();
5676 remote_target
*remote
5677 = (extended_p
? new extended_remote_target () : new remote_target ());
5678 target_ops_up
target_holder (remote
);
5680 remote_state
*rs
= remote
->get_remote_state ();
5682 /* See FIXME above. */
5683 if (!target_async_permitted
)
5684 rs
->wait_forever_enabled_p
= 1;
5686 rs
->remote_desc
= remote_serial_open (name
);
5687 if (!rs
->remote_desc
)
5688 perror_with_name (name
);
5690 if (baud_rate
!= -1)
5692 if (serial_setbaudrate (rs
->remote_desc
, baud_rate
))
5694 /* The requested speed could not be set. Error out to
5695 top level after closing remote_desc. Take care to
5696 set remote_desc to NULL to avoid closing remote_desc
5698 serial_close (rs
->remote_desc
);
5699 rs
->remote_desc
= NULL
;
5700 perror_with_name (name
);
5704 serial_setparity (rs
->remote_desc
, serial_parity
);
5705 serial_raw (rs
->remote_desc
);
5707 /* If there is something sitting in the buffer we might take it as a
5708 response to a command, which would be bad. */
5709 serial_flush_input (rs
->remote_desc
);
5713 puts_filtered ("Remote debugging using ");
5714 puts_filtered (name
);
5715 puts_filtered ("\n");
5718 /* Switch to using the remote target now. */
5719 current_inferior ()->push_target (std::move (target_holder
));
5721 /* Register extra event sources in the event loop. */
5722 rs
->remote_async_inferior_event_token
5723 = create_async_event_handler (remote_async_inferior_event_handler
, nullptr,
5725 rs
->notif_state
= remote_notif_state_allocate (remote
);
5727 /* Reset the target state; these things will be queried either by
5728 remote_query_supported or as they are needed. */
5729 reset_all_packet_configs_support ();
5730 rs
->cached_wait_status
= 0;
5731 rs
->explicit_packet_size
= 0;
5733 rs
->extended
= extended_p
;
5734 rs
->waiting_for_stop_reply
= 0;
5735 rs
->ctrlc_pending_p
= 0;
5736 rs
->got_ctrlc_during_io
= 0;
5738 rs
->general_thread
= not_sent_ptid
;
5739 rs
->continue_thread
= not_sent_ptid
;
5740 rs
->remote_traceframe_number
= -1;
5742 rs
->last_resume_exec_dir
= EXEC_FORWARD
;
5744 /* Probe for ability to use "ThreadInfo" query, as required. */
5745 rs
->use_threadinfo_query
= 1;
5746 rs
->use_threadextra_query
= 1;
5748 rs
->readahead_cache
.invalidate ();
5750 if (target_async_permitted
)
5752 /* FIXME: cagney/1999-09-23: During the initial connection it is
5753 assumed that the target is already ready and able to respond to
5754 requests. Unfortunately remote_start_remote() eventually calls
5755 wait_for_inferior() with no timeout. wait_forever_enabled_p gets
5756 around this. Eventually a mechanism that allows
5757 wait_for_inferior() to expect/get timeouts will be
5759 rs
->wait_forever_enabled_p
= 0;
5762 /* First delete any symbols previously loaded from shared libraries. */
5763 no_shared_libraries (NULL
, 0);
5765 /* Start the remote connection. If error() or QUIT, discard this
5766 target (we'd otherwise be in an inconsistent state) and then
5767 propogate the error on up the exception chain. This ensures that
5768 the caller doesn't stumble along blindly assuming that the
5769 function succeeded. The CLI doesn't have this problem but other
5770 UI's, such as MI do.
5772 FIXME: cagney/2002-05-19: Instead of re-throwing the exception,
5773 this function should return an error indication letting the
5774 caller restore the previous state. Unfortunately the command
5775 ``target remote'' is directly wired to this function making that
5776 impossible. On a positive note, the CLI side of this problem has
5777 been fixed - the function set_cmd_context() makes it possible for
5778 all the ``target ....'' commands to share a common callback
5779 function. See cli-dump.c. */
5784 remote
->start_remote (from_tty
, extended_p
);
5786 catch (const gdb_exception
&ex
)
5788 /* Pop the partially set up target - unless something else did
5789 already before throwing the exception. */
5790 if (ex
.error
!= TARGET_CLOSE_ERROR
)
5791 remote_unpush_target (remote
);
5796 remote_btrace_reset (rs
);
5798 if (target_async_permitted
)
5799 rs
->wait_forever_enabled_p
= 1;
5802 /* Detach the specified process. */
5805 remote_target::remote_detach_pid (int pid
)
5807 struct remote_state
*rs
= get_remote_state ();
5809 /* This should not be necessary, but the handling for D;PID in
5810 GDBserver versions prior to 8.2 incorrectly assumes that the
5811 selected process points to the same process we're detaching,
5812 leading to misbehavior (and possibly GDBserver crashing) when it
5813 does not. Since it's easy and cheap, work around it by forcing
5814 GDBserver to select GDB's current process. */
5815 set_general_process ();
5817 if (remote_multi_process_p (rs
))
5818 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "D;%x", pid
);
5820 strcpy (rs
->buf
.data (), "D");
5823 getpkt (&rs
->buf
, 0);
5825 if (rs
->buf
[0] == 'O' && rs
->buf
[1] == 'K')
5827 else if (rs
->buf
[0] == '\0')
5828 error (_("Remote doesn't know how to detach"));
5830 error (_("Can't detach process."));
5833 /* This detaches a program to which we previously attached, using
5834 inferior_ptid to identify the process. After this is done, GDB
5835 can be used to debug some other program. We better not have left
5836 any breakpoints in the target program or it'll die when it hits
5840 remote_target::remote_detach_1 (inferior
*inf
, int from_tty
)
5842 int pid
= inferior_ptid
.pid ();
5843 struct remote_state
*rs
= get_remote_state ();
5846 if (!target_has_execution ())
5847 error (_("No process to detach from."));
5849 target_announce_detach (from_tty
);
5851 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
5853 /* If we're in breakpoints-always-inserted mode, or the inferior
5854 is running, we have to remove breakpoints before detaching.
5855 We don't do this in common code instead because not all
5856 targets support removing breakpoints while the target is
5857 running. The remote target / gdbserver does, though. */
5858 remove_breakpoints_inf (current_inferior ());
5861 /* Tell the remote target to detach. */
5862 remote_detach_pid (pid
);
5864 /* Exit only if this is the only active inferior. */
5865 if (from_tty
&& !rs
->extended
&& number_of_live_inferiors (this) == 1)
5866 puts_filtered (_("Ending remote debugging.\n"));
5868 thread_info
*tp
= find_thread_ptid (this, inferior_ptid
);
5870 /* Check to see if we are detaching a fork parent. Note that if we
5871 are detaching a fork child, tp == NULL. */
5872 is_fork_parent
= (tp
!= NULL
5873 && tp
->pending_follow
.kind
== TARGET_WAITKIND_FORKED
);
5875 /* If doing detach-on-fork, we don't mourn, because that will delete
5876 breakpoints that should be available for the followed inferior. */
5877 if (!is_fork_parent
)
5879 /* Save the pid as a string before mourning, since that will
5880 unpush the remote target, and we need the string after. */
5881 std::string infpid
= target_pid_to_str (ptid_t (pid
));
5883 target_mourn_inferior (inferior_ptid
);
5884 if (print_inferior_events
)
5885 printf_unfiltered (_("[Inferior %d (%s) detached]\n"),
5886 inf
->num
, infpid
.c_str ());
5890 switch_to_no_thread ();
5891 detach_inferior (current_inferior ());
5896 remote_target::detach (inferior
*inf
, int from_tty
)
5898 remote_detach_1 (inf
, from_tty
);
5902 extended_remote_target::detach (inferior
*inf
, int from_tty
)
5904 remote_detach_1 (inf
, from_tty
);
5907 /* Target follow-fork function for remote targets. On entry, and
5908 at return, the current inferior is the fork parent.
5910 Note that although this is currently only used for extended-remote,
5911 it is named remote_follow_fork in anticipation of using it for the
5912 remote target as well. */
5915 remote_target::follow_fork (bool follow_child
, bool detach_fork
)
5917 struct remote_state
*rs
= get_remote_state ();
5918 enum target_waitkind kind
= inferior_thread ()->pending_follow
.kind
;
5920 if ((kind
== TARGET_WAITKIND_FORKED
&& remote_fork_event_p (rs
))
5921 || (kind
== TARGET_WAITKIND_VFORKED
&& remote_vfork_event_p (rs
)))
5923 /* When following the parent and detaching the child, we detach
5924 the child here. For the case of following the child and
5925 detaching the parent, the detach is done in the target-
5926 independent follow fork code in infrun.c. We can't use
5927 target_detach when detaching an unfollowed child because
5928 the client side doesn't know anything about the child. */
5929 if (detach_fork
&& !follow_child
)
5931 /* Detach the fork child. */
5935 child_ptid
= inferior_thread ()->pending_follow
.value
.related_pid
;
5936 child_pid
= child_ptid
.pid ();
5938 remote_detach_pid (child_pid
);
5943 /* Target follow-exec function for remote targets. Save EXECD_PATHNAME
5944 in the program space of the new inferior. */
5947 remote_target::follow_exec (inferior
*follow_inf
, ptid_t ptid
,
5948 const char *execd_pathname
)
5950 process_stratum_target::follow_exec (follow_inf
, ptid
, execd_pathname
);
5952 /* We know that this is a target file name, so if it has the "target:"
5953 prefix we strip it off before saving it in the program space. */
5954 if (is_target_filename (execd_pathname
))
5955 execd_pathname
+= strlen (TARGET_SYSROOT_PREFIX
);
5957 set_pspace_remote_exec_file (follow_inf
->pspace
, execd_pathname
);
5960 /* Same as remote_detach, but don't send the "D" packet; just disconnect. */
5963 remote_target::disconnect (const char *args
, int from_tty
)
5966 error (_("Argument given to \"disconnect\" when remotely debugging."));
5968 /* Make sure we unpush even the extended remote targets. Calling
5969 target_mourn_inferior won't unpush, and
5970 remote_target::mourn_inferior won't unpush if there is more than
5971 one inferior left. */
5972 remote_unpush_target (this);
5975 puts_filtered ("Ending remote debugging.\n");
5978 /* Attach to the process specified by ARGS. If FROM_TTY is non-zero,
5979 be chatty about it. */
5982 extended_remote_target::attach (const char *args
, int from_tty
)
5984 struct remote_state
*rs
= get_remote_state ();
5986 char *wait_status
= NULL
;
5988 pid
= parse_pid_to_attach (args
);
5990 /* Remote PID can be freely equal to getpid, do not check it here the same
5991 way as in other targets. */
5993 if (packet_support (PACKET_vAttach
) == PACKET_DISABLE
)
5994 error (_("This target does not support attaching to a process"));
5998 const char *exec_file
= get_exec_file (0);
6001 printf_unfiltered (_("Attaching to program: %s, %s\n"), exec_file
,
6002 target_pid_to_str (ptid_t (pid
)).c_str ());
6004 printf_unfiltered (_("Attaching to %s\n"),
6005 target_pid_to_str (ptid_t (pid
)).c_str ());
6008 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vAttach;%x", pid
);
6010 getpkt (&rs
->buf
, 0);
6012 switch (packet_ok (rs
->buf
,
6013 &remote_protocol_packets
[PACKET_vAttach
]))
6016 if (!target_is_non_stop_p ())
6018 /* Save the reply for later. */
6019 wait_status
= (char *) alloca (strlen (rs
->buf
.data ()) + 1);
6020 strcpy (wait_status
, rs
->buf
.data ());
6022 else if (strcmp (rs
->buf
.data (), "OK") != 0)
6023 error (_("Attaching to %s failed with: %s"),
6024 target_pid_to_str (ptid_t (pid
)).c_str (),
6027 case PACKET_UNKNOWN
:
6028 error (_("This target does not support attaching to a process"));
6030 error (_("Attaching to %s failed"),
6031 target_pid_to_str (ptid_t (pid
)).c_str ());
6034 switch_to_inferior_no_thread (remote_add_inferior (false, pid
, 1, 0));
6036 inferior_ptid
= ptid_t (pid
);
6038 if (target_is_non_stop_p ())
6040 /* Get list of threads. */
6041 update_thread_list ();
6043 thread_info
*thread
= first_thread_of_inferior (current_inferior ());
6044 if (thread
!= nullptr)
6045 switch_to_thread (thread
);
6047 /* Invalidate our notion of the remote current thread. */
6048 record_currthread (rs
, minus_one_ptid
);
6052 /* Now, if we have thread information, update the main thread's
6054 ptid_t curr_ptid
= remote_current_thread (ptid_t (pid
));
6056 /* Add the main thread to the thread list. We add the thread
6057 silently in this case (the final true parameter). */
6058 thread_info
*thr
= remote_add_thread (curr_ptid
, true, true, true);
6060 switch_to_thread (thr
);
6063 /* Next, if the target can specify a description, read it. We do
6064 this before anything involving memory or registers. */
6065 target_find_description ();
6067 if (!target_is_non_stop_p ())
6069 /* Use the previously fetched status. */
6070 gdb_assert (wait_status
!= NULL
);
6072 if (target_can_async_p ())
6074 struct notif_event
*reply
6075 = remote_notif_parse (this, ¬if_client_stop
, wait_status
);
6077 push_stop_reply ((struct stop_reply
*) reply
);
6083 gdb_assert (wait_status
!= NULL
);
6084 strcpy (rs
->buf
.data (), wait_status
);
6085 rs
->cached_wait_status
= 1;
6090 gdb_assert (wait_status
== NULL
);
6092 gdb_assert (target_can_async_p ());
6097 /* Implementation of the to_post_attach method. */
6100 extended_remote_target::post_attach (int pid
)
6102 /* Get text, data & bss offsets. */
6105 /* In certain cases GDB might not have had the chance to start
6106 symbol lookup up until now. This could happen if the debugged
6107 binary is not using shared libraries, the vsyscall page is not
6108 present (on Linux) and the binary itself hadn't changed since the
6109 debugging process was started. */
6110 if (current_program_space
->symfile_object_file
!= NULL
)
6111 remote_check_symbols();
6115 /* Check for the availability of vCont. This function should also check
6119 remote_target::remote_vcont_probe ()
6121 remote_state
*rs
= get_remote_state ();
6124 strcpy (rs
->buf
.data (), "vCont?");
6126 getpkt (&rs
->buf
, 0);
6127 buf
= rs
->buf
.data ();
6129 /* Make sure that the features we assume are supported. */
6130 if (startswith (buf
, "vCont"))
6133 int support_c
, support_C
;
6135 rs
->supports_vCont
.s
= 0;
6136 rs
->supports_vCont
.S
= 0;
6139 rs
->supports_vCont
.t
= 0;
6140 rs
->supports_vCont
.r
= 0;
6141 while (p
&& *p
== ';')
6144 if (*p
== 's' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6145 rs
->supports_vCont
.s
= 1;
6146 else if (*p
== 'S' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6147 rs
->supports_vCont
.S
= 1;
6148 else if (*p
== 'c' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6150 else if (*p
== 'C' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6152 else if (*p
== 't' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6153 rs
->supports_vCont
.t
= 1;
6154 else if (*p
== 'r' && (*(p
+ 1) == ';' || *(p
+ 1) == 0))
6155 rs
->supports_vCont
.r
= 1;
6157 p
= strchr (p
, ';');
6160 /* If c, and C are not all supported, we can't use vCont. Clearing
6161 BUF will make packet_ok disable the packet. */
6162 if (!support_c
|| !support_C
)
6166 packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCont
]);
6167 rs
->supports_vCont_probed
= true;
6170 /* Helper function for building "vCont" resumptions. Write a
6171 resumption to P. ENDP points to one-passed-the-end of the buffer
6172 we're allowed to write to. Returns BUF+CHARACTERS_WRITTEN. The
6173 thread to be resumed is PTID; STEP and SIGGNAL indicate whether the
6174 resumed thread should be single-stepped and/or signalled. If PTID
6175 equals minus_one_ptid, then all threads are resumed; if PTID
6176 represents a process, then all threads of the process are resumed;
6177 the thread to be stepped and/or signalled is given in the global
6181 remote_target::append_resumption (char *p
, char *endp
,
6182 ptid_t ptid
, int step
, gdb_signal siggnal
)
6184 struct remote_state
*rs
= get_remote_state ();
6186 if (step
&& siggnal
!= GDB_SIGNAL_0
)
6187 p
+= xsnprintf (p
, endp
- p
, ";S%02x", siggnal
);
6189 /* GDB is willing to range step. */
6190 && use_range_stepping
6191 /* Target supports range stepping. */
6192 && rs
->supports_vCont
.r
6193 /* We don't currently support range stepping multiple
6194 threads with a wildcard (though the protocol allows it,
6195 so stubs shouldn't make an active effort to forbid
6197 && !(remote_multi_process_p (rs
) && ptid
.is_pid ()))
6199 struct thread_info
*tp
;
6201 if (ptid
== minus_one_ptid
)
6203 /* If we don't know about the target thread's tid, then
6204 we're resuming magic_null_ptid (see caller). */
6205 tp
= find_thread_ptid (this, magic_null_ptid
);
6208 tp
= find_thread_ptid (this, ptid
);
6209 gdb_assert (tp
!= NULL
);
6211 if (tp
->control
.may_range_step
)
6213 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
6215 p
+= xsnprintf (p
, endp
- p
, ";r%s,%s",
6216 phex_nz (tp
->control
.step_range_start
,
6218 phex_nz (tp
->control
.step_range_end
,
6222 p
+= xsnprintf (p
, endp
- p
, ";s");
6225 p
+= xsnprintf (p
, endp
- p
, ";s");
6226 else if (siggnal
!= GDB_SIGNAL_0
)
6227 p
+= xsnprintf (p
, endp
- p
, ";C%02x", siggnal
);
6229 p
+= xsnprintf (p
, endp
- p
, ";c");
6231 if (remote_multi_process_p (rs
) && ptid
.is_pid ())
6235 /* All (-1) threads of process. */
6236 nptid
= ptid_t (ptid
.pid (), -1, 0);
6238 p
+= xsnprintf (p
, endp
- p
, ":");
6239 p
= write_ptid (p
, endp
, nptid
);
6241 else if (ptid
!= minus_one_ptid
)
6243 p
+= xsnprintf (p
, endp
- p
, ":");
6244 p
= write_ptid (p
, endp
, ptid
);
6250 /* Clear the thread's private info on resume. */
6253 resume_clear_thread_private_info (struct thread_info
*thread
)
6255 if (thread
->priv
!= NULL
)
6257 remote_thread_info
*priv
= get_remote_thread_info (thread
);
6259 priv
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6260 priv
->watch_data_address
= 0;
6264 /* Append a vCont continue-with-signal action for threads that have a
6265 non-zero stop signal. */
6268 remote_target::append_pending_thread_resumptions (char *p
, char *endp
,
6271 for (thread_info
*thread
: all_non_exited_threads (this, ptid
))
6272 if (inferior_ptid
!= thread
->ptid
6273 && thread
->suspend
.stop_signal
!= GDB_SIGNAL_0
)
6275 p
= append_resumption (p
, endp
, thread
->ptid
,
6276 0, thread
->suspend
.stop_signal
);
6277 thread
->suspend
.stop_signal
= GDB_SIGNAL_0
;
6278 resume_clear_thread_private_info (thread
);
6284 /* Set the target running, using the packets that use Hc
6288 remote_target::remote_resume_with_hc (ptid_t ptid
, int step
,
6291 struct remote_state
*rs
= get_remote_state ();
6294 rs
->last_sent_signal
= siggnal
;
6295 rs
->last_sent_step
= step
;
6297 /* The c/s/C/S resume packets use Hc, so set the continue
6299 if (ptid
== minus_one_ptid
)
6300 set_continue_thread (any_thread_ptid
);
6302 set_continue_thread (ptid
);
6304 for (thread_info
*thread
: all_non_exited_threads (this))
6305 resume_clear_thread_private_info (thread
);
6307 buf
= rs
->buf
.data ();
6308 if (::execution_direction
== EXEC_REVERSE
)
6310 /* We don't pass signals to the target in reverse exec mode. */
6311 if (info_verbose
&& siggnal
!= GDB_SIGNAL_0
)
6312 warning (_(" - Can't pass signal %d to target in reverse: ignored."),
6315 if (step
&& packet_support (PACKET_bs
) == PACKET_DISABLE
)
6316 error (_("Remote reverse-step not supported."));
6317 if (!step
&& packet_support (PACKET_bc
) == PACKET_DISABLE
)
6318 error (_("Remote reverse-continue not supported."));
6320 strcpy (buf
, step
? "bs" : "bc");
6322 else if (siggnal
!= GDB_SIGNAL_0
)
6324 buf
[0] = step
? 'S' : 'C';
6325 buf
[1] = tohex (((int) siggnal
>> 4) & 0xf);
6326 buf
[2] = tohex (((int) siggnal
) & 0xf);
6330 strcpy (buf
, step
? "s" : "c");
6335 /* Resume the remote inferior by using a "vCont" packet. The thread
6336 to be resumed is PTID; STEP and SIGGNAL indicate whether the
6337 resumed thread should be single-stepped and/or signalled. If PTID
6338 equals minus_one_ptid, then all threads are resumed; the thread to
6339 be stepped and/or signalled is given in the global INFERIOR_PTID.
6340 This function returns non-zero iff it resumes the inferior.
6342 This function issues a strict subset of all possible vCont commands
6346 remote_target::remote_resume_with_vcont (ptid_t ptid
, int step
,
6347 enum gdb_signal siggnal
)
6349 struct remote_state
*rs
= get_remote_state ();
6353 /* No reverse execution actions defined for vCont. */
6354 if (::execution_direction
== EXEC_REVERSE
)
6357 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
6358 remote_vcont_probe ();
6360 if (packet_support (PACKET_vCont
) == PACKET_DISABLE
)
6363 p
= rs
->buf
.data ();
6364 endp
= p
+ get_remote_packet_size ();
6366 /* If we could generate a wider range of packets, we'd have to worry
6367 about overflowing BUF. Should there be a generic
6368 "multi-part-packet" packet? */
6370 p
+= xsnprintf (p
, endp
- p
, "vCont");
6372 if (ptid
== magic_null_ptid
)
6374 /* MAGIC_NULL_PTID means that we don't have any active threads,
6375 so we don't have any TID numbers the inferior will
6376 understand. Make sure to only send forms that do not specify
6378 append_resumption (p
, endp
, minus_one_ptid
, step
, siggnal
);
6380 else if (ptid
== minus_one_ptid
|| ptid
.is_pid ())
6382 /* Resume all threads (of all processes, or of a single
6383 process), with preference for INFERIOR_PTID. This assumes
6384 inferior_ptid belongs to the set of all threads we are about
6386 if (step
|| siggnal
!= GDB_SIGNAL_0
)
6388 /* Step inferior_ptid, with or without signal. */
6389 p
= append_resumption (p
, endp
, inferior_ptid
, step
, siggnal
);
6392 /* Also pass down any pending signaled resumption for other
6393 threads not the current. */
6394 p
= append_pending_thread_resumptions (p
, endp
, ptid
);
6396 /* And continue others without a signal. */
6397 append_resumption (p
, endp
, ptid
, /*step=*/ 0, GDB_SIGNAL_0
);
6401 /* Scheduler locking; resume only PTID. */
6402 append_resumption (p
, endp
, ptid
, step
, siggnal
);
6405 gdb_assert (strlen (rs
->buf
.data ()) < get_remote_packet_size ());
6408 if (target_is_non_stop_p ())
6410 /* In non-stop, the stub replies to vCont with "OK". The stop
6411 reply will be reported asynchronously by means of a `%Stop'
6413 getpkt (&rs
->buf
, 0);
6414 if (strcmp (rs
->buf
.data (), "OK") != 0)
6415 error (_("Unexpected vCont reply in non-stop mode: %s"),
6422 /* Tell the remote machine to resume. */
6425 remote_target::resume (ptid_t ptid
, int step
, enum gdb_signal siggnal
)
6427 struct remote_state
*rs
= get_remote_state ();
6429 /* When connected in non-stop mode, the core resumes threads
6430 individually. Resuming remote threads directly in target_resume
6431 would thus result in sending one packet per thread. Instead, to
6432 minimize roundtrip latency, here we just store the resume
6433 request (put the thread in RESUMED_PENDING_VCONT state); the actual remote
6434 resumption will be done in remote_target::commit_resume, where we'll be
6435 able to do vCont action coalescing. */
6436 if (target_is_non_stop_p () && ::execution_direction
!= EXEC_REVERSE
)
6438 remote_thread_info
*remote_thr
;
6440 if (minus_one_ptid
== ptid
|| ptid
.is_pid ())
6441 remote_thr
= get_remote_thread_info (this, inferior_ptid
);
6443 remote_thr
= get_remote_thread_info (this, ptid
);
6445 /* We don't expect the core to ask to resume an already resumed (from
6446 its point of view) thread. */
6447 gdb_assert (remote_thr
->get_resume_state () == resume_state::NOT_RESUMED
);
6449 remote_thr
->set_resumed_pending_vcont (step
, siggnal
);
6453 /* In all-stop, we can't mark REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN
6454 (explained in remote-notif.c:handle_notification) so
6455 remote_notif_process is not called. We need find a place where
6456 it is safe to start a 'vNotif' sequence. It is good to do it
6457 before resuming inferior, because inferior was stopped and no RSP
6458 traffic at that moment. */
6459 if (!target_is_non_stop_p ())
6460 remote_notif_process (rs
->notif_state
, ¬if_client_stop
);
6462 rs
->last_resume_exec_dir
= ::execution_direction
;
6464 /* Prefer vCont, and fallback to s/c/S/C, which use Hc. */
6465 if (!remote_resume_with_vcont (ptid
, step
, siggnal
))
6466 remote_resume_with_hc (ptid
, step
, siggnal
);
6468 /* Update resumed state tracked by the remote target. */
6469 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6470 get_remote_thread_info (tp
)->set_resumed ();
6472 /* We are about to start executing the inferior, let's register it
6473 with the event loop. NOTE: this is the one place where all the
6474 execution commands end up. We could alternatively do this in each
6475 of the execution commands in infcmd.c. */
6476 /* FIXME: ezannoni 1999-09-28: We may need to move this out of here
6477 into infcmd.c in order to allow inferior function calls to work
6478 NOT asynchronously. */
6479 if (target_can_async_p ())
6482 /* We've just told the target to resume. The remote server will
6483 wait for the inferior to stop, and then send a stop reply. In
6484 the mean time, we can't start another command/query ourselves
6485 because the stub wouldn't be ready to process it. This applies
6486 only to the base all-stop protocol, however. In non-stop (which
6487 only supports vCont), the stub replies with an "OK", and is
6488 immediate able to process further serial input. */
6489 if (!target_is_non_stop_p ())
6490 rs
->waiting_for_stop_reply
= 1;
6493 static int is_pending_fork_parent_thread (struct thread_info
*thread
);
6495 /* Private per-inferior info for target remote processes. */
6497 struct remote_inferior
: public private_inferior
6499 /* Whether we can send a wildcard vCont for this process. */
6500 bool may_wildcard_vcont
= true;
6503 /* Get the remote private inferior data associated to INF. */
6505 static remote_inferior
*
6506 get_remote_inferior (inferior
*inf
)
6508 if (inf
->priv
== NULL
)
6509 inf
->priv
.reset (new remote_inferior
);
6511 return static_cast<remote_inferior
*> (inf
->priv
.get ());
6514 struct stop_reply
: public notif_event
6518 /* The identifier of the thread about this event */
6521 /* The remote state this event is associated with. When the remote
6522 connection, represented by a remote_state object, is closed,
6523 all the associated stop_reply events should be released. */
6524 struct remote_state
*rs
;
6526 struct target_waitstatus ws
;
6528 /* The architecture associated with the expedited registers. */
6531 /* Expedited registers. This makes remote debugging a bit more
6532 efficient for those targets that provide critical registers as
6533 part of their normal status mechanism (as another roundtrip to
6534 fetch them is avoided). */
6535 std::vector
<cached_reg_t
> regcache
;
6537 enum target_stop_reason stop_reason
;
6539 CORE_ADDR watch_data_address
;
6544 /* Class used to track the construction of a vCont packet in the
6545 outgoing packet buffer. This is used to send multiple vCont
6546 packets if we have more actions than would fit a single packet. */
6551 explicit vcont_builder (remote_target
*remote
)
6558 void push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
);
6563 /* The remote target. */
6564 remote_target
*m_remote
;
6566 /* Pointer to the first action. P points here if no action has been
6568 char *m_first_action
;
6570 /* Where the next action will be appended. */
6573 /* The end of the buffer. Must never write past this. */
6577 /* Prepare the outgoing buffer for a new vCont packet. */
6580 vcont_builder::restart ()
6582 struct remote_state
*rs
= m_remote
->get_remote_state ();
6584 m_p
= rs
->buf
.data ();
6585 m_endp
= m_p
+ m_remote
->get_remote_packet_size ();
6586 m_p
+= xsnprintf (m_p
, m_endp
- m_p
, "vCont");
6587 m_first_action
= m_p
;
6590 /* If the vCont packet being built has any action, send it to the
6594 vcont_builder::flush ()
6596 struct remote_state
*rs
;
6598 if (m_p
== m_first_action
)
6601 rs
= m_remote
->get_remote_state ();
6602 m_remote
->putpkt (rs
->buf
);
6603 m_remote
->getpkt (&rs
->buf
, 0);
6604 if (strcmp (rs
->buf
.data (), "OK") != 0)
6605 error (_("Unexpected vCont reply in non-stop mode: %s"), rs
->buf
.data ());
6608 /* The largest action is range-stepping, with its two addresses. This
6609 is more than sufficient. If a new, bigger action is created, it'll
6610 quickly trigger a failed assertion in append_resumption (and we'll
6612 #define MAX_ACTION_SIZE 200
6614 /* Append a new vCont action in the outgoing packet being built. If
6615 the action doesn't fit the packet along with previous actions, push
6616 what we've got so far to the remote end and start over a new vCont
6617 packet (with the new action). */
6620 vcont_builder::push_action (ptid_t ptid
, bool step
, gdb_signal siggnal
)
6622 char buf
[MAX_ACTION_SIZE
+ 1];
6624 char *endp
= m_remote
->append_resumption (buf
, buf
+ sizeof (buf
),
6625 ptid
, step
, siggnal
);
6627 /* Check whether this new action would fit in the vCont packet along
6628 with previous actions. If not, send what we've got so far and
6629 start a new vCont packet. */
6630 size_t rsize
= endp
- buf
;
6631 if (rsize
> m_endp
- m_p
)
6636 /* Should now fit. */
6637 gdb_assert (rsize
<= m_endp
- m_p
);
6640 memcpy (m_p
, buf
, rsize
);
6645 /* to_commit_resume implementation. */
6648 remote_target::commit_resumed ()
6650 /* If connected in all-stop mode, we'd send the remote resume
6651 request directly from remote_resume. Likewise if
6652 reverse-debugging, as there are no defined vCont actions for
6653 reverse execution. */
6654 if (!target_is_non_stop_p () || ::execution_direction
== EXEC_REVERSE
)
6657 /* Try to send wildcard actions ("vCont;c" or "vCont;c:pPID.-1")
6658 instead of resuming all threads of each process individually.
6659 However, if any thread of a process must remain halted, we can't
6660 send wildcard resumes and must send one action per thread.
6662 Care must be taken to not resume threads/processes the server
6663 side already told us are stopped, but the core doesn't know about
6664 yet, because the events are still in the vStopped notification
6667 #1 => vCont s:p1.1;c
6669 #3 <= %Stopped T05 p1.1
6674 #8 (infrun handles the stop for p1.1 and continues stepping)
6675 #9 => vCont s:p1.1;c
6677 The last vCont above would resume thread p1.2 by mistake, because
6678 the server has no idea that the event for p1.2 had not been
6681 The server side must similarly ignore resume actions for the
6682 thread that has a pending %Stopped notification (and any other
6683 threads with events pending), until GDB acks the notification
6684 with vStopped. Otherwise, e.g., the following case is
6687 #1 => g (or any other packet)
6689 #3 <= %Stopped T05 p1.2
6690 #4 => vCont s:p1.1;c
6693 Above, the server must not resume thread p1.2. GDB can't know
6694 that p1.2 stopped until it acks the %Stopped notification, and
6695 since from GDB's perspective all threads should be running, it
6698 Finally, special care must also be given to handling fork/vfork
6699 events. A (v)fork event actually tells us that two processes
6700 stopped -- the parent and the child. Until we follow the fork,
6701 we must not resume the child. Therefore, if we have a pending
6702 fork follow, we must not send a global wildcard resume action
6703 (vCont;c). We can still send process-wide wildcards though. */
6705 /* Start by assuming a global wildcard (vCont;c) is possible. */
6706 bool may_global_wildcard_vcont
= true;
6708 /* And assume every process is individually wildcard-able too. */
6709 for (inferior
*inf
: all_non_exited_inferiors (this))
6711 remote_inferior
*priv
= get_remote_inferior (inf
);
6713 priv
->may_wildcard_vcont
= true;
6716 /* Check for any pending events (not reported or processed yet) and
6717 disable process and global wildcard resumes appropriately. */
6718 check_pending_events_prevent_wildcard_vcont (&may_global_wildcard_vcont
);
6720 bool any_pending_vcont_resume
= false;
6722 for (thread_info
*tp
: all_non_exited_threads (this))
6724 remote_thread_info
*priv
= get_remote_thread_info (tp
);
6726 /* If a thread of a process is not meant to be resumed, then we
6727 can't wildcard that process. */
6728 if (priv
->get_resume_state () == resume_state::NOT_RESUMED
)
6730 get_remote_inferior (tp
->inf
)->may_wildcard_vcont
= false;
6732 /* And if we can't wildcard a process, we can't wildcard
6733 everything either. */
6734 may_global_wildcard_vcont
= false;
6738 if (priv
->get_resume_state () == resume_state::RESUMED_PENDING_VCONT
)
6739 any_pending_vcont_resume
= true;
6741 /* If a thread is the parent of an unfollowed fork, then we
6742 can't do a global wildcard, as that would resume the fork
6744 if (is_pending_fork_parent_thread (tp
))
6745 may_global_wildcard_vcont
= false;
6748 /* We didn't have any resumed thread pending a vCont resume, so nothing to
6750 if (!any_pending_vcont_resume
)
6753 /* Now let's build the vCont packet(s). Actions must be appended
6754 from narrower to wider scopes (thread -> process -> global). If
6755 we end up with too many actions for a single packet vcont_builder
6756 flushes the current vCont packet to the remote side and starts a
6758 struct vcont_builder
vcont_builder (this);
6760 /* Threads first. */
6761 for (thread_info
*tp
: all_non_exited_threads (this))
6763 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6765 /* If the thread was previously vCont-resumed, no need to send a specific
6766 action for it. If we didn't receive a resume request for it, don't
6767 send an action for it either. */
6768 if (remote_thr
->get_resume_state () != resume_state::RESUMED_PENDING_VCONT
)
6771 gdb_assert (!thread_is_in_step_over_chain (tp
));
6773 /* We should never be commit-resuming a thread that has a stop reply.
6774 Otherwise, we would end up reporting a stop event for a thread while
6775 it is running on the remote target. */
6776 remote_state
*rs
= get_remote_state ();
6777 for (const auto &stop_reply
: rs
->stop_reply_queue
)
6778 gdb_assert (stop_reply
->ptid
!= tp
->ptid
);
6780 const resumed_pending_vcont_info
&info
6781 = remote_thr
->resumed_pending_vcont_info ();
6783 /* Check if we need to send a specific action for this thread. If not,
6784 it will be included in a wildcard resume instead. */
6785 if (info
.step
|| info
.sig
!= GDB_SIGNAL_0
6786 || !get_remote_inferior (tp
->inf
)->may_wildcard_vcont
)
6787 vcont_builder
.push_action (tp
->ptid
, info
.step
, info
.sig
);
6789 remote_thr
->set_resumed ();
6792 /* Now check whether we can send any process-wide wildcard. This is
6793 to avoid sending a global wildcard in the case nothing is
6794 supposed to be resumed. */
6795 bool any_process_wildcard
= false;
6797 for (inferior
*inf
: all_non_exited_inferiors (this))
6799 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6801 any_process_wildcard
= true;
6806 if (any_process_wildcard
)
6808 /* If all processes are wildcard-able, then send a single "c"
6809 action, otherwise, send an "all (-1) threads of process"
6810 continue action for each running process, if any. */
6811 if (may_global_wildcard_vcont
)
6813 vcont_builder
.push_action (minus_one_ptid
,
6814 false, GDB_SIGNAL_0
);
6818 for (inferior
*inf
: all_non_exited_inferiors (this))
6820 if (get_remote_inferior (inf
)->may_wildcard_vcont
)
6822 vcont_builder
.push_action (ptid_t (inf
->pid
),
6823 false, GDB_SIGNAL_0
);
6829 vcont_builder
.flush ();
6832 /* Implementation of target_has_pending_events. */
6835 remote_target::has_pending_events ()
6837 if (target_can_async_p ())
6839 remote_state
*rs
= get_remote_state ();
6841 if (async_event_handler_marked (rs
->remote_async_inferior_event_token
))
6844 /* Note that BUFCNT can be negative, indicating sticky
6846 if (rs
->remote_desc
->bufcnt
!= 0)
6854 /* Non-stop version of target_stop. Uses `vCont;t' to stop a remote
6855 thread, all threads of a remote process, or all threads of all
6859 remote_target::remote_stop_ns (ptid_t ptid
)
6861 struct remote_state
*rs
= get_remote_state ();
6862 char *p
= rs
->buf
.data ();
6863 char *endp
= p
+ get_remote_packet_size ();
6865 /* If any thread that needs to stop was resumed but pending a vCont
6866 resume, generate a phony stop_reply. However, first check
6867 whether the thread wasn't resumed with a signal. Generating a
6868 phony stop in that case would result in losing the signal. */
6869 bool needs_commit
= false;
6870 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6872 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6874 if (remote_thr
->get_resume_state ()
6875 == resume_state::RESUMED_PENDING_VCONT
)
6877 const resumed_pending_vcont_info
&info
6878 = remote_thr
->resumed_pending_vcont_info ();
6879 if (info
.sig
!= GDB_SIGNAL_0
)
6881 /* This signal must be forwarded to the inferior. We
6882 could commit-resume just this thread, but its simpler
6883 to just commit-resume everything. */
6884 needs_commit
= true;
6893 for (thread_info
*tp
: all_non_exited_threads (this, ptid
))
6895 remote_thread_info
*remote_thr
= get_remote_thread_info (tp
);
6897 if (remote_thr
->get_resume_state ()
6898 == resume_state::RESUMED_PENDING_VCONT
)
6900 remote_debug_printf ("Enqueueing phony stop reply for thread pending "
6901 "vCont-resume (%d, %ld, %ld)", tp
->ptid
.pid(),
6902 tp
->ptid
.lwp (), tp
->ptid
.tid ());
6904 /* Check that the thread wasn't resumed with a signal.
6905 Generating a phony stop would result in losing the
6907 const resumed_pending_vcont_info
&info
6908 = remote_thr
->resumed_pending_vcont_info ();
6909 gdb_assert (info
.sig
== GDB_SIGNAL_0
);
6911 stop_reply
*sr
= new stop_reply ();
6912 sr
->ptid
= tp
->ptid
;
6914 sr
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
6915 sr
->ws
.value
.sig
= GDB_SIGNAL_0
;
6916 sr
->arch
= tp
->inf
->gdbarch
;
6917 sr
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
6918 sr
->watch_data_address
= 0;
6920 this->push_stop_reply (sr
);
6922 /* Pretend that this thread was actually resumed on the
6923 remote target, then stopped. If we leave it in the
6924 RESUMED_PENDING_VCONT state and the commit_resumed
6925 method is called while the stop reply is still in the
6926 queue, we'll end up reporting a stop event to the core
6927 for that thread while it is running on the remote
6928 target... that would be bad. */
6929 remote_thr
->set_resumed ();
6933 /* FIXME: This supports_vCont_probed check is a workaround until
6934 packet_support is per-connection. */
6935 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
6936 || !rs
->supports_vCont_probed
)
6937 remote_vcont_probe ();
6939 if (!rs
->supports_vCont
.t
)
6940 error (_("Remote server does not support stopping threads"));
6942 if (ptid
== minus_one_ptid
6943 || (!remote_multi_process_p (rs
) && ptid
.is_pid ()))
6944 p
+= xsnprintf (p
, endp
- p
, "vCont;t");
6949 p
+= xsnprintf (p
, endp
- p
, "vCont;t:");
6952 /* All (-1) threads of process. */
6953 nptid
= ptid_t (ptid
.pid (), -1, 0);
6956 /* Small optimization: if we already have a stop reply for
6957 this thread, no use in telling the stub we want this
6959 if (peek_stop_reply (ptid
))
6965 write_ptid (p
, endp
, nptid
);
6968 /* In non-stop, we get an immediate OK reply. The stop reply will
6969 come in asynchronously by notification. */
6971 getpkt (&rs
->buf
, 0);
6972 if (strcmp (rs
->buf
.data (), "OK") != 0)
6973 error (_("Stopping %s failed: %s"), target_pid_to_str (ptid
).c_str (),
6977 /* All-stop version of target_interrupt. Sends a break or a ^C to
6978 interrupt the remote target. It is undefined which thread of which
6979 process reports the interrupt. */
6982 remote_target::remote_interrupt_as ()
6984 struct remote_state
*rs
= get_remote_state ();
6986 rs
->ctrlc_pending_p
= 1;
6988 /* If the inferior is stopped already, but the core didn't know
6989 about it yet, just ignore the request. The cached wait status
6990 will be collected in remote_wait. */
6991 if (rs
->cached_wait_status
)
6994 /* Send interrupt_sequence to remote target. */
6995 send_interrupt_sequence ();
6998 /* Non-stop version of target_interrupt. Uses `vCtrlC' to interrupt
6999 the remote target. It is undefined which thread of which process
7000 reports the interrupt. Throws an error if the packet is not
7001 supported by the server. */
7004 remote_target::remote_interrupt_ns ()
7006 struct remote_state
*rs
= get_remote_state ();
7007 char *p
= rs
->buf
.data ();
7008 char *endp
= p
+ get_remote_packet_size ();
7010 xsnprintf (p
, endp
- p
, "vCtrlC");
7012 /* In non-stop, we get an immediate OK reply. The stop reply will
7013 come in asynchronously by notification. */
7015 getpkt (&rs
->buf
, 0);
7017 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vCtrlC
]))
7021 case PACKET_UNKNOWN
:
7022 error (_("No support for interrupting the remote target."));
7024 error (_("Interrupting target failed: %s"), rs
->buf
.data ());
7028 /* Implement the to_stop function for the remote targets. */
7031 remote_target::stop (ptid_t ptid
)
7033 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7035 if (target_is_non_stop_p ())
7036 remote_stop_ns (ptid
);
7039 /* We don't currently have a way to transparently pause the
7040 remote target in all-stop mode. Interrupt it instead. */
7041 remote_interrupt_as ();
7045 /* Implement the to_interrupt function for the remote targets. */
7048 remote_target::interrupt ()
7050 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7052 if (target_is_non_stop_p ())
7053 remote_interrupt_ns ();
7055 remote_interrupt_as ();
7058 /* Implement the to_pass_ctrlc function for the remote targets. */
7061 remote_target::pass_ctrlc ()
7063 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7065 struct remote_state
*rs
= get_remote_state ();
7067 /* If we're starting up, we're not fully synced yet. Quit
7069 if (rs
->starting_up
)
7071 /* If ^C has already been sent once, offer to disconnect. */
7072 else if (rs
->ctrlc_pending_p
)
7075 target_interrupt ();
7078 /* Ask the user what to do when an interrupt is received. */
7081 remote_target::interrupt_query ()
7083 struct remote_state
*rs
= get_remote_state ();
7085 if (rs
->waiting_for_stop_reply
&& rs
->ctrlc_pending_p
)
7087 if (query (_("The target is not responding to interrupt requests.\n"
7088 "Stop debugging it? ")))
7090 remote_unpush_target (this);
7091 throw_error (TARGET_CLOSE_ERROR
, _("Disconnected from target."));
7096 if (query (_("Interrupted while waiting for the program.\n"
7097 "Give up waiting? ")))
7102 /* Enable/disable target terminal ownership. Most targets can use
7103 terminal groups to control terminal ownership. Remote targets are
7104 different in that explicit transfer of ownership to/from GDB/target
7108 remote_target::terminal_inferior ()
7110 /* NOTE: At this point we could also register our selves as the
7111 recipient of all input. Any characters typed could then be
7112 passed on down to the target. */
7116 remote_target::terminal_ours ()
7121 remote_console_output (const char *msg
)
7125 for (p
= msg
; p
[0] && p
[1]; p
+= 2)
7128 char c
= fromhex (p
[0]) * 16 + fromhex (p
[1]);
7132 gdb_stdtarg
->puts (tb
);
7134 gdb_stdtarg
->flush ();
7137 /* Return the length of the stop reply queue. */
7140 remote_target::stop_reply_queue_length ()
7142 remote_state
*rs
= get_remote_state ();
7143 return rs
->stop_reply_queue
.size ();
7147 remote_notif_stop_parse (remote_target
*remote
,
7148 struct notif_client
*self
, const char *buf
,
7149 struct notif_event
*event
)
7151 remote
->remote_parse_stop_reply (buf
, (struct stop_reply
*) event
);
7155 remote_notif_stop_ack (remote_target
*remote
,
7156 struct notif_client
*self
, const char *buf
,
7157 struct notif_event
*event
)
7159 struct stop_reply
*stop_reply
= (struct stop_reply
*) event
;
7162 putpkt (remote
, self
->ack_command
);
7164 /* Kind can be TARGET_WAITKIND_IGNORE if we have meanwhile discarded
7165 the notification. It was left in the queue because we need to
7166 acknowledge it and pull the rest of the notifications out. */
7167 if (stop_reply
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
7168 remote
->push_stop_reply (stop_reply
);
7172 remote_notif_stop_can_get_pending_events (remote_target
*remote
,
7173 struct notif_client
*self
)
7175 /* We can't get pending events in remote_notif_process for
7176 notification stop, and we have to do this in remote_wait_ns
7177 instead. If we fetch all queued events from stub, remote stub
7178 may exit and we have no chance to process them back in
7180 remote_state
*rs
= remote
->get_remote_state ();
7181 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7185 stop_reply::~stop_reply ()
7187 for (cached_reg_t
®
: regcache
)
7191 static notif_event_up
7192 remote_notif_stop_alloc_reply ()
7194 return notif_event_up (new struct stop_reply ());
7197 /* A client of notification Stop. */
7199 struct notif_client notif_client_stop
=
7203 remote_notif_stop_parse
,
7204 remote_notif_stop_ack
,
7205 remote_notif_stop_can_get_pending_events
,
7206 remote_notif_stop_alloc_reply
,
7210 /* Determine if THREAD_PTID is a pending fork parent thread. ARG contains
7211 the pid of the process that owns the threads we want to check, or
7212 -1 if we want to check all threads. */
7215 is_pending_fork_parent (struct target_waitstatus
*ws
, int event_pid
,
7218 if (ws
->kind
== TARGET_WAITKIND_FORKED
7219 || ws
->kind
== TARGET_WAITKIND_VFORKED
)
7221 if (event_pid
== -1 || event_pid
== thread_ptid
.pid ())
7228 /* Return the thread's pending status used to determine whether the
7229 thread is a fork parent stopped at a fork event. */
7231 static struct target_waitstatus
*
7232 thread_pending_fork_status (struct thread_info
*thread
)
7234 if (thread
->suspend
.waitstatus_pending_p
)
7235 return &thread
->suspend
.waitstatus
;
7237 return &thread
->pending_follow
;
7240 /* Determine if THREAD is a pending fork parent thread. */
7243 is_pending_fork_parent_thread (struct thread_info
*thread
)
7245 struct target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7248 return is_pending_fork_parent (ws
, pid
, thread
->ptid
);
7251 /* If CONTEXT contains any fork child threads that have not been
7252 reported yet, remove them from the CONTEXT list. If such a
7253 thread exists it is because we are stopped at a fork catchpoint
7254 and have not yet called follow_fork, which will set up the
7255 host-side data structures for the new process. */
7258 remote_target::remove_new_fork_children (threads_listing_context
*context
)
7261 struct notif_client
*notif
= ¬if_client_stop
;
7263 /* For any threads stopped at a fork event, remove the corresponding
7264 fork child threads from the CONTEXT list. */
7265 for (thread_info
*thread
: all_non_exited_threads (this))
7267 struct target_waitstatus
*ws
= thread_pending_fork_status (thread
);
7269 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
7270 context
->remove_thread (ws
->value
.related_pid
);
7273 /* Check for any pending fork events (not reported or processed yet)
7274 in process PID and remove those fork child threads from the
7275 CONTEXT list as well. */
7276 remote_notif_get_pending_events (notif
);
7277 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7278 if (event
->ws
.kind
== TARGET_WAITKIND_FORKED
7279 || event
->ws
.kind
== TARGET_WAITKIND_VFORKED
7280 || event
->ws
.kind
== TARGET_WAITKIND_THREAD_EXITED
)
7281 context
->remove_thread (event
->ws
.value
.related_pid
);
7284 /* Check whether any event pending in the vStopped queue would prevent a
7285 global or process wildcard vCont action. Set *may_global_wildcard to
7286 false if we can't do a global wildcard (vCont;c), and clear the event
7287 inferior's may_wildcard_vcont flag if we can't do a process-wide
7288 wildcard resume (vCont;c:pPID.-1). */
7291 remote_target::check_pending_events_prevent_wildcard_vcont
7292 (bool *may_global_wildcard
)
7294 struct notif_client
*notif
= ¬if_client_stop
;
7296 remote_notif_get_pending_events (notif
);
7297 for (auto &event
: get_remote_state ()->stop_reply_queue
)
7299 if (event
->ws
.kind
== TARGET_WAITKIND_NO_RESUMED
7300 || event
->ws
.kind
== TARGET_WAITKIND_NO_HISTORY
)
7303 if (event
->ws
.kind
== TARGET_WAITKIND_FORKED
7304 || event
->ws
.kind
== TARGET_WAITKIND_VFORKED
)
7305 *may_global_wildcard
= false;
7307 /* This may be the first time we heard about this process.
7308 Regardless, we must not do a global wildcard resume, otherwise
7309 we'd resume this process too. */
7310 *may_global_wildcard
= false;
7311 if (event
->ptid
!= null_ptid
)
7313 inferior
*inf
= find_inferior_ptid (this, event
->ptid
);
7315 get_remote_inferior (inf
)->may_wildcard_vcont
= false;
7320 /* Discard all pending stop replies of inferior INF. */
7323 remote_target::discard_pending_stop_replies (struct inferior
*inf
)
7325 struct stop_reply
*reply
;
7326 struct remote_state
*rs
= get_remote_state ();
7327 struct remote_notif_state
*rns
= rs
->notif_state
;
7329 /* This function can be notified when an inferior exists. When the
7330 target is not remote, the notification state is NULL. */
7331 if (rs
->remote_desc
== NULL
)
7334 reply
= (struct stop_reply
*) rns
->pending_event
[notif_client_stop
.id
];
7336 /* Discard the in-flight notification. */
7337 if (reply
!= NULL
&& reply
->ptid
.pid () == inf
->pid
)
7339 /* Leave the notification pending, since the server expects that
7340 we acknowledge it with vStopped. But clear its contents, so
7341 that later on when we acknowledge it, we also discard it. */
7342 reply
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
7345 fprintf_unfiltered (gdb_stdlog
,
7346 "discarded in-flight notification\n");
7349 /* Discard the stop replies we have already pulled with
7351 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7352 rs
->stop_reply_queue
.end (),
7353 [=] (const stop_reply_up
&event
)
7355 return event
->ptid
.pid () == inf
->pid
;
7357 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7360 /* Discard the stop replies for RS in stop_reply_queue. */
7363 remote_target::discard_pending_stop_replies_in_queue ()
7365 remote_state
*rs
= get_remote_state ();
7367 /* Discard the stop replies we have already pulled with
7369 auto iter
= std::remove_if (rs
->stop_reply_queue
.begin (),
7370 rs
->stop_reply_queue
.end (),
7371 [=] (const stop_reply_up
&event
)
7373 return event
->rs
== rs
;
7375 rs
->stop_reply_queue
.erase (iter
, rs
->stop_reply_queue
.end ());
7378 /* Remove the first reply in 'stop_reply_queue' which matches
7382 remote_target::remote_notif_remove_queued_reply (ptid_t ptid
)
7384 remote_state
*rs
= get_remote_state ();
7386 auto iter
= std::find_if (rs
->stop_reply_queue
.begin (),
7387 rs
->stop_reply_queue
.end (),
7388 [=] (const stop_reply_up
&event
)
7390 return event
->ptid
.matches (ptid
);
7392 struct stop_reply
*result
;
7393 if (iter
== rs
->stop_reply_queue
.end ())
7397 result
= iter
->release ();
7398 rs
->stop_reply_queue
.erase (iter
);
7402 fprintf_unfiltered (gdb_stdlog
,
7403 "notif: discard queued event: 'Stop' in %s\n",
7404 target_pid_to_str (ptid
).c_str ());
7409 /* Look for a queued stop reply belonging to PTID. If one is found,
7410 remove it from the queue, and return it. Returns NULL if none is
7411 found. If there are still queued events left to process, tell the
7412 event loop to get back to target_wait soon. */
7415 remote_target::queued_stop_reply (ptid_t ptid
)
7417 remote_state
*rs
= get_remote_state ();
7418 struct stop_reply
*r
= remote_notif_remove_queued_reply (ptid
);
7420 if (!rs
->stop_reply_queue
.empty ())
7422 /* There's still at least an event left. */
7423 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7429 /* Push a fully parsed stop reply in the stop reply queue. Since we
7430 know that we now have at least one queued event left to pass to the
7431 core side, tell the event loop to get back to target_wait soon. */
7434 remote_target::push_stop_reply (struct stop_reply
*new_event
)
7436 remote_state
*rs
= get_remote_state ();
7437 rs
->stop_reply_queue
.push_back (stop_reply_up (new_event
));
7440 fprintf_unfiltered (gdb_stdlog
,
7441 "notif: push 'Stop' %s to queue %d\n",
7442 target_pid_to_str (new_event
->ptid
).c_str (),
7443 int (rs
->stop_reply_queue
.size ()));
7445 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
7448 /* Returns true if we have a stop reply for PTID. */
7451 remote_target::peek_stop_reply (ptid_t ptid
)
7453 remote_state
*rs
= get_remote_state ();
7454 for (auto &event
: rs
->stop_reply_queue
)
7455 if (ptid
== event
->ptid
7456 && event
->ws
.kind
== TARGET_WAITKIND_STOPPED
)
7461 /* Helper for remote_parse_stop_reply. Return nonzero if the substring
7462 starting with P and ending with PEND matches PREFIX. */
7465 strprefix (const char *p
, const char *pend
, const char *prefix
)
7467 for ( ; p
< pend
; p
++, prefix
++)
7470 return *prefix
== '\0';
7473 /* Parse the stop reply in BUF. Either the function succeeds, and the
7474 result is stored in EVENT, or throws an error. */
7477 remote_target::remote_parse_stop_reply (const char *buf
, stop_reply
*event
)
7479 remote_arch_state
*rsa
= NULL
;
7484 event
->ptid
= null_ptid
;
7485 event
->rs
= get_remote_state ();
7486 event
->ws
.kind
= TARGET_WAITKIND_IGNORE
;
7487 event
->ws
.value
.integer
= 0;
7488 event
->stop_reason
= TARGET_STOPPED_BY_NO_REASON
;
7489 event
->regcache
.clear ();
7494 case 'T': /* Status with PC, SP, FP, ... */
7495 /* Expedited reply, containing Signal, {regno, reg} repeat. */
7496 /* format is: 'Tssn...:r...;n...:r...;n...:r...;#cc', where
7498 n... = register number
7499 r... = register contents
7502 p
= &buf
[3]; /* after Txx */
7508 p1
= strchr (p
, ':');
7510 error (_("Malformed packet(a) (missing colon): %s\n\
7514 error (_("Malformed packet(a) (missing register number): %s\n\
7518 /* Some "registers" are actually extended stop information.
7519 Note if you're adding a new entry here: GDB 7.9 and
7520 earlier assume that all register "numbers" that start
7521 with an hex digit are real register numbers. Make sure
7522 the server only sends such a packet if it knows the
7523 client understands it. */
7525 if (strprefix (p
, p1
, "thread"))
7526 event
->ptid
= read_ptid (++p1
, &p
);
7527 else if (strprefix (p
, p1
, "syscall_entry"))
7531 event
->ws
.kind
= TARGET_WAITKIND_SYSCALL_ENTRY
;
7532 p
= unpack_varlen_hex (++p1
, &sysno
);
7533 event
->ws
.value
.syscall_number
= (int) sysno
;
7535 else if (strprefix (p
, p1
, "syscall_return"))
7539 event
->ws
.kind
= TARGET_WAITKIND_SYSCALL_RETURN
;
7540 p
= unpack_varlen_hex (++p1
, &sysno
);
7541 event
->ws
.value
.syscall_number
= (int) sysno
;
7543 else if (strprefix (p
, p1
, "watch")
7544 || strprefix (p
, p1
, "rwatch")
7545 || strprefix (p
, p1
, "awatch"))
7547 event
->stop_reason
= TARGET_STOPPED_BY_WATCHPOINT
;
7548 p
= unpack_varlen_hex (++p1
, &addr
);
7549 event
->watch_data_address
= (CORE_ADDR
) addr
;
7551 else if (strprefix (p
, p1
, "swbreak"))
7553 event
->stop_reason
= TARGET_STOPPED_BY_SW_BREAKPOINT
;
7555 /* Make sure the stub doesn't forget to indicate support
7557 if (packet_support (PACKET_swbreak_feature
) != PACKET_ENABLE
)
7558 error (_("Unexpected swbreak stop reason"));
7560 /* The value part is documented as "must be empty",
7561 though we ignore it, in case we ever decide to make
7562 use of it in a backward compatible way. */
7563 p
= strchrnul (p1
+ 1, ';');
7565 else if (strprefix (p
, p1
, "hwbreak"))
7567 event
->stop_reason
= TARGET_STOPPED_BY_HW_BREAKPOINT
;
7569 /* Make sure the stub doesn't forget to indicate support
7571 if (packet_support (PACKET_hwbreak_feature
) != PACKET_ENABLE
)
7572 error (_("Unexpected hwbreak stop reason"));
7575 p
= strchrnul (p1
+ 1, ';');
7577 else if (strprefix (p
, p1
, "library"))
7579 event
->ws
.kind
= TARGET_WAITKIND_LOADED
;
7580 p
= strchrnul (p1
+ 1, ';');
7582 else if (strprefix (p
, p1
, "replaylog"))
7584 event
->ws
.kind
= TARGET_WAITKIND_NO_HISTORY
;
7585 /* p1 will indicate "begin" or "end", but it makes
7586 no difference for now, so ignore it. */
7587 p
= strchrnul (p1
+ 1, ';');
7589 else if (strprefix (p
, p1
, "core"))
7593 p
= unpack_varlen_hex (++p1
, &c
);
7596 else if (strprefix (p
, p1
, "fork"))
7598 event
->ws
.value
.related_pid
= read_ptid (++p1
, &p
);
7599 event
->ws
.kind
= TARGET_WAITKIND_FORKED
;
7601 else if (strprefix (p
, p1
, "vfork"))
7603 event
->ws
.value
.related_pid
= read_ptid (++p1
, &p
);
7604 event
->ws
.kind
= TARGET_WAITKIND_VFORKED
;
7606 else if (strprefix (p
, p1
, "vforkdone"))
7608 event
->ws
.kind
= TARGET_WAITKIND_VFORK_DONE
;
7609 p
= strchrnul (p1
+ 1, ';');
7611 else if (strprefix (p
, p1
, "exec"))
7616 /* Determine the length of the execd pathname. */
7617 p
= unpack_varlen_hex (++p1
, &ignored
);
7618 pathlen
= (p
- p1
) / 2;
7620 /* Save the pathname for event reporting and for
7621 the next run command. */
7622 gdb::unique_xmalloc_ptr
<char[]> pathname
7623 ((char *) xmalloc (pathlen
+ 1));
7624 hex2bin (p1
, (gdb_byte
*) pathname
.get (), pathlen
);
7625 pathname
[pathlen
] = '\0';
7627 /* This is freed during event handling. */
7628 event
->ws
.value
.execd_pathname
= pathname
.release ();
7629 event
->ws
.kind
= TARGET_WAITKIND_EXECD
;
7631 /* Skip the registers included in this packet, since
7632 they may be for an architecture different from the
7633 one used by the original program. */
7636 else if (strprefix (p
, p1
, "create"))
7638 event
->ws
.kind
= TARGET_WAITKIND_THREAD_CREATED
;
7639 p
= strchrnul (p1
+ 1, ';');
7648 p
= strchrnul (p1
+ 1, ';');
7653 /* Maybe a real ``P'' register number. */
7654 p_temp
= unpack_varlen_hex (p
, &pnum
);
7655 /* If the first invalid character is the colon, we got a
7656 register number. Otherwise, it's an unknown stop
7660 /* If we haven't parsed the event's thread yet, find
7661 it now, in order to find the architecture of the
7662 reported expedited registers. */
7663 if (event
->ptid
== null_ptid
)
7665 /* If there is no thread-id information then leave
7666 the event->ptid as null_ptid. Later in
7667 process_stop_reply we will pick a suitable
7669 const char *thr
= strstr (p1
+ 1, ";thread:");
7671 event
->ptid
= read_ptid (thr
+ strlen (";thread:"),
7678 = (event
->ptid
== null_ptid
7680 : find_inferior_ptid (this, event
->ptid
));
7681 /* If this is the first time we learn anything
7682 about this process, skip the registers
7683 included in this packet, since we don't yet
7684 know which architecture to use to parse them.
7685 We'll determine the architecture later when
7686 we process the stop reply and retrieve the
7687 target description, via
7688 remote_notice_new_inferior ->
7689 post_create_inferior. */
7692 p
= strchrnul (p1
+ 1, ';');
7697 event
->arch
= inf
->gdbarch
;
7698 rsa
= event
->rs
->get_remote_arch_state (event
->arch
);
7702 = packet_reg_from_pnum (event
->arch
, rsa
, pnum
);
7703 cached_reg_t cached_reg
;
7706 error (_("Remote sent bad register number %s: %s\n\
7708 hex_string (pnum
), p
, buf
);
7710 cached_reg
.num
= reg
->regnum
;
7711 cached_reg
.data
= (gdb_byte
*)
7712 xmalloc (register_size (event
->arch
, reg
->regnum
));
7715 fieldsize
= hex2bin (p
, cached_reg
.data
,
7716 register_size (event
->arch
, reg
->regnum
));
7718 if (fieldsize
< register_size (event
->arch
, reg
->regnum
))
7719 warning (_("Remote reply is too short: %s"), buf
);
7721 event
->regcache
.push_back (cached_reg
);
7725 /* Not a number. Silently skip unknown optional
7727 p
= strchrnul (p1
+ 1, ';');
7732 error (_("Remote register badly formatted: %s\nhere: %s"),
7737 if (event
->ws
.kind
!= TARGET_WAITKIND_IGNORE
)
7741 case 'S': /* Old style status, just signal only. */
7745 event
->ws
.kind
= TARGET_WAITKIND_STOPPED
;
7746 sig
= (fromhex (buf
[1]) << 4) + fromhex (buf
[2]);
7747 if (GDB_SIGNAL_FIRST
<= sig
&& sig
< GDB_SIGNAL_LAST
)
7748 event
->ws
.value
.sig
= (enum gdb_signal
) sig
;
7750 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
7753 case 'w': /* Thread exited. */
7757 event
->ws
.kind
= TARGET_WAITKIND_THREAD_EXITED
;
7758 p
= unpack_varlen_hex (&buf
[1], &value
);
7759 event
->ws
.value
.integer
= value
;
7761 error (_("stop reply packet badly formatted: %s"), buf
);
7762 event
->ptid
= read_ptid (++p
, NULL
);
7765 case 'W': /* Target exited. */
7770 /* GDB used to accept only 2 hex chars here. Stubs should
7771 only send more if they detect GDB supports multi-process
7773 p
= unpack_varlen_hex (&buf
[1], &value
);
7777 /* The remote process exited. */
7778 event
->ws
.kind
= TARGET_WAITKIND_EXITED
;
7779 event
->ws
.value
.integer
= value
;
7783 /* The remote process exited with a signal. */
7784 event
->ws
.kind
= TARGET_WAITKIND_SIGNALLED
;
7785 if (GDB_SIGNAL_FIRST
<= value
&& value
< GDB_SIGNAL_LAST
)
7786 event
->ws
.value
.sig
= (enum gdb_signal
) value
;
7788 event
->ws
.value
.sig
= GDB_SIGNAL_UNKNOWN
;
7791 /* If no process is specified, return null_ptid, and let the
7792 caller figure out the right process to use. */
7802 else if (startswith (p
, "process:"))
7806 p
+= sizeof ("process:") - 1;
7807 unpack_varlen_hex (p
, &upid
);
7811 error (_("unknown stop reply packet: %s"), buf
);
7814 error (_("unknown stop reply packet: %s"), buf
);
7815 event
->ptid
= ptid_t (pid
);
7819 event
->ws
.kind
= TARGET_WAITKIND_NO_RESUMED
;
7820 event
->ptid
= minus_one_ptid
;
7825 /* When the stub wants to tell GDB about a new notification reply, it
7826 sends a notification (%Stop, for example). Those can come it at
7827 any time, hence, we have to make sure that any pending
7828 putpkt/getpkt sequence we're making is finished, before querying
7829 the stub for more events with the corresponding ack command
7830 (vStopped, for example). E.g., if we started a vStopped sequence
7831 immediately upon receiving the notification, something like this
7839 1.6) <-- (registers reply to step #1.3)
7841 Obviously, the reply in step #1.6 would be unexpected to a vStopped
7844 To solve this, whenever we parse a %Stop notification successfully,
7845 we mark the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN, and carry on
7846 doing whatever we were doing:
7852 <GDB marks the REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN>
7853 2.5) <-- (registers reply to step #2.3)
7855 Eventually after step #2.5, we return to the event loop, which
7856 notices there's an event on the
7857 REMOTE_ASYNC_GET_PENDING_EVENTS_TOKEN event and calls the
7858 associated callback --- the function below. At this point, we're
7859 always safe to start a vStopped sequence. :
7862 2.7) <-- T05 thread:2
7868 remote_target::remote_notif_get_pending_events (notif_client
*nc
)
7870 struct remote_state
*rs
= get_remote_state ();
7872 if (rs
->notif_state
->pending_event
[nc
->id
] != NULL
)
7875 fprintf_unfiltered (gdb_stdlog
,
7876 "notif: process: '%s' ack pending event\n",
7880 nc
->ack (this, nc
, rs
->buf
.data (),
7881 rs
->notif_state
->pending_event
[nc
->id
]);
7882 rs
->notif_state
->pending_event
[nc
->id
] = NULL
;
7886 getpkt (&rs
->buf
, 0);
7887 if (strcmp (rs
->buf
.data (), "OK") == 0)
7890 remote_notif_ack (this, nc
, rs
->buf
.data ());
7896 fprintf_unfiltered (gdb_stdlog
,
7897 "notif: process: '%s' no pending reply\n",
7902 /* Wrapper around remote_target::remote_notif_get_pending_events to
7903 avoid having to export the whole remote_target class. */
7906 remote_notif_get_pending_events (remote_target
*remote
, notif_client
*nc
)
7908 remote
->remote_notif_get_pending_events (nc
);
7911 /* Called from process_stop_reply when the stop packet we are responding
7912 to didn't include a process-id or thread-id. STATUS is the stop event
7913 we are responding to.
7915 It is the task of this function to select a suitable thread (or process)
7916 and return its ptid, this is the thread (or process) we will assume the
7917 stop event came from.
7919 In some cases there isn't really any choice about which thread (or
7920 process) is selected, a basic remote with a single process containing a
7921 single thread might choose not to send any process-id or thread-id in
7922 its stop packets, this function will select and return the one and only
7925 However, if a target supports multiple threads (or processes) and still
7926 doesn't include a thread-id (or process-id) in its stop packet then
7927 first, this is a badly behaving target, and second, we're going to have
7928 to select a thread (or process) at random and use that. This function
7929 will print a warning to the user if it detects that there is the
7930 possibility that GDB is guessing which thread (or process) to
7933 Note that this is called before GDB fetches the updated thread list from the
7934 target. So it's possible for the stop reply to be ambiguous and for GDB to
7935 not realize it. For example, if there's initially one thread, the target
7936 spawns a second thread, and then sends a stop reply without an id that
7937 concerns the first thread. GDB will assume the stop reply is about the
7938 first thread - the only thread it knows about - without printing a warning.
7939 Anyway, if the remote meant for the stop reply to be about the second thread,
7940 then it would be really broken, because GDB doesn't know about that thread
7944 remote_target::select_thread_for_ambiguous_stop_reply
7945 (const struct target_waitstatus
*status
)
7947 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
7949 /* Some stop events apply to all threads in an inferior, while others
7950 only apply to a single thread. */
7951 bool process_wide_stop
7952 = (status
->kind
== TARGET_WAITKIND_EXITED
7953 || status
->kind
== TARGET_WAITKIND_SIGNALLED
);
7955 remote_debug_printf ("process_wide_stop = %d", process_wide_stop
);
7957 thread_info
*first_resumed_thread
= nullptr;
7958 bool ambiguous
= false;
7960 /* Consider all non-exited threads of the target, find the first resumed
7962 for (thread_info
*thr
: all_non_exited_threads (this))
7964 remote_thread_info
*remote_thr
= get_remote_thread_info (thr
);
7966 if (remote_thr
->get_resume_state () != resume_state::RESUMED
)
7969 if (first_resumed_thread
== nullptr)
7970 first_resumed_thread
= thr
;
7971 else if (!process_wide_stop
7972 || first_resumed_thread
->ptid
.pid () != thr
->ptid
.pid ())
7976 gdb_assert (first_resumed_thread
!= nullptr);
7978 remote_debug_printf ("first resumed thread is %s",
7979 pid_to_str (first_resumed_thread
->ptid
).c_str ());
7980 remote_debug_printf ("is this guess ambiguous? = %d", ambiguous
);
7982 /* Warn if the remote target is sending ambiguous stop replies. */
7985 static bool warned
= false;
7989 /* If you are seeing this warning then the remote target has
7990 stopped without specifying a thread-id, but the target
7991 does have multiple threads (or inferiors), and so GDB is
7992 having to guess which thread stopped.
7994 Examples of what might cause this are the target sending
7995 and 'S' stop packet, or a 'T' stop packet and not
7996 including a thread-id.
7998 Additionally, the target might send a 'W' or 'X packet
7999 without including a process-id, when the target has
8000 multiple running inferiors. */
8001 if (process_wide_stop
)
8002 warning (_("multi-inferior target stopped without "
8003 "sending a process-id, using first "
8004 "non-exited inferior"));
8006 warning (_("multi-threaded target stopped without "
8007 "sending a thread-id, using first "
8008 "non-exited thread"));
8013 /* If this is a stop for all threads then don't use a particular threads
8014 ptid, instead create a new ptid where only the pid field is set. */
8015 if (process_wide_stop
)
8016 return ptid_t (first_resumed_thread
->ptid
.pid ());
8018 return first_resumed_thread
->ptid
;
8021 /* Called when it is decided that STOP_REPLY holds the info of the
8022 event that is to be returned to the core. This function always
8023 destroys STOP_REPLY. */
8026 remote_target::process_stop_reply (struct stop_reply
*stop_reply
,
8027 struct target_waitstatus
*status
)
8029 *status
= stop_reply
->ws
;
8030 ptid_t ptid
= stop_reply
->ptid
;
8032 /* If no thread/process was reported by the stub then select a suitable
8034 if (ptid
== null_ptid
)
8035 ptid
= select_thread_for_ambiguous_stop_reply (status
);
8036 gdb_assert (ptid
!= null_ptid
);
8038 if (status
->kind
!= TARGET_WAITKIND_EXITED
8039 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
8040 && status
->kind
!= TARGET_WAITKIND_NO_RESUMED
)
8042 /* Expedited registers. */
8043 if (!stop_reply
->regcache
.empty ())
8045 struct regcache
*regcache
8046 = get_thread_arch_regcache (this, ptid
, stop_reply
->arch
);
8048 for (cached_reg_t
®
: stop_reply
->regcache
)
8050 regcache
->raw_supply (reg
.num
, reg
.data
);
8054 stop_reply
->regcache
.clear ();
8057 remote_notice_new_inferior (ptid
, false);
8058 remote_thread_info
*remote_thr
= get_remote_thread_info (this, ptid
);
8059 remote_thr
->core
= stop_reply
->core
;
8060 remote_thr
->stop_reason
= stop_reply
->stop_reason
;
8061 remote_thr
->watch_data_address
= stop_reply
->watch_data_address
;
8063 if (target_is_non_stop_p ())
8065 /* If the target works in non-stop mode, a stop-reply indicates that
8066 only this thread stopped. */
8067 remote_thr
->set_not_resumed ();
8071 /* If the target works in all-stop mode, a stop-reply indicates that
8072 all the target's threads stopped. */
8073 for (thread_info
*tp
: all_non_exited_threads (this))
8074 get_remote_thread_info (tp
)->set_not_resumed ();
8082 /* The non-stop mode version of target_wait. */
8085 remote_target::wait_ns (ptid_t ptid
, struct target_waitstatus
*status
,
8086 target_wait_flags options
)
8088 struct remote_state
*rs
= get_remote_state ();
8089 struct stop_reply
*stop_reply
;
8093 /* If in non-stop mode, get out of getpkt even if a
8094 notification is received. */
8096 ret
= getpkt_or_notif_sane (&rs
->buf
, 0 /* forever */, &is_notif
);
8099 if (ret
!= -1 && !is_notif
)
8102 case 'E': /* Error of some sort. */
8103 /* We're out of sync with the target now. Did it continue
8104 or not? We can't tell which thread it was in non-stop,
8105 so just ignore this. */
8106 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
8108 case 'O': /* Console output. */
8109 remote_console_output (&rs
->buf
[1]);
8112 warning (_("Invalid remote reply: %s"), rs
->buf
.data ());
8116 /* Acknowledge a pending stop reply that may have arrived in the
8118 if (rs
->notif_state
->pending_event
[notif_client_stop
.id
] != NULL
)
8119 remote_notif_get_pending_events (¬if_client_stop
);
8121 /* If indeed we noticed a stop reply, we're done. */
8122 stop_reply
= queued_stop_reply (ptid
);
8123 if (stop_reply
!= NULL
)
8124 return process_stop_reply (stop_reply
, status
);
8126 /* Still no event. If we're just polling for an event, then
8127 return to the event loop. */
8128 if (options
& TARGET_WNOHANG
)
8130 status
->kind
= TARGET_WAITKIND_IGNORE
;
8131 return minus_one_ptid
;
8134 /* Otherwise do a blocking wait. */
8135 ret
= getpkt_or_notif_sane (&rs
->buf
, 1 /* forever */, &is_notif
);
8139 /* Return the first resumed thread. */
8142 first_remote_resumed_thread (remote_target
*target
)
8144 for (thread_info
*tp
: all_non_exited_threads (target
, minus_one_ptid
))
8150 /* Wait until the remote machine stops, then return, storing status in
8151 STATUS just as `wait' would. */
8154 remote_target::wait_as (ptid_t ptid
, target_waitstatus
*status
,
8155 target_wait_flags options
)
8157 struct remote_state
*rs
= get_remote_state ();
8158 ptid_t event_ptid
= null_ptid
;
8160 struct stop_reply
*stop_reply
;
8164 status
->kind
= TARGET_WAITKIND_IGNORE
;
8165 status
->value
.integer
= 0;
8167 stop_reply
= queued_stop_reply (ptid
);
8168 if (stop_reply
!= NULL
)
8169 return process_stop_reply (stop_reply
, status
);
8171 if (rs
->cached_wait_status
)
8172 /* Use the cached wait status, but only once. */
8173 rs
->cached_wait_status
= 0;
8178 int forever
= ((options
& TARGET_WNOHANG
) == 0
8179 && rs
->wait_forever_enabled_p
);
8181 if (!rs
->waiting_for_stop_reply
)
8183 status
->kind
= TARGET_WAITKIND_NO_RESUMED
;
8184 return minus_one_ptid
;
8187 /* FIXME: cagney/1999-09-27: If we're in async mode we should
8188 _never_ wait for ever -> test on target_is_async_p().
8189 However, before we do that we need to ensure that the caller
8190 knows how to take the target into/out of async mode. */
8191 ret
= getpkt_or_notif_sane (&rs
->buf
, forever
, &is_notif
);
8193 /* GDB gets a notification. Return to core as this event is
8195 if (ret
!= -1 && is_notif
)
8196 return minus_one_ptid
;
8198 if (ret
== -1 && (options
& TARGET_WNOHANG
) != 0)
8199 return minus_one_ptid
;
8202 buf
= rs
->buf
.data ();
8204 /* Assume that the target has acknowledged Ctrl-C unless we receive
8205 an 'F' or 'O' packet. */
8206 if (buf
[0] != 'F' && buf
[0] != 'O')
8207 rs
->ctrlc_pending_p
= 0;
8211 case 'E': /* Error of some sort. */
8212 /* We're out of sync with the target now. Did it continue or
8213 not? Not is more likely, so report a stop. */
8214 rs
->waiting_for_stop_reply
= 0;
8216 warning (_("Remote failure reply: %s"), buf
);
8217 status
->kind
= TARGET_WAITKIND_STOPPED
;
8218 status
->value
.sig
= GDB_SIGNAL_0
;
8220 case 'F': /* File-I/O request. */
8221 /* GDB may access the inferior memory while handling the File-I/O
8222 request, but we don't want GDB accessing memory while waiting
8223 for a stop reply. See the comments in putpkt_binary. Set
8224 waiting_for_stop_reply to 0 temporarily. */
8225 rs
->waiting_for_stop_reply
= 0;
8226 remote_fileio_request (this, buf
, rs
->ctrlc_pending_p
);
8227 rs
->ctrlc_pending_p
= 0;
8228 /* GDB handled the File-I/O request, and the target is running
8229 again. Keep waiting for events. */
8230 rs
->waiting_for_stop_reply
= 1;
8232 case 'N': case 'T': case 'S': case 'X': case 'W':
8234 /* There is a stop reply to handle. */
8235 rs
->waiting_for_stop_reply
= 0;
8238 = (struct stop_reply
*) remote_notif_parse (this,
8242 event_ptid
= process_stop_reply (stop_reply
, status
);
8245 case 'O': /* Console output. */
8246 remote_console_output (buf
+ 1);
8249 if (rs
->last_sent_signal
!= GDB_SIGNAL_0
)
8251 /* Zero length reply means that we tried 'S' or 'C' and the
8252 remote system doesn't support it. */
8253 target_terminal::ours_for_output ();
8255 ("Can't send signals to this remote system. %s not sent.\n",
8256 gdb_signal_to_name (rs
->last_sent_signal
));
8257 rs
->last_sent_signal
= GDB_SIGNAL_0
;
8258 target_terminal::inferior ();
8260 strcpy (buf
, rs
->last_sent_step
? "s" : "c");
8266 warning (_("Invalid remote reply: %s"), buf
);
8270 if (status
->kind
== TARGET_WAITKIND_NO_RESUMED
)
8271 return minus_one_ptid
;
8272 else if (status
->kind
== TARGET_WAITKIND_IGNORE
)
8274 /* Nothing interesting happened. If we're doing a non-blocking
8275 poll, we're done. Otherwise, go back to waiting. */
8276 if (options
& TARGET_WNOHANG
)
8277 return minus_one_ptid
;
8281 else if (status
->kind
!= TARGET_WAITKIND_EXITED
8282 && status
->kind
!= TARGET_WAITKIND_SIGNALLED
)
8284 if (event_ptid
!= null_ptid
)
8285 record_currthread (rs
, event_ptid
);
8287 event_ptid
= first_remote_resumed_thread (this);
8291 /* A process exit. Invalidate our notion of current thread. */
8292 record_currthread (rs
, minus_one_ptid
);
8293 /* It's possible that the packet did not include a pid. */
8294 if (event_ptid
== null_ptid
)
8295 event_ptid
= first_remote_resumed_thread (this);
8296 /* EVENT_PTID could still be NULL_PTID. Double-check. */
8297 if (event_ptid
== null_ptid
)
8298 event_ptid
= magic_null_ptid
;
8304 /* Wait until the remote machine stops, then return, storing status in
8305 STATUS just as `wait' would. */
8308 remote_target::wait (ptid_t ptid
, struct target_waitstatus
*status
,
8309 target_wait_flags options
)
8311 REMOTE_SCOPED_DEBUG_ENTER_EXIT
;
8313 remote_state
*rs
= get_remote_state ();
8315 /* Start by clearing the flag that asks for our wait method to be called,
8316 we'll mark it again at the end if needed. */
8317 if (target_is_async_p ())
8318 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
8322 if (target_is_non_stop_p ())
8323 event_ptid
= wait_ns (ptid
, status
, options
);
8325 event_ptid
= wait_as (ptid
, status
, options
);
8327 if (target_is_async_p ())
8329 /* If there are events left in the queue, or unacknowledged
8330 notifications, then tell the event loop to call us again. */
8331 if (!rs
->stop_reply_queue
.empty ()
8332 || rs
->notif_state
->pending_event
[notif_client_stop
.id
] != nullptr)
8333 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
8339 /* Fetch a single register using a 'p' packet. */
8342 remote_target::fetch_register_using_p (struct regcache
*regcache
,
8345 struct gdbarch
*gdbarch
= regcache
->arch ();
8346 struct remote_state
*rs
= get_remote_state ();
8348 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8351 if (packet_support (PACKET_p
) == PACKET_DISABLE
)
8354 if (reg
->pnum
== -1)
8357 p
= rs
->buf
.data ();
8359 p
+= hexnumstr (p
, reg
->pnum
);
8362 getpkt (&rs
->buf
, 0);
8364 buf
= rs
->buf
.data ();
8366 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_p
]))
8370 case PACKET_UNKNOWN
:
8373 error (_("Could not fetch register \"%s\"; remote failure reply '%s'"),
8374 gdbarch_register_name (regcache
->arch (),
8379 /* If this register is unfetchable, tell the regcache. */
8382 regcache
->raw_supply (reg
->regnum
, NULL
);
8386 /* Otherwise, parse and supply the value. */
8392 error (_("fetch_register_using_p: early buf termination"));
8394 regp
[i
++] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8397 regcache
->raw_supply (reg
->regnum
, regp
);
8401 /* Fetch the registers included in the target's 'g' packet. */
8404 remote_target::send_g_packet ()
8406 struct remote_state
*rs
= get_remote_state ();
8409 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "g");
8411 getpkt (&rs
->buf
, 0);
8412 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8413 error (_("Could not read registers; remote failure reply '%s'"),
8416 /* We can get out of synch in various cases. If the first character
8417 in the buffer is not a hex character, assume that has happened
8418 and try to fetch another packet to read. */
8419 while ((rs
->buf
[0] < '0' || rs
->buf
[0] > '9')
8420 && (rs
->buf
[0] < 'A' || rs
->buf
[0] > 'F')
8421 && (rs
->buf
[0] < 'a' || rs
->buf
[0] > 'f')
8422 && rs
->buf
[0] != 'x') /* New: unavailable register value. */
8424 remote_debug_printf ("Bad register packet; fetching a new packet");
8425 getpkt (&rs
->buf
, 0);
8428 buf_len
= strlen (rs
->buf
.data ());
8430 /* Sanity check the received packet. */
8431 if (buf_len
% 2 != 0)
8432 error (_("Remote 'g' packet reply is of odd length: %s"), rs
->buf
.data ());
8438 remote_target::process_g_packet (struct regcache
*regcache
)
8440 struct gdbarch
*gdbarch
= regcache
->arch ();
8441 struct remote_state
*rs
= get_remote_state ();
8442 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8447 buf_len
= strlen (rs
->buf
.data ());
8449 /* Further sanity checks, with knowledge of the architecture. */
8450 if (buf_len
> 2 * rsa
->sizeof_g_packet
)
8451 error (_("Remote 'g' packet reply is too long (expected %ld bytes, got %d "
8453 rsa
->sizeof_g_packet
, buf_len
/ 2,
8456 /* Save the size of the packet sent to us by the target. It is used
8457 as a heuristic when determining the max size of packets that the
8458 target can safely receive. */
8459 if (rsa
->actual_register_packet_size
== 0)
8460 rsa
->actual_register_packet_size
= buf_len
;
8462 /* If this is smaller than we guessed the 'g' packet would be,
8463 update our records. A 'g' reply that doesn't include a register's
8464 value implies either that the register is not available, or that
8465 the 'p' packet must be used. */
8466 if (buf_len
< 2 * rsa
->sizeof_g_packet
)
8468 long sizeof_g_packet
= buf_len
/ 2;
8470 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8472 long offset
= rsa
->regs
[i
].offset
;
8473 long reg_size
= register_size (gdbarch
, i
);
8475 if (rsa
->regs
[i
].pnum
== -1)
8478 if (offset
>= sizeof_g_packet
)
8479 rsa
->regs
[i
].in_g_packet
= 0;
8480 else if (offset
+ reg_size
> sizeof_g_packet
)
8481 error (_("Truncated register %d in remote 'g' packet"), i
);
8483 rsa
->regs
[i
].in_g_packet
= 1;
8486 /* Looks valid enough, we can assume this is the correct length
8487 for a 'g' packet. It's important not to adjust
8488 rsa->sizeof_g_packet if we have truncated registers otherwise
8489 this "if" won't be run the next time the method is called
8490 with a packet of the same size and one of the internal errors
8491 below will trigger instead. */
8492 rsa
->sizeof_g_packet
= sizeof_g_packet
;
8495 regs
= (char *) alloca (rsa
->sizeof_g_packet
);
8497 /* Unimplemented registers read as all bits zero. */
8498 memset (regs
, 0, rsa
->sizeof_g_packet
);
8500 /* Reply describes registers byte by byte, each byte encoded as two
8501 hex characters. Suck them all up, then supply them to the
8502 register cacheing/storage mechanism. */
8504 p
= rs
->buf
.data ();
8505 for (i
= 0; i
< rsa
->sizeof_g_packet
; i
++)
8507 if (p
[0] == 0 || p
[1] == 0)
8508 /* This shouldn't happen - we adjusted sizeof_g_packet above. */
8509 internal_error (__FILE__
, __LINE__
,
8510 _("unexpected end of 'g' packet reply"));
8512 if (p
[0] == 'x' && p
[1] == 'x')
8513 regs
[i
] = 0; /* 'x' */
8515 regs
[i
] = fromhex (p
[0]) * 16 + fromhex (p
[1]);
8519 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8521 struct packet_reg
*r
= &rsa
->regs
[i
];
8522 long reg_size
= register_size (gdbarch
, i
);
8526 if ((r
->offset
+ reg_size
) * 2 > strlen (rs
->buf
.data ()))
8527 /* This shouldn't happen - we adjusted in_g_packet above. */
8528 internal_error (__FILE__
, __LINE__
,
8529 _("unexpected end of 'g' packet reply"));
8530 else if (rs
->buf
[r
->offset
* 2] == 'x')
8532 gdb_assert (r
->offset
* 2 < strlen (rs
->buf
.data ()));
8533 /* The register isn't available, mark it as such (at
8534 the same time setting the value to zero). */
8535 regcache
->raw_supply (r
->regnum
, NULL
);
8538 regcache
->raw_supply (r
->regnum
, regs
+ r
->offset
);
8544 remote_target::fetch_registers_using_g (struct regcache
*regcache
)
8547 process_g_packet (regcache
);
8550 /* Make the remote selected traceframe match GDB's selected
8554 remote_target::set_remote_traceframe ()
8557 struct remote_state
*rs
= get_remote_state ();
8559 if (rs
->remote_traceframe_number
== get_traceframe_number ())
8562 /* Avoid recursion, remote_trace_find calls us again. */
8563 rs
->remote_traceframe_number
= get_traceframe_number ();
8565 newnum
= target_trace_find (tfind_number
,
8566 get_traceframe_number (), 0, 0, NULL
);
8568 /* Should not happen. If it does, all bets are off. */
8569 if (newnum
!= get_traceframe_number ())
8570 warning (_("could not set remote traceframe"));
8574 remote_target::fetch_registers (struct regcache
*regcache
, int regnum
)
8576 struct gdbarch
*gdbarch
= regcache
->arch ();
8577 struct remote_state
*rs
= get_remote_state ();
8578 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8581 set_remote_traceframe ();
8582 set_general_thread (regcache
->ptid ());
8586 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8588 gdb_assert (reg
!= NULL
);
8590 /* If this register might be in the 'g' packet, try that first -
8591 we are likely to read more than one register. If this is the
8592 first 'g' packet, we might be overly optimistic about its
8593 contents, so fall back to 'p'. */
8594 if (reg
->in_g_packet
)
8596 fetch_registers_using_g (regcache
);
8597 if (reg
->in_g_packet
)
8601 if (fetch_register_using_p (regcache
, reg
))
8604 /* This register is not available. */
8605 regcache
->raw_supply (reg
->regnum
, NULL
);
8610 fetch_registers_using_g (regcache
);
8612 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8613 if (!rsa
->regs
[i
].in_g_packet
)
8614 if (!fetch_register_using_p (regcache
, &rsa
->regs
[i
]))
8616 /* This register is not available. */
8617 regcache
->raw_supply (i
, NULL
);
8621 /* Prepare to store registers. Since we may send them all (using a
8622 'G' request), we have to read out the ones we don't want to change
8626 remote_target::prepare_to_store (struct regcache
*regcache
)
8628 struct remote_state
*rs
= get_remote_state ();
8629 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8632 /* Make sure the entire registers array is valid. */
8633 switch (packet_support (PACKET_P
))
8635 case PACKET_DISABLE
:
8636 case PACKET_SUPPORT_UNKNOWN
:
8637 /* Make sure all the necessary registers are cached. */
8638 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8639 if (rsa
->regs
[i
].in_g_packet
)
8640 regcache
->raw_update (rsa
->regs
[i
].regnum
);
8647 /* Helper: Attempt to store REGNUM using the P packet. Return fail IFF
8648 packet was not recognized. */
8651 remote_target::store_register_using_P (const struct regcache
*regcache
,
8654 struct gdbarch
*gdbarch
= regcache
->arch ();
8655 struct remote_state
*rs
= get_remote_state ();
8656 /* Try storing a single register. */
8657 char *buf
= rs
->buf
.data ();
8658 gdb_byte
*regp
= (gdb_byte
*) alloca (register_size (gdbarch
, reg
->regnum
));
8661 if (packet_support (PACKET_P
) == PACKET_DISABLE
)
8664 if (reg
->pnum
== -1)
8667 xsnprintf (buf
, get_remote_packet_size (), "P%s=", phex_nz (reg
->pnum
, 0));
8668 p
= buf
+ strlen (buf
);
8669 regcache
->raw_collect (reg
->regnum
, regp
);
8670 bin2hex (regp
, p
, register_size (gdbarch
, reg
->regnum
));
8672 getpkt (&rs
->buf
, 0);
8674 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_P
]))
8679 error (_("Could not write register \"%s\"; remote failure reply '%s'"),
8680 gdbarch_register_name (gdbarch
, reg
->regnum
), rs
->buf
.data ());
8681 case PACKET_UNKNOWN
:
8684 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
8688 /* Store register REGNUM, or all registers if REGNUM == -1, from the
8689 contents of the register cache buffer. FIXME: ignores errors. */
8692 remote_target::store_registers_using_G (const struct regcache
*regcache
)
8694 struct remote_state
*rs
= get_remote_state ();
8695 remote_arch_state
*rsa
= rs
->get_remote_arch_state (regcache
->arch ());
8699 /* Extract all the registers in the regcache copying them into a
8704 regs
= (gdb_byte
*) alloca (rsa
->sizeof_g_packet
);
8705 memset (regs
, 0, rsa
->sizeof_g_packet
);
8706 for (i
= 0; i
< gdbarch_num_regs (regcache
->arch ()); i
++)
8708 struct packet_reg
*r
= &rsa
->regs
[i
];
8711 regcache
->raw_collect (r
->regnum
, regs
+ r
->offset
);
8715 /* Command describes registers byte by byte,
8716 each byte encoded as two hex characters. */
8717 p
= rs
->buf
.data ();
8719 bin2hex (regs
, p
, rsa
->sizeof_g_packet
);
8721 getpkt (&rs
->buf
, 0);
8722 if (packet_check_result (rs
->buf
) == PACKET_ERROR
)
8723 error (_("Could not write registers; remote failure reply '%s'"),
8727 /* Store register REGNUM, or all registers if REGNUM == -1, from the contents
8728 of the register cache buffer. FIXME: ignores errors. */
8731 remote_target::store_registers (struct regcache
*regcache
, int regnum
)
8733 struct gdbarch
*gdbarch
= regcache
->arch ();
8734 struct remote_state
*rs
= get_remote_state ();
8735 remote_arch_state
*rsa
= rs
->get_remote_arch_state (gdbarch
);
8738 set_remote_traceframe ();
8739 set_general_thread (regcache
->ptid ());
8743 packet_reg
*reg
= packet_reg_from_regnum (gdbarch
, rsa
, regnum
);
8745 gdb_assert (reg
!= NULL
);
8747 /* Always prefer to store registers using the 'P' packet if
8748 possible; we often change only a small number of registers.
8749 Sometimes we change a larger number; we'd need help from a
8750 higher layer to know to use 'G'. */
8751 if (store_register_using_P (regcache
, reg
))
8754 /* For now, don't complain if we have no way to write the
8755 register. GDB loses track of unavailable registers too
8756 easily. Some day, this may be an error. We don't have
8757 any way to read the register, either... */
8758 if (!reg
->in_g_packet
)
8761 store_registers_using_G (regcache
);
8765 store_registers_using_G (regcache
);
8767 for (i
= 0; i
< gdbarch_num_regs (gdbarch
); i
++)
8768 if (!rsa
->regs
[i
].in_g_packet
)
8769 if (!store_register_using_P (regcache
, &rsa
->regs
[i
]))
8770 /* See above for why we do not issue an error here. */
8775 /* Return the number of hex digits in num. */
8778 hexnumlen (ULONGEST num
)
8782 for (i
= 0; num
!= 0; i
++)
8785 return std::max (i
, 1);
8788 /* Set BUF to the minimum number of hex digits representing NUM. */
8791 hexnumstr (char *buf
, ULONGEST num
)
8793 int len
= hexnumlen (num
);
8795 return hexnumnstr (buf
, num
, len
);
8799 /* Set BUF to the hex digits representing NUM, padded to WIDTH characters. */
8802 hexnumnstr (char *buf
, ULONGEST num
, int width
)
8808 for (i
= width
- 1; i
>= 0; i
--)
8810 buf
[i
] = "0123456789abcdef"[(num
& 0xf)];
8817 /* Mask all but the least significant REMOTE_ADDRESS_SIZE bits. */
8820 remote_address_masked (CORE_ADDR addr
)
8822 unsigned int address_size
= remote_address_size
;
8824 /* If "remoteaddresssize" was not set, default to target address size. */
8826 address_size
= gdbarch_addr_bit (target_gdbarch ());
8828 if (address_size
> 0
8829 && address_size
< (sizeof (ULONGEST
) * 8))
8831 /* Only create a mask when that mask can safely be constructed
8832 in a ULONGEST variable. */
8835 mask
= (mask
<< address_size
) - 1;
8841 /* Determine whether the remote target supports binary downloading.
8842 This is accomplished by sending a no-op memory write of zero length
8843 to the target at the specified address. It does not suffice to send
8844 the whole packet, since many stubs strip the eighth bit and
8845 subsequently compute a wrong checksum, which causes real havoc with
8848 NOTE: This can still lose if the serial line is not eight-bit
8849 clean. In cases like this, the user should clear "remote
8853 remote_target::check_binary_download (CORE_ADDR addr
)
8855 struct remote_state
*rs
= get_remote_state ();
8857 switch (packet_support (PACKET_X
))
8859 case PACKET_DISABLE
:
8863 case PACKET_SUPPORT_UNKNOWN
:
8867 p
= rs
->buf
.data ();
8869 p
+= hexnumstr (p
, (ULONGEST
) addr
);
8871 p
+= hexnumstr (p
, (ULONGEST
) 0);
8875 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
8876 getpkt (&rs
->buf
, 0);
8878 if (rs
->buf
[0] == '\0')
8880 remote_debug_printf ("binary downloading NOT supported by target");
8881 remote_protocol_packets
[PACKET_X
].support
= PACKET_DISABLE
;
8885 remote_debug_printf ("binary downloading supported by target");
8886 remote_protocol_packets
[PACKET_X
].support
= PACKET_ENABLE
;
8893 /* Helper function to resize the payload in order to try to get a good
8894 alignment. We try to write an amount of data such that the next write will
8895 start on an address aligned on REMOTE_ALIGN_WRITES. */
8898 align_for_efficient_write (int todo
, CORE_ADDR memaddr
)
8900 return ((memaddr
+ todo
) & ~(REMOTE_ALIGN_WRITES
- 1)) - memaddr
;
8903 /* Write memory data directly to the remote machine.
8904 This does not inform the data cache; the data cache uses this.
8905 HEADER is the starting part of the packet.
8906 MEMADDR is the address in the remote memory space.
8907 MYADDR is the address of the buffer in our space.
8908 LEN_UNITS is the number of addressable units to write.
8909 UNIT_SIZE is the length in bytes of an addressable unit.
8910 PACKET_FORMAT should be either 'X' or 'M', and indicates if we
8911 should send data as binary ('X'), or hex-encoded ('M').
8913 The function creates packet of the form
8914 <HEADER><ADDRESS>,<LENGTH>:<DATA>
8916 where encoding of <DATA> is terminated by PACKET_FORMAT.
8918 If USE_LENGTH is 0, then the <LENGTH> field and the preceding comma
8921 Return the transferred status, error or OK (an
8922 'enum target_xfer_status' value). Save the number of addressable units
8923 transferred in *XFERED_LEN_UNITS. Only transfer a single packet.
8925 On a platform with an addressable memory size of 2 bytes (UNIT_SIZE == 2), an
8926 exchange between gdb and the stub could look like (?? in place of the
8932 -> $M1000,3:eeeeffffeeee#??
8936 <- eeeeffffeeeedddd */
8939 remote_target::remote_write_bytes_aux (const char *header
, CORE_ADDR memaddr
,
8940 const gdb_byte
*myaddr
,
8943 ULONGEST
*xfered_len_units
,
8944 char packet_format
, int use_length
)
8946 struct remote_state
*rs
= get_remote_state ();
8952 int payload_capacity_bytes
;
8953 int payload_length_bytes
;
8955 if (packet_format
!= 'X' && packet_format
!= 'M')
8956 internal_error (__FILE__
, __LINE__
,
8957 _("remote_write_bytes_aux: bad packet format"));
8960 return TARGET_XFER_EOF
;
8962 payload_capacity_bytes
= get_memory_write_packet_size ();
8964 /* The packet buffer will be large enough for the payload;
8965 get_memory_packet_size ensures this. */
8968 /* Compute the size of the actual payload by subtracting out the
8969 packet header and footer overhead: "$M<memaddr>,<len>:...#nn". */
8971 payload_capacity_bytes
-= strlen ("$,:#NN");
8973 /* The comma won't be used. */
8974 payload_capacity_bytes
+= 1;
8975 payload_capacity_bytes
-= strlen (header
);
8976 payload_capacity_bytes
-= hexnumlen (memaddr
);
8978 /* Construct the packet excluding the data: "<header><memaddr>,<len>:". */
8980 strcat (rs
->buf
.data (), header
);
8981 p
= rs
->buf
.data () + strlen (header
);
8983 /* Compute a best guess of the number of bytes actually transfered. */
8984 if (packet_format
== 'X')
8986 /* Best guess at number of bytes that will fit. */
8987 todo_units
= std::min (len_units
,
8988 (ULONGEST
) payload_capacity_bytes
/ unit_size
);
8990 payload_capacity_bytes
-= hexnumlen (todo_units
);
8991 todo_units
= std::min (todo_units
, payload_capacity_bytes
/ unit_size
);
8995 /* Number of bytes that will fit. */
8997 = std::min (len_units
,
8998 (ULONGEST
) (payload_capacity_bytes
/ unit_size
) / 2);
9000 payload_capacity_bytes
-= hexnumlen (todo_units
);
9001 todo_units
= std::min (todo_units
,
9002 (payload_capacity_bytes
/ unit_size
) / 2);
9005 if (todo_units
<= 0)
9006 internal_error (__FILE__
, __LINE__
,
9007 _("minimum packet size too small to write data"));
9009 /* If we already need another packet, then try to align the end
9010 of this packet to a useful boundary. */
9011 if (todo_units
> 2 * REMOTE_ALIGN_WRITES
&& todo_units
< len_units
)
9012 todo_units
= align_for_efficient_write (todo_units
, memaddr
);
9014 /* Append "<memaddr>". */
9015 memaddr
= remote_address_masked (memaddr
);
9016 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9023 /* Append the length and retain its location and size. It may need to be
9024 adjusted once the packet body has been created. */
9026 plenlen
= hexnumstr (p
, (ULONGEST
) todo_units
);
9034 /* Append the packet body. */
9035 if (packet_format
== 'X')
9037 /* Binary mode. Send target system values byte by byte, in
9038 increasing byte addresses. Only escape certain critical
9040 payload_length_bytes
=
9041 remote_escape_output (myaddr
, todo_units
, unit_size
, (gdb_byte
*) p
,
9042 &units_written
, payload_capacity_bytes
);
9044 /* If not all TODO units fit, then we'll need another packet. Make
9045 a second try to keep the end of the packet aligned. Don't do
9046 this if the packet is tiny. */
9047 if (units_written
< todo_units
&& units_written
> 2 * REMOTE_ALIGN_WRITES
)
9051 new_todo_units
= align_for_efficient_write (units_written
, memaddr
);
9053 if (new_todo_units
!= units_written
)
9054 payload_length_bytes
=
9055 remote_escape_output (myaddr
, new_todo_units
, unit_size
,
9056 (gdb_byte
*) p
, &units_written
,
9057 payload_capacity_bytes
);
9060 p
+= payload_length_bytes
;
9061 if (use_length
&& units_written
< todo_units
)
9063 /* Escape chars have filled up the buffer prematurely,
9064 and we have actually sent fewer units than planned.
9065 Fix-up the length field of the packet. Use the same
9066 number of characters as before. */
9067 plen
+= hexnumnstr (plen
, (ULONGEST
) units_written
,
9069 *plen
= ':'; /* overwrite \0 from hexnumnstr() */
9074 /* Normal mode: Send target system values byte by byte, in
9075 increasing byte addresses. Each byte is encoded as a two hex
9077 p
+= 2 * bin2hex (myaddr
, p
, todo_units
* unit_size
);
9078 units_written
= todo_units
;
9081 putpkt_binary (rs
->buf
.data (), (int) (p
- rs
->buf
.data ()));
9082 getpkt (&rs
->buf
, 0);
9084 if (rs
->buf
[0] == 'E')
9085 return TARGET_XFER_E_IO
;
9087 /* Return UNITS_WRITTEN, not TODO_UNITS, in case escape chars caused us to
9088 send fewer units than we'd planned. */
9089 *xfered_len_units
= (ULONGEST
) units_written
;
9090 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9093 /* Write memory data directly to the remote machine.
9094 This does not inform the data cache; the data cache uses this.
9095 MEMADDR is the address in the remote memory space.
9096 MYADDR is the address of the buffer in our space.
9097 LEN is the number of bytes.
9099 Return the transferred status, error or OK (an
9100 'enum target_xfer_status' value). Save the number of bytes
9101 transferred in *XFERED_LEN. Only transfer a single packet. */
9104 remote_target::remote_write_bytes (CORE_ADDR memaddr
, const gdb_byte
*myaddr
,
9105 ULONGEST len
, int unit_size
,
9106 ULONGEST
*xfered_len
)
9108 const char *packet_format
= NULL
;
9110 /* Check whether the target supports binary download. */
9111 check_binary_download (memaddr
);
9113 switch (packet_support (PACKET_X
))
9116 packet_format
= "X";
9118 case PACKET_DISABLE
:
9119 packet_format
= "M";
9121 case PACKET_SUPPORT_UNKNOWN
:
9122 internal_error (__FILE__
, __LINE__
,
9123 _("remote_write_bytes: bad internal state"));
9125 internal_error (__FILE__
, __LINE__
, _("bad switch"));
9128 return remote_write_bytes_aux (packet_format
,
9129 memaddr
, myaddr
, len
, unit_size
, xfered_len
,
9130 packet_format
[0], 1);
9133 /* Read memory data directly from the remote machine.
9134 This does not use the data cache; the data cache uses this.
9135 MEMADDR is the address in the remote memory space.
9136 MYADDR is the address of the buffer in our space.
9137 LEN_UNITS is the number of addressable memory units to read..
9138 UNIT_SIZE is the length in bytes of an addressable unit.
9140 Return the transferred status, error or OK (an
9141 'enum target_xfer_status' value). Save the number of bytes
9142 transferred in *XFERED_LEN_UNITS.
9144 See the comment of remote_write_bytes_aux for an example of
9145 memory read/write exchange between gdb and the stub. */
9148 remote_target::remote_read_bytes_1 (CORE_ADDR memaddr
, gdb_byte
*myaddr
,
9150 int unit_size
, ULONGEST
*xfered_len_units
)
9152 struct remote_state
*rs
= get_remote_state ();
9153 int buf_size_bytes
; /* Max size of packet output buffer. */
9158 buf_size_bytes
= get_memory_read_packet_size ();
9159 /* The packet buffer will be large enough for the payload;
9160 get_memory_packet_size ensures this. */
9162 /* Number of units that will fit. */
9163 todo_units
= std::min (len_units
,
9164 (ULONGEST
) (buf_size_bytes
/ unit_size
) / 2);
9166 /* Construct "m"<memaddr>","<len>". */
9167 memaddr
= remote_address_masked (memaddr
);
9168 p
= rs
->buf
.data ();
9170 p
+= hexnumstr (p
, (ULONGEST
) memaddr
);
9172 p
+= hexnumstr (p
, (ULONGEST
) todo_units
);
9175 getpkt (&rs
->buf
, 0);
9176 if (rs
->buf
[0] == 'E'
9177 && isxdigit (rs
->buf
[1]) && isxdigit (rs
->buf
[2])
9178 && rs
->buf
[3] == '\0')
9179 return TARGET_XFER_E_IO
;
9180 /* Reply describes memory byte by byte, each byte encoded as two hex
9182 p
= rs
->buf
.data ();
9183 decoded_bytes
= hex2bin (p
, myaddr
, todo_units
* unit_size
);
9184 /* Return what we have. Let higher layers handle partial reads. */
9185 *xfered_len_units
= (ULONGEST
) (decoded_bytes
/ unit_size
);
9186 return (*xfered_len_units
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
9189 /* Using the set of read-only target sections of remote, read live
9192 For interface/parameters/return description see target.h,
9196 remote_target::remote_xfer_live_readonly_partial (gdb_byte
*readbuf
,
9200 ULONGEST
*xfered_len
)
9202 const struct target_section
*secp
;
9204 secp
= target_section_by_addr (this, memaddr
);
9206 && (bfd_section_flags (secp
->the_bfd_section
) & SEC_READONLY
))
9208 ULONGEST memend
= memaddr
+ len
;
9210 const target_section_table
*table
= target_get_section_table (this);
9211 for (const target_section
&p
: *table
)
9213 if (memaddr
>= p
.addr
)
9215 if (memend
<= p
.endaddr
)
9217 /* Entire transfer is within this section. */
9218 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9221 else if (memaddr
>= p
.endaddr
)
9223 /* This section ends before the transfer starts. */
9228 /* This section overlaps the transfer. Just do half. */
9229 len
= p
.endaddr
- memaddr
;
9230 return remote_read_bytes_1 (memaddr
, readbuf
, len
, unit_size
,
9237 return TARGET_XFER_EOF
;
9240 /* Similar to remote_read_bytes_1, but it reads from the remote stub
9241 first if the requested memory is unavailable in traceframe.
9242 Otherwise, fall back to remote_read_bytes_1. */
9245 remote_target::remote_read_bytes (CORE_ADDR memaddr
,
9246 gdb_byte
*myaddr
, ULONGEST len
, int unit_size
,
9247 ULONGEST
*xfered_len
)
9250 return TARGET_XFER_EOF
;
9252 if (get_traceframe_number () != -1)
9254 std::vector
<mem_range
> available
;
9256 /* If we fail to get the set of available memory, then the
9257 target does not support querying traceframe info, and so we
9258 attempt reading from the traceframe anyway (assuming the
9259 target implements the old QTro packet then). */
9260 if (traceframe_available_memory (&available
, memaddr
, len
))
9262 if (available
.empty () || available
[0].start
!= memaddr
)
9264 enum target_xfer_status res
;
9266 /* Don't read into the traceframe's available
9268 if (!available
.empty ())
9270 LONGEST oldlen
= len
;
9272 len
= available
[0].start
- memaddr
;
9273 gdb_assert (len
<= oldlen
);
9276 /* This goes through the topmost target again. */
9277 res
= remote_xfer_live_readonly_partial (myaddr
, memaddr
,
9278 len
, unit_size
, xfered_len
);
9279 if (res
== TARGET_XFER_OK
)
9280 return TARGET_XFER_OK
;
9283 /* No use trying further, we know some memory starting
9284 at MEMADDR isn't available. */
9286 return (*xfered_len
!= 0) ?
9287 TARGET_XFER_UNAVAILABLE
: TARGET_XFER_EOF
;
9291 /* Don't try to read more than how much is available, in
9292 case the target implements the deprecated QTro packet to
9293 cater for older GDBs (the target's knowledge of read-only
9294 sections may be outdated by now). */
9295 len
= available
[0].length
;
9299 return remote_read_bytes_1 (memaddr
, myaddr
, len
, unit_size
, xfered_len
);
9304 /* Sends a packet with content determined by the printf format string
9305 FORMAT and the remaining arguments, then gets the reply. Returns
9306 whether the packet was a success, a failure, or unknown. */
9309 remote_target::remote_send_printf (const char *format
, ...)
9311 struct remote_state
*rs
= get_remote_state ();
9312 int max_size
= get_remote_packet_size ();
9315 va_start (ap
, format
);
9318 int size
= vsnprintf (rs
->buf
.data (), max_size
, format
, ap
);
9322 if (size
>= max_size
)
9323 internal_error (__FILE__
, __LINE__
, _("Too long remote packet."));
9325 if (putpkt (rs
->buf
) < 0)
9326 error (_("Communication problem with target."));
9329 getpkt (&rs
->buf
, 0);
9331 return packet_check_result (rs
->buf
);
9334 /* Flash writing can take quite some time. We'll set
9335 effectively infinite timeout for flash operations.
9336 In future, we'll need to decide on a better approach. */
9337 static const int remote_flash_timeout
= 1000;
9340 remote_target::flash_erase (ULONGEST address
, LONGEST length
)
9342 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
9343 enum packet_result ret
;
9344 scoped_restore restore_timeout
9345 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9347 ret
= remote_send_printf ("vFlashErase:%s,%s",
9348 phex (address
, addr_size
),
9352 case PACKET_UNKNOWN
:
9353 error (_("Remote target does not support flash erase"));
9355 error (_("Error erasing flash with vFlashErase packet"));
9362 remote_target::remote_flash_write (ULONGEST address
,
9363 ULONGEST length
, ULONGEST
*xfered_len
,
9364 const gdb_byte
*data
)
9366 scoped_restore restore_timeout
9367 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9368 return remote_write_bytes_aux ("vFlashWrite:", address
, data
, length
, 1,
9373 remote_target::flash_done ()
9377 scoped_restore restore_timeout
9378 = make_scoped_restore (&remote_timeout
, remote_flash_timeout
);
9380 ret
= remote_send_printf ("vFlashDone");
9384 case PACKET_UNKNOWN
:
9385 error (_("Remote target does not support vFlashDone"));
9387 error (_("Error finishing flash operation"));
9394 remote_target::files_info ()
9396 puts_filtered ("Debugging a target over a serial line.\n");
9399 /* Stuff for dealing with the packets which are part of this protocol.
9400 See comment at top of file for details. */
9402 /* Close/unpush the remote target, and throw a TARGET_CLOSE_ERROR
9403 error to higher layers. Called when a serial error is detected.
9404 The exception message is STRING, followed by a colon and a blank,
9405 the system error message for errno at function entry and final dot
9406 for output compatibility with throw_perror_with_name. */
9409 unpush_and_perror (remote_target
*target
, const char *string
)
9411 int saved_errno
= errno
;
9413 remote_unpush_target (target
);
9414 throw_error (TARGET_CLOSE_ERROR
, "%s: %s.", string
,
9415 safe_strerror (saved_errno
));
9418 /* Read a single character from the remote end. The current quit
9419 handler is overridden to avoid quitting in the middle of packet
9420 sequence, as that would break communication with the remote server.
9421 See remote_serial_quit_handler for more detail. */
9424 remote_target::readchar (int timeout
)
9427 struct remote_state
*rs
= get_remote_state ();
9430 scoped_restore restore_quit_target
9431 = make_scoped_restore (&curr_quit_handler_target
, this);
9432 scoped_restore restore_quit
9433 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9435 rs
->got_ctrlc_during_io
= 0;
9437 ch
= serial_readchar (rs
->remote_desc
, timeout
);
9439 if (rs
->got_ctrlc_during_io
)
9446 switch ((enum serial_rc
) ch
)
9449 remote_unpush_target (this);
9450 throw_error (TARGET_CLOSE_ERROR
, _("Remote connection closed"));
9453 unpush_and_perror (this, _("Remote communication error. "
9454 "Target disconnected."));
9456 case SERIAL_TIMEOUT
:
9462 /* Wrapper for serial_write that closes the target and throws if
9463 writing fails. The current quit handler is overridden to avoid
9464 quitting in the middle of packet sequence, as that would break
9465 communication with the remote server. See
9466 remote_serial_quit_handler for more detail. */
9469 remote_target::remote_serial_write (const char *str
, int len
)
9471 struct remote_state
*rs
= get_remote_state ();
9473 scoped_restore restore_quit_target
9474 = make_scoped_restore (&curr_quit_handler_target
, this);
9475 scoped_restore restore_quit
9476 = make_scoped_restore (&quit_handler
, ::remote_serial_quit_handler
);
9478 rs
->got_ctrlc_during_io
= 0;
9480 if (serial_write (rs
->remote_desc
, str
, len
))
9482 unpush_and_perror (this, _("Remote communication error. "
9483 "Target disconnected."));
9486 if (rs
->got_ctrlc_during_io
)
9490 /* Return a string representing an escaped version of BUF, of len N.
9491 E.g. \n is converted to \\n, \t to \\t, etc. */
9494 escape_buffer (const char *buf
, int n
)
9498 stb
.putstrn (buf
, n
, '\\');
9499 return std::move (stb
.string ());
9502 /* Display a null-terminated packet on stdout, for debugging, using C
9506 print_packet (const char *buf
)
9508 puts_filtered ("\"");
9509 fputstr_filtered (buf
, '"', gdb_stdout
);
9510 puts_filtered ("\"");
9514 remote_target::putpkt (const char *buf
)
9516 return putpkt_binary (buf
, strlen (buf
));
9519 /* Wrapper around remote_target::putpkt to avoid exporting
9523 putpkt (remote_target
*remote
, const char *buf
)
9525 return remote
->putpkt (buf
);
9528 /* Send a packet to the remote machine, with error checking. The data
9529 of the packet is in BUF. The string in BUF can be at most
9530 get_remote_packet_size () - 5 to account for the $, # and checksum,
9531 and for a possible /0 if we are debugging (remote_debug) and want
9532 to print the sent packet as a string. */
9535 remote_target::putpkt_binary (const char *buf
, int cnt
)
9537 struct remote_state
*rs
= get_remote_state ();
9539 unsigned char csum
= 0;
9540 gdb::def_vector
<char> data (cnt
+ 6);
9541 char *buf2
= data
.data ();
9547 /* Catch cases like trying to read memory or listing threads while
9548 we're waiting for a stop reply. The remote server wouldn't be
9549 ready to handle this request, so we'd hang and timeout. We don't
9550 have to worry about this in synchronous mode, because in that
9551 case it's not possible to issue a command while the target is
9552 running. This is not a problem in non-stop mode, because in that
9553 case, the stub is always ready to process serial input. */
9554 if (!target_is_non_stop_p ()
9555 && target_is_async_p ()
9556 && rs
->waiting_for_stop_reply
)
9558 error (_("Cannot execute this command while the target is running.\n"
9559 "Use the \"interrupt\" command to stop the target\n"
9560 "and then try again."));
9563 /* We're sending out a new packet. Make sure we don't look at a
9564 stale cached response. */
9565 rs
->cached_wait_status
= 0;
9567 /* Copy the packet into buffer BUF2, encapsulating it
9568 and giving it a checksum. */
9573 for (i
= 0; i
< cnt
; i
++)
9579 *p
++ = tohex ((csum
>> 4) & 0xf);
9580 *p
++ = tohex (csum
& 0xf);
9582 /* Send it over and over until we get a positive ack. */
9590 int len
= (int) (p
- buf2
);
9593 if (remote_packet_max_chars
< 0)
9596 max_chars
= remote_packet_max_chars
;
9599 = escape_buffer (buf2
, std::min (len
, max_chars
));
9601 if (len
> max_chars
)
9602 remote_debug_printf_nofunc
9603 ("Sending packet: %s [%d bytes omitted]", str
.c_str (),
9606 remote_debug_printf_nofunc ("Sending packet: %s", str
.c_str ());
9608 remote_serial_write (buf2
, p
- buf2
);
9610 /* If this is a no acks version of the remote protocol, send the
9611 packet and move on. */
9615 /* Read until either a timeout occurs (-2) or '+' is read.
9616 Handle any notification that arrives in the mean time. */
9619 ch
= readchar (remote_timeout
);
9624 remote_debug_printf_nofunc ("Received Ack");
9627 remote_debug_printf_nofunc ("Received Nak");
9629 case SERIAL_TIMEOUT
:
9633 break; /* Retransmit buffer. */
9636 remote_debug_printf ("Packet instead of Ack, ignoring it");
9637 /* It's probably an old response sent because an ACK
9638 was lost. Gobble up the packet and ack it so it
9639 doesn't get retransmitted when we resend this
9642 remote_serial_write ("+", 1);
9643 continue; /* Now, go look for +. */
9650 /* If we got a notification, handle it, and go back to looking
9652 /* We've found the start of a notification. Now
9653 collect the data. */
9654 val
= read_frame (&rs
->buf
);
9657 remote_debug_printf_nofunc
9658 (" Notification received: %s",
9659 escape_buffer (rs
->buf
.data (), val
).c_str ());
9661 handle_notification (rs
->notif_state
, rs
->buf
.data ());
9662 /* We're in sync now, rewait for the ack. */
9666 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9672 remote_debug_printf_nofunc ("Junk: %c%s", ch
& 0177,
9676 break; /* Here to retransmit. */
9680 /* This is wrong. If doing a long backtrace, the user should be
9681 able to get out next time we call QUIT, without anything as
9682 violent as interrupt_query. If we want to provide a way out of
9683 here without getting to the next QUIT, it should be based on
9684 hitting ^C twice as in remote_wait. */
9696 /* Come here after finding the start of a frame when we expected an
9697 ack. Do our best to discard the rest of this packet. */
9700 remote_target::skip_frame ()
9706 c
= readchar (remote_timeout
);
9709 case SERIAL_TIMEOUT
:
9710 /* Nothing we can do. */
9713 /* Discard the two bytes of checksum and stop. */
9714 c
= readchar (remote_timeout
);
9716 c
= readchar (remote_timeout
);
9719 case '*': /* Run length encoding. */
9720 /* Discard the repeat count. */
9721 c
= readchar (remote_timeout
);
9726 /* A regular character. */
9732 /* Come here after finding the start of the frame. Collect the rest
9733 into *BUF, verifying the checksum, length, and handling run-length
9734 compression. NUL terminate the buffer. If there is not enough room,
9737 Returns -1 on error, number of characters in buffer (ignoring the
9738 trailing NULL) on success. (could be extended to return one of the
9739 SERIAL status indications). */
9742 remote_target::read_frame (gdb::char_vector
*buf_p
)
9747 char *buf
= buf_p
->data ();
9748 struct remote_state
*rs
= get_remote_state ();
9755 c
= readchar (remote_timeout
);
9758 case SERIAL_TIMEOUT
:
9759 remote_debug_printf ("Timeout in mid-packet, retrying");
9763 remote_debug_printf ("Saw new packet start in middle of old one");
9764 return -1; /* Start a new packet, count retries. */
9768 unsigned char pktcsum
;
9774 check_0
= readchar (remote_timeout
);
9776 check_1
= readchar (remote_timeout
);
9778 if (check_0
== SERIAL_TIMEOUT
|| check_1
== SERIAL_TIMEOUT
)
9780 remote_debug_printf ("Timeout in checksum, retrying");
9783 else if (check_0
< 0 || check_1
< 0)
9785 remote_debug_printf ("Communication error in checksum");
9789 /* Don't recompute the checksum; with no ack packets we
9790 don't have any way to indicate a packet retransmission
9795 pktcsum
= (fromhex (check_0
) << 4) | fromhex (check_1
);
9796 if (csum
== pktcsum
)
9800 ("Bad checksum, sentsum=0x%x, csum=0x%x, buf=%s",
9801 pktcsum
, csum
, escape_buffer (buf
, bc
).c_str ());
9803 /* Number of characters in buffer ignoring trailing
9807 case '*': /* Run length encoding. */
9812 c
= readchar (remote_timeout
);
9814 repeat
= c
- ' ' + 3; /* Compute repeat count. */
9816 /* The character before ``*'' is repeated. */
9818 if (repeat
> 0 && repeat
<= 255 && bc
> 0)
9820 if (bc
+ repeat
- 1 >= buf_p
->size () - 1)
9822 /* Make some more room in the buffer. */
9823 buf_p
->resize (buf_p
->size () + repeat
);
9824 buf
= buf_p
->data ();
9827 memset (&buf
[bc
], buf
[bc
- 1], repeat
);
9833 printf_filtered (_("Invalid run length encoding: %s\n"), buf
);
9837 if (bc
>= buf_p
->size () - 1)
9839 /* Make some more room in the buffer. */
9840 buf_p
->resize (buf_p
->size () * 2);
9841 buf
= buf_p
->data ();
9851 /* Set this to the maximum number of seconds to wait instead of waiting forever
9852 in target_wait(). If this timer times out, then it generates an error and
9853 the command is aborted. This replaces most of the need for timeouts in the
9854 GDB test suite, and makes it possible to distinguish between a hung target
9855 and one with slow communications. */
9857 static int watchdog
= 0;
9859 show_watchdog (struct ui_file
*file
, int from_tty
,
9860 struct cmd_list_element
*c
, const char *value
)
9862 fprintf_filtered (file
, _("Watchdog timer is %s.\n"), value
);
9865 /* Read a packet from the remote machine, with error checking, and
9866 store it in *BUF. Resize *BUF if necessary to hold the result. If
9867 FOREVER, wait forever rather than timing out; this is used (in
9868 synchronous mode) to wait for a target that is is executing user
9870 /* FIXME: ezannoni 2000-02-01 this wrapper is necessary so that we
9871 don't have to change all the calls to getpkt to deal with the
9872 return value, because at the moment I don't know what the right
9873 thing to do it for those. */
9876 remote_target::getpkt (gdb::char_vector
*buf
, int forever
)
9878 getpkt_sane (buf
, forever
);
9882 /* Read a packet from the remote machine, with error checking, and
9883 store it in *BUF. Resize *BUF if necessary to hold the result. If
9884 FOREVER, wait forever rather than timing out; this is used (in
9885 synchronous mode) to wait for a target that is is executing user
9886 code to stop. If FOREVER == 0, this function is allowed to time
9887 out gracefully and return an indication of this to the caller.
9888 Otherwise return the number of bytes read. If EXPECTING_NOTIF,
9889 consider receiving a notification enough reason to return to the
9890 caller. *IS_NOTIF is an output boolean that indicates whether *BUF
9891 holds a notification or not (a regular packet). */
9894 remote_target::getpkt_or_notif_sane_1 (gdb::char_vector
*buf
,
9895 int forever
, int expecting_notif
,
9898 struct remote_state
*rs
= get_remote_state ();
9904 /* We're reading a new response. Make sure we don't look at a
9905 previously cached response. */
9906 rs
->cached_wait_status
= 0;
9908 strcpy (buf
->data (), "timeout");
9911 timeout
= watchdog
> 0 ? watchdog
: -1;
9912 else if (expecting_notif
)
9913 timeout
= 0; /* There should already be a char in the buffer. If
9916 timeout
= remote_timeout
;
9920 /* Process any number of notifications, and then return when
9924 /* If we get a timeout or bad checksum, retry up to MAX_TRIES
9926 for (tries
= 1; tries
<= MAX_TRIES
; tries
++)
9928 /* This can loop forever if the remote side sends us
9929 characters continuously, but if it pauses, we'll get
9930 SERIAL_TIMEOUT from readchar because of timeout. Then
9931 we'll count that as a retry.
9933 Note that even when forever is set, we will only wait
9934 forever prior to the start of a packet. After that, we
9935 expect characters to arrive at a brisk pace. They should
9936 show up within remote_timeout intervals. */
9938 c
= readchar (timeout
);
9939 while (c
!= SERIAL_TIMEOUT
&& c
!= '$' && c
!= '%');
9941 if (c
== SERIAL_TIMEOUT
)
9943 if (expecting_notif
)
9944 return -1; /* Don't complain, it's normal to not get
9945 anything in this case. */
9947 if (forever
) /* Watchdog went off? Kill the target. */
9949 remote_unpush_target (this);
9950 throw_error (TARGET_CLOSE_ERROR
,
9951 _("Watchdog timeout has expired. "
9952 "Target detached."));
9955 remote_debug_printf ("Timed out.");
9959 /* We've found the start of a packet or notification.
9960 Now collect the data. */
9961 val
= read_frame (buf
);
9966 remote_serial_write ("-", 1);
9969 if (tries
> MAX_TRIES
)
9971 /* We have tried hard enough, and just can't receive the
9972 packet/notification. Give up. */
9973 printf_unfiltered (_("Ignoring packet error, continuing...\n"));
9975 /* Skip the ack char if we're in no-ack mode. */
9976 if (!rs
->noack_mode
)
9977 remote_serial_write ("+", 1);
9981 /* If we got an ordinary packet, return that to our caller. */
9988 if (remote_packet_max_chars
< 0)
9991 max_chars
= remote_packet_max_chars
;
9994 = escape_buffer (buf
->data (),
9995 std::min (val
, max_chars
));
9997 if (val
> max_chars
)
9998 remote_debug_printf_nofunc
9999 ("Packet received: %s [%d bytes omitted]", str
.c_str (),
10002 remote_debug_printf_nofunc ("Packet received: %s",
10006 /* Skip the ack char if we're in no-ack mode. */
10007 if (!rs
->noack_mode
)
10008 remote_serial_write ("+", 1);
10009 if (is_notif
!= NULL
)
10014 /* If we got a notification, handle it, and go back to looking
10018 gdb_assert (c
== '%');
10020 remote_debug_printf_nofunc
10021 (" Notification received: %s",
10022 escape_buffer (buf
->data (), val
).c_str ());
10024 if (is_notif
!= NULL
)
10027 handle_notification (rs
->notif_state
, buf
->data ());
10029 /* Notifications require no acknowledgement. */
10031 if (expecting_notif
)
10038 remote_target::getpkt_sane (gdb::char_vector
*buf
, int forever
)
10040 return getpkt_or_notif_sane_1 (buf
, forever
, 0, NULL
);
10044 remote_target::getpkt_or_notif_sane (gdb::char_vector
*buf
, int forever
,
10047 return getpkt_or_notif_sane_1 (buf
, forever
, 1, is_notif
);
10050 /* Kill any new fork children of process PID that haven't been
10051 processed by follow_fork. */
10054 remote_target::kill_new_fork_children (int pid
)
10056 remote_state
*rs
= get_remote_state ();
10057 struct notif_client
*notif
= ¬if_client_stop
;
10059 /* Kill the fork child threads of any threads in process PID
10060 that are stopped at a fork event. */
10061 for (thread_info
*thread
: all_non_exited_threads (this))
10063 struct target_waitstatus
*ws
= &thread
->pending_follow
;
10065 if (is_pending_fork_parent (ws
, pid
, thread
->ptid
))
10067 int child_pid
= ws
->value
.related_pid
.pid ();
10070 res
= remote_vkill (child_pid
);
10072 error (_("Can't kill fork child process %d"), child_pid
);
10076 /* Check for any pending fork events (not reported or processed yet)
10077 in process PID and kill those fork child threads as well. */
10078 remote_notif_get_pending_events (notif
);
10079 for (auto &event
: rs
->stop_reply_queue
)
10080 if (is_pending_fork_parent (&event
->ws
, pid
, event
->ptid
))
10082 int child_pid
= event
->ws
.value
.related_pid
.pid ();
10085 res
= remote_vkill (child_pid
);
10087 error (_("Can't kill fork child process %d"), child_pid
);
10092 /* Target hook to kill the current inferior. */
10095 remote_target::kill ()
10098 int pid
= inferior_ptid
.pid ();
10099 struct remote_state
*rs
= get_remote_state ();
10101 if (packet_support (PACKET_vKill
) != PACKET_DISABLE
)
10103 /* If we're stopped while forking and we haven't followed yet,
10104 kill the child task. We need to do this before killing the
10105 parent task because if this is a vfork then the parent will
10107 kill_new_fork_children (pid
);
10109 res
= remote_vkill (pid
);
10112 target_mourn_inferior (inferior_ptid
);
10117 /* If we are in 'target remote' mode and we are killing the only
10118 inferior, then we will tell gdbserver to exit and unpush the
10120 if (res
== -1 && !remote_multi_process_p (rs
)
10121 && number_of_live_inferiors (this) == 1)
10125 /* We've killed the remote end, we get to mourn it. If we are
10126 not in extended mode, mourning the inferior also unpushes
10127 remote_ops from the target stack, which closes the remote
10129 target_mourn_inferior (inferior_ptid
);
10134 error (_("Can't kill process"));
10137 /* Send a kill request to the target using the 'vKill' packet. */
10140 remote_target::remote_vkill (int pid
)
10142 if (packet_support (PACKET_vKill
) == PACKET_DISABLE
)
10145 remote_state
*rs
= get_remote_state ();
10147 /* Tell the remote target to detach. */
10148 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "vKill;%x", pid
);
10150 getpkt (&rs
->buf
, 0);
10152 switch (packet_ok (rs
->buf
,
10153 &remote_protocol_packets
[PACKET_vKill
]))
10159 case PACKET_UNKNOWN
:
10162 internal_error (__FILE__
, __LINE__
, _("Bad result from packet_ok"));
10166 /* Send a kill request to the target using the 'k' packet. */
10169 remote_target::remote_kill_k ()
10171 /* Catch errors so the user can quit from gdb even when we
10172 aren't on speaking terms with the remote system. */
10177 catch (const gdb_exception_error
&ex
)
10179 if (ex
.error
== TARGET_CLOSE_ERROR
)
10181 /* If we got an (EOF) error that caused the target
10182 to go away, then we're done, that's what we wanted.
10183 "k" is susceptible to cause a premature EOF, given
10184 that the remote server isn't actually required to
10185 reply to "k", and it can happen that it doesn't
10186 even get to reply ACK to the "k". */
10190 /* Otherwise, something went wrong. We didn't actually kill
10191 the target. Just propagate the exception, and let the
10192 user or higher layers decide what to do. */
10198 remote_target::mourn_inferior ()
10200 struct remote_state
*rs
= get_remote_state ();
10202 /* We're no longer interested in notification events of an inferior
10203 that exited or was killed/detached. */
10204 discard_pending_stop_replies (current_inferior ());
10206 /* In 'target remote' mode with one inferior, we close the connection. */
10207 if (!rs
->extended
&& number_of_live_inferiors (this) <= 1)
10209 remote_unpush_target (this);
10213 /* In case we got here due to an error, but we're going to stay
10215 rs
->waiting_for_stop_reply
= 0;
10217 /* If the current general thread belonged to the process we just
10218 detached from or has exited, the remote side current general
10219 thread becomes undefined. Considering a case like this:
10221 - We just got here due to a detach.
10222 - The process that we're detaching from happens to immediately
10223 report a global breakpoint being hit in non-stop mode, in the
10224 same thread we had selected before.
10225 - GDB attaches to this process again.
10226 - This event happens to be the next event we handle.
10228 GDB would consider that the current general thread didn't need to
10229 be set on the stub side (with Hg), since for all it knew,
10230 GENERAL_THREAD hadn't changed.
10232 Notice that although in all-stop mode, the remote server always
10233 sets the current thread to the thread reporting the stop event,
10234 that doesn't happen in non-stop mode; in non-stop, the stub *must
10235 not* change the current thread when reporting a breakpoint hit,
10236 due to the decoupling of event reporting and event handling.
10238 To keep things simple, we always invalidate our notion of the
10240 record_currthread (rs
, minus_one_ptid
);
10242 /* Call common code to mark the inferior as not running. */
10243 generic_mourn_inferior ();
10247 extended_remote_target::supports_disable_randomization ()
10249 return packet_support (PACKET_QDisableRandomization
) == PACKET_ENABLE
;
10253 remote_target::extended_remote_disable_randomization (int val
)
10255 struct remote_state
*rs
= get_remote_state ();
10258 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10259 "QDisableRandomization:%x", val
);
10261 reply
= remote_get_noisy_reply ();
10262 if (*reply
== '\0')
10263 error (_("Target does not support QDisableRandomization."));
10264 if (strcmp (reply
, "OK") != 0)
10265 error (_("Bogus QDisableRandomization reply from target: %s"), reply
);
10269 remote_target::extended_remote_run (const std::string
&args
)
10271 struct remote_state
*rs
= get_remote_state ();
10273 const char *remote_exec_file
= get_remote_exec_file ();
10275 /* If the user has disabled vRun support, or we have detected that
10276 support is not available, do not try it. */
10277 if (packet_support (PACKET_vRun
) == PACKET_DISABLE
)
10280 strcpy (rs
->buf
.data (), "vRun;");
10281 len
= strlen (rs
->buf
.data ());
10283 if (strlen (remote_exec_file
) * 2 + len
>= get_remote_packet_size ())
10284 error (_("Remote file name too long for run packet"));
10285 len
+= 2 * bin2hex ((gdb_byte
*) remote_exec_file
, rs
->buf
.data () + len
,
10286 strlen (remote_exec_file
));
10288 if (!args
.empty ())
10292 gdb_argv
argv (args
.c_str ());
10293 for (i
= 0; argv
[i
] != NULL
; i
++)
10295 if (strlen (argv
[i
]) * 2 + 1 + len
>= get_remote_packet_size ())
10296 error (_("Argument list too long for run packet"));
10297 rs
->buf
[len
++] = ';';
10298 len
+= 2 * bin2hex ((gdb_byte
*) argv
[i
], rs
->buf
.data () + len
,
10303 rs
->buf
[len
++] = '\0';
10306 getpkt (&rs
->buf
, 0);
10308 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_vRun
]))
10311 /* We have a wait response. All is well. */
10313 case PACKET_UNKNOWN
:
10316 if (remote_exec_file
[0] == '\0')
10317 error (_("Running the default executable on the remote target failed; "
10318 "try \"set remote exec-file\"?"));
10320 error (_("Running \"%s\" on the remote target failed"),
10323 gdb_assert_not_reached (_("bad switch"));
10327 /* Helper function to send set/unset environment packets. ACTION is
10328 either "set" or "unset". PACKET is either "QEnvironmentHexEncoded"
10329 or "QEnvironmentUnsetVariable". VALUE is the variable to be
10333 remote_target::send_environment_packet (const char *action
,
10334 const char *packet
,
10337 remote_state
*rs
= get_remote_state ();
10339 /* Convert the environment variable to an hex string, which
10340 is the best format to be transmitted over the wire. */
10341 std::string encoded_value
= bin2hex ((const gdb_byte
*) value
,
10344 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10345 "%s:%s", packet
, encoded_value
.c_str ());
10348 getpkt (&rs
->buf
, 0);
10349 if (strcmp (rs
->buf
.data (), "OK") != 0)
10350 warning (_("Unable to %s environment variable '%s' on remote."),
10354 /* Helper function to handle the QEnvironment* packets. */
10357 remote_target::extended_remote_environment_support ()
10359 remote_state
*rs
= get_remote_state ();
10361 if (packet_support (PACKET_QEnvironmentReset
) != PACKET_DISABLE
)
10363 putpkt ("QEnvironmentReset");
10364 getpkt (&rs
->buf
, 0);
10365 if (strcmp (rs
->buf
.data (), "OK") != 0)
10366 warning (_("Unable to reset environment on remote."));
10369 gdb_environ
*e
= ¤t_inferior ()->environment
;
10371 if (packet_support (PACKET_QEnvironmentHexEncoded
) != PACKET_DISABLE
)
10372 for (const std::string
&el
: e
->user_set_env ())
10373 send_environment_packet ("set", "QEnvironmentHexEncoded",
10376 if (packet_support (PACKET_QEnvironmentUnset
) != PACKET_DISABLE
)
10377 for (const std::string
&el
: e
->user_unset_env ())
10378 send_environment_packet ("unset", "QEnvironmentUnset", el
.c_str ());
10381 /* Helper function to set the current working directory for the
10382 inferior in the remote target. */
10385 remote_target::extended_remote_set_inferior_cwd ()
10387 if (packet_support (PACKET_QSetWorkingDir
) != PACKET_DISABLE
)
10389 const char *inferior_cwd
= get_inferior_cwd ();
10390 remote_state
*rs
= get_remote_state ();
10392 if (inferior_cwd
!= NULL
)
10394 std::string hexpath
= bin2hex ((const gdb_byte
*) inferior_cwd
,
10395 strlen (inferior_cwd
));
10397 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10398 "QSetWorkingDir:%s", hexpath
.c_str ());
10402 /* An empty inferior_cwd means that the user wants us to
10403 reset the remote server's inferior's cwd. */
10404 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10405 "QSetWorkingDir:");
10409 getpkt (&rs
->buf
, 0);
10410 if (packet_ok (rs
->buf
,
10411 &remote_protocol_packets
[PACKET_QSetWorkingDir
])
10414 Remote replied unexpectedly while setting the inferior's working\n\
10421 /* In the extended protocol we want to be able to do things like
10422 "run" and have them basically work as expected. So we need
10423 a special create_inferior function. We support changing the
10424 executable file and the command line arguments, but not the
10428 extended_remote_target::create_inferior (const char *exec_file
,
10429 const std::string
&args
,
10430 char **env
, int from_tty
)
10434 struct remote_state
*rs
= get_remote_state ();
10435 const char *remote_exec_file
= get_remote_exec_file ();
10437 /* If running asynchronously, register the target file descriptor
10438 with the event loop. */
10439 if (target_can_async_p ())
10442 /* Disable address space randomization if requested (and supported). */
10443 if (supports_disable_randomization ())
10444 extended_remote_disable_randomization (disable_randomization
);
10446 /* If startup-with-shell is on, we inform gdbserver to start the
10447 remote inferior using a shell. */
10448 if (packet_support (PACKET_QStartupWithShell
) != PACKET_DISABLE
)
10450 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
10451 "QStartupWithShell:%d", startup_with_shell
? 1 : 0);
10453 getpkt (&rs
->buf
, 0);
10454 if (strcmp (rs
->buf
.data (), "OK") != 0)
10456 Remote replied unexpectedly while setting startup-with-shell: %s"),
10460 extended_remote_environment_support ();
10462 extended_remote_set_inferior_cwd ();
10464 /* Now restart the remote server. */
10465 run_worked
= extended_remote_run (args
) != -1;
10468 /* vRun was not supported. Fail if we need it to do what the
10470 if (remote_exec_file
[0])
10471 error (_("Remote target does not support \"set remote exec-file\""));
10472 if (!args
.empty ())
10473 error (_("Remote target does not support \"set args\" or run ARGS"));
10475 /* Fall back to "R". */
10476 extended_remote_restart ();
10479 /* vRun's success return is a stop reply. */
10480 stop_reply
= run_worked
? rs
->buf
.data () : NULL
;
10481 add_current_inferior_and_thread (stop_reply
);
10483 /* Get updated offsets, if the stub uses qOffsets. */
10488 /* Given a location's target info BP_TGT and the packet buffer BUF, output
10489 the list of conditions (in agent expression bytecode format), if any, the
10490 target needs to evaluate. The output is placed into the packet buffer
10491 started from BUF and ended at BUF_END. */
10494 remote_add_target_side_condition (struct gdbarch
*gdbarch
,
10495 struct bp_target_info
*bp_tgt
, char *buf
,
10498 if (bp_tgt
->conditions
.empty ())
10501 buf
+= strlen (buf
);
10502 xsnprintf (buf
, buf_end
- buf
, "%s", ";");
10505 /* Send conditions to the target. */
10506 for (agent_expr
*aexpr
: bp_tgt
->conditions
)
10508 xsnprintf (buf
, buf_end
- buf
, "X%x,", aexpr
->len
);
10509 buf
+= strlen (buf
);
10510 for (int i
= 0; i
< aexpr
->len
; ++i
)
10511 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10518 remote_add_target_side_commands (struct gdbarch
*gdbarch
,
10519 struct bp_target_info
*bp_tgt
, char *buf
)
10521 if (bp_tgt
->tcommands
.empty ())
10524 buf
+= strlen (buf
);
10526 sprintf (buf
, ";cmds:%x,", bp_tgt
->persist
);
10527 buf
+= strlen (buf
);
10529 /* Concatenate all the agent expressions that are commands into the
10531 for (agent_expr
*aexpr
: bp_tgt
->tcommands
)
10533 sprintf (buf
, "X%x,", aexpr
->len
);
10534 buf
+= strlen (buf
);
10535 for (int i
= 0; i
< aexpr
->len
; ++i
)
10536 buf
= pack_hex_byte (buf
, aexpr
->buf
[i
]);
10541 /* Insert a breakpoint. On targets that have software breakpoint
10542 support, we ask the remote target to do the work; on targets
10543 which don't, we insert a traditional memory breakpoint. */
10546 remote_target::insert_breakpoint (struct gdbarch
*gdbarch
,
10547 struct bp_target_info
*bp_tgt
)
10549 /* Try the "Z" s/w breakpoint packet if it is not already disabled.
10550 If it succeeds, then set the support to PACKET_ENABLE. If it
10551 fails, and the user has explicitly requested the Z support then
10552 report an error, otherwise, mark it disabled and go on. */
10554 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10556 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10557 struct remote_state
*rs
;
10560 /* Make sure the remote is pointing at the right process, if
10562 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10563 set_general_process ();
10565 rs
= get_remote_state ();
10566 p
= rs
->buf
.data ();
10567 endbuf
= p
+ get_remote_packet_size ();
10572 addr
= (ULONGEST
) remote_address_masked (addr
);
10573 p
+= hexnumstr (p
, addr
);
10574 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10576 if (supports_evaluation_of_breakpoint_conditions ())
10577 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10579 if (can_run_breakpoint_commands ())
10580 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10583 getpkt (&rs
->buf
, 0);
10585 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
]))
10591 case PACKET_UNKNOWN
:
10596 /* If this breakpoint has target-side commands but this stub doesn't
10597 support Z0 packets, throw error. */
10598 if (!bp_tgt
->tcommands
.empty ())
10599 throw_error (NOT_SUPPORTED_ERROR
, _("\
10600 Target doesn't support breakpoints that have target side commands."));
10602 return memory_insert_breakpoint (this, gdbarch
, bp_tgt
);
10606 remote_target::remove_breakpoint (struct gdbarch
*gdbarch
,
10607 struct bp_target_info
*bp_tgt
,
10608 enum remove_bp_reason reason
)
10610 CORE_ADDR addr
= bp_tgt
->placed_address
;
10611 struct remote_state
*rs
= get_remote_state ();
10613 if (packet_support (PACKET_Z0
) != PACKET_DISABLE
)
10615 char *p
= rs
->buf
.data ();
10616 char *endbuf
= p
+ get_remote_packet_size ();
10618 /* Make sure the remote is pointing at the right process, if
10620 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10621 set_general_process ();
10627 addr
= (ULONGEST
) remote_address_masked (bp_tgt
->placed_address
);
10628 p
+= hexnumstr (p
, addr
);
10629 xsnprintf (p
, endbuf
- p
, ",%d", bp_tgt
->kind
);
10632 getpkt (&rs
->buf
, 0);
10634 return (rs
->buf
[0] == 'E');
10637 return memory_remove_breakpoint (this, gdbarch
, bp_tgt
, reason
);
10640 static enum Z_packet_type
10641 watchpoint_to_Z_packet (int type
)
10646 return Z_PACKET_WRITE_WP
;
10649 return Z_PACKET_READ_WP
;
10652 return Z_PACKET_ACCESS_WP
;
10655 internal_error (__FILE__
, __LINE__
,
10656 _("hw_bp_to_z: bad watchpoint type %d"), type
);
10661 remote_target::insert_watchpoint (CORE_ADDR addr
, int len
,
10662 enum target_hw_bp_type type
, struct expression
*cond
)
10664 struct remote_state
*rs
= get_remote_state ();
10665 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10667 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10669 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10672 /* Make sure the remote is pointing at the right process, if
10674 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10675 set_general_process ();
10677 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "Z%x,", packet
);
10678 p
= strchr (rs
->buf
.data (), '\0');
10679 addr
= remote_address_masked (addr
);
10680 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10681 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10684 getpkt (&rs
->buf
, 0);
10686 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10690 case PACKET_UNKNOWN
:
10695 internal_error (__FILE__
, __LINE__
,
10696 _("remote_insert_watchpoint: reached end of function"));
10700 remote_target::watchpoint_addr_within_range (CORE_ADDR addr
,
10701 CORE_ADDR start
, int length
)
10703 CORE_ADDR diff
= remote_address_masked (addr
- start
);
10705 return diff
< length
;
10710 remote_target::remove_watchpoint (CORE_ADDR addr
, int len
,
10711 enum target_hw_bp_type type
, struct expression
*cond
)
10713 struct remote_state
*rs
= get_remote_state ();
10714 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
10716 enum Z_packet_type packet
= watchpoint_to_Z_packet (type
);
10718 if (packet_support (PACKET_Z0
+ packet
) == PACKET_DISABLE
)
10721 /* Make sure the remote is pointing at the right process, if
10723 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10724 set_general_process ();
10726 xsnprintf (rs
->buf
.data (), endbuf
- rs
->buf
.data (), "z%x,", packet
);
10727 p
= strchr (rs
->buf
.data (), '\0');
10728 addr
= remote_address_masked (addr
);
10729 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10730 xsnprintf (p
, endbuf
- p
, ",%x", len
);
10732 getpkt (&rs
->buf
, 0);
10734 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z0
+ packet
]))
10737 case PACKET_UNKNOWN
:
10742 internal_error (__FILE__
, __LINE__
,
10743 _("remote_remove_watchpoint: reached end of function"));
10747 static int remote_hw_watchpoint_limit
= -1;
10748 static int remote_hw_watchpoint_length_limit
= -1;
10749 static int remote_hw_breakpoint_limit
= -1;
10752 remote_target::region_ok_for_hw_watchpoint (CORE_ADDR addr
, int len
)
10754 if (remote_hw_watchpoint_length_limit
== 0)
10756 else if (remote_hw_watchpoint_length_limit
< 0)
10758 else if (len
<= remote_hw_watchpoint_length_limit
)
10765 remote_target::can_use_hw_breakpoint (enum bptype type
, int cnt
, int ot
)
10767 if (type
== bp_hardware_breakpoint
)
10769 if (remote_hw_breakpoint_limit
== 0)
10771 else if (remote_hw_breakpoint_limit
< 0)
10773 else if (cnt
<= remote_hw_breakpoint_limit
)
10778 if (remote_hw_watchpoint_limit
== 0)
10780 else if (remote_hw_watchpoint_limit
< 0)
10784 else if (cnt
<= remote_hw_watchpoint_limit
)
10790 /* The to_stopped_by_sw_breakpoint method of target remote. */
10793 remote_target::stopped_by_sw_breakpoint ()
10795 struct thread_info
*thread
= inferior_thread ();
10797 return (thread
->priv
!= NULL
10798 && (get_remote_thread_info (thread
)->stop_reason
10799 == TARGET_STOPPED_BY_SW_BREAKPOINT
));
10802 /* The to_supports_stopped_by_sw_breakpoint method of target
10806 remote_target::supports_stopped_by_sw_breakpoint ()
10808 return (packet_support (PACKET_swbreak_feature
) == PACKET_ENABLE
);
10811 /* The to_stopped_by_hw_breakpoint method of target remote. */
10814 remote_target::stopped_by_hw_breakpoint ()
10816 struct thread_info
*thread
= inferior_thread ();
10818 return (thread
->priv
!= NULL
10819 && (get_remote_thread_info (thread
)->stop_reason
10820 == TARGET_STOPPED_BY_HW_BREAKPOINT
));
10823 /* The to_supports_stopped_by_hw_breakpoint method of target
10827 remote_target::supports_stopped_by_hw_breakpoint ()
10829 return (packet_support (PACKET_hwbreak_feature
) == PACKET_ENABLE
);
10833 remote_target::stopped_by_watchpoint ()
10835 struct thread_info
*thread
= inferior_thread ();
10837 return (thread
->priv
!= NULL
10838 && (get_remote_thread_info (thread
)->stop_reason
10839 == TARGET_STOPPED_BY_WATCHPOINT
));
10843 remote_target::stopped_data_address (CORE_ADDR
*addr_p
)
10845 struct thread_info
*thread
= inferior_thread ();
10847 if (thread
->priv
!= NULL
10848 && (get_remote_thread_info (thread
)->stop_reason
10849 == TARGET_STOPPED_BY_WATCHPOINT
))
10851 *addr_p
= get_remote_thread_info (thread
)->watch_data_address
;
10860 remote_target::insert_hw_breakpoint (struct gdbarch
*gdbarch
,
10861 struct bp_target_info
*bp_tgt
)
10863 CORE_ADDR addr
= bp_tgt
->reqstd_address
;
10864 struct remote_state
*rs
;
10868 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10871 /* Make sure the remote is pointing at the right process, if
10873 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10874 set_general_process ();
10876 rs
= get_remote_state ();
10877 p
= rs
->buf
.data ();
10878 endbuf
= p
+ get_remote_packet_size ();
10884 addr
= remote_address_masked (addr
);
10885 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10886 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10888 if (supports_evaluation_of_breakpoint_conditions ())
10889 remote_add_target_side_condition (gdbarch
, bp_tgt
, p
, endbuf
);
10891 if (can_run_breakpoint_commands ())
10892 remote_add_target_side_commands (gdbarch
, bp_tgt
, p
);
10895 getpkt (&rs
->buf
, 0);
10897 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10900 if (rs
->buf
[1] == '.')
10902 message
= strchr (&rs
->buf
[2], '.');
10904 error (_("Remote failure reply: %s"), message
+ 1);
10907 case PACKET_UNKNOWN
:
10912 internal_error (__FILE__
, __LINE__
,
10913 _("remote_insert_hw_breakpoint: reached end of function"));
10918 remote_target::remove_hw_breakpoint (struct gdbarch
*gdbarch
,
10919 struct bp_target_info
*bp_tgt
)
10922 struct remote_state
*rs
= get_remote_state ();
10923 char *p
= rs
->buf
.data ();
10924 char *endbuf
= p
+ get_remote_packet_size ();
10926 if (packet_support (PACKET_Z1
) == PACKET_DISABLE
)
10929 /* Make sure the remote is pointing at the right process, if
10931 if (!gdbarch_has_global_breakpoints (target_gdbarch ()))
10932 set_general_process ();
10938 addr
= remote_address_masked (bp_tgt
->placed_address
);
10939 p
+= hexnumstr (p
, (ULONGEST
) addr
);
10940 xsnprintf (p
, endbuf
- p
, ",%x", bp_tgt
->kind
);
10943 getpkt (&rs
->buf
, 0);
10945 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[PACKET_Z1
]))
10948 case PACKET_UNKNOWN
:
10953 internal_error (__FILE__
, __LINE__
,
10954 _("remote_remove_hw_breakpoint: reached end of function"));
10957 /* Verify memory using the "qCRC:" request. */
10960 remote_target::verify_memory (const gdb_byte
*data
, CORE_ADDR lma
, ULONGEST size
)
10962 struct remote_state
*rs
= get_remote_state ();
10963 unsigned long host_crc
, target_crc
;
10966 /* It doesn't make sense to use qCRC if the remote target is
10967 connected but not running. */
10968 if (target_has_execution ()
10969 && packet_support (PACKET_qCRC
) != PACKET_DISABLE
)
10971 enum packet_result result
;
10973 /* Make sure the remote is pointing at the right process. */
10974 set_general_process ();
10976 /* FIXME: assumes lma can fit into long. */
10977 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qCRC:%lx,%lx",
10978 (long) lma
, (long) size
);
10981 /* Be clever; compute the host_crc before waiting for target
10983 host_crc
= xcrc32 (data
, size
, 0xffffffff);
10985 getpkt (&rs
->buf
, 0);
10987 result
= packet_ok (rs
->buf
,
10988 &remote_protocol_packets
[PACKET_qCRC
]);
10989 if (result
== PACKET_ERROR
)
10991 else if (result
== PACKET_OK
)
10993 for (target_crc
= 0, tmp
= &rs
->buf
[1]; *tmp
; tmp
++)
10994 target_crc
= target_crc
* 16 + fromhex (*tmp
);
10996 return (host_crc
== target_crc
);
11000 return simple_verify_memory (this, data
, lma
, size
);
11003 /* compare-sections command
11005 With no arguments, compares each loadable section in the exec bfd
11006 with the same memory range on the target, and reports mismatches.
11007 Useful for verifying the image on the target against the exec file. */
11010 compare_sections_command (const char *args
, int from_tty
)
11013 const char *sectname
;
11014 bfd_size_type size
;
11017 int mismatched
= 0;
11021 if (!current_program_space
->exec_bfd ())
11022 error (_("command cannot be used without an exec file"));
11024 if (args
!= NULL
&& strcmp (args
, "-r") == 0)
11030 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
11032 if (!(s
->flags
& SEC_LOAD
))
11033 continue; /* Skip non-loadable section. */
11035 if (read_only
&& (s
->flags
& SEC_READONLY
) == 0)
11036 continue; /* Skip writeable sections */
11038 size
= bfd_section_size (s
);
11040 continue; /* Skip zero-length section. */
11042 sectname
= bfd_section_name (s
);
11043 if (args
&& strcmp (args
, sectname
) != 0)
11044 continue; /* Not the section selected by user. */
11046 matched
= 1; /* Do this section. */
11049 gdb::byte_vector
sectdata (size
);
11050 bfd_get_section_contents (current_program_space
->exec_bfd (), s
,
11051 sectdata
.data (), 0, size
);
11053 res
= target_verify_memory (sectdata
.data (), lma
, size
);
11056 error (_("target memory fault, section %s, range %s -- %s"), sectname
,
11057 paddress (target_gdbarch (), lma
),
11058 paddress (target_gdbarch (), lma
+ size
));
11060 printf_filtered ("Section %s, range %s -- %s: ", sectname
,
11061 paddress (target_gdbarch (), lma
),
11062 paddress (target_gdbarch (), lma
+ size
));
11064 printf_filtered ("matched.\n");
11067 printf_filtered ("MIS-MATCHED!\n");
11071 if (mismatched
> 0)
11072 warning (_("One or more sections of the target image does not match\n\
11073 the loaded file\n"));
11074 if (args
&& !matched
)
11075 printf_filtered (_("No loaded section named '%s'.\n"), args
);
11078 /* Write LEN bytes from WRITEBUF into OBJECT_NAME/ANNEX at OFFSET
11079 into remote target. The number of bytes written to the remote
11080 target is returned, or -1 for error. */
11083 remote_target::remote_write_qxfer (const char *object_name
,
11084 const char *annex
, const gdb_byte
*writebuf
,
11085 ULONGEST offset
, LONGEST len
,
11086 ULONGEST
*xfered_len
,
11087 struct packet_config
*packet
)
11091 struct remote_state
*rs
= get_remote_state ();
11092 int max_size
= get_memory_write_packet_size ();
11094 if (packet_config_support (packet
) == PACKET_DISABLE
)
11095 return TARGET_XFER_E_IO
;
11097 /* Insert header. */
11098 i
= snprintf (rs
->buf
.data (), max_size
,
11099 "qXfer:%s:write:%s:%s:",
11100 object_name
, annex
? annex
: "",
11101 phex_nz (offset
, sizeof offset
));
11102 max_size
-= (i
+ 1);
11104 /* Escape as much data as fits into rs->buf. */
11105 buf_len
= remote_escape_output
11106 (writebuf
, len
, 1, (gdb_byte
*) rs
->buf
.data () + i
, &max_size
, max_size
);
11108 if (putpkt_binary (rs
->buf
.data (), i
+ buf_len
) < 0
11109 || getpkt_sane (&rs
->buf
, 0) < 0
11110 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11111 return TARGET_XFER_E_IO
;
11113 unpack_varlen_hex (rs
->buf
.data (), &n
);
11116 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11119 /* Read OBJECT_NAME/ANNEX from the remote target using a qXfer packet.
11120 Data at OFFSET, of up to LEN bytes, is read into READBUF; the
11121 number of bytes read is returned, or 0 for EOF, or -1 for error.
11122 The number of bytes read may be less than LEN without indicating an
11123 EOF. PACKET is checked and updated to indicate whether the remote
11124 target supports this object. */
11127 remote_target::remote_read_qxfer (const char *object_name
,
11129 gdb_byte
*readbuf
, ULONGEST offset
,
11131 ULONGEST
*xfered_len
,
11132 struct packet_config
*packet
)
11134 struct remote_state
*rs
= get_remote_state ();
11135 LONGEST i
, n
, packet_len
;
11137 if (packet_config_support (packet
) == PACKET_DISABLE
)
11138 return TARGET_XFER_E_IO
;
11140 /* Check whether we've cached an end-of-object packet that matches
11142 if (rs
->finished_object
)
11144 if (strcmp (object_name
, rs
->finished_object
) == 0
11145 && strcmp (annex
? annex
: "", rs
->finished_annex
) == 0
11146 && offset
== rs
->finished_offset
)
11147 return TARGET_XFER_EOF
;
11150 /* Otherwise, we're now reading something different. Discard
11152 xfree (rs
->finished_object
);
11153 xfree (rs
->finished_annex
);
11154 rs
->finished_object
= NULL
;
11155 rs
->finished_annex
= NULL
;
11158 /* Request only enough to fit in a single packet. The actual data
11159 may not, since we don't know how much of it will need to be escaped;
11160 the target is free to respond with slightly less data. We subtract
11161 five to account for the response type and the protocol frame. */
11162 n
= std::min
<LONGEST
> (get_remote_packet_size () - 5, len
);
11163 snprintf (rs
->buf
.data (), get_remote_packet_size () - 4,
11164 "qXfer:%s:read:%s:%s,%s",
11165 object_name
, annex
? annex
: "",
11166 phex_nz (offset
, sizeof offset
),
11167 phex_nz (n
, sizeof n
));
11168 i
= putpkt (rs
->buf
);
11170 return TARGET_XFER_E_IO
;
11173 packet_len
= getpkt_sane (&rs
->buf
, 0);
11174 if (packet_len
< 0 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11175 return TARGET_XFER_E_IO
;
11177 if (rs
->buf
[0] != 'l' && rs
->buf
[0] != 'm')
11178 error (_("Unknown remote qXfer reply: %s"), rs
->buf
.data ());
11180 /* 'm' means there is (or at least might be) more data after this
11181 batch. That does not make sense unless there's at least one byte
11182 of data in this reply. */
11183 if (rs
->buf
[0] == 'm' && packet_len
== 1)
11184 error (_("Remote qXfer reply contained no data."));
11186 /* Got some data. */
11187 i
= remote_unescape_input ((gdb_byte
*) rs
->buf
.data () + 1,
11188 packet_len
- 1, readbuf
, n
);
11190 /* 'l' is an EOF marker, possibly including a final block of data,
11191 or possibly empty. If we have the final block of a non-empty
11192 object, record this fact to bypass a subsequent partial read. */
11193 if (rs
->buf
[0] == 'l' && offset
+ i
> 0)
11195 rs
->finished_object
= xstrdup (object_name
);
11196 rs
->finished_annex
= xstrdup (annex
? annex
: "");
11197 rs
->finished_offset
= offset
+ i
;
11201 return TARGET_XFER_EOF
;
11205 return TARGET_XFER_OK
;
11209 enum target_xfer_status
11210 remote_target::xfer_partial (enum target_object object
,
11211 const char *annex
, gdb_byte
*readbuf
,
11212 const gdb_byte
*writebuf
, ULONGEST offset
, ULONGEST len
,
11213 ULONGEST
*xfered_len
)
11215 struct remote_state
*rs
;
11219 int unit_size
= gdbarch_addressable_memory_unit_size (target_gdbarch ());
11221 set_remote_traceframe ();
11222 set_general_thread (inferior_ptid
);
11224 rs
= get_remote_state ();
11226 /* Handle memory using the standard memory routines. */
11227 if (object
== TARGET_OBJECT_MEMORY
)
11229 /* If the remote target is connected but not running, we should
11230 pass this request down to a lower stratum (e.g. the executable
11232 if (!target_has_execution ())
11233 return TARGET_XFER_EOF
;
11235 if (writebuf
!= NULL
)
11236 return remote_write_bytes (offset
, writebuf
, len
, unit_size
,
11239 return remote_read_bytes (offset
, readbuf
, len
, unit_size
,
11243 /* Handle extra signal info using qxfer packets. */
11244 if (object
== TARGET_OBJECT_SIGNAL_INFO
)
11247 return remote_read_qxfer ("siginfo", annex
, readbuf
, offset
, len
,
11248 xfered_len
, &remote_protocol_packets
11249 [PACKET_qXfer_siginfo_read
]);
11251 return remote_write_qxfer ("siginfo", annex
,
11252 writebuf
, offset
, len
, xfered_len
,
11253 &remote_protocol_packets
11254 [PACKET_qXfer_siginfo_write
]);
11257 if (object
== TARGET_OBJECT_STATIC_TRACE_DATA
)
11260 return remote_read_qxfer ("statictrace", annex
,
11261 readbuf
, offset
, len
, xfered_len
,
11262 &remote_protocol_packets
11263 [PACKET_qXfer_statictrace_read
]);
11265 return TARGET_XFER_E_IO
;
11268 /* Only handle flash writes. */
11269 if (writebuf
!= NULL
)
11273 case TARGET_OBJECT_FLASH
:
11274 return remote_flash_write (offset
, len
, xfered_len
,
11278 return TARGET_XFER_E_IO
;
11282 /* Map pre-existing objects onto letters. DO NOT do this for new
11283 objects!!! Instead specify new query packets. */
11286 case TARGET_OBJECT_AVR
:
11290 case TARGET_OBJECT_AUXV
:
11291 gdb_assert (annex
== NULL
);
11292 return remote_read_qxfer ("auxv", annex
, readbuf
, offset
, len
,
11294 &remote_protocol_packets
[PACKET_qXfer_auxv
]);
11296 case TARGET_OBJECT_AVAILABLE_FEATURES
:
11297 return remote_read_qxfer
11298 ("features", annex
, readbuf
, offset
, len
, xfered_len
,
11299 &remote_protocol_packets
[PACKET_qXfer_features
]);
11301 case TARGET_OBJECT_LIBRARIES
:
11302 return remote_read_qxfer
11303 ("libraries", annex
, readbuf
, offset
, len
, xfered_len
,
11304 &remote_protocol_packets
[PACKET_qXfer_libraries
]);
11306 case TARGET_OBJECT_LIBRARIES_SVR4
:
11307 return remote_read_qxfer
11308 ("libraries-svr4", annex
, readbuf
, offset
, len
, xfered_len
,
11309 &remote_protocol_packets
[PACKET_qXfer_libraries_svr4
]);
11311 case TARGET_OBJECT_MEMORY_MAP
:
11312 gdb_assert (annex
== NULL
);
11313 return remote_read_qxfer ("memory-map", annex
, readbuf
, offset
, len
,
11315 &remote_protocol_packets
[PACKET_qXfer_memory_map
]);
11317 case TARGET_OBJECT_OSDATA
:
11318 /* Should only get here if we're connected. */
11319 gdb_assert (rs
->remote_desc
);
11320 return remote_read_qxfer
11321 ("osdata", annex
, readbuf
, offset
, len
, xfered_len
,
11322 &remote_protocol_packets
[PACKET_qXfer_osdata
]);
11324 case TARGET_OBJECT_THREADS
:
11325 gdb_assert (annex
== NULL
);
11326 return remote_read_qxfer ("threads", annex
, readbuf
, offset
, len
,
11328 &remote_protocol_packets
[PACKET_qXfer_threads
]);
11330 case TARGET_OBJECT_TRACEFRAME_INFO
:
11331 gdb_assert (annex
== NULL
);
11332 return remote_read_qxfer
11333 ("traceframe-info", annex
, readbuf
, offset
, len
, xfered_len
,
11334 &remote_protocol_packets
[PACKET_qXfer_traceframe_info
]);
11336 case TARGET_OBJECT_FDPIC
:
11337 return remote_read_qxfer ("fdpic", annex
, readbuf
, offset
, len
,
11339 &remote_protocol_packets
[PACKET_qXfer_fdpic
]);
11341 case TARGET_OBJECT_OPENVMS_UIB
:
11342 return remote_read_qxfer ("uib", annex
, readbuf
, offset
, len
,
11344 &remote_protocol_packets
[PACKET_qXfer_uib
]);
11346 case TARGET_OBJECT_BTRACE
:
11347 return remote_read_qxfer ("btrace", annex
, readbuf
, offset
, len
,
11349 &remote_protocol_packets
[PACKET_qXfer_btrace
]);
11351 case TARGET_OBJECT_BTRACE_CONF
:
11352 return remote_read_qxfer ("btrace-conf", annex
, readbuf
, offset
,
11354 &remote_protocol_packets
[PACKET_qXfer_btrace_conf
]);
11356 case TARGET_OBJECT_EXEC_FILE
:
11357 return remote_read_qxfer ("exec-file", annex
, readbuf
, offset
,
11359 &remote_protocol_packets
[PACKET_qXfer_exec_file
]);
11362 return TARGET_XFER_E_IO
;
11365 /* Minimum outbuf size is get_remote_packet_size (). If LEN is not
11366 large enough let the caller deal with it. */
11367 if (len
< get_remote_packet_size ())
11368 return TARGET_XFER_E_IO
;
11369 len
= get_remote_packet_size ();
11371 /* Except for querying the minimum buffer size, target must be open. */
11372 if (!rs
->remote_desc
)
11373 error (_("remote query is only available after target open"));
11375 gdb_assert (annex
!= NULL
);
11376 gdb_assert (readbuf
!= NULL
);
11378 p2
= rs
->buf
.data ();
11380 *p2
++ = query_type
;
11382 /* We used one buffer char for the remote protocol q command and
11383 another for the query type. As the remote protocol encapsulation
11384 uses 4 chars plus one extra in case we are debugging
11385 (remote_debug), we have PBUFZIZ - 7 left to pack the query
11388 while (annex
[i
] && (i
< (get_remote_packet_size () - 8)))
11390 /* Bad caller may have sent forbidden characters. */
11391 gdb_assert (isprint (annex
[i
]) && annex
[i
] != '$' && annex
[i
] != '#');
11396 gdb_assert (annex
[i
] == '\0');
11398 i
= putpkt (rs
->buf
);
11400 return TARGET_XFER_E_IO
;
11402 getpkt (&rs
->buf
, 0);
11403 strcpy ((char *) readbuf
, rs
->buf
.data ());
11405 *xfered_len
= strlen ((char *) readbuf
);
11406 return (*xfered_len
!= 0) ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
11409 /* Implementation of to_get_memory_xfer_limit. */
11412 remote_target::get_memory_xfer_limit ()
11414 return get_memory_write_packet_size ();
11418 remote_target::search_memory (CORE_ADDR start_addr
, ULONGEST search_space_len
,
11419 const gdb_byte
*pattern
, ULONGEST pattern_len
,
11420 CORE_ADDR
*found_addrp
)
11422 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
11423 struct remote_state
*rs
= get_remote_state ();
11424 int max_size
= get_memory_write_packet_size ();
11425 struct packet_config
*packet
=
11426 &remote_protocol_packets
[PACKET_qSearch_memory
];
11427 /* Number of packet bytes used to encode the pattern;
11428 this could be more than PATTERN_LEN due to escape characters. */
11429 int escaped_pattern_len
;
11430 /* Amount of pattern that was encodable in the packet. */
11431 int used_pattern_len
;
11434 ULONGEST found_addr
;
11436 auto read_memory
= [=] (CORE_ADDR addr
, gdb_byte
*result
, size_t len
)
11438 return (target_read (this, TARGET_OBJECT_MEMORY
, NULL
, result
, addr
, len
)
11442 /* Don't go to the target if we don't have to. This is done before
11443 checking packet_config_support to avoid the possibility that a
11444 success for this edge case means the facility works in
11446 if (pattern_len
> search_space_len
)
11448 if (pattern_len
== 0)
11450 *found_addrp
= start_addr
;
11454 /* If we already know the packet isn't supported, fall back to the simple
11455 way of searching memory. */
11457 if (packet_config_support (packet
) == PACKET_DISABLE
)
11459 /* Target doesn't provided special support, fall back and use the
11460 standard support (copy memory and do the search here). */
11461 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11462 pattern
, pattern_len
, found_addrp
);
11465 /* Make sure the remote is pointing at the right process. */
11466 set_general_process ();
11468 /* Insert header. */
11469 i
= snprintf (rs
->buf
.data (), max_size
,
11470 "qSearch:memory:%s;%s;",
11471 phex_nz (start_addr
, addr_size
),
11472 phex_nz (search_space_len
, sizeof (search_space_len
)));
11473 max_size
-= (i
+ 1);
11475 /* Escape as much data as fits into rs->buf. */
11476 escaped_pattern_len
=
11477 remote_escape_output (pattern
, pattern_len
, 1,
11478 (gdb_byte
*) rs
->buf
.data () + i
,
11479 &used_pattern_len
, max_size
);
11481 /* Bail if the pattern is too large. */
11482 if (used_pattern_len
!= pattern_len
)
11483 error (_("Pattern is too large to transmit to remote target."));
11485 if (putpkt_binary (rs
->buf
.data (), i
+ escaped_pattern_len
) < 0
11486 || getpkt_sane (&rs
->buf
, 0) < 0
11487 || packet_ok (rs
->buf
, packet
) != PACKET_OK
)
11489 /* The request may not have worked because the command is not
11490 supported. If so, fall back to the simple way. */
11491 if (packet_config_support (packet
) == PACKET_DISABLE
)
11493 return simple_search_memory (read_memory
, start_addr
, search_space_len
,
11494 pattern
, pattern_len
, found_addrp
);
11499 if (rs
->buf
[0] == '0')
11501 else if (rs
->buf
[0] == '1')
11504 if (rs
->buf
[1] != ',')
11505 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11506 unpack_varlen_hex (&rs
->buf
[2], &found_addr
);
11507 *found_addrp
= found_addr
;
11510 error (_("Unknown qSearch:memory reply: %s"), rs
->buf
.data ());
11516 remote_target::rcmd (const char *command
, struct ui_file
*outbuf
)
11518 struct remote_state
*rs
= get_remote_state ();
11519 char *p
= rs
->buf
.data ();
11521 if (!rs
->remote_desc
)
11522 error (_("remote rcmd is only available after target open"));
11524 /* Send a NULL command across as an empty command. */
11525 if (command
== NULL
)
11528 /* The query prefix. */
11529 strcpy (rs
->buf
.data (), "qRcmd,");
11530 p
= strchr (rs
->buf
.data (), '\0');
11532 if ((strlen (rs
->buf
.data ()) + strlen (command
) * 2 + 8/*misc*/)
11533 > get_remote_packet_size ())
11534 error (_("\"monitor\" command ``%s'' is too long."), command
);
11536 /* Encode the actual command. */
11537 bin2hex ((const gdb_byte
*) command
, p
, strlen (command
));
11539 if (putpkt (rs
->buf
) < 0)
11540 error (_("Communication problem with target."));
11542 /* get/display the response */
11547 /* XXX - see also remote_get_noisy_reply(). */
11548 QUIT
; /* Allow user to bail out with ^C. */
11550 if (getpkt_sane (&rs
->buf
, 0) == -1)
11552 /* Timeout. Continue to (try to) read responses.
11553 This is better than stopping with an error, assuming the stub
11554 is still executing the (long) monitor command.
11555 If needed, the user can interrupt gdb using C-c, obtaining
11556 an effect similar to stop on timeout. */
11559 buf
= rs
->buf
.data ();
11560 if (buf
[0] == '\0')
11561 error (_("Target does not support this command."));
11562 if (buf
[0] == 'O' && buf
[1] != 'K')
11564 remote_console_output (buf
+ 1); /* 'O' message from stub. */
11567 if (strcmp (buf
, "OK") == 0)
11569 if (strlen (buf
) == 3 && buf
[0] == 'E'
11570 && isdigit (buf
[1]) && isdigit (buf
[2]))
11572 error (_("Protocol error with Rcmd"));
11574 for (p
= buf
; p
[0] != '\0' && p
[1] != '\0'; p
+= 2)
11576 char c
= (fromhex (p
[0]) << 4) + fromhex (p
[1]);
11578 fputc_unfiltered (c
, outbuf
);
11584 std::vector
<mem_region
>
11585 remote_target::memory_map ()
11587 std::vector
<mem_region
> result
;
11588 gdb::optional
<gdb::char_vector
> text
11589 = target_read_stralloc (current_inferior ()->top_target (),
11590 TARGET_OBJECT_MEMORY_MAP
, NULL
);
11593 result
= parse_memory_map (text
->data ());
11599 packet_command (const char *args
, int from_tty
)
11601 remote_target
*remote
= get_current_remote_target ();
11603 if (remote
== nullptr)
11604 error (_("command can only be used with remote target"));
11606 remote
->packet_command (args
, from_tty
);
11610 remote_target::packet_command (const char *args
, int from_tty
)
11613 error (_("remote-packet command requires packet text as argument"));
11615 puts_filtered ("sending: ");
11616 print_packet (args
);
11617 puts_filtered ("\n");
11620 remote_state
*rs
= get_remote_state ();
11622 getpkt (&rs
->buf
, 0);
11623 puts_filtered ("received: ");
11624 print_packet (rs
->buf
.data ());
11625 puts_filtered ("\n");
11629 /* --------- UNIT_TEST for THREAD oriented PACKETS ------------------- */
11631 static void display_thread_info (struct gdb_ext_thread_info
*info
);
11633 static void threadset_test_cmd (char *cmd
, int tty
);
11635 static void threadalive_test (char *cmd
, int tty
);
11637 static void threadlist_test_cmd (char *cmd
, int tty
);
11639 int get_and_display_threadinfo (threadref
*ref
);
11641 static void threadinfo_test_cmd (char *cmd
, int tty
);
11643 static int thread_display_step (threadref
*ref
, void *context
);
11645 static void threadlist_update_test_cmd (char *cmd
, int tty
);
11647 static void init_remote_threadtests (void);
11649 #define SAMPLE_THREAD 0x05060708 /* Truncated 64 bit threadid. */
11652 threadset_test_cmd (const char *cmd
, int tty
)
11654 int sample_thread
= SAMPLE_THREAD
;
11656 printf_filtered (_("Remote threadset test\n"));
11657 set_general_thread (sample_thread
);
11662 threadalive_test (const char *cmd
, int tty
)
11664 int sample_thread
= SAMPLE_THREAD
;
11665 int pid
= inferior_ptid
.pid ();
11666 ptid_t ptid
= ptid_t (pid
, sample_thread
, 0);
11668 if (remote_thread_alive (ptid
))
11669 printf_filtered ("PASS: Thread alive test\n");
11671 printf_filtered ("FAIL: Thread alive test\n");
11674 void output_threadid (char *title
, threadref
*ref
);
11677 output_threadid (char *title
, threadref
*ref
)
11681 pack_threadid (&hexid
[0], ref
); /* Convert thread id into hex. */
11683 printf_filtered ("%s %s\n", title
, (&hexid
[0]));
11687 threadlist_test_cmd (const char *cmd
, int tty
)
11690 threadref nextthread
;
11691 int done
, result_count
;
11692 threadref threadlist
[3];
11694 printf_filtered ("Remote Threadlist test\n");
11695 if (!remote_get_threadlist (startflag
, &nextthread
, 3, &done
,
11696 &result_count
, &threadlist
[0]))
11697 printf_filtered ("FAIL: threadlist test\n");
11700 threadref
*scan
= threadlist
;
11701 threadref
*limit
= scan
+ result_count
;
11703 while (scan
< limit
)
11704 output_threadid (" thread ", scan
++);
11709 display_thread_info (struct gdb_ext_thread_info
*info
)
11711 output_threadid ("Threadid: ", &info
->threadid
);
11712 printf_filtered ("Name: %s\n ", info
->shortname
);
11713 printf_filtered ("State: %s\n", info
->display
);
11714 printf_filtered ("other: %s\n\n", info
->more_display
);
11718 get_and_display_threadinfo (threadref
*ref
)
11722 struct gdb_ext_thread_info threadinfo
;
11724 set
= TAG_THREADID
| TAG_EXISTS
| TAG_THREADNAME
11725 | TAG_MOREDISPLAY
| TAG_DISPLAY
;
11726 if (0 != (result
= remote_get_threadinfo (ref
, set
, &threadinfo
)))
11727 display_thread_info (&threadinfo
);
11732 threadinfo_test_cmd (const char *cmd
, int tty
)
11734 int athread
= SAMPLE_THREAD
;
11738 int_to_threadref (&thread
, athread
);
11739 printf_filtered ("Remote Threadinfo test\n");
11740 if (!get_and_display_threadinfo (&thread
))
11741 printf_filtered ("FAIL cannot get thread info\n");
11745 thread_display_step (threadref
*ref
, void *context
)
11747 /* output_threadid(" threadstep ",ref); *//* simple test */
11748 return get_and_display_threadinfo (ref
);
11752 threadlist_update_test_cmd (const char *cmd
, int tty
)
11754 printf_filtered ("Remote Threadlist update test\n");
11755 remote_threadlist_iterator (thread_display_step
, 0, CRAZY_MAX_THREADS
);
11759 init_remote_threadtests (void)
11761 add_com ("tlist", class_obscure
, threadlist_test_cmd
,
11762 _("Fetch and print the remote list of "
11763 "thread identifiers, one pkt only."));
11764 add_com ("tinfo", class_obscure
, threadinfo_test_cmd
,
11765 _("Fetch and display info about one thread."));
11766 add_com ("tset", class_obscure
, threadset_test_cmd
,
11767 _("Test setting to a different thread."));
11768 add_com ("tupd", class_obscure
, threadlist_update_test_cmd
,
11769 _("Iterate through updating all remote thread info."));
11770 add_com ("talive", class_obscure
, threadalive_test
,
11771 _("Remote thread alive test."));
11776 /* Convert a thread ID to a string. */
11779 remote_target::pid_to_str (ptid_t ptid
)
11781 struct remote_state
*rs
= get_remote_state ();
11783 if (ptid
== null_ptid
)
11784 return normal_pid_to_str (ptid
);
11785 else if (ptid
.is_pid ())
11787 /* Printing an inferior target id. */
11789 /* When multi-process extensions are off, there's no way in the
11790 remote protocol to know the remote process id, if there's any
11791 at all. There's one exception --- when we're connected with
11792 target extended-remote, and we manually attached to a process
11793 with "attach PID". We don't record anywhere a flag that
11794 allows us to distinguish that case from the case of
11795 connecting with extended-remote and the stub already being
11796 attached to a process, and reporting yes to qAttached, hence
11797 no smart special casing here. */
11798 if (!remote_multi_process_p (rs
))
11799 return "Remote target";
11801 return normal_pid_to_str (ptid
);
11805 if (magic_null_ptid
== ptid
)
11806 return "Thread <main>";
11807 else if (remote_multi_process_p (rs
))
11808 if (ptid
.lwp () == 0)
11809 return normal_pid_to_str (ptid
);
11811 return string_printf ("Thread %d.%ld",
11812 ptid
.pid (), ptid
.lwp ());
11814 return string_printf ("Thread %ld", ptid
.lwp ());
11818 /* Get the address of the thread local variable in OBJFILE which is
11819 stored at OFFSET within the thread local storage for thread PTID. */
11822 remote_target::get_thread_local_address (ptid_t ptid
, CORE_ADDR lm
,
11825 if (packet_support (PACKET_qGetTLSAddr
) != PACKET_DISABLE
)
11827 struct remote_state
*rs
= get_remote_state ();
11828 char *p
= rs
->buf
.data ();
11829 char *endp
= p
+ get_remote_packet_size ();
11830 enum packet_result result
;
11832 strcpy (p
, "qGetTLSAddr:");
11834 p
= write_ptid (p
, endp
, ptid
);
11836 p
+= hexnumstr (p
, offset
);
11838 p
+= hexnumstr (p
, lm
);
11842 getpkt (&rs
->buf
, 0);
11843 result
= packet_ok (rs
->buf
,
11844 &remote_protocol_packets
[PACKET_qGetTLSAddr
]);
11845 if (result
== PACKET_OK
)
11849 unpack_varlen_hex (rs
->buf
.data (), &addr
);
11852 else if (result
== PACKET_UNKNOWN
)
11853 throw_error (TLS_GENERIC_ERROR
,
11854 _("Remote target doesn't support qGetTLSAddr packet"));
11856 throw_error (TLS_GENERIC_ERROR
,
11857 _("Remote target failed to process qGetTLSAddr request"));
11860 throw_error (TLS_GENERIC_ERROR
,
11861 _("TLS not supported or disabled on this target"));
11866 /* Provide thread local base, i.e. Thread Information Block address.
11867 Returns 1 if ptid is found and thread_local_base is non zero. */
11870 remote_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
11872 if (packet_support (PACKET_qGetTIBAddr
) != PACKET_DISABLE
)
11874 struct remote_state
*rs
= get_remote_state ();
11875 char *p
= rs
->buf
.data ();
11876 char *endp
= p
+ get_remote_packet_size ();
11877 enum packet_result result
;
11879 strcpy (p
, "qGetTIBAddr:");
11881 p
= write_ptid (p
, endp
, ptid
);
11885 getpkt (&rs
->buf
, 0);
11886 result
= packet_ok (rs
->buf
,
11887 &remote_protocol_packets
[PACKET_qGetTIBAddr
]);
11888 if (result
== PACKET_OK
)
11891 unpack_varlen_hex (rs
->buf
.data (), &val
);
11893 *addr
= (CORE_ADDR
) val
;
11896 else if (result
== PACKET_UNKNOWN
)
11897 error (_("Remote target doesn't support qGetTIBAddr packet"));
11899 error (_("Remote target failed to process qGetTIBAddr request"));
11902 error (_("qGetTIBAddr not supported or disabled on this target"));
11907 /* Support for inferring a target description based on the current
11908 architecture and the size of a 'g' packet. While the 'g' packet
11909 can have any size (since optional registers can be left off the
11910 end), some sizes are easily recognizable given knowledge of the
11911 approximate architecture. */
11913 struct remote_g_packet_guess
11915 remote_g_packet_guess (int bytes_
, const struct target_desc
*tdesc_
)
11922 const struct target_desc
*tdesc
;
11925 struct remote_g_packet_data
: public allocate_on_obstack
11927 std::vector
<remote_g_packet_guess
> guesses
;
11930 static struct gdbarch_data
*remote_g_packet_data_handle
;
11933 remote_g_packet_data_init (struct obstack
*obstack
)
11935 return new (obstack
) remote_g_packet_data
;
11939 register_remote_g_packet_guess (struct gdbarch
*gdbarch
, int bytes
,
11940 const struct target_desc
*tdesc
)
11942 struct remote_g_packet_data
*data
11943 = ((struct remote_g_packet_data
*)
11944 gdbarch_data (gdbarch
, remote_g_packet_data_handle
));
11946 gdb_assert (tdesc
!= NULL
);
11948 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11949 if (guess
.bytes
== bytes
)
11950 internal_error (__FILE__
, __LINE__
,
11951 _("Duplicate g packet description added for size %d"),
11954 data
->guesses
.emplace_back (bytes
, tdesc
);
11957 /* Return true if remote_read_description would do anything on this target
11958 and architecture, false otherwise. */
11961 remote_read_description_p (struct target_ops
*target
)
11963 struct remote_g_packet_data
*data
11964 = ((struct remote_g_packet_data
*)
11965 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
11967 return !data
->guesses
.empty ();
11970 const struct target_desc
*
11971 remote_target::read_description ()
11973 struct remote_g_packet_data
*data
11974 = ((struct remote_g_packet_data
*)
11975 gdbarch_data (target_gdbarch (), remote_g_packet_data_handle
));
11977 /* Do not try this during initial connection, when we do not know
11978 whether there is a running but stopped thread. */
11979 if (!target_has_execution () || inferior_ptid
== null_ptid
)
11980 return beneath ()->read_description ();
11982 if (!data
->guesses
.empty ())
11984 int bytes
= send_g_packet ();
11986 for (const remote_g_packet_guess
&guess
: data
->guesses
)
11987 if (guess
.bytes
== bytes
)
11988 return guess
.tdesc
;
11990 /* We discard the g packet. A minor optimization would be to
11991 hold on to it, and fill the register cache once we have selected
11992 an architecture, but it's too tricky to do safely. */
11995 return beneath ()->read_description ();
11998 /* Remote file transfer support. This is host-initiated I/O, not
11999 target-initiated; for target-initiated, see remote-fileio.c. */
12001 /* If *LEFT is at least the length of STRING, copy STRING to
12002 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12003 decrease *LEFT. Otherwise raise an error. */
12006 remote_buffer_add_string (char **buffer
, int *left
, const char *string
)
12008 int len
= strlen (string
);
12011 error (_("Packet too long for target."));
12013 memcpy (*buffer
, string
, len
);
12017 /* NUL-terminate the buffer as a convenience, if there is
12023 /* If *LEFT is large enough, hex encode LEN bytes from BYTES into
12024 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12025 decrease *LEFT. Otherwise raise an error. */
12028 remote_buffer_add_bytes (char **buffer
, int *left
, const gdb_byte
*bytes
,
12031 if (2 * len
> *left
)
12032 error (_("Packet too long for target."));
12034 bin2hex (bytes
, *buffer
, len
);
12035 *buffer
+= 2 * len
;
12038 /* NUL-terminate the buffer as a convenience, if there is
12044 /* If *LEFT is large enough, convert VALUE to hex and add it to
12045 *BUFFER, update *BUFFER to point to the new end of the buffer, and
12046 decrease *LEFT. Otherwise raise an error. */
12049 remote_buffer_add_int (char **buffer
, int *left
, ULONGEST value
)
12051 int len
= hexnumlen (value
);
12054 error (_("Packet too long for target."));
12056 hexnumstr (*buffer
, value
);
12060 /* NUL-terminate the buffer as a convenience, if there is
12066 /* Parse an I/O result packet from BUFFER. Set RETCODE to the return
12067 value, *REMOTE_ERRNO to the remote error number or zero if none
12068 was included, and *ATTACHMENT to point to the start of the annex
12069 if any. The length of the packet isn't needed here; there may
12070 be NUL bytes in BUFFER, but they will be after *ATTACHMENT.
12072 Return 0 if the packet could be parsed, -1 if it could not. If
12073 -1 is returned, the other variables may not be initialized. */
12076 remote_hostio_parse_result (const char *buffer
, int *retcode
,
12077 int *remote_errno
, const char **attachment
)
12082 *attachment
= NULL
;
12084 if (buffer
[0] != 'F')
12088 *retcode
= strtol (&buffer
[1], &p
, 16);
12089 if (errno
!= 0 || p
== &buffer
[1])
12092 /* Check for ",errno". */
12096 *remote_errno
= strtol (p
+ 1, &p2
, 16);
12097 if (errno
!= 0 || p
+ 1 == p2
)
12102 /* Check for ";attachment". If there is no attachment, the
12103 packet should end here. */
12106 *attachment
= p
+ 1;
12109 else if (*p
== '\0')
12115 /* Send a prepared I/O packet to the target and read its response.
12116 The prepared packet is in the global RS->BUF before this function
12117 is called, and the answer is there when we return.
12119 COMMAND_BYTES is the length of the request to send, which may include
12120 binary data. WHICH_PACKET is the packet configuration to check
12121 before attempting a packet. If an error occurs, *REMOTE_ERRNO
12122 is set to the error number and -1 is returned. Otherwise the value
12123 returned by the function is returned.
12125 ATTACHMENT and ATTACHMENT_LEN should be non-NULL if and only if an
12126 attachment is expected; an error will be reported if there's a
12127 mismatch. If one is found, *ATTACHMENT will be set to point into
12128 the packet buffer and *ATTACHMENT_LEN will be set to the
12129 attachment's length. */
12132 remote_target::remote_hostio_send_command (int command_bytes
, int which_packet
,
12133 int *remote_errno
, const char **attachment
,
12134 int *attachment_len
)
12136 struct remote_state
*rs
= get_remote_state ();
12137 int ret
, bytes_read
;
12138 const char *attachment_tmp
;
12140 if (packet_support (which_packet
) == PACKET_DISABLE
)
12142 *remote_errno
= FILEIO_ENOSYS
;
12146 putpkt_binary (rs
->buf
.data (), command_bytes
);
12147 bytes_read
= getpkt_sane (&rs
->buf
, 0);
12149 /* If it timed out, something is wrong. Don't try to parse the
12151 if (bytes_read
< 0)
12153 *remote_errno
= FILEIO_EINVAL
;
12157 switch (packet_ok (rs
->buf
, &remote_protocol_packets
[which_packet
]))
12160 *remote_errno
= FILEIO_EINVAL
;
12162 case PACKET_UNKNOWN
:
12163 *remote_errno
= FILEIO_ENOSYS
;
12169 if (remote_hostio_parse_result (rs
->buf
.data (), &ret
, remote_errno
,
12172 *remote_errno
= FILEIO_EINVAL
;
12176 /* Make sure we saw an attachment if and only if we expected one. */
12177 if ((attachment_tmp
== NULL
&& attachment
!= NULL
)
12178 || (attachment_tmp
!= NULL
&& attachment
== NULL
))
12180 *remote_errno
= FILEIO_EINVAL
;
12184 /* If an attachment was found, it must point into the packet buffer;
12185 work out how many bytes there were. */
12186 if (attachment_tmp
!= NULL
)
12188 *attachment
= attachment_tmp
;
12189 *attachment_len
= bytes_read
- (*attachment
- rs
->buf
.data ());
12195 /* See declaration.h. */
12198 readahead_cache::invalidate ()
12203 /* See declaration.h. */
12206 readahead_cache::invalidate_fd (int fd
)
12208 if (this->fd
== fd
)
12212 /* Set the filesystem remote_hostio functions that take FILENAME
12213 arguments will use. Return 0 on success, or -1 if an error
12214 occurs (and set *REMOTE_ERRNO). */
12217 remote_target::remote_hostio_set_filesystem (struct inferior
*inf
,
12220 struct remote_state
*rs
= get_remote_state ();
12221 int required_pid
= (inf
== NULL
|| inf
->fake_pid_p
) ? 0 : inf
->pid
;
12222 char *p
= rs
->buf
.data ();
12223 int left
= get_remote_packet_size () - 1;
12227 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12230 if (rs
->fs_pid
!= -1 && required_pid
== rs
->fs_pid
)
12233 remote_buffer_add_string (&p
, &left
, "vFile:setfs:");
12235 xsnprintf (arg
, sizeof (arg
), "%x", required_pid
);
12236 remote_buffer_add_string (&p
, &left
, arg
);
12238 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_setfs
,
12239 remote_errno
, NULL
, NULL
);
12241 if (packet_support (PACKET_vFile_setfs
) == PACKET_DISABLE
)
12245 rs
->fs_pid
= required_pid
;
12250 /* Implementation of to_fileio_open. */
12253 remote_target::remote_hostio_open (inferior
*inf
, const char *filename
,
12254 int flags
, int mode
, int warn_if_slow
,
12257 struct remote_state
*rs
= get_remote_state ();
12258 char *p
= rs
->buf
.data ();
12259 int left
= get_remote_packet_size () - 1;
12263 static int warning_issued
= 0;
12265 printf_unfiltered (_("Reading %s from remote target...\n"),
12268 if (!warning_issued
)
12270 warning (_("File transfers from remote targets can be slow."
12271 " Use \"set sysroot\" to access files locally"
12273 warning_issued
= 1;
12277 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12280 remote_buffer_add_string (&p
, &left
, "vFile:open:");
12282 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12283 strlen (filename
));
12284 remote_buffer_add_string (&p
, &left
, ",");
12286 remote_buffer_add_int (&p
, &left
, flags
);
12287 remote_buffer_add_string (&p
, &left
, ",");
12289 remote_buffer_add_int (&p
, &left
, mode
);
12291 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_open
,
12292 remote_errno
, NULL
, NULL
);
12296 remote_target::fileio_open (struct inferior
*inf
, const char *filename
,
12297 int flags
, int mode
, int warn_if_slow
,
12300 return remote_hostio_open (inf
, filename
, flags
, mode
, warn_if_slow
,
12304 /* Implementation of to_fileio_pwrite. */
12307 remote_target::remote_hostio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12308 ULONGEST offset
, int *remote_errno
)
12310 struct remote_state
*rs
= get_remote_state ();
12311 char *p
= rs
->buf
.data ();
12312 int left
= get_remote_packet_size ();
12315 rs
->readahead_cache
.invalidate_fd (fd
);
12317 remote_buffer_add_string (&p
, &left
, "vFile:pwrite:");
12319 remote_buffer_add_int (&p
, &left
, fd
);
12320 remote_buffer_add_string (&p
, &left
, ",");
12322 remote_buffer_add_int (&p
, &left
, offset
);
12323 remote_buffer_add_string (&p
, &left
, ",");
12325 p
+= remote_escape_output (write_buf
, len
, 1, (gdb_byte
*) p
, &out_len
,
12326 (get_remote_packet_size ()
12327 - (p
- rs
->buf
.data ())));
12329 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pwrite
,
12330 remote_errno
, NULL
, NULL
);
12334 remote_target::fileio_pwrite (int fd
, const gdb_byte
*write_buf
, int len
,
12335 ULONGEST offset
, int *remote_errno
)
12337 return remote_hostio_pwrite (fd
, write_buf
, len
, offset
, remote_errno
);
12340 /* Helper for the implementation of to_fileio_pread. Read the file
12341 from the remote side with vFile:pread. */
12344 remote_target::remote_hostio_pread_vFile (int fd
, gdb_byte
*read_buf
, int len
,
12345 ULONGEST offset
, int *remote_errno
)
12347 struct remote_state
*rs
= get_remote_state ();
12348 char *p
= rs
->buf
.data ();
12349 const char *attachment
;
12350 int left
= get_remote_packet_size ();
12351 int ret
, attachment_len
;
12354 remote_buffer_add_string (&p
, &left
, "vFile:pread:");
12356 remote_buffer_add_int (&p
, &left
, fd
);
12357 remote_buffer_add_string (&p
, &left
, ",");
12359 remote_buffer_add_int (&p
, &left
, len
);
12360 remote_buffer_add_string (&p
, &left
, ",");
12362 remote_buffer_add_int (&p
, &left
, offset
);
12364 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_pread
,
12365 remote_errno
, &attachment
,
12371 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12373 if (read_len
!= ret
)
12374 error (_("Read returned %d, but %d bytes."), ret
, (int) read_len
);
12379 /* See declaration.h. */
12382 readahead_cache::pread (int fd
, gdb_byte
*read_buf
, size_t len
,
12386 && this->offset
<= offset
12387 && offset
< this->offset
+ this->bufsize
)
12389 ULONGEST max
= this->offset
+ this->bufsize
;
12391 if (offset
+ len
> max
)
12392 len
= max
- offset
;
12394 memcpy (read_buf
, this->buf
+ offset
- this->offset
, len
);
12401 /* Implementation of to_fileio_pread. */
12404 remote_target::remote_hostio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12405 ULONGEST offset
, int *remote_errno
)
12408 struct remote_state
*rs
= get_remote_state ();
12409 readahead_cache
*cache
= &rs
->readahead_cache
;
12411 ret
= cache
->pread (fd
, read_buf
, len
, offset
);
12414 cache
->hit_count
++;
12416 remote_debug_printf ("readahead cache hit %s",
12417 pulongest (cache
->hit_count
));
12421 cache
->miss_count
++;
12423 remote_debug_printf ("readahead cache miss %s",
12424 pulongest (cache
->miss_count
));
12427 cache
->offset
= offset
;
12428 cache
->bufsize
= get_remote_packet_size ();
12429 cache
->buf
= (gdb_byte
*) xrealloc (cache
->buf
, cache
->bufsize
);
12431 ret
= remote_hostio_pread_vFile (cache
->fd
, cache
->buf
, cache
->bufsize
,
12432 cache
->offset
, remote_errno
);
12435 cache
->invalidate_fd (fd
);
12439 cache
->bufsize
= ret
;
12440 return cache
->pread (fd
, read_buf
, len
, offset
);
12444 remote_target::fileio_pread (int fd
, gdb_byte
*read_buf
, int len
,
12445 ULONGEST offset
, int *remote_errno
)
12447 return remote_hostio_pread (fd
, read_buf
, len
, offset
, remote_errno
);
12450 /* Implementation of to_fileio_close. */
12453 remote_target::remote_hostio_close (int fd
, int *remote_errno
)
12455 struct remote_state
*rs
= get_remote_state ();
12456 char *p
= rs
->buf
.data ();
12457 int left
= get_remote_packet_size () - 1;
12459 rs
->readahead_cache
.invalidate_fd (fd
);
12461 remote_buffer_add_string (&p
, &left
, "vFile:close:");
12463 remote_buffer_add_int (&p
, &left
, fd
);
12465 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_close
,
12466 remote_errno
, NULL
, NULL
);
12470 remote_target::fileio_close (int fd
, int *remote_errno
)
12472 return remote_hostio_close (fd
, remote_errno
);
12475 /* Implementation of to_fileio_unlink. */
12478 remote_target::remote_hostio_unlink (inferior
*inf
, const char *filename
,
12481 struct remote_state
*rs
= get_remote_state ();
12482 char *p
= rs
->buf
.data ();
12483 int left
= get_remote_packet_size () - 1;
12485 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12488 remote_buffer_add_string (&p
, &left
, "vFile:unlink:");
12490 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12491 strlen (filename
));
12493 return remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_unlink
,
12494 remote_errno
, NULL
, NULL
);
12498 remote_target::fileio_unlink (struct inferior
*inf
, const char *filename
,
12501 return remote_hostio_unlink (inf
, filename
, remote_errno
);
12504 /* Implementation of to_fileio_readlink. */
12506 gdb::optional
<std::string
>
12507 remote_target::fileio_readlink (struct inferior
*inf
, const char *filename
,
12510 struct remote_state
*rs
= get_remote_state ();
12511 char *p
= rs
->buf
.data ();
12512 const char *attachment
;
12513 int left
= get_remote_packet_size ();
12514 int len
, attachment_len
;
12517 if (remote_hostio_set_filesystem (inf
, remote_errno
) != 0)
12520 remote_buffer_add_string (&p
, &left
, "vFile:readlink:");
12522 remote_buffer_add_bytes (&p
, &left
, (const gdb_byte
*) filename
,
12523 strlen (filename
));
12525 len
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_readlink
,
12526 remote_errno
, &attachment
,
12532 std::string
ret (len
, '\0');
12534 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12535 (gdb_byte
*) &ret
[0], len
);
12536 if (read_len
!= len
)
12537 error (_("Readlink returned %d, but %d bytes."), len
, read_len
);
12542 /* Implementation of to_fileio_fstat. */
12545 remote_target::fileio_fstat (int fd
, struct stat
*st
, int *remote_errno
)
12547 struct remote_state
*rs
= get_remote_state ();
12548 char *p
= rs
->buf
.data ();
12549 int left
= get_remote_packet_size ();
12550 int attachment_len
, ret
;
12551 const char *attachment
;
12552 struct fio_stat fst
;
12555 remote_buffer_add_string (&p
, &left
, "vFile:fstat:");
12557 remote_buffer_add_int (&p
, &left
, fd
);
12559 ret
= remote_hostio_send_command (p
- rs
->buf
.data (), PACKET_vFile_fstat
,
12560 remote_errno
, &attachment
,
12564 if (*remote_errno
!= FILEIO_ENOSYS
)
12567 /* Strictly we should return -1, ENOSYS here, but when
12568 "set sysroot remote:" was implemented in August 2008
12569 BFD's need for a stat function was sidestepped with
12570 this hack. This was not remedied until March 2015
12571 so we retain the previous behavior to avoid breaking
12574 Note that the memset is a March 2015 addition; older
12575 GDBs set st_size *and nothing else* so the structure
12576 would have garbage in all other fields. This might
12577 break something but retaining the previous behavior
12578 here would be just too wrong. */
12580 memset (st
, 0, sizeof (struct stat
));
12581 st
->st_size
= INT_MAX
;
12585 read_len
= remote_unescape_input ((gdb_byte
*) attachment
, attachment_len
,
12586 (gdb_byte
*) &fst
, sizeof (fst
));
12588 if (read_len
!= ret
)
12589 error (_("vFile:fstat returned %d, but %d bytes."), ret
, read_len
);
12591 if (read_len
!= sizeof (fst
))
12592 error (_("vFile:fstat returned %d bytes, but expecting %d."),
12593 read_len
, (int) sizeof (fst
));
12595 remote_fileio_to_host_stat (&fst
, st
);
12600 /* Implementation of to_filesystem_is_local. */
12603 remote_target::filesystem_is_local ()
12605 /* Valgrind GDB presents itself as a remote target but works
12606 on the local filesystem: it does not implement remote get
12607 and users are not expected to set a sysroot. To handle
12608 this case we treat the remote filesystem as local if the
12609 sysroot is exactly TARGET_SYSROOT_PREFIX and if the stub
12610 does not support vFile:open. */
12611 if (strcmp (gdb_sysroot
, TARGET_SYSROOT_PREFIX
) == 0)
12613 enum packet_support ps
= packet_support (PACKET_vFile_open
);
12615 if (ps
== PACKET_SUPPORT_UNKNOWN
)
12617 int fd
, remote_errno
;
12619 /* Try opening a file to probe support. The supplied
12620 filename is irrelevant, we only care about whether
12621 the stub recognizes the packet or not. */
12622 fd
= remote_hostio_open (NULL
, "just probing",
12623 FILEIO_O_RDONLY
, 0700, 0,
12627 remote_hostio_close (fd
, &remote_errno
);
12629 ps
= packet_support (PACKET_vFile_open
);
12632 if (ps
== PACKET_DISABLE
)
12634 static int warning_issued
= 0;
12636 if (!warning_issued
)
12638 warning (_("remote target does not support file"
12639 " transfer, attempting to access files"
12640 " from local filesystem."));
12641 warning_issued
= 1;
12652 remote_fileio_errno_to_host (int errnum
)
12658 case FILEIO_ENOENT
:
12666 case FILEIO_EACCES
:
12668 case FILEIO_EFAULT
:
12672 case FILEIO_EEXIST
:
12674 case FILEIO_ENODEV
:
12676 case FILEIO_ENOTDIR
:
12678 case FILEIO_EISDIR
:
12680 case FILEIO_EINVAL
:
12682 case FILEIO_ENFILE
:
12684 case FILEIO_EMFILE
:
12688 case FILEIO_ENOSPC
:
12690 case FILEIO_ESPIPE
:
12694 case FILEIO_ENOSYS
:
12696 case FILEIO_ENAMETOOLONG
:
12697 return ENAMETOOLONG
;
12703 remote_hostio_error (int errnum
)
12705 int host_error
= remote_fileio_errno_to_host (errnum
);
12707 if (host_error
== -1)
12708 error (_("Unknown remote I/O error %d"), errnum
);
12710 error (_("Remote I/O error: %s"), safe_strerror (host_error
));
12713 /* A RAII wrapper around a remote file descriptor. */
12715 class scoped_remote_fd
12718 scoped_remote_fd (remote_target
*remote
, int fd
)
12719 : m_remote (remote
), m_fd (fd
)
12723 ~scoped_remote_fd ()
12730 m_remote
->remote_hostio_close (m_fd
, &remote_errno
);
12734 /* Swallow exception before it escapes the dtor. If
12735 something goes wrong, likely the connection is gone,
12736 and there's nothing else that can be done. */
12741 DISABLE_COPY_AND_ASSIGN (scoped_remote_fd
);
12743 /* Release ownership of the file descriptor, and return it. */
12744 ATTRIBUTE_UNUSED_RESULT
int release () noexcept
12751 /* Return the owned file descriptor. */
12752 int get () const noexcept
12758 /* The remote target. */
12759 remote_target
*m_remote
;
12761 /* The owned remote I/O file descriptor. */
12766 remote_file_put (const char *local_file
, const char *remote_file
, int from_tty
)
12768 remote_target
*remote
= get_current_remote_target ();
12770 if (remote
== nullptr)
12771 error (_("command can only be used with remote target"));
12773 remote
->remote_file_put (local_file
, remote_file
, from_tty
);
12777 remote_target::remote_file_put (const char *local_file
, const char *remote_file
,
12780 int retcode
, remote_errno
, bytes
, io_size
;
12781 int bytes_in_buffer
;
12785 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "rb");
12787 perror_with_name (local_file
);
12789 scoped_remote_fd fd
12790 (this, remote_hostio_open (NULL
,
12791 remote_file
, (FILEIO_O_WRONLY
| FILEIO_O_CREAT
12793 0700, 0, &remote_errno
));
12794 if (fd
.get () == -1)
12795 remote_hostio_error (remote_errno
);
12797 /* Send up to this many bytes at once. They won't all fit in the
12798 remote packet limit, so we'll transfer slightly fewer. */
12799 io_size
= get_remote_packet_size ();
12800 gdb::byte_vector
buffer (io_size
);
12802 bytes_in_buffer
= 0;
12805 while (bytes_in_buffer
|| !saw_eof
)
12809 bytes
= fread (buffer
.data () + bytes_in_buffer
, 1,
12810 io_size
- bytes_in_buffer
,
12814 if (ferror (file
.get ()))
12815 error (_("Error reading %s."), local_file
);
12818 /* EOF. Unless there is something still in the
12819 buffer from the last iteration, we are done. */
12821 if (bytes_in_buffer
== 0)
12829 bytes
+= bytes_in_buffer
;
12830 bytes_in_buffer
= 0;
12832 retcode
= remote_hostio_pwrite (fd
.get (), buffer
.data (), bytes
,
12833 offset
, &remote_errno
);
12836 remote_hostio_error (remote_errno
);
12837 else if (retcode
== 0)
12838 error (_("Remote write of %d bytes returned 0!"), bytes
);
12839 else if (retcode
< bytes
)
12841 /* Short write. Save the rest of the read data for the next
12843 bytes_in_buffer
= bytes
- retcode
;
12844 memmove (buffer
.data (), buffer
.data () + retcode
, bytes_in_buffer
);
12850 if (remote_hostio_close (fd
.release (), &remote_errno
))
12851 remote_hostio_error (remote_errno
);
12854 printf_filtered (_("Successfully sent file \"%s\".\n"), local_file
);
12858 remote_file_get (const char *remote_file
, const char *local_file
, int from_tty
)
12860 remote_target
*remote
= get_current_remote_target ();
12862 if (remote
== nullptr)
12863 error (_("command can only be used with remote target"));
12865 remote
->remote_file_get (remote_file
, local_file
, from_tty
);
12869 remote_target::remote_file_get (const char *remote_file
, const char *local_file
,
12872 int remote_errno
, bytes
, io_size
;
12875 scoped_remote_fd fd
12876 (this, remote_hostio_open (NULL
,
12877 remote_file
, FILEIO_O_RDONLY
, 0, 0,
12879 if (fd
.get () == -1)
12880 remote_hostio_error (remote_errno
);
12882 gdb_file_up file
= gdb_fopen_cloexec (local_file
, "wb");
12884 perror_with_name (local_file
);
12886 /* Send up to this many bytes at once. They won't all fit in the
12887 remote packet limit, so we'll transfer slightly fewer. */
12888 io_size
= get_remote_packet_size ();
12889 gdb::byte_vector
buffer (io_size
);
12894 bytes
= remote_hostio_pread (fd
.get (), buffer
.data (), io_size
, offset
,
12897 /* Success, but no bytes, means end-of-file. */
12900 remote_hostio_error (remote_errno
);
12904 bytes
= fwrite (buffer
.data (), 1, bytes
, file
.get ());
12906 perror_with_name (local_file
);
12909 if (remote_hostio_close (fd
.release (), &remote_errno
))
12910 remote_hostio_error (remote_errno
);
12913 printf_filtered (_("Successfully fetched file \"%s\".\n"), remote_file
);
12917 remote_file_delete (const char *remote_file
, int from_tty
)
12919 remote_target
*remote
= get_current_remote_target ();
12921 if (remote
== nullptr)
12922 error (_("command can only be used with remote target"));
12924 remote
->remote_file_delete (remote_file
, from_tty
);
12928 remote_target::remote_file_delete (const char *remote_file
, int from_tty
)
12930 int retcode
, remote_errno
;
12932 retcode
= remote_hostio_unlink (NULL
, remote_file
, &remote_errno
);
12934 remote_hostio_error (remote_errno
);
12937 printf_filtered (_("Successfully deleted file \"%s\".\n"), remote_file
);
12941 remote_put_command (const char *args
, int from_tty
)
12944 error_no_arg (_("file to put"));
12946 gdb_argv
argv (args
);
12947 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12948 error (_("Invalid parameters to remote put"));
12950 remote_file_put (argv
[0], argv
[1], from_tty
);
12954 remote_get_command (const char *args
, int from_tty
)
12957 error_no_arg (_("file to get"));
12959 gdb_argv
argv (args
);
12960 if (argv
[0] == NULL
|| argv
[1] == NULL
|| argv
[2] != NULL
)
12961 error (_("Invalid parameters to remote get"));
12963 remote_file_get (argv
[0], argv
[1], from_tty
);
12967 remote_delete_command (const char *args
, int from_tty
)
12970 error_no_arg (_("file to delete"));
12972 gdb_argv
argv (args
);
12973 if (argv
[0] == NULL
|| argv
[1] != NULL
)
12974 error (_("Invalid parameters to remote delete"));
12976 remote_file_delete (argv
[0], from_tty
);
12980 remote_target::can_execute_reverse ()
12982 if (packet_support (PACKET_bs
) == PACKET_ENABLE
12983 || packet_support (PACKET_bc
) == PACKET_ENABLE
)
12990 remote_target::supports_non_stop ()
12996 remote_target::supports_disable_randomization ()
12998 /* Only supported in extended mode. */
13003 remote_target::supports_multi_process ()
13005 struct remote_state
*rs
= get_remote_state ();
13007 return remote_multi_process_p (rs
);
13011 remote_supports_cond_tracepoints ()
13013 return packet_support (PACKET_ConditionalTracepoints
) == PACKET_ENABLE
;
13017 remote_target::supports_evaluation_of_breakpoint_conditions ()
13019 return packet_support (PACKET_ConditionalBreakpoints
) == PACKET_ENABLE
;
13023 remote_supports_fast_tracepoints ()
13025 return packet_support (PACKET_FastTracepoints
) == PACKET_ENABLE
;
13029 remote_supports_static_tracepoints ()
13031 return packet_support (PACKET_StaticTracepoints
) == PACKET_ENABLE
;
13035 remote_supports_install_in_trace ()
13037 return packet_support (PACKET_InstallInTrace
) == PACKET_ENABLE
;
13041 remote_target::supports_enable_disable_tracepoint ()
13043 return (packet_support (PACKET_EnableDisableTracepoints_feature
)
13048 remote_target::supports_string_tracing ()
13050 return packet_support (PACKET_tracenz_feature
) == PACKET_ENABLE
;
13054 remote_target::can_run_breakpoint_commands ()
13056 return packet_support (PACKET_BreakpointCommands
) == PACKET_ENABLE
;
13060 remote_target::trace_init ()
13062 struct remote_state
*rs
= get_remote_state ();
13065 remote_get_noisy_reply ();
13066 if (strcmp (rs
->buf
.data (), "OK") != 0)
13067 error (_("Target does not support this command."));
13070 /* Recursive routine to walk through command list including loops, and
13071 download packets for each command. */
13074 remote_target::remote_download_command_source (int num
, ULONGEST addr
,
13075 struct command_line
*cmds
)
13077 struct remote_state
*rs
= get_remote_state ();
13078 struct command_line
*cmd
;
13080 for (cmd
= cmds
; cmd
; cmd
= cmd
->next
)
13082 QUIT
; /* Allow user to bail out with ^C. */
13083 strcpy (rs
->buf
.data (), "QTDPsrc:");
13084 encode_source_string (num
, addr
, "cmd", cmd
->line
,
13085 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13086 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13088 remote_get_noisy_reply ();
13089 if (strcmp (rs
->buf
.data (), "OK"))
13090 warning (_("Target does not support source download."));
13092 if (cmd
->control_type
== while_control
13093 || cmd
->control_type
== while_stepping_control
)
13095 remote_download_command_source (num
, addr
, cmd
->body_list_0
.get ());
13097 QUIT
; /* Allow user to bail out with ^C. */
13098 strcpy (rs
->buf
.data (), "QTDPsrc:");
13099 encode_source_string (num
, addr
, "cmd", "end",
13100 rs
->buf
.data () + strlen (rs
->buf
.data ()),
13101 rs
->buf
.size () - strlen (rs
->buf
.data ()));
13103 remote_get_noisy_reply ();
13104 if (strcmp (rs
->buf
.data (), "OK"))
13105 warning (_("Target does not support source download."));
13111 remote_target::download_tracepoint (struct bp_location
*loc
)
13115 std::vector
<std::string
> tdp_actions
;
13116 std::vector
<std::string
> stepping_actions
;
13118 struct breakpoint
*b
= loc
->owner
;
13119 struct tracepoint
*t
= (struct tracepoint
*) b
;
13120 struct remote_state
*rs
= get_remote_state ();
13122 const char *err_msg
= _("Tracepoint packet too large for target.");
13125 /* We use a buffer other than rs->buf because we'll build strings
13126 across multiple statements, and other statements in between could
13128 gdb::char_vector
buf (get_remote_packet_size ());
13130 encode_actions_rsp (loc
, &tdp_actions
, &stepping_actions
);
13132 tpaddr
= loc
->address
;
13133 strcpy (addrbuf
, phex (tpaddr
, sizeof (CORE_ADDR
)));
13134 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:%x:%s:%c:%lx:%x",
13135 b
->number
, addrbuf
, /* address */
13136 (b
->enable_state
== bp_enabled
? 'E' : 'D'),
13137 t
->step_count
, t
->pass_count
);
13139 if (ret
< 0 || ret
>= buf
.size ())
13140 error ("%s", err_msg
);
13142 /* Fast tracepoints are mostly handled by the target, but we can
13143 tell the target how big of an instruction block should be moved
13145 if (b
->type
== bp_fast_tracepoint
)
13147 /* Only test for support at download time; we may not know
13148 target capabilities at definition time. */
13149 if (remote_supports_fast_tracepoints ())
13151 if (gdbarch_fast_tracepoint_valid_at (loc
->gdbarch
, tpaddr
,
13154 size_left
= buf
.size () - strlen (buf
.data ());
13155 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13157 gdb_insn_length (loc
->gdbarch
, tpaddr
));
13159 if (ret
< 0 || ret
>= size_left
)
13160 error ("%s", err_msg
);
13163 /* If it passed validation at definition but fails now,
13164 something is very wrong. */
13165 internal_error (__FILE__
, __LINE__
,
13166 _("Fast tracepoint not "
13167 "valid during download"));
13170 /* Fast tracepoints are functionally identical to regular
13171 tracepoints, so don't take lack of support as a reason to
13172 give up on the trace run. */
13173 warning (_("Target does not support fast tracepoints, "
13174 "downloading %d as regular tracepoint"), b
->number
);
13176 else if (b
->type
== bp_static_tracepoint
)
13178 /* Only test for support at download time; we may not know
13179 target capabilities at definition time. */
13180 if (remote_supports_static_tracepoints ())
13182 struct static_tracepoint_marker marker
;
13184 if (target_static_tracepoint_marker_at (tpaddr
, &marker
))
13186 size_left
= buf
.size () - strlen (buf
.data ());
13187 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13190 if (ret
< 0 || ret
>= size_left
)
13191 error ("%s", err_msg
);
13194 error (_("Static tracepoint not valid during download"));
13197 /* Fast tracepoints are functionally identical to regular
13198 tracepoints, so don't take lack of support as a reason
13199 to give up on the trace run. */
13200 error (_("Target does not support static tracepoints"));
13202 /* If the tracepoint has a conditional, make it into an agent
13203 expression and append to the definition. */
13206 /* Only test support at download time, we may not know target
13207 capabilities at definition time. */
13208 if (remote_supports_cond_tracepoints ())
13210 agent_expr_up aexpr
= gen_eval_for_expr (tpaddr
,
13213 size_left
= buf
.size () - strlen (buf
.data ());
13215 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13216 size_left
, ":X%x,", aexpr
->len
);
13218 if (ret
< 0 || ret
>= size_left
)
13219 error ("%s", err_msg
);
13221 size_left
= buf
.size () - strlen (buf
.data ());
13223 /* Two bytes to encode each aexpr byte, plus the terminating
13225 if (aexpr
->len
* 2 + 1 > size_left
)
13226 error ("%s", err_msg
);
13228 pkt
= buf
.data () + strlen (buf
.data ());
13230 for (int ndx
= 0; ndx
< aexpr
->len
; ++ndx
)
13231 pkt
= pack_hex_byte (pkt
, aexpr
->buf
[ndx
]);
13235 warning (_("Target does not support conditional tracepoints, "
13236 "ignoring tp %d cond"), b
->number
);
13239 if (b
->commands
|| *default_collect
)
13241 size_left
= buf
.size () - strlen (buf
.data ());
13243 ret
= snprintf (buf
.data () + strlen (buf
.data ()),
13246 if (ret
< 0 || ret
>= size_left
)
13247 error ("%s", err_msg
);
13250 putpkt (buf
.data ());
13251 remote_get_noisy_reply ();
13252 if (strcmp (rs
->buf
.data (), "OK"))
13253 error (_("Target does not support tracepoints."));
13255 /* do_single_steps (t); */
13256 for (auto action_it
= tdp_actions
.begin ();
13257 action_it
!= tdp_actions
.end (); action_it
++)
13259 QUIT
; /* Allow user to bail out with ^C. */
13261 bool has_more
= ((action_it
+ 1) != tdp_actions
.end ()
13262 || !stepping_actions
.empty ());
13264 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%c",
13265 b
->number
, addrbuf
, /* address */
13266 action_it
->c_str (),
13267 has_more
? '-' : 0);
13269 if (ret
< 0 || ret
>= buf
.size ())
13270 error ("%s", err_msg
);
13272 putpkt (buf
.data ());
13273 remote_get_noisy_reply ();
13274 if (strcmp (rs
->buf
.data (), "OK"))
13275 error (_("Error on target while setting tracepoints."));
13278 for (auto action_it
= stepping_actions
.begin ();
13279 action_it
!= stepping_actions
.end (); action_it
++)
13281 QUIT
; /* Allow user to bail out with ^C. */
13283 bool is_first
= action_it
== stepping_actions
.begin ();
13284 bool has_more
= (action_it
+ 1) != stepping_actions
.end ();
13286 ret
= snprintf (buf
.data (), buf
.size (), "QTDP:-%x:%s:%s%s%s",
13287 b
->number
, addrbuf
, /* address */
13288 is_first
? "S" : "",
13289 action_it
->c_str (),
13290 has_more
? "-" : "");
13292 if (ret
< 0 || ret
>= buf
.size ())
13293 error ("%s", err_msg
);
13295 putpkt (buf
.data ());
13296 remote_get_noisy_reply ();
13297 if (strcmp (rs
->buf
.data (), "OK"))
13298 error (_("Error on target while setting tracepoints."));
13301 if (packet_support (PACKET_TracepointSource
) == PACKET_ENABLE
)
13303 if (b
->location
!= NULL
)
13305 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13307 if (ret
< 0 || ret
>= buf
.size ())
13308 error ("%s", err_msg
);
13310 encode_source_string (b
->number
, loc
->address
, "at",
13311 event_location_to_string (b
->location
.get ()),
13312 buf
.data () + strlen (buf
.data ()),
13313 buf
.size () - strlen (buf
.data ()));
13314 putpkt (buf
.data ());
13315 remote_get_noisy_reply ();
13316 if (strcmp (rs
->buf
.data (), "OK"))
13317 warning (_("Target does not support source download."));
13319 if (b
->cond_string
)
13321 ret
= snprintf (buf
.data (), buf
.size (), "QTDPsrc:");
13323 if (ret
< 0 || ret
>= buf
.size ())
13324 error ("%s", err_msg
);
13326 encode_source_string (b
->number
, loc
->address
,
13327 "cond", b
->cond_string
,
13328 buf
.data () + strlen (buf
.data ()),
13329 buf
.size () - strlen (buf
.data ()));
13330 putpkt (buf
.data ());
13331 remote_get_noisy_reply ();
13332 if (strcmp (rs
->buf
.data (), "OK"))
13333 warning (_("Target does not support source download."));
13335 remote_download_command_source (b
->number
, loc
->address
,
13336 breakpoint_commands (b
));
13341 remote_target::can_download_tracepoint ()
13343 struct remote_state
*rs
= get_remote_state ();
13344 struct trace_status
*ts
;
13347 /* Don't try to install tracepoints until we've relocated our
13348 symbols, and fetched and merged the target's tracepoint list with
13350 if (rs
->starting_up
)
13353 ts
= current_trace_status ();
13354 status
= get_trace_status (ts
);
13356 if (status
== -1 || !ts
->running_known
|| !ts
->running
)
13359 /* If we are in a tracing experiment, but remote stub doesn't support
13360 installing tracepoint in trace, we have to return. */
13361 if (!remote_supports_install_in_trace ())
13369 remote_target::download_trace_state_variable (const trace_state_variable
&tsv
)
13371 struct remote_state
*rs
= get_remote_state ();
13374 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDV:%x:%s:%x:",
13375 tsv
.number
, phex ((ULONGEST
) tsv
.initial_value
, 8),
13377 p
= rs
->buf
.data () + strlen (rs
->buf
.data ());
13378 if ((p
- rs
->buf
.data ()) + tsv
.name
.length () * 2
13379 >= get_remote_packet_size ())
13380 error (_("Trace state variable name too long for tsv definition packet"));
13381 p
+= 2 * bin2hex ((gdb_byte
*) (tsv
.name
.data ()), p
, tsv
.name
.length ());
13384 remote_get_noisy_reply ();
13385 if (rs
->buf
[0] == '\0')
13386 error (_("Target does not support this command."));
13387 if (strcmp (rs
->buf
.data (), "OK") != 0)
13388 error (_("Error on target while downloading trace state variable."));
13392 remote_target::enable_tracepoint (struct bp_location
*location
)
13394 struct remote_state
*rs
= get_remote_state ();
13396 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTEnable:%x:%s",
13397 location
->owner
->number
,
13398 phex (location
->address
, sizeof (CORE_ADDR
)));
13400 remote_get_noisy_reply ();
13401 if (rs
->buf
[0] == '\0')
13402 error (_("Target does not support enabling tracepoints while a trace run is ongoing."));
13403 if (strcmp (rs
->buf
.data (), "OK") != 0)
13404 error (_("Error on target while enabling tracepoint."));
13408 remote_target::disable_tracepoint (struct bp_location
*location
)
13410 struct remote_state
*rs
= get_remote_state ();
13412 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QTDisable:%x:%s",
13413 location
->owner
->number
,
13414 phex (location
->address
, sizeof (CORE_ADDR
)));
13416 remote_get_noisy_reply ();
13417 if (rs
->buf
[0] == '\0')
13418 error (_("Target does not support disabling tracepoints while a trace run is ongoing."));
13419 if (strcmp (rs
->buf
.data (), "OK") != 0)
13420 error (_("Error on target while disabling tracepoint."));
13424 remote_target::trace_set_readonly_regions ()
13427 bfd_size_type size
;
13432 if (!current_program_space
->exec_bfd ())
13433 return; /* No information to give. */
13435 struct remote_state
*rs
= get_remote_state ();
13437 strcpy (rs
->buf
.data (), "QTro");
13438 offset
= strlen (rs
->buf
.data ());
13439 for (s
= current_program_space
->exec_bfd ()->sections
; s
; s
= s
->next
)
13441 char tmp1
[40], tmp2
[40];
13444 if ((s
->flags
& SEC_LOAD
) == 0 ||
13445 /* (s->flags & SEC_CODE) == 0 || */
13446 (s
->flags
& SEC_READONLY
) == 0)
13450 vma
= bfd_section_vma (s
);
13451 size
= bfd_section_size (s
);
13452 sprintf_vma (tmp1
, vma
);
13453 sprintf_vma (tmp2
, vma
+ size
);
13454 sec_length
= 1 + strlen (tmp1
) + 1 + strlen (tmp2
);
13455 if (offset
+ sec_length
+ 1 > rs
->buf
.size ())
13457 if (packet_support (PACKET_qXfer_traceframe_info
) != PACKET_ENABLE
)
13459 Too many sections for read-only sections definition packet."));
13462 xsnprintf (rs
->buf
.data () + offset
, rs
->buf
.size () - offset
, ":%s,%s",
13464 offset
+= sec_length
;
13469 getpkt (&rs
->buf
, 0);
13474 remote_target::trace_start ()
13476 struct remote_state
*rs
= get_remote_state ();
13478 putpkt ("QTStart");
13479 remote_get_noisy_reply ();
13480 if (rs
->buf
[0] == '\0')
13481 error (_("Target does not support this command."));
13482 if (strcmp (rs
->buf
.data (), "OK") != 0)
13483 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13487 remote_target::get_trace_status (struct trace_status
*ts
)
13489 /* Initialize it just to avoid a GCC false warning. */
13491 enum packet_result result
;
13492 struct remote_state
*rs
= get_remote_state ();
13494 if (packet_support (PACKET_qTStatus
) == PACKET_DISABLE
)
13497 /* FIXME we need to get register block size some other way. */
13498 trace_regblock_size
13499 = rs
->get_remote_arch_state (target_gdbarch ())->sizeof_g_packet
;
13501 putpkt ("qTStatus");
13505 p
= remote_get_noisy_reply ();
13507 catch (const gdb_exception_error
&ex
)
13509 if (ex
.error
!= TARGET_CLOSE_ERROR
)
13511 exception_fprintf (gdb_stderr
, ex
, "qTStatus: ");
13517 result
= packet_ok (p
, &remote_protocol_packets
[PACKET_qTStatus
]);
13519 /* If the remote target doesn't do tracing, flag it. */
13520 if (result
== PACKET_UNKNOWN
)
13523 /* We're working with a live target. */
13524 ts
->filename
= NULL
;
13527 error (_("Bogus trace status reply from target: %s"), rs
->buf
.data ());
13529 /* Function 'parse_trace_status' sets default value of each field of
13530 'ts' at first, so we don't have to do it here. */
13531 parse_trace_status (p
, ts
);
13533 return ts
->running
;
13537 remote_target::get_tracepoint_status (struct breakpoint
*bp
,
13538 struct uploaded_tp
*utp
)
13540 struct remote_state
*rs
= get_remote_state ();
13542 struct tracepoint
*tp
= (struct tracepoint
*) bp
;
13543 size_t size
= get_remote_packet_size ();
13548 tp
->traceframe_usage
= 0;
13549 for (bp_location
*loc
: tp
->locations ())
13551 /* If the tracepoint was never downloaded, don't go asking for
13553 if (tp
->number_on_target
== 0)
13555 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", tp
->number_on_target
,
13556 phex_nz (loc
->address
, 0));
13558 reply
= remote_get_noisy_reply ();
13559 if (reply
&& *reply
)
13562 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13568 utp
->hit_count
= 0;
13569 utp
->traceframe_usage
= 0;
13570 xsnprintf (rs
->buf
.data (), size
, "qTP:%x:%s", utp
->number
,
13571 phex_nz (utp
->addr
, 0));
13573 reply
= remote_get_noisy_reply ();
13574 if (reply
&& *reply
)
13577 parse_tracepoint_status (reply
+ 1, bp
, utp
);
13583 remote_target::trace_stop ()
13585 struct remote_state
*rs
= get_remote_state ();
13588 remote_get_noisy_reply ();
13589 if (rs
->buf
[0] == '\0')
13590 error (_("Target does not support this command."));
13591 if (strcmp (rs
->buf
.data (), "OK") != 0)
13592 error (_("Bogus reply from target: %s"), rs
->buf
.data ());
13596 remote_target::trace_find (enum trace_find_type type
, int num
,
13597 CORE_ADDR addr1
, CORE_ADDR addr2
,
13600 struct remote_state
*rs
= get_remote_state ();
13601 char *endbuf
= rs
->buf
.data () + get_remote_packet_size ();
13603 int target_frameno
= -1, target_tracept
= -1;
13605 /* Lookups other than by absolute frame number depend on the current
13606 trace selected, so make sure it is correct on the remote end
13608 if (type
!= tfind_number
)
13609 set_remote_traceframe ();
13611 p
= rs
->buf
.data ();
13612 strcpy (p
, "QTFrame:");
13613 p
= strchr (p
, '\0');
13617 xsnprintf (p
, endbuf
- p
, "%x", num
);
13620 xsnprintf (p
, endbuf
- p
, "pc:%s", phex_nz (addr1
, 0));
13623 xsnprintf (p
, endbuf
- p
, "tdp:%x", num
);
13626 xsnprintf (p
, endbuf
- p
, "range:%s:%s", phex_nz (addr1
, 0),
13627 phex_nz (addr2
, 0));
13629 case tfind_outside
:
13630 xsnprintf (p
, endbuf
- p
, "outside:%s:%s", phex_nz (addr1
, 0),
13631 phex_nz (addr2
, 0));
13634 error (_("Unknown trace find type %d"), type
);
13638 reply
= remote_get_noisy_reply ();
13639 if (*reply
== '\0')
13640 error (_("Target does not support this command."));
13642 while (reply
&& *reply
)
13647 target_frameno
= (int) strtol (p
, &reply
, 16);
13649 error (_("Unable to parse trace frame number"));
13650 /* Don't update our remote traceframe number cache on failure
13651 to select a remote traceframe. */
13652 if (target_frameno
== -1)
13657 target_tracept
= (int) strtol (p
, &reply
, 16);
13659 error (_("Unable to parse tracepoint number"));
13661 case 'O': /* "OK"? */
13662 if (reply
[1] == 'K' && reply
[2] == '\0')
13665 error (_("Bogus reply from target: %s"), reply
);
13668 error (_("Bogus reply from target: %s"), reply
);
13671 *tpp
= target_tracept
;
13673 rs
->remote_traceframe_number
= target_frameno
;
13674 return target_frameno
;
13678 remote_target::get_trace_state_variable_value (int tsvnum
, LONGEST
*val
)
13680 struct remote_state
*rs
= get_remote_state ();
13684 set_remote_traceframe ();
13686 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTV:%x", tsvnum
);
13688 reply
= remote_get_noisy_reply ();
13689 if (reply
&& *reply
)
13693 unpack_varlen_hex (reply
+ 1, &uval
);
13694 *val
= (LONGEST
) uval
;
13702 remote_target::save_trace_data (const char *filename
)
13704 struct remote_state
*rs
= get_remote_state ();
13707 p
= rs
->buf
.data ();
13708 strcpy (p
, "QTSave:");
13710 if ((p
- rs
->buf
.data ()) + strlen (filename
) * 2
13711 >= get_remote_packet_size ())
13712 error (_("Remote file name too long for trace save packet"));
13713 p
+= 2 * bin2hex ((gdb_byte
*) filename
, p
, strlen (filename
));
13716 reply
= remote_get_noisy_reply ();
13717 if (*reply
== '\0')
13718 error (_("Target does not support this command."));
13719 if (strcmp (reply
, "OK") != 0)
13720 error (_("Bogus reply from target: %s"), reply
);
13724 /* This is basically a memory transfer, but needs to be its own packet
13725 because we don't know how the target actually organizes its trace
13726 memory, plus we want to be able to ask for as much as possible, but
13727 not be unhappy if we don't get as much as we ask for. */
13730 remote_target::get_raw_trace_data (gdb_byte
*buf
, ULONGEST offset
, LONGEST len
)
13732 struct remote_state
*rs
= get_remote_state ();
13737 p
= rs
->buf
.data ();
13738 strcpy (p
, "qTBuffer:");
13740 p
+= hexnumstr (p
, offset
);
13742 p
+= hexnumstr (p
, len
);
13746 reply
= remote_get_noisy_reply ();
13747 if (reply
&& *reply
)
13749 /* 'l' by itself means we're at the end of the buffer and
13750 there is nothing more to get. */
13754 /* Convert the reply into binary. Limit the number of bytes to
13755 convert according to our passed-in buffer size, rather than
13756 what was returned in the packet; if the target is
13757 unexpectedly generous and gives us a bigger reply than we
13758 asked for, we don't want to crash. */
13759 rslt
= hex2bin (reply
, buf
, len
);
13763 /* Something went wrong, flag as an error. */
13768 remote_target::set_disconnected_tracing (int val
)
13770 struct remote_state
*rs
= get_remote_state ();
13772 if (packet_support (PACKET_DisconnectedTracing_feature
) == PACKET_ENABLE
)
13776 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13777 "QTDisconnected:%x", val
);
13779 reply
= remote_get_noisy_reply ();
13780 if (*reply
== '\0')
13781 error (_("Target does not support this command."));
13782 if (strcmp (reply
, "OK") != 0)
13783 error (_("Bogus reply from target: %s"), reply
);
13786 warning (_("Target does not support disconnected tracing."));
13790 remote_target::core_of_thread (ptid_t ptid
)
13792 thread_info
*info
= find_thread_ptid (this, ptid
);
13794 if (info
!= NULL
&& info
->priv
!= NULL
)
13795 return get_remote_thread_info (info
)->core
;
13801 remote_target::set_circular_trace_buffer (int val
)
13803 struct remote_state
*rs
= get_remote_state ();
13806 xsnprintf (rs
->buf
.data (), get_remote_packet_size (),
13807 "QTBuffer:circular:%x", val
);
13809 reply
= remote_get_noisy_reply ();
13810 if (*reply
== '\0')
13811 error (_("Target does not support this command."));
13812 if (strcmp (reply
, "OK") != 0)
13813 error (_("Bogus reply from target: %s"), reply
);
13817 remote_target::traceframe_info ()
13819 gdb::optional
<gdb::char_vector
> text
13820 = target_read_stralloc (current_inferior ()->top_target (),
13821 TARGET_OBJECT_TRACEFRAME_INFO
,
13824 return parse_traceframe_info (text
->data ());
13829 /* Handle the qTMinFTPILen packet. Returns the minimum length of
13830 instruction on which a fast tracepoint may be placed. Returns -1
13831 if the packet is not supported, and 0 if the minimum instruction
13832 length is unknown. */
13835 remote_target::get_min_fast_tracepoint_insn_len ()
13837 struct remote_state
*rs
= get_remote_state ();
13840 /* If we're not debugging a process yet, the IPA can't be
13842 if (!target_has_execution ())
13845 /* Make sure the remote is pointing at the right process. */
13846 set_general_process ();
13848 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "qTMinFTPILen");
13850 reply
= remote_get_noisy_reply ();
13851 if (*reply
== '\0')
13855 ULONGEST min_insn_len
;
13857 unpack_varlen_hex (reply
, &min_insn_len
);
13859 return (int) min_insn_len
;
13864 remote_target::set_trace_buffer_size (LONGEST val
)
13866 if (packet_support (PACKET_QTBuffer_size
) != PACKET_DISABLE
)
13868 struct remote_state
*rs
= get_remote_state ();
13869 char *buf
= rs
->buf
.data ();
13870 char *endbuf
= buf
+ get_remote_packet_size ();
13871 enum packet_result result
;
13873 gdb_assert (val
>= 0 || val
== -1);
13874 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTBuffer:size:");
13875 /* Send -1 as literal "-1" to avoid host size dependency. */
13879 buf
+= hexnumstr (buf
, (ULONGEST
) -val
);
13882 buf
+= hexnumstr (buf
, (ULONGEST
) val
);
13885 remote_get_noisy_reply ();
13886 result
= packet_ok (rs
->buf
,
13887 &remote_protocol_packets
[PACKET_QTBuffer_size
]);
13889 if (result
!= PACKET_OK
)
13890 warning (_("Bogus reply from target: %s"), rs
->buf
.data ());
13895 remote_target::set_trace_notes (const char *user
, const char *notes
,
13896 const char *stop_notes
)
13898 struct remote_state
*rs
= get_remote_state ();
13900 char *buf
= rs
->buf
.data ();
13901 char *endbuf
= buf
+ get_remote_packet_size ();
13904 buf
+= xsnprintf (buf
, endbuf
- buf
, "QTNotes:");
13907 buf
+= xsnprintf (buf
, endbuf
- buf
, "user:");
13908 nbytes
= bin2hex ((gdb_byte
*) user
, buf
, strlen (user
));
13914 buf
+= xsnprintf (buf
, endbuf
- buf
, "notes:");
13915 nbytes
= bin2hex ((gdb_byte
*) notes
, buf
, strlen (notes
));
13921 buf
+= xsnprintf (buf
, endbuf
- buf
, "tstop:");
13922 nbytes
= bin2hex ((gdb_byte
*) stop_notes
, buf
, strlen (stop_notes
));
13926 /* Ensure the buffer is terminated. */
13930 reply
= remote_get_noisy_reply ();
13931 if (*reply
== '\0')
13934 if (strcmp (reply
, "OK") != 0)
13935 error (_("Bogus reply from target: %s"), reply
);
13941 remote_target::use_agent (bool use
)
13943 if (packet_support (PACKET_QAgent
) != PACKET_DISABLE
)
13945 struct remote_state
*rs
= get_remote_state ();
13947 /* If the stub supports QAgent. */
13948 xsnprintf (rs
->buf
.data (), get_remote_packet_size (), "QAgent:%d", use
);
13950 getpkt (&rs
->buf
, 0);
13952 if (strcmp (rs
->buf
.data (), "OK") == 0)
13963 remote_target::can_use_agent ()
13965 return (packet_support (PACKET_QAgent
) != PACKET_DISABLE
);
13968 struct btrace_target_info
13970 /* The ptid of the traced thread. */
13973 /* The obtained branch trace configuration. */
13974 struct btrace_config conf
;
13977 /* Reset our idea of our target's btrace configuration. */
13980 remote_btrace_reset (remote_state
*rs
)
13982 memset (&rs
->btrace_config
, 0, sizeof (rs
->btrace_config
));
13985 /* Synchronize the configuration with the target. */
13988 remote_target::btrace_sync_conf (const btrace_config
*conf
)
13990 struct packet_config
*packet
;
13991 struct remote_state
*rs
;
13992 char *buf
, *pos
, *endbuf
;
13994 rs
= get_remote_state ();
13995 buf
= rs
->buf
.data ();
13996 endbuf
= buf
+ get_remote_packet_size ();
13998 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
];
13999 if (packet_config_support (packet
) == PACKET_ENABLE
14000 && conf
->bts
.size
!= rs
->btrace_config
.bts
.size
)
14003 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14007 getpkt (&rs
->buf
, 0);
14009 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14011 if (buf
[0] == 'E' && buf
[1] == '.')
14012 error (_("Failed to configure the BTS buffer size: %s"), buf
+ 2);
14014 error (_("Failed to configure the BTS buffer size."));
14017 rs
->btrace_config
.bts
.size
= conf
->bts
.size
;
14020 packet
= &remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
];
14021 if (packet_config_support (packet
) == PACKET_ENABLE
14022 && conf
->pt
.size
!= rs
->btrace_config
.pt
.size
)
14025 pos
+= xsnprintf (pos
, endbuf
- pos
, "%s=0x%x", packet
->name
,
14029 getpkt (&rs
->buf
, 0);
14031 if (packet_ok (buf
, packet
) == PACKET_ERROR
)
14033 if (buf
[0] == 'E' && buf
[1] == '.')
14034 error (_("Failed to configure the trace buffer size: %s"), buf
+ 2);
14036 error (_("Failed to configure the trace buffer size."));
14039 rs
->btrace_config
.pt
.size
= conf
->pt
.size
;
14043 /* Read the current thread's btrace configuration from the target and
14044 store it into CONF. */
14047 btrace_read_config (struct btrace_config
*conf
)
14049 gdb::optional
<gdb::char_vector
> xml
14050 = target_read_stralloc (current_inferior ()->top_target (),
14051 TARGET_OBJECT_BTRACE_CONF
, "");
14053 parse_xml_btrace_conf (conf
, xml
->data ());
14056 /* Maybe reopen target btrace. */
14059 remote_target::remote_btrace_maybe_reopen ()
14061 struct remote_state
*rs
= get_remote_state ();
14062 int btrace_target_pushed
= 0;
14063 #if !defined (HAVE_LIBIPT)
14067 /* Don't bother walking the entirety of the remote thread list when
14068 we know the feature isn't supported by the remote. */
14069 if (packet_support (PACKET_qXfer_btrace_conf
) != PACKET_ENABLE
)
14072 scoped_restore_current_thread restore_thread
;
14074 for (thread_info
*tp
: all_non_exited_threads (this))
14076 set_general_thread (tp
->ptid
);
14078 memset (&rs
->btrace_config
, 0x00, sizeof (struct btrace_config
));
14079 btrace_read_config (&rs
->btrace_config
);
14081 if (rs
->btrace_config
.format
== BTRACE_FORMAT_NONE
)
14084 #if !defined (HAVE_LIBIPT)
14085 if (rs
->btrace_config
.format
== BTRACE_FORMAT_PT
)
14090 warning (_("Target is recording using Intel Processor Trace "
14091 "but support was disabled at compile time."));
14096 #endif /* !defined (HAVE_LIBIPT) */
14098 /* Push target, once, but before anything else happens. This way our
14099 changes to the threads will be cleaned up by unpushing the target
14100 in case btrace_read_config () throws. */
14101 if (!btrace_target_pushed
)
14103 btrace_target_pushed
= 1;
14104 record_btrace_push_target ();
14105 printf_filtered (_("Target is recording using %s.\n"),
14106 btrace_format_string (rs
->btrace_config
.format
));
14109 tp
->btrace
.target
= XCNEW (struct btrace_target_info
);
14110 tp
->btrace
.target
->ptid
= tp
->ptid
;
14111 tp
->btrace
.target
->conf
= rs
->btrace_config
;
14115 /* Enable branch tracing. */
14117 struct btrace_target_info
*
14118 remote_target::enable_btrace (ptid_t ptid
, const struct btrace_config
*conf
)
14120 struct btrace_target_info
*tinfo
= NULL
;
14121 struct packet_config
*packet
= NULL
;
14122 struct remote_state
*rs
= get_remote_state ();
14123 char *buf
= rs
->buf
.data ();
14124 char *endbuf
= buf
+ get_remote_packet_size ();
14126 switch (conf
->format
)
14128 case BTRACE_FORMAT_BTS
:
14129 packet
= &remote_protocol_packets
[PACKET_Qbtrace_bts
];
14132 case BTRACE_FORMAT_PT
:
14133 packet
= &remote_protocol_packets
[PACKET_Qbtrace_pt
];
14137 if (packet
== NULL
|| packet_config_support (packet
) != PACKET_ENABLE
)
14138 error (_("Target does not support branch tracing."));
14140 btrace_sync_conf (conf
);
14142 set_general_thread (ptid
);
14144 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14146 getpkt (&rs
->buf
, 0);
14148 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14150 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14151 error (_("Could not enable branch tracing for %s: %s"),
14152 target_pid_to_str (ptid
).c_str (), &rs
->buf
[2]);
14154 error (_("Could not enable branch tracing for %s."),
14155 target_pid_to_str (ptid
).c_str ());
14158 tinfo
= XCNEW (struct btrace_target_info
);
14159 tinfo
->ptid
= ptid
;
14161 /* If we fail to read the configuration, we lose some information, but the
14162 tracing itself is not impacted. */
14165 btrace_read_config (&tinfo
->conf
);
14167 catch (const gdb_exception_error
&err
)
14169 if (err
.message
!= NULL
)
14170 warning ("%s", err
.what ());
14176 /* Disable branch tracing. */
14179 remote_target::disable_btrace (struct btrace_target_info
*tinfo
)
14181 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_Qbtrace_off
];
14182 struct remote_state
*rs
= get_remote_state ();
14183 char *buf
= rs
->buf
.data ();
14184 char *endbuf
= buf
+ get_remote_packet_size ();
14186 if (packet_config_support (packet
) != PACKET_ENABLE
)
14187 error (_("Target does not support branch tracing."));
14189 set_general_thread (tinfo
->ptid
);
14191 buf
+= xsnprintf (buf
, endbuf
- buf
, "%s", packet
->name
);
14193 getpkt (&rs
->buf
, 0);
14195 if (packet_ok (rs
->buf
, packet
) == PACKET_ERROR
)
14197 if (rs
->buf
[0] == 'E' && rs
->buf
[1] == '.')
14198 error (_("Could not disable branch tracing for %s: %s"),
14199 target_pid_to_str (tinfo
->ptid
).c_str (), &rs
->buf
[2]);
14201 error (_("Could not disable branch tracing for %s."),
14202 target_pid_to_str (tinfo
->ptid
).c_str ());
14208 /* Teardown branch tracing. */
14211 remote_target::teardown_btrace (struct btrace_target_info
*tinfo
)
14213 /* We must not talk to the target during teardown. */
14217 /* Read the branch trace. */
14220 remote_target::read_btrace (struct btrace_data
*btrace
,
14221 struct btrace_target_info
*tinfo
,
14222 enum btrace_read_type type
)
14224 struct packet_config
*packet
= &remote_protocol_packets
[PACKET_qXfer_btrace
];
14227 if (packet_config_support (packet
) != PACKET_ENABLE
)
14228 error (_("Target does not support branch tracing."));
14230 #if !defined(HAVE_LIBEXPAT)
14231 error (_("Cannot process branch tracing result. XML parsing not supported."));
14236 case BTRACE_READ_ALL
:
14239 case BTRACE_READ_NEW
:
14242 case BTRACE_READ_DELTA
:
14246 internal_error (__FILE__
, __LINE__
,
14247 _("Bad branch tracing read type: %u."),
14248 (unsigned int) type
);
14251 gdb::optional
<gdb::char_vector
> xml
14252 = target_read_stralloc (current_inferior ()->top_target (),
14253 TARGET_OBJECT_BTRACE
, annex
);
14255 return BTRACE_ERR_UNKNOWN
;
14257 parse_xml_btrace (btrace
, xml
->data ());
14259 return BTRACE_ERR_NONE
;
14262 const struct btrace_config
*
14263 remote_target::btrace_conf (const struct btrace_target_info
*tinfo
)
14265 return &tinfo
->conf
;
14269 remote_target::augmented_libraries_svr4_read ()
14271 return (packet_support (PACKET_augmented_libraries_svr4_read_feature
)
14275 /* Implementation of to_load. */
14278 remote_target::load (const char *name
, int from_tty
)
14280 generic_load (name
, from_tty
);
14283 /* Accepts an integer PID; returns a string representing a file that
14284 can be opened on the remote side to get the symbols for the child
14285 process. Returns NULL if the operation is not supported. */
14288 remote_target::pid_to_exec_file (int pid
)
14290 static gdb::optional
<gdb::char_vector
> filename
;
14291 char *annex
= NULL
;
14293 if (packet_support (PACKET_qXfer_exec_file
) != PACKET_ENABLE
)
14296 inferior
*inf
= find_inferior_pid (this, pid
);
14298 internal_error (__FILE__
, __LINE__
,
14299 _("not currently attached to process %d"), pid
);
14301 if (!inf
->fake_pid_p
)
14303 const int annex_size
= 9;
14305 annex
= (char *) alloca (annex_size
);
14306 xsnprintf (annex
, annex_size
, "%x", pid
);
14309 filename
= target_read_stralloc (current_inferior ()->top_target (),
14310 TARGET_OBJECT_EXEC_FILE
, annex
);
14312 return filename
? filename
->data () : nullptr;
14315 /* Implement the to_can_do_single_step target_ops method. */
14318 remote_target::can_do_single_step ()
14320 /* We can only tell whether target supports single step or not by
14321 supported s and S vCont actions if the stub supports vContSupported
14322 feature. If the stub doesn't support vContSupported feature,
14323 we have conservatively to think target doesn't supports single
14325 if (packet_support (PACKET_vContSupported
) == PACKET_ENABLE
)
14327 struct remote_state
*rs
= get_remote_state ();
14329 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14330 remote_vcont_probe ();
14332 return rs
->supports_vCont
.s
&& rs
->supports_vCont
.S
;
14338 /* Implementation of the to_execution_direction method for the remote
14341 enum exec_direction_kind
14342 remote_target::execution_direction ()
14344 struct remote_state
*rs
= get_remote_state ();
14346 return rs
->last_resume_exec_dir
;
14349 /* Return pointer to the thread_info struct which corresponds to
14350 THREAD_HANDLE (having length HANDLE_LEN). */
14353 remote_target::thread_handle_to_thread_info (const gdb_byte
*thread_handle
,
14357 for (thread_info
*tp
: all_non_exited_threads (this))
14359 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14361 if (tp
->inf
== inf
&& priv
!= NULL
)
14363 if (handle_len
!= priv
->thread_handle
.size ())
14364 error (_("Thread handle size mismatch: %d vs %zu (from remote)"),
14365 handle_len
, priv
->thread_handle
.size ());
14366 if (memcmp (thread_handle
, priv
->thread_handle
.data (),
14376 remote_target::thread_info_to_thread_handle (struct thread_info
*tp
)
14378 remote_thread_info
*priv
= get_remote_thread_info (tp
);
14379 return priv
->thread_handle
;
14383 remote_target::can_async_p ()
14385 struct remote_state
*rs
= get_remote_state ();
14387 /* We don't go async if the user has explicitly prevented it with the
14388 "maint set target-async" command. */
14389 if (!target_async_permitted
)
14392 /* We're async whenever the serial device is. */
14393 return serial_can_async_p (rs
->remote_desc
);
14397 remote_target::is_async_p ()
14399 struct remote_state
*rs
= get_remote_state ();
14401 if (!target_async_permitted
)
14402 /* We only enable async when the user specifically asks for it. */
14405 /* We're async whenever the serial device is. */
14406 return serial_is_async_p (rs
->remote_desc
);
14409 /* Pass the SERIAL event on and up to the client. One day this code
14410 will be able to delay notifying the client of an event until the
14411 point where an entire packet has been received. */
14413 static serial_event_ftype remote_async_serial_handler
;
14416 remote_async_serial_handler (struct serial
*scb
, void *context
)
14418 /* Don't propogate error information up to the client. Instead let
14419 the client find out about the error by querying the target. */
14420 inferior_event_handler (INF_REG_EVENT
);
14424 remote_async_inferior_event_handler (gdb_client_data data
)
14426 inferior_event_handler (INF_REG_EVENT
);
14430 remote_target::async_wait_fd ()
14432 struct remote_state
*rs
= get_remote_state ();
14433 return rs
->remote_desc
->fd
;
14437 remote_target::async (int enable
)
14439 struct remote_state
*rs
= get_remote_state ();
14443 serial_async (rs
->remote_desc
, remote_async_serial_handler
, rs
);
14445 /* If there are pending events in the stop reply queue tell the
14446 event loop to process them. */
14447 if (!rs
->stop_reply_queue
.empty ())
14448 mark_async_event_handler (rs
->remote_async_inferior_event_token
);
14449 /* For simplicity, below we clear the pending events token
14450 without remembering whether it is marked, so here we always
14451 mark it. If there's actually no pending notification to
14452 process, this ends up being a no-op (other than a spurious
14453 event-loop wakeup). */
14454 if (target_is_non_stop_p ())
14455 mark_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14459 serial_async (rs
->remote_desc
, NULL
, NULL
);
14460 /* If the core is disabling async, it doesn't want to be
14461 disturbed with target events. Clear all async event sources
14463 clear_async_event_handler (rs
->remote_async_inferior_event_token
);
14464 if (target_is_non_stop_p ())
14465 clear_async_event_handler (rs
->notif_state
->get_pending_events_token
);
14469 /* Implementation of the to_thread_events method. */
14472 remote_target::thread_events (int enable
)
14474 struct remote_state
*rs
= get_remote_state ();
14475 size_t size
= get_remote_packet_size ();
14477 if (packet_support (PACKET_QThreadEvents
) == PACKET_DISABLE
)
14480 xsnprintf (rs
->buf
.data (), size
, "QThreadEvents:%x", enable
? 1 : 0);
14482 getpkt (&rs
->buf
, 0);
14484 switch (packet_ok (rs
->buf
,
14485 &remote_protocol_packets
[PACKET_QThreadEvents
]))
14488 if (strcmp (rs
->buf
.data (), "OK") != 0)
14489 error (_("Remote refused setting thread events: %s"), rs
->buf
.data ());
14492 warning (_("Remote failure reply: %s"), rs
->buf
.data ());
14494 case PACKET_UNKNOWN
:
14500 show_remote_cmd (const char *args
, int from_tty
)
14502 /* We can't just use cmd_show_list here, because we want to skip
14503 the redundant "show remote Z-packet" and the legacy aliases. */
14504 struct cmd_list_element
*list
= remote_show_cmdlist
;
14505 struct ui_out
*uiout
= current_uiout
;
14507 ui_out_emit_tuple
tuple_emitter (uiout
, "showlist");
14508 for (; list
!= NULL
; list
= list
->next
)
14509 if (strcmp (list
->name
, "Z-packet") == 0)
14511 else if (list
->type
== not_set_cmd
)
14512 /* Alias commands are exactly like the original, except they
14513 don't have the normal type. */
14517 ui_out_emit_tuple
option_emitter (uiout
, "option");
14519 uiout
->field_string ("name", list
->name
);
14520 uiout
->text (": ");
14521 if (list
->type
== show_cmd
)
14522 do_show_command (NULL
, from_tty
, list
);
14524 cmd_func (list
, NULL
, from_tty
);
14529 /* Function to be called whenever a new objfile (shlib) is detected. */
14531 remote_new_objfile (struct objfile
*objfile
)
14533 remote_target
*remote
= get_current_remote_target ();
14535 /* First, check whether the current inferior's process target is a remote
14537 if (remote
== nullptr)
14540 /* When we are attaching or handling a fork child and the shared library
14541 subsystem reads the list of loaded libraries, we receive new objfile
14542 events in between each found library. The libraries are read in an
14543 undefined order, so if we gave the remote side a chance to look up
14544 symbols between each objfile, we might give it an inconsistent picture
14545 of the inferior. It could appear that a library A appears loaded but
14546 a library B does not, even though library A requires library B. That
14547 would present a state that couldn't normally exist in the inferior.
14549 So, skip these events, we'll give the remote a chance to look up symbols
14550 once all the loaded libraries and their symbols are known to GDB. */
14551 if (current_inferior ()->in_initial_library_scan
)
14554 remote
->remote_check_symbols ();
14557 /* Pull all the tracepoints defined on the target and create local
14558 data structures representing them. We don't want to create real
14559 tracepoints yet, we don't want to mess up the user's existing
14563 remote_target::upload_tracepoints (struct uploaded_tp
**utpp
)
14565 struct remote_state
*rs
= get_remote_state ();
14568 /* Ask for a first packet of tracepoint definition. */
14570 getpkt (&rs
->buf
, 0);
14571 p
= rs
->buf
.data ();
14572 while (*p
&& *p
!= 'l')
14574 parse_tracepoint_definition (p
, utpp
);
14575 /* Ask for another packet of tracepoint definition. */
14577 getpkt (&rs
->buf
, 0);
14578 p
= rs
->buf
.data ();
14584 remote_target::upload_trace_state_variables (struct uploaded_tsv
**utsvp
)
14586 struct remote_state
*rs
= get_remote_state ();
14589 /* Ask for a first packet of variable definition. */
14591 getpkt (&rs
->buf
, 0);
14592 p
= rs
->buf
.data ();
14593 while (*p
&& *p
!= 'l')
14595 parse_tsv_definition (p
, utsvp
);
14596 /* Ask for another packet of variable definition. */
14598 getpkt (&rs
->buf
, 0);
14599 p
= rs
->buf
.data ();
14604 /* The "set/show range-stepping" show hook. */
14607 show_range_stepping (struct ui_file
*file
, int from_tty
,
14608 struct cmd_list_element
*c
,
14611 fprintf_filtered (file
,
14612 _("Debugger's willingness to use range stepping "
14613 "is %s.\n"), value
);
14616 /* Return true if the vCont;r action is supported by the remote
14620 remote_target::vcont_r_supported ()
14622 if (packet_support (PACKET_vCont
) == PACKET_SUPPORT_UNKNOWN
)
14623 remote_vcont_probe ();
14625 return (packet_support (PACKET_vCont
) == PACKET_ENABLE
14626 && get_remote_state ()->supports_vCont
.r
);
14629 /* The "set/show range-stepping" set hook. */
14632 set_range_stepping (const char *ignore_args
, int from_tty
,
14633 struct cmd_list_element
*c
)
14635 /* When enabling, check whether range stepping is actually supported
14636 by the target, and warn if not. */
14637 if (use_range_stepping
)
14639 remote_target
*remote
= get_current_remote_target ();
14641 || !remote
->vcont_r_supported ())
14642 warning (_("Range stepping is not supported by the current target"));
14647 show_remote_debug (struct ui_file
*file
, int from_tty
,
14648 struct cmd_list_element
*c
, const char *value
)
14650 fprintf_filtered (file
, _("Debugging of remote protocol is %s.\n"),
14655 show_remote_timeout (struct ui_file
*file
, int from_tty
,
14656 struct cmd_list_element
*c
, const char *value
)
14658 fprintf_filtered (file
,
14659 _("Timeout limit to wait for target to respond is %s.\n"),
14663 /* Implement the "supports_memory_tagging" target_ops method. */
14666 remote_target::supports_memory_tagging ()
14668 return remote_memory_tagging_p ();
14671 /* Create the qMemTags packet given ADDRESS, LEN and TYPE. */
14674 create_fetch_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14675 size_t len
, int type
)
14677 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14679 std::string request
= string_printf ("qMemTags:%s,%s:%s",
14680 phex_nz (address
, addr_size
),
14681 phex_nz (len
, sizeof (len
)),
14682 phex_nz (type
, sizeof (type
)));
14684 strcpy (packet
.data (), request
.c_str ());
14687 /* Parse the qMemTags packet reply into TAGS.
14689 Return true if successful, false otherwise. */
14692 parse_fetch_memtags_reply (const gdb::char_vector
&reply
,
14693 gdb::byte_vector
&tags
)
14695 if (reply
.empty () || reply
[0] == 'E' || reply
[0] != 'm')
14698 /* Copy the tag data. */
14699 tags
= hex2bin (reply
.data () + 1);
14704 /* Create the QMemTags packet given ADDRESS, LEN, TYPE and TAGS. */
14707 create_store_memtags_request (gdb::char_vector
&packet
, CORE_ADDR address
,
14708 size_t len
, int type
,
14709 const gdb::byte_vector
&tags
)
14711 int addr_size
= gdbarch_addr_bit (target_gdbarch ()) / 8;
14713 /* Put together the main packet, address and length. */
14714 std::string request
= string_printf ("QMemTags:%s,%s:%s:",
14715 phex_nz (address
, addr_size
),
14716 phex_nz (len
, sizeof (len
)),
14717 phex_nz (type
, sizeof (type
)));
14718 request
+= bin2hex (tags
.data (), tags
.size ());
14720 /* Check if we have exceeded the maximum packet size. */
14721 if (packet
.size () < request
.length ())
14722 error (_("Contents too big for packet QMemTags."));
14724 strcpy (packet
.data (), request
.c_str ());
14727 /* Implement the "fetch_memtags" target_ops method. */
14730 remote_target::fetch_memtags (CORE_ADDR address
, size_t len
,
14731 gdb::byte_vector
&tags
, int type
)
14733 /* Make sure the qMemTags packet is supported. */
14734 if (!remote_memory_tagging_p ())
14735 gdb_assert_not_reached ("remote fetch_memtags called with packet disabled");
14737 struct remote_state
*rs
= get_remote_state ();
14739 create_fetch_memtags_request (rs
->buf
, address
, len
, type
);
14742 getpkt (&rs
->buf
, 0);
14744 return parse_fetch_memtags_reply (rs
->buf
, tags
);
14747 /* Implement the "store_memtags" target_ops method. */
14750 remote_target::store_memtags (CORE_ADDR address
, size_t len
,
14751 const gdb::byte_vector
&tags
, int type
)
14753 /* Make sure the QMemTags packet is supported. */
14754 if (!remote_memory_tagging_p ())
14755 gdb_assert_not_reached ("remote store_memtags called with packet disabled");
14757 struct remote_state
*rs
= get_remote_state ();
14759 create_store_memtags_request (rs
->buf
, address
, len
, type
, tags
);
14762 getpkt (&rs
->buf
, 0);
14764 /* Verify if the request was successful. */
14765 return packet_check_result (rs
->buf
.data ()) == PACKET_OK
;
14768 /* Return true if remote target T is non-stop. */
14771 remote_target_is_non_stop_p (remote_target
*t
)
14773 scoped_restore_current_thread restore_thread
;
14774 switch_to_target_no_thread (t
);
14776 return target_is_non_stop_p ();
14781 namespace selftests
{
14784 test_memory_tagging_functions ()
14786 remote_target remote
;
14788 struct packet_config
*config
14789 = &remote_protocol_packets
[PACKET_memory_tagging_feature
];
14791 scoped_restore restore_memtag_support_
14792 = make_scoped_restore (&config
->support
);
14794 /* Test memory tagging packet support. */
14795 config
->support
= PACKET_SUPPORT_UNKNOWN
;
14796 SELF_CHECK (remote
.supports_memory_tagging () == false);
14797 config
->support
= PACKET_DISABLE
;
14798 SELF_CHECK (remote
.supports_memory_tagging () == false);
14799 config
->support
= PACKET_ENABLE
;
14800 SELF_CHECK (remote
.supports_memory_tagging () == true);
14802 /* Setup testing. */
14803 gdb::char_vector packet
;
14804 gdb::byte_vector tags
, bv
;
14805 std::string expected
, reply
;
14806 packet
.resize (32000);
14808 /* Test creating a qMemTags request. */
14810 expected
= "qMemTags:0,0:0";
14811 create_fetch_memtags_request (packet
, 0x0, 0x0, 0);
14812 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14814 expected
= "qMemTags:deadbeef,10:1";
14815 create_fetch_memtags_request (packet
, 0xdeadbeef, 16, 1);
14816 SELF_CHECK (strcmp (packet
.data (), expected
.c_str ()) == 0);
14818 /* Test parsing a qMemTags reply. */
14820 /* Error reply, tags vector unmodified. */
14822 strcpy (packet
.data (), reply
.c_str ());
14824 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == false);
14825 SELF_CHECK (tags
.size () == 0);
14827 /* Valid reply, tags vector updated. */
14831 for (int i
= 0; i
< 5; i
++)
14834 reply
= "m" + bin2hex (bv
.data (), bv
.size ());
14835 strcpy (packet
.data (), reply
.c_str ());
14837 SELF_CHECK (parse_fetch_memtags_reply (packet
, tags
) == true);
14838 SELF_CHECK (tags
.size () == 5);
14840 for (int i
= 0; i
< 5; i
++)
14841 SELF_CHECK (tags
[i
] == i
);
14843 /* Test creating a QMemTags request. */
14845 /* Empty tag data. */
14847 expected
= "QMemTags:0,0:0:";
14848 create_store_memtags_request (packet
, 0x0, 0x0, 0, tags
);
14849 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14850 expected
.length ()) == 0);
14852 /* Non-empty tag data. */
14854 for (int i
= 0; i
< 5; i
++)
14855 tags
.push_back (i
);
14856 expected
= "QMemTags:deadbeef,ff:1:0001020304";
14857 create_store_memtags_request (packet
, 0xdeadbeef, 255, 1, tags
);
14858 SELF_CHECK (memcmp (packet
.data (), expected
.c_str (),
14859 expected
.length ()) == 0);
14862 } // namespace selftests
14863 #endif /* GDB_SELF_TEST */
14865 void _initialize_remote ();
14867 _initialize_remote ()
14869 /* architecture specific data */
14870 remote_g_packet_data_handle
=
14871 gdbarch_data_register_pre_init (remote_g_packet_data_init
);
14873 add_target (remote_target_info
, remote_target::open
);
14874 add_target (extended_remote_target_info
, extended_remote_target::open
);
14876 /* Hook into new objfile notification. */
14877 gdb::observers::new_objfile
.attach (remote_new_objfile
, "remote");
14880 init_remote_threadtests ();
14883 /* set/show remote ... */
14885 add_basic_prefix_cmd ("remote", class_maintenance
, _("\
14886 Remote protocol specific variables.\n\
14887 Configure various remote-protocol specific variables such as\n\
14888 the packets being used."),
14889 &remote_set_cmdlist
,
14890 0 /* allow-unknown */, &setlist
);
14891 add_prefix_cmd ("remote", class_maintenance
, show_remote_cmd
, _("\
14892 Remote protocol specific variables.\n\
14893 Configure various remote-protocol specific variables such as\n\
14894 the packets being used."),
14895 &remote_show_cmdlist
,
14896 0 /* allow-unknown */, &showlist
);
14898 add_cmd ("compare-sections", class_obscure
, compare_sections_command
, _("\
14899 Compare section data on target to the exec file.\n\
14900 Argument is a single section name (default: all loaded sections).\n\
14901 To compare only read-only loaded sections, specify the -r option."),
14904 add_cmd ("packet", class_maintenance
, packet_command
, _("\
14905 Send an arbitrary packet to a remote target.\n\
14906 maintenance packet TEXT\n\
14907 If GDB is talking to an inferior via the GDB serial protocol, then\n\
14908 this command sends the string TEXT to the inferior, and displays the\n\
14909 response packet. GDB supplies the initial `$' character, and the\n\
14910 terminating `#' character and checksum."),
14913 set_show_commands remotebreak_cmds
14914 = add_setshow_boolean_cmd ("remotebreak", no_class
, &remote_break
, _("\
14915 Set whether to send break if interrupted."), _("\
14916 Show whether to send break if interrupted."), _("\
14917 If set, a break, instead of a cntrl-c, is sent to the remote target."),
14918 set_remotebreak
, show_remotebreak
,
14919 &setlist
, &showlist
);
14920 deprecate_cmd (remotebreak_cmds
.set
, "set remote interrupt-sequence");
14921 deprecate_cmd (remotebreak_cmds
.show
, "show remote interrupt-sequence");
14923 add_setshow_enum_cmd ("interrupt-sequence", class_support
,
14924 interrupt_sequence_modes
, &interrupt_sequence_mode
,
14926 Set interrupt sequence to remote target."), _("\
14927 Show interrupt sequence to remote target."), _("\
14928 Valid value is \"Ctrl-C\", \"BREAK\" or \"BREAK-g\". The default is \"Ctrl-C\"."),
14929 NULL
, show_interrupt_sequence
,
14930 &remote_set_cmdlist
,
14931 &remote_show_cmdlist
);
14933 add_setshow_boolean_cmd ("interrupt-on-connect", class_support
,
14934 &interrupt_on_connect
, _("\
14935 Set whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14936 Show whether interrupt-sequence is sent to remote target when gdb connects to."), _("\
14937 If set, interrupt sequence is sent to remote target."),
14939 &remote_set_cmdlist
, &remote_show_cmdlist
);
14941 /* Install commands for configuring memory read/write packets. */
14943 add_cmd ("remotewritesize", no_class
, set_memory_write_packet_size
, _("\
14944 Set the maximum number of bytes per memory write packet (deprecated)."),
14946 add_cmd ("remotewritesize", no_class
, show_memory_write_packet_size
, _("\
14947 Show the maximum number of bytes per memory write packet (deprecated)."),
14949 add_cmd ("memory-write-packet-size", no_class
,
14950 set_memory_write_packet_size
, _("\
14951 Set the maximum number of bytes per memory-write packet.\n\
14952 Specify the number of bytes in a packet or 0 (zero) for the\n\
14953 default packet size. The actual limit is further reduced\n\
14954 dependent on the target. Specify ``fixed'' to disable the\n\
14955 further restriction and ``limit'' to enable that restriction."),
14956 &remote_set_cmdlist
);
14957 add_cmd ("memory-read-packet-size", no_class
,
14958 set_memory_read_packet_size
, _("\
14959 Set the maximum number of bytes per memory-read packet.\n\
14960 Specify the number of bytes in a packet or 0 (zero) for the\n\
14961 default packet size. The actual limit is further reduced\n\
14962 dependent on the target. Specify ``fixed'' to disable the\n\
14963 further restriction and ``limit'' to enable that restriction."),
14964 &remote_set_cmdlist
);
14965 add_cmd ("memory-write-packet-size", no_class
,
14966 show_memory_write_packet_size
,
14967 _("Show the maximum number of bytes per memory-write packet."),
14968 &remote_show_cmdlist
);
14969 add_cmd ("memory-read-packet-size", no_class
,
14970 show_memory_read_packet_size
,
14971 _("Show the maximum number of bytes per memory-read packet."),
14972 &remote_show_cmdlist
);
14974 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-limit", no_class
,
14975 &remote_hw_watchpoint_limit
, _("\
14976 Set the maximum number of target hardware watchpoints."), _("\
14977 Show the maximum number of target hardware watchpoints."), _("\
14978 Specify \"unlimited\" for unlimited hardware watchpoints."),
14979 NULL
, show_hardware_watchpoint_limit
,
14980 &remote_set_cmdlist
,
14981 &remote_show_cmdlist
);
14982 add_setshow_zuinteger_unlimited_cmd ("hardware-watchpoint-length-limit",
14984 &remote_hw_watchpoint_length_limit
, _("\
14985 Set the maximum length (in bytes) of a target hardware watchpoint."), _("\
14986 Show the maximum length (in bytes) of a target hardware watchpoint."), _("\
14987 Specify \"unlimited\" to allow watchpoints of unlimited size."),
14988 NULL
, show_hardware_watchpoint_length_limit
,
14989 &remote_set_cmdlist
, &remote_show_cmdlist
);
14990 add_setshow_zuinteger_unlimited_cmd ("hardware-breakpoint-limit", no_class
,
14991 &remote_hw_breakpoint_limit
, _("\
14992 Set the maximum number of target hardware breakpoints."), _("\
14993 Show the maximum number of target hardware breakpoints."), _("\
14994 Specify \"unlimited\" for unlimited hardware breakpoints."),
14995 NULL
, show_hardware_breakpoint_limit
,
14996 &remote_set_cmdlist
, &remote_show_cmdlist
);
14998 add_setshow_zuinteger_cmd ("remoteaddresssize", class_obscure
,
14999 &remote_address_size
, _("\
15000 Set the maximum size of the address (in bits) in a memory packet."), _("\
15001 Show the maximum size of the address (in bits) in a memory packet."), NULL
,
15003 NULL
, /* FIXME: i18n: */
15004 &setlist
, &showlist
);
15006 init_all_packet_configs ();
15008 add_packet_config_cmd (&remote_protocol_packets
[PACKET_X
],
15009 "X", "binary-download", 1);
15011 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCont
],
15012 "vCont", "verbose-resume", 0);
15014 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QPassSignals
],
15015 "QPassSignals", "pass-signals", 0);
15017 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QCatchSyscalls
],
15018 "QCatchSyscalls", "catch-syscalls", 0);
15020 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QProgramSignals
],
15021 "QProgramSignals", "program-signals", 0);
15023 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QSetWorkingDir
],
15024 "QSetWorkingDir", "set-working-dir", 0);
15026 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartupWithShell
],
15027 "QStartupWithShell", "startup-with-shell", 0);
15029 add_packet_config_cmd (&remote_protocol_packets
15030 [PACKET_QEnvironmentHexEncoded
],
15031 "QEnvironmentHexEncoded", "environment-hex-encoded",
15034 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentReset
],
15035 "QEnvironmentReset", "environment-reset",
15038 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QEnvironmentUnset
],
15039 "QEnvironmentUnset", "environment-unset",
15042 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSymbol
],
15043 "qSymbol", "symbol-lookup", 0);
15045 add_packet_config_cmd (&remote_protocol_packets
[PACKET_P
],
15046 "P", "set-register", 1);
15048 add_packet_config_cmd (&remote_protocol_packets
[PACKET_p
],
15049 "p", "fetch-register", 1);
15051 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z0
],
15052 "Z0", "software-breakpoint", 0);
15054 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z1
],
15055 "Z1", "hardware-breakpoint", 0);
15057 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z2
],
15058 "Z2", "write-watchpoint", 0);
15060 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z3
],
15061 "Z3", "read-watchpoint", 0);
15063 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Z4
],
15064 "Z4", "access-watchpoint", 0);
15066 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_auxv
],
15067 "qXfer:auxv:read", "read-aux-vector", 0);
15069 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_exec_file
],
15070 "qXfer:exec-file:read", "pid-to-exec-file", 0);
15072 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_features
],
15073 "qXfer:features:read", "target-features", 0);
15075 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries
],
15076 "qXfer:libraries:read", "library-info", 0);
15078 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_libraries_svr4
],
15079 "qXfer:libraries-svr4:read", "library-info-svr4", 0);
15081 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_memory_map
],
15082 "qXfer:memory-map:read", "memory-map", 0);
15084 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_osdata
],
15085 "qXfer:osdata:read", "osdata", 0);
15087 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_threads
],
15088 "qXfer:threads:read", "threads", 0);
15090 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_read
],
15091 "qXfer:siginfo:read", "read-siginfo-object", 0);
15093 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_siginfo_write
],
15094 "qXfer:siginfo:write", "write-siginfo-object", 0);
15096 add_packet_config_cmd
15097 (&remote_protocol_packets
[PACKET_qXfer_traceframe_info
],
15098 "qXfer:traceframe-info:read", "traceframe-info", 0);
15100 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_uib
],
15101 "qXfer:uib:read", "unwind-info-block", 0);
15103 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTLSAddr
],
15104 "qGetTLSAddr", "get-thread-local-storage-address",
15107 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qGetTIBAddr
],
15108 "qGetTIBAddr", "get-thread-information-block-address",
15111 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bc
],
15112 "bc", "reverse-continue", 0);
15114 add_packet_config_cmd (&remote_protocol_packets
[PACKET_bs
],
15115 "bs", "reverse-step", 0);
15117 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSupported
],
15118 "qSupported", "supported-packets", 0);
15120 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qSearch_memory
],
15121 "qSearch:memory", "search-memory", 0);
15123 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qTStatus
],
15124 "qTStatus", "trace-status", 0);
15126 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_setfs
],
15127 "vFile:setfs", "hostio-setfs", 0);
15129 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_open
],
15130 "vFile:open", "hostio-open", 0);
15132 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pread
],
15133 "vFile:pread", "hostio-pread", 0);
15135 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_pwrite
],
15136 "vFile:pwrite", "hostio-pwrite", 0);
15138 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_close
],
15139 "vFile:close", "hostio-close", 0);
15141 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_unlink
],
15142 "vFile:unlink", "hostio-unlink", 0);
15144 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_readlink
],
15145 "vFile:readlink", "hostio-readlink", 0);
15147 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vFile_fstat
],
15148 "vFile:fstat", "hostio-fstat", 0);
15150 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vAttach
],
15151 "vAttach", "attach", 0);
15153 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vRun
],
15156 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QStartNoAckMode
],
15157 "QStartNoAckMode", "noack", 0);
15159 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vKill
],
15160 "vKill", "kill", 0);
15162 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qAttached
],
15163 "qAttached", "query-attached", 0);
15165 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalTracepoints
],
15166 "ConditionalTracepoints",
15167 "conditional-tracepoints", 0);
15169 add_packet_config_cmd (&remote_protocol_packets
[PACKET_ConditionalBreakpoints
],
15170 "ConditionalBreakpoints",
15171 "conditional-breakpoints", 0);
15173 add_packet_config_cmd (&remote_protocol_packets
[PACKET_BreakpointCommands
],
15174 "BreakpointCommands",
15175 "breakpoint-commands", 0);
15177 add_packet_config_cmd (&remote_protocol_packets
[PACKET_FastTracepoints
],
15178 "FastTracepoints", "fast-tracepoints", 0);
15180 add_packet_config_cmd (&remote_protocol_packets
[PACKET_TracepointSource
],
15181 "TracepointSource", "TracepointSource", 0);
15183 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAllow
],
15184 "QAllow", "allow", 0);
15186 add_packet_config_cmd (&remote_protocol_packets
[PACKET_StaticTracepoints
],
15187 "StaticTracepoints", "static-tracepoints", 0);
15189 add_packet_config_cmd (&remote_protocol_packets
[PACKET_InstallInTrace
],
15190 "InstallInTrace", "install-in-trace", 0);
15192 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_statictrace_read
],
15193 "qXfer:statictrace:read", "read-sdata-object", 0);
15195 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_fdpic
],
15196 "qXfer:fdpic:read", "read-fdpic-loadmap", 0);
15198 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QDisableRandomization
],
15199 "QDisableRandomization", "disable-randomization", 0);
15201 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QAgent
],
15202 "QAgent", "agent", 0);
15204 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QTBuffer_size
],
15205 "QTBuffer:size", "trace-buffer-size", 0);
15207 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_off
],
15208 "Qbtrace:off", "disable-btrace", 0);
15210 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_bts
],
15211 "Qbtrace:bts", "enable-btrace-bts", 0);
15213 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_pt
],
15214 "Qbtrace:pt", "enable-btrace-pt", 0);
15216 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace
],
15217 "qXfer:btrace", "read-btrace", 0);
15219 add_packet_config_cmd (&remote_protocol_packets
[PACKET_qXfer_btrace_conf
],
15220 "qXfer:btrace-conf", "read-btrace-conf", 0);
15222 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_bts_size
],
15223 "Qbtrace-conf:bts:size", "btrace-conf-bts-size", 0);
15225 add_packet_config_cmd (&remote_protocol_packets
[PACKET_multiprocess_feature
],
15226 "multiprocess-feature", "multiprocess-feature", 0);
15228 add_packet_config_cmd (&remote_protocol_packets
[PACKET_swbreak_feature
],
15229 "swbreak-feature", "swbreak-feature", 0);
15231 add_packet_config_cmd (&remote_protocol_packets
[PACKET_hwbreak_feature
],
15232 "hwbreak-feature", "hwbreak-feature", 0);
15234 add_packet_config_cmd (&remote_protocol_packets
[PACKET_fork_event_feature
],
15235 "fork-event-feature", "fork-event-feature", 0);
15237 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vfork_event_feature
],
15238 "vfork-event-feature", "vfork-event-feature", 0);
15240 add_packet_config_cmd (&remote_protocol_packets
[PACKET_Qbtrace_conf_pt_size
],
15241 "Qbtrace-conf:pt:size", "btrace-conf-pt-size", 0);
15243 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vContSupported
],
15244 "vContSupported", "verbose-resume-supported", 0);
15246 add_packet_config_cmd (&remote_protocol_packets
[PACKET_exec_event_feature
],
15247 "exec-event-feature", "exec-event-feature", 0);
15249 add_packet_config_cmd (&remote_protocol_packets
[PACKET_vCtrlC
],
15250 "vCtrlC", "ctrl-c", 0);
15252 add_packet_config_cmd (&remote_protocol_packets
[PACKET_QThreadEvents
],
15253 "QThreadEvents", "thread-events", 0);
15255 add_packet_config_cmd (&remote_protocol_packets
[PACKET_no_resumed
],
15256 "N stop reply", "no-resumed-stop-reply", 0);
15258 add_packet_config_cmd (&remote_protocol_packets
[PACKET_memory_tagging_feature
],
15259 "memory-tagging-feature", "memory-tagging-feature", 0);
15261 /* Assert that we've registered "set remote foo-packet" commands
15262 for all packet configs. */
15266 for (i
= 0; i
< PACKET_MAX
; i
++)
15268 /* Ideally all configs would have a command associated. Some
15269 still don't though. */
15274 case PACKET_QNonStop
:
15275 case PACKET_EnableDisableTracepoints_feature
:
15276 case PACKET_tracenz_feature
:
15277 case PACKET_DisconnectedTracing_feature
:
15278 case PACKET_augmented_libraries_svr4_read_feature
:
15280 /* Additions to this list need to be well justified:
15281 pre-existing packets are OK; new packets are not. */
15289 /* This catches both forgetting to add a config command, and
15290 forgetting to remove a packet from the exception list. */
15291 gdb_assert (excepted
== (remote_protocol_packets
[i
].name
== NULL
));
15295 /* Keep the old ``set remote Z-packet ...'' working. Each individual
15296 Z sub-packet has its own set and show commands, but users may
15297 have sets to this variable in their .gdbinit files (or in their
15299 add_setshow_auto_boolean_cmd ("Z-packet", class_obscure
,
15300 &remote_Z_packet_detect
, _("\
15301 Set use of remote protocol `Z' packets."), _("\
15302 Show use of remote protocol `Z' packets."), _("\
15303 When set, GDB will attempt to use the remote breakpoint and watchpoint\n\
15305 set_remote_protocol_Z_packet_cmd
,
15306 show_remote_protocol_Z_packet_cmd
,
15307 /* FIXME: i18n: Use of remote protocol
15308 `Z' packets is %s. */
15309 &remote_set_cmdlist
, &remote_show_cmdlist
);
15311 add_basic_prefix_cmd ("remote", class_files
, _("\
15312 Manipulate files on the remote system.\n\
15313 Transfer files to and from the remote target system."),
15315 0 /* allow-unknown */, &cmdlist
);
15317 add_cmd ("put", class_files
, remote_put_command
,
15318 _("Copy a local file to the remote system."),
15321 add_cmd ("get", class_files
, remote_get_command
,
15322 _("Copy a remote file to the local system."),
15325 add_cmd ("delete", class_files
, remote_delete_command
,
15326 _("Delete a remote file."),
15329 add_setshow_string_noescape_cmd ("exec-file", class_files
,
15330 &remote_exec_file_var
, _("\
15331 Set the remote pathname for \"run\"."), _("\
15332 Show the remote pathname for \"run\"."), NULL
,
15333 set_remote_exec_file
,
15334 show_remote_exec_file
,
15335 &remote_set_cmdlist
,
15336 &remote_show_cmdlist
);
15338 add_setshow_boolean_cmd ("range-stepping", class_run
,
15339 &use_range_stepping
, _("\
15340 Enable or disable range stepping."), _("\
15341 Show whether target-assisted range stepping is enabled."), _("\
15342 If on, and the target supports it, when stepping a source line, GDB\n\
15343 tells the target to step the corresponding range of addresses itself instead\n\
15344 of issuing multiple single-steps. This speeds up source level\n\
15345 stepping. If off, GDB always issues single-steps, even if range\n\
15346 stepping is supported by the target. The default is on."),
15347 set_range_stepping
,
15348 show_range_stepping
,
15352 add_setshow_zinteger_cmd ("watchdog", class_maintenance
, &watchdog
, _("\
15353 Set watchdog timer."), _("\
15354 Show watchdog timer."), _("\
15355 When non-zero, this timeout is used instead of waiting forever for a target\n\
15356 to finish a low-level step or continue operation. If the specified amount\n\
15357 of time passes without a response from the target, an error occurs."),
15360 &setlist
, &showlist
);
15362 add_setshow_zuinteger_unlimited_cmd ("remote-packet-max-chars", no_class
,
15363 &remote_packet_max_chars
, _("\
15364 Set the maximum number of characters to display for each remote packet."), _("\
15365 Show the maximum number of characters to display for each remote packet."), _("\
15366 Specify \"unlimited\" to display all the characters."),
15367 NULL
, show_remote_packet_max_chars
,
15368 &setdebuglist
, &showdebuglist
);
15370 add_setshow_boolean_cmd ("remote", no_class
, &remote_debug
,
15371 _("Set debugging of remote protocol."),
15372 _("Show debugging of remote protocol."),
15374 When enabled, each packet sent or received with the remote target\n\
15378 &setdebuglist
, &showdebuglist
);
15380 add_setshow_zuinteger_unlimited_cmd ("remotetimeout", no_class
,
15381 &remote_timeout
, _("\
15382 Set timeout limit to wait for target to respond."), _("\
15383 Show timeout limit to wait for target to respond."), _("\
15384 This value is used to set the time limit for gdb to wait for a response\n\
15385 from the target."),
15387 show_remote_timeout
,
15388 &setlist
, &showlist
);
15390 /* Eventually initialize fileio. See fileio.c */
15391 initialize_remote_fileio (&remote_set_cmdlist
, &remote_show_cmdlist
);
15394 selftests::register_test ("remote_memory_tagging",
15395 selftests::test_memory_tagging_functions
);